@everframe/react-native 1.0.0 → 1.2.0

package/dist/index.web.d.ts

@@ -1 +1,13 @@
+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';
 export * from '@everframe/react';
+
+/** Hermes observation is separate from the browser SDK's own rejection handling. */
+declare function getPromiseRejectionStatus(): PromiseRejectionStatus;
+
+/** Mobile admission diagnostics are unavailable on the browser entry. */
+declare function getErrorCaptureStatus(): ErrorCaptureStatus;
+
+declare function getReportDeliveryStatus(): ReportDeliveryStatus;
+
+export { ErrorCaptureStatus, PromiseRejectionStatus, ReportDeliveryStatus, getErrorCaptureStatus, getPromiseRejectionStatus, getReportDeliveryStatus };

package/dist/index.web.js

@@ -1 +1 @@
-export*from"@everframe/react";
+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};

package/dist/integrations/console.js

@@ -1 +1 @@
-import{f as c}from"../chunk-QRPINMCR.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{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};

package/dist/integrations/react-navigation.js

@@ -1 +1 @@
-import{g as i}from"../chunk-QRPINMCR.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{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};

package/dist/integrations/react.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Call from an application's componentDidCatch, in a boundary rendered inside
+ * EverframeProvider. A boundary that wraps the provider replaces it with its
+ * fallback in the same commit, before componentDidCatch runs, so its calls find
+ * no provider unless that fallback mounts one. Inside the provider, errors
+ * caught during its first commit are not captured: the provider publishes its
+ * runtime after its descendants' componentDidCatch.
+ * The application owns its fallback and recovery policy. Native acceptance does
+ * not establish delivery; fatal escalation can still produce a separate report.
+ */
+declare function captureReactError(error: unknown, info?: {
+    componentStack?: string | null;
+}): void;
+
+export { captureReactError };

package/dist/integrations/react.js

@@ -0,0 +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};

package/dist/promise-rejection-types-C-lxCdDl.d.ts

@@ -0,0 +1,101 @@
+declare const capturePaths: readonly ["native-handled", "bridge-handled", "bridge-automatic", "jvm-uncaught"];
+declare const captureOutcomes: readonly ["persisted", "disabled", "admission-suppressed", "reentrant", "invalid-input", "ownership-lost", "storage-unavailable", "failed"];
+declare const queueOperations: readonly ["enqueue-committed", "enqueue-failed", "capacity-evicted", "removed-after-acceptance", "removed-after-terminal", "removal-failed", "read-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';
+interface ReportCapturePathStatus {
+    supported: boolean;
+    settledAttempts: number;
+    outcomes: Record<ReportCaptureOutcome, number>;
+    lastOutcome?: ReportCaptureOutcome;
+}
+interface ReportQueueStatus {
+    scope: 'sdk-report-outbox';
+    observation: 'not-observed' | 'observed' | 'failed';
+    quality: 'complete' | 'partial' | 'unknown';
+    pendingCount?: number;
+    capacityPolicy: 'reject-new' | 'evict-oldest' | 'unknown';
+    terminalHttpPolicy: 'retain' | 'attempt-remove' | 'unknown';
+    operations: Record<ReportQueueOperation, number>;
+    lastFailure?: ReportStorageFailure;
+    migration: 'not-observed' | 'clear' | 'blocked' | 'unknown';
+}
+interface ReportTransportStatus {
+    settledAttempts: number;
+    outcomes: Record<ReportTransportOutcome, number>;
+    lastOutcome?: ReportTransportOutcome;
+    lastHttpStatus?: number;
+}
+interface ReportDeliveryStatus {
+    schemaVersion: 1;
+    status: 'active' | 'not-started' | 'disabled' | 'not-mounted' | 'unsupported' | 'unavailable';
+    reason: ReportDeliveryReason;
+    scope: 'native-runtime-observations';
+    coverage: 'best-effort';
+    revision: number;
+    capture: {
+        enabled: boolean;
+        paths: Record<ReportCapturePath, ReportCapturePathStatus>;
+    };
+    queue: ReportQueueStatus;
+    transport: Record<ReportTransportOrigin, ReportTransportStatus>;
+}
+
+/** Local admission only: native acceptance is not delivery confirmation. */
+type ErrorCapturePath = 'handled' | 'errorUtils' | 'rejection';
+interface ErrorCaptureCounters {
+    attempted: number;
+    accepted: number;
+    duplicateSuppressed: number;
+    allowanceSuppressed: number;
+    bridgeUnavailable: number;
+    nativeRefused: number;
+    captureFailed: number;
+    reentrantSuppressed: number;
+    inactiveAborted: number;
+    legacyAttempted: number;
+}
+type ErrorCaptureOutcome = Exclude<keyof ErrorCaptureCounters, 'attempted'>;
+interface ErrorCaptureStatus {
+    status: 'not-mounted' | 'disabled' | 'active' | 'unsupported';
+    reason: 'no-mount' | 'crash-reporting-disabled' | 'none' | 'platform';
+    scope: 'mounted-js-admission';
+    limits: {
+        handled: 10;
+        automatic: 10;
+    };
+    counters: Record<ErrorCapturePath, ErrorCaptureCounters>;
+}
+
+type RejectionReason = 'none' | 'opt-in-required' | 'crash-reporting-disabled' | 'platform' | 'runtime' | 'promise-identity' | 'hook-shape' | 'hook-install' | 'hook-displaced' | 'no-mount';
+interface PromiseRejectionCounters {
+    pending: number;
+    accepted: number;
+    cancelled: number;
+    capacityDropped: number;
+    sizeDropped: number;
+    expired: number;
+    duplicateSuppressed: number;
+    allowanceSuppressed: number;
+    nativeRefused: number;
+    captureFailed: number;
+    /** Pending observations released when another owner replaced the hooks. */
+    discarded: number;
+}
+interface PromiseRejectionStatus {
+    status: 'disabled' | 'unsupported' | 'observing' | 'displaced' | 'install-failed' | 'not-mounted';
+    reason: RejectionReason;
+    adapterId?: string;
+    previousCallbacksPresent: boolean;
+    counters: PromiseRejectionCounters;
+}
+
+export type { ErrorCaptureStatus as E, PromiseRejectionStatus as P, ReportDeliveryStatus as R, ErrorCaptureCounters as a, ErrorCaptureOutcome as b, ErrorCapturePath as c, PromiseRejectionCounters as d, RejectionReason as e, ReportCaptureOutcome as f, ReportCapturePath as g, ReportCapturePathStatus as h, ReportDeliveryReason as i, ReportQueueOperation as j, ReportQueueStatus as k, ReportStorageFailure as l, ReportTransportOrigin as m, ReportTransportOutcome as n, ReportTransportStatus as o };

package/ios/Sources/EverframeBridge.swift

@@ -44,11 +44,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 +61,31 @@ 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
     ) 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
