@fixback/expo 0.9.0 → 0.9.1

package/dist/client-replay.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Mobile replay's arming (ADR-0044): whether the client records at all, the frame
+ * recorder it starts and stops on every boot, and turning a frozen window into the
+ * report's video.
+ *
+ * One piece of the headless client (`./client`), created over the state every piece
+ * shares (`./client-state`). The recorder and the window the composer froze live
+ * there, because the composer (`present`, `submit`) and boot (`./client-boot`) both
+ * reach them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReplayArming = createReplayArming;
+const sdk_core_1 = require("@fixback/sdk-core");
+const replay_1 = require("./replay");
+const replay_encode_1 = require("./replay-encode");
+/** Mobile replay's arming over the client's shared state. */
+function createReplayArming(s) {
+    const { options, adapters, warn, now, readEnvironment } = s;
+    /**
+     * Whether this app asked for mobile replay. Unlike every other stream, replay is
+     * **off until asked for** (ADR-0044): it records the device screen unmasked, so
+     * shipping an SDK update must never start it. Either spelling opts in —
+     * `capture: { replay: true }`, or simply passing a `replay` tuning object — and an
+     * explicit `capture: { replay: false }` always wins.
+     */
+    function replayRequested() {
+        if (typeof options.capture?.replay === "boolean")
+            return options.capture.replay;
+        return options.replay !== undefined;
+    }
+    /**
+     * Whether the server turned mobile replay off: the Project's replay toggle (the master kill
+     * switch, #138), or — on a server that sends it — `mobileReplay`, that toggle under the
+     * platform's `mobile_replay` feature flag for the workspace (#647). An older server sends only
+     * `replay`, which is then read as before.
+     */
+    function servedOff(served) {
+        if (typeof served?.replay === "boolean" && !served.replay)
+            return "project";
+        if (typeof served?.mobileReplay === "boolean" && !served.mobileReplay)
+            return "platform";
+        return null;
+    }
+    /**
+     * Whether replay records: this app asked for it, the server has not turned it off, and the
+     * platform can actually capture and encode frames.
+     */
+    function replayEnabled(served) {
+        if (!replayRequested())
+            return false;
+        if (servedOff(served) !== null)
+            return false;
+        return Boolean(adapters.captureReplayFrame && adapters.encodeReplaySegment);
+    }
+    /**
+     * Start (or stop) the frame recorder for the Project's served config. Re-armed on
+     * every boot, so a Project that turns replay off stops recording on the next boot
+     * rather than at the next launch — and the frames already buffered are deleted with
+     * the recorder, so nothing captured under the old answer can ship.
+     */
+    function armReplay(served) {
+        disarmReplay();
+        if (!replayEnabled(served)) {
+            const off = servedOff(served);
+            if (replayRequested() && off === "project") {
+                warn(`${sdk_core_1.WARN_PREFIX} replay is enabled in init but turned off for this Project — ` +
+                    "no replay will be recorded until it is enabled in the dashboard.");
+            }
+            else if (replayRequested() && off === "platform") {
+                warn(`${sdk_core_1.WARN_PREFIX} replay is enabled in init but mobile replay isn't available for this ` +
+                    "workspace yet — no replay will be recorded.");
+            }
+            else if (replayRequested() && !adapters.encodeReplaySegment) {
+                warn(`${sdk_core_1.WARN_PREFIX} replay is enabled in init but no native encoder is linked — ` +
+                    "mobile replay needs a development build (`npx expo prebuild`), not Expo Go.");
+            }
+            return;
+        }
+        s.replayRecorder = (0, replay_1.startMobileReplayRecorder)(options.replay ?? {}, {
+            captureFrame: (quality) => adapters.captureReplayFrame(quality),
+            releaseFrame: (uri) => releaseReplayFile(uri),
+            isActive: adapters.isAppActive,
+            now,
+        });
+    }
+    /** Stop the recorder and drop every frame it owns (best-effort). */
+    function disarmReplay() {
+        try {
+            s.replayRecorder?.stop();
+        }
+        catch {
+            /* teardown is best-effort */
+        }
+        s.replayRecorder = null;
+        s.pendingReplayWindow = null;
+    }
+    /** Delete a replay frame or encoded window file (best-effort, repeat-safe). */
+    function releaseReplayFile(uri) {
+        try {
+            adapters.releaseReplayFrame?.(uri);
+        }
+        catch {
+            /* release is best-effort */
+        }
+    }
+    /** Give a frozen window back to the recorder, so its frames can be reclaimed. */
+    function releaseReplayWindow(window) {
+        if (!window)
+            return;
+        try {
+            s.replayRecorder?.release(window);
+        }
+        catch {
+            /* release is best-effort */
+        }
+    }
+    /**
+     * Freeze the window as it stands **now** and encode it — the auto-capture path's
+     * whole replay step (ADR-0044): an uncaught error has no composer to open, so the
+     * throw itself is the moment the window is taken. The window is given back as soon
+     * as the encode is done, since nothing holds a draft for an auto report.
+     */
+    async function freezeAndEncodeReplay() {
+        const window = s.replayRecorder?.snapshot() ?? null;
+        if (!window)
+            return null;
+        try {
+            return await encodeReplay(window);
+        }
+        finally {
+            releaseReplayWindow(window);
+        }
+    }
+    /**
+     * Encode a frozen window for transport (ADR-0044). `null` whenever the window
+     * cannot become a video — no recorder, nothing watchable buffered, or an encoder
+     * that declined — so the report ships without replay rather than not at all.
+     */
+    async function encodeReplay(window) {
+        if (!window || !adapters.encodeReplaySegment)
+            return null;
+        return (0, replay_encode_1.encodeReplayWindow)(window, {
+            encodeSegment: adapters.encodeReplaySegment,
+            windowSize: () => {
+                const env = readEnvironment();
+                return {
+                    width: env.windowWidth ?? 0,
+                    height: env.windowHeight ?? 0,
+                };
+            },
+            maxEdge: (0, replay_1.resolvedMaxEdge)(options.replay),
+            now,
+        });
+    }
+    return {
+        armReplay,
+        disarmReplay,
+        releaseReplayFile,
+        releaseReplayWindow,
+        freezeAndEncodeReplay,
+        encodeReplay,
+    };
+}
+//# sourceMappingURL=client-replay.js.map

