Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Guidance for reviewers and agents working in this repository.

## Project

`bugsee_flutter`: the Flutter wrapper for the Bugsee 7.x native SDKs (Android 7.4.2, iOS 7.0.0-beta7), version `10.0.0-dev.1`,
`bugsee_flutter`: the Flutter wrapper for the Bugsee 7.x native SDKs (Android 7.4.2, iOS 7.0.0), version `10.0.0-dev.1`,
unpublished, plus the separate `packages/bugsee_flutter_feedback`. The implementation is complete and merged into `nextgen`;
`PLAN.md` is the status, the decisions (D1 to D12), the open questions and the release checklist. The authoritative wrapper spec is
`sdk/wrapper-workbook` in the `bugsee/specs` repository (refer to it by repo name); `doc/workbook-conformance.md` maps it to the code.
Expand Down
2 changes: 1 addition & 1 deletion .github/CI.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ framework. Four checks, by where their inputs live:
| `dart scripts/generate_options.dart --check` | PR CI (`options-codegen`) | the committed manifests and `docs.json` |
| `flutter test` (`option_manifests_test`, `options_registry_test`, `launch_options_test`, `launch_drift_test`) | PR CI (`test`) | the committed manifests |
| `dart scripts/sync_option_manifests.dart --check` | weekly `native-pins.yml`, or by hand | the network (the published manifests) |
| `dart scripts/verify_option_manifests.dart ...` and `dart scripts/extract_option_docs.dart ... --check` | by hand | the private SDK checkouts (Android tag, iOS `origin/nextgen`); never CI |
| `dart scripts/verify_option_manifests.dart ...` and `dart scripts/extract_option_docs.dart ... --check` | by hand | the private SDK checkouts (Android tag, iOS `origin/release`); never CI |

Bumping a native pin: edit `native-versions.json`, run `sync_option_manifests.dart`, the two source scripts, then
`generate_options.dart`, and commit the diff: the review shows exactly which options appeared, changed or went.
Expand Down
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## 10.0.0-dev.1

A rewrite for the Bugsee 7.x native SDKs (Android 7.4.2, iOS 7.0.0-beta7). **Not published yet; a prerelease.** Existing 9.x apps
A rewrite for the Bugsee 7.x native SDKs (Android 7.4.2, iOS 7.0.0). **Not published yet; a prerelease.** Existing 9.x apps
should stay on 9.x: there is no compatibility layer (the decision is open), see `doc/migration-from-9x.md`.