@@ -106,57 +120,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 +216,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()
@@ -296,7 +293,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
-    /// `configureWithAppId:...:error:` (which, on success or on the
+    /// `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
@@ -592,6 +589,11 @@ import EverframeReporterUI    // tvOS slice present per Package.swift:12 (TV-03
         }
     }
 
+    /// Cached, content-free native delivery facts. Encoding failure is rejected by JS.
+    @objc public static func getReportDeliveryStatusJson() -> NSString {
+        ((try? Everframe.shared.getReportDeliveryStatus().toJSON()) ?? "{}") as NSString
+    }
+
     // MARK: - reportCrash (Task 13 — crash/error reporting spec 2026-07-18)
 
     /// Crash/error reporting. Synchronous: the RN fatal path must finish
@@ -848,10 +850,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/EverframeModule.mm

@@ -110,7 +110,7 @@ RCT_EXPORT_MODULE(Everframe)
 
 // Signature MUST match the codegen-emitted protocol in EverframeSpec.h:
 //   - (void)configure:(JS::NativeEverframe::ConfigOpts &)opts;
-// Field accessors (.apiKey(), .sdkVersion(), .captureScreenshot(),
+// 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
@@ -121,15 +121,17 @@ RCT_EXPORT_MODULE(Everframe)
 // 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() ?: @"";
+  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();
@@ -179,11 +181,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,6 +201,11 @@ 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)
                                error:&err];
   if (err != nil) {
     // Configure is void-typed at the spec; we can't reject a promise here.
@@ -419,6 +432,10 @@ RCT_EXPORT_MODULE(Everframe)
   [EverframeBridge setUser:dict];
 }
 
