@fireweaveai/web-sdk-cjs 0.0.0-reserve.0 → 0.0.0-stage

package/dist/start/policy.js

@@ -1,128 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sourced = sourced;
-exports.firstOf = firstOf;
-exports.resolvePolicy = resolvePolicy;
-/**
- * The web start-profile policy: one pure resolver shared by the browser
- * start() and the Node build helpers (node/vite.ts, node/define.ts), so a
- * build and the page it produces can never disagree about mode, key or URL.
- *
- * Pure on purpose: no DOM, no env, no core import. Callers hand in values
- * with their source names; the result is a config, or a failure carrying a
- * fixed reason code and a message that names sources and variables, never a
- * value.
- */
-const names_js_1 = require("./names.js");
-/** A trimmed, non-empty string with its source, or undefined. Non-strings count as unset. */
-function sourced(value, source) {
-    if (typeof value !== 'string')
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed === '' ? undefined : { value: trimmed, source };
-}
-/** The first candidate that is set. */
-function firstOf(...candidates) {
-    return candidates.find((c) => c !== undefined);
-}
-const fail = (reason, variable, message) => ({
-    ok: false,
-    reason,
-    variable,
-    message: `[fireweave] ${message}`,
-});
-/** Key family check. Messages name the source, never the value. */
-function checkKey(key) {
-    const v = key.value;
-    if (v.startsWith(names_js_1.BROWSER_KEY_PREFIX))
-        return undefined;
-    if (v.startsWith('project-api-key_')) {
-        return fail('server-key', key.source, `The key from ${key.source} is a server key (project-api-key_…), which must never ship to a browser. Use a browser key (fw_public_…) from Project settings, API keys. If a bundle built with this key was deployed, revoke the key.`);
-    }
-    if (/^ph[a-z]_/.test(v)) {
-        return fail('wrong-key-family', key.source, `The key from ${key.source} is an analytics vendor key, not a FireWeave browser key (fw_public_…).`);
-    }
-    if (v.startsWith('fw_org_') || v.startsWith('cli_at_')) {
-        return fail('wrong-key-family', key.source, `The key from ${key.source} is an organisation or CLI token, not a FireWeave browser key (fw_public_…).`);
-    }
-    return fail('wrong-key-family', key.source, `The key from ${key.source} is not a FireWeave browser key (fw_public_…).`);
-}
-const isLoopback = (hostname) => hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1' || hostname === '[::1]';
-function resolveUrl(url, channel) {
-    if (url === undefined)
-        return { url: names_js_1.CHANNEL_URLS[channel], urlSource: `SDK channel (${channel})` };
-    const value = url.value.replace(/\/+$/, '');
-    if (value.startsWith('//')) {
-        return fail('insecure-url', url.source, `The endpoint from ${url.source} is protocol-relative. Use an https URL or a same-origin path such as '/fw'.`);
-    }
-    // A same-origin proxy path: the browser resolves it against location.origin.
-    if (value.startsWith('/'))
-        return { url: value, urlSource: url.source };
-    let parsed;
-    try {
-        parsed = new URL(value);
-    }
-    catch {
-        return fail('insecure-url', url.source, `The endpoint from ${url.source} is not a valid URL.`);
-    }
-    const httpsOk = parsed.protocol === 'https:';
-    const loopbackHttp = parsed.protocol === 'http:' && isLoopback(parsed.hostname);
-    if (!httpsOk && !loopbackHttp) {
-        return fail('insecure-url', url.source, `The endpoint from ${url.source} must use https (http is allowed only for localhost).`);
-    }
-    return { url: value, urlSource: url.source, allowedHosts: [parsed.hostname.replace(/^\[|\]$/g, ''), ...names_js_1.LOOPBACK_HOSTS] };
-}
-function remote(input, key, modeSource, warnings) {
-    const keyProblem = checkKey(key);
-    if (keyProblem !== undefined)
-        return keyProblem;
-    const url = resolveUrl(input.url, input.channel);
-    if ('ok' in url)
-        return url;
-    return { ok: true, config: { mode: 'remote', modeSource, ...url, key: key.value, keySource: key.source }, warnings };
-}
-/**
- * Resolve mode, key and endpoint.
- *
- * An explicit mode wins. Otherwise a key means remote; no key and a
- * development environment name means local; anything else fails closed, so a
- * missing key never turns into silent local evaluation for real visitors.
- */
-function resolvePolicy(input) {
-    const warnings = [];
-    const { mode, key, environment } = input;
-    if (mode !== undefined && mode !== 'remote' && mode !== 'local') {
-        return fail('invalid-mode', 'mode', `start({ mode }) must be 'remote' or 'local'.`);
-    }
-    if (mode === 'local') {
-        if (key !== undefined) {
-            warnings.push(`[fireweave] mode 'local' ignores the key from ${key.source}; nothing is sent to fw-server.`);
-        }
-        return { ok: true, config: { mode: 'local', modeSource: 'option', keySource: 'none' }, warnings };
-    }
-    if (mode === 'remote') {
-        if (key === undefined) {
-            return fail('missing-key', input.keyVariable, `mode 'remote' needs a browser key. Set ${input.keyVariable} to a browser key (fw_public_…).`);
-        }
-        return remote(input, key, 'option', warnings);
-    }
-    if (key !== undefined)
-        return remote(input, key, 'key', warnings);
-    if (environment !== undefined && names_js_1.DEV_ENVIRONMENTS.has(environment.value.toLowerCase())) {
-        return {
-            ok: true,
-            config: {
-                mode: 'local',
-                modeSource: 'environment',
-                keySource: 'none',
-                environment: environment.value,
-                environmentSource: environment.source,
-            },
-            warnings,
-        };
-    }
-    const where = environment === undefined
-        ? `no environment name is set (checked ${input.environmentChecked})`
-        : `the environment is '${environment.value}' (from ${environment.source}), which is not a development name`;
-    return fail('missing-key', input.keyVariable, `${input.keyVariable} is not set and ${where}. Set ${input.keyVariable} to a browser key (fw_public_…), or for local work set FIREWEAVE_ENV=development or pass start({ mode: 'local' }).`);
-}