package/dist/client-replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-replay.js","sourceRoot":"","sources":["../src/client-replay.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA6BH,gDAsJC;AAjLD,gDAAoE;AAGpE,qCAIkB;AAClB,mDAA4E;AAkB5E,6DAA6D;AAC7D,SAAgB,kBAAkB,CAAC,CAAc;IAC/C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;IAE5D;;;;;;OAMG;IACH,SAAS,eAAe;QACtB,IAAI,OAAO,OAAO,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAChF,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,SAAS,SAAS,CAAC,MAAiC;QAClD,IAAI,OAAO,MAAM,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC5E,IAAI,OAAO,MAAM,EAAE,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,YAAY;YAAE,OAAO,UAAU,CAAC;QACzF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,SAAS,aAAa,CAAC,MAAiC;QACtD,IAAI,CAAC,eAAe,EAAE;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC7C,OAAO,OAAO,CAAC,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACH,SAAS,SAAS,CAAC,MAAiC;QAClD,YAAY,EAAE,CAAC;QACf,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,eAAe,EAAE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC3C,IAAI,CACF,GAAG,sBAAW,+DAA+D;oBAC3E,kEAAkE,CACrE,CAAC;YACJ,CAAC;iBAAM,IAAI,eAAe,EAAE,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;gBACnD,IAAI,CACF,GAAG,sBAAW,wEAAwE;oBACpF,6CAA6C,CAChD,CAAC;YACJ,CAAC;iBAAM,IAAI,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;gBAC9D,IAAI,CACF,GAAG,sBAAW,+DAA+D;oBAC3E,6EAA6E,CAChF,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,CAAC,CAAC,cAAc,GAAG,IAAA,kCAAyB,EAAC,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE;YACjE,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,kBAAmB,CAAC,OAAO,CAAC;YAChE,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC;YAC7C,QAAQ,EAAE,QAAQ,CAAC,WAAW;YAC9B,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,SAAS,YAAY;QACnB,IAAI,CAAC;YACH,CAAC,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QACD,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC;QACxB,CAAC,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED,+EAA+E;IAC/E,SAAS,iBAAiB,CAAC,GAAW;QACpC,IAAI,CAAC;YACH,QAAQ,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,SAAS,mBAAmB,CAAC,MAAiC;QAC5D,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,CAAC;YACH,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,UAAU,qBAAqB;QAClC,MAAM,MAAM,GAAG,CAAC,CAAC,cAAc,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC;QACpD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;gBAAS,CAAC;YACT,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,UAAU,YAAY,CACzB,MAAiC;QAEjC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,mBAAmB;YAAE,OAAO,IAAI,CAAC;QAC1D,OAAO,IAAA,kCAAkB,EAAC,MAAM,EAAE;YAChC,aAAa,EAAE,QAAQ,CAAC,mBAAmB;YAC3C,UAAU,EAAE,GAAG,EAAE;gBACf,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;gBAC9B,OAAO;oBACL,KAAK,EAAE,GAAG,CAAC,WAAW,IAAI,CAAC;oBAC3B,MAAM,EAAE,GAAG,CAAC,YAAY,IAAI,CAAC;iBAC9B,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAA,wBAAe,EAAC,OAAO,CAAC,MAAM,CAAC;YACxC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,SAAS;QACT,YAAY;QACZ,iBAAiB;QACjB,mBAAmB;QACnB,qBAAqB;QACrB,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/client-state.d.ts