+- (NSString *)getReportDeliveryStatusJson {
+  return [EverframeBridge getReportDeliveryStatusJson];
+}
+
 // MARK: - reportCrash(crashJson) — Task 13 (spec 2026-07-18)
 
 // Sync spec method: codegen emits a non-void, non-promise boolean-returning

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everframe/react-native",
-  "version": "1.0.0",
+  "version": "1.2.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",
@@ -73,6 +73,11 @@
     "./integrations/theoplayer": {
       "types": "./dist/integrations/theoplayer.d.ts",
       "default": "./dist/integrations/theoplayer.js"
+    },
+    "./integrations/react": {
+      "types": "./dist/integrations/react.d.ts",
+      "browser": null,
+      "default": "./dist/integrations/react.js"
     }
   },
   "files": [
@@ -95,7 +100,7 @@
   "dependencies": {
     "bippy": "^0.5.39",
     "zod": "^4.3.0",
-    "@everframe/react": "^1.0.0"
+    "@everframe/react": "^1.2.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.0",
@@ -107,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/protocol": "0.7.0",
+    "@everframe/sdk-core": "0.6.0"
   },
   "codegenConfig": {
     "name": "EverframeSpec",

package/src/NativeEverframe.ts

@@ -65,7 +65,7 @@
 //   an absent field, which decodes as `undefined` and never reaches native
 //   at all — to `.builtin`/`BUILTIN`. This rides `configure()`, not a new
 //   bridge method: the flag is a startup-time preference, not a per-call
-//   argument, so it belongs beside `apiKey`/`networkBodiesDisabled` on
+//   argument, so it belongs beside `sdkKey`/`networkBodiesDisabled` on
 //   `ConfigOpts` — see `companion.ts`'s `everframe.companion.attachChallenge`
 //   event, the JS-facing half of this same D-decision.
 //   Session Vitals (spec 2026-09-06) is the next D-decision after that —
@@ -105,7 +105,7 @@ export type Rect = {
  * Rich variants (e.g., callbacks, function refs) MUST stay on the JS side.
  */
 export type ConfigOpts = {
-  apiKey?: string;
+  sdkKey?: string;
   sdkVersion?: string;
   /**
    * If true, the native side captures a UIWindow/SurfaceFlinger screenshot
@@ -131,6 +131,14 @@ export type ConfigOpts = {
    * once polarity is flipped.
    */
   installIdentifierDisabled?: boolean;
+  /**
+   * Client veto for automatic crash capture. `true` turns off the native SDKs' crash capture
+   * (JVM, native crashes and ANRs on Android; native crashes on iOS) as well as the JS handlers:
+   * both natives store `capture.crash = !crashReportingDisabled`. Flat because RN codegen rejects
+   * nested objects; `extractBridgeConfig` flattens the host-facing `crashReporting: { disabled }`.
+   * Absent means capture stays on.
+   */
+  crashReportingDisabled?: boolean;
   /**
    * Built-in attach-PIN surface mode (spec 2026-08-19): 'builtin' (default —
    * the native SDK presents the code itself), 'custom' (host renders it from
@@ -210,6 +218,21 @@ export type ConfigOpts = {
   vitalsEnabled?: boolean;
   vitalsSampleRate?: number;
   vitalsCaptureSourceQuery?: boolean;
+  /**
+   * Whether this is a debug build, which Everframe never makes a release out of. The JS facade always
+   * sends it (the config's `debugBuild`, else `__DEV__`). Absent means the native SDK decides for itself.
+   */
+  debugBuild?: boolean;
+  /**
+   * Native foreground monitoring (release health). The JS facade always sends this flag: `true` with a
+   * validated loaded bundle, or `false` to revoke monitoring. A bridge that finds it missing treats it as
+   * on, and only an explicit `false` as off. The native SDK reads the app version.
+   */
+  releaseHealthEnabled?: boolean;
+  releaseHealthLoadedBuildId?: string;
+  releaseHealthUserId?: string;
+  /** Count debug builds, which the native SDKs skip by default. Absent means false. */
+  releaseHealthIncludeDebugBuilds?: boolean;
 };
 
 /**
@@ -319,6 +342,9 @@ export interface Spec extends TurboModule {
    */
   recordScreen(name: string, data?: UnsafeObject): void;
 
+  /** Additive diagnostic bridge: bounded JSON of cached native observations; no I/O. */
+  getReportDeliveryStatusJson(): string;
+
   /**
    * Crash/error reporting (spec 2026-07-18). SYNCHRONOUS by design (non-void
    * return forces a sync TurboModule method): the fatal path must complete

package/dist/chunk-QRPINMCR.js

@@ -1 +0,0 @@
-import{a as r}from"./chunk-XUSV3KOD.js";var n=class extends Error{static{r(this,"EverframeNotMountedError")}name="EverframeNotMountedError";constructor(o){super(o??"EverframeProvider is not mounted; wrap your app root.")}};var t=null;function a(e){t=e}r(a,"__setCurrentContext");function d(){return t}r(d,"__getCurrentContext");function p(){let e=t;return e?e.open():Promise.reject(new n("EverframeProvider not mounted; wrap your root with <EverframeProvider>."))}r(p,"open");function c(e){t?.setExtra(e)}r(c,"setExtra");function v(e){t?.addBreadcrumb(e)}r(v,"addBreadcrumb");function x(e,o){o!==void 0?t?.recordScreen(e,o):t?.recordScreen(e)}r(x,"recordScreen");function m(e){t?.setUser(e)}r(m,"setUser");function f(e,o){t?.captureException(e,o)}r(f,"captureException");export{n as a,a as b,d as c,p as d,c as e,v as f,x as g,m as h,f as i};