@everframe/react-native 1.1.0 → 1.2.1

package/dist/index.web.d.ts

@@ -1,5 +1,5 @@
-import { E as ErrorCaptureStatus, P as PromiseRejectionStatus, R as ReportDeliveryStatus } from './promise-rejection-types-C-lxCdDl.js';
-export { a as ErrorCaptureCounters, b as ErrorCaptureOutcome, c as ErrorCapturePath, d as PromiseRejectionCounters, e as RejectionReason, f as ReportCaptureOutcome, g as ReportCapturePath, h as ReportCapturePathStatus, i as ReportDeliveryReason, j as ReportQueueOperation, k as ReportQueueStatus, l as ReportStorageFailure, m as ReportTransportOrigin, n as ReportTransportOutcome, o as ReportTransportStatus } from './promise-rejection-types-C-lxCdDl.js';
+import { E as ErrorCaptureStatus, P as PromiseRejectionStatus, R as ReportDeliveryStatus } from './promise-rejection-types-Bf5iLv8n.js';
+export { a as ErrorCaptureCounters, b as ErrorCaptureOutcome, c as ErrorCapturePath, d as PromiseRejectionCounters, e as RejectionReason, f as ReportCaptureOutcome, g as ReportCapturePath, h as ReportCapturePathStatus, i as ReportDeliveryReason, j as ReportQueueOperation, k as ReportQueueStatus, l as ReportStorageFailure, m as ReportTransportOrigin, n as ReportTransportOutcome, o as ReportTransportStatus } from './promise-rejection-types-Bf5iLv8n.js';
 export * from '@everframe/react';
 
 /** Hermes observation is separate from the browser SDK's own rejection handling. */

package/dist/index.web.js

@@ -1 +1 @@
-import{a as r,c as e,e as o}from"./chunk-ENPQ66EV.js";import{a as t}from"./chunk-XUSV3KOD.js";export*from"@everframe/react";function a(){return o("unsupported","platform")}t(a,"getPromiseRejectionStatus");function s(){return e("unsupported","platform")}t(s,"getErrorCaptureStatus");function n(){return r("unsupported","platform")}t(n,"getReportDeliveryStatus");export{s as getErrorCaptureStatus,a as getPromiseRejectionStatus,n as getReportDeliveryStatus};
+import{a as r,c as e,e as o}from"./chunk-UN3Q4UGZ.js";import{a as t}from"./chunk-XUSV3KOD.js";export*from"@everframe/react";function a(){return o("unsupported","platform")}t(a,"getPromiseRejectionStatus");function s(){return e("unsupported","platform")}t(s,"getErrorCaptureStatus");function n(){return r("unsupported","platform")}t(n,"getReportDeliveryStatus");export{s as getErrorCaptureStatus,a as getPromiseRejectionStatus,n as getReportDeliveryStatus};

package/dist/integrations/console.js

@@ -1 +1 @@
-import{h as c}from"../chunk-POE5CSO5.js";import"../chunk-ENPQ66EV.js";import{a as i}from"../chunk-XUSV3KOD.js";var g={log:"info",info:"info",warn:"warn",error:"error",debug:"debug"},a=2048;function p(t){let l=[...new Set(t?.levels??["log","info","warn","error"])];return{name:"console",setup(){let n=!1,e=[];for(let o of l){let r=console[o];if(typeof r!="function")continue;e.push({level:o,fn:r});let u=r.bind(console);console[o]=(...f)=>{if(u(...f),!n){n=!0;try{let s=v(f);s&&!s.startsWith("[everframe]")&&c({message:s,kind:"console",level:g[o]})}catch{}finally{n=!1}}}}return()=>{for(let{level:o,fn:r}of e)console[o]=r}}}}i(p,"consoleIntegration");function v(t){let n=t.map(e=>{if(typeof e=="string")return e;if(e instanceof Error)return e.message;try{return JSON.stringify(e)??String(e)}catch{return String(e)}}).join(" ");return n.length>a?n.slice(0,a):n}i(v,"serializeArgs");export{p as consoleIntegration};
+import{j as c}from"../chunk-MIWWEGLO.js";import"../chunk-UN3Q4UGZ.js";import{a as i}from"../chunk-XUSV3KOD.js";var g={log:"info",info:"info",warn:"warn",error:"error",debug:"debug"},a=2048;function p(t){let l=[...new Set(t?.levels??["log","info","warn","error"])];return{name:"console",setup(){let n=!1,e=[];for(let o of l){let r=console[o];if(typeof r!="function")continue;e.push({level:o,fn:r});let u=r.bind(console);console[o]=(...f)=>{if(u(...f),!n){n=!0;try{let s=v(f);s&&!s.startsWith("[everframe]")&&c({message:s,kind:"console",level:g[o]})}catch{}finally{n=!1}}}}return()=>{for(let{level:o,fn:r}of e)console[o]=r}}}}i(p,"consoleIntegration");function v(t){let n=t.map(e=>{if(typeof e=="string")return e;if(e instanceof Error)return e.message;try{return JSON.stringify(e)??String(e)}catch{return String(e)}}).join(" ");return n.length>a?n.slice(0,a):n}i(v,"serializeArgs");export{p as consoleIntegration};