package/dist/start/state.d.ts

@@ -1,103 +0,0 @@
-/**
- * start() and the page-wide singleton behind `fw`.
- *
- * One slot per page (or worker) at a Symbol.for key on globalThis, so HMR
- * re-evaluation and two bundled copies of this package share one client.
- *
- * Nothing here throws or rejects. A browser that fails to start must still
- * render: a configuration fault logs one console.error, sets the state to
- * FAILED and `problem`, and every read serves its default. The build helpers
- * (`/vite`, `/define`) are where a bad configuration fails loudly.
- */
-import { FireweaveError, type FireweaveWebClient } from '../index.js';
-import { type ControlPointMap } from './control-points.js';
-import { type Identity, type Persistence } from './identity.js';
-import { type InjectedConfig, type PolicyConfig, type PolicyReason, type SdkChannel, type StartMode } from './policy.js';
-export interface StartOptions {
-    /** Control points and their local values; import from src/fireweave/control-points.ts. */
-    readonly controlPoints?: ControlPointMap;
-    /** Force a mode. Without it: a key means remote; no key means local only in a dev environment. */
-    readonly mode?: StartMode;
-    /** Environment name used to infer the mode. Default: what the fireweave() build plugin injected. */
-    readonly environment?: string;
-    /** fw-server URL, or a same-origin proxy path such as '/fw'. Default: the build config, else this SDK build's channel host. */
-    readonly url?: string;
-    /** Browser key (fw_public_…). Default: FIREWEAVE_BROWSER_KEY, injected by the build plugin. */
-    readonly key?: string;
-    /** Initial storage mode. 'memory' writes nothing until fw.setPersistence('localStorage'). Default 'localStorage'. */
-    readonly persistence?: Persistence;
-    /** An app-supplied anonymous id (for example the analytics id), used verbatim and not stored. */
-    readonly deviceId?: string;
-    /** Where [fireweave] lines go. Default: console. */
-    readonly log?: (line: string) => void;
-    /** Transport override for tests. */
-    readonly fetch?: typeof fetch;
-}
-export type StartState = 'NOT_STARTED' | 'INITIALIZING' | 'READY' | 'STALE' | 'ERROR' | 'FAILED' | 'SHUTDOWN';
-export interface StartProblem {
-    readonly reason: PolicyReason | 'invalid-control-points' | 'start-failed' | 'key-rejected' | 'unreachable';
-    /** The variable or option at fault, when there is one. Never a value. */
-    readonly variable?: string;
-}
-export interface FireweaveWebStatus {
-    readonly state: StartState;
-    readonly mode?: StartMode;
-    readonly modeSource?: PolicyConfig['modeSource'];
-    readonly channel: SdkChannel;
-    readonly sdkVersion: string;
-    /** fw-server host name only: never a path or a credential. */
-    readonly host?: string;
-    readonly endpointSource?: string;
-    readonly keySource?: string;
-    readonly environment?: string;
-    readonly controlPointCount?: number;
-    readonly problem?: StartProblem;
-}
-export interface Slot {
-    readonly protocol: 1;
-    state: StartState;
-    /** Bumped by every start and shutdown, so a late result from an older attempt is ignored. */
-    generation: number;
-    fingerprint?: string | undefined;
-    config?: PolicyConfig | undefined;
-    controlPoints: ControlPointMap;
-    persistence: Persistence;
-    appDeviceId: boolean;
-    identity?: Identity | undefined;
-    /** The key the current decisions were prefetched under. */
-    currentKey?: string | undefined;
-    client?: FireweaveWebClient | undefined;
-    problem?: StartProblem | undefined;
-    ready: Promise<void>;
-    /** Serializes identify / reset / forget, so the last call wins. */
-    chain: Promise<unknown>;
-    log: (line: string) => void;
-    readonly warned: Set<string>;
-    readonly listeners: Set<(state: StartState) => void>;
-    detachRuntime?: (() => void) | undefined;
-}
-export declare function slot(): Slot;
-export declare function warnOnce(s: Slot, line: string): void;
-/** console.error once per line. Errors bypass the log sink so they always reach the console. */
-export declare function errorOnce(s: Slot, line: string): void;
-/** Change state and notify. `always` re-notifies an unchanged state (a re-prefetch after identify). */
-export declare function setState(s: Slot, next: StartState, always?: boolean): void;
-/** What the fireweave() build plugin or fireweaveDefine() injected, if anything. */
-export declare function injectedConfig(): InjectedConfig | undefined;
-/**
- * Start FireWeave for this page. Call once, from src/fireweave/start.ts.
- *
- * Resolves when the first prefetch settles (READY, STALE or ERROR) and never
- * rejects, so `await start(...)` cannot blank a page. Check `fw.status()` for
- * the outcome.
- */
-export declare function start(options?: StartOptions): Promise<void>;
-export declare function currentStatus(): FireweaveWebStatus;
-/** Switch storage at runtime, for consent. Never part of the start() configuration check. */
-export declare function setPersistenceFor(mode: Persistence): void;
-/** Store (or clear) the signed-in key, when persistence allows it. */
-export declare function rememberUser(s: Slot, user: string | undefined): void;
-export declare function shutdownSlot(): Promise<void>;
-/** Test only: shut down and forget the singleton so the next start() begins fresh. */
-export declare function resetForTests(): Promise<void>;
-export declare const notStartedError: (state: StartState) => FireweaveError;

