@fixback/expo 0.8.3 → 0.9.1

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;

package/dist/client-boot.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * 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`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBoot = createBoot;
+const sdk_core_1 = require("@fixback/sdk-core");
+const breadcrumbs_1 = require("./breadcrumbs");
+const client_connect_1 = require("./client-connect");
+const client_state_1 = require("./client-state");
+const error_capture_1 = require("./error-capture");
+const reporter_session_store_1 = require("./reporter-session-store");
+const submit_1 = require("./submit");
+const version_1 = require("./version");
+/** Boot and capture arming over the client's shared state, with replay's arming. */
+function createBoot(s, replay) {
+    const { options, adapters, warn, now, readEnvironment } = s;
+    const { key, origin, apiUrl, release, propagateTo, buffer } = s;
+    const { armReplay, disarmReplay, freezeAndEncodeReplay } = replay;
+    function setMaintenance(next) {
+        const changed = (s.maintenance === null) !== (next === null) ||
+            s.maintenance?.message !== next?.message ||
+            s.maintenance?.until !== next?.until;
+        s.maintenance = next;
+        if (next !== null)
+            scheduleMaintenanceRecheck();
+        if (!changed)
+            return;
+        for (const listener of s.maintenanceListeners) {
+            try {
+                listener(next);
+            }
+            catch {
+                /* a listener must never break the client */
+            }
+        }
+    }
+    /** Ask boot again in a minute, once, so the notice comes down on its own (the maintenance-mode ADR). */
+    function scheduleMaintenanceRecheck() {
+        if (!s.running)
+            return;
+        const gen = s.generation;
+        s.maintenanceRecheck.schedule(() => {
+            if (gen === s.generation)
+                void bootAndArm(gen, { recheck: true }).catch(() => undefined);
+        });
+    }
+    function clearMaintenanceRecheck() {
+        s.maintenanceRecheck.cancel();
+    }
+    /** Tear down the trace hooks (best-effort), so they can be re-armed. */
+    function disarmTrace() {
+        try {
+            s.teardownTrace?.();
+        }
+        catch {
+            /* teardown is best-effort */
+        }
+        s.teardownTrace = null;
+    }
+    /** Tear down the trace + auto-capture hooks (best-effort), so they can be re-armed. */
+    function disarmCapture() {
+        disarmTrace();
+        disarmReplay();
+        try {
+            s.autoCapture?.destroy();
+        }
+        catch {
+            /* teardown is best-effort */
+        }
+        s.autoCapture = null;
+    }
+    /**
+     * The effective per-stream capture flags: an init option overrides the served
+     * config, and an absent (or malformed) served value means **on** — the default-on
+     * rule (spec 0003 §C, ported). Called with no answer before boot has one, which is
+     * how the pre-boot arming lands on "both streams on".
+     */
+    function resolveStreams(served) {
+        return {
+            console: (0, sdk_core_1.streamEnabled)(options.capture?.console, served?.console),
+            network: (0, sdk_core_1.streamEnabled)(options.capture?.network, served?.network),
+        };
+    }
+    /**
+     * Install the trace instrumentation for the given per-stream flags, replacing
+     * whatever is installed — the teardown runs first, so a re-arm can never double-wrap
+     * `console` or `XMLHttpRequest`.
+     */
+    function armTrace(streams) {
+        disarmTrace();
+        s.teardownTrace = (0, breadcrumbs_1.instrumentBreadcrumbs)(buffer, {
+            consoleObj: adapters.consoleObj,
+            xhr: adapters.xhr,
+            ignoreUrl: (url) => (0, sdk_core_1.isFixbackApiRequest)(apiUrl, url),
+            now,
+            captureConsole: streams.console,
+            captureNetwork: streams.network,
+            propagateTo,
+        });
+    }
+    /**
+     * Boot with the current identity and reconcile capture + the identity row. Shared by
+     * `start`, `signIn`, and `signOut`: it swaps in the refreshed Reporter session token
+     * (30-day sliding), records the Account / tier / connect URL the boot answer carries,
+     * and arms capture only while a submission would be accepted — so a gated Project's
+     * shake gesture arms exactly when the Account becomes eligible, and drops when it signs
+     * out. `gen` is the caller's lifecycle generation; every await re-checks it so a
+     * destroyed (or restarted) client abandons this in-flight boot.
+     */
+    async function bootAndArm(gen, { recheck = false } = {}) {
+        // Boots are last-one-wins. Two can be in flight at once — a deep link redeemed
+        // while `start`'s boot is still out, a `signOut` racing a Connect — and they carry
+        // *different* identities, so an older answer landing last would undo a newer one:
+        // the shake gesture would stay withheld from a Reporter the server had just
+        // accepted, with the session sitting unused in SecureStore until the next launch.
+        const seq = ++s.bootSequence;
+        let failure = null;
+        const answer = await (0, sdk_core_1.requestBoot)(apiUrl, { key, ...(0, sdk_core_1.compactIdentity)(s.identity) }, {
+            fetch: adapters.fetch,
+            origin,
+            onFailure: (reason) => {
+                failure = reason;
+            },
+        });
+        if (gen !== s.generation || seq !== s.bootSequence)
+            return;
+        // Mid-maintenance, an unanswered boot is Fixback restarting, not a reason to disarm:
+        // keep the notice up and ask again (the maintenance-mode ADR).
+        if (!answer && s.maintenance !== null && s.status === "ready") {
+            scheduleMaintenanceRecheck();
+            return;
+        }
+        s.boot = answer;
+        // What the answer settles, read the way every capture SDK reads it (`reconcileBoot`).
+        const settled = (0, sdk_core_1.reconcileBoot)(answer);
+        // Swap in the refreshed session token (30-day sliding) when boot returned one.
+        if (settled.reporterSession) {
+            s.reporterSessionToken = settled.reporterSession;
+            s.identity = { ...s.identity, reporterSession: s.reporterSessionToken };
+            await (0, reporter_session_store_1.writeReporterSession)(adapters.secureStore, key, s.reporterSessionToken);
+            if (gen !== s.generation || seq !== s.bootSequence)
+                return;
+        }
+        s.currentTier = settled.tier;
+        s.account = settled.account;
+        s.connectUrl = settled.connectUrl;
+        (0, client_state_1.notifyIdentity)(s);
+        // Maintenance mode's notice (the maintenance-mode ADR) — sent only to a caller who could
+        // otherwise report, so it arms the composer as a yes does: it opens onto the notice.
+        const notice = settled.maintenance;
+        // A maintenance recheck on a client already armed changes only the notice: re-arming would
+        // restart the replay recorder every minute and drop the lead-up the next report should carry.
+        if (recheck && s.status === "ready" && settled.arm) {
+            setMaintenance(notice);
+            return;
+        }
+        if (answer && settled.arm) {
+            // Re-arm from a clean slate (the shared trace buffer persists across a re-arm, so
+            // no lead-up is lost) — a Connect that just made the Account eligible arms here.
+            disarmCapture();
+            armCapture(answer);
+            s.lastDormancyWarning = null;
+            setMaintenance(notice);
+            (0, client_state_1.setStatus)(s, "ready");
+        }
+        else {
+            setMaintenance(null);
+            // Say why, once per dormant boot, in a development build (`warn` is silent in
+            // production). A dormant SDK is otherwise indistinguishable on the device from
+            // one that was never installed — and the reason is right here in the answer the
+            // client already holds, or in the failure that stopped one arriving.
+            warnDormant(answer, failure);
+            // Not eligible (a gated Project the Account cannot yet report on, or a signed-out
+            // visitor): nothing armed, but `connectUrl` is retained so `signIn` still works.
+            // What the pre-boot arming optimistically recorded is dropped with it — this
+            // Account cannot submit, so holding its console and network lead-up in memory
+            // serves nothing. A later `signIn` re-arms and starts a fresh lead-up.
+            disarmCapture();
+            buffer.clear();
+            (0, client_state_1.setStatus)(s, "disabled");
+        }
+    }
+    /** Explain a dormant boot to the developer, at most once per distinct reason. */
+    function warnDormant(answer, failure) {
+        const message = (0, sdk_core_1.explainDormancy)({
+            answer,
+            failure,
+            apiUrl,
+            origin: origin || undefined,
+            // Connect needs a door this app can actually open — an auth session it can
+            // return through, or an in-app browser plus the seam the redirect comes back
+            // on. With neither, naming `signIn()` would send the developer down a dead end.
+            signInCall: (0, client_connect_1.canSignIn)(s) ? "Fixback.signIn()" : undefined,
+        });
+        if (!message || message === s.lastDormancyWarning)
+            return;
+        s.lastDormancyWarning = message;
+        warn(message);
+    }
+    /**
+     * Step two of `start`: with a boot answer that says a submission would be
+     * accepted, reconcile the trace instrumentation against the Project's served
+     * capture config and install (unless turned off) automatic error capture.
+     * Reaching here means the Gate is already satisfied, so an auto-error inherits
+     * the very tier boot derived.
+     *
+     * The trace was already armed optimistically at `start()`, so this is a
+     * **reconciliation**, not the first arming: a stream the Project turns off is both
+     * uninstrumented and **purged**, so what the optimistic window recorded for it can
+     * never ship.
+     */
+    function armCapture(answer) {
+        const streams = resolveStreams(answer.capture);
+        armTrace(streams);
+        if (!streams.console)
+            buffer.clearStream("console");
+        if (!streams.network)
+            buffer.clearStream("network");
+        // Replay arms **here and only here** — never optimistically before boot, the way
+        // the trace does. A trace that turns out to be unwanted is purged; frames already
+        // written to the cache are a recording that should not have started (ADR-0044).
+        armReplay(answer.capture);
+        if (options.autoCapture === false)
+            return;
+        s.autoCapture = (0, error_capture_1.installErrorCapture)({
+            apiUrl,
+            key,
+            origin,
+            identity: s.identity,
+            sdkVersion: version_1.EXPO_SDK_VERSION,
+            release,
+            buffer,
+            beforeSend: options.beforeSend,
+            scrub: options.scrub,
+            environment: readEnvironment,
+            currentUrl: () => (0, client_state_1.currentUrl)(s),
+            // The replay window as it stood at the throw (ADR-0044): frozen and encoded at
+            // filing time, on the rich first report only — a flush is a count update, and
+            // re-encoding the same window for it would be pure cost.
+            captureReplay: () => freezeAndEncodeReplay(),
+            errorUtils: adapters.errorUtils,
+            appState: adapters.appState,
+            deps: {
+                submitReport: (url, input) => (0, submit_1.submitReport)(url, input, (0, client_state_1.submitDeps)(s)),
+            },
+            now,
+        });
+    }
+    return {
+        bootAndArm,
+        resolveStreams,
+        armTrace,
+        disarmCapture,
+        setMaintenance,
+        clearMaintenanceRecheck,
+    };
+}
+//# sourceMappingURL=client-boot.js.map

package/dist/client-boot.js.map

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

package/dist/client-connect.d.ts

@@ -0,0 +1,33 @@
+/**
+ * **Connect** on the headless client (ADR-0066): the two doors `signIn()` opens
+ * (ADR-0052), the inbound deep links that finish a Connect started outside the app
+ * (ADR-0046), and `signOut()`.
+ *
+ * One piece of the headless client (`./client`), created over the state every piece
+ * shares (`./client-state`): the Reporter session token, the connect URL boot
+ * returned, the last inbound code, and the callers waiting on one. A Connect that lands
+ * re-boots as the Account through the boot it is handed (`./client-boot`), so a gated
+ * Project's shake gesture arms once the Account is eligible.
+ */
+import { type ReporterIdentity } from "@fixback/sdk-core";
+import { type ClientState } from "./client-state";
+/** Whether `signIn()` can open a door at all — what the dormancy hint is gated on. */
+export declare function canSignIn(s: ClientState): boolean;
+/** Connect on the client, as {@link createConnect} builds it. */
+export interface Connect {
+    /** Start a Connect through whichever door this app can open. Never throws. */
+    signIn(): Promise<ReporterIdentity>;
+    /** Revoke the Reporter session, clear it from SecureStore, and re-boot as anonymous. */
+    signOut(): Promise<void>;
+    /** Listen for Connect deep links that arrive while the app runs. */
+    armConnectLinking(gen: number): void;
+    /** Redeem the code on the URL the app was launched with, before the first boot. */
+    redeemLaunchUrl(gen: number): Promise<void>;
+    /** Resolve everyone waiting on an inbound Connect, and stop waiting. */
+    settleInboundWaiters(landed: boolean): void;
+}
+/**
+ * Connect over the client's shared state. `bootAndArm` is the client's boot: a Connect
+ * that lands re-boots through it, as the Account.
+ */
+export declare function createConnect(s: ClientState, bootAndArm: (gen: number) => Promise<void>): Connect;