package/dist/integrations/react-navigation.js

@@ -1 +1 @@
-import{i}from"../chunk-POE5CSO5.js";import"../chunk-ENPQ66EV.js";import{a as n}from"../chunk-XUSV3KOD.js";function o(t){let e=n(()=>{try{let a=t.navigationRef.getCurrentRoute?.()?.name;a&&i(a)}catch{}},"emit");return{name:"react-navigation",onReady:e,onStateChange:e,setup(){try{t.navigationRef.isReady()&&e()}catch{}try{return t.navigationRef.addListener("state",e)}catch{return}}}}n(o,"reactNavigationIntegration");export{o as reactNavigationIntegration};
+import{k as i}from"../chunk-MIWWEGLO.js";import"../chunk-UN3Q4UGZ.js";import{a as n}from"../chunk-XUSV3KOD.js";function o(t){let e=n(()=>{try{let a=t.navigationRef.getCurrentRoute?.()?.name;a&&i(a)}catch{}},"emit");return{name:"react-navigation",onReady:e,onStateChange:e,setup(){try{t.navigationRef.isReady()&&e()}catch{}try{return t.navigationRef.addListener("state",e)}catch{return}}}}n(o,"reactNavigationIntegration");export{o as reactNavigationIntegration};

package/dist/integrations/react.js

@@ -1 +1 @@
-import{b as n,e as a}from"../chunk-POE5CSO5.js";import"../chunk-ENPQ66EV.js";import{a as c}from"../chunk-XUSV3KOD.js";var d=Reflect.apply,u;function l(t,i){let r=a();if(!r){s();return}let p=n(),o;try{if(i!=null){let e=Object.getOwnPropertyDescriptor(i,"componentStack");e&&"value"in e&&typeof e.value=="string"&&(o=e.value)}}catch{}try{let e=r.captureException;if(a()!==r||n()!==p)return;d(e,r,[t,{context:"react.error-boundary",...o!==void 0?{metadata:{componentStack:o}}:{}}])}catch{}}c(l,"captureReactError");function s(){try{let t=n();if(u===t||typeof __DEV__>"u"||!__DEV__)return;u=t,console.warn("[everframe] captureReactError: no EverframeProvider is mounted, so this error was not captured. Render the error boundary inside <EverframeProvider>; errors caught during its first commit are not captured.")}catch{}}c(s,"warnNotMounted");export{l as captureReactError};
+import{d as n,g as a}from"../chunk-MIWWEGLO.js";import"../chunk-UN3Q4UGZ.js";import{a as c}from"../chunk-XUSV3KOD.js";var d=Reflect.apply,u;function l(t,i){let r=a();if(!r){s();return}let p=n(),o;try{if(i!=null){let e=Object.getOwnPropertyDescriptor(i,"componentStack");e&&"value"in e&&typeof e.value=="string"&&(o=e.value)}}catch{}try{let e=r.captureException;if(a()!==r||n()!==p)return;d(e,r,[t,{context:"react.error-boundary",...o!==void 0?{metadata:{componentStack:o}}:{}}])}catch{}}c(l,"captureReactError");function s(){try{let t=n();if(u===t||typeof __DEV__>"u"||!__DEV__)return;u=t,console.warn("[everframe] captureReactError: no EverframeProvider is mounted, so this error was not captured. Render the error boundary inside <EverframeProvider>; errors caught during its first commit are not captured.")}catch{}}c(s,"warnNotMounted");export{l as captureReactError};

package/dist/{promise-rejection-types-C-lxCdDl.d.ts → promise-rejection-types-Bf5iLv8n.d.ts}

@@ -10,7 +10,7 @@ type ReportQueueOperation = typeof queueOperations[number];
 type ReportStorageFailure = typeof storageFailures[number];
 type ReportTransportOrigin = typeof transportOrigins[number];
 type ReportTransportOutcome = typeof transportOutcomes[number];
