@everframe/react-native 1.2.0 → 1.3.0

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-CiyBTz7v.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-CiyBTz7v.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-CiyBTz7v.d.ts}

@@ -4,13 +4,13 @@ declare const queueOperations: readonly ["enqueue-committed", "enqueue-failed",
 declare const storageFailures: readonly ["capacity", "key-unavailable", "corrupt", "io", "revoked", "invalid-entry", "busy", "unknown", "unsupported-format"];
 declare const transportOrigins: readonly ["live-submit", "outbox-drain"];
 declare const transportOutcomes: readonly ["server-accepted", "retryable-http", "terminal-http", "network-failure", "authorization-cancelled", "cancelled", "failed"];
-type ReportCapturePath = typeof capturePaths[number];
-type ReportCaptureOutcome = typeof captureOutcomes[number];
-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 ReportCapturePath = (typeof capturePaths)[number];
+type ReportCaptureOutcome = (typeof captureOutcomes)[number];
+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-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
@@ -66,7 +67,8 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
         releaseHealthEnabled: Bool,
         releaseHealthLoadedBuildId: NSString?,
         releaseHealthUserId: NSString?,
-        releaseHealthIncludeDebugBuilds: Bool
+        releaseHealthIncludeDebugBuilds: Bool,
+        reporterDisabled: Bool = false
     ) throws {
         configureLock.lock()
         defer { configureLock.unlock() }
@@ -101,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
@@ -275,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
@@ -292,7 +297,7 @@ 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
+    /// `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
@@ -397,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
@@ -559,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
@@ -601,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
@@ -628,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
@@ -652,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
@@ -746,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

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,10 +106,12 @@ 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;
+//   - (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.
@@ -120,7 +122,7 @@ 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 {
+- (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
@@ -151,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
@@ -206,9 +211,10 @@ RCT_EXPORT_MODULE(Everframe)
           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).
@@ -224,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;
 }
 
@@ -242,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 ?: @{});
     }
@@ -403,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.2.0",
+  "version": "1.3.0",
   "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.2.0"
+    "@everframe/react": "^1.3.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.0",
@@ -112,8 +112,8 @@
     "publint": "^0.3.0",
     "tsup": "^8.0.0",
     "vitest": "^4.0.0",
