@scalebun/react-native 1.0.1 → 1.0.3

package/lib/typescript/features/ota/signature.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Bundle signature verification (OTA-03).
+ *
+ * WHAT WAS WRONG. `ota-signing-key.service.ts` documents the intended model
+ * exactly: the CLI generates an ed25519 keypair locally, uploads only the public
+ * half, and "the device verifies every bundle's signature before install and
+ * rejects forgeries." Two of those three steps did not exist. The CLI had no
+ * signing code, and this SDK received `bundle.signature` in the check response
+ * and never read it. The only client-side check was SHA-256 against a hash
+ * delivered in the same response as the URL — which defends against a corrupted
+ * download and nothing else. On a platform whose entire purpose is remote code
+ * delivery, that is the control that matters most.
+ *
+ * WHY IT IS SHAPED LIKE THIS. The SDK ships zero third-party runtime
+ * dependencies, and React Native has no built-in ed25519. So verification is
+ * delegated to a host-provided verifier when one is installed, and the SDK's job
+ * is to decide — unambiguously — what happens when there is not one.
+ *
+ * THE POLICY, which is the important part:
+ *
+ *   - A bundle carrying a signature, with a configured public key and a
+ *     verifier: verified. Failure REJECTS the install. This is the goal state.
+ *   - A bundle carrying a signature, with a public key configured, but no
+ *     verifier available: REJECT. The app asked for signature enforcement by
+ *     configuring a key; silently installing unverified code because a helper is
+ *     missing would turn a security feature into a placebo.
+ *   - No public key configured: skip, and say so once. Signing is opt-in per app,
+ *     and an app that has not adopted it must keep working.
+ *
+ * The failure mode is the whole design: an app that opts in cannot be
+ * accidentally downgraded to unverified installs.
+ */
+/** Verifies a detached ed25519 signature. Supplied by the host app. */
+export type SignatureVerifier = (input: {
+    /** Hex-encoded SHA-256 of the bundle — what the signature is over. */
+    messageHex: string;
+    /** Hex or base64 detached signature from the check response. */
+    signature: string;
+    /** The app's configured ed25519 public key. */
+    publicKey: string;
+}) => boolean | Promise<boolean>;
+export interface SignatureConfig {
+    /** ed25519 public key shipped in the app binary. Absent = signing not adopted. */
+    publicKey?: string;
+    /** Host-provided ed25519 verification function. */
+    verifier?: SignatureVerifier;
+}
+export type SignatureOutcome = {
+    ok: true;
+    reason: 'verified' | 'not_configured';
+} | {
+    ok: false;
+    reason: 'no_verifier' | 'invalid_signature' | 'missing_signature' | 'verifier_threw';
+};
+/**
+ * Decide whether a bundle may be staged.
+ *
+ * Returns a structured outcome rather than a boolean so the caller can emit a
+ * precise telemetry reason — "we shipped unverified code because no key was
+ * configured" and "we refused because the signature was forged" are very
+ * different operational events and must not collapse into one.
+ */
+export declare function verifyBundleSignature(bundleSha256: string, signature: string | undefined, config: SignatureConfig | undefined): Promise<SignatureOutcome>;
+/** Test seam — resets the once-per-process "not configured" warning. */
+export declare function _resetSignatureWarnings(): void;
+//# sourceMappingURL=signature.d.ts.map

package/lib/typescript/features/ota/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../../src/features/ota/signature.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE;IACtC,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEjC,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAIxG;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/lib/typescript/features/session/BackendSessionAdapter.d.ts