-type ReportDeliveryReason = 'none' | 'no-start' | 'capture-disabled' | 'no-mount' | 'platform' | 'native-method-missing' | 'native-call-failed' | 'invalid-native-snapshot' | 'snapshot-busy';
+type ReportDeliveryReason = 'none' | 'no-start' | 'capture-disabled' | 'no-mount' | 'platform' | 'native-call-failed' | 'invalid-native-snapshot' | 'snapshot-busy';
 interface ReportCapturePathStatus {
     supported: boolean;
     settledAttempts: number;
@@ -26,7 +26,6 @@ interface ReportQueueStatus {
     terminalHttpPolicy: 'retain' | 'attempt-remove' | 'unknown';
     operations: Record<ReportQueueOperation, number>;
     lastFailure?: ReportStorageFailure;
-    migration: 'not-observed' | 'clear' | 'blocked' | 'unknown';
 }
 interface ReportTransportStatus {
     settledAttempts: number;
@@ -61,7 +60,6 @@ interface ErrorCaptureCounters {
     captureFailed: number;
     reentrantSuppressed: number;
     inactiveAborted: number;
-    legacyAttempted: number;
 }
 type ErrorCaptureOutcome = Exclude<keyof ErrorCaptureCounters, 'attempted'>;
 interface ErrorCaptureStatus {

package/ios/Sources/EverframeBridge.swift

@@ -7,7 +7,7 @@
 // new D-decision):
 //
 //   The RN bridge surface is the Phase 06 5-method TurboModule (configure,
-//   openReporter, registerSensitiveRect, setExtra, attachReactTree). The native
+//   openReporter, registerSensitiveRect, setExtra). The native
 //   EFReporterPresenter owns the entire report UX (capture + annotate + redact +
 //   submit) on iOS/iPadOS. On tvOS the on-device modal reporter was removed —
 //   tvOS hosts call the companion start API and route reporting through the
@@ -26,6 +26,7 @@
 //   • The presenter resolver is installed exactly once per process (idempotent
 //     installer + a local flag for defense-in-depth).
 import Foundation
+import CoreFoundation
 import Combine
 import os.log
 import UIKit
@@ -44,11 +45,15 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
 
     // MARK: - configure
 
+    // Serialize the bridge's start/idempotence decision with synchronous health reservation.
+    private static let configureLock = NSRecursiveLock()
+
     @objc public static func configure(
-        appId: NSString,
+        sdkKey: NSString,
         endpoint: NSString,
         networkBodiesDisabled: Bool,
         installIdentifierDisabled: Bool,
+        crashReportingDisabled: Bool,
         attachPinUi: NSString?,
         companionDeviceId: NSString?,
         companionBadgeEnabled: Bool,
@@ -57,21 +62,32 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
         theme: NSDictionary?,
         vitalsEnabled: NSNumber?,
         vitalsSampleRate: NSNumber?,
-        vitalsCaptureSourceQuery: NSNumber?
+        vitalsCaptureSourceQuery: NSNumber?,
+        debugBuild: NSNumber?,
+        releaseHealthEnabled: Bool,
+        releaseHealthLoadedBuildId: NSString?,
+        releaseHealthUserId: NSString?,
+        releaseHealthIncludeDebugBuilds: Bool,
+        reporterDisabled: Bool = false
     ) throws {
+        configureLock.lock()
+        defer { configureLock.unlock() }
         // `endpoint` arg is retained for ObjC ABI compatibility with the
         // codegen .mm — value is ignored. The SDK bakes the ingest URL at
         // compile time (sdk-ios IngestEndpoint).
         _ = endpoint
-        os_log("[everframe] configure appId=%{public}@", log: log, type: .info, appId as String)
+        os_log("[everframe] configure sdkKey=%{public}@", log: log, type: .info, sdkKey as String)
         // Polarity flips exactly once, here: JS sends the veto
         // (`networkBodiesDisabled`), native stores the permission.
-        var cfg = EverframeConfig(appId: appId as String)
+        var cfg = EverframeConfig(sdkKey: sdkKey as String)
         cfg.capture.networkBodies = !networkBodiesDisabled
         // Polarity flips exactly once, here: JS sends the veto
         // (`installIdentifierDisabled`), native stores the permission —
         // identical to `networkBodies` above.
         cfg.installIdentifierEnabled = !installIdentifierDisabled
+        // Polarity flips exactly once, here: JS sends the veto
+        // (`crashReportingDisabled`), native stores the permission.
+        cfg.capture.crash = !crashReportingDisabled
         // Explicit companion device-identity override (naming spec
         // 2026-08-24) — read straight off the flat ConfigOpts field, same
         // shape as attachPinUi below. nil/absent falls through to the
@@ -87,6 +103,9 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
         // badge) exist, mirroring `companionAttachPinUi` below.
         cfg.companionBadgeEnabled = companionBadgeEnabled
         cfg.shakeToReportEnabled = shakeToReportEnabled
+        // Polarity flips exactly once, here: JS sends the crash-only switch
+        // (`reporterDisabled`), native stores the permission.
+        cfg.reporterEnabled = !reporterDisabled
         cfg.companionBadgePosition = companionBadgePosition as String?
         // Inline reporter theme (reporter branding spec 2026-08-25, RN
         // slice). The .mm collapses the 8 flat ConfigOpts `theme*` wire
@@ -106,57 +125,40 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
         if let vitalsEnabled { cfg.vitals.enabled = vitalsEnabled.boolValue }
         if let vitalsSampleRate { cfg.vitals.sampleRate = vitalsSampleRate.doubleValue }
         if let vitalsCaptureSourceQuery { cfg.vitals.captureSourceQuery = vitalsCaptureSourceQuery.boolValue }
+        // Absent stays nil, so the native SDK detects a debug build itself; present wins.
+        cfg.debugBuild = debugBuild?.boolValue
         // The attach-PIN UI mode for startCompanion() to read (spec 2026-08-19). configure()
         // precedes startCompanion() in every host's lifecycle, so this is the natural place to
         // parse the flat ConfigOpts string into the native enum; startCompanion is where it is
         // actually consumed (RelayWSClient's announce arg + the suppression seam), since a mode
-        // can't affect anything before a relay client exists. Parsed into a LOCAL: the gate
-        // below compares it against the stashed value, and only the start path adopts it.
+        // can't affect anything before a relay client exists. A changed value forces native
+        // reconfiguration even when the SDK configuration itself compares equal.
         let newAttachPinUi = Self.parseAttachPinUi(attachPinUi as String?)
-        // Codex round-6, H1 — IDEMPOTENT configure, twin of `EverframeModule.configure`'s gate on
-        // Android, and decided against the INSTALLED config rather than a cache of the last
-        // options this bridge started with.
-        //
-        // `Everframe.shared.start(...)` SUPERSEDES the running SDK: the outgoing controller's
-        // shutdown detaches every integration it had announced, so a Provider that merely
-        // REMOUNTS with the same config used to kill every live player registration for
-        // nothing. An identical configuration installs identical state, so the cheapest correct
-        // answer is not to start at all.
-        //
-        // Round-5 kept a cached snapshot of the options it last started with, and a cache can
-        // disagree with the singleton it claims to describe: two overlapping configures (A then
-        // B) can interleave so the cache says A while the SDK runs B, and a native host calling
-        // `Everframe.shared.start(configB)` between two bridge configures of A reproduces it with
-        // no concurrency at all — the second A matches the stale cached A, skips, and leaves B
-        // installed under a JS host that believes it configured A. `currentConfig` cannot drift:
-        // it IS the installed state.
-        //
-        // `captureGate` is the second term: a killed SDK must be restarted even by an identical
-        // config, or the host is left with a dead SDK and no way to revive it.
-        //
-        // Codex round-7, I3 — the comparison is the WHOLE config (`EverframeConfig` is now
-        // `Equatable`, matching Android's `data class`), not a rendering of the fields this
-        // bridge happens to set. Round-6 hand-built a string snapshot here, which meant any
-        // config field the snapshot's author had not listed — a new one, or one a native host
-        // set directly — read as "unchanged" and silently suppressed a start that was needed.
-        // `attachPinUi` is the one term that is NOT part of the config (it lands in module
-        // state), so it is compared separately.
-        //
-        // Everything else this method does still runs on the skip path — the presenter-resolver
-        // install and the crash-metadata prime — because both are idempotent and neither
-        // depends on a fresh start. The attach-PIN stash is the exception, and only nominally:
-        // on the skip path it would write the value it already holds.
-        let unchanged = Everframe.shared.captureGate
-            && Everframe.shared.currentConfig == cfg
-            && companionAttachPinUi == newAttachPinUi
-        if unchanged {
-            os_log("[everframe] configure: SDK already running this exact config — skipping start()",
-                   log: log, type: .debug)
+        let health: ReleaseHealthConfiguration?
+        if releaseHealthEnabled, let loaded = releaseHealthLoadedBuildId {
+            // The SDK reads the app version itself; the bridge carries the loaded bundle, the user ID and
+            // whether debug builds count. A nil value (disabled, no loaded bundle, or an invalid identity) is off.
+            health = try? ReleaseHealthConfiguration(userId: releaseHealthUserId as String?,
+                loadedBuildId: loaded as String, loadedBundleStatus: .known,
+                includeDebugBuilds: releaseHealthIncludeDebugBuilds)
         } else {
-            try Everframe.shared.start(config: cfg)
-            // Adopted only on the start path — the skip path has already established that the
-            // stashed value equals this one.
-            companionAttachPinUi = newAttachPinUi
+            health = nil
+        }
+        // The bridge owns release health through `health` alone: it needs the loaded Hermes bundle, and a new
+        // user ID must reconfigure health without restarting the SDK. The native default
+        // (`EverframeConfig.releaseHealth`, on) must not arm anonymous sessions at start or take part in
+        // the unchanged-configuration comparison.
+        cfg.releaseHealth = nil
+        // Native code atomically checks installed config and reserves its exact owner.
+        // An identical configure preserves the session; a changed attach-PIN mode still
+        // requires the same full restart as the other native configuration changes.
+        let applyHealth = try Everframe.shared.configureAndPrepareReleaseHealth(
+            config: cfg, health: health, forceRestart: companionAttachPinUi != newAttachPinUi)
+        companionAttachPinUi = newAttachPinUi
+        // Reservation is tied to this configure's exact native start generation. Later
+        // configure/disable or a native restart invalidates the asynchronous operation.
+        if let applyHealth {
+            Task { _ = await applyHealth() }
         }
         installPresenterResolverIfNeeded()
         // Spec 2026-09-17 setExtra-resolver — installed unconditionally,
@@ -219,9 +221,9 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
     /// Wires `EFReporterPresenter` as the resolver for `Everframe.shared.report
     /// .open()`. Called from configure(); the first call installs, subsequent
     /// calls no-op. tvOS has no on-device modal — reporting goes through the
-    /// phone-companion flow (QR → phone browser) — so the presenter type
-    /// itself is `#if !os(tvOS)`-gated in EverframeReporterUI. Mirror that
-    /// gate here so the bridge compiles for the tvOS slice.
+    /// phone-companion flow (QR → phone browser) — so EverframeReporterUI's
+    /// tvOS `installResolver()` is a no-op. The gate here skips that call and
+    /// logs where tvOS reporting goes instead.
     private static func installPresenterResolverIfNeeded() {
         #if !os(tvOS)
         resolverInstallLock.lock()
@@ -278,7 +280,7 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
     /// every `configure()` is cheap, harmless churn, same as Android already
     /// accepts on every module construction.
     ///
-    /// Returns the fresh generation so `EverframeModule.mm`'s `-configure:`
+    /// Returns the fresh generation so `EverframeModule.mm`'s `-configureSync:`
     /// can capture it (via `currentExtraResolveHookGeneration()` below) and
     /// hand it back to `resetExtraResolverForTeardown(_:)` at `-invalidate`
     /// time. `@discardableResult` because `configure()` itself has no use
@@ -295,8 +297,8 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
 
     /// ObjC-visible read of whichever generation is live RIGHT NOW — i.e.
     /// whatever the most recent `installExtraResolveHook()` call minted.
-    /// `EverframeModule.mm`'s `-configure:` calls this immediately after
-    /// `configureWithAppId:...:error:` (which, on success or on the
+    /// `EverframeModule.mm`'s `-configureSync:` calls this immediately after
+    /// `configureWithSdkKey:...:error:` (which, on success or on the
     /// already-running-unchanged skip path, calls `installExtraResolveHook()`
     /// internally) and stashes the result on its own instance ivar for
     /// `-invalidate` to hand back later. 0 means no `configure()` call has
@@ -400,7 +402,7 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
     /// `RemoteVitalsBridge.reset()`'s own lifetime doc comment.
     ///
     /// IDENTITY GUARD (D1 fix — stale-teardown race). `generation` is the
-    /// value `EverframeModule.mm`'s `-configure:` captured via
+    /// value `EverframeModule.mm`'s `-configureSync:` captured via
     /// `currentExtraResolveHookGeneration()` right after ITS OWN
     /// `configure()` call, stashed on that ObjC instance and handed back
     /// here at `-invalidate` time. RN dispatches `-invalidate` on a
@@ -562,12 +564,29 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
                     dict = ["status": "cancelled"]
                 }
                 completion(dict, nil)
+            } catch EverframeReporterError.reporterDisabled {
+                completion(nil, NSError(
+                    domain: "EverframeBridge", code: reporterDisabledErrorCode,
+                    userInfo: [NSLocalizedDescriptionKey: EverframeReporterError.reporterDisabled.localizedDescription]
+                ))
             } catch {
                 completion(nil, error as NSError)
             }
         }
     }
 
+    /// `openReporter`'s error for a crash-only session (`reporterDisabled: true`).
+    static let reporterDisabledErrorCode = 1101
+
+    /// The promise rejection code for an `openReporter` failure. A crash-only session gets
+    /// `EVERFRAME_REPORTER_DISABLED`, which the JS facade maps to
+    /// `EverframeReporterDisabledError`; anything else keeps `open_reporter_failed`.
+    @objc(openReporterRejectCodeFor:)
+    public static func openReporterRejectCode(for error: NSError) -> String {
+        error.domain == "EverframeBridge" && error.code == reporterDisabledErrorCode
+            ? "EVERFRAME_REPORTER_DISABLED" : "open_reporter_failed"
+    }
+
     // MARK: - registerSensitiveRect
 
     /// Mark a view as sensitive. Routed through MainActor.assumeIsolated so the
@@ -604,12 +623,31 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
     /// `everframe-react-native` (distinct from `CrashReporter.captureFacts`'s
     /// `"everframe-ios"` default) so envelopes are attributable to the RN SDK.
     @objc public static func reportCrash(_ crashJson: NSString) -> Bool {
-        CrashReporter.captureFacts(json: crashJson as String, sdkName: "everframe-react-native")
+        let facts = crashJson as String
+        // Replays on errors (spec 2026-10-11): only an error the app survives asks for a replay of the seconds
+        // before it. A fatal JavaScript error ends the app, so it is a crash and never carries one.
+        guard appSurvivesError(facts) else {
+            return CrashReporter.captureFacts(json: facts, sdkName: "everframe-react-native", attachReplay: false)
+        }
+        return CrashReporter.captureFacts(json: facts, sdkName: "everframe-react-native", attachReplay: true)
     }
 
-    /// Explicit handled capture acknowledges the core's completed encrypted enqueue.
+    /// Explicit handled capture acknowledges the core's completed encrypted enqueue. It is always an error the
+    /// app survives, so it asks for a replay; the core decides whether the session qualifies.
     @objc public static func captureHandledException(_ crashJson: NSString) -> Bool {
-        CrashReporter.captureHandledFacts(json: crashJson as String, sdkName: "everframe-react-native")
+        CrashReporter.captureHandledFacts(json: crashJson as String, sdkName: "everframe-react-native", attachReplay: true)
+    }
+
+    /// True when the facts describe an error the app survives: `fatal` is absent or the JSON boolean `false`,
+    /// which is how `CrashReporter` classifies facts that are not marked fatal. Anything unreadable counts as
+    /// fatal here, so it can only lose a replay, never ask for one on a crash.
+    static func appSurvivesError(_ facts: String) -> Bool {
+        guard let data = facts.data(using: .utf8),
+              let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] else { return false }
+        guard let flag = object["fatal"] else { return true }
+        guard let boolean = flag as? NSNumber,
+              CFGetTypeID(boolean) == CFBooleanGetTypeID() else { return false }
+        return !boolean.boolValue
     }
 
     // MARK: - setExtra
@@ -631,7 +669,7 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
     /// `Everframe.shared.addBreadcrumb(message:kind:level:data:)` (Task 5) —
     /// NO validation/coercion happens here. That singleton already owns
     /// kind/level/data coercion AND gating (no-op pre-start / while killed),
-    /// exactly like `setExtra`/`attachReactTree` above never re-check
+    /// exactly like `setExtra` above never re-checks
     /// `captureGate` themselves. `data` crosses as an `NSDictionary?` — the
     /// codegen-typed `UnsafeObject` boundary for freeform objects; a
     /// non-dictionary payload (shouldn't happen via codegen, but fail-soft
@@ -655,8 +693,8 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
 
     /// Forward a host-declared user from JS into `Everframe.shared.setUser`.
     /// Pure pass-through: the native singleton owns storage — NO
-    /// validation/coercion happens here, same contract as `setExtra`/
-    /// `attachReactTree` above. `nil` clears the active user (the bridge
+    /// validation/coercion happens here, same contract as `setExtra`
+    /// above. `nil` clears the active user (the bridge
     /// forbids `T | null`, so JS expresses "clear" by calling with no
     /// argument, which crosses as `nil` here). A missing key on the incoming
     /// dictionary must become `nil`, never an empty string — that's what
@@ -749,9 +787,7 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
     nonisolated(unsafe) private static var companionClient: RelayWSClient?
     /// The host's configured attach-PIN UI mode (spec 2026-08-19), parsed
     /// from `ConfigOpts.attachPinUi` at `configure()` time. Defaults to
-    /// `.builtin` — the pre-existing-behaviour default for a host that never
-    /// set the flag (including every host on an older RN SDK version whose
-    /// `configure()` call carries no such field at all).
+    /// `.builtin` for a host that never sets the flag.
     nonisolated(unsafe) private static var companionAttachPinUi: AttachPinUi = .builtin
     // `CompanionCaptureBridge` subscribes to the report.request notification
     // posted by RelayWSClient and runs the capture+send dance. Without an
@@ -853,10 +889,10 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
     /// presence", never "no socket": RelayWSClient skips the announce hop
     /// entirely on a nil key and reporting is unaffected.
     private static func configuredSdkKey() -> String? {
-        guard let appId = Everframe.shared.currentConfig?.appId,
-              !appId.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
+        guard let sdkKey = Everframe.shared.currentConfig?.sdkKey,
+              !sdkKey.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
         else { return nil }
-        return appId
+        return sdkKey
     }
 
     /// Non-personal device label for the dashboard's device list — "Apple TV",

package/ios/Sources/EverframeEventEmitter.swift

@@ -70,11 +70,9 @@ public final class EverframeEventEmitter: RCTEventEmitter {
     /// Payload: `{ code, requestedByName, ttlMs }` | NSNull.
     public static let attachChallengeEvent = "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 are gone (spec 2026-08-29). The event and
-    /// the bridge's brief wait survive as the companion's JS-ready
-    /// handshake (see CompanionCaptureBridge.awaitJsReactTreeAttach).
+    /// Fired when a `report.request` arrives from the paired phone. The event
+    /// and the bridge's brief wait are the companion's JS-ready handshake
+    /// (see CompanionCaptureBridge.awaitJsReactTreeAttach).
     /// Payload: String — the correlation_id of the inbound request.
     public static let reportRequestedEvent = "everframe.companion.reportRequested"
 

package/ios/Sources/EverframeModule.mm

@@ -6,7 +6,7 @@
 // to the Swift glue layer (`EverframeBridge` in `EverframeBridge.swift`).
 //
 // Threading (RESEARCH §2.5):
-//   • configure              — JS thread (synchronous; <5ms per sdk-ios contract)
+//   • configureSync          — JS thread (synchronous; <5ms per sdk-ios contract)
 //   • captureNow             — main queue (UIKit reads, capture, accessibility walk)
 //   • registerSensitiveRect  — main queue (RCTUIManager view lookup)
 //   • submit                 — background OK (no UIKit reads); bridge runs it
@@ -75,11 +75,11 @@
   RemoteVitalsBridge *_vitals;
   // D1 fix (stale-teardown identity guard, spec 2026-09-17 setExtra-resolver).
   // Snapshot of `[EverframeBridge currentExtraResolveHookGeneration]` taken
-  // right after THIS instance's most recent `-configure:` call — see
+  // right after THIS instance's most recent `-configureSync:` call — see
   // `EverframeBridge.resetExtraResolverForTeardown(_:)`'s doc comment for why
   // `-invalidate` must hand this back rather than tearing down unconditionally.
   // Zero-initialized by ObjC, matching `resetExtraResolverForTeardown(_:)`'s
-  // "0 = never installed" no-op case for an instance whose `-configure:` was
+  // "0 = never installed" no-op case for an instance whose `-configureSync:` was
   // never called (or never reached the install site) before `-invalidate`.
   NSInteger _extraResolveHookGeneration;
 }
@@ -106,11 +106,13 @@ RCT_EXPORT_MODULE(Everframe)
   _bridge = bridge;
 }
 