@@ -0,0 +1,131 @@
+/**
+ * The state the headless client's pieces share (#661): one explicit object, where
+ * `createFixbackClient` used to be a single closure whose parts reached into each
+ * other's variables.
+ *
+ * It holds what the client resolves from its options once, at creation — the trimmed
+ * key, the canonical origin, the API base, the validated Release, the Correlation id's
+ * targets, the trace buffer, the listener sets — and every value that changes over the
+ * client's life: the status and the boot answer, the lifecycle generation, the Connect
+ * state, the armed capture, and maintenance mode's notice. Every piece is created over
+ * the same object — boot and capture arming (`./client-boot`), mobile replay
+ * (`./client-replay`), Connect (`./client-connect`), and the composer-facing surface
+ * (`./client`) — so what one piece writes is what the next one reads.
+ */
+import { type BootAnswer, type BreadcrumbBuffer, type FetchLike, type IdentityInputs, type MaintenanceNotice, type MaintenanceRecheck, type ReporterIdentity, type ReporterTier, type Teardown } from "@fixback/sdk-core";
+import type { AutoCaptureHandle } from "./error-capture";
+import type { FormDataFactory } from "./http";
+import type { ComposerContext, FixbackAdapters, FixbackOptions, FixbackStatus } from "./options";
+import type { EnvironmentInputs } from "./report";
+import type { MobileReplayRecorder, MobileReplayWindow } from "./replay";
+/** Everything a client knows and holds — see the module doc. */
+export interface ClientState {
+    readonly options: FixbackOptions;
+    readonly adapters: FixbackAdapters;
+    /** The publishable key, trimmed; `""` when there is none, which keeps the client dormant. */
+    readonly key: string;
+    /** The canonical `origin` the app reports as, or `""` when it declared none (ADR-0041). */
+    readonly origin: string;
+    /** The Fixback API base: trimmed, with no trailing slash. */
+    readonly apiUrl: string;
+    readonly now: () => number;
+    readonly readEnvironment: () => EnvironmentInputs;
+    /** The development-only warning sink (silent unless the adapters provide one). */
+    readonly warn: (message: string) => void;
+    /** The host app's Release (#117, ADR-0024), validated; `undefined` when unset or invalid. */
+    readonly release: string | undefined;
+    /** The Correlation id's targets (#540): the `propagateTo` entries that are bare origins. */
+    readonly propagateTo: readonly string[];
+    /** The trace buffer. It outlives every re-arm, so no lead-up is lost to one. */
+    readonly buffer: BreadcrumbBuffer;
+    readonly statusListeners: Set<(status: FixbackStatus) => void>;
+    readonly presentListeners: Set<(context: ComposerContext) => void>;
+    readonly identityListeners: Set<(identity: ReporterIdentity) => void>;
+    readonly maintenanceListeners: Set<(notice: MaintenanceNotice | null) => void>;
+    status: FixbackStatus;
+    boot: BootAnswer | null;
+    /** Monotonic id of the most recently *started* boot — see `bootAndArm` (`./client-boot`). */
+    bootSequence: number;
+    currentScreen: string | null;
+    teardownTrace: Teardown | null;
+    autoCapture: AutoCaptureHandle | null;
+    /**
+     * The mobile replay recorder, and the window frozen when the composer opened
+     * (ADR-0044). Both are null unless the Project enabled replay *and* this app asked
+     * for it — recording an unmasked screen is never something the SDK starts on its own.
+     */
+    replayRecorder: MobileReplayRecorder | null;
+    pendingReplayWindow: MobileReplayWindow | null;
+    identity: IdentityInputs;
+    reporterSessionToken: string | null;
+    account: {
+        name: string;
+        email: string;
+    } | null;
+    currentTier: ReporterTier | null;
+    connectUrl: string | undefined;
+    /** Removes the inbound deep-link listener; re-armed by each `start()`. */
+    teardownLinking: Teardown | null;
+    /**
+     * The last inbound Connect code redeemed, so a replayed launch URL is not exchanged
+     * twice. A code is single-use: the second attempt would fail, and a failed exchange
+     * is indistinguishable from a Connect that never worked.
+     */
+    lastInboundCode: string | null;
+    /**
+     * Callers waiting for the next inbound Connect to land — the browser door's
+     * `signIn()` (ADR-0052), which hands control to the connect page and gets it back as
+     * a deep link the inbound listener redeems. Resolved with `true` by a successful
+     * redemption, `false` when the wait gives up or the client is destroyed, so an
+     * awaited `signIn()` reports the identity the round trip actually produced instead
+     * of the anonymous one it started from.
+     */
+    inboundWaiters: Array<(landed: boolean) => void>;
+    /**
+     * The lifecycle generation. Each `start()` claims a new generation and every
+     * await inside it re-checks that it is still current; `destroy()` bumps the
+     * generation so an in-flight start abandons itself. A destroyed client can be
+     * started again — React 18+ StrictMode (and Fast Refresh) replay the
+     * provider's effect as mount → cleanup → re-mount on the same client
+     * instance, so destroy must not be terminal.
+     */
+    generation: number;
+    /** Whether a start() has claimed the current generation. */
+    running: boolean;
+    /** Maintenance mode's notice — boot's, or a held report's — else `null`. */
+    maintenance: MaintenanceNotice | null;
+    /** The next boot while the notice shows. */
+    readonly maintenanceRecheck: MaintenanceRecheck;
+    /**
+     * The last dormancy line printed, so a re-boot that changes nothing (a `signOut`
+     * back to the same refusal, an app resumed) does not repeat itself. Reset whenever
+     * the client becomes able to submit, so a *later* relapse is reported again.
+     */
+    lastDormancyWarning: string | null;
+}
+/**
+ * Resolve a client's options once, saying what it cannot use as it goes, and set up its
+ * state at rest: `idle`, nothing armed, no boot answer yet.
+ */
+export declare function createClientState(options: FixbackOptions, adapters: FixbackAdapters): ClientState;
+/** Move the client to `next`, telling every status listener once. */
+export declare function setStatus(s: ClientState, next: FixbackStatus): void;
+/**
+ * The `url` a report carries right now (spec 0004 §D). With an `origin` configured
+ * it reads `<origin>/<screen>`; without one — the default since ADR-0041 — the
+ * screen stands alone, so the Evidence still says *where* the reporter was rather
+ * than losing it to a setting nobody has to fill in. Ingest takes `url` as a free
+ * string and the dashboard renders it as text, so a bare screen name is honest
+ * here where a synthesised origin would be fiction.
+ */
+export declare function currentUrl(s: ClientState): string | undefined;
+/** The transport deps every call shares: the injected seams plus this app's origin. */
+export declare function submitDeps(s: ClientState): {
+    fetch?: FetchLike;
+    formData?: FormDataFactory;
+    origin: string;
+};
+/** The current Reporter identity for the composer's identity row and `identity()`. */
+export declare function reporterIdentity(s: ClientState): ReporterIdentity;
+/** Tell identity listeners the identity may have changed (boot / sign in / sign out). */
+export declare function notifyIdentity(s: ClientState): void;