@@ -89,8 +89,31 @@ export declare class BackendSessionAdapter implements SessionTransport {
     private readonly _frameStore;
     /** Storage key for the snapshotted unflushed frame buffer (see persistPendingFrames). */
     private static readonly PENDING_FRAMES_KEY;
-    /** Cap on frames persisted per snapshot — bounds KV footprint (keeps the most recent). */
-    private static readonly MAX_PERSIST_FRAMES;
+    /**
+     * Byte budget for the cross-kill frame snapshot (see `_selectFramesToPersist`).
+     *
+     * Replaces a flat 10-frame cap. A count could not bound the KV write at all — these frames carry
+     * base64 screenshots, so ten of them is anywhere from ~200 KB to several MB depending on device
+     * resolution, and an oversized value is exactly what fails on the background transition where
+     * this write happens.
+     *
+     * 2 MB is deliberately modest: this is a last-resort snapshot for frames that never reached the
+     * network, not a mirror of the session. Enough for a keyframe plus a run of deltas on any device;
+     * small enough that writing it cannot itself be the reason backgrounding stalls.
+     */
+    private static readonly MAX_PERSIST_BYTES;
+    /**
+     * Frames the backend accepts in ONE request — `'Max 100 frames per batch'`
+     * (`IngestionService.uploadFrames`). Exceeding it is a 4xx, which this SDK classifies as
+     * permanent.
+     *
+     * This has to exist alongside the byte budget, not instead of it. The budget alone cannot bound
+     * the COUNT, and the count is what the server checks: measured on real traffic, mobile keyframes
+     * average ~16 KB, so a 2 MB snapshot is around 128 frames — over the cap by construction. The old
+     * flat 10-frame rule was under it by construction, which is why this failure could not happen
+     * before and can now.
+     */
+    private static readonly MAX_FRAMES_PER_BATCH;
     private objectStorageActive;
     private readonly nativeOutboxEnabled;
     private _nativeOutboxReady;
@@ -104,6 +127,14 @@ export declare class BackendSessionAdapter implements SessionTransport {
     private pendingLogs;
     private flushTimer;
     private destroyed;
+    /**
+     * Latch for `sdk_replay_capture_failed` — reported once per adapter, not once per rejected batch.
+     *
+     * A session whose row was never created rejects EVERY frame batch, so an unlatched report would
+     * emit one analytics event per flush for as long as the app stays open, on the same lane it is
+     * trying to report through.
+     */
+    private _captureFailureReported;
     private static readonly ANALYTICS_BUFFER_CAP;
     /** Logs lane: queue length that triggers an eager flush (mirrors the network lane). */
     private static readonly LOGS_BATCH_SIZE;
@@ -272,6 +303,44 @@ export declare class BackendSessionAdapter implements SessionTransport {
     /** Shallow-prune null/undefined/'' leaves from a payload object. */
     private _pruneEmpty;
     private _flushFrames;
+    /**
+     * Report frames the SDK gave up on, on the analytics lane.
+     *
+     * SAME EVENT NAME AS THE WEB SDK (`sdk_replay_capture_failed`) with platform-specific `reason`
+     * values, so one dashboard breakdown reads both platforms without a concept-map alias — the two
+     * SDKs share no event vocabulary otherwise (`$pageview` vs `screen_viewed`), and adding a second
+     * name here would need an entry in `event-concepts.ts` for no benefit.
+     *
+     * Latched to once per session: a session whose row was never created rejects every batch, and an
+     * unlatched report would emit one event per flush for as long as the app is open.
+     *
+     * Best-effort and never throws — a diagnostic must not be able to break the capture path it
+     * describes.
+     */
+    private _reportCaptureFailure;
+    /**
+     * Post frames in BACKEND-SAFE CHUNKS, and return the ones that were not durably accepted.
+     *
+     * WHY THIS EXISTS. `_postFrameBatch` issues exactly one request for whatever array it is handed,
+     * and both callers could hand it more than the server's 100-frame cap — the live flush via
+     * `config.batchSize`, and cross-kill recovery via the 2 MB persistence budget (~128 frames at the
+     * measured 16 KB average). The result was a 4xx, classified permanent, and on the recovery path
+     * that meant `_clearPersistedFrames()` — the ENTIRE cross-kill snapshot deleted because it was
+     * one frame too big to send in a single request it never needed to be sent in.
+     *
+     * THE RETURN VALUE IS THE POINT. The caller must be able to delete exactly what landed and keep
+     * exactly what did not, so this reports the survivors rather than throwing:
+     *   - chunk accepted            → dropped from the result (it is durably stored)
+     *   - chunk PERMANENTLY refused → dropped, and reported once. Re-sending identical bytes cannot
+     *                                 succeed, and holding it would wedge every future launch on the
+     *                                 same poison chunk. Only that chunk is abandoned; the rest still
+     *                                 gets its chance, which is the whole difference from before.
+     *   - chunk TRANSIENTLY failed  → that chunk AND every chunk after it are kept, in order. We stop
+     *                                 on the first transient failure rather than pressing on, because
+     *                                 the usual cause is the network being gone and the rest would
+     *                                 fail identically.
+     */
+    private _postFramesChunked;
     /**
      * POST one frame batch under an EXPLICIT sessionId (object-storage path when
      * active, else legacy inline base64). Used by both the live flush and cross-kill
@@ -287,6 +356,28 @@ export declare class BackendSessionAdapter implements SessionTransport {
      * next coalesced flush. No-op if recovery storage is absent or nothing pending.
      */
     persistPendingFrames(): void;
+    /**
+     * Choose which unflushed frames survive a process kill.
+     *
+     * WHY THIS IS NOT `slice(-10)`.
+     *
+     * The old rule kept the ten most RECENT frames, which is the wrong end of the buffer for replay.
+     * A delta reconstructs against its base keyframe, so ten trailing deltas whose keyframe was
+     * dropped are unplayable on their own — they arrive as `orphaned`, the state the dashboard flags
+     * as a capture defect. Keeping the keyframe and fewer deltas yields a SHORTER replay; keeping the
+     * deltas and no keyframe yields NO replay. That asymmetry is the whole decision.
+     *
+     * So: every keyframe is kept, then the most recent deltas fill whatever byte budget is left. This
+     * mirrors the web SDK's `capBytes` policy (which sheds deltas first and never the keyframe), so
+     * the two platforms lose the same thing under pressure instead of two different things.
+     *
+     * BYTES, not a frame count. A count is a poor proxy here: these carry base64 screenshots, so ten
+     * frames may be 200 KB or 4 MB depending on device resolution — and this write goes to a KV store
+     * on the background transition, where an oversized value is the thing most likely to fail and
+     * lose the snapshot entirely. `imageData.length` is the base64 length, which is within ~1% of the
+     * serialized cost and needs no extra pass.
+     */
+    private static _selectFramesToPersist;
     /** Drop the persisted frame snapshot (after successful delivery). Never throws. */
     private _clearPersistedFrames;
     /**

package/lib/typescript/features/session/BackendSessionAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackendSessionAdapter.d.ts","sourceRoot":"","sources":["../../../../src/features/session/BackendSessionAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EACR,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,YAAY,EACZ,WAAW,EACd,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,oBAAoB;IACjC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,wFAAwF;IACxF,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAID,qBAAa,qBAAsB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,MAAM,CAAmH;IACjI,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,yFAAyF;IACzF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAoC;IAC9E,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IAEhD,OAAO,CAAC,mBAAmB,CAAU;IAIrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAE9C,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,gBAAgB,CAAuB;IAQ/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,aAAa,CAAwD;IAC7E,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,sBAAsB,CAAsC;IACpE,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,yBAAyB,CAAsC;IAGvE,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,SAAS,CAAS;IAO1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAO;IACnD,uFAAuF;IACvF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAM;IAC7C,uEAAuE;IACvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAM;IAC5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,sBAAsB,CAAsB;IACpD,OAAO,CAAC,mBAAmB,CAA+C;IAQ1E,OAAO,CAAC,kBAAkB,CAAuB;gBAErC,MAAM,EAAE,oBAAoB;IAwBxC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAIxB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAsExC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAyDtC,2EAA2E;IAC3E,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;IAED;;;;;OAKG;IACG,qBAAqB,CAAC,OAAO,EAAE;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,eAAe,CAAC;QAC3B;+EACuE;QACvE,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CjB;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAYrC;;;;;;;OAOG;IACH,mBAAmB,CACf,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,EACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI;IAYP;;;;;;OAMG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;OAIG;YACW,qBAAqB;IA0BnC,8EAA8E;IACxE,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC/C;;;;;;;;OAQG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/C,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,wBAAwB;IAOhC,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAgBpC,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAkBtD,mBAAmB,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QACpE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QACjF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrF,GAAG,IAAI;IAUR,UAAU,CAAC,IAAI,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KACtE,GAAG,IAAI;IAQR,8EAA8E;IAC9E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B,sBAAsB,CAAC,IAAI,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACrE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,GAAG,IAAI;IAQR;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QACjE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC1D,GAAG,IAAI;IAeR,iFAAiF;IACjF,OAAO,CAAC,SAAS;IAMjB;;;;;OAKG;YACW,cAAc;IAe5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;;;OAKG;IACH,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAO3C,sFAAsF;IACtF,OAAO,CAAC,mBAAmB;IAW3B,OAAO,IAAI,IAAI;IAkBf,6FAA6F;IAC7F,OAAO,CAAC,UAAU;IA4BlB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAiBlB,oEAAoE;IACpE,OAAO,CAAC,WAAW;YAYL,YAAY;IAuB1B;;;;;;OAMG;YACW,eAAe;IAmC7B;;;;;OAKG;IACH,oBAAoB,IAAI,IAAI;IAc5B,mFAAmF;IACnF,OAAO,CAAC,qBAAqB;IAS7B;;;;;;OAMG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC7C;;;;OAIG;YACW,uBAAuB;YAqCvB,YAAY;YA8BZ,aAAa;YAYb,YAAY;YAYZ,iBAAiB;YAYjB,UAAU;IAcxB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,MAAM,CAAC,qBAAqB;YAKtB,KAAK;IAsCnB;;;;OAIG;YACW,cAAc;IA4B5B;;;;OAIG;YACW,SAAS;IAuBvB,qFAAqF;IACrF,OAAO,CAAC,aAAa;CAIxB"}
+{"version":3,"file":"BackendSessionAdapter.d.ts","sourceRoot":"","sources":["../../../../src/features/session/BackendSessionAdapter.ts"],"names":[],"mappings":"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"}

package/lib/typescript/index.d.ts

@@ -11,6 +11,12 @@
  */
 export { default } from './public/ScaleBunFacade';
 export { ScaleBunProvider } from './public/ScaleBunProvider';
+/**
+ * Render-error boundary. Named and shaped to match `@scalebun/web-react`'s export so the same code
+ * works on both platforms — see the note in ScaleBunErrorBoundary.tsx for why a host boundary
+ * without this silently swallowed every React render error.
+ */
+export { ScaleBunErrorBoundary, type ScaleBunErrorBoundaryProps } from './public/ScaleBunErrorBoundary';
 export { ScaleBunDebugRoot, ScaleBunScreen, useScaleBunScreen } from './features/journey/ScaleBunDebugRoot';
 export { ScaleBunScrollView } from './features/journey/ScaleBunScrollView';
 export { ScaleBunFlatList } from './features/journey/ScaleBunFlatList';

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/typescript/public/ScaleBunErrorBoundary.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ScaleBunErrorBoundary — React render errors, forwarded to the SDK.
+ *
+ * THE GAP THIS CLOSES
+ * `ErrorUtils.setGlobalHandler` catches a render error only when NO boundary intercepts it first.
+ * The moment a host wraps its tree in its own boundary — which most production apps do — that
+ * boundary's `componentDidCatch` consumes the error, it never reaches `ErrorUtils`, and the SDK
+ * recorded nothing at all. The screen went blank or fell back, and the crash list stayed empty.
+ *
+ * The web SDK has shipped `ScaleBunErrorBoundary` from `@scalebun/web-react` for exactly this reason;
+ * React Native had no equivalent and no `componentDidCatch` hook a host could forward through. This
+ * is the counterpart, and the two are deliberately the same component with the same prop names so a
+ * team working across both platforms writes the same thing twice.
+ *
+ * Use it INSTEAD of your own boundary, or nest it inside one — `onError` runs after capture so an
+ * existing boundary's logging keeps working.
+ *
+ * ```tsx
+ * <ScaleBunErrorBoundary fallback={(e) => <Text>Something broke: {e.message}</Text>}>
+ *   <App />
+ * </ScaleBunErrorBoundary>
+ * ```
+ */
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+export interface ScaleBunErrorBoundaryProps {
+    children: ReactNode;
+    /** Rendered after a caught error. A function receives the error; a node is rendered as-is. */
+    fallback?: ReactNode | ((error: Error) => ReactNode);
+    /** Extra hook after the error is captured (e.g. custom logging). */
+    onError?: (error: Error, info: ErrorInfo) => void;
+    /** Screen name to attribute the error to, when the host knows it. */
+    screenName?: string;
+}
+interface State {
+    error: Error | null;
+}
+export declare class ScaleBunErrorBoundary extends Component<ScaleBunErrorBoundaryProps, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=ScaleBunErrorBoundary.d.ts.map

package/lib/typescript/public/ScaleBunErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScaleBunErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/public/ScaleBunErrorBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlE,MAAM,WAAW,0BAA0B;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC;IACrD,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,KAAK;IACX,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACvB;AAED,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,0BAA0B,EAAE,KAAK,CAAC;IACnF,KAAK,EAAE,KAAK,CAAmB;IAE/B,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAIpD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAwBtD,MAAM,IAAI,SAAS;CAOtB"}

package/lib/typescript/specs/NativeScaleBunOta.d.ts

@@ -65,6 +65,17 @@ export interface Spec extends TurboModule {
      * at cold start, BEFORE JS loads.
      */
     revertToPrevious(): Promise<boolean>;
+    /**
+     * Restart the React Native runtime so the applied bundle loads NOW.
+     *
+     * Exists because `DevSettings.reload()` is a silent no-op in RELEASE builds
+     * (verified live: "Triggering app restart…" logged, nothing happened, same
+     * process, old bundle still running). That made IMMEDIATE / ON_NEXT_RESUME /
+     * `autoRestart` / the CodePush shim's restart all fiction in production.
+     * Android: `ReactHost.reload()` (bridgeless) or
+     * `recreateReactContextInBackground()` (bridge). iOS: RCTReloadCommand.
+     */
+    restartApp(): void;
 }
 /**
  * Resolved via `get` (not `getEnforcing`) so the SDK degrades gracefully when

package/lib/typescript/specs/NativeScaleBunOta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeScaleBunOta.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeScaleBunOta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;OAIG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;OAKG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB;;;OAGG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElE;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5F;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;;;OAIG;IACH,WAAW,IAAI,IAAI,CAAC;IAEpB;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;GAMG;;AACH,wBAA4D"}
+{"version":3,"file":"NativeScaleBunOta.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeScaleBunOta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;OAIG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;OAKG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB;;;OAGG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElE;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5F;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;;;OAIG;IACH,WAAW,IAAI,IAAI,CAAC;IAEpB;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC;;;;;;;;;OASG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;;;;;GAMG;;AACH,wBAA4D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalebun/react-native",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Production-grade React Native SDK for ScaleBun",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -82,8 +82,8 @@
     "typescript": "^5.4.5"
   },
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*",
+    "react": ">=18.0.0",
+    "react-native": ">=0.74.0",
     "react-native-view-shot": ">=3.0.0",
     "@notifee/react-native": ">=5.0.0",
     "expo-router": ">=1.0.0"

package/src/bootstrap/SDKBootstrapper.ts

@@ -484,6 +484,30 @@ export class SDKBootstrapper {
             });
             detector.start();
             logger.info('[Bootstrap] Auto screen detection started');
+
+            /**
+             * Screen detection that never resolves anything must SAY so.
+             *
+             * Wrapping React Navigation only helps a container that mounts afterwards, so an app that
+             * initialises the SDK late still ends up with no screen names — and until now that was
+             * indistinguishable from working. Everything downstream inherits the silence: no
+             * SCREEN_VIEW events, so every session's screens read "Unknown"; and no `screenName` on
+             * taps, which is the column heatmaps group by, so every route collapses into one bucket.
+             *
+             * One warning, once, naming the fix.
+             */
+            let sawScreen = false;
+            detector.onScreenChange(() => { sawScreen = true; });
+            const warnTimer = setTimeout(() => {
+                if (sawScreen) return;
+                logger.warn(
+                    '[ScaleBun] No screen has been detected. Screens will show as "Unknown" and heatmaps ' +
+                    'cannot be split by route. If you use React Navigation, pass your container ref to ' +
+                    'ScaleBun.setNavigationRef(ref); otherwise mark screens with <ScaleBunScreen name="…">.',
+                );
+            }, 15_000);
+            // Never hold the JS timer queue open on a background/exiting app.
+            (warnTimer as unknown as { unref?: () => void }).unref?.();
         } catch (err: any) {
             logger.warn('[Bootstrap] Failed to start AutoScreenDetector:', err?.message);
         }

package/src/features/crash/CrashFeature.ts

@@ -11,6 +11,7 @@
 
 import type { IFeature, FeatureContext } from '../../core/contracts/IFeature';
 import { installCrashReporting } from './index';
+import { installRejectionHandler } from './rejectionHandler';
 import { getCrashReporter } from './CrashReporter';
 
 export class CrashFeature implements IFeature {
@@ -38,6 +39,24 @@ export class CrashFeature implements IFeature {
                 this.flushFn();
             }
         });
+
+        /**
+         * Unhandled promise rejections — a SEPARATE intake from ErrorUtils, which never sees them.
+         *
+         * Never fatal: a rejected promise does not stop the app, so it is reported as 'handled' and
+         * does not flush. Marking these fatal would inflate the crash count with errors the user
+         * never experienced as a crash.
+         */
+        installRejectionHandler((error: Error) => {
+            getCrashReporter().report({
+                source: 'js',
+                type: 'handled',
+                isFatal: false,
+                message: error.message,
+                stack: error.stack,
+            });
+        });
+
         this.active = true;
     }
 