### Features
Expand Down
14 changes: 8 additions & 6 deletions PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Contents: [Status](#status) | [Decisions taken](#decisions-taken) | [Open decisi

| # | Decision | Reason |
|---|---|---|
| D1 | **Native pins:** Android 7.4.2 (Maven Central), iOS 7.0.0-beta7 via SwiftPM `github.com/bugsee/spm`; every pin in `native-versions.json` with provenance | one source, compared by tests |
| D1 | **Native pins:** Android 7.4.2 (Maven Central), iOS 7.0.0 (stable) via SwiftPM `github.com/bugsee/spm`; every pin in `native-versions.json` with provenance | one source, compared by tests |
| D2 | **iOS is SwiftPM only**, no podspec | Bugsee publishes no CocoaPods pod |
| D3 | **Compatibility with the 9.x Dart API: deferred** to the owner (see below). The facade is isolated in `lib/src/bugsee.dart` / `bugsee_runtime.dart` so a layer could sit beside it | |
| D4 | **The feedback chat is a separate package**, mirroring the native split and React Native | apps that never show it do not carry SwiftUI / Compose |
Expand All @@ -50,8 +50,8 @@ Contents: [Status](#status) | [Decisions taken](#decisions-taken) | [Open decisi

1. **A 9.x compatibility layer** (D3): offer a `bugsee.dart`-style shim over the 10.x facade, or none. The migration guide is written for
"none".
2. **Whether to publish**, and when. The iOS pin is a beta (`7.0.0-beta7`): publish a stable `10.0.0` only against a stable iOS SDK,
or ship `10.0.0-dev.N` / `-beta` first.
2. **Whether to publish**, and when. Both native pins are stable releases now (Android 7.4.2, iOS 7.0.0; the iOS pin was `7.0.0-beta7` until then), so a stable
`10.0.0` is no longer blocked by a beta dependency; the choice between `10.0.0` and `10.0.0-dev.N` / `-beta` first is open.
3. **pub.dev name and ownership.** `bugsee_flutter` exists on pub.dev (latest `9.0.4`, publisher `bugsee.com`), so 10.x continues that
package. `bugsee_flutter_feedback` does not exist yet (checked 2026-10-22) and must be created under the same publisher.
4. **Versioning of the first release**: `10.0.0` against `10.0.0-dev.1`. The versions in `pubspec.yaml` (both packages), `wrapper_identity.dart`,
Expand Down Expand Up @@ -166,10 +166,12 @@ Facts worth keeping from the work (each is in the doc named):
(`doc/api-surface.md`, `doc/view-hierarchy.md`, `.claude/CLAUDE.md`).
* **Measured on a device (Phase 7):** a native-crash report recovered after a normal Android session is dispatched on `BugseeReportHandlerThread` with the live
window, so the Dart handler runs and its edits land (the workbook table says main; the early-crash recovery path is the one that completes at once).
* **Option manifests cross-check** (`scripts/verify_option_manifests.dart`, 2026-10-21, Android `v7.4.2`, iOS `origin/nextgen@0581aa02c`): keys, hidden
* **Option manifests cross-check** (`scripts/verify_option_manifests.dart`, 2026-10-21, Android `v7.4.2`, iOS `origin/nextgen@0581aa02c`, beta7): keys, hidden
keys and enum values in the vendored manifests equal what the SDK source declares. Inventory: Android 87 options (84 public, 3 hidden), iOS 70 (69
public, 1 hidden), 49 shared; the leak module's four options and one deprecated option have no typed field; defaults differ on exactly two shared keys
(`capture.video.adaptive`, `config.max-data-size`).
public, 1 hidden), 49 shared; the leak module's four options and one deprecated option have no typed field; defaults differed on exactly two shared keys
(`capture.video.adaptive`, `config.max-data-size`). Moving the iOS pin to 7.0.0 (manifest of 2026-10-30) changed that: iOS gained
`config.max-pending-reports` and `config.max-pending-report-age` (now 72 options, 71 public, 51 shared) and its `config.max-data-size` default went
from 50 to 150 (as Android), so only `capture.video.adaptive` still differs.
* **Pre-existing, worked around:** `flutter build ios --simulator` fails on Flutter 3.41 / Xcode 27.1 (an order-sensitive architecture check); the harness
builds with `--config-only` plus `xcodebuild` for one simulator.

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ errors.
| Flutter / Dart | 3.41.0 or newer / 3.11 or newer |
| Android | `minSdk` 21; JDK 17 or 21 for the build (JDK 25 breaks the Gradle 8.14 of the Flutter template); the Bugsee Gradle plugin **4.0.8** (mandatory, see below) |
| iOS | 15.0 or newer; Swift Package Manager only (no CocoaPods: Bugsee publishes no pod and this plugin has no podspec) |
| Native SDKs | Android `7.4.2`, iOS `7.0.0-beta7` (pinned in [`native-versions.json`](native-versions.json)) |
| Native SDKs | Android `7.4.2`, iOS `7.0.0` (pinned in [`native-versions.json`](native-versions.json)) |
| Not covered | web, desktop (the calls do nothing there), tvOS, visionOS, the Android leak module |

The Flutter floor is 3.41.0 because the plugin is SwiftPM-only: `flutter pub get` fails on Linux and Windows with
Expand Down
2 changes: 1 addition & 1 deletion android/src/main/java/com/bugsee/flutter/Messages.java
Original file line number Diff line number Diff line change
Expand Up @@ -2645,7 +2645,7 @@ ArrayList<Object> toList() {
* vocabulary is strings and integers only (no Pigeon enum: Pigeon sends an ordinal).
*
* Native builds the SDK's own event from it (Android: `BugseeExchangeFactory.createNetworkEvent`,
* iOS: `BugseeNetworkEvent`, because the iOS 7.0.0-beta7 factory answers nil) and submits it
* iOS: `BugseeNetworkEvent`, because the iOS 7.0.0 factory answers nil) and submits it
* through the wrapper channel with filtering REQUIRED, so the SDK's default sanitizer and the app's
* native filter still apply (doc/network.md).
*
Expand Down
2 changes: 1 addition & 1 deletion android/src/main/java/com/bugsee/flutter/ReportOps.java
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ final class ReportOps {
/**
* The soft limit of ONE attached file: 20 MiB. Neither SDK limits a file on this path, but a copy is
* synchronous I/O in front of every other queued operation and the SDK's handler timer does not wait
* for it (see {@link Window}); {@code config.max-data-size} (default 50 on iOS, 150 on Android) bounds
* for it (see {@link Window}); {@code config.max-data-size} (default 150 on both, 50 on iOS up to 7.0.0-beta7) bounds
* all the data a report may hold, so one file of 20 MiB is the most a handler can attach without
* crowding the rest out. Repeated in Dart ({@code maxAttachmentFileBytes}) and Objective-C.
*/
Expand Down
2 changes: 1 addition & 1 deletion doc/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,6 @@ The pages below go deeper.
| [../.claude/CLAUDE.md](../.claude/CLAUDE.md) | The reviewer and agent guide: rules the code must keep |
| [../example/README.md](../example/README.md) | The example app and its integration tests |

Source references in these pages name the SDK files and lines they were read from (Android tag `v7.4.2`, iOS `7.0.0-beta7`). The
Source references in these pages name the SDK files and lines they were read from (Android tag `v7.4.2`, iOS `7.0.0`: SDK source `origin/release@2b88480fa`, the commit the 7.0.0 banner `build:2b88480fa-7` names; the iOS repository has no 7.x tag. Line numbers read at the earlier 7.0.0-beta7 commit `0581aa02c` are marked as such where they have not been re-read). The
SDKs are private repositories; the published artefacts are Maven Central `com.bugsee:bugsee-android` and the SwiftPM package
`github.com/bugsee/spm`.
8 changes: 4 additions & 4 deletions doc/api-surface.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# Public API surface and its inventory

This is the written inventory the public facade was built from: every public method of the
Android 7.4.2 and iOS 7.0.0-beta7 SDKs, whether it is cross-platform, one-platform or
Android 7.4.2 and iOS 7.0.0 SDKs, whether it is cross-platform, one-platform or
wrapper-internal, and what this package does about it. The decisions mirror the converged 7.x React
Native facade (`cross/bugsee-react-native/packages/react-native/src/index.ts`) unless the SDK source
says otherwise; where it does, the source wins and the difference is noted.

Sources read: Android `bugsee/bugsee-android` tag `v7.4.2` (`3b7af6371`):
`library/.../Bugsee.java`, `BugseeInternal.java`, `BugseeAttributes.java`, `BugseeEnvironment.java`,
`docs/api-7.x.md`; iOS `bugsee/bugsee-ios` `origin/nextgen` (`0581aa02c`, the 7.0.0-beta7 headers):
`docs/api-7.x.md`; iOS `bugsee/bugsee-cocoa` `origin/release@2b88480fa` (7.0.0; the lines below were read at beta7's `0581aa02c`, and 7.0.0 moved the wrapper SPI from `BGSContracts.h` (now a private header that is not shipped) into `BugseeSPI.h` / the `Bugsee.SPI` submodule):
`Bugsee.h`, `Bugsee.m`, `BGSBugseeEnvironment.m`, `BGSContracts.h`. Line numbers below refer to those.

Everything below is implemented. Details that have a page of their own: attachments, annotated screenshots and
Expand All @@ -25,7 +25,7 @@ Everything below is implemented. Details that have a page of their own: attachme

### Lifecycle and configuration

| Capability | Android 7.4.2 | iOS 7.0.0-beta7 | Decision |
| Capability | Android 7.4.2 | iOS 7.0.0 | Decision |
|---|---|---|---|
| launch (token, options) | `launch` x4 (+ manifest auto-init) | `launchWithToken:` x4 | **expose**: `Bugsee.launch`, `waitUntilLaunched` |
| stop | `stop()`, `stop(Runnable)` | `stop:` | **expose**: `Bugsee.stop` |
Expand Down Expand Up @@ -93,7 +93,7 @@ Everything below is implemented. Details that have a page of their own: attachme
The wrapper queues nothing and gates nothing: each call reaches the SDK as it is and does what that SDK does
(Dart validates arguments first; native defends again). "Dropped" means the SDK ignores the call; it never throws.

| `Bugsee.` | Android 7.4.2 before launch | iOS 7.0.0-beta7 before launch | Result |
| `Bugsee.` | Android 7.4.2 before launch | iOS 7.0.0 before launch | Result |
|---|---|---|---|
| `setAttribute` and the other attribute calls | works: `BugseeAttributes.getInstance()` is a persisted store (`BugseeAttributes.java`, preferences scope `global_attrs`) | works: `NSUserDefaults` (`BGSBugseeEnvironment.m`, `setAttributeForKey:value:`) | works on both, persisted across launches and stops. Verified on device |
| `setUserIdentifier`, `getUserIdentifier`, `clearUserIdentifier` | works: global preferences (`BugseeEnvironment.setUserIdentifier`) | works: Keychain, `NSUserDefaults` fallback (`Bugsee.m:2057`) | works on both. Verified on device |
Expand Down
2 changes: 1 addition & 1 deletion doc/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ flowchart TB
iwrap --> istores
end

sdk["Native Bugsee SDK<br/>Android 7.4.2 / iOS 7.0.0-beta7"]
sdk["Native Bugsee SDK<br/>Android 7.4.2 / iOS 7.0.0"]

app --> facade
bridge <--> aplug
Expand Down
10 changes: 5 additions & 5 deletions doc/attachments.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ sources are `specs/sdk/report-contract` (method matrix, lifetime, "path-first",

## 1. What exists at the pins (read from SDK source, not from the spec's status line)

| Piece | Android 7.4.2 (`v7.4.2`, `3b7af6371`) | iOS 7.0.0-beta7 (`origin/nextgen@0581aa02c`) |
| Piece | Android 7.4.2 (`v7.4.2`, `3b7af6371`) | iOS 7.0.0 (`origin/release@2b88480fa`; read at beta7 `0581aa02c`, limits re-extracted at 7.0.0) |
|---|---|---|
| `addAttachment(file, name, mime, move)` | `Report.addAttachment(File,..)` (`contracts/reporting/Report.java`), implemented by `IssueReport.addAttachment` / `IssueReportAttachment.importFile` (rename, else copy+delete; symlink always copied) | `addAttachmentWithFilePath:name:mimeType:move:` (`BGSContracts.h`, `BGSReport.m`; lstat, rename or copy, hands a refused move back) |
| `addAttachment(file, name, mime, move)` | `Report.addAttachment(File,..)` (`contracts/reporting/Report.java`), implemented by `IssueReport.addAttachment` / `IssueReportAttachment.importFile` (rename, else copy+delete; symlink always copied) | `addAttachmentWithFilePath:name:mimeType:move:` (`BugseeSPI.h` (`BGSContracts.h` at beta7), `BGSReport.m`; lstat, rename or copy, hands a refused move back) |
| `addAttachment(bytes, name, mime)` | `Report.addAttachment(byte[],..)` | `addAttachmentWithData:name:mimeType:` |
| list / clear | `getAttachments()`, `clearAttachments()` (deletes the files) | `attachments`, `clearAttachments` |
| lifetime | `IssueReport.isAcceptingAttachments` (reporting stage `< PROCESSING_SCHEDULED`) | `stopAcceptingAttachments` / `_closedToAttachments` |
Expand All @@ -20,8 +20,8 @@ sources are `specs/sdk/report-contract` (method matrix, lifetime, "path-first",

**The spec's "Android implements on branch `feat/report-contract-parity`" is stale for the pin:** that branch is NOT
merged into `v7.4.2` (`git merge-base --is-ancestor` fails) but the contract's pieces (PR #117 path-first, #136, #178)
arrived through `main`, and `v7.4.2` has them; everything above was read at the tag. iOS closes its gaps on `nextgen`
as the spec says (#136, #145) and beta7 = `0581aa02c` has them.
arrived through `main`, and `v7.4.2` has them; everything above was read at the tag. iOS closed its gaps on `nextgen`
(now in `origin/release`) as the spec says (#136, #145); beta7 (`0581aa02c`) and 7.0.0 (`2b88480fa`) have them.

## 2. Public API

Expand Down Expand Up @@ -70,7 +70,7 @@ Objective-C (a drift guard compares them).

**Limits.** Files: a SOFT limit of 20 MiB each (`maxAttachmentFileBytes`; neither SDK has one on this path, but a copy is
synchronous I/O in front of every other queued operation and the SDK's handler timer does not wait for it;
`config.max-data-size`, default 50 on iOS and 150 on Android, bounds what a report may hold; a native copy, nothing read
`config.max-data-size`, default 150 on both (iOS: 50 up to 7.0.0-beta7), bounds what a report may hold; a native copy, nothing read
into memory), 1000 attachments per report (the SDKs' own, extracted into `test/fixtures/report_enums.json` from source). Bytes: 1 MiB, empty allowed for a handler report. Images:
4096 x 4096 pixels, refused from the header before any pixel is allocated. A refusal never consumes the source: with
`move: true` a refused file stays (verified on both SDKs).
Expand Down
Loading