package/dist/client-state.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * The state the headless client's pieces share (#661): one explicit object, where
+ * `createFixbackClient` used to be a single closure whose parts reached into each
+ * other's variables.
+ *
+ * It holds what the client resolves from its options once, at creation — the trimmed
+ * key, the canonical origin, the API base, the validated Release, the Correlation id's
+ * targets, the trace buffer, the listener sets — and every value that changes over the
+ * client's life: the status and the boot answer, the lifecycle generation, the Connect
+ * state, the armed capture, and maintenance mode's notice. Every piece is created over
+ * the same object — boot and capture arming (`./client-boot`), mobile replay
+ * (`./client-replay`), Connect (`./client-connect`), and the composer-facing surface
+ * (`./client`) — so what one piece writes is what the next one reads.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClientState = createClientState;
+exports.setStatus = setStatus;
+exports.currentUrl = currentUrl;
+exports.submitDeps = submitDeps;
+exports.reporterIdentity = reporterIdentity;
+exports.notifyIdentity = notifyIdentity;
+const sdk_core_1 = require("@fixback/sdk-core");
+const origin_1 = require("./origin");
+const propagation_1 = require("./propagation");
+/** Normalise a base URL: trim and drop trailing slashes. */
+function normalizeBase(value) {
+    return value.trim().replace(/\/+$/, "");
+}
+/** Turn a screen name into the path segment of the report `url`. */
+function screenPath(name) {
+    return name.trim().replace(/^\/+/, "");
+}
+/**
+ * Resolve a client's options once, saying what it cannot use as it goes, and set up its
+ * state at rest: `idle`, nothing armed, no boot answer yet.
+ */
+function createClientState(options, adapters) {
+    const key = typeof options.key === "string" ? options.key.trim() : "";
+    const origin = typeof options.origin === "string" ? (0, origin_1.canonicalizeOrigin)(options.origin) : "";
+    const apiUrl = normalizeBase(options.apiUrl || sdk_core_1.DEFAULT_API_URL) || sdk_core_1.DEFAULT_API_URL;
+    const now = adapters.now ?? Date.now;
+    const readEnvironment = adapters.environment ?? (() => ({}));
+    const warn = adapters.warn ?? (() => { });
+    // The host app's Release (#117, ADR-0024), validated once here: an invalid value
+    // is dropped with a warning rather than shipped for the server to discard — and
+    // never a reason to refuse to start (capture must not break on config). Unlike the
+    // browser SDK, nothing falls back to a bundler-injected Release: with no option,
+    // none is stamped.
+    const { release, warning: releaseWarning } = (0, sdk_core_1.readReleaseOption)(options.release);
+    if (releaseWarning)
+        warn(`${sdk_core_1.WARN_PREFIX} ${releaseWarning}`);
+    // `environment` is no longer an option — the key selects the Environment (ADR
+    // 2026-09-24) — but a plain-JS caller gets no type error for passing it, and would
+    // otherwise believe it was honoured. Said once, here, never per report.
+    const removedOption = (0, sdk_core_1.removedEnvironmentOptionWarning)(options);
+    if (removedOption)
+        warn(`${sdk_core_1.WARN_PREFIX} ${removedOption}`);
+    // The Correlation id's targets (#540) — app topology known in code, so an init option
+    // rather than a served setting, and allowlist-only on mobile. An entry that is not a
+    // bare origin is never used, and said so once, the way an invalid release is — in the
+    // words every capture SDK shares.
+    const propagation = (0, propagation_1.normalizePropagateTo)(options.propagateTo);
+    const ignoredPropagateTo = (0, sdk_core_1.ignoredPropagateToWarning)(propagation.rejected);
+    if (ignoredPropagateTo)
+        warn(`${sdk_core_1.WARN_PREFIX} ${ignoredPropagateTo}`);
+    const buffer = (0, sdk_core_1.createBreadcrumbBuffer)({
+        beforeBreadcrumb: options.beforeBreadcrumb,
+        now,
+    });
+    return {
+        options,
+        adapters,
+        key,
+        origin,
+        apiUrl,
+        now,
+        readEnvironment,
+        warn,
+        release,
+        propagateTo: propagation.origins,
+        buffer,
+        statusListeners: new Set(),
+        presentListeners: new Set(),
+        identityListeners: new Set(),
+        maintenanceListeners: new Set(),
+        status: "idle",
+        boot: null,
+        bootSequence: 0,
+        currentScreen: null,
+        teardownTrace: null,
+        autoCapture: null,
+        replayRecorder: null,
+        pendingReplayWindow: null,
+        identity: {},
+        reporterSessionToken: null,
+        account: null,
+        currentTier: null,
+        connectUrl: undefined,
+        teardownLinking: null,
+        lastInboundCode: null,
+        inboundWaiters: [],
+        generation: 0,
+        running: false,
+        maintenance: null,
+        maintenanceRecheck: (0, sdk_core_1.createMaintenanceRecheck)(),
+        lastDormancyWarning: null,
+    };
+}
+/** Move the client to `next`, telling every status listener once. */
+function setStatus(s, next) {
+    if (s.status === next)
+        return;
+    s.status = next;
+    for (const listener of s.statusListeners) {
+        try {
+            listener(next);
+        }
+        catch {
+            /* a listener must never break the client */
+        }
+    }
+}
+/**
+ * The `url` a report carries right now (spec 0004 §D). With an `origin` configured
+ * it reads `<origin>/<screen>`; without one — the default since ADR-0041 — the
+ * screen stands alone, so the Evidence still says *where* the reporter was rather
+ * than losing it to a setting nobody has to fill in. Ingest takes `url` as a free
+ * string and the dashboard renders it as text, so a bare screen name is honest
+ * here where a synthesised origin would be fiction.
+ */
+function currentUrl(s) {
+    const { origin, currentScreen } = s;
+    if (!origin)
+        return currentScreen ? screenPath(currentScreen) : undefined;
+    return currentScreen ? `${origin}/${screenPath(currentScreen)}` : origin;
+}
+/** The transport deps every call shares: the injected seams plus this app's origin. */
+function submitDeps(s) {
+    return { fetch: s.adapters.fetch, formData: s.adapters.formData, origin: s.origin };
+}
+/** The current Reporter identity for the composer's identity row and `identity()`. */
+function reporterIdentity(s) {
+    return (0, sdk_core_1.reporterIdentityOf)(s.account, s.currentTier);
+}
+/** Tell identity listeners the identity may have changed (boot / sign in / sign out). */
+function notifyIdentity(s) {
+    const current = reporterIdentity(s);
+    for (const listener of s.identityListeners) {
+        try {
+            listener(current);
+        }
+        catch {
+            /* a listener must never break the client */
+        }
+    }
+}
+//# sourceMappingURL=client-state.js.map

package/dist/client-state.js.map

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