package/src/features/crash/rejectionHandler.ts

@@ -0,0 +1,134 @@
+import { noThrow } from '../../core/lifecycle/crashSafe';
+import { logger } from '../../core/logger/internalLogger';
+
+/**
+ * Capture UNHANDLED PROMISE REJECTIONS.
+ *
+ * THE GAP THIS CLOSES
+ * `ErrorUtils.setGlobalHandler` (see ./globalHandler) catches uncaught *throws* and nothing else. A
+ * rejected promise with no `.catch()` does not pass through it — React Native routes those to its own
+ * rejection tracker, which prints a LogBox warning in development and does nothing whatsoever in
+ * production. So `await doThing()` with no catch was reported by the WEB SDK (which listens for
+ * `unhandledrejection`) and silently lost on mobile. Same product, same mistake in the host's code,
+ * one platform reporting it — the cross-SDK asymmetry CLAUDE.md §2 exists to catch.
+ *
+ * WHY `require`, GUARDED, AND NOT AN IMPORT
+ * `promise/setimmediate/rejection-tracking` is React Native's own tracker: it arrives with
+ * react-native in any real app, and adding it to this package's dependencies would put a third-party
+ * runtime dep into the SDK for something the platform already ships. It is therefore resolved at
+ * runtime and treated as optional — the same shape as `globalHandler`'s `ErrorUtils` feature-detect,
+ * for the same reason. When it cannot be resolved this logs once and no-ops; nothing throws.
+ *
+ * ⚠️ `enable()` REPLACES the current handlers — it does not chain, and the module exposes no way to
+ * read the previous ones. Calling it therefore takes over from React Native's own dev-mode warning,
+ * so this re-emits that warning itself under `__DEV__`. Without it, installing the SDK would make
+ * unhandled rejections *quieter* in development than they were before, which is a poor trade for
+ * catching them in production.
+ */
+
+/** The slice of `promise/setimmediate/rejection-tracking` this uses. */
+export interface RejectionTracker {
+    enable(options: {
+        allRejections: boolean;
+        onUnhandled: (id: number, error: unknown) => void;
+        onHandled: (id: number) => void;
+    }): void;
+}
+
+/** Default resolver — optional at runtime, never a build-time dependency. */
+function defaultResolveTracker(): RejectionTracker | null {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require('promise/setimmediate/rejection-tracking') as RejectionTracker;
+    } catch {
+        return null;
+    }
+}
+
+/** Anything can be rejected — `throw 'a string'` is legal. Normalise without inventing a stack. */
+function toError(value: unknown): Error {
+    if (value instanceof Error) return value;
+    if (typeof value === 'string') return new Error(value);
+    try {
+        return new Error(`Non-Error rejection: ${JSON.stringify(value)}`);
+    } catch {
+        return new Error('Non-Error rejection');
+    }
+}
+
+/**
+ * Install the unhandled-rejection handler.
+ *
+ * @returns true when the tracker was available and handlers were installed.
+ */
+export function installRejectionHandler(
+    onRejection: (error: Error) => void,
+    deps?: { resolveTracker?: () => RejectionTracker | null; isDev?: boolean },
+): boolean {
+    return (
+        noThrow(() => {
+            const tracker = (deps?.resolveTracker ?? defaultResolveTracker)();
+            if (!tracker || typeof tracker.enable !== 'function') {
+                logger.debug(
+                    '[Crash] promise rejection tracking unavailable — unhandled rejections not captured',
+                );
+                return false;
+            }
+
+            const isDev = deps?.isDev ?? (typeof __DEV__ !== 'undefined' && __DEV__);
+
+            tracker.enable({
+                /**
+                 * `allRejections: true` reports a rejection that is still unhandled when the tracker's
+                 * grace period elapses. `onHandled` below is the other half: a promise caught LATE —
+                 * a very common pattern, e.g. attaching `.catch()` after an `await` chain — fires
+                 * `onUnhandled` first and `onHandled` afterwards. Reporting on the first and saying
+                 * nothing on the second would file a crash for code that handled its own error.
+                 */
+                allRejections: true,
+                onUnhandled: (id: number, error: unknown) => {
+                    const err = toError(error);
+                    pending.set(id, err);
+                    onRejection(err);
+                    if (isDev) {
+                        // Re-emit what RN's own tracker would have said, since enable() displaced it.
+                        // eslint-disable-next-line no-console
+                        console.warn(`Possible unhandled promise rejection (id: ${id}):`, err?.message ?? err);
+                    }
+                },
+                onHandled: (id: number) => {
+                    pending.delete(id);
+                    if (isDev) {
+                        // eslint-disable-next-line no-console
+                        console.warn(
+                            `Promise rejection handled late (id: ${id}) — it was already reported.`,
+                        );
+                    }
+                },
+            });
+
+            logger.debug('Unhandled promise rejection handler installed');
+            return true;
+        }) ?? false
+    );
+}
+
+/**
+ * Rejections reported but not yet seen handled.
+ *
+ * Deliberately NOT used to suppress the report — by the time `onUnhandled` fires the rejection has
+ * already gone unhandled for the tracker's whole grace period, and holding it back on the chance
+ * that a late `.catch()` arrives would mean losing genuine production errors to a guess. This exists
+ * so `onHandled` has somewhere to clear from, and so a test can observe the pairing.
+ */
+const pending = new Map<number, Error>();
+
+/** Test seam — number of reported-and-not-yet-handled rejections. */
+export function __pendingRejectionCount(): number {
+    return pending.size;
+}
+
+/** Test seam — clear state between cases. */
+export function __resetRejectionsForTests(): void {
+    pending.clear();
+}

package/src/features/engage/EngagePromptProvider.tsx

@@ -800,7 +800,9 @@ export function EngagePromptProvider({
                     engage.flushEvents?.();
                     logger.debug(`[Engage] test ${runId} ${eventType} persisted + ACK flushed`);
                 } else {
-                    storeRef.current?.markCompleted(current.id);
+                    // Stamp the SERVED revision: without it the completion can never be invalidated,
+                    // and an edited campaign would never return to a device that closed the old one.
+                    storeRef.current?.markCompleted(current.id, Date.now(), current.revision);
                     engage.flushEvents?.();
                     logger.debug(`[Engage] in-app ${current.id} ${eventType} — marked done on device`);
                 }
@@ -854,7 +856,7 @@ export function EngagePromptProvider({
                 logger.debug(`[Engage] test ${runId} CTA — persisted locally + ACK flushed`);
             } else {
                 // Production message: a CTA tap is as final as a close — don't re-show it.
-                storeRef.current?.markCompleted(message.id);
+                storeRef.current?.markCompleted(message.id, Date.now(), message.revision);
                 engage.flushEvents?.();
                 logger.debug(`[Engage] in-app ${message.id} CTA tapped — marked done on device`);
             }