@everframe/react-native 1.2.0 → 1.3.0

package/EverframeRN.podspec

@@ -40,7 +40,7 @@ package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 # 1.2.0, so the range already asks for 1.2 while package.json is still 1.1.0.
 # The 1.2.0 release moves package.json to match.
 native_version_override = ENV['EVERFRAME_NATIVE_POD_VERSION'].to_s.strip
-native_minor_range = native_version_override.empty? ? '~> 1.2.0' : native_version_override
+native_minor_range = native_version_override.empty? ? '~> 1.3.0' : native_version_override
 
 Pod::Spec.new do |s|
   s.name         = 'EverframeRN'

package/README.md

@@ -29,6 +29,25 @@ Then install pods (iOS) / sync Gradle (Android) as usual:
 cd ios && pod install
 ```
 
+### Source maps and symbols
+
+Release builds can upload their Hermes source maps, dSYMs, R8 mappings and
+native libraries, so crashes show your code. Wrap Metro with
+`withEverframe` from `@everframe/metro`, add `@everframe/cli`, and set up the
+native projects once. In Expo, apply `withEverframe` from `@everframe/expo`
+with your App ID in `app.config.js`. In a bare app, run:
+
+```bash
+npx @everframe/cli setup react-native --app-id "$EVERFRAME_APP_ID"
+```
+
+Either way, Android gets `apply plugin: "dev.everframe"` and
+`everframe { appId = "…" }` plus one classpath line, and Xcode gets a
+one-line Run Script phase that runs `scripts/xcode-upload.sh` from the installed
+`@everframe/cli`. The upload logic lives in the Gradle plugin and the CLI. Set `EVERFRAME_API_TOKEN` in release builds;
+without it the build warns and continues. See the
+[CLI guide](../cli/README.md#react-native-and-expo).
+
 ## React Native Web
 
 `@everframe/react-native` has a browser entry and an explicit
@@ -49,6 +68,8 @@ the web mask registry. Native iOS and Android use their native capture. A web
 bundler that honors the `browser` export condition can keep the regular package
 import; use the `/web` subpath if its resolver does not select that condition.
 
+Replays also attach to errors; see [session replay](../../docs/session-replay.md).
+
 ## Usage
 
 Wrap your app with `<EverframeProvider>` at the highest practical level
@@ -283,15 +304,12 @@ Snapshots are detached, contain no captured content, reset on remount, and perfo
 no native query or upload. Paths are `handled` (including the boundary callback),
 `errorUtils` (including errors no boundary catches), and `rejection` (submission only). Each active attempt has one outcome:
 `accepted`, `duplicateSuppressed`, `allowanceSuppressed`, `bridgeUnavailable`,
-`nativeRefused`, `captureFailed`, `reentrantSuppressed`, `inactiveAborted`, or
-`legacyAttempted`. Counters saturate at 2,147,483,647. Existing limits are ten
+`nativeRefused`, `captureFailed`, `reentrantSuppressed`, or `inactiveAborted`.
+Counters saturate at 2,147,483,647. Existing limits are ten
 handled and ten automatic distinct keys; fatal capture bypasses them.
 
-`accepted` requires exactly true from a current native capture method. It does
-not mean upload success, server processing or outbox removal. An automatic call
-to an older native fallback is only `legacyAttempted`, regardless of its return.
-Old-binary unavailable/throwing methods are covered by unit controls, not an
-installed old-binary qualification. This snapshot excludes native queue and
+`accepted` requires exactly true from the native capture method. It does
+not mean upload success, server processing or outbox removal. This snapshot excludes native queue and
 delivery observations; read those with `getReportDeliveryStatus()`. Status is
 neutral `not-mounted` without a provider, `disabled` under the crash-reporting
 veto, and `unsupported` on the browser root entry.
@@ -341,8 +359,7 @@ bridges. iOS marks `jvm-uncaught` unsupported and implies no automatic iOS nativ
 crash collector.
 
 Without a mounted provider the result is `not-mounted/no-mount`; the browser
-export is `unsupported/platform`. Older native SDKs without the getter return
-`unsupported/native-method-missing`. A throwing native call returns
+export is `unsupported/platform`. A missing or throwing native call returns
 `unavailable/native-call-failed`, and malformed native responses return
 `unavailable/invalid-native-snapshot`. These fallbacks have an unobserved queue
 and `unknown` platform policies. This API does not provide a per-report delivery
@@ -379,6 +396,34 @@ capturing network traffic in the first place:
 Do not enable this option expecting RN's own network calls to show up in
 reports — that capability doesn't exist yet.
 
+## Crash-only sessions
+
+```tsx
+<EverframeProvider config={{ sdkKey: '…', reporter: { disabled: true } }}>
+```
+
+`reporter.disabled: true` turns the bug reporter off for the session and
+keeps crash and error reporting, for example in production builds. It is a
+**client veto**: the dashboard can't turn the reporter back on for this
+session.
+
+In a crash-only session:
+
+- Shake-to-report is off, and `open()` rejects with
+  `EverframeReporterDisabledError`.
+- Session replay uses the app's crash-only sampling rate, which is 0 by
+  default. An error carries a replay only while the session records.
+- Network bodies aren't captured.
+- Crash and error capture, breadcrumbs, vitals, release health and the
+  companion work as usual.
+
+A companion bond (a phone scanning the QR code, or a dashboard member
+attaching) upgrades the session. Replay and network bodies then follow the
+app's normal settings for the rest of the session, and recording starts at
+the bond. The reporter stays off: reports from an upgraded session come
+through the companion. See
+[crash-only sessions](../../docs/session-replay.md#crash-only-sessions).
+
 ## Navigation breadcrumbs
 
 Mark screens with one line; the native SDK derives `from → to` from a global
@@ -472,15 +517,15 @@ inside a native view and never reaches JS.
 - `captureSourceQuery` — keep the query string on `source_change.src`
   (default `false`: signed CDN URLs carry tokens in the query).
 
-**Reconfiguring.** A Provider remount with the *same* config does not restart
-the SDK: both native sides compare the incoming config against the *installed*
+**Reconfiguring.** A Provider remount with the _same_ config does not restart
+the SDK: both native sides compare the incoming config against the _installed_
 one and skip the start entirely. A **changed** config does restart it (on iOS,
 except a change confined to `releaseHealth` or the loaded bundle; see
 [Release health](#release-health)) — and a
 start supersedes the running SDK, detaching every player integration it had
 announced. **Limitation:** players tracked before that restart stay untracked
 until their screens remount; nothing re-registers them automatically. Two React
-instances in one process are *not* coordinated either: if a second one starts
+instances in one process are _not_ coordinated either: if a second one starts
 the SDK under the first, the first instance's players stay untracked until its
 own screens remount.
 
@@ -525,7 +570,7 @@ adapter has subscribed — and `onLoadStart` is what arms the adapter's startup
 clock, so the first source's startup latency is simply never seen. Deferring
 the load until after the adapter subscribed puts the first `onLoadStart` back
 where it can be observed. Without this, everything else still works; only the
-*first* `startup` measurement is missing (later source changes are fine).
+_first_ `startup` measurement is missing (later source changes are fine).
 
 Options: `name`, `libraryVersion`, and `captureErrors` (default `false` — see
 Limitations). `onBandwidthUpdate` is read per platform: on iOS its `bitrate`
@@ -535,7 +580,7 @@ the `bandwidthEstimate` stat (with `quality_change` for the accompanying
 rendition size) and never as a bitrate.
 
 `onProgress` is read per platform too. The `bufferAheadMs` stat is always the
-media time buffered *ahead of the playhead*: on Android `bufferDuration` is
+media time buffered _ahead of the playhead_: on Android `bufferDuration` is
 already that, on iOS it is the buffered range's absolute end position, so the
 adapter subtracts `currentTime` from it.
 
@@ -618,7 +663,7 @@ dropped, not forwarded.
   `captureErrors` is off by default.
 - **`rate_change` was not observed from react-native-video v7 on Android** in
   our Android emulator smoke — `onPlaybackRateChange` never arrived there.
-  Note that the library *does* forward ExoPlayer's
+  Note that the library _does_ forward ExoPlayer's
   `onPlaybackParametersChanged`, so this is a "not seen in our smoke run"
   result, not a proven library gap; a host that changes playback speed
   explicitly may well see it. Nothing on the adapter side gates it either way.
@@ -693,7 +738,7 @@ subscription?.remove();
 ```
 
 > If you have seen the older `new TVEventHandler(); handler.enable(cmp, cb);
-> handler.disable()` shape elsewhere — that class-based API was removed in
+handler.disable()` shape elsewhere — that class-based API was removed in
 > RN-tvos 0.85.x. Always read the version installed in your `node_modules`.
 
 #### Apple TV: long-press Play/Pause
@@ -777,28 +822,12 @@ recipes above.
 ## Android reporter initialization
 
 The Android reporter can be opened after the host activity has resumed, including
-apps that disable AndroidX Startup. Use matching updated React Native bridge and
-`dev.everframe:reporter-ui` artifacts: the bridge supplies the current resumed
+apps that disable AndroidX Startup. The bridge supplies the current resumed
 activity, and installation and presentation run on the main thread. Repeated
-configuration with matching updated artifacts does not register another lifecycle observer. Capture configuration
-remains synchronous without waiting for reporter UI initialization.
-
-The existing `ReporterResolverInstaller.create(Context)` entry point is retained
-for compiled callers. A new bridge with an older reporter uses its legacy entry
-point when the activity-aware method is absent; that combination retains the old
-late-initialization limitation. A failure from an available method is reported,
-not retried through the legacy path. Background or unavailable activities return
-a cancelled result with reason `no_active_activity`.
-
-Legacy off-main `create(Context)` schedules installation and returns before it is
-ready; use the awaited activity-aware bridge to open immediately after configure.
-With a new bridge and an older reporter, each configure, companion start, and
-open invokes legacy installation again. This can add duplicate lifecycle
-callbacks and overwrite that older reporter's resolver and activity supplier;
-the previous bridge limited installation to once per module. Conversely, an old
-compiled bridge with the new reporter can announce companion PIN capability
-before asynchronous reporter installation finishes, temporarily advertising no
-PIN support. Use the matching updated pair for the qualified behavior.
+configuration does not register another lifecycle observer. Capture configuration
+remains synchronous without waiting for reporter UI initialization. A failure
+while opening is reported to JavaScript. Background or unavailable activities
+return a cancelled result with reason `no_active_activity`.
 
 Activity destruction while a reporter is open resolves the pending call with
 `{ status: "cancelled", reason: "activity_destroyed" }`, releases that report's

package/android/build.gradle.kts

@@ -153,7 +153,7 @@ val rnSdkPkg = groovy.json.JsonSlurper()
 val rnSdkVersion = rnSdkPkg["version"] as String
 // Native 1.2.0 is the release that renamed the SDK key to `sdkKey`; the
 // bridge moves with it, ahead of package.json, which the 1.2.0 release bumps.
-val nativeMinorRange: String = nativeVersionOverride ?: "[1.2.0,1.3.0)"
+val nativeMinorRange: String = nativeVersionOverride ?: "[1.3.0,1.4.0)"
 if (nativeVersionOverride != null) {
     logger.lifecycle(
         "[everframe-rn] native AAR pinned to $nativeVersionOverride via everframeNativeVersion " +

package/android/src/main/java/dev/everframe/rn/EverframeModule.kt

@@ -22,7 +22,7 @@
 //   signalCompanionReportRequestReady(id) → void           (Plan 06.2-13)
 //   trackPlayer/detachPlayer/recordPlayerEvent/updatePlayerStats/
 //   trackVitals                           → void           (spec 2026-09-06)
-//   configure(opts.vitals*)               → void           (spec 2026-09-06)
+//   configureSync(opts.vitals*)           → boolean        (spec 2026-09-06)
 //   addListener(name)/removeListeners(n)  → void (RN event-emitter no-ops)
 //
 // The native TXReporterPresenter owns the entire report UX (capture, annotate,
@@ -30,8 +30,7 @@
 // and the sensitive-rect bridge. Native mobile shake stays below this bridge.
 //
 // THREADING:
-//   • configureSync runs on the JS thread (blocking synchronous); legacy
-//     void configure retains React Native's queued native dispatch.
+//   • configureSync runs on the JS thread (blocking synchronous).
 //   • openReporter dispatches presenter.openReporter onto the activity from
 //     MainScope (presenter manages its own UI thread hops internally).
 //   • registerSensitiveRect runs on the UI thread (UIManager view resolution).
@@ -148,6 +147,8 @@ class EverframeModule(
         internal const val REJECT_CAPTURE_DISABLED: String = "capture_disabled"
         internal const val REJECT_NO_ACTIVITY: String = "no_activity"
         internal const val REJECT_OPEN_REPORTER_FAILED: String = "open_reporter_failed"
+        /** Crash-only sessions (spec 2026-10-12). The JS facade maps this exact code to `EverframeReporterDisabledError`. */
+        internal const val REJECT_REPORTER_DISABLED: String = "EVERFRAME_REPORTER_DISABLED"
 
         // Plan 06.2-11 — JS-side event names. Keep in lock-step with
         // `packages/sdk-react-native/src/companion.ts` and the iOS
@@ -175,13 +176,10 @@ class EverframeModule(
         // below for the full contract.
         internal const val COMPANION_ATTACH_CHALLENGE_EVENT: String =
             "everframe.companion.attachChallenge"
-        // Fired when a `report.request` arrives from the paired phone. This
-        // used to give JS a window to walk the React fiber tree and call
-        // `attachReactTree`; both the tree payload and that spec method are
-        // gone (spec 2026-08-29). The event and its
-        // `signalCompanionReportRequestReady` acknowledgement survive as the
-        // companion's JS-ready handshake — the bounded wait is part of the
-        // pairing flow, not of tap-to-identify.
+        // Fired when a `report.request` arrives from the paired phone. The
+        // event and its `signalCompanionReportRequestReady` acknowledgement
+        // are the companion's JS-ready handshake — the bounded wait is part
+        // of the pairing flow.
         internal const val COMPANION_REPORT_REQUESTED_EVENT: String = "everframe.companion.reportRequested"
 
         // Spec 2026-09-17 setExtra-resolver — NOT a companion event (no
@@ -209,11 +207,6 @@ class EverframeModule(
 
     // ---------------- configure ----------------
 
-    @ReactMethod
-    override fun configure(opts: ReadableMap) {
-        configureInternal(opts)
-    }
-
     @ReactMethod(isBlockingSynchronousMethod = true)
     override fun configureSync(opts: ReadableMap): Boolean = configureInternal(opts)
 
@@ -271,6 +264,10 @@ class EverframeModule(
             // Polarity flips exactly once, here: JS sends the veto
             // (`crashReportingDisabled`), native stores the permission.
             val crashReportingDisabled = opts.takeIfHasBoolean("crashReportingDisabled") ?: false
+            // Polarity flips exactly once, here: JS sends the crash-only switch
+            // (`reporterDisabled`, flattened from `reporter: { disabled }`),
+            // native stores the permission.
+            val reporterDisabled = opts.takeIfHasBoolean("reporterDisabled") ?: false
             // Attach-PIN UI mode (spec 2026-08-19) — a flat optional STRING
             // field (codegen cannot express a string-literal union), parsed
             // here and stashed for `startCompanion()` to read (the flag is a
@@ -314,6 +311,7 @@ class EverframeModule(
                 // `startCompanion()` time, mirroring `attachPinUi`.
                 companionBadgeEnabled = opts.takeIfHasBoolean("companionBadgeEnabled") ?: true,
                 shakeToReportEnabled = opts.takeIfHasBoolean("shakeToReportEnabled") ?: true,
+                reporterEnabled = !reporterDisabled,
                 companionBadgePosition = opts.takeIfHasString("companionBadgePosition"),
                 // Inline reporter theme (reporter branding spec 2026-08-25,
                 // RN slice) — 8 flat optional STRING fields on ConfigOpts
@@ -423,6 +421,9 @@ class EverframeModule(
      *   { status: "submitted", reportId: "<uuid>" }
      *   { status: "queued",    reportId: "<uuid>" }
      *   { status: "cancelled" }
+     *
+     * Rejects with [REJECT_REPORTER_DISABLED] in a crash-only session
+     * (`reporterDisabled`), including after a companion bond upgraded it.
      */
     @ReactMethod
     override fun openReporter(promise: Promise) {
@@ -430,6 +431,12 @@ class EverframeModule(
             promise.reject(REJECT_CAPTURE_DISABLED, "Everframe not started (captureGate=false). Call configure() first.")
             return
         }
+        // Crash-only session: rejected here because ReporterBridge reduces every core failure to one
+        // generic message, which would hide `ReporterDisabledException` from JS.
+        if (Everframe.currentConfig?.reporterEnabled == false) {
+            promise.reject(REJECT_REPORTER_DISABLED, "The reporter is turned off for this session (reporter.disabled).")
+            return
+        }
         MainScope().launch {
             try {
                 val result: ReportResult = reporterBridge.open(reactContext)
@@ -500,7 +507,7 @@ class EverframeModule(
      * `Everframe.addBreadcrumb` (Task 9) — NO validation/coercion here. That
      * singleton already owns kind/level/data coercion AND gating (no-op
      * pre-start / while killed via its own `txGuardVoid` + `captureGate`
-     * check), exactly like `setExtra`/`attachReactTree` above never re-check
+     * check), exactly like `setExtra` above never re-checks
      * `captureGate` themselves. `data` crosses as a `ReadableMap?` — the
      * codegen-typed freeform-object boundary — converted with RN's own
      * `toHashMap()` (no re-shaping) before handing off.
@@ -637,7 +644,7 @@ class EverframeModule(
      *
      * The primary fix is the JS projection in `src/user-projection.ts`, applied
      * before the value ever crosses the bridge. This is the second layer, for a
-     * hand-wired native caller (or a host on an older JS bundle) that reaches
+     * hand-wired native caller that reaches
      * this method directly: bad fields degrade to `null` — a partial user, or
      * anonymous — and `Everframe.setUser` is ALWAYS reached, so the call always
      * replaces what was installed before.
@@ -687,11 +694,11 @@ class EverframeModule(
     @ReactMethod(isBlockingSynchronousMethod = true)
     override fun getReportDeliveryStatusJson(): String = Everframe.getReportDeliveryStatus().toJson()
 
-    /** Automatic ErrorUtils capture; true acknowledges completed sidecar storage. */
+    /** Automatic ErrorUtils and unhandled-rejection capture; true acknowledges completed sidecar storage. A non-fatal error may carry a replay. */
     @ReactMethod(isBlockingSynchronousMethod = true)
     override fun reportCrash(crashJson: String): Boolean = captureCrashJson(crashJson, handled = false)
 
-    /** Explicit capture always enforces handled=true, fatal=false, captureException. */
+    /** Explicit capture always enforces handled=true, fatal=false, captureException, and may carry a replay. */
     @ReactMethod(isBlockingSynchronousMethod = true)
     override fun captureHandledException(crashJson: String): Boolean = captureCrashJson(crashJson, handled = true)
 
@@ -718,12 +725,17 @@ class EverframeModule(
             val details = if (obj.has("details")) obj.get("details") else null
             val causeChain = if (obj.has("causeChain")) obj.get("causeChain") else null
             val fatal = !handled && obj.optBoolean("fatal", false)
-            val accepted = if (handled) {
-                dev.everframe.crash.CrashReporter.captureHandledFactsWithCauses(
+            // Only errors the app survives ask for a replay. Eligibility and export remain in the core;
+            // fatal errors keep the entry point that never carries a replay.
+            val accepted = when {
+                handled -> dev.everframe.crash.CrashReporter.captureHandledFactsWithReplay(
                     exceptionType, message, frames, occurredAt, jsBundle, details, causeChain, "everframe-android",
                 )
-            } else {
-                dev.everframe.crash.CrashReporter.captureFactsAcceptedWithCauses(
+                fatal -> dev.everframe.crash.CrashReporter.captureFactsAcceptedWithCauses(
+                    exceptionType, message, frames, obj.optString("mechanism", "errorutils"),
+                    fatal, occurredAt, jsBundle, details, causeChain,
+                )
+                else -> dev.everframe.crash.CrashReporter.captureFactsAcceptedWithReplay(
                     exceptionType, message, frames, obj.optString("mechanism", "errorutils"),
                     fatal, occurredAt, jsBundle, details, causeChain,
                 )
@@ -1097,14 +1109,6 @@ class EverframeModule(
         val capture: ScreenshotCapture.CaptureResult,
         val reportCapture: dev.everframe.capture.video.FrozenReportCapture,
         val hostExtra: String?,
-        /**
-         * Drained-and-discarded host React tree (spec 2026-08-29). Nothing
-         * reads it any more, and RN can no longer attach one — the
-         * TurboModule spec method is gone. Kept only because the native core
-         * `Everframe.attachReactTree` remains callable by pure-native hosts,
-         * so the consume-once drain must still clear the slot.
-         */
-        val hostReactTreeJson: String?,
     )
 
     private val companionCaptureStash = ConcurrentHashMap<String, CompanionCapture>()
@@ -1161,7 +1165,7 @@ class EverframeModule(
                         //    same reason the screenshot capture above is —
                         //    this whole provider runs on the OkHttp WS
                         //    thread, never the UI thread.
-                        val (hostExtraRaw, hostReactTreeJson) =
+                        val hostExtraRaw =
                             runBlocking { Everframe.consumePendingAttachments() }
                         val hostExtra = hostExtraRaw?.takeIf { it.isNotEmpty() }
 
@@ -1173,7 +1177,6 @@ class EverframeModule(
                                 capture = capture,
                                 reportCapture = reportCapture,
                                 hostExtra = hostExtra,
-                                hostReactTreeJson = hostReactTreeJson?.takeIf { it.isNotEmpty() },
                             )
                         }
                         if (!published) {
@@ -1485,9 +1488,7 @@ class EverframeModule(
     /**
      * Called by the JS companion module from the `everframe.companion
      * .reportRequested` event handler once it is ready for capture to
-     * proceed. (It used to walk the React fiber tree and call
-     * `attachReactTree` first; both are gone — spec 2026-08-29.) Releases
-     * the `awaitJsReactTreeAttach` waiter for this correlation id so the
+     * proceed. Releases the `awaitJsReactTreeAttach` waiter for this correlation id so the
      * capture provider can proceed. Idempotent — late signals after the
      * timeout fired are harmless.
      */

package/android/src/main/java/dev/everframe/rn/ReporterBridge.kt

@@ -9,7 +9,6 @@ import android.os.Looper
 import android.util.Log
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.common.LifecycleState
-import dev.everframe.Everframe
 import dev.everframe.config.ReportResult
 import java.lang.reflect.InvocationTargetException
 import java.lang.reflect.Method
@@ -19,7 +18,7 @@ import kotlinx.coroutines.CancellationException
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
 
-/** Reflection preserves compatibility with separately built native reporter artifacts. */
+/** Resolves the reporter installer reflectively, so tests can substitute it. */
 internal class ReporterBridge(
     private val resolveInstaller: () -> Class<*> = { Class.forName("dev.everframe.ui.ReporterResolverInstaller") },
 ) {
@@ -46,17 +45,9 @@ internal class ReporterBridge(
         try {
             val type = installerType()
             val instance = type.getDeclaredConstructor().newInstance()
-            val method = try {
-                type.getMethod("openForActivity", Context::class.java, Activity::class.java, Continuation::class.java)
-            } catch (_: NoSuchMethodException) { null }
-            if (method == null) {
-                // Absence is the only legacy fallback. A present method's failure is final.
-                invoke(type.getMethod("create", Context::class.java), instance, context.applicationContext)
-                Everframe.report.open()
-            } else {
-                suspendCoroutineUninterceptedOrReturn<ReportResult> { continuation ->
-                    invoke(method, instance, context.applicationContext, activity, continuation)
-                }
+            val method = type.getMethod("openForActivity", Context::class.java, Activity::class.java, Continuation::class.java)
+            suspendCoroutineUninterceptedOrReturn<ReportResult> { continuation ->
+                invoke(method, instance, context.applicationContext, activity, continuation)
             }
         } catch (failure: Throwable) {
             when (failure) {

package/dist/NativeEverframe.d.ts

@@ -89,6 +89,13 @@ type ConfigOpts = {
     companionBadgeEnabled?: boolean;
     /** Local veto for native mobile shake-to-report. Absent defaults to enabled. */
     shakeToReportEnabled?: boolean;
+    /**
+     * Crash-only session switch. `true` turns off every on-device way to open the reporter, keeps
+     * network bodies off and samples replay with the server's crash-only rate until a companion
+     * bond upgrades the session. Flattened by `extractBridgeConfig` from `reporter: { disabled }`.
+     * Absent means a normal report session.
+     */
+    reporterDisabled?: boolean;
     /**
      * Companion on-screen name-badge corner (naming spec 2026-08-24,
      * controller ruling / Task 6b). Flat optional STRING, not a literal
@@ -170,11 +177,10 @@ type EverframeUserSpec = {
     displayName?: string;
 };
 interface Spec extends TurboModule {
-    configure(opts: ConfigOpts): void;
     /**
-     * Synchronous startup entry used by the current JS runtime. The legacy
-     * void configure method remains for already-compiled native callers, but
-     * React Native dispatches void TurboModule methods asynchronously.
+     * Synchronous startup entry. It is blocking rather than void because React
+     * Native dispatches void TurboModule methods asynchronously, and the first
+     * capture after mount must not overtake configuration.
      */
     configureSync(opts: ConfigOpts): boolean;
     /**
@@ -261,6 +267,12 @@ interface Spec extends TurboModule {
      * fatal, occurredAt }. Native builds/redacts/persists the envelope with
      * state it already owns (crumb ring, device metadata, outbox).
      * Returns true when the report was persisted.
+     *
+     * A non-fatal ErrorUtils error or unhandled promise rejection may carry a
+     * session replay of the seconds before it. A fatal error never carries one.
+     * Native decides replay eligibility; JavaScript sends no extra fields.
+     * Send `fatal` as a JSON boolean: only an absent flag or boolean false can
+     * request a replay on iOS.
      */
     reportCrash(crashJson: string): boolean;
     /** Register a remote player. A token already live is ignored. */
@@ -288,7 +300,10 @@ interface Spec extends TurboModule {
      * `token` resolves to a live player, else session-scoped.
      */
     trackVitals(name: string, dataJson?: string, token?: string): void;
-    /** Explicit handled capture; native enforces handled=true, fatal=false. */
+    /**
+     * Explicit handled capture; native enforces handled=true, fatal=false. Like a
+     * non-fatal `reportCrash`, it may carry a session replay.
+     */
     captureHandledException(crashJson: string): boolean;
     startCompanion(): void;
     stopCompanion(): void;

package/dist/chunk-MIWWEGLO.js

@@ -0,0 +1 @@
+import{a as s,c as i,e as u}from"./chunk-UN3Q4UGZ.js";import{a as t}from"./chunk-XUSV3KOD.js";var n=class extends Error{static{t(this,"EverframeNotMountedError")}name="EverframeNotMountedError";constructor(o){super(o??"EverframeProvider is not mounted; wrap your app root.")}},c="EVERFRAME_REPORTER_DISABLED",a=class extends Error{static{t(this,"EverframeReporterDisabledError")}name="EverframeReporterDisabledError";constructor(o){super(o??"The Everframe reporter is disabled in this session (reporter.disabled).")}};var r=null,p={};function f(){return p}t(f,"__getContextEpoch");function g(){try{return r?.getPromiseRejectionStatus()??u("not-mounted","no-mount")}catch{return u("install-failed","hook-install")}}t(g,"getPromiseRejectionStatus");function R(e){r=e,p={}}t(R,"__setCurrentContext");function S(){return r}t(S,"__getCurrentContext");function y(){let e=r;return e?e.open():Promise.reject(new n("EverframeProvider not mounted; wrap your root with <EverframeProvider>."))}t(y,"open");function C(e){r?.setExtra(e)}t(C,"setExtra");function b(e){r?.addBreadcrumb(e)}t(b,"addBreadcrumb");function P(e,o){o!==void 0?r?.recordScreen(e,o):r?.recordScreen(e)}t(P,"recordScreen");function _(e){r?.setUser(e)}t(_,"setUser");function j(e,o){r?.captureException(e,o)}t(j,"captureException");function w(){try{return r?.getErrorCaptureStatus()??i("not-mounted","no-mount")}catch{return i("not-mounted","no-mount")}}t(w,"getErrorCaptureStatus");function D(){let e=r;try{let o=e?.getReportDeliveryStatus();return e===r&&o?o:s("not-mounted","no-mount")}catch{return s("unavailable","native-call-failed")}}t(D,"getReportDeliveryStatus");export{n as a,c as b,a as c,f as d,g as e,R as f,S as g,y as h,C as i,b as j,P as k,_ as l,j as m,w as n,D as o};

package/dist/chunk-UN3Q4UGZ.js

@@ -0,0 +1 @@
+import{a as o}from"./chunk-XUSV3KOD.js";var h=["native-handled","bridge-handled","bridge-automatic","jvm-uncaught"],K=["persisted","disabled","admission-suppressed","reentrant","invalid-input","ownership-lost","storage-unavailable","failed"],S=["enqueue-committed","enqueue-failed","capacity-evicted","removed-after-acceptance","removed-after-terminal","removal-failed","read-failed"],T=["capacity","key-unavailable","corrupt","io","revoked","invalid-entry","busy","unknown","unsupported-format"],R=["live-submit","outbox-drain"],A=["server-accepted","retryable-http","terminal-http","network-failure","authorization-cancelled","cancelled","failed"],V=JSON.parse,H=Object.keys,y=Object.hasOwn,Q=Array.isArray,U=Number.isInteger,I=Reflect.apply,z=RegExp.prototype.test,_=/[^\x00-\x7f]/,O=2147483647;function d(e,t){let r={};for(let n=0;n<e.length;n++){let a=e[n];r[a]=t(a)}return r}o(d,"mapKeys");function J(e,t){return{schemaVersion:1,status:e,reason:t,scope:"native-runtime-observations",coverage:"best-effort",revision:0,capture:{enabled:!1,paths:d(h,()=>({supported:!1,settledAttempts:0,outcomes:d(K,()=>0)}))},queue:{scope:"sdk-report-outbox",observation:"not-observed",quality:"unknown",capacityPolicy:"unknown",terminalHttpPolicy:"unknown",operations:d(S,()=>0)},transport:d(R,()=>({settledAttempts:0,outcomes:d(A,()=>0)}))}}o(J,"emptyReportDeliveryStatus");function c(e,t,r=[]){if(!e||typeof e!="object"||Q(e))throw new Error;let n=H(e);for(let a=0;a<t.length;a++)if(!y(e,t[a]))throw new Error;for(let a=0;a<n.length;a++){let u=n[a];if(!g(t,u)&&!g(r,u))throw new Error}return e}o(c,"record");function g(e,t){for(let r=0;r<e.length;r++)if(e[r]===t)return!0;return!1}o(g,"contains");function l(e,t){if(typeof e!="string"||!g(t,e))throw new Error;return e}o(l,"enumeration");function v(e){if(typeof e!="number"||!U(e)||e<0||e>O)throw new Error;return e}o(v,"counter");function P(e){if(typeof e!="boolean")throw new Error;return e}o(P,"boolean");function q(e,t){let r=c(e,t);return d(t,n=>v(r[n]))}o(q,"counters");function j(e,t){let r=q(e.outcomes,t),n=v(e.settledAttempts),a=0;for(let b=0;b<t.length;b++)a+=r[t[b]];if((a>O?O:a)!==n)throw new Error;let u=y(e,"lastOutcome")?l(e.lastOutcome,t):void 0;if(n>0!=(u!==void 0)||u!==void 0&&r[u]===0)throw new Error;return{settledAttempts:n,outcomes:r,...u===void 0?{}:{lastOutcome:u}}}o(j,"settled");function C(e,t,r){for(let n=0;n<t.length;n++)if(r(e[t[n]])!==0)return!0;return!1}o(C,"nonzero");function M(e){try{if(typeof e!="string"||e.length>16384||I(z,_,[e]))return null;let t=c(V(e),["schemaVersion","status","reason","scope","coverage","revision","capture","queue","transport"]);if(t.schemaVersion!==1||t.scope!=="native-runtime-observations"||t.coverage!=="best-effort")return null;let r=l(t.status,["active","not-started","disabled","unavailable"]),n=l(t.reason,["none","no-start","capture-disabled","snapshot-busy"]);if({active:"none","not-started":"no-start",disabled:"capture-disabled",unavailable:"snapshot-busy"}[r]!==n)return null;let a=c(t.capture,["enabled","paths"]),u=c(a.paths,h),b=d(h,p=>{let f=c(u[p],["supported","settledAttempts","outcomes"],["lastOutcome"]),m={supported:P(f.supported),...j(f,K)};if(!m.supported&&m.settledAttempts!==0)throw new Error;return m}),i=c(t.queue,["scope","observation","quality","capacityPolicy","terminalHttpPolicy","operations"],["pendingCount","lastFailure"]);if(i.scope!=="sdk-report-outbox")return null;let s={scope:"sdk-report-outbox",observation:l(i.observation,["not-observed","observed","failed"]),quality:l(i.quality,["complete","partial","unknown"]),capacityPolicy:l(i.capacityPolicy,["reject-new","evict-oldest"]),terminalHttpPolicy:l(i.terminalHttpPolicy,["retain","attempt-remove"]),operations:q(i.operations,S),...y(i,"pendingCount")?{pendingCount:v(i.pendingCount)}:{},...y(i,"lastFailure")?{lastFailure:l(i.lastFailure,T)}:{}};if(s.capacityPolicy==="reject-new"!=(s.terminalHttpPolicy==="retain")||(s.observation!=="observed"||s.quality==="unknown")&&s.pendingCount!==void 0||s.observation!=="observed"&&s.quality!=="unknown"||s.observation==="failed"!=(s.lastFailure!==void 0))return null;let D=c(t.transport,R),E=d(R,p=>{let f=c(D[p],["settledAttempts","outcomes"],["lastOutcome","lastHttpStatus"]),m=j(f,A);if(y(f,"lastHttpStatus")){let x=v(f.lastHttpStatus);if(x<100||x>599||!g(["server-accepted","retryable-http","terminal-http"],m.lastOutcome??""))throw new Error;m.lastHttpStatus=x}return m}),w={schemaVersion:1,status:r,reason:n,scope:"native-runtime-observations",coverage:"best-effort",revision:v(t.revision),capture:{enabled:P(a.enabled),paths:b},queue:s,transport:E};return r!=="active"&&(w.revision!==0||w.capture.enabled||s.observation!=="not-observed"||C(b,h,p=>p.settledAttempts)||C(E,R,p=>p.settledAttempts)||C(s.operations,S,p=>p))?null:w}catch{return null}}o(M,"parseReportDeliveryStatus");function k(){return{attempted:0,accepted:0,duplicateSuppressed:0,allowanceSuppressed:0,bridgeUnavailable:0,nativeRefused:0,captureFailed:0,reentrantSuppressed:0,inactiveAborted:0}}o(k,"emptyCounters");function N(e,t){return{status:e,reason:t,scope:"mounted-js-admission",limits:{handled:10,automatic:10},counters:{handled:k(),errorUtils:k(),rejection:k()}}}o(N,"emptyErrorCaptureStatus");function F(e,t){e[t]=Math.min(2147483647,e[t]+1)}o(F,"incrementErrorCaptureCounter");function B(){let e=N("active","none").counters;return{begin(t){F(e[t],"attempted");let r=!1;return n=>{r||(r=!0,F(e[t],n))}},snapshot(){return{handled:{...e.handled},errorUtils:{...e.errorUtils},rejection:{...e.rejection}}}}}o(B,"createErrorCaptureLedger");function Y(e,t){return{status:e,reason:t,previousCallbacksPresent:!1,counters:{pending:0,accepted:0,cancelled:0,capacityDropped:0,sizeDropped:0,expired:0,duplicateSuppressed:0,allowanceSuppressed:0,nativeRefused:0,captureFailed:0,discarded:0}}}o(Y,"emptyPromiseRejectionStatus");export{J as a,M as b,N as c,B as d,Y as e};