@fixback/expo 0.9.0 → 0.9.1

package/dist/adapters.js

@@ -167,12 +167,13 @@ function createNativeAdapters() {
         captureScreenshot,
         releaseScreenshot,
         // Session replay (ADR-0044): frame capture through the same view-shot module, and
-        // the encode through our own Expo module. `encodeSegment` resolves `null` when no
-        // native encoder is linked (Expo Go, or a build that never ran `expo prebuild`),
-        // so the SDK degrades to "no replay" rather than failing a report.
+        // the encode through our own Expo module — handed over only when its native half is
+        // linked. In Expo Go, or a build that never ran `expo prebuild`, there is none, so
+        // the client records no frames it could never encode, says why in a development
+        // build, and reports without replay (#661).
         captureReplayFrame,
         releaseReplayFrame: releaseScreenshot,
-        encodeReplaySegment: expo_replay_encoder_1.encodeSegment,
+        encodeReplaySegment: expo_replay_encoder_1.isEncoderAvailable ? expo_replay_encoder_1.encodeSegment : undefined,
         consoleObj: (0, breadcrumbs_1.globalConsole)() ?? null,
         xhr: (0, breadcrumbs_1.globalXhr)() ?? null,
         errorUtils: (0, error_capture_1.globalErrorUtils)() ?? null,

package/dist/adapters.js.map

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

package/dist/breadcrumbs.d.ts

@@ -2,12 +2,12 @@
  * The Expo SDK's **React Native capture instrumentation** — the runtime seams, and
  * nothing else.
  *
- * The trace buffer, the crumb builders, the caps and eviction rules, and the
- * `console` wrapper are all shared with the browser SDK through
+ * The trace buffer, the crumb builders, the caps and eviction rules, the `console`
+ * wrapper, and the `XMLHttpRequest` patch are all shared with the browser SDK through
  * `@fixback/sdk-core` (ADR-0028, replacing the file-parallel port ADR-0021
  * described), so the server and dashboard cannot tell a mobile trace from a web one.
- * What is left here is genuinely mobile: how to find React Native's globals, and
- * the `XMLHttpRequest` patch.
+ * What is left here is genuinely mobile: how to find React Native's globals, and how
+ * the shared XHR patch is bound to them.
  *
  * Mobile mappings (spec 0004 §D): network capture patches `XMLHttpRequest` **only**
  * — React Native's `fetch` is a polyfill over XHR, so wrapping both would
@@ -16,60 +16,24 @@
  * yet and simply never occur.
  *
  * Everything private is kept out at the source: network crumbs carry method + URL +
- * status metadata only, **never** bodies, and URLs are scrubbed as the crumb is
- * built. The one header the patch touches is the one it mints — the **Correlation
- * id**'s W3C `traceparent` (grill 2026-09-24 D2; #540), sent only to the origins the
- * app lists in `propagateTo` (`./propagation`) — and no header value is ever read.
+ * status metadata only, **never** bodies (the web-only body opt-in is never passed
+ * here), and URLs are scrubbed as the crumb is built. The one header the patch touches
+ * is the one it mints — the **Correlation id**'s W3C `traceparent` (grill 2026-09-24
+ * D2; #540), sent only to the origins the app lists in `propagateTo` (`./propagation`)
+ * — and no header value is ever read. The patch carries it under React Native's
+ * `"per-request"` rule: the app's header always wins — one set before `send` means
+ * Fixback adds none, and one set after ours (a `send` wrapper installed before
+ * Fixback's) replaces it, because React Native's XHR sends the last value a header was
+ * given — so the crumb then records no id rather than one the request did not carry.
  * The SDK must never throw into the host app, so every hook is wrapped: a capture
  * failure is swallowed and the original behaviour always runs.
  */
-import { type BreadcrumbBuffer, type BreadcrumbLevel, type ConsoleLike, type Teardown } from "@fixback/sdk-core";
-import { type PropagationFilter } from "./propagation";
-export type { ConsoleLike, Teardown };
+import { type BreadcrumbBuffer, type BreadcrumbLevel, type ConsoleLike, type Teardown, type XhrConstructor, type XhrInstance } from "@fixback/sdk-core";
+export type { ConsoleLike, Teardown, XhrConstructor, XhrInstance };
 /** React Native's global `console`, when present. */
 export declare function globalConsole(): ConsoleLike | undefined;
-/** The XHR instance surface the network instrumentation touches. */
-export interface XhrInstance {
-    status: number;
-    statusText?: string;
-    open(method: string, url: string | {
-        toString(): string;
-    }, ...rest: unknown[]): void;
-    send(body?: unknown): void;
-    /** How the Correlation id's `traceparent` goes on. Absent ⇒ no header and no id. */
-    setRequestHeader?(name: string, value: string): void;
-    getResponseHeader?(name: string): string | null;
-    addEventListener(type: string, listener: () => void): void;
-    removeEventListener(type: string, listener: () => void): void;
-}
-/** The XHR constructor whose prototype is patched — injectable for tests. */
-export interface XhrConstructor {
-    new (): XhrInstance;
-    prototype: XhrInstance;
-}
 /** React Native's global `XMLHttpRequest`, when present. */
 export declare function globalXhr(): XhrConstructor | undefined;
-/**
- * Patch `XMLHttpRequest` to record a rich network crumb when a request settles.
- * On React Native this is the **single** network hook: the built-in `fetch` is
- * a polyfill over XHR, so its traffic is captured here too (as `xhr` crumbs)
- * and `fetch` itself is deliberately not wrapped — wrapping both would record
- * every request twice (spec 0004 §D). The `send` body argument is **never read
- * for content** — only its trivially-known size.
- *
- * It also carries the **Correlation id** (grill 2026-09-24 D2; #540), so one patch
- * covers `fetch` too: on `send`, a request whose origin the app listed in
- * `propagateTo` (`./propagation`; nothing by default) gets a freshly minted W3C
- * `traceparent` through the original `setRequestHeader`, and its crumb records the
- * trace id as `requestId`. The patched `setRequestHeader` notes only a header's
- * **name** — whether the app set its own `traceparent` — never a value, and the app's
- * header always wins: one set before `send` means Fixback adds none, and one set after
- * ours (a `send` wrapper installed before Fixback's) replaces it, because React
- * Native's XHR sends the last value a header was given — so the crumb then records no
- * id rather than one the request did not carry. A `setRequestHeader` that is missing
- * or throws degrades to "no header, no id", and the original `send` always runs.
- */
-export declare function instrumentXhr(buffer: BreadcrumbBuffer, ctor: XhrConstructor | undefined, ignoreUrl: (url: string) => boolean, now: () => number, mono?: () => number, propagate?: PropagationFilter): Teardown;
 /** Options for {@link instrumentBreadcrumbs}. */
 export interface InstrumentOptions {
     readonly consoleObj?: ConsoleLike | null;

package/dist/breadcrumbs.js

@@ -3,12 +3,12 @@
  * The Expo SDK's **React Native capture instrumentation** — the runtime seams, and
  * nothing else.
  *
- * The trace buffer, the crumb builders, the caps and eviction rules, and the
- * `console` wrapper are all shared with the browser SDK through
+ * The trace buffer, the crumb builders, the caps and eviction rules, the `console`
+ * wrapper, and the `XMLHttpRequest` patch are all shared with the browser SDK through
  * `@fixback/sdk-core` (ADR-0028, replacing the file-parallel port ADR-0021
  * described), so the server and dashboard cannot tell a mobile trace from a web one.
- * What is left here is genuinely mobile: how to find React Native's globals, and
- * the `XMLHttpRequest` patch.
+ * What is left here is genuinely mobile: how to find React Native's globals, and how
+ * the shared XHR patch is bound to them.
  *
  * Mobile mappings (spec 0004 §D): network capture patches `XMLHttpRequest` **only**
  * — React Native's `fetch` is a polyfill over XHR, so wrapping both would
@@ -17,23 +17,24 @@
  * yet and simply never occur.
  *
  * Everything private is kept out at the source: network crumbs carry method + URL +
- * status metadata only, **never** bodies, and URLs are scrubbed as the crumb is
- * built. The one header the patch touches is the one it mints — the **Correlation
- * id**'s W3C `traceparent` (grill 2026-09-24 D2; #540), sent only to the origins the
- * app lists in `propagateTo` (`./propagation`) — and no header value is ever read.
+ * status metadata only, **never** bodies (the web-only body opt-in is never passed
+ * here), and URLs are scrubbed as the crumb is built. The one header the patch touches
+ * is the one it mints — the **Correlation id**'s W3C `traceparent` (grill 2026-09-24
+ * D2; #540), sent only to the origins the app lists in `propagateTo` (`./propagation`)
+ * — and no header value is ever read. The patch carries it under React Native's
+ * `"per-request"` rule: the app's header always wins — one set before `send` means
+ * Fixback adds none, and one set after ours (a `send` wrapper installed before
+ * Fixback's) replaces it, because React Native's XHR sends the last value a header was
+ * given — so the crumb then records no id rather than one the request did not carry.
  * The SDK must never throw into the host app, so every hook is wrapped: a capture
  * failure is swallowed and the original behaviour always runs.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.globalConsole = globalConsole;
 exports.globalXhr = globalXhr;
-exports.instrumentXhr = instrumentXhr;
 exports.instrumentBreadcrumbs = instrumentBreadcrumbs;
 const sdk_core_1 = require("@fixback/sdk-core");
 const propagation_1 = require("./propagation");
-function noop() {
-    /* nothing installed */
-}
 /** React Native's global `console`, when present. */
 function globalConsole() {
     const g = globalThis;
@@ -44,162 +45,6 @@ function globalXhr() {
     const g = globalThis;
     return typeof g.XMLHttpRequest === "function" ? g.XMLHttpRequest : undefined;
 }
-/** Read one XHR response header defensively — `null` when unavailable or on any throw. */
-function safeXhrHeader(xhr, name) {
-    try {
-        return typeof xhr.getResponseHeader === "function"
-            ? xhr.getResponseHeader(name)
-            : null;
-    }
-    catch {
-        return null;
-    }
-}
-/** Read an XHR's `statusText` defensively — `undefined` when empty or on any throw. */
-function safeXhrStatusText(xhr) {
-    try {
-        return xhr.statusText || undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Patch `XMLHttpRequest` to record a rich network crumb when a request settles.
- * On React Native this is the **single** network hook: the built-in `fetch` is
- * a polyfill over XHR, so its traffic is captured here too (as `xhr` crumbs)
- * and `fetch` itself is deliberately not wrapped — wrapping both would record
- * every request twice (spec 0004 §D). The `send` body argument is **never read
- * for content** — only its trivially-known size.
- *
- * It also carries the **Correlation id** (grill 2026-09-24 D2; #540), so one patch
- * covers `fetch` too: on `send`, a request whose origin the app listed in
- * `propagateTo` (`./propagation`; nothing by default) gets a freshly minted W3C
- * `traceparent` through the original `setRequestHeader`, and its crumb records the
- * trace id as `requestId`. The patched `setRequestHeader` notes only a header's
- * **name** — whether the app set its own `traceparent` — never a value, and the app's
- * header always wins: one set before `send` means Fixback adds none, and one set after
- * ours (a `send` wrapper installed before Fixback's) replaces it, because React
- * Native's XHR sends the last value a header was given — so the crumb then records no
- * id rather than one the request did not carry. A `setRequestHeader` that is missing
- * or throws degrades to "no header, no id", and the original `send` always runs.
- */
-function instrumentXhr(buffer, ctor, ignoreUrl, now, mono = sdk_core_1.nowMono, 
-// Which requests carry the Correlation id: the origins the app listed in
-// `propagateTo`, threaded in by the composite — nothing by default.
-propagate = (0, propagation_1.createPropagationFilter)()) {
-    if (typeof ctor !== "function")
-        return noop;
-    const proto = ctor.prototype;
-    const originalOpen = proto.open;
-    const originalSend = proto.send;
-    const originalSetRequestHeader = proto.setRequestHeader;
-    const canSetHeader = typeof originalSetRequestHeader === "function";
-    proto.open = function (method, url, ...rest) {
-        // A new request: nothing the app set on an earlier one, and no id yet.
-        this.__fixbackMeta = {
-            method: String(method).toUpperCase(),
-            url: String(url),
-            appTraceparent: false,
-        };
-        return originalOpen.call(this, method, url, ...rest);
-    };
-    if (canSetHeader) {
-        proto.setRequestHeader = function (name, value) {
-            try {
-                const meta = this.__fixbackMeta;
-                if (meta && (0, sdk_core_1.isTraceparentHeader)(name))
-                    meta.appTraceparent = true;
-            }
-            catch {
-                /* noting a header name must never break the app's own call */
-            }
-            return originalSetRequestHeader.call(this, name, value);
-        };
-    }
-    /**
-     * Put a freshly minted `traceparent` on a request about to be sent, remembering the
-     * Correlation id its crumb records — unless the request is not one to propagate to,
-     * the app set its own, this request already carries ours (a repeated `send`), or
-     * setting it throws. Calls the original `setRequestHeader`, so Fixback's own header is
-     * never mistaken for the app's.
-     */
-    const stampCorrelationId = (xhr, meta) => {
-        if (!canSetHeader || meta.appTraceparent || meta.correlationId !== undefined)
-            return;
-        try {
-            if (!propagate(meta.url))
-                return;
-            const minted = (0, sdk_core_1.mintTraceparent)();
-            originalSetRequestHeader.call(xhr, sdk_core_1.TRACEPARENT_HEADER, minted.header);
-            meta.correlationId = minted.correlationId;
-        }
-        catch {
-            /* no header, no id — and the request still goes out */
-        }
-    };
-    proto.send = function (body) {
-        const meta = this.__fixbackMeta;
-        if (meta && !ignoreUrl(meta.url)) {
-            stampCorrelationId(this, meta);
-            const started = mono();
-            const reqSize = (0, sdk_core_1.trivialBodySize)(body);
-            // The terminal event names the outcome; `loadend` always follows exactly
-            // one of load/error/timeout/abort, so by record time `settled` is set.
-            let settled;
-            const onLoad = () => {
-                settled = (0, sdk_core_1.outcomeFromStatus)(this.status || undefined);
-            };
-            const onError = () => {
-                settled = "network-error";
-            };
-            const onTimeout = () => {
-                settled = "timeout";
-            };
-            const onAbort = () => {
-                settled = "aborted";
-            };
-            const onDone = () => {
-                try {
-                    buffer.add((0, sdk_core_1.networkCrumb)({
-                        api: "xhr",
-                        method: meta.method,
-                        url: meta.url,
-                        status: this.status || undefined,
-                        statusText: safeXhrStatusText(this),
-                        durationMs: Math.max(0, mono() - started),
-                        reqSize,
-                        respSize: (0, sdk_core_1.parseContentLength)(safeXhrHeader(this, "content-length")),
-                        contentType: (0, sdk_core_1.contentTypeOf)(safeXhrHeader(this, "content-type")),
-                        outcome: settled ?? (0, sdk_core_1.outcomeFromStatus)(this.status || undefined),
-                        // Read at settle time: an app header set after ours replaced it.
-                        requestId: meta.appTraceparent ? undefined : meta.correlationId,
-                    }, now()));
-                }
-                catch {
-                    /* never throw into the host app */
-                }
-                this.removeEventListener("load", onLoad);
-                this.removeEventListener("error", onError);
-                this.removeEventListener("timeout", onTimeout);
-                this.removeEventListener("abort", onAbort);
-                this.removeEventListener("loadend", onDone);
-            };
-            this.addEventListener("load", onLoad);
-            this.addEventListener("error", onError);
-            this.addEventListener("timeout", onTimeout);
-            this.addEventListener("abort", onAbort);
-            this.addEventListener("loadend", onDone);
-        }
-        return originalSend.call(this, body);
-    };
-    return () => {
-        proto.open = originalOpen;
-        proto.send = originalSend;
-        if (canSetHeader)
-            proto.setRequestHeader = originalSetRequestHeader;
-    };
-}
 /**
  * Install the React Native capture hooks — the shared console wrapper and the XHR
  * patch — and return a single teardown that removes them all. Each hook is
@@ -220,7 +65,15 @@ function instrumentBreadcrumbs(buffer, options = {}) {
         teardowns.push((0, sdk_core_1.instrumentConsole)(buffer, consoleObj, levels, now));
     }
     if (captureNetwork) {
-        teardowns.push(instrumentXhr(buffer, xhr, ignoreUrl, now, mono, (0, propagation_1.createPropagationFilter)(options.propagateTo)));
+        teardowns.push((0, sdk_core_1.instrumentXhr)(buffer, xhr, {
+            ignoreUrl,
+            now,
+            mono,
+            // Which requests carry the Correlation id: the origins the app listed in
+            // `propagateTo` — nothing by default — under React Native's rule (see above).
+            propagate: (0, propagation_1.createPropagationFilter)(options.propagateTo),
+            correlation: "per-request",
+        }));
     }
     return () => {
         for (const teardown of teardowns) {

package/dist/breadcrumbs.js.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;AAoBH,sCAGC;AAGD,8BAGC;AA8BD,sDAyCC;AAlGD,gDAW2B;AAE3B,+CAAwD;AAIxD,qDAAqD;AACrD,SAAgB,aAAa;IAC3B,MAAM,CAAC,GAAG,UAAuC,CAAC;IAClD,OAAO,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED,4DAA4D;AAC5D,SAAgB,SAAS;IACvB,MAAM,CAAC,GAAG,UAAiD,CAAC;IAC5D,OAAO,OAAO,CAAC,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC;AAwBD;;;;;GAKG;AACH,SAAgB,qBAAqB,CACnC,MAAwB,EACxB,UAA6B,EAAE;IAE/B,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,aAAa,EAAE,CAAC;IAClF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,iCAAsB,CAAC;IAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,kBAAO,CAAC;IACrC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC;IACxD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC;IAExD,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;QACjC,SAAS,CAAC,IAAI,CAAC,IAAA,4BAAiB,EAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,cAAc,EAAE,CAAC;QACnB,SAAS,CAAC,IAAI,CACZ,IAAA,wBAAa,EAAC,MAAM,EAAE,GAAG,EAAE;YACzB,SAAS;YACT,GAAG;YACH,IAAI;YACJ,yEAAyE;YACzE,8EAA8E;YAC9E,SAAS,EAAE,IAAA,qCAAuB,EAAC,OAAO,CAAC,WAAW,CAAC;YACvD,WAAW,EAAE,aAAa;SAC3B,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/client-boot.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Boot, and the capture its answer arms (spec 0003 §G ported to mobile, spec 0004).
+ *
+ * {@link Boot.bootAndArm} is the round trip `start`, `signIn` and `signOut` all end in:
+ * it swaps in the refreshed Reporter session, records the Account and tier for the
+ * identity row, raises or lowers maintenance mode's notice (and schedules its
+ * recheck), and arms capture only while a submission would be accepted — the trace
+ * hooks, mobile replay (`./client-replay`), and automatic error capture — or says why
+ * the SDK is dormant.
+ *
+ * One piece of the headless client (`./client`), created over the state every piece
+ * shares (`./client-state`).
+ */
+import { type CaptureConfig, type MaintenanceNotice } from "@fixback/sdk-core";
+import type { ReplayArming } from "./client-replay";
+import { type ClientState } from "./client-state";
+/** The per-stream trace flags capture is armed with. */
+export interface TraceStreams {
+    readonly console: boolean;
+    readonly network: boolean;
+}
+/** Boot and capture arming, as {@link createBoot} builds them. */
+export interface Boot {
+    /** Boot with the current identity and reconcile capture + the identity row. */
+    bootAndArm(gen: number, options?: {
+        readonly recheck?: boolean;
+    }): Promise<void>;
+    /** The effective per-stream capture flags for a served config (or none yet). */
+    resolveStreams(served: CaptureConfig | undefined): TraceStreams;
+    /** Install the trace instrumentation for the given flags, replacing what is installed. */
+    armTrace(streams: TraceStreams): void;
+    /** Tear down the trace, replay and auto-capture hooks (best-effort). */
+    disarmCapture(): void;
+    /** Raise, change or lower maintenance mode's notice, telling its listeners. */
+    setMaintenance(next: MaintenanceNotice | null): void;
+    /** Cancel the pending maintenance recheck, if any. */
+    clearMaintenanceRecheck(): void;
+}
+/** Boot and capture arming over the client's shared state, with replay's arming. */
+export declare function createBoot(s: ClientState, replay: ReplayArming): Boot;