diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 27fcfb33..1eafa92a 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -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. diff --git a/.github/CI.md b/.github/CI.md index f548ed14..324e0b51 100644 --- a/.github/CI.md +++ b/.github/CI.md @@ -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. diff --git a/CHANGELOG.md b/CHANGELOG.md index 6bdd6411..6435dc7a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 diff --git a/PLAN.md b/PLAN.md index d356aaeb..50603d42 100644 --- a/PLAN.md +++ b/PLAN.md @@ -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 | @@ -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`, @@ -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. diff --git a/README.md b/README.md index 127cddfe..d4271121 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/android/src/main/java/com/bugsee/flutter/Messages.java b/android/src/main/java/com/bugsee/flutter/Messages.java index 6c844df5..1e708ddf 100644 --- a/android/src/main/java/com/bugsee/flutter/Messages.java +++ b/android/src/main/java/com/bugsee/flutter/Messages.java @@ -2645,7 +2645,7 @@ ArrayList 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). * diff --git a/android/src/main/java/com/bugsee/flutter/ReportOps.java b/android/src/main/java/com/bugsee/flutter/ReportOps.java index dc1c6b09..d4f790d8 100644 --- a/android/src/main/java/com/bugsee/flutter/ReportOps.java +++ b/android/src/main/java/com/bugsee/flutter/ReportOps.java @@ -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. */ diff --git a/doc/README.md b/doc/README.md index 54f8bdc5..189ab310 100644 --- a/doc/README.md +++ b/doc/README.md @@ -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`. diff --git a/doc/api-surface.md b/doc/api-surface.md index b6a849e5..c8e6e66e 100644 --- a/doc/api-surface.md +++ b/doc/api-surface.md @@ -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 @@ -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` | @@ -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 | diff --git a/doc/architecture.md b/doc/architecture.md index 19446ec1..6e95ebb0 100644 --- a/doc/architecture.md +++ b/doc/architecture.md @@ -39,7 +39,7 @@ flowchart TB iwrap --> istores end - sdk["Native Bugsee SDK
Android 7.4.2 / iOS 7.0.0-beta7"] + sdk["Native Bugsee SDK
Android 7.4.2 / iOS 7.0.0"] app --> facade bridge <--> aplug diff --git a/doc/attachments.md b/doc/attachments.md index c3caf0d9..c5ac793f 100644 --- a/doc/attachments.md +++ b/doc/attachments.md @@ -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` | @@ -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 @@ -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). diff --git a/doc/design-rules.md b/doc/design-rules.md index a9a3674f..6beef7d9 100644 --- a/doc/design-rules.md +++ b/doc/design-rules.md @@ -8,7 +8,7 @@ the evidence; this page is the checklist. ## Secure rectangles -Secure rectangles (workbook Part 5; Dart `lib/src/secure`, `SecureRectangleStore` / `BGSFlutterSecureRectangleStore`): Dart publishes Flutter LOGICAL pixels per view WITH the device pixel ratio it measured them at, whole state, ordered by `(epoch, sequence)` where the epoch is a RANDOM id (never a clock): a new epoch is a new isolate and wins, a retired one is a dead isolate's straggler and is ignored. The SDKs' units differ and are read from SDK source: Android 7.4.2 takes PHYSICAL PIXELS in `View.getLocationOnScreen` space (factor = the message's ratio, which must equal the density of the Flutter view's `Resources` read at every pull), iOS 7.0.0-beta7 takes POINTS in the screen's coordinate space (factor = ratio / `UIScreen.scale` = 1; NEVER multiply by `UIScreen.scale`). A ratio that does not match the display now (density changed natively before Dart laid out again) covers the whole display until Dart republishes. Scale (including the view's own on-screen scale from its and its ancestors' transforms), then add the view's screen position, THEN floor l/t and ceil r/b. Versions are derived from what is served (per display, never 0, no-op never moves them); a display that never had a rectangle serves `[0, 0]`. Anything unplaceable, non-finite, mis-scaled, rotated/skewed or without an activity/view controller serves the WHOLE display (fail closed); only a view known to be off-screen (iOS: in no window) serves nothing. A grace window (`GRACE_MS` = 0.12 s, in both stores, compared by the drift guard) serves each past set for that long AFTER IT stopped being current (not from the last change, so a long movement does not widen the cover to its path), so a moving region leaves no strip; the union shrinking back is itself a version change. Dart reports regions unclipped, including what their descendants paint outside the box, and drops one ONLY on positive evidence that it is not on screen (an ancestor that does not paint it, an IndexedStack showing another child, a clipping viewport it and what it paints lie wholly outside). A disabled TickerMode is NOT evidence (it only stops animations). A detached layer is NOT such evidence (SnapshotWidget, the Zoom page transition). Android: a pull asks the main thread to re-read the placements (throttled to 100 ms) and answers from the last completed read, so a view that moved with no relayout is served at its old place for up to about one pull; a refresh asked for and not completed for `REFRESH_STALE_MS` (1 s: a stuck main thread) covers every placed view whole until one completes (tracked from the OLDEST unanswered request, so throttle suppression cannot hide it, and independent of the pull rate; marking every pull as pending would blank the display on every pull). iOS refreshes synchronously on the main thread, where the SDK pulls today. A failed publish is retried by a timer with deterministic backoff (1 s doubling to a 30 s cap) and NEVER abandoned (native keeps the last accepted state, so giving up leaves a stale mask and a new region in the clear); frames never resend the state that just failed, and once `maxRetries` consecutive failures passed a CHANGED state (the only kind that can add a region) goes out once `retryDelay` has passed since the last attempt, never per frame (no flood; a missing plugin costs one message per 30 s while nothing moves, at most one per second while regions move). The registry's clock is injectable for tests. Every one of these rules has a test that fails when it is broken; keep it that way. +Secure rectangles (workbook Part 5; Dart `lib/src/secure`, `SecureRectangleStore` / `BGSFlutterSecureRectangleStore`): Dart publishes Flutter LOGICAL pixels per view WITH the device pixel ratio it measured them at, whole state, ordered by `(epoch, sequence)` where the epoch is a RANDOM id (never a clock): a new epoch is a new isolate and wins, a retired one is a dead isolate's straggler and is ignored. The SDKs' units differ and are read from SDK source: Android 7.4.2 takes PHYSICAL PIXELS in `View.getLocationOnScreen` space (factor = the message's ratio, which must equal the density of the Flutter view's `Resources` read at every pull), iOS 7.0.0 takes POINTS in the screen's coordinate space (factor = ratio / `UIScreen.scale` = 1; NEVER multiply by `UIScreen.scale`). A ratio that does not match the display now (density changed natively before Dart laid out again) covers the whole display until Dart republishes. Scale (including the view's own on-screen scale from its and its ancestors' transforms), then add the view's screen position, THEN floor l/t and ceil r/b. Versions are derived from what is served (per display, never 0, no-op never moves them); a display that never had a rectangle serves `[0, 0]`. Anything unplaceable, non-finite, mis-scaled, rotated/skewed or without an activity/view controller serves the WHOLE display (fail closed); only a view known to be off-screen (iOS: in no window) serves nothing. A grace window (`GRACE_MS` = 0.12 s, in both stores, compared by the drift guard) serves each past set for that long AFTER IT stopped being current (not from the last change, so a long movement does not widen the cover to its path), so a moving region leaves no strip; the union shrinking back is itself a version change. Dart reports regions unclipped, including what their descendants paint outside the box, and drops one ONLY on positive evidence that it is not on screen (an ancestor that does not paint it, an IndexedStack showing another child, a clipping viewport it and what it paints lie wholly outside). A disabled TickerMode is NOT evidence (it only stops animations). A detached layer is NOT such evidence (SnapshotWidget, the Zoom page transition). Android: a pull asks the main thread to re-read the placements (throttled to 100 ms) and answers from the last completed read, so a view that moved with no relayout is served at its old place for up to about one pull; a refresh asked for and not completed for `REFRESH_STALE_MS` (1 s: a stuck main thread) covers every placed view whole until one completes (tracked from the OLDEST unanswered request, so throttle suppression cannot hide it, and independent of the pull rate; marking every pull as pending would blank the display on every pull). iOS refreshes synchronously on the main thread, where the SDK pulls today. A failed publish is retried by a timer with deterministic backoff (1 s doubling to a 30 s cap) and NEVER abandoned (native keeps the last accepted state, so giving up leaves a stale mask and a new region in the clear); frames never resend the state that just failed, and once `maxRetries` consecutive failures passed a CHANGED state (the only kind that can add a region) goes out once `retryDelay` has passed since the last attempt, never per frame (no flood; a missing plugin costs one message per 30 s while nothing moves, at most one per second while regions move). The registry's clock is injectable for tests. Every one of these rules has a test that fails when it is broken; keep it that way. ## Secure rectangle limits @@ -32,7 +32,7 @@ Option encoding (`lib/src/options/launch_options.dart`): ONE flat `com.bugsee.op ## Endpoint -Endpoint (workbook 8.2 is stale for the pinned SDKs): iOS 7.0.0-beta7 registers the SAME hidden `com.bugsee.option.$$ENDPOINT` (manifest, nextgen d33dcc987) and strips trailing `/v2` itself, like Android; the flat `endpoint` is only a legacy alias. So one version-less value under the one namespaced key goes to both (`lib/src/options/endpoint.dart`, the only place; the wrapper's encoding is covered by tests; the launch integration test does NOT assert endpoint handling at runtime, so the SDKs' reading of it is as read from their manifests and source, not shown on a device). If an SDK diverges again, change only that file. `BugseeOptions.endpoint` is the one supported hidden-key override; the SDKs strip hidden options from uploaded `sdk.options` (8.4), the wrapper never sends `$$WRAPPER`/`$$DEBUG`. +Endpoint (workbook 8.2 is stale for the pinned SDKs): iOS 7.0.0 registers the SAME hidden `com.bugsee.option.$$ENDPOINT` (manifest, commit d33dcc987, which 7.0.0 contains) and strips trailing `/v2` itself, like Android; the flat `endpoint` is only a legacy alias. So one version-less value under the one namespaced key goes to both (`lib/src/options/endpoint.dart`, the only place; the wrapper's encoding is covered by tests; the launch integration test does NOT assert endpoint handling at runtime, so the SDKs' reading of it is as read from their manifests and source, not shown on a device). If an SDK diverges again, change only that file. `BugseeOptions.endpoint` is the one supported hidden-key override; the SDKs strip hidden options from uploaded `sdk.options` (8.4), the wrapper never sends `$$WRAPPER`/`$$DEBUG`. ## Launch @@ -56,7 +56,7 @@ Facade runtime verification: `example/integration_test/facade_test.dart` (Androi ## Network capture -Network capture (`lib/src/network`, native `NetworkOps.java` / `BGSFlutterNetworkOps.m`, doc `doc/network.md`): Dart's `dart:io` is invisible to the SDKs, so `Bugsee.installNetworkCapture()` puts a chaining `BugseeHttpOverrides` in front of `HttpOverrides.current` (the previous overrides MAKE the client and answer `findProxyFromEnvironment`; `CapturingHttpClient implements HttpClient` with NO `noSuchMethod`, so a member a newer SDK adds fails to compile instead of being silently unforwarded; a client already wrapped by another layer is not wrapped again) and records `before`/`redirect`/`complete`/`error`/`abort` entries. It must never change what the app sees or its timing (the differential test in `test/http_capture_test.dart` compares every observable with an unwrapped client), never throw into the app (every hook is try/catch), and never hold unbounded memory (`BodyTee`: copy only while text and within `capture.network.body-size-limit`, count beyond; a binary body is never copied). The SDK's body rules are mirrored from SDK source (Android `NetworkEventsProducer`/`applyBodyFilters`, iOS `BGSCaptureDataEntryNetwork`), request and response in the SDK's own order, and applied BEFORE copying. Events go `submit` (O(1)) -> bounded queue (512 events / 8 MiB, the NEW event is dropped and counted) -> Dart filter -> batches (<= 32 / 512 KiB, ONE in flight) -> `addNetworkEvents` on a serial BACKGROUND thread of the plugin (a Pigeon `@TaskQueue`, unlike the rest of the facade: the SDK's sanitizer and the app's native filter run on the calling thread, one body-size-limit's worth of text per event, and must not take UI time; the channel is documented as callable from any thread). The Dart filter is the privacy boundary and FAILS CLOSED (a throw, a wrong return type, a hang past its timeout drops the event; `id`/`stage`/`method`/`status`/`size` are the exchange's and a filter cannot change them). Injection uses the SDKs' WRAPPER CHANNEL, shipped at both pins (Android 7.4.2 `BugseeWrapperChannel`, iOS 7.0.0-beta7 `BGSWrapperChannel`; the wrapper-channel spec still says Proposed): `FlutterWrapper.onWrapperChannelAvailable` only STORES the channel in the process-wide `NetworkChannelHolder` / `BGSFlutterNetworkChannel` (the wrapper object is replaced when Dart refines the identity and the SDK retires the old channel then; store and return, nothing else, the SDK delivers it under its registration lock). Events are ALWAYS submitted with `requiresFiltering = true`: `false` would skip the SDK's default sanitizer and the app's native filter (`BugseeCaptureDataProviderNetwork.onNetworkEvent`, `BGSCaptureDataProviderNetwork.addNetworkEvent`); a Dart filter therefore does NOT replace the sanitizer and a native filter runs after it (double filtering is by design, documented). Network events carry NO source attribution at the pins (only `log` does): `mechanism: dart:io` is the label. Gate mirrored natively AND in Dart: only `launched` (Android would take `launching` into a 32-entry buffer, iOS drops it) and `capture.network` on; the policy is read from `getLaunchOptions` at install, after launch/stop and on every status event, a stop takes effect before the re-read, a failed read accepts nothing. iOS has no `createNetworkEvent` (the factory answers nil at the pin: build `BugseeNetworkEvent` directly), no redirect stage (the hop entries are not handed over; `redirectedFromURL` rides the final event), spells `abort` `cancel`, has no `statusText`/timings. The wire vocabulary (stages, reasons, max age, mechanism, filter timeout) is `test/fixtures/network_wire.json`, compared with Dart/Java/ObjC by `test/network_drift_test.dart` and with the REAL SDK enums/constants by `NetworkWireParityTest` and `BGSFlutterNetworkOpsTests`; the injection files may not wait, sleep or take a lock (guard in the drift test). The event age crosses as `ageMs` (Dart monotonic clock) and native subtracts it from the SDK's own clock (Android `currentTimestamp()`, which is not wall time once the clock was corrected). Requests to `bugsee.com` and below and to the configured `endpoint` host are never captured. URL hygiene (review round): userinfo is stripped in Dart from EVERY URL-bearing field (url, redirectedFrom, error texts, and once more after the filter) and URL-valued headers (`location`, `content-location`, `referer`, `refresh`) lose query values (`lib/src/network/url_redaction.dart`; the SDKs sanitize the url field only, Android breadcrumbs and error texts keep what they are given); redirect entries carry no headers; a manual `response.redirect()` starts a NEW exchange; `uninstall` still submits what was already captured; `ageMs` is stamped just before the batch is sent; `body-size-limit` is capped at 2 MiB; `install` refuses a zone that scopes its own overrides; `networkCaptureStats.submittedToSdk` is submitted, not recorded. Limits (documented, not bugs): other isolates, WebSocket frames (the handshake is an exchange), a client created before the install, an app that replaces the overrides without chaining (install again), a request never closed or a response never listened to. Runtime check: `example/integration_test/network_test.dart` (`--dart-define=BUGSEE_ENDPOINT=`; `NET_HOLD=` keeps the app alive to read the bundle with `adb run-as`). +Network capture (`lib/src/network`, native `NetworkOps.java` / `BGSFlutterNetworkOps.m`, doc `doc/network.md`): Dart's `dart:io` is invisible to the SDKs, so `Bugsee.installNetworkCapture()` puts a chaining `BugseeHttpOverrides` in front of `HttpOverrides.current` (the previous overrides MAKE the client and answer `findProxyFromEnvironment`; `CapturingHttpClient implements HttpClient` with NO `noSuchMethod`, so a member a newer SDK adds fails to compile instead of being silently unforwarded; a client already wrapped by another layer is not wrapped again) and records `before`/`redirect`/`complete`/`error`/`abort` entries. It must never change what the app sees or its timing (the differential test in `test/http_capture_test.dart` compares every observable with an unwrapped client), never throw into the app (every hook is try/catch), and never hold unbounded memory (`BodyTee`: copy only while text and within `capture.network.body-size-limit`, count beyond; a binary body is never copied). The SDK's body rules are mirrored from SDK source (Android `NetworkEventsProducer`/`applyBodyFilters`, iOS `BGSCaptureDataEntryNetwork`), request and response in the SDK's own order, and applied BEFORE copying. Events go `submit` (O(1)) -> bounded queue (512 events / 8 MiB, the NEW event is dropped and counted) -> Dart filter -> batches (<= 32 / 512 KiB, ONE in flight) -> `addNetworkEvents` on a serial BACKGROUND thread of the plugin (a Pigeon `@TaskQueue`, unlike the rest of the facade: the SDK's sanitizer and the app's native filter run on the calling thread, one body-size-limit's worth of text per event, and must not take UI time; the channel is documented as callable from any thread). The Dart filter is the privacy boundary and FAILS CLOSED (a throw, a wrong return type, a hang past its timeout drops the event; `id`/`stage`/`method`/`status`/`size` are the exchange's and a filter cannot change them). Injection uses the SDKs' WRAPPER CHANNEL, shipped at both pins (Android 7.4.2 `BugseeWrapperChannel`, iOS 7.0.0 `BGSWrapperChannel`; the wrapper-channel spec still says Proposed): `FlutterWrapper.onWrapperChannelAvailable` only STORES the channel in the process-wide `NetworkChannelHolder` / `BGSFlutterNetworkChannel` (the wrapper object is replaced when Dart refines the identity and the SDK retires the old channel then; store and return, nothing else, the SDK delivers it under its registration lock). Events are ALWAYS submitted with `requiresFiltering = true`: `false` would skip the SDK's default sanitizer and the app's native filter (`BugseeCaptureDataProviderNetwork.onNetworkEvent`, `BGSCaptureDataProviderNetwork.addNetworkEvent`); a Dart filter therefore does NOT replace the sanitizer and a native filter runs after it (double filtering is by design, documented). Network events carry NO source attribution at the pins (only `log` does): `mechanism: dart:io` is the label. Gate mirrored natively AND in Dart: only `launched` (Android would take `launching` into a 32-entry buffer, iOS drops it) and `capture.network` on; the policy is read from `getLaunchOptions` at install, after launch/stop and on every status event, a stop takes effect before the re-read, a failed read accepts nothing. iOS has no `createNetworkEvent` (the factory answers nil at the pin: build `BugseeNetworkEvent` directly), no redirect stage (the hop entries are not handed over; `redirectedFromURL` rides the final event), spells `abort` `cancel`, has no `statusText`/timings. The wire vocabulary (stages, reasons, max age, mechanism, filter timeout) is `test/fixtures/network_wire.json`, compared with Dart/Java/ObjC by `test/network_drift_test.dart` and with the REAL SDK enums/constants by `NetworkWireParityTest` and `BGSFlutterNetworkOpsTests`; the injection files may not wait, sleep or take a lock (guard in the drift test). The event age crosses as `ageMs` (Dart monotonic clock) and native subtracts it from the SDK's own clock (Android `currentTimestamp()`, which is not wall time once the clock was corrected). Requests to `bugsee.com` and below and to the configured `endpoint` host are never captured. URL hygiene (review round): userinfo is stripped in Dart from EVERY URL-bearing field (url, redirectedFrom, error texts, and once more after the filter) and URL-valued headers (`location`, `content-location`, `referer`, `refresh`) lose query values (`lib/src/network/url_redaction.dart`; the SDKs sanitize the url field only, Android breadcrumbs and error texts keep what they are given); redirect entries carry no headers; a manual `response.redirect()` starts a NEW exchange; `uninstall` still submits what was already captured; `ageMs` is stamped just before the batch is sent; `body-size-limit` is capped at 2 MiB; `install` refuses a zone that scopes its own overrides; `networkCaptureStats.submittedToSdk` is submitted, not recorded. Limits (documented, not bugs): other isolates, WebSocket frames (the handshake is an exchange), a client created before the install, an app that replaces the overrides without chaining (install again), a request never closed or a response never listened to. Runtime check: `example/integration_test/network_test.dart` (`--dart-define=BUGSEE_ENDPOINT=`; `NET_HOLD=` keeps the app alive to read the bundle with `adb run-as`). ## Log capture diff --git a/doc/exceptions.md b/doc/exceptions.md index fb4fa209..31783a4c 100644 --- a/doc/exceptions.md +++ b/doc/exceptions.md @@ -4,7 +4,7 @@ How a Dart error reaches the Bugsee backend, what the two SDKs do with it, what do (and never do), and how an obfuscated build is symbolicated. Everything below was read from source and, where it says so, measured on a device. Source refs: worker `bugsee/worker` @ `0b987619` (`crash/managed/__init__.py`, `crash/managed/dart.py`, `crash/managed/common.py`, `symbolfiles/flutter.py`, -`jobs/symbols.py`), Android SDK `v7.4.2` (`3b7af6371`), iOS SDK `origin/nextgen` (`0581aa02c`, the 7.0.0-beta7 +`jobs/symbols.py`), Android SDK `v7.4.2` (`3b7af6371`), iOS SDK (read at `0581aa02c`, the 7.0.0-beta7 headers), the 9.x plugin (`origin/release`: `lib/src/exceptions*.dart`, `scripts/symbols.py`). ## 1. The backend contract @@ -100,7 +100,7 @@ IsolateErrorListener Bugsee.listenToIsolateErrors(Isolate isolate) // .cancel( ## 3. What each SDK does, before launch and after stop -| | Android 7.4.2 | iOS 7.0.0-beta7 | +| | Android 7.4.2 | iOS 7.0.0 | |---|---|---| | handled | `Bugsee.logException(Throwable, domain, skipFrames)`: an **error** report, built on the SDK's aux thread (`BugseeInternal.java:1339-1356`, `BugseeIssueReportingCoordinator.java:458`) | `+logException:reason:domain:skipFrames:completion:`: an error report (`Bugsee.m:1517-1575`) | | unhandled | `Bugsee.logUnhandledException(Throwable, Map)`: a **crash** report, `isTerminating` false (the capture keeps running), written **synchronously on the calling thread**, which snapshots the capture ring ("up to a couple of seconds": `BugseeInternal.java:1358-1410`; the SDK's own comment names the Flutter cost: `BugseeIssueReportingCoordinator.java:329-346`) | `+logUnhandledException:reason:completion:`: writes a PLCrashReporter report to disk that the **next launch** sends, one at a time (`Bugsee.m:1578`, `BGSCrashManager.m:296`); with a debugger attached it falls back to the handled path with `handled=NO` | diff --git a/doc/logs.md b/doc/logs.md index db32b02e..cd77093b 100644 --- a/doc/logs.md +++ b/doc/logs.md @@ -27,7 +27,7 @@ Public API (all on `Bugsee`, `doc/api-surface.md` has the rest): `installLogCapt ## What the SDKs ship at the pins -| | Android 7.4.2 (`v7.4.2`) | iOS 7.0.0-beta7 (SDK `nextgen` `0581aa02c`) | +| | Android 7.4.2 (`v7.4.2`) | iOS 7.0.0 (SDK read at beta7 `0581aa02c`; release `2b88480fa`) | |---|---|---| | route | `BugseeWrapperChannel.log(tag, message, level, source)` -> `BugseeWrapperChannelImpl.log` (:36) -> `BugseeInternal.log` (:1029) | `-[BGSWrapperChannel logWithTag:message:level:source:]` -> `BGSWrapperChannelImpl.m:143` -> `+[Bugsee log:level:timestamp:source:requiresFiltering:YES]` | | allowed `source` | allow-list: `Custom` 98, `WebView` 5, `StdOut` 1, `StdErr` 2, `Unknown` 0; **every other value is recorded as `Custom`** (`toWrapperSource` :79), reported once per process; a null source is `Custom` silently | the same allow-list (`recordedSourceForClaimedSource:` :99), the same coercion and once-per-process notice | @@ -226,6 +226,6 @@ XCTest `BGSFlutterLogOpsTests`. Every one was checked with mutation testing (cou Android `bugsee-android` `v7.4.2`: `BugseeWrapperChannelImpl.java`, `contracts/internal/{BugseeWrapperChannel,LogSource}.java`, `contracts/options/LogLevel.java`, `BugseeInternal.java:1008-1050`, `capture/providers/log_system/BugseeCaptureDataProviderLog.java` (`mConsoleEventLogger`, `logEventInternal`, `FilterCallbackWrapper`, `isLevelAccepted`), `BugseeCaptureDataEntryLog.java`, -`interception/logs/LogLogcatThread.java`. iOS `0581aa02c`: `BGSWrapperChannelImpl.m`, `BGSContracts.h` (`BGSLogEventSource`, +`interception/logs/LogLogcatThread.java`. iOS `0581aa02c` (beta7; the SPI is in `BugseeSPI.h` at 7.0.0, `BGSContracts.h` being private and unshipped): `BGSWrapperChannelImpl.m`, `BGSContracts.h` (`BGSLogEventSource`, `BGSWrapperChannel`), `BugseeLogEvent.h`, `BugseeLogger.h` (`BugseeLogLevel`), `Capture/Providers/BGSCaptureDataProviderLog.m`, `Bugsee.m:1630-1700`. Bundle: `specs/sdk/reporting/bundle/log.md`. diff --git a/doc/migration-from-9x.md b/doc/migration-from-9x.md index d2b1a78a..5ebe698f 100644 --- a/doc/migration-from-9x.md +++ b/doc/migration-from-9x.md @@ -16,7 +16,7 @@ arguments for `event` and `trace`); this page follows the code. | | 9.x | 10.x | |---|---|---| | Flutter / Dart | `>=3.0.0` / `^3.0.0` | **Flutter `>=3.41.0` / Dart `^3.11.0`** (the plugin is SwiftPM-only; older Flutter fails `pub get` on Linux and Windows) | -| Native SDKs | Android 6.x, iOS 6.x | Android **7.4.2**, iOS **7.0.0-beta7** | +| Native SDKs | Android 6.x, iOS 6.x | Android **7.4.2**, iOS **7.0.0** | | Android | `minSdk` 21 | `minSdk` 21; the **Bugsee Gradle plugin 4.0.8 is mandatory** and applied by the app, plus a Gradle ordering workaround (README); JDK 17 or 21 | | iOS | CocoaPods podspec (and a SwiftPM package), deployment target 11.0 | **SwiftPM only: no podspec, no CocoaPods**; deployment target **15.0** | | Android launch | from Dart | from Dart, or by the SDK itself before Dart when the manifest has `com.bugsee.app-token` (then `Bugsee.launch` answers `alreadyRunning` and its options are not applied) | diff --git a/doc/network.md b/doc/network.md index 714ead21..6ac9a8e9 100644 --- a/doc/network.md +++ b/doc/network.md @@ -23,10 +23,10 @@ Public API (all on `Bugsee`, `doc/api-surface.md` has the rest): `installNetwork Both SDKs expose a way to hand them a network event, and, at the pinned versions, a wrapper-attributed channel: -| | Android 7.4.2 (`v7.4.2`) | iOS 7.0.0-beta7 (`bugsee/spm` 73ed983; SDK `nextgen` `0581aa02c`) | +| | Android 7.4.2 (`v7.4.2`) | iOS 7.0.0 (`bugsee/spm` bbfdda2; SDK read at beta7 `0581aa02c`; release `2b88480fa`) | |---|---|---| | public route | `Bugsee.addNetworkEvent(event, requiresFiltering)` (`Bugsee.java:1323`) over `BugseeExchangeFactory.createNetworkEvent` | `+[Bugsee addNetworkEvent:requiresFiltering:]` (`Bugsee.m:2154`); `+addNetworkEvent:` is `requiresFiltering:NO` | -| wrapper channel | **shipped**: `BugseeWrapperChannel` (`contracts/internal`), handed to `BugseeWrapper.onWrapperChannelAvailable` by `Bugsee.setWrapper` (`BugseeEnvironment.java:709`); its `addNetworkEvent` is `BugseeWrapperChannelImpl.addNetworkEvent` | **shipped**: `BGSWrapperChannel` / `-[BGSBugseeWrapper onWrapperChannelAvailable:]` (`BGSContracts.h`, `BGSWrapperChannelImpl.m:176`; present in the binary headers of the pinned xcframework) | +| wrapper channel | **shipped**: `BugseeWrapperChannel` (`contracts/internal`), handed to `BugseeWrapper.onWrapperChannelAvailable` by `Bugsee.setWrapper` (`BugseeEnvironment.java:709`); its `addNetworkEvent` is `BugseeWrapperChannelImpl.addNetworkEvent` | **shipped**: `BGSWrapperChannel` / `-[BGSBugseeWrapper onWrapperChannelAvailable:]` (`BugseeSPI.h` at 7.0.0, `BGSContracts.h` at beta7; `BGSWrapperChannelImpl.m:176`; present in the binary headers of the pinned xcframework) | | event factory | `createNetworkEvent(...)` x2 (the long overload sets every field) | `createNetworkEvent` answers **nil** ("not wired", `BGSExchangeFactory.m`): build a `BugseeNetworkEvent` directly | | gate | `BugseeInternal.addNetworkEvent`: `isStartedOrStarting()` (`BugseeInternal.java:975`); the provider only buffers 32 entries until it starts | `currentState == Launched` only (`Bugsee.m:2156`; `Launching` is dropped) | | attribution | none for network events (the channel only adds a source to `log`) | none (same) | @@ -342,7 +342,7 @@ Android `bugsee/bugsee-android` tag `v7.4.2`: `Bugsee.java` (`addNetworkEvent`, `contracts/exchange/NetworkEvent.java`, `capture/providers/network/BugseeCaptureDataProviderNetwork.java` (`onNetworkEvent`, `applyBodyFilters`, `filterEntry`, `FILTER_CALLBACK_TIMEOUT_MS`), `interception/network/NetworkEventsProducer.java` (`getRequestBody`, `getResponseBody`), `NetworkUtils.isSupportedMediaType`. -iOS `bugsee/bugsee-ios` `0581aa02c`: `Bugsee.m:2109-2166`, `BGSContracts.h` (`BGSWrapperChannel`), +iOS `bugsee/bugsee-cocoa` `0581aa02c` (beta7; at 7.0.0 `BGSWrapperChannel` is in `BugseeSPI.h`): `Bugsee.m:2109-2166`, `BGSContracts.h` (`BGSWrapperChannel`), `BGSWrapperChannelImpl.m`, `BGSExchangeFactory.m`, `BugseeNetworkEvent.{h,m}`, `BugseeConstants.{h,m}`, `Capture/Providers/BGSCaptureDataProviderNetwork.m`, `BGSCaptureDataEntryNetwork.m`, `Interception/Network/BGSNetworkInterceptionHelper.m`. diff --git a/doc/verification.md b/doc/verification.md index 1156623f..39973036 100644 --- a/doc/verification.md +++ b/doc/verification.md @@ -43,7 +43,7 @@ failure. | 9.1 | What the harness asserts, on every launch | |---|---| -| 9.1.1 which build | The SDK banner (`Bugsee Android SDK 7.4.2 [3b7af6371]`, `Bugsee IOS SDK ver:7.0.0-beta7 build:9854b7e50-15`) matches the version AND the build in `native-versions.json` (`android.sdkBuild`, `ios.sdkBuild`): a version string alone cannot tell two builds of one version apart. The wrapper's own log lines (registered and refined: type `flutter`, the pubspec version, Flutter, Dart, engine, build mode) match the toolchain that built it. The artefact set: Android `./gradlew :app:dependencies` has `bugsee-android` and `bugsee-android-ndk` at the pin, the Gradle plugin in the (private) Gradle home is the pinned 4.0.8 alone, the APK carries the four `libbugsee*.so`, the merged manifest keeps the wrapper provider at `initOrder` 200 (not stripped) ahead of the SDK's 100; iOS: SwiftPM resolved `bugsee/spm` and `bugsee/feedback-spm` at the pinned tag AND revision (`ios.spmRevision`), not a branch or a local path. | +| 9.1.1 which build | The SDK banner (`Bugsee Android SDK 7.4.2 [3b7af6371]`, `Bugsee IOS SDK ver:7.0.0 build:2b88480fa-7`) matches the version AND the build in `native-versions.json` (`android.sdkBuild`, `ios.sdkBuild`): a version string alone cannot tell two builds of one version apart. The wrapper's own log lines (registered and refined: type `flutter`, the pubspec version, Flutter, Dart, engine, build mode) match the toolchain that built it. The artefact set: Android `./gradlew :app:dependencies` has `bugsee-android` and `bugsee-android-ndk` at the pin, the Gradle plugin in the (private) Gradle home is the pinned 4.0.8 alone, the APK carries the four `libbugsee*.so`, the merged manifest keeps the wrapper provider at `initOrder` 200 (not stripped) ahead of the SDK's 100; iOS: SwiftPM resolved `bugsee/spm` and `bugsee/feedback-spm` at the pinned tag AND revision (`ios.spmRevision`), not a branch or a local path. | | 9.1.2 launched | The app reported `launch -> launched` and `status launched` before anything is concluded from an absence. | | 9.1.3 precondition | Staged facts are read back: data wiped (the app is gone), the right `versionCode`/`CFBundleVersion` installed, no retained bundle before a crash, airplane mode really on (`settings get global airplane_mode_on`), the crash data of build N still there after the update. | | 9.1.4 event | The process died of signal 11: logcat `Fatal signal 11 (SIGSEGV)` for that pid AND `ApplicationExitInfo` reason 5 status 11 (Android); launchd's `exited due to SIGSEGV` (followed by `sent by kill[...]`, iOS simulator). A hot restart really ran (`flutter run` printed it); a report really appeared for the command that should make one. | @@ -63,7 +63,7 @@ Nothing in the repository is modified by a run: the app is configured with build | Android SDK under test | `com.bugsee:bugsee-android` and `-ndk` 7.4.2 (banner build `3b7af6371`) | | Android device | AVD `phase7_api30`: Pixel 4 profile, API 30 (Android 11), `google_apis` arm64-v8a userdebug image, 1080x2280 at 440 dpi (2.75), 3 GB RAM, started headless (`-no-window -no-snapshot`), emulator 37.2.12 | | iOS toolchain | Xcode 27.1 (27A9275), iOS SDK 27.1 | -| iOS SDK under test | `bugsee/spm` 7.0.0-beta7 (revision `73ed983`, banner `build:9854b7e50-15`), `bugsee/feedback-spm` 7.0.0-beta7 (`40dd3b0`) | +| iOS SDK under test | `bugsee/spm` 7.0.0 (revision `bbfdda2`, banner `build:2b88480fa-7`), `bugsee/feedback-spm` 7.0.0 (`82054e7`); the results below were taken at 7.0.0-beta7 (`73ed983`, `build:9854b7e50-15`, feedback `40dd3b0`), see "The 7.0.0 pin move" | | iOS device | simulator `phase7-iphone`: iPhone 18 Pro, iOS 27.0 runtime (24A434), 3x | | Other tools | ffmpeg 7.1.1 and ffprobe (frames of the report video and screenshots), Python 3.14.6 (the mock API), `apkanalyzer` and `retrace` (cmdline-tools 13.0) | @@ -74,6 +74,25 @@ all run on the devices above where a device is needed (`xcodebuild test -collect The two devices were created for this work and shut down afterwards; other emulators and simulators on the host were never touched (every command names its own serial or UDID). +### The 7.0.0 pin move (2026-11-01) + +The iOS pin moved from 7.0.0-beta7 to the stable 7.0.0 (`bugsee/spm` `bbfdda2`, banner `build:2b88480fa-7`). The iOS part of the +harness was run again on a new simulator (iPhone 17, iOS 26.5, Xcode 27.1) with `--allow-dirty --allow-not-possible`: + +* **PASS: 8 (hot restart), 12/12 checks**, and the build, banner (`ver:7.0.0 build:2b88480fa-7`), wrapper identity, SwiftPM + revision and add-on registration guards of every scenario passed. +* **INVALID: 1, 2, 3, 4, 5, 7**, each at its first `upload` command ("no new bundle reached the mock API in 90 s"). Cause, measured: the SDK + posts `/v2/issues` (the mock answers 200) but never PUTs the bundle, because its background upload session cannot be created: + `nsurlsessiond` logs `Process with pid N does not have a bundle ID, rejecting connection` for the app launched by `simctl launch`. + This is the simulator environment, not the SDK version: the **beta7 build fails the same way on the same simulator today** + (checked by hand against the mock), and re-signing the app with its bundle identifier did not change it. Scenario 8, whose app is started by + `flutter run`, uploads normally. So the 4 scenarios that passed with beta7 on 2026-10-22 could not be re-measured here; nothing in them + failed for a product reason. +* **Crash reporter on the simulator: still none.** The `ios-arm64_x86_64-simulator` slice of `Bugsee.xcframework` 7.0.0 has 0 strings + matching `BGSCrashManager|PLCrashReporter`, the `ios-arm64` slice 28, so scenario 2 (and a recovered iOS report) remains NOT POSSIBLE + without a physical iPhone. +* Unit level, all passing: `flutter test` 1357, iOS XCTest 335 (core) + 23 (feedback) on the simulator, `flutter build ios` and the debug APK. + ## Results at a glance | # | Scenario | Android emulator API 30 | iOS 27.0 simulator | @@ -118,9 +137,9 @@ Android, debug and release (R8, `--obfuscate`), a cold start captured for 32 s: `{"type":"flutter","version":"10.0.0-dev.1","context":{"dart":"3.11.0","flutter":"3.41.0","flutter-engine":"3452d735bd","build-configuration":"debug"|"release"}}`, `sdk` `7.4.2` / `3b7af6371`, `app` `1.0.1` (`1`), and no `identity_source` (a live report is not recovered). -iOS: the log has `[BugseeFlutter] wrapper registered ...` before `Bugsee IOS SDK ver:7.0.0-beta7 build:9854b7e50-15`; +iOS (measured at 7.0.0-beta7, banner `build:9854b7e50-15`; the 7.0.0 banner `build:2b88480fa-7` was confirmed in the scenario 1 guards of the 2026-11-01 re-run): the log has `[BugseeFlutter] wrapper registered ...` before the `Bugsee IOS SDK ver:... build:...` banner; the feedback add-on registered through its `+load`; the build's `workspace-state.json` resolves `spm` and `feedback-spm` at -7.0.0-beta7 and the pinned revisions; the report's wrapper has the same identity with `build-configuration: debug`. +the pinned version (beta7 then) and revisions; the report's wrapper has the same identity with `build-configuration: debug`. Not applicable on iOS: manifest provider, NDK artefact, Gradle plugin. ### 2. Native crash (SIGSEGV), retained bundle, recovered identity diff --git a/doc/view-hierarchy.md b/doc/view-hierarchy.md index 45b54d6c..7ef5bffd 100644 --- a/doc/view-hierarchy.md +++ b/doc/view-hierarchy.md @@ -8,13 +8,12 @@ or redacting it**. Everything private about that tree is decided here. Sources of truth, read for this design: `bugsee/specs` `sdk/wrapper-data-requests` (the `vh` flow), `sdk/wrapper-workbook` Part 5.3 (units) and Part 6 (data requests, 6.7 async replies), `sdk/reporting/bundle/viewtree.md` -(privacy, the node vocabulary), the Android SDK at `v7.4.2` and the iOS SDK at `origin/nextgen@0581aa02c` -(= the 7.0.0-beta7 headers). Where they disagree, the SDK source is followed and the disagreement is listed under +(privacy, the node vocabulary), the Android SDK at `v7.4.2` and the iOS SDK at `0581aa02c` (the 7.0.0-beta7 source; the `vh` constants were re-extracted at 7.0.0, `origin/release@2b88480fa`). Where they disagree, the SDK source is followed and the disagreement is listed under [Spec gaps](#spec-gaps-found). ## What the SDKs do (from source) -| | Android 7.4.2 | iOS 7.0.0-beta7 (nextgen `0581aa02c`) | +| | Android 7.4.2 | iOS 7.0.0 (read at beta7 `0581aa02c`) | |---|---|---| | asked by | `BugseeCaptureDataProviderViewHierarchy.onBeforeSnapshotCreated` (every report snapshot, not while the process is terminating) and `Bugsee.captureViewHierarchy()`; one request per display, none for a blacked-out display or one with no top activity | `BGSCaptureDataProviderViewHierarchy -onBeforeSnapshotCreatedIsTerminating:` (same exceptions) and `+[Bugsee captureViewHierarchy]` | | thread of `requestData` | main (`ViewHierarchyBuilder.requestAdditionalData`, `@UiThread`) | main (`requestManagedHierarchyFromWrapper:`) | diff --git a/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index a1cdcf52..26277c6d 100644 --- a/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -5,8 +5,8 @@ "kind" : "remoteSourceControl", "location" : "https://github.com/bugsee/feedback-spm", "state" : { - "revision" : "40dd3b091ce96beb2faca0ad0df0b5df4e7c60b3", - "version" : "7.0.0-beta7" + "revision" : "82054e77e835933ab1d585863a97da625e0396b5", + "version" : "7.0.0" } }, { @@ -14,8 +14,8 @@ "kind" : "remoteSourceControl", "location" : "https://github.com/bugsee/spm", "state" : { - "revision" : "73ed98341d1243ffa7985f871417adcd0ad19799", - "version" : "7.0.0-beta7" + "revision" : "bbfdda2a9f1d7aadf73be6e94793b83d7a907aba", + "version" : "7.0.0" } } ], diff --git a/example/ios/Runner.xcworkspace/xcshareddata/swiftpm/Package.resolved b/example/ios/Runner.xcworkspace/xcshareddata/swiftpm/Package.resolved index a1cdcf52..26277c6d 100644 --- a/example/ios/Runner.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/example/ios/Runner.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -5,8 +5,8 @@ "kind" : "remoteSourceControl", "location" : "https://github.com/bugsee/feedback-spm", "state" : { - "revision" : "40dd3b091ce96beb2faca0ad0df0b5df4e7c60b3", - "version" : "7.0.0-beta7" + "revision" : "82054e77e835933ab1d585863a97da625e0396b5", + "version" : "7.0.0" } }, { @@ -14,8 +14,8 @@ "kind" : "remoteSourceControl", "location" : "https://github.com/bugsee/spm", "state" : { - "revision" : "73ed98341d1243ffa7985f871417adcd0ad19799", - "version" : "7.0.0-beta7" + "revision" : "bbfdda2a9f1d7aadf73be6e94793b83d7a907aba", + "version" : "7.0.0" } } ], diff --git a/ios/bugsee_flutter/Package.swift b/ios/bugsee_flutter/Package.swift index edf7415a..6a065b1f 100644 --- a/ios/bugsee_flutter/Package.swift +++ b/ios/bugsee_flutter/Package.swift @@ -16,7 +16,7 @@ let package = Package( .library(name: "bugsee-flutter", targets: ["bugsee_flutter"]) ], dependencies: [ - .package(url: "https://github.com/bugsee/spm", exact: "7.0.0-beta7") + .package(url: "https://github.com/bugsee/spm", exact: "7.0.0") ], targets: [ // Objective-C so `+load` can register the wrapper at image load, before diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter/Messages.g.swift b/ios/bugsee_flutter/Sources/bugsee_flutter/Messages.g.swift index 85f5d71e..050a83df 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter/Messages.g.swift +++ b/ios/bugsee_flutter/Sources/bugsee_flutter/Messages.g.swift @@ -1083,7 +1083,7 @@ struct LogLineMessage: Hashable, CustomStringConvertible { /// 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). /// diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterCreatedReportOps.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterCreatedReportOps.m index ae19f6d1..b9a5ab9f 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterCreatedReportOps.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterCreatedReportOps.m @@ -2,9 +2,9 @@ #import "BGSFlutterReportOps.h" -@import Bugsee; +@import Bugsee.SPI; -// `ATTACHMENTS_LIMIT` and `MAX_SIZE_ATTACHMENT` in `BGSAttachment.h` (nextgen). +// `ATTACHMENTS_LIMIT` and `MAX_SIZE_ATTACHMENT` in `BGSAttachment.h`. const NSUInteger BGSFlutterCreatedReportMaxAttachments = 3; const NSUInteger BGSFlutterCreatedReportMaxAttachmentBytes = 3u * 1024u * 1024u; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterExceptionOps.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterExceptionOps.m index 104594ec..9729ec64 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterExceptionOps.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterExceptionOps.m @@ -1,6 +1,6 @@ #import "BGSFlutterExceptionOps.h" -@import Bugsee; +@import Bugsee.SPI; static NSString *const kExceptionName = @"FlutterManagedException"; static const NSInteger kMaxPayloadLength = 262144; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterFacadeOps.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterFacadeOps.m index 26914b3e..851737e6 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterFacadeOps.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterFacadeOps.m @@ -2,7 +2,7 @@ #import "BGSFlutterReportOps.h" -@import Bugsee; +@import Bugsee.SPI; static NSString *const kInvalidArgument = @"invalid-argument"; static NSString *const kAttributeRejected = @"attribute-rejected"; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLaunchOps.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLaunchOps.m index 769877fe..a1cc7769 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLaunchOps.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLaunchOps.m @@ -1,6 +1,6 @@ #import "BGSFlutterLaunchOps.h" -@import Bugsee; +@import Bugsee.SPI; @implementation BGSFlutterRealBugsee diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLogOps.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLogOps.m index 25c2252f..b93f4388 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLogOps.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterLogOps.m @@ -2,7 +2,7 @@ #import "BGSFlutterNetworkOps.h" -@import Bugsee; +@import Bugsee.SPI; static const NSInteger kMinLevel = 1; static const NSInteger kMaxLevel = 5; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterNetworkOps.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterNetworkOps.m index 19a300f9..52c6a9c6 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterNetworkOps.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterNetworkOps.m @@ -1,6 +1,6 @@ #import "BGSFlutterNetworkOps.h" -@import Bugsee; +@import Bugsee.SPI; static NSString *const kStageBefore = @"before"; static NSString *const kStageRedirect = @"redirect"; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFileFlow.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFileFlow.m index 0f50e1f0..8bbebb53 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFileFlow.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFileFlow.m @@ -3,7 +3,7 @@ #import #import -@import Bugsee; +@import Bugsee.SPI; NSString *const BGSFlutterCreateBusy = @"create-busy"; NSString *const BGSFlutterCreateTimeout = @"create-timeout"; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFiles.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFiles.m index af486717..cb47574a 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFiles.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportFiles.m @@ -2,7 +2,7 @@ #import -@import Bugsee; +@import Bugsee.SPI; NSString *const BGSFlutterFileNotLive = @"not-live"; NSString *const BGSFlutterFileNotFound = @"file-not-found"; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportHandlerPipeline.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportHandlerPipeline.m index 9631c7ad..428c743f 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportHandlerPipeline.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportHandlerPipeline.m @@ -4,7 +4,7 @@ #import "BGSFlutterReportOps.h" -@import Bugsee; +@import Bugsee.SPI; const int64_t BGSFlutterReportLiveDeadlineMs = 20000; const int64_t BGSFlutterReportRecoveryDeadlineMs = 2000; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportOps.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportOps.m index aae06063..7c3d1618 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportOps.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterReportOps.m @@ -1,6 +1,6 @@ #import "BGSFlutterReportOps.h" -@import Bugsee; +@import Bugsee.SPI; NSErrorDomain const BGSFlutterReportOpsErrorDomain = @"com.bugsee.flutter.report-ops"; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterSecureRectangleStore.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterSecureRectangleStore.m index c836e7d2..fd67287a 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterSecureRectangleStore.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterSecureRectangleStore.m @@ -4,7 +4,7 @@ #include -/// Version meaning "unknown" (`BGSSecureRectanglesVersionUnknown` in the SDK's BGSContracts.h, +/// Version meaning "unknown" (`BGSSecureRectanglesVersionUnknown` in the SDK's BugseeSPI.h, /// not imported here so the store needs no SDK). static const int32_t kUnknownVersion = 0; static const NSInteger kHeaderInts = 2; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterWrapper.m b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterWrapper.m index 022c749d..714a81b9 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterWrapper.m +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/BGSFlutterWrapper.m @@ -6,7 +6,10 @@ #import "BGSFlutterSecureRectangleStore.h" #import "BGSFlutterViewHierarchyStore.h" -@import Bugsee; +// 7.0.0 moved the wrapper SPI (BGSWrapperChannel, BGSLifecycleEvent*, secure rectangles, report handler) out of +// `import Bugsee` into the `Bugsee.SPI` submodule (BugseeSPI.h; BGSContracts.h is now a private header that is not shipped). Every wrapper file +// that touches it asks for the submodule; the beta7 headers had it all in the main module. +@import Bugsee.SPI; // The wrapper identity on iOS, in one place. The type is the backend's // identifier (Dart: `wrapperType`); the version must equal `version:` in diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterFacadeOps.h b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterFacadeOps.h index 9357d83c..9852a8be 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterFacadeOps.h +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterFacadeOps.h @@ -64,7 +64,7 @@ NS_ASSUME_NONNULL_BEGIN /// the seam above. Dart validates first; this defends again. /// /// Before launch the wrapper queues and gates nothing: each SDK entry point does what it does -/// (doc/api-surface.md, per method, from iOS 7.0.0-beta7 source). Attributes (NSUserDefaults), the +/// (doc/api-surface.md, per method, from iOS 7.0.0 source). Attributes (NSUserDefaults), the /// user identifier (Keychain) and blackout (a flag the video provider reads) work; event, trace, /// log, breadcrumb, notification, the dialog and upload are dropped. @interface BGSFlutterFacadeOps : NSObject diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterLogOps.h b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterLogOps.h index 4a9ce4a6..3a0ec23e 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterLogOps.h +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterLogOps.h @@ -21,7 +21,7 @@ NS_ASSUME_NONNULL_BEGIN /// Log lines the Dart capture hands to the SDK (Phase 5d: `print`, `debugPrint`, `Bugsee.forwardLog`). /// -/// What the SDK would drop is not sent (iOS 7.0.0-beta7 source, `BGSWrapperChannelImpl.m`): the +/// What the SDK would drop is not sent (iOS 7.0.0 source, `BGSWrapperChannelImpl.m`): the /// channel takes lines while `Launching` or `Launched` (`bugseeAvailableForUserDumps`) and drops them /// with `capture.logs` off ("forwarded host output is automatic capture"). The source is ALWAYS /// `BGSLogEventSourceCustom` ("the host runtime's own logs"): the channel accepts five wrapper diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterNetworkOps.h b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterNetworkOps.h index 61e37d1e..ba72300b 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterNetworkOps.h +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterNetworkOps.h @@ -31,7 +31,7 @@ NS_ASSUME_NONNULL_BEGIN /// Network events the Dart capture hands to the SDK (Phase 5b). Dart's `dart:io` stack is invisible /// to the SDK's own interception, so the wrapper captures it in Dart and injects the events. /// -/// What the SDK would drop is not sent (iOS 7.0.0-beta7 source): `+[Bugsee addNetworkEvent:...]` +/// What the SDK would drop is not sent (iOS 7.0.0 source): `+[Bugsee addNetworkEvent:...]` /// takes events only while `Launched` (not `Launching`: the channel's own header says so), and /// `BGSCaptureDataProviderNetwork` only runs with `capture.network` on. Filtering is ALWAYS /// required (`requiresFiltering:YES`): the SDK's default sanitizer and the app's native filter see @@ -39,7 +39,7 @@ NS_ASSUME_NONNULL_BEGIN /// `body-without-type`) are enforced by the SDK on whatever arrives; Dart withholds a body the SDK /// would drop, so this only defends against a message that did not come from this Dart. /// -/// The iOS 7.0.0-beta7 exchange factory answers nil for `createNetworkEvent` ("not wired"), so the +/// The iOS 7.0.0 exchange factory answers nil for `createNetworkEvent` ("not wired"), so the /// event is a `BugseeNetworkEvent` built directly. Network events carry no source attribution at /// this version (only `log` does): `mechanism` (`dart:io`) says where an event came from. @interface BGSFlutterNetworkOps : NSObject diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportFiles.h b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportFiles.h index 687e6abc..da74757a 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportFiles.h +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportFiles.h @@ -24,7 +24,7 @@ FOUNDATION_EXPORT const NSUInteger BGSFlutterMaxAttachmentNameLength; FOUNDATION_EXPORT const NSUInteger BGSFlutterMaxMimeTypeLength; FOUNDATION_EXPORT const NSUInteger BGSFlutterMaxPathLength; FOUNDATION_EXPORT const unsigned long long BGSFlutterMaxScreenshotPixels; -/// `kBGSMaxReportAttachments` in the SDK (`BGSReport.m`, nextgen): the 1001st is refused. +/// `kBGSMaxReportAttachments` in the SDK (`BGSReport.m`): the 1001st is refused. FOUNDATION_EXPORT const NSUInteger BGSFlutterMaxReportAttachments; /// What a file operation did: finished (both nil), was refused with a reply code (`code`), or was diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportHandlerPipeline.h b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportHandlerPipeline.h index 70161416..9aeeee5c 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportHandlerPipeline.h +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterReportHandlerPipeline.h @@ -9,8 +9,8 @@ typedef NS_ENUM(NSInteger, BGSFlutterReportPhase) { }; /// How long Dart gets, per path. Ours is the SDK's budget LESS A MARGIN of a third of it (at most -/// 10 s), never more (workbook 7.3.5). From the iOS SDK (`origin/nextgen`, -/// `BGSIssueReportingCoordinator.{h,m}`, `BGSContracts.h` `BGSReportHandler`): +/// 10 s), never more (workbook 7.3.5). From the iOS SDK (`origin/release`, +/// `BGSIssueReportingCoordinator.{h,m}`, `BugseeSPI.h` `BGSReportHandler`): /// /// - LIVE (a report raised by the running app): handlers are called on the MAIN thread, one /// after another, and each completion is waited for, up to `reportHandlerCallbackTimeout` @@ -27,7 +27,7 @@ typedef NS_ENUM(NSInteger, BGSFlutterReportPhase) { /// - TERMINATING (`isTerminating = YES`): no producer exists on iOS today; if one appears /// the process dies when the handler returns. Never reaches Dart. /// -/// The SDK does not say which of the first two it is except by the thread (`BGSContracts.h`), +/// The SDK does not say which of the first two it is except by the thread (`BugseeSPI.h`), /// so that is the signal, used for the time budget and nothing else: never passed to Dart and /// never read as "this is a recovered crash" (workbook 7.2.3). FOUNDATION_EXPORT const int64_t BGSFlutterReportLiveDeadlineMs; diff --git a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterSecureRectangleStore.h b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterSecureRectangleStore.h index a3699938..0797de23 100644 --- a/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterSecureRectangleStore.h +++ b/ios/bugsee_flutter/Sources/bugsee_flutter_wrapper/include/BGSFlutterSecureRectangleStore.h @@ -78,7 +78,7 @@ typedef NS_ENUM(NSInteger, BGSFlutterPlacementKind) { /// identity, and the regions must survive that or the app is recorded /// unredacted until it next republishes. /// -/// What the SDK takes (iOS 7.0.0-beta7, BGSContracts.h `secureRectanglesForDisplay:`): +/// What the SDK takes (iOS 7.0.0, BugseeSPI.h `secureRectanglesForDisplay:`): /// a packed little-endian int32 `[version, count, l, t, r, b, ...]`; the rectangles /// are in POINTS in the screen's coordinate space, origin top-left, `r`/`b` exclusive /// (the SDK draws them as they are over the recorded frame, which is the screen), and diff --git a/ios/wrapper_tests/Package.swift b/ios/wrapper_tests/Package.swift index 05575921..5037a3aa 100644 --- a/ios/wrapper_tests/Package.swift +++ b/ios/wrapper_tests/Package.swift @@ -25,7 +25,7 @@ let package = Package( .library(name: "BugseeFlutterWrapper", targets: ["BugseeFlutterWrapper"]) ], dependencies: [ - .package(url: "https://github.com/bugsee/spm", exact: "7.0.0-beta7") + .package(url: "https://github.com/bugsee/spm", exact: "7.0.0") ], targets: [ .target( diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterCreatedReportOpsTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterCreatedReportOpsTests.m index c711d3bb..59172e2f 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterCreatedReportOpsTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterCreatedReportOpsTests.m @@ -1,6 +1,6 @@ #import -@import Bugsee; +@import Bugsee.SPI; #import "BGSFlutterCreatedReportOps.h" diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionOpsTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionOpsTests.m index 28abc7e5..2c82fc9b 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionOpsTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionOpsTests.m @@ -2,7 +2,7 @@ #import "BGSFlutterExceptionOps.h" -@import Bugsee; +@import Bugsee.SPI; /// A fake SDK behind the seam: records which entry point was called, with what. @interface BGSFakeExceptionSdk : NSObject diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionSignatureTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionSignatureTests.m index 7efa5381..0ceceb08 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionSignatureTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterExceptionSignatureTests.m @@ -2,7 +2,7 @@ #import "BGSFlutterExceptionOps.h" -@import Bugsee; +@import Bugsee.SPI; /// The SDK's OWN signature code (`BGSExceptionSignature`, which `+logException:reason:...` feeds with the /// exception's name, reason and frames, and which reads the `signature` KEY of a JSON reason) fed with diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFacadeOpsTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFacadeOpsTests.m index 8c2c2cdc..57bc7b0f 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFacadeOpsTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFacadeOpsTests.m @@ -2,7 +2,7 @@ #import "BGSFlutterFacadeOps.h" -@import Bugsee; +@import Bugsee.SPI; /// A fake SDK behind the seam: records every call; stores attributes like the real one (an /// oversized string is ignored, and the call still "succeeds"). diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFakeReport.h b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFakeReport.h index 34ed4753..a89c6ffc 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFakeReport.h +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterFakeReport.h @@ -1,5 +1,5 @@ @import Foundation; -@import Bugsee; +@import Bugsee.SPI; NS_ASSUME_NONNULL_BEGIN @@ -31,7 +31,7 @@ NS_ASSUME_NONNULL_BEGIN /// How many times `reportId` / `type` were read. @property(nonatomic) NSUInteger reads; -// ---- Attachments and screenshots: a model of what the SDK does (nextgen `BGSReport.m`) ---------- +// ---- Attachments and screenshots: a model of what the SDK does (`BGSReport.m`) ---------- /// The attachments the report holds (`BGSFlutterFakeAttachment`s). @property(nonatomic, readonly) NSMutableArray> *fakeAttachments; /// What each add received: `@{@"path"/@"data", @"name", @"mimeType", @"move"}`. diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLaunchOpsTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLaunchOpsTests.m index 797c72ab..b5b56daa 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLaunchOpsTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLaunchOpsTests.m @@ -2,7 +2,7 @@ #import "BGSFlutterLaunchOps.h" -@import Bugsee; +@import Bugsee.SPI; /// A fake SDK behind the seam: records what reaches it and answers as scripted. @interface BGSFakeBugsee : NSObject @@ -329,6 +329,25 @@ - (NSDictionary *)manifest { return [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL]; } +/// 7.0.0 keeps `BugseeDataEncryptionMode` in a private header the framework does not ship, so the +/// values cannot come from the compiler: they are the ones scripts/extract_report_enums.dart read +/// from BGSOptionsPrivate.h at the pinned source ref (test/fixtures/report_enums.json). +- (NSDictionary *)encryptionModeFromSdkSource { + NSString *path = [[[@(__FILE__) stringByDeletingLastPathComponent] + stringByAppendingPathComponent:@"../../../../test/fixtures/report_enums.json"] + stringByStandardizingPath]; + NSData *data = [NSData dataWithContentsOfFile:path]; + XCTAssertNotNil(data, @"%@", path); + NSDictionary *fixture = [NSJSONSerialization JSONObjectWithData:data options:0 error:NULL]; + NSDictionary *raw = fixture[@"ios"][@"BugseeDataEncryptionMode"]; + XCTAssertTrue(raw.count > 0); + NSMutableDictionary *out = [NSMutableDictionary dictionary]; + for (NSString *name in raw) { + out[[name stringByReplacingOccurrencesOfString:@"BugseeDataEncryption" withString:@""]] = raw[name]; + } + return out; +} + /// The enums the pinned framework compiles, by value, against the manifest the SDK published: a /// renumbered SDK or a stale manifest is seen (workbook 7.4.2, 7.4.3). - (void)testTheManifestEnumsAreTheFrameworksRealEnums { @@ -338,7 +357,7 @@ - (void)testTheManifestEnumsAreTheFrameworksRealEnums { @"BugseeSeverityLevel" : @{@"Low" : @(BugseeSeverityLow), @"Medium" : @(BugseeSeverityMedium), @"High" : @(BugseeSeverityHigh), @"Critical" : @(BugseeSeverityCritical), @"Blocker" : @(BugseeSeverityBlocker)}, @"BugseeStyle" : @{@"Light" : @(BugseeStyleLight), @"Dusk" : @(BugseeStyleDusk), @"BasedOnStatusBar" : @(BugseeStyleBasedOnStatusBar), @"System" : @(BugseeStyleSystem)}, @"BugseeLogLevel" : @{@"Error" : @(BugseeLogLevelError), @"Warning" : @(BugseeLogLevelWarning), @"Info" : @(BugseeLogLevelInfo), @"Debug" : @(BugseeLogLevelDebug), @"Verbose" : @(BugseeLogLevelVerbose)}, - @"BugseeDataEncryptionMode" : @{@"None" : @(BugseeDataEncryptionNone), @"OnDevice" : @(BugseeDataEncryptionOnDevice), @"EndToEnd" : @(BugseeDataEncryptionEndToEnd)}, + @"BugseeDataEncryptionMode" : [self encryptionModeFromSdkSource], @"BugseeCrashHandlerType" : @{@"BSD" : @(BugseeCrashHandlerTypeBSD), @"Mach" : @(BugseeCrashHandlerTypeMach), @"MachAndBSD" : @(BugseeCrashHandlerTypeMachAndBSD)}, }; NSMutableSet *seen = [NSMutableSet set]; diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLifecycleHubTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLifecycleHubTests.m index 10ecba5d..145dca32 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLifecycleHubTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLifecycleHubTests.m @@ -66,7 +66,7 @@ - (void)testUnknownNamesAreForwardedUnchanged { } - (void)testEveryRealSdkNameIsForwarded { - // From BGSContracts.h (BGSLifecycleEvent*), iOS origin/nextgen. Launching and + // From BugseeSPI.h (BGSLifecycleEvent*; BGSContracts.h until beta7), iOS origin/release. Launching and // Stopping have no BugseeLifecycleEventType: the SDK sends them to the wrapper // only. The two feedback names exist on Android; iOS does not emit them yet. NSArray *names = @[ diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLogOpsTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLogOpsTests.m index 92aed334..8eff841d 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLogOpsTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterLogOpsTests.m @@ -3,7 +3,7 @@ #import "BGSFlutterLogOps.h" #import "BGSFlutterNetworkOps.h" -@import Bugsee; +@import Bugsee.SPI; /// One recorded call to the fake SDK. @interface BGSLogCall : NSObject diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterNetworkOpsTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterNetworkOpsTests.m index 74a79f35..1ca3fdd9 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterNetworkOpsTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterNetworkOpsTests.m @@ -3,7 +3,7 @@ #import "BGSFlutterNetworkOps.h" #import "BGSFlutterWrapper.h" -@import Bugsee; +@import Bugsee.SPI; /// A fake SDK behind the seam: records every event handed to it. @interface BGSFakeNetworkSdk : NSObject diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterReportFileFlowTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterReportFileFlowTests.m index a954f8c5..153a37b3 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterReportFileFlowTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterReportFileFlowTests.m @@ -1,6 +1,6 @@ #import -@import Bugsee; +@import Bugsee.SPI; #import "BGSFlutterFakeReport.h" #import "BGSFlutterReportFileFlow.h" diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterSecureRectangleStoreTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterSecureRectangleStoreTests.m index c41a195e..8f0801ce 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterSecureRectangleStoreTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterSecureRectangleStoreTests.m @@ -4,7 +4,7 @@ #import "BGSFlutterSecureRectangleStore.h" /// Workbook Part 5 on iOS: units, rounding, versions, ownership. The SDK's unit here is POINTS in -/// the screen's coordinate space (BGSContracts.h, `secureRectanglesForDisplay:`). +/// the screen's coordinate space (BugseeSPI.h, `secureRectanglesForDisplay:`). /// A device a test can change between pulls. @interface BGSMockScreen : NSObject diff --git a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterWrapperTests.m b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterWrapperTests.m index 47e97606..000db5b2 100644 --- a/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterWrapperTests.m +++ b/ios/wrapper_tests/Tests/BugseeFlutterWrapperTests/BGSFlutterWrapperTests.m @@ -7,7 +7,7 @@ #import "BGSFlutterViewHierarchyStore.h" #import "BGSFlutterWrapper.h" -@import Bugsee; +@import Bugsee.SPI; /// A 3x phone: a Flutter logical pixel is a point, so the factor is 1. @interface BGSWrapperTestScreen : NSObject diff --git a/lib/src/bridge/messages.g.dart b/lib/src/bridge/messages.g.dart index 0fdeb1e4..2bf0fabe 100644 --- a/lib/src/bridge/messages.g.dart +++ b/lib/src/bridge/messages.g.dart @@ -1144,7 +1144,7 @@ class LogLineMessage { /// 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). class NetworkEventMessage { diff --git a/lib/src/options/bugsee_options.g.dart b/lib/src/options/bugsee_options.g.dart index 5e667d8a..33436f77 100644 --- a/lib/src/options/bugsee_options.g.dart +++ b/lib/src/options/bugsee_options.g.dart @@ -818,7 +818,7 @@ final class BugseeOptions { /// uploaded are never deleted. Values below `10` are treated as `10`. /// /// - Option key: `com.bugsee.option.config.max-data-size`. - /// - SDK default: `150` on Android, `50` on iOS. + /// - SDK default: `150`. /// - Available on: Android and iOS. final int? configMaxDataSize; @@ -828,7 +828,7 @@ final class BugseeOptions { /// /// - Option key: `com.bugsee.option.config.max-pending-report-age`. /// - SDK default: `30`. - /// - Available on: Android only. On iOS the option is ignored (a debug-mode warning says so). + /// - Available on: Android and iOS. final int? configMaxPendingReportAge; /// Maximum number of reports waiting to be sent. When exceeded, pending reports are deleted in @@ -836,7 +836,7 @@ final class BugseeOptions { /// /// - Option key: `com.bugsee.option.config.max-pending-reports`. /// - SDK default: `30`. - /// - Available on: Android only. On iOS the option is ignored (a debug-mode warning says so). + /// - Available on: Android and iOS. final int? configMaxPendingReports; /// Coalesce window in milliseconds before a notification-relay FIFO flush. `0` (the default) diff --git a/lib/src/options/endpoint.dart b/lib/src/options/endpoint.dart index dce7279f..48f75089 100644 --- a/lib/src/options/endpoint.dart +++ b/lib/src/options/endpoint.dart @@ -2,7 +2,7 @@ // // The workbook says the two SDKs spell it differently: iOS a flat `endpoint` key whose value // includes the API version, Android `com.bugsee.option.$$ENDPOINT` without it. That was true of -// the 6.x iOS SDK. At the pinned iOS 7.0.0-beta7 (nextgen commit d33dcc987, "namespaced endpoint +// the 6.x iOS SDK. At the pinned iOS 7.0.0 (commit d33dcc987, contained in the 7.0.0 source `origin/release@2b88480fa`, "namespaced endpoint // override with /v2 normalization"; `BGSURLResolver +normalizedAPIBase:`) iOS registers the same // hidden `com.bugsee.option.$$ENDPOINT` (the options manifest lists it for both SDKs), keeps the // flat `endpoint` only as a legacy alias, and strips every trailing API-version segment before diff --git a/lib/src/options/option_registry.g.dart b/lib/src/options/option_registry.g.dart index f554a8b3..cb0465ba 100644 --- a/lib/src/options/option_registry.g.dart +++ b/lib/src/options/option_registry.g.dart @@ -2,7 +2,7 @@ // (test/fixtures/option_manifests). Do not edit by hand. // // Android 7.4.2 (manifest generatedAt 2026-10-19T07:03:45Z) -// iOS 7.0.0-beta7 (manifest generatedAt 2026-10-18T04:41:18Z) +// iOS 7.0.0 (manifest generatedAt 2026-10-30T19:10:39Z) import 'option_registry.dart'; @@ -451,7 +451,7 @@ const List optionSpecs = [ hidden: false, typed: true, android: PlatformOption(module: 'bugsee-android', defaultValue: 150), - ios: PlatformOption(module: 'Bugsee', defaultValue: 50), + ios: PlatformOption(module: 'Bugsee', defaultValue: 150), ), OptionSpec( key: 'com.bugsee.option.config.max-pending-report-age', @@ -459,6 +459,7 @@ const List optionSpecs = [ hidden: false, typed: true, android: PlatformOption(module: 'bugsee-android', defaultValue: 30), + ios: PlatformOption(module: 'Bugsee', defaultValue: 30), ), OptionSpec( key: 'com.bugsee.option.config.max-pending-reports', @@ -466,6 +467,7 @@ const List optionSpecs = [ hidden: false, typed: true, android: PlatformOption(module: 'bugsee-android', defaultValue: 30), + ios: PlatformOption(module: 'Bugsee', defaultValue: 30), ), OptionSpec( key: 'com.bugsee.option.config.notify-flush-delay', diff --git a/lib/src/report/attachments.dart b/lib/src/report/attachments.dart index f577dc26..7a79689b 100644 --- a/lib/src/report/attachments.dart +++ b/lib/src/report/attachments.dart @@ -15,8 +15,8 @@ const int maxAttachmentBytes = 1024 * 1024; /// 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 (Android 7.4.2 can register an add that finished after processing was scheduled: the plugin -/// undoes it, but a copy that long is the cause). `config.max-data-size` (default 50 on iOS, 150 on -/// Android) bounds everything a report may hold. A bigger file is [ReportAttachmentFailure.tooLarge]. +/// undoes it, but a copy that long is the cause). `config.max-data-size` (default 150 on both; iOS up to +/// 7.0.0-beta7: 50) bounds everything a report may hold. A bigger file is [ReportAttachmentFailure.tooLarge]. /// Repeated in Java (`ReportOps.MAX_ATTACHMENT_FILE_BYTES`) and Objective-C. const int maxAttachmentFileBytes = 20 * 1024 * 1024; diff --git a/lib/src/report/report_enums.dart b/lib/src/report/report_enums.dart index d3fb2cbf..be77d1c1 100644 --- a/lib/src/report/report_enums.dart +++ b/lib/src/report/report_enums.dart @@ -8,7 +8,7 @@ // // The values are repeated from the SDK sources, not invented: // `test/fixtures/report_enums.json` is extracted from Android `IssueSeverity` / -// `IssueType` (v7.4.2) and iOS `BugseeSeverityLevel` (7.0.0-beta7) by +// `IssueType` (v7.4.2) and iOS `BugseeSeverityLevel` (7.0.0) by // `scripts/extract_report_enums.dart`, and `test/report_enum_parity_test.dart` // compares this file with BOTH platforms, so a divergence in either is seen. diff --git a/native-versions.json b/native-versions.json index 45debe4d..e298953b 100644 --- a/native-versions.json +++ b/native-versions.json @@ -20,14 +20,14 @@ } }, "ios": { - "sdk": "7.0.0-beta7", - "sdkBuild": "9854b7e50-15", - "spmRevision": "73ed98341d1243ffa7985f871417adcd0ad19799", - "feedbackSpmRevision": "40dd3b091ce96beb2faca0ad0df0b5df4e7c60b3", + "sdk": "7.0.0", + "sdkBuild": "2b88480fa-7", + "spmRevision": "bbfdda2a9f1d7aadf73be6e94793b83d7a907aba", + "feedbackSpmRevision": "82054e77e835933ab1d585863a97da625e0396b5", "spmUrl": "https://github.com/bugsee/spm", "feedbackSpmUrl": "https://github.com/bugsee/feedback-spm", "deploymentTarget": "15.0", - "provenance": "Tag 7.0.0-beta7 of bugsee/spm (73ed983) and bugsee/feedback-spm (40dd3b0). sdkBuild is what the SDK prints in its banner (`Bugsee IOS SDK ver:7.0.0-beta7 build:9854b7e50-15`), read from a simulator run on 2026-10-22 and matched by the device verification harness (workbook 9.1.1)." + "provenance": "Stable 7.0.0 (moved from 7.0.0-beta7 on 2026-11-01): tag 7.0.0 of bugsee/spm (bbfdda2) and bugsee/feedback-spm (82054e7), SDK source `origin/release@2b88480fa` of bugsee/bugsee-cocoa (the iOS source repository has no 7.x tag). sdkBuild is what the SDK prints in its banner (`Bugsee IOS SDK ver:7.0.0 build:2b88480fa-7`: the commit and its count), read from a simulator run on 2026-11-01 and matched by the device verification harness (workbook 9.1.1). The beta7 build was `9854b7e50-15`." }, "feedback": { "package": "bugsee_flutter_feedback", @@ -43,6 +43,6 @@ "optionsManifest": { "urlTemplate": "https://download.bugsee.com/sdk/options/{sdk}/{version}.json", "fixtureDir": "test/fixtures/option_manifests", - "provenance": "Both SDKs publish an immutable options-manifest.json per release (bugsee/specs sdk/options, manifestVersion 1), generated from the live option registry: android/7.4.2.json (generatedAt 2026-10-19) and ios/7.0.0-beta7.json (generatedAt 2026-10-18), fetched 2026-10-21 and vendored verbatim as android.json / ios.json in fixtureDir. `dart scripts/sync_option_manifests.dart --check` (weekly, native-pins.yml) refetches and diffs; everything else reads the committed copies offline." + "provenance": "Both SDKs publish an immutable options-manifest.json per release (bugsee/specs sdk/options, manifestVersion 1), generated from the live option registry: android/7.4.2.json (generatedAt 2026-10-19) and ios/7.0.0.json (generatedAt 2026-10-30), android fetched 2026-10-21, ios 2026-11-01, vendored verbatim as android.json / ios.json in fixtureDir. `dart scripts/sync_option_manifests.dart --check` (weekly, native-pins.yml) refetches and diffs; everything else reads the committed copies offline." } } diff --git a/packages/bugsee_flutter_feedback/CHANGELOG.md b/packages/bugsee_flutter_feedback/CHANGELOG.md index 6c21ed40..7dac4d4b 100644 --- a/packages/bugsee_flutter_feedback/CHANGELOG.md +++ b/packages/bugsee_flutter_feedback/CHANGELOG.md @@ -4,7 +4,7 @@ The first version, released in lock-step with `bugsee_flutter` (same version num * The in-app feedback chat as a separate package, so apps that never show it do not carry its UI (SwiftUI on iOS, Jetpack Compose on Android). * `BugseeFeedback.show`, `setGreeting`, `isAvailable`, and the `messagesReceived` and `messageSent` streams (they fire only while the chat is - on screen), over the feedback modules of the 7.x SDKs (`com.bugsee:bugsee-android-feedback` 7.4.2, `feedback-spm` 7.0.0-beta7). Errors are + on screen), over the feedback modules of the 7.x SDKs (`com.bugsee:bugsee-android-feedback` 7.4.2, `feedback-spm` 7.0.0). Errors are `BugseeFeedbackException`s with a `reason` (`notRegistered`, `incompatibleCore`, `nativeError`). * Replaces the 9.x `Bugsee.showFeedbackUI`, `setDefaultFeedbackGreeting` and `setNewFeedbackMessagesCallback`. * Nothing to configure beyond adding the package next to `bugsee_flutter` at the same version: the module registers itself (Android through the diff --git a/packages/bugsee_flutter_feedback/README.md b/packages/bugsee_flutter_feedback/README.md index 28fe1ec4..856027d3 100644 --- a/packages/bugsee_flutter_feedback/README.md +++ b/packages/bugsee_flutter_feedback/README.md @@ -95,8 +95,8 @@ That is the whole API, because it is all both SDKs have: show the chat, the gree SDK has an unread count, a notification setting, an option key for the chat, or a separate user name or e-mail (the chat asks the user for an e-mail address itself, and skips that screen when the identifier you set with `Bugsee.setUserIdentifier` contains an `@`). The chat's colours (`FeedbackAppearance` on Android, `BugseeTheme` on iOS) are -not exposed, like the core's appearance system (see `doc/api-surface.md` of `bugsee_flutter`): the iOS 7.0.0-beta7 chat does not read -`BugseeTheme` anyway. The details, with source references, are in [doc/feedback.md](doc/feedback.md). +not exposed, like the core's appearance system (see `doc/api-surface.md` of `bugsee_flutter`): the iOS 7.0.0 chat does read +`BugseeTheme`, so they could be exposed later. The details, with source references, are in [doc/feedback.md](doc/feedback.md). Call it after `Bugsee.launch`: on Android `show()` does nothing before the SDK has launched; on iOS it presents a chat that cannot reach the backend. diff --git a/packages/bugsee_flutter_feedback/doc/feedback.md b/packages/bugsee_flutter_feedback/doc/feedback.md index 553157be..b7aa9a6d 100644 --- a/packages/bugsee_flutter_feedback/doc/feedback.md +++ b/packages/bugsee_flutter_feedback/doc/feedback.md @@ -2,7 +2,7 @@ The feedback package (PLAN.md, decision D4: a separate package, mirroring the native split and the React Native SDK's `@bugsee/react-native-feedback`). Sources read: Android `bugsee/bugsee-android` tag `v7.4.2` (`3b7af6371`), module -`feedback/` and `.claude/rules/extensions.md`; iOS `bugsee/feedback-spm` tag `7.0.0-beta7` (`40dd3b0`, the same sources +`feedback/` and `.claude/rules/extensions.md`; iOS `bugsee/feedback-spm` tag `7.0.0` (`82054e7`, the same sources as `bugsee/bugsee-ios` `feedback/`); the Bugsee Gradle plugin `bugsee-android-gradle-plugin` (`instrumentation/extensions_init/ExtensionSpec.kt`, `BugseePluginExtension.kt`). @@ -16,7 +16,7 @@ as `bugsee/bugsee-ios` `feedback/`); the Bugsee Gradle plugin `bugsee-android-gr | unread count, notification settings | none | none | not invented | | option keys | none: the published options manifests (`test/fixtures/option_manifests`) list modules `bugsee-android`, `bugsee-android-leak`, `bugsee-android-ndk` only | none | nothing to type | | user identity | reads `Bugsee.setUserIdentifier`: a value containing `@` pre-fills the e-mail and skips the e-mail screen (`BugseeFeedback.prefillEmailFromUserIdentifier`) | same (`FeedbackEmailPreferences.prefill(fromUserIdentifier:)`) | documented; `Bugsee.setUserIdentifier` is the core's | -| appearance | `FeedbackAppearance` keys through `Bugsee.getAppearance()` | `BugseeTheme.feedback*` (the 7.0.0-beta7 SwiftUI chat does not read it) | **skip**, like the core's appearance system | +| appearance | `FeedbackAppearance` keys through `Bugsee.getAppearance()` | `BugseeTheme.feedback*` (the 7.0.0 SwiftUI chat reads `Bugsee.getAppearance()`: `feedbackBackgroundColor`, `feedbackEmailBackgroundColor`, `feedbackEmailContinueActiveColor` / `...NotActiveColor`, in `BugseeFeedback.swift` and `FeedbackEmailView.swift`) | **skip** for now: the appearance keys are simply not exposed yet, like the core's appearance system | | lifecycle events | `BeforeFeedbackShown` / `AfterFeedbackShown` (`FeedbackLifecycleEvents`) are dispatched | declared (`BugseeLifecycleEventBeforeFeedbackShown`) but "not dispatched yet" (`BugseeConstants.h`) | already carried as names by the core's `lifecycleEvents` stream; nothing added | | message objects | `FeedbackMessage` / `FeedbackMessageType` (contract types, not delivered by the listener) | `BugseeFeedbackMessage` (Swift only, not delivered) | **skip**: the listeners deliver text only | diff --git a/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Package.swift b/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Package.swift index ed8628e7..b6c62246 100644 --- a/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Package.swift +++ b/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Package.swift @@ -17,8 +17,8 @@ let package = Package( .library(name: "bugsee-flutter-feedback", targets: ["bugsee_flutter_feedback"]) ], dependencies: [ - .package(url: "https://github.com/bugsee/spm", exact: "7.0.0-beta7"), - .package(url: "https://github.com/bugsee/feedback-spm", exact: "7.0.0-beta7") + .package(url: "https://github.com/bugsee/spm", exact: "7.0.0"), + .package(url: "https://github.com/bugsee/feedback-spm", exact: "7.0.0") ], targets: [ // Objective-C so `+load` can register the add-on at image load, before the SDK can be diff --git a/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Sources/bugsee_flutter_feedback_wrapper/BGSFlutterFeedbackOps.m b/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Sources/bugsee_flutter_feedback_wrapper/BGSFlutterFeedbackOps.m index 03b9e9b5..de7c3855 100644 --- a/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Sources/bugsee_flutter_feedback_wrapper/BGSFlutterFeedbackOps.m +++ b/packages/bugsee_flutter_feedback/ios/bugsee_flutter_feedback/Sources/bugsee_flutter_feedback_wrapper/BGSFlutterFeedbackOps.m @@ -1,6 +1,6 @@ #import "BGSFlutterFeedbackOps.h" -@import Bugsee; +@import Bugsee.SPI; @import BugseeFeedback; static NSString *const kNotRegistered = @"not-registered"; diff --git a/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Package.swift b/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Package.swift index 91bdf675..27d01272 100644 --- a/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Package.swift +++ b/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Package.swift @@ -26,8 +26,8 @@ let package = Package( .library(name: "BugseeFlutterFeedbackWrapper", targets: ["BugseeFlutterFeedbackWrapper"]) ], dependencies: [ - .package(url: "https://github.com/bugsee/spm", exact: "7.0.0-beta7"), - .package(url: "https://github.com/bugsee/feedback-spm", exact: "7.0.0-beta7") + .package(url: "https://github.com/bugsee/spm", exact: "7.0.0"), + .package(url: "https://github.com/bugsee/feedback-spm", exact: "7.0.0") ], targets: [ .target( diff --git a/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Tests/BugseeFlutterFeedbackWrapperTests/BGSFlutterFeedbackOpsTests.m b/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Tests/BugseeFlutterFeedbackWrapperTests/BGSFlutterFeedbackOpsTests.m index 746f9266..185969e5 100644 --- a/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Tests/BugseeFlutterFeedbackWrapperTests/BGSFlutterFeedbackOpsTests.m +++ b/packages/bugsee_flutter_feedback/ios/feedback_wrapper_tests/Tests/BugseeFlutterFeedbackWrapperTests/BGSFlutterFeedbackOpsTests.m @@ -1,7 +1,7 @@ #import @import BugseeFlutterFeedbackWrapper; -@import Bugsee; +@import Bugsee.SPI; @import BugseeFeedback; /// The add-on's module: records what reaches it. diff --git a/pigeons/bridge.dart b/pigeons/bridge.dart index ea5b5efe..449e6abb 100644 --- a/pigeons/bridge.dart +++ b/pigeons/bridge.dart @@ -363,7 +363,7 @@ class LogLineMessage { /// 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). class NetworkEventMessage { diff --git a/scripts/device/core/expectations.dart b/scripts/device/core/expectations.dart index e15c03d4..048dc323 100644 --- a/scripts/device/core/expectations.dart +++ b/scripts/device/core/expectations.dart @@ -55,7 +55,7 @@ class Pins { final int minSdk; final String iosSdk; - /// The build the iOS SDK's banner prints for [iosSdk] (`Bugsee IOS SDK ver:7.0.0-beta7 build:...`). + /// The build the iOS SDK's banner prints for [iosSdk] (`Bugsee IOS SDK ver:7.0.0 build:...`). final String iosSdkBuild; /// The git revisions of bugsee/spm and bugsee/feedback-spm at [iosSdk]: what SwiftPM must resolve. diff --git a/scripts/device/core/log_parsers.dart b/scripts/device/core/log_parsers.dart index 99737e97..08ea7b61 100644 --- a/scripts/device/core/log_parsers.dart +++ b/scripts/device/core/log_parsers.dart @@ -7,7 +7,7 @@ import 'dart:convert'; import 'zip.dart'; /// The SDK's own banner: Android `Bugsee Android SDK 7.4.2 [3b7af6371]`, iOS -/// `Bugsee IOS SDK ver:7.0.0-beta7 build:...`. +/// `Bugsee IOS SDK ver:7.0.0 build:...`. class SdkBanner { const SdkBanner(this.platform, this.version, this.build); final String platform; diff --git a/scripts/extract_data_requests.dart b/scripts/extract_data_requests.dart index f0d65f99..12789528 100644 --- a/scripts/extract_data_requests.dart +++ b/scripts/extract_data_requests.dart @@ -5,14 +5,15 @@ // spec, or from the wrapper itself, cannot see the SDK change). // // Run (the iOS constants are in a .m the shipped binary does not expose, so they come from the -// nextgen commit named by --ios-source-ref; no 7.0.0-beta7 tag exists in the iOS repository): +// commit named by --ios-source-ref (the iOS repository has no 7.x tag; 7.0.0 is `origin/release` at +// 2b88480fa, the build the 7.0.0 banner names: `build:2b88480fa-7`): // // git -C show v7.4.2:library/src/main/java/com/bugsee/library/contracts/internal/DataRequestTypes.java > /tmp/DataRequestTypes.java // git -C show v7.4.2:library/src/main/java/com/bugsee/library/capture/providers/vh/BugseeCaptureDataProviderViewHierarchy.java > /tmp/AndroidVH.java -// git -C show origin/nextgen:BugseeDev/BugseeLib/BugseeLib/Capture/Providers/ViewHierarchy/BGSCaptureDataProviderViewHierarchy.m > /tmp/IosVH.m +// git -C show 2b88480fa:BugseeDev/BugseeLib/BugseeLib/Capture/Providers/ViewHierarchy/BGSCaptureDataProviderViewHierarchy.m > /tmp/IosVH.m // dart scripts/extract_data_requests.dart --android-types /tmp/DataRequestTypes.java \ // --android-provider /tmp/AndroidVH.java --ios-provider /tmp/IosVH.m \ -// --ios-source-ref origin/nextgen@0581aa02c [--check] +// --ios-source-ref origin/release@2b88480fa [--check] // // `--check` compares with the committed fixture instead of writing it. The fixture records the // pins it was extracted at; the drift test fails when they stop matching native-versions.json. diff --git a/scripts/extract_option_docs.dart b/scripts/extract_option_docs.dart index 66818c89..eb4d7c27 100644 --- a/scripts/extract_option_docs.dart +++ b/scripts/extract_option_docs.dart @@ -9,7 +9,7 @@ // property (`propertyKeyMap` in `BugseeOptions.m` maps one to the other) // // dart scripts/extract_option_docs.dart --android-repo --android-ref v7.4.2 \ -// --ios-repo --ios-ref origin/nextgen [--check] +// --ios-repo --ios-ref origin/release [--check] // // `--check` compares with the committed fixture instead of writing it. Needs the (private) SDK // checkouts, so it is a local check; the fixture records the refs it was read from, and the @@ -233,7 +233,7 @@ String show(String repo, String ref, String path) { return r.stdout as String; } -/// `ref@`: a moving ref (`origin/nextgen`) is recorded with what it pointed at. +/// `ref@`: a moving ref (`origin/release`) is recorded with what it pointed at. String pinned(String repo, String ref) { final r = Process.runSync('git', ['-C', repo, 'rev-parse', '--short=9', ref]); if (r.exitCode != 0) throw StateError('git rev-parse $ref: ${r.stderr}'); diff --git a/scripts/extract_report_enums.dart b/scripts/extract_report_enums.dart index 22336b20..7a2d63c7 100644 --- a/scripts/extract_report_enums.dart +++ b/scripts/extract_report_enums.dart @@ -8,27 +8,28 @@ // // git -C show v7.4.2:library/src/main/java/com/bugsee/library/contracts/options/IssueSeverity.java > /tmp/IssueSeverity.java // git -C show v7.4.2:library/src/main/java/com/bugsee/library/contracts/options/IssueType.java > /tmp/IssueType.java -// # iOS: the headers the pinned xcframework ships (Bugsee.framework/Headers) +// # iOS: BugseeConstants.h and BugseeSPI.h (7.0.0 moved the SPI out of BGSContracts.h, a private header that is not shipped) of the SDK repo at 2b88480fa // dart scripts/extract_report_enums.dart --android-severity /tmp/IssueSeverity.java \ // --android-type /tmp/IssueType.java --ios-constants .../BugseeConstants.h \ -// --ios-contracts .../BGSContracts.h \ +// --ios-contracts .../BugseeSPI.h \ // --android-coordinator /tmp/BugseeIssueReportingCoordinator.java \ // --android-chain /tmp/ReportHandlerChain.java --android-options /tmp/OptionsDescriptors.java \ -// --ios-coordinator /tmp/BGSIssueReportingCoordinator.m --ios-source-ref origin/nextgen@0581aa02c \ -// --android-report /tmp/IssueReport.java --ios-report /tmp/BGSReport.m --ios-attachment /tmp/BGSAttachment.h [--check] +// --ios-coordinator /tmp/BGSIssueReportingCoordinator.m --ios-source-ref origin/release@2b88480fa \ +// --android-report /tmp/IssueReport.java --ios-report /tmp/BGSReport.m --ios-attachment /tmp/BGSAttachment.h \ +// --ios-options-private .../BGSOptionsPrivate.h [--check] // // (Phase 6) The same fixture carries the SDKs' ATTACHMENT limits: Android `IssueReport.MAX_ATTACHMENTS` // (v7.4.2, `library/src/main/java/com/bugsee/library/reporting/IssueReport.java`), iOS // `kBGSMaxReportAttachments` (`BGSReport.m`) and the legacy `BugseeExtendedReport` rules // `ATTACHMENTS_LIMIT` / `MAX_SIZE_ATTACHMENT` (`BGSAttachment.h`), all `BugseeDev/BugseeLib/BugseeLib/` at -// the nextgen commit of --ios-source-ref, so the wrapper's copies of those numbers are compared with +// the commit of --ios-source-ref, so the wrapper's copies of those numbers are compared with // the SDKs', never with themselves. // // The same fixture also carries the SDKs' report-handler TIMINGS (workbook 7.3.5), read from // source, so the wrapper's deadlines are compared with the SDK's real numbers and not with // copies of themselves. The iOS timings are constants of a .m that the shipped binary does not -// expose: they come from the nextgen commit named by --ios-source-ref (no 7.0.0-beta7 tag exists -// in the iOS SDK repository; the shipped headers equal nextgen's). +// expose: they come from the commit named by --ios-source-ref (the iOS repository has no 7.x +// tag; 7.0.0 is `origin/release` at 2b88480fa, the commit the 7.0.0 banner `build:2b88480fa-7` names). // // `--check` compares with the committed fixture instead of writing it. The fixture // records the pins it was extracted at; test/report_enum_parity_test.dart fails when @@ -183,6 +184,7 @@ Map extract({ required String androidReport, required String iosReport, required String iosAttachment, + required String iosOptionsPrivate, required String iosSourceRef, required Map pins, }) => { @@ -208,6 +210,12 @@ Map extract({ }, 'ios': { 'BugseeSeverityLevel': objcEnum(iosConstants, 'BugseeSeverityLevel'), + // Not in a shipped header at 7.0.0 (BGSOptionsPrivate.h), so the XCTest cannot read it from the + // framework: the source's values are the fixture, compared with the published manifest. + 'BugseeDataEncryptionMode': objcEnum( + iosOptionsPrivate, + 'BugseeDataEncryptionMode', + ), 'issueTypeStrings': iosTypeStrings(iosContracts), 'reportHandlerTimings': { 'source': iosSourceRef, @@ -266,6 +274,9 @@ void main(List args) { androidReport: File(arg(args, '--android-report')).readAsStringSync(), iosReport: File(arg(args, '--ios-report')).readAsStringSync(), iosAttachment: File(arg(args, '--ios-attachment')).readAsStringSync(), + iosOptionsPrivate: File( + arg(args, '--ios-options-private'), + ).readAsStringSync(), iosSourceRef: arg(args, '--ios-source-ref'), pins: { 'android': (versions['android'] as Map)['sdk'], diff --git a/scripts/verify_option_manifests.dart b/scripts/verify_option_manifests.dart index fc6acdc1..d21a7bbf 100644 --- a/scripts/verify_option_manifests.dart +++ b/scripts/verify_option_manifests.dart @@ -3,7 +3,7 @@ // // dart scripts/verify_option_manifests.dart \ // --android-repo --android-ref v7.4.2 \ -// --ios-repo --ios-ref origin/nextgen +// --ios-repo --ios-ref origin/release // // The manifests are generated by the SDKs from their live registries and are the // authority (scripts/sync_option_manifests.dart); this exists to catch a manifest that @@ -38,6 +38,8 @@ const iosDescriptors = 'BugseeDev/BugseeLib/BugseeLib/BGSOptionsDescriptors.m'; const iosEnumFiles = [ 'BugseeDev/BugseeLib/BugseeLib/BugseeConstants.h', 'BugseeDev/BugseeLib/BugseeLib/Interception/Log/BugseeLogger.h', + // 7.0.0 moved `BugseeDataEncryptionMode` out of the public header (encryption is not public API yet). + 'BugseeDev/BugseeLib/BugseeLib/BGSOptionsPrivate.h', ]; /// `String Name = "com.bugsee.option...";` declarations (Android), `$$` keys included. diff --git a/test/check_native_pins_test.dart b/test/check_native_pins_test.dart index b4650b75..174d7d96 100644 --- a/test/check_native_pins_test.dart +++ b/test/check_native_pins_test.dart @@ -6,7 +6,7 @@ import '../scripts/check_native_pins.dart'; const pins = { 'android': {'sdk': '7.4.2', 'gradlePlugin': '4.0.8'}, 'ios': { - 'sdk': '7.0.0-beta7', + 'sdk': '7.0.0', 'spmUrl': 'https://github.com/bugsee/spm', 'feedbackSpmUrl': 'https://github.com/bugsee/feedback-spm', }, @@ -17,8 +17,8 @@ PinReport run({ List sdk = const ['7.4.1', '7.4.2'], List ndk = const ['7.4.2'], List plugin = const ['4.0.7', '4.0.8'], - List spm = const ['7.0.0-beta7'], - List feedback = const ['7.0.0-beta7'], + List spm = const ['7.0.0'], + List feedback = const ['7.0.0'], List androidFeedback = const ['7.4.2'], }) => evaluate( pins, @@ -72,7 +72,10 @@ void main() { expect(run(ndk: []).errors.single, contains('bugsee-android-ndk')); expect(run(plugin: ['4.0.7']).errors.single, contains('gradle plugin')); expect(run(spm: []).errors.single, contains('bugsee/spm')); - expect(run(feedback: ['7.0.0']).errors.single, contains('feedback-spm')); + expect( + run(feedback: ['7.0.0-beta7']).errors.single, + contains('feedback-spm'), + ); expect( run(androidFeedback: ['7.4.1']).errors.single, contains('bugsee-android-feedback 7.4.2'), diff --git a/test/device_harness_test.dart b/test/device_harness_test.dart index 60338565..5365792a 100644 --- a/test/device_harness_test.dart +++ b/test/device_harness_test.dart @@ -124,10 +124,10 @@ void main() { flutter = "3.41.0"; "flutter-engine" = 3452d735bd; } -2026-10-22 11:19:15.375 Df Runner[60233:9e1d3b5] (Bugsee) Bugsee IOS SDK ver:7.0.0-beta7 build:9854b7e50-15 +2026-10-22 11:19:15.375 Df Runner[60233:9e1d3b5] (Bugsee) Bugsee IOS SDK ver:7.0.0 build:2b88480fa-7 '''; final b = parseIosBanner(log)!; - expect([b.version, b.build], ['7.0.0-beta7', '9854b7e50-15']); + expect([b.version, b.build], ['7.0.0', '2b88480fa-7']); final w = parseWrapperLog(log); expect(w.context['build-configuration'], 'debug'); expect(w.context['flutter-engine'], '3452d735bd'); diff --git a/test/endpoint_test.dart b/test/endpoint_test.dart index 0baeca2f..818efafc 100644 --- a/test/endpoint_test.dart +++ b/test/endpoint_test.dart @@ -92,7 +92,7 @@ void main() { expect( spec.ios, isNotNull, - reason: 'iOS 7.0.0-beta7 registers it too (it did not in 6.x)', + reason: 'iOS 7.0.0 registers it too (it did not in 6.x)', ); expect(spec.typed, isFalse); }); diff --git a/test/fixtures/data_requests.json b/test/fixtures/data_requests.json index 44f9444d..4695ad93 100644 --- a/test/fixtures/data_requests.json +++ b/test/fixtures/data_requests.json @@ -2,7 +2,7 @@ "_comment": "Extracted from the native SDK sources by scripts/extract_data_requests.dart; do not edit by hand. Compared by test/view_hierarchy_drift_test.dart.", "pins": { "android": "7.4.2", - "ios": "7.0.0-beta7" + "ios": "7.0.0" }, "android": { "vhType": "vh", @@ -11,7 +11,7 @@ "waitsForReplyOffMainThreadOnly": true }, "ios": { - "source": "origin/nextgen@0581aa02c", + "source": "origin/release@2b88480fa", "vhType": "vh", "vhBudgetMs": 500, "silentBudgetMs": 50, diff --git a/test/fixtures/option_manifests/docs.json b/test/fixtures/option_manifests/docs.json index 85f05de0..037f9a55 100644 --- a/test/fixtures/option_manifests/docs.json +++ b/test/fixtures/option_manifests/docs.json @@ -2,7 +2,7 @@ "_comment": "Extracted from the native SDK sources by scripts/extract_option_docs.dart; do not edit by hand. The prose of the typed BugseeOptions doc comments (scripts/generate_options.dart).", "sources": { "android": "v7.4.2@3b7af6371", - "ios": "origin/nextgen@0581aa02c" + "ios": "origin/release@2b88480fa" }, "docs": { "com.bugsee.option.capture.avplayer": { @@ -60,7 +60,7 @@ }, "com.bugsee.option.capture.network.default-sanitizer": { "android": "Automatically sanitize sensitive data (PII) from captured network events. Applies only when no network event filter is set, whether through `Bugsee.setNetworkEventFilter` or the manifest. Redacts values for known sensitive keys in URL query parameters, HTTP headers, and JSON request/response bodies.", - "iosProperty": "Automatically sanitize sensitive data (PII) from captured network events. Applies only when no custom network filter (block or delegate) is set. Redacts values for known sensitive keys in URL query parameters, HTTP headers, and JSON bodies." + "iosProperty": "Automatically sanitize sensitive data (PII) from captured network events. Applies only when no custom network filter (block or delegate) is set; a filter can run the same redaction itself through `+[Bugsee defaultNetworkSanitizer]`. Redacts values for known sensitive keys in URL query parameters, HTTP headers, and JSON bodies." }, "com.bugsee.option.capture.network.on-launch": { "android": "Subscribe network capture synchronously during `Bugsee.launch()`, so requests issued in the launch window — between `launch()` returning and capture starting on its background thread — are observed. Installing the interception cannot be done retroactively for a request already in flight, so it has to happen up front when this is on. The provider is only subscribed at launch, not started; events captured meanwhile are buffered and flushed when capture starts.\n\nHas no effect unless `capture.network` is also enabled. Enabling this puts the interception install (a few milliseconds) back on the launch critical path, which is why it is off by default.", @@ -162,13 +162,19 @@ }, "com.bugsee.option.config.max-data-size": { "android": "Maximum disk space, in megabytes, that reports waiting to be sent may occupy. When exceeded, whole pending reports are deleted — errors first, then bug reports, then crashes, oldest first within each — until they fit again. The newest crash and any report being exported or uploaded are never deleted. Values below `10` are treated as `10`.", - "iosProperty": "Bugsee will avoid using more disk space than specified. Should be specified in Mb. Value should not be smaller than 10." + "iosProperty": "Most disk space, in MB, that reports waiting to be sent may take up. Past it the oldest reports are deleted whole: errors first, then bug reports, then crashes; the newest crash is kept. Values below 10 count as 10.", + "iosConstant": "Most disk space, in MB, that reports waiting to be sent may take up. Past it the oldest reports are deleted whole: errors first, then bug reports, then crashes; the newest crash is kept. Values below 10 count as 10." }, "com.bugsee.option.config.max-pending-report-age": { - "android": "Maximum age, in days, of a report waiting to be sent. Older reports are deleted, whatever their type. `0` or a negative value disables aging: reports are then kept until they are sent or evicted by `config.max-data-size` / `config.max-pending-reports`." + "android": "Maximum age, in days, of a report waiting to be sent. Older reports are deleted, whatever their type. `0` or a negative value disables aging: reports are then kept until they are sent or evicted by `config.max-data-size` / `config.max-pending-reports`.", + "iosProperty": "Days a report may wait to be sent before it is deleted, crashes included. 0 or less keeps reports with no time limit.", + "iosConstant": "Days a report may wait to be sent before it is deleted, crashes included. 0 or less keeps reports with no time limit.", + "iosNote": "days" }, "com.bugsee.option.config.max-pending-reports": { - "android": "Maximum number of reports waiting to be sent. When exceeded, pending reports are deleted in the same order as for `config.max-data-size`. Values below `1` are treated as `1`." + "android": "Maximum number of reports waiting to be sent. When exceeded, pending reports are deleted in the same order as for `config.max-data-size`. Values below `1` are treated as `1`.", + "iosProperty": "Most reports that may wait to be sent. Past it the oldest are deleted, in the same order as for `maxDataSize`. Values below 1 count as 1.", + "iosConstant": "Most reports that may wait to be sent. Past it the oldest are deleted, in the same order as for `BugseeOptionConfigMaxDataSize`. Values below 1 count as 1." }, "com.bugsee.option.config.notify-flush-delay": { "android": "Coalesce window in milliseconds before a notification-relay FIFO flush. `0` (the default) tries to POST as soon as the item is on disk (still persisted first). A positive value delays the JobScheduler drain so nearby `Bugsee.notify` calls batch together.", diff --git a/test/fixtures/option_manifests/ios.json b/test/fixtures/option_manifests/ios.json index 8fe13746..49958869 100644 --- a/test/fixtures/option_manifests/ios.json +++ b/test/fixtures/option_manifests/ios.json @@ -1,6 +1,6 @@ { "buildConfiguration" : "release", - "generatedAt" : "2026-10-18T04:41:18Z", + "generatedAt" : "2026-10-30T19:10:39Z", "manifestVersion" : 1, "options" : [ { @@ -319,12 +319,26 @@ "type" : "int" }, { - "default" : 50, + "default" : 150, "hidden" : false, "key" : "com.bugsee.option.config.max-data-size", "module" : "Bugsee", "type" : "int" }, + { + "default" : 30, + "hidden" : false, + "key" : "com.bugsee.option.config.max-pending-report-age", + "module" : "Bugsee", + "type" : "int" + }, + { + "default" : 30, + "hidden" : false, + "key" : "com.bugsee.option.config.max-pending-reports", + "module" : "Bugsee", + "type" : "int" + }, { "default" : 0, "hidden" : false, @@ -576,5 +590,5 @@ } ], "sdk" : "ios", - "sdkVersion" : "7.0.0-beta7" + "sdkVersion" : "7.0.0" } \ No newline at end of file diff --git a/test/fixtures/report_enums.json b/test/fixtures/report_enums.json index dedbbea0..6c6c732c 100644 --- a/test/fixtures/report_enums.json +++ b/test/fixtures/report_enums.json @@ -2,7 +2,7 @@ "_comment": "Extracted from the native SDK sources by scripts/extract_report_enums.dart; do not edit by hand. Compared by test/report_enum_parity_test.dart.", "pins": { "android": "7.4.2", - "ios": "7.0.0-beta7" + "ios": "7.0.0" }, "android": { "IssueSeverity": { @@ -34,19 +34,24 @@ "BugseeSeverityCritical": 4, "BugseeSeverityBlocker": 5 }, + "BugseeDataEncryptionMode": { + "BugseeDataEncryptionNone": 0, + "BugseeDataEncryptionOnDevice": 1, + "BugseeDataEncryptionEndToEnd": 2 + }, "issueTypeStrings": [ "bug", "crash", "error" ], "reportHandlerTimings": { - "source": "origin/nextgen@0581aa02c", + "source": "origin/release@2b88480fa", "handlerTimeoutSeconds": 30.0, "chainTimeoutSeconds": 60.0, "boundedCapSeconds": 3.0 }, "attachments": { - "source": "origin/nextgen@0581aa02c", + "source": "origin/release@2b88480fa", "maxPerReport": 1000, "legacyCreatedReportMaxCount": 3, "legacyCreatedReportMaxBytes": 3145728 diff --git a/test/option_manifests_test.dart b/test/option_manifests_test.dart index 2dad5e65..f253187d 100644 --- a/test/option_manifests_test.dart +++ b/test/option_manifests_test.dart @@ -43,7 +43,6 @@ const knownNameDivergences = { /// some differ from Android intentionally"). Reviewed; a new difference fails until added. const knownDefaultDifferences = { 'com.bugsee.option.capture.video.adaptive': (false, true), - 'com.bugsee.option.config.max-data-size': (150, 50), }; void main() { @@ -101,8 +100,8 @@ void main() { final template = (pins['optionsManifest'] as Map)['urlTemplate'] as String; expect( - sync.manifestUrl(template, 'ios', '7.0.0-beta7'), - 'https://download.bugsee.com/sdk/options/ios/7.0.0-beta7.json', + sync.manifestUrl(template, 'ios', '7.0.0'), + 'https://download.bugsee.com/sdk/options/ios/7.0.0.json', ); expect( (pins['optionsManifest'] as Map)['fixtureDir'], @@ -126,11 +125,11 @@ void main() { final shared = a.keys.toSet().intersection(i.keys.toSet()); test('counts, so a changed option surface is noticed', () { - // Android 7.4.2: 87 (84 public + 3 hidden). iOS 7.0.0-beta7: 70 (69 public + 1 hidden). + // Android 7.4.2: 87 (84 public + 3 hidden). iOS 7.0.0: 72 (71 public + 1 hidden). expect(a.length, 87); - expect(i.length, 70); - expect(shared.length, 49); - expect(a.keys.toSet().difference(i.keys.toSet()).length, 38); + expect(i.length, 72); + expect(shared.length, 51); + expect(a.keys.toSet().difference(i.keys.toSet()).length, 36); expect(i.keys.toSet().difference(a.keys.toSet()).length, 21); }); diff --git a/test/options_registry_test.dart b/test/options_registry_test.dart index 808ef61b..6dc0acf0 100644 --- a/test/options_registry_test.dart +++ b/test/options_registry_test.dart @@ -135,7 +135,7 @@ void main() { final typed = optionSpecs.where((s) => s.typed).toList(); test( - 'there are 100 of them (84 + 69 public, 49 shared, less 4 leak-module and 1 deprecated)', + 'there are 100 of them (84 + 71 public, 51 shared, less 4 leak-module and 1 deprecated)', () { expect(typed.length, 100); }, diff --git a/test/report_enum_parity_test.dart b/test/report_enum_parity_test.dart index 44b79d8b..e6f32947 100644 --- a/test/report_enum_parity_test.dart +++ b/test/report_enum_parity_test.dart @@ -43,6 +43,27 @@ void main() { }); }); + group('the iOS encryption enum, which no shipped header has', () { + test('the source values equal what the SDK published in its manifest', () { + final source = (ios['BugseeDataEncryptionMode']! as Map) + .cast() + .map( + (k, v) => MapEntry(k.replaceFirst('BugseeDataEncryption', ''), v), + ); + final manifest = json('test/fixtures/option_manifests/ios.json'); + final published = [ + for (final o in manifest['options']! as List) + if ((o as Map)['enum'] is Map && + (o['enum'] as Map)['name'] == 'BugseeDataEncryptionMode') + (o['enum'] as Map)['values'], + ]; + expect(published, isNotEmpty); + for (final v in published) { + expect(v, source); + } + }); + }); + group('IssueSeverity agrees across platforms and with Dart, by value', () { test('both SDKs and Dart assign the same set of values', () { final dart = ReportSeverity.values.map((s) => s.value).toSet();