-// MARK: - configure(opts)
+// MARK: - configureSync(opts)
 
 // Signature MUST match the codegen-emitted protocol in EverframeSpec.h:
-//   - (void)configure:(JS::NativeEverframe::ConfigOpts &)opts;
-// Field accessors (.apiKey(), .sdkVersion(), .captureScreenshot(),
+//   - (NSNumber *)configureSync:(JS::NativeEverframe::ConfigOpts &)opts;
+// Blocking rather than void: React Native dispatches void TurboModule methods
+// asynchronously, and JS's first capture after mount must not overtake it.
+// Field accessors (.sdkKey(), .sdkVersion(), .captureScreenshot(),
 // .networkBodiesDisabled()) are inline methods on the JS::NativeEverframe::
 // ConfigOpts struct, generated from the TS spec in src/NativeEverframe.ts.
 // The ingest URL is no longer JS-supplied — the native SDK bakes it at
@@ -120,16 +122,18 @@ RCT_EXPORT_MODULE(Everframe)
 // into ConfigOpts by extractBridgeConfig() but is never read below, so it is
 // silently dropped on iOS today. Task 9 (spec 2026-08-12) only wires
 // `networkBodiesDisabled` through; see task-9-report.md.
-- (void)configure:(JS::NativeEverframe::ConfigOpts &)opts {
-  NSString *appId = opts.apiKey() ?: @"";
+- (NSNumber *)configureSync:(JS::NativeEverframe::ConfigOpts &)opts {
+  NSString *sdkKey = opts.sdkKey() ?: @"";
   BOOL networkBodiesDisabled = opts.networkBodiesDisabled().value_or(false);
   // `installIdentifierDisabled` (MAI meter spec 2026-08-27) — `std::optional
   // <bool>`, same shape as `networkBodiesDisabled()` above. Absent means the
   // host said nothing, which is "send it": the SDK default is ON.
   BOOL installIdentifierDisabled = opts.installIdentifierDisabled().value_or(false);
+  // `crashReportingDisabled` — same `std::optional<bool>` shape. Absent keeps capture on.
+  BOOL crashReportingDisabled = opts.crashReportingDisabled().value_or(false);
   // `attachPinUi` (spec 2026-08-19) is a plain optional STRING field —
   // `opts.attachPinUi()` returns a nullable NSString*, same shape as
-  // `opts.apiKey()` above, NOT the `std::optional<bool>` shape
+  // `opts.sdkKey()` above, NOT the `std::optional<bool>` shape
   // `networkBodiesDisabled()` uses. `EverframeBridge.configure` coerces a
   // nil/unrecognised value to `.builtin`.
   NSString *attachPinUi = opts.attachPinUi();
@@ -149,6 +153,9 @@ RCT_EXPORT_MODULE(Everframe)
   // above; `EverframeBridge` coerces nil/unrecognised to `.bottomRight`.
   BOOL companionBadgeEnabled = opts.companionBadgeEnabled().value_or(true);
   BOOL shakeToReportEnabled = opts.shakeToReportEnabled().value_or(true);
+  // Crash-only session switch (spec 2026-10-12) — `std::optional<bool>`, same shape as
+  // `networkBodiesDisabled()`. Absent means a normal report session.
+  BOOL reporterDisabled = opts.reporterDisabled().value_or(false);
   NSString *companionBadgePosition = opts.companionBadgePosition();
   // Inline reporter theme (reporter branding spec 2026-08-25, RN slice) —
   // 8 flat optional STRING fields on ConfigOpts (RN codegen cannot express
@@ -179,11 +186,17 @@ RCT_EXPORT_MODULE(Everframe)
   NSNumber *vitalsEnabled = opts.vitalsEnabled().has_value() ? @(opts.vitalsEnabled().value()) : nil;
   NSNumber *vitalsSampleRate = opts.vitalsSampleRate().has_value() ? @(opts.vitalsSampleRate().value()) : nil;
   NSNumber *vitalsCaptureSourceQuery = opts.vitalsCaptureSourceQuery().has_value() ? @(opts.vitalsCaptureSourceQuery().value()) : nil;
+  // `debugBuild` stays nil when absent so the native SDK decides for itself; the JS facade always sends it.
+  NSNumber *debugBuild = opts.debugBuild().has_value() ? @(opts.debugBuild().value()) : nil;
+  // Release health is on by default: a missing `releaseHealthEnabled` is on and only an explicit NO is
+  // off. The JS facade always sends the flag, so a missing value can only come from another caller.
+  // `releaseHealthIncludeDebugBuilds` is false when missing, matching the native SDK default.
   NSError *err = nil;
-  [EverframeBridge configureWithAppId:appId
+  [EverframeBridge configureWithSdkKey:sdkKey
                             endpoint:@""
                networkBodiesDisabled:networkBodiesDisabled
            installIdentifierDisabled:installIdentifierDisabled
+              crashReportingDisabled:crashReportingDisabled
                          attachPinUi:attachPinUi
                    companionDeviceId:companionDeviceId
                companionBadgeEnabled:companionBadgeEnabled
@@ -193,9 +206,15 @@ RCT_EXPORT_MODULE(Everframe)
                        vitalsEnabled:vitalsEnabled
                     vitalsSampleRate:vitalsSampleRate
             vitalsCaptureSourceQuery:vitalsCaptureSourceQuery
+                          debugBuild:debugBuild
+                releaseHealthEnabled:opts.releaseHealthEnabled().value_or(true)
+          releaseHealthLoadedBuildId:opts.releaseHealthLoadedBuildId()
+                 releaseHealthUserId:opts.releaseHealthUserId()
+     releaseHealthIncludeDebugBuilds:opts.releaseHealthIncludeDebugBuilds().value_or(false)
+                    reporterDisabled:reporterDisabled
                                error:&err];
   if (err != nil) {
-    // Configure is void-typed at the spec; we can't reject a promise here.
+    // A refused configuration is logged; JS keeps its mount either way.
     RCTLogWarn(@"[everframe] configure failed: %@", err.localizedDescription);
   }
   // D1 fix (stale-teardown identity guard, spec 2026-09-17 setExtra-resolver).
@@ -211,13 +230,6 @@ RCT_EXPORT_MODULE(Everframe)
   // the effective options are unchanged and the SDK is already started, and when it does
   // restart, the JS `configureEpoch` bump re-runs every vitals hook effect — each one
   // detaching its old token and tracking a fresh one against the SDK that is now current.
-}
-
-// Additive synchronous startup entry. The legacy void selector above stays
-// ABI-compatible for already-compiled callers; current JS uses this boolean
-// method so its first synchronous capture cannot overtake configure dispatch.
-- (NSNumber *)configureSync:(JS::NativeEverframe::ConfigOpts &)opts {
-  [self configure:opts];
   return @YES;
 }
 
@@ -229,7 +241,9 @@ RCT_EXPORT_MODULE(Everframe)
               reject:(RCTPromiseRejectBlock)reject {
   [EverframeBridge openReporterWithCompletion:^(NSDictionary *result, NSError *err) {
     if (err) {
-      reject(@"open_reporter_failed", err.localizedDescription, err);
+      // `EVERFRAME_REPORTER_DISABLED` for a crash-only session (the JS facade maps it to
+      // `EverframeReporterDisabledError`); `open_reporter_failed` for every other failure.
+      reject([EverframeBridge openReporterRejectCodeFor:err], err.localizedDescription, err);
     } else {
       resolve(result ?: @{});
     }
@@ -390,7 +404,7 @@ RCT_EXPORT_MODULE(Everframe)
   // full 250ms ask-and-wait for an ack nobody will ever send.
   //
   // D1 fix: `_extraResolveHookGeneration` (captured at the end of
-  // `-configure:`) travels with this instance so the Swift side can tell a
+  // `-configureSync:`) travels with this instance so the Swift side can tell a
   // STALE instance's `-invalidate` — delivered late, on this module's
   // method queue, after a reloaded bundle's fresh instance already
   // reconfigured — from the CURRENT one, and no-op the former. See

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everframe/react-native",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "React Native SDK for Everframe — AI-ready in-app bug reporting, bridging the native iOS and Android reporter to your RN app. Supports phone, Apple TV, and Android TV.",
   "author": {
     "name": "Scriptx, UAB",
@@ -100,7 +100,7 @@
   "dependencies": {
     "bippy": "^0.5.39",
     "zod": "^4.3.0",
-    "@everframe/react": "^1.1.0"
+    "@everframe/react": "^1.2.1"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.0",
@@ -112,8 +112,8 @@
     "publint": "^0.3.0",
     "tsup": "^8.0.0",
     "vitest": "^4.0.0",
-    "@everframe/sdk-core": "0.5.0",
-    "@everframe/protocol": "0.6.0"
+    "@everframe/sdk-core": "0.6.0",
+    "@everframe/protocol": "0.7.0"
   },
   "codegenConfig": {
     "name": "EverframeSpec",