-    "@everframe/protocol": "0.7.0",
-    "@everframe/sdk-core": "0.6.0"
+    "@everframe/sdk-core": "0.6.0",
+    "@everframe/protocol": "0.7.0"
   },
   "codegenConfig": {
     "name": "EverframeSpec",

package/src/NativeEverframe.ts

@@ -43,7 +43,7 @@
 //   `setUser(user?: UnsafeObject)` generates
 //   `- (void)setUser:(NSDictionary *)user;` (nullable, matching
 //   `addBreadcrumb`'s `data?: UnsafeObject` above). This was harmless for
-//   `configure(opts: ConfigOpts)` only because that parameter is REQUIRED,
+//   `configureSync(opts: ConfigOpts)` only because that parameter is REQUIRED,
 //   never optional, so the alias-vs-UnsafeObject distinction never mattered
 //   there. `EverframeUserSpec` stays exported as the JS-FACING type (runtime.ts /
 //   contextSeam.ts / index.ts) — only the bridge parameter itself widens to
@@ -63,7 +63,7 @@
 //   `AttachPinUi` enum (`enum AttachPinUi: String` on iOS, `enum class
 //   AttachPinUi` on Android) and coerces anything unrecognised — including
 //   an absent field, which decodes as `undefined` and never reaches native
-//   at all — to `.builtin`/`BUILTIN`. This rides `configure()`, not a new
+//   at all — to `.builtin`/`BUILTIN`. This rides `configureSync()`, not a new
 //   bridge method: the flag is a startup-time preference, not a per-call
 //   argument, so it belongs beside `sdkKey`/`networkBodiesDisabled` on
 //   `ConfigOpts` — see `companion.ts`'s `everframe.companion.attachChallenge`
@@ -85,9 +85,9 @@
 //   the companion `reportRequested`/`signalCompanionReportRequestReady`
 //   handshake below exactly), bounded and fail-open; see both methods' own
 //   doc comments.
-import type { TurboModule } from "react-native";
-import { TurboModuleRegistry } from "react-native";
-import type { UnsafeObject } from "./codegen-types";
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+import type { UnsafeObject } from './codegen-types';
 
 /**
  * Geometry rect crossing the bridge. Flat-object only; codegen cannot express
@@ -171,6 +171,13 @@ export 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
@@ -254,11 +261,10 @@ export type EverframeUserSpec = {
 };
 
 export 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;
   /**
@@ -324,12 +330,7 @@ export interface Spec extends TurboModule {
    * (no-op pre-start / while killed). `data` is typed `UnsafeObject` — the
    * documented codegen escape hatch for freeform objects (see file header).
    */
-  addBreadcrumb(
-    message: string,
-    kind?: string,
-    level?: string,
-    data?: UnsafeObject,
-  ): void;
+  addBreadcrumb(message: string, kind?: string, level?: string, data?: UnsafeObject): void;
 
   /**
    * Navigation screen marker (spec 2026-07-14 — the D-decision for this
@@ -353,6 +354,12 @@ export 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;
 
@@ -369,12 +376,7 @@ export interface Spec extends TurboModule {
   // crosses here. Unknown/duplicate/detached tokens are silent no-ops.
 
   /** Register a remote player. A token already live is ignored. */
-  trackPlayer(
-    token: string,
-    library: string,
-    name?: string,
-    libraryVersion?: string,
-  ): void;
+  trackPlayer(token: string, library: string, name?: string, libraryVersion?: string): void;
   /** `handle.detach()` + drop the token. Native emits `player_detach`. */
   detachPlayer(token: string): void;
   /**
@@ -384,12 +386,7 @@ export interface Spec extends TurboModule {
    * enum); the native context's `emit` refuses anything outside
    * `VitalsPlayerEventType`. `data` is the `UnsafeObject` escape hatch.
    */
-  recordPlayerEvent(
-    token: string,
-    type: string,
-    t: number,
-    data?: UnsafeObject,
-  ): void;
+  recordPlayerEvent(token: string, type: string, t: number, data?: UnsafeObject): void;
   /**
    * Refresh the native snapshot cache: `{ bufferAheadMs, bandwidthEstimate?,
    * bitrate?, width?, height?, droppedFrames? }`. `droppedFrames` is
@@ -403,7 +400,10 @@ export 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;
 
   // ---------------- Phone-companion (Plan 06.2-11) ----------------
@@ -462,4 +462,4 @@ export interface Spec extends TurboModule {
   setUser(user?: UnsafeObject): void;
 }
 
-export default TurboModuleRegistry.getEnforcing<Spec>("Everframe");
+export default TurboModuleRegistry.getEnforcing<Spec>('Everframe');

package/src/codegen-types.ts

@@ -8,4 +8,3 @@
  * whose declaration is disabled by default in React Native 0.87.
  */
 export type UnsafeObject = object;
-

package/dist/chunk-ENPQ66EV.js

@@ -1 +0,0 @@
-import{a as o}from"./chunk-XUSV3KOD.js";var h=["native-handled","bridge-handled","bridge-automatic","jvm-uncaught"],A=["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"],K=["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]/,k=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(A,()=>0)}))},queue:{scope:"sdk-report-outbox",observation:"not-observed",quality:"unknown",capacityPolicy:"unknown",terminalHttpPolicy:"unknown",operations:d(S,()=>0),migration:"not-observed"},transport:d(R,()=>({settledAttempts:0,outcomes:d(K,()=>0)}))}}o(J,"emptyReportDeliveryStatus");function l(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 i=n[a];if(!g(t,i)&&!g(r,i))throw new Error}return e}o(l,"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 c(e,t){if(typeof e!="string"||!g(t,e))throw new Error;return e}o(c,"enumeration");function v(e){if(typeof e!="number"||!U(e)||e<0||e>k)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=l(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>k?k:a)!==n)throw new Error;let i=y(e,"lastOutcome")?c(e.lastOutcome,t):void 0;if(n>0!=(i!==void 0)||i!==void 0&&r[i]===0)throw new Error;return{settledAttempts:n,outcomes:r,...i===void 0?{}:{lastOutcome:i}}}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=l(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=c(t.status,["active","not-started","disabled","unavailable"]),n=c(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=l(t.capture,["enabled","paths"]),i=l(a.paths,h),b=d(h,p=>{let f=l(i[p],["supported","settledAttempts","outcomes"],["lastOutcome"]),m={supported:P(f.supported),...j(f,A)};if(!m.supported&&m.settledAttempts!==0)throw new Error;return m}),u=l(t.queue,["scope","observation","quality","capacityPolicy","terminalHttpPolicy","operations","migration"],["pendingCount","lastFailure"]);if(u.scope!=="sdk-report-outbox")return null;let s={scope:"sdk-report-outbox",observation:c(u.observation,["not-observed","observed","failed"]),quality:c(u.quality,["complete","partial","unknown"]),capacityPolicy:c(u.capacityPolicy,["reject-new","evict-oldest"]),terminalHttpPolicy:c(u.terminalHttpPolicy,["retain","attempt-remove"]),operations:q(u.operations,S),migration:c(u.migration,["not-observed","clear","blocked","unknown"]),...y(u,"pendingCount")?{pendingCount:v(u.pendingCount)}:{},...y(u,"lastFailure")?{lastFailure:c(u.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=l(t.transport,R),E=d(R,p=>{let f=l(D[p],["settledAttempts","outcomes"],["lastOutcome","lastHttpStatus"]),m=j(f,K);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 O(){return{attempted:0,accepted:0,duplicateSuppressed:0,allowanceSuppressed:0,bridgeUnavailable:0,nativeRefused:0,captureFailed:0,reentrantSuppressed:0,inactiveAborted:0,legacyAttempted:0}}o(O,"emptyCounters");function N(e,t){return{status:e,reason:t,scope:"mounted-js-admission",limits:{handled:10,automatic:10},counters:{handled:O(),errorUtils:O(),rejection:O()}}}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};

package/dist/chunk-POE5CSO5.js

@@ -1 +0,0 @@
-import{a as i,c as s,e as u}from"./chunk-ENPQ66EV.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.")}};var r=null,a={};function x(){return a}t(x,"__getContextEpoch");function f(){try{return r?.getPromiseRejectionStatus?.()??u("not-mounted","no-mount")}catch{return u("install-failed","hook-install")}}t(f,"getPromiseRejectionStatus");function E(e){r=e,a={}}t(E,"__setCurrentContext");function g(){return r}t(g,"__getCurrentContext");function R(){let e=r;return e?e.open():Promise.reject(new n("EverframeProvider not mounted; wrap your root with <EverframeProvider>."))}t(R,"open");function S(e){r?.setExtra(e)}t(S,"setExtra");function y(e){r?.addBreadcrumb(e)}t(y,"addBreadcrumb");function C(e,o){o!==void 0?r?.recordScreen(e,o):r?.recordScreen(e)}t(C,"recordScreen");function b(e){r?.setUser(e)}t(b,"setUser");function j(e,o){r?.captureException(e,o)}t(j,"captureException");function w(){try{return r?.getErrorCaptureStatus?.()??s("not-mounted","no-mount")}catch{return s("not-mounted","no-mount")}}t(w,"getErrorCaptureStatus");function P(){let e=r;try{let o=e?.getReportDeliveryStatus?.();return e===r&&o?o:i("not-mounted","no-mount")}catch{return i("unavailable","native-call-failed")}}t(P,"getReportDeliveryStatus");export{n as a,x as b,f as c,E as d,g as e,R as f,S as g,y as h,C as i,b as j,j as k,w as l,P as m};