package/dist/start/state.js

@@ -1,375 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.notStartedError = void 0;
-exports.slot = slot;
-exports.warnOnce = warnOnce;
-exports.errorOnce = errorOnce;
-exports.setState = setState;
-exports.injectedConfig = injectedConfig;
-exports.start = start;
-exports.currentStatus = currentStatus;
-exports.setPersistenceFor = setPersistenceFor;
-exports.rememberUser = rememberUser;
-exports.shutdownSlot = shutdownSlot;
-exports.resetForTests = resetForTests;
-/**
- * start() and the page-wide singleton behind `fw`.
- *
- * One slot per page (or worker) at a Symbol.for key on globalThis, so HMR
- * re-evaluation and two bundled copies of this package share one client.
- *
- * Nothing here throws or rejects. A browser that fails to start must still
- * render: a configuration fault logs one console.error, sets the state to
- * FAILED and `problem`, and every read serves its default. The build helpers
- * (`/vite`, `/define`) are where a bad configuration fails loudly.
- */
-const index_js_1 = require("../index.js");
-const build_info_js_1 = require("./build-info.js");
-const control_points_js_1 = require("./control-points.js");
-const identity_js_1 = require("./identity.js");
-const names_js_1 = require("./names.js");
-const policy_js_1 = require("./policy.js");
-const SLOT_KEY = Symbol.for('@fireweaveai/web-sdk/start');
-let protocolWarned = false;
-const defaultLog = (line) => {
-    if (line.startsWith('[fireweave:local]'))
-        console.info(line);
-    else
-        console.warn(line);
-};
-const freshSlot = () => ({
-    protocol: 1,
-    state: 'NOT_STARTED',
-    generation: 0,
-    controlPoints: Object.freeze({}),
-    persistence: 'localStorage',
-    appDeviceId: false,
-    ready: Promise.resolve(),
-    chain: Promise.resolve(),
-    log: defaultLog,
-    warned: new Set(),
-    listeners: new Set(),
-});
-function slot() {
-    const g = globalThis;
-    const existing = g[SLOT_KEY];
-    if (existing !== undefined) {
-        if (existing.protocol !== 1 && !protocolWarned) {
-            protocolWarned = true;
-            console.warn('[fireweave] Two incompatible copies of @fireweaveai/web-sdk are loaded. Deduplicate the dependency.');
-        }
-        return existing;
-    }
-    const created = freshSlot();
-    g[SLOT_KEY] = created;
-    return created;
-}
-function warnOnce(s, line) {
-    if (s.warned.has(line))
-        return;
-    s.warned.add(line);
-    s.log(line);
-}
-/** console.error once per line. Errors bypass the log sink so they always reach the console. */
-function errorOnce(s, line) {
-    if (s.warned.has(line))
-        return;
-    s.warned.add(line);
-    console.error(line);
-}
-/** Change state and notify. `always` re-notifies an unchanged state (a re-prefetch after identify). */
-function setState(s, next, always = false) {
-    if (s.state === next && !always)
-        return;
-    s.state = next;
-    for (const listener of s.listeners) {
-        try {
-            listener(next);
-        }
-        catch {
-            // a listener's bug must not break the SDK
-        }
-    }
-}
-const fromLifecycle = (state) => (state === 'UNINITIALIZED' ? 'INITIALIZING' : state);
-/** What the fireweave() build plugin or fireweaveDefine() injected, if anything. */
-function injectedConfig() {
-    let raw;
-    try {
-        raw = typeof __FIREWEAVE_WEB_CONFIG__ !== 'undefined' ? __FIREWEAVE_WEB_CONFIG__ : undefined;
-    }
-    catch {
-        raw = undefined;
-    }
-    if (typeof raw !== 'object' || raw === null || raw.v !== 1)
-        return undefined;
-    return raw;
-}
-const hasDom = () => typeof window !== 'undefined' && typeof document !== 'undefined';
-/** Sorted-key JSON, so the fingerprint does not depend on property order. */
-function stableJson(value) {
-    if (Array.isArray(value))
-        return `[${value.map(stableJson).join(',')}]`;
-    if (value !== null && typeof value === 'object') {
-        const entries = Object.entries(value)
-            .filter(([, v]) => v !== undefined)
-            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
-        return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableJson(v)}`).join(',')}}`;
-    }
-    return JSON.stringify(value ?? null);
-}
-function fingerprintOf(config, controlPoints, deviceId) {
-    return stableJson({
-        mode: config.mode,
-        url: config.url,
-        key: config.key,
-        allowedHosts: config.allowedHosts,
-        deviceId,
-        // Local values only matter in local mode.
-        controlPoints: config.mode === 'local' ? (0, control_points_js_1.toLocalControlPoints)(controlPoints) : undefined,
-    });
-}
-const isActive = (state) => state === 'INITIALIZING' || state === 'READY' || state === 'STALE' || state === 'ERROR';
-function fail(s, problem, message) {
-    // A bad repeat start() must not take down the client that is already running.
-    if (isActive(s.state)) {
-        errorOnce(s, `${message} Keeping the running configuration.`);
-        return s.ready;
-    }
-    s.problem = problem;
-    errorOnce(s, `${message} FireWeave is not running; reads serve their defaults.`);
-    setState(s, 'FAILED');
-    s.ready = Promise.resolve();
-    return s.ready;
-}
-/** Same-origin proxy paths ('/fw') resolve against the page origin. */
-function absolutize(config) {
-    if (config.url === undefined || !config.url.startsWith('/'))
-        return config;
-    const origin = globalThis.location.origin;
-    return { ...config, url: `${origin}${config.url}`, allowedHosts: [globalThis.location.hostname, ...names_js_1.LOOPBACK_HOSTS] };
-}
-function localLine(config, controlPoints) {
-    const why = config.modeSource === 'option'
-        ? "mode 'local'"
-        : `no key; environment '${config.environment ?? ''}' from ${config.environmentSource ?? 'the build config'}`;
-    const n = Object.keys(controlPoints).length;
-    return `[fireweave:local] Local mode (${why}). Serving ${n} control point${n === 1 ? '' : 's'} from your control-points object; nothing is sent to fw-server.`;
-}
-/**
- * Wrap the transport so faults the core folds into STALE keep their cause:
- * a 401/403 means the key was refused, a rejected fetch means fw-server was
- * not reachable from this page.
- */
-function observedFetch(s, generation, base, config) {
-    const host = config.url !== undefined ? new URL(config.url).host : 'fw-server';
-    const wrapped = async (input, init) => {
-        try {
-            const response = await base(input, init);
-            if (s.generation === generation) {
-                if (response.status === 401 || response.status === 403) {
-                    s.problem = { reason: 'key-rejected', variable: config.keySource };
-                    errorOnce(s, `[fireweave] fw-server refused the browser key from ${config.keySource} (HTTP ${response.status}). Check the key is an active browser key (fw_public_…) for this project. Reads serve their defaults.`);
-                }
-                else if (response.ok && (s.problem?.reason === 'key-rejected' || s.problem?.reason === 'unreachable')) {
-                    s.problem = undefined;
-                }
-            }
-            return response;
-        }
-        catch (err) {
-            if (s.generation === generation) {
-                s.problem = { reason: 'unreachable' };
-                warnOnce(s, `[fireweave] Could not reach fw-server at ${host}: offline, an ad or tracker blocker, a firewall, or a Content-Security-Policy connect-src rule. Reads serve their defaults. A same-origin proxy set through FIREWEAVE_URL avoids most of these.`);
-            }
-            throw err;
-        }
-    };
-    return wrapped;
-}
-function registerDevice(s, generation) {
-    const { client, identity, config } = s;
-    if (client === undefined || identity === undefined || config?.mode !== 'remote' || !identity.durable)
-        return;
-    if ((0, identity_js_1.readItem)(names_js_1.STORAGE_KEYS.deviceRegistered) === identity.deviceId)
-        return;
-    void client.registerTarget(identity.deviceId, { kind: 'device' }).then((result) => {
-        if (result.ok && s.generation === generation && s.persistence === 'localStorage') {
-            (0, identity_js_1.writeItem)(names_js_1.STORAGE_KEYS.deviceRegistered, identity.deviceId);
-        }
-    });
-}
-/**
- * Start FireWeave for this page. Call once, from src/fireweave/start.ts.
- *
- * Resolves when the first prefetch settles (READY, STALE or ERROR) and never
- * rejects, so `await start(...)` cannot blank a page. Check `fw.status()` for
- * the outcome.
- */
-function start(options = {}) {
-    const s = slot();
-    if (options.log !== undefined && (s.state === 'NOT_STARTED' || s.state === 'FAILED' || s.state === 'SHUTDOWN')) {
-        s.log = options.log;
-    }
-    let controlPoints;
-    try {
-        controlPoints = (0, control_points_js_1.normalizeControlPoints)(options.controlPoints);
-    }
-    catch (err) {
-        return fail(s, { reason: 'invalid-control-points', variable: 'controlPoints' }, err.message);
-    }
-    const injected = injectedConfig();
-    const policy = (0, policy_js_1.resolvePolicy)({
-        mode: options.mode,
-        key: (0, policy_js_1.firstOf)((0, policy_js_1.sourced)(options.key, 'start({ key })'), (0, policy_js_1.sourced)(injected?.key, injected?.keySource ?? names_js_1.BUILD_ENV.key)),
-        url: (0, policy_js_1.firstOf)((0, policy_js_1.sourced)(options.url, 'start({ url })'), (0, policy_js_1.sourced)(injected?.url, injected?.urlSource ?? names_js_1.BUILD_ENV.url)),
-        environment: (0, policy_js_1.firstOf)((0, policy_js_1.sourced)(options.environment, 'start({ environment })'), (0, policy_js_1.sourced)(injected?.environment, injected?.environmentSource ?? names_js_1.BUILD_ENV.environment)),
-        channel: build_info_js_1.SDK_CHANNEL,
-        keyVariable: injected !== undefined ? names_js_1.BUILD_ENV.key : `the browser key (start({ key }), or ${names_js_1.BUILD_ENV.key} through the fireweave() build plugin)`,
-        environmentChecked: 'start({ environment }) and the build config',
-    });
-    if (!policy.ok)
-        return fail(s, { reason: policy.reason, variable: policy.variable }, policy.message);
-    // Remote mode without a DOM (SSR, a worker, a DOM-less test) does nothing:
-    // a server-side singleton would share one visitor's identity across requests.
-    if (policy.config.mode === 'remote' && !hasDom())
-        return Promise.resolve();
-    const config = absolutize(policy.config);
-    const fingerprint = fingerprintOf(config, controlPoints, options.deviceId);
-    if (isActive(s.state)) {
-        if (fingerprint !== s.fingerprint) {
-            errorOnce(s, '[fireweave] start() was already called with a different configuration; keeping the first one. Call start() once, from src/fireweave/start.ts.');
-        }
-        return s.ready;
-    }
-    const generation = s.generation + 1;
-    s.generation = generation;
-    s.fingerprint = fingerprint;
-    s.config = config;
-    s.controlPoints = controlPoints;
-    s.problem = undefined;
-    s.client = undefined;
-    s.persistence = options.persistence === 'memory' ? 'memory' : 'localStorage';
-    s.appDeviceId = options.deviceId !== undefined;
-    s.chain = Promise.resolve();
-    for (const w of policy.warnings)
-        warnOnce(s, w);
-    // Local mode stores nothing and registers nothing: the id lives for this page only.
-    const identity = config.mode === 'local'
-        ? { deviceId: options.deviceId ?? (0, identity_js_1.mintDeviceId)(), durable: false }
-        : (0, identity_js_1.loadIdentity)(s.persistence, options.deviceId);
-    s.identity = identity;
-    s.currentKey = identity.user ?? identity.deviceId;
-    if (config.mode === 'local')
-        s.log(localLine(config, controlPoints));
-    setState(s, 'INITIALIZING');
-    const base = options.fetch ?? globalThis.fetch?.bind(globalThis);
-    const init = config.mode === 'local'
-        ? (0, index_js_1.initFireweave)({
-            mode: 'local',
-            local: { controlPoints: (0, control_points_js_1.toLocalControlPoints)(controlPoints), log: (line) => s.log(line) },
-            context: { targetingKey: s.currentKey },
-        })
-        : (0, index_js_1.initFireweave)({
-            mode: 'remote',
-            apiKey: config.key,
-            apiUrl: config.url,
-            ...(config.allowedHosts !== undefined ? { allowedHosts: config.allowedHosts } : {}),
-            ...(base !== undefined ? { fetch: observedFetch(s, generation, base, config) } : {}),
-            context: { targetingKey: s.currentKey },
-        });
-    s.ready = init.then((client) => {
-        if (s.generation !== generation) {
-            void client.shutdown();
-            return;
-        }
-        s.client = client;
-        s.detachRuntime = client.runtime.onStateChange((state) => {
-            if (s.generation === generation)
-                setState(s, fromLifecycle(state), true);
-        });
-        setState(s, fromLifecycle(client.runtime.getState()));
-        registerDevice(s, generation);
-    }, () => {
-        if (s.generation !== generation)
-            return;
-        s.problem = { reason: 'start-failed' };
-        errorOnce(s, '[fireweave] start failed: the core rejected the configuration. FireWeave is not running; reads serve their defaults.');
-        setState(s, 'FAILED');
-    });
-    return s.ready;
-}
-function currentStatus() {
-    const s = slot();
-    const c = s.config;
-    const active = s.state !== 'NOT_STARTED' && s.state !== 'FAILED';
-    return {
-        state: s.state,
-        channel: build_info_js_1.SDK_CHANNEL,
-        sdkVersion: build_info_js_1.SDK_VERSION,
-        ...(c !== undefined && active
-            ? {
-                mode: c.mode,
-                modeSource: c.modeSource,
-                keySource: c.keySource,
-                controlPointCount: Object.keys(s.controlPoints).length,
-                ...(c.url !== undefined && c.urlSource !== undefined ? { host: new URL(c.url).hostname, endpointSource: c.urlSource } : {}),
-                ...(c.environment !== undefined ? { environment: c.environment } : {}),
-            }
-            : {}),
-        ...(s.problem !== undefined ? { problem: s.problem } : {}),
-    };
-}
-/** Switch storage at runtime, for consent. Never part of the start() configuration check. */
-function setPersistenceFor(mode) {
-    const s = slot();
-    if (mode !== 'localStorage' && mode !== 'memory')
-        return;
-    const previous = s.persistence;
-    s.persistence = mode;
-    if (s.identity === undefined || s.config?.mode !== 'remote' || previous === mode)
-        return;
-    if (mode === 'memory') {
-        (0, identity_js_1.clearStoredIdentity)();
-        return;
-    }
-    const user = s.currentKey !== s.identity.deviceId ? s.currentKey : undefined;
-    s.identity.durable = (0, identity_js_1.persistIdentity)(s.identity, user, s.appDeviceId);
-    registerDevice(s, s.generation);
-}
-/** Store (or clear) the signed-in key, when persistence allows it. */
-function rememberUser(s, user) {
-    if (s.config?.mode !== 'remote' || s.persistence !== 'localStorage')
-        return;
-    if (user === undefined)
-        (0, identity_js_1.removeItem)(names_js_1.STORAGE_KEYS.identity);
-    else
-        (0, identity_js_1.writeItem)(names_js_1.STORAGE_KEYS.identity, user);
-}
-async function shutdownSlot() {
-    const s = slot();
-    await s.ready;
-    const client = s.client;
-    s.generation += 1;
-    s.detachRuntime?.();
-    s.client = undefined;
-    s.fingerprint = undefined;
-    s.ready = Promise.resolve();
-    setState(s, 'SHUTDOWN');
-    if (client !== undefined)
-        await client.shutdown();
-}
-/** Test only: shut down and forget the singleton so the next start() begins fresh. */
-async function resetForTests() {
-    const g = globalThis;
-    const s = g[SLOT_KEY];
-    if (s !== undefined) {
-        s.generation += 1;
-        s.detachRuntime?.();
-        if (s.client !== undefined)
-            await s.client.shutdown().catch(() => undefined);
-    }
-    delete g[SLOT_KEY];
-}
-const notStartedError = (state) => new index_js_1.FireweaveError(state === 'FAILED' ? 'Configuration' : state === 'SHUTDOWN' ? 'AlreadyClosed' : 'NotReady');
-exports.notStartedError = notStartedError;