@nebulr-group/bridge-auth-core 0.1.2 → 0.4.0-beta.0

package/dist/flags/realtime.js

@@ -0,0 +1,504 @@
+// SDK realtime client (TBP-150).
+//
+// Auto-discovers the workspace's pub/sub protocol from `GET /realtime/config`
+// (TBP-147), authorizes via `POST /realtime/authorize` (TBP-151), and connects
+// to receive live flag updates + per-user identity changes.
+//
+// Two protocols, one shape:
+//   - `centrifugo`: WebSocket to a Centrifugo server using a signed connect token
+//   - `appsync`: planned (TBP-148); not implemented here
+//
+// `noop` server-side → realtime is disabled; the SDK falls back to periodic
+// poll or simply doesn't get live updates.
+//
+// Messages received on the workspace channel update the BridgeFlags cache
+// (`upsert` / `remove`). Per-user channel messages are handled via callbacks
+// the framework SDK supplies (token refresh, attribute changes — see TBP-90).
+export class RealtimeClient {
+    cfg;
+    ws;
+    state = 'idle';
+    reconnectDelayMs;
+    reconnectTimer;
+    bridge;
+    onUserStateHook;
+    onSubscriptionPlanChangedHook;
+    onBillingLifecycleHook;
+    onQuotaUpdatedHook;
+    onEntitlementsChangedHook;
+    // Phase 3 (TBP-287/314) — fans `session.snapshot` out to whichever slices
+    // the consumer has wired (app.branding, tenant.subscription, etc.).
+    onSnapshotHook;
+    onOpenHook;
+    onCloseHook;
+    stopped = false;
+    constructor(cfg) {
+        const defaultWs = ((url, protocols) => 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        new globalThis.WebSocket(url, protocols));
+        this.cfg = {
+            apiBaseUrl: cfg.apiBaseUrl.replace(/\/+$/, ''),
+            apiKey: cfg.apiKey,
+            appId: cfg.appId,
+            workspaceId: cfg.workspaceId,
+            userId: cfg.userId,
+            enabled: cfg.enabled !== false,
+            reconnectBaseMs: cfg.reconnectBaseMs ?? 1000,
+            reconnectMaxMs: cfg.reconnectMaxMs ?? 30_000,
+            websocketFactory: cfg.websocketFactory ?? defaultWs,
+            fetchFn: cfg.fetchFn ?? (typeof fetch !== 'undefined' ? fetch : undefined),
+            getAuthToken: cfg.getAuthToken,
+        };
+        this.reconnectDelayMs = this.cfg.reconnectBaseMs;
+    }
+    /** Attach to a BridgeFlags instance — flag updates auto-apply to its cache. */
+    attach(bridge) {
+        this.bridge = bridge;
+    }
+    /** Register a hook for per-user channel messages. */
+    setOnUserState(hook) {
+        this.onUserStateHook = hook;
+    }
+    /**
+     * Billing 2.0 US-3 — register a hook for canonical subscription plan-change
+     * events. The billing reactive surface (`BridgeSubscription.attach(rt)`)
+     * wires this up; framework SDKs typically don't call it directly.
+     */
+    setOnSubscriptionPlanChanged(hook) {
+        this.onSubscriptionPlanChangedHook = hook;
+    }
+    /**
+     * Billing 2.0 US-5+ — register a hook for all canonical lifecycle events
+     * (payment.*, subscription.*, dunning.*, entitlements.*). `BridgeSubscription.attach(rt)`
+     * wires this; user-level event handlers can also register here via
+     * `useBridge().handle({ "payment.failed": ... })`.
+     */
+    setOnBillingLifecycle(hook) {
+        this.onBillingLifecycleHook = hook;
+    }
+    /**
+     * Billing 2.0 US-11 — register a hook for `quota.updated` payloads on the
+     * workspace channel. `useBridge().quota(metric)` consumers wire this up
+     * so live counter UI reflects server-side ingest without polling.
+     */
+    setOnQuotaUpdated(hook) {
+        this.onQuotaUpdatedHook = hook;
+    }
+    /**
+     * Billing 2.0 US-12 — register a hook for `entitlements.changed` payloads
+     * on the workspace channel that carry the full entitlements map.
+     * `useBridge().entitlements.can(...)` consumers wire this up so the cache
+     * replaces wholesale on every diff.
+     *
+     * Note: the legacy `BillingLifecycleMessage` `entitlements.changed` kind
+     * (signal-only, no payload) keeps firing through `setOnBillingLifecycle`
+     * — this hook ONLY fires when the wire payload includes the `entitlements`
+     * field. Allows both old and new consumers to coexist during rollout.
+     */
+    setOnEntitlementsChanged(hook) {
+        this.onEntitlementsChangedHook = hook;
+    }
+    /**
+     * Phase 3 (TBP-287/314) — register a hook for `session.snapshot`. The server
+     * publishes one on every successful per-user channel subscribe (initial
+     * connect AND reconnect). Framework SDKs use this to pre-populate the
+     * `bridge.app.branding` / `bridge.tenant.{subscription,entitlements}` /
+     * `bridge.user` slices on first paint, eliminating the per-slice REST
+     * hydrate round-trips that the legacy bootstrap path required.
+     *
+     * Composition is fixed (no consumer config). If a later release promotes
+     * another slice into the snapshot, that slice's `.load()` becomes a no-op
+     * automatically — consumers don't need code changes.
+     */
+    setOnSnapshot(hook) {
+        this.onSnapshotHook = hook;
+    }
+    /**
+     * Register a hook fired when the WebSocket transitions to `'open'` —
+     * fires on initial connect AND on every successful reconnect. Framework
+     * SDKs use this to re-fire startup tasks (e.g. cache hydration) that
+     * may have been missed during an outage.
+     */
+    setOnOpen(hook) {
+        this.onOpenHook = hook;
+    }
+    /**
+     * Register a hook fired when the WebSocket transitions to `'closed'` —
+     * use for surfacing connection status to consumers (e.g. an "offline"
+     * indicator). Fires on intentional close as well; check `getState()`
+     * if you need to distinguish.
+     */
+    setOnClose(hook) {
+        this.onCloseHook = hook;
+    }
+    /**
+     * Re-run the authorize step against the current `getAuthToken()` value and
+     * re-open the WebSocket. Used by the framework SDK on every token rotation
+     * where the userId is unchanged but the JWT value rotated (post-refresh).
+     *
+     * Without this, the existing connection keeps riding the OLD token until
+     * Centrifugo's own connection-token TTL drops it — a strictly-larger
+     * blast-radius window than necessary.
+     *
+     * Behavior:
+     *  - Disabled / stopped → no-op.
+     *  - Mid-`connecting` → no-op; the in-flight authorize() reads the current
+     *    token by closure, so it will already pick up the new value.
+     *  - Open → drop the ws ref (so the old socket's onclose treats itself as
+     *    stale via the identity guard in `openWebSocket`), close it with
+     *    `1000 / sdk.reauthorize`, reset backoff, then `start()` immediately.
+     */
+    async reauthorize() {
+        if (!this.cfg.enabled || this.stopped)
+            return;
+        if (this.state === 'connecting')
+            return;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        this.reconnectDelayMs = this.cfg.reconnectBaseMs;
+        if (this.state === 'open' && this.ws) {
+            const oldWs = this.ws;
+            this.ws = undefined;
+            this.state = 'closed';
+            try {
+                oldWs.close(1000, 'sdk.reauthorize');
+            }
+            catch {
+                // ignore
+            }
+        }
+        await this.start();
+    }
+    /**
+     * Phase 2 (TBP-307) — Set/update the appId after initial start. Framework
+     * SDKs call this when the app context first lands (e.g. after the first
+     * authorize round-trip exposes the JWT `aid` claim). Triggers a reconnect
+     * so the new `app:<appId>` channel is included in the next authorize.
+     */
+    setAppId(appId) {
+        if (this.cfg.appId === appId)
+            return;
+        this.cfg.appId = appId;
+        if (this.state === 'open' && this.ws) {
+            this.ws.close(1000, 'sdk.setAppId');
+            // onclose → scheduleReconnect → start() picks up updated channelsToSubscribe()
+        }
+    }
+    /**
+     * Phase 2 (TBP-307) — Set/update the workspaceId after initial start. Used
+     * by framework SDKs when the tenant context lands or changes (workspace
+     * switcher, tenant join/leave). Triggers a reconnect.
+     */
+    setWorkspaceId(workspaceId) {
+        if (this.cfg.workspaceId === workspaceId)
+            return;
+        this.cfg.workspaceId = workspaceId;
+        if (this.state === 'open' && this.ws) {
+            this.ws.close(1000, 'sdk.setWorkspaceId');
+        }
+    }
+    /**
+     * Update the userId after initial start — used by the framework SDK to
+     * subscribe to the per-user channel when the user logs in post-bootstrap.
+     * Triggers a reconnect so the new channel is included in the next authorize.
+     */
+    setUserId(userId) {
+        if (this.cfg.userId === userId)
+            return;
+        this.cfg.userId = userId;
+        if (this.state === 'open' && this.ws) {
+            this.ws.close(1000, 'sdk.setUserId');
+            // onclose fires → scheduleReconnect → start() picks up updated channelsToSubscribe()
+        }
+    }
+    /** Begin connecting. Idempotent. */
+    async start() {
+        if (!this.cfg.enabled || this.stopped)
+            return;
+        if (this.state !== 'idle' && this.state !== 'closed')
+            return;
+        this.state = 'connecting';
+        try {
+            const serverConfig = await this.fetchServerConfig();
+            if (serverConfig.kind === 'noop' || !serverConfig.endpoint) {
+                this.state = 'closed';
+                return;
+            }
+            if (serverConfig.kind !== 'centrifugo') {
+                // appsync impl is deferred (TBP-148). Silently no-op for now.
+                this.state = 'closed';
+                return;
+            }
+            const channels = this.channelsToSubscribe();
+            const auth = await this.authorize(channels);
+            this.openWebSocket(serverConfig.endpoint, auth);
+        }
+        catch {
+            this.state = 'closed';
+            this.scheduleReconnect();
+        }
+    }
+    /** Close the connection. Idempotent. */
+    async stop() {
+        this.stopped = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.ws) {
+            try {
+                this.ws.close(1000, 'sdk.stop');
+            }
+            catch {
+                // ignore
+            }
+            this.ws = undefined;
+        }
+        this.state = 'closed';
+    }
+    /** Read connection state. */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Channels this client subscribes to — the three canonical channels:
+     *   - `app:<appId>`           — flag mutations, app config (app-scoped)
+     *   - `workspace:<wsId>`      — subscription, quota, entitlement (tenant-scoped)
+     *   - `user:<userId>`         — user-state, role/attr change (user-scoped)
+     *
+     * Each id is optional; the SDK skips the channel if its id isn't configured.
+     * The anonymous-only standalone case ends up with just `app:<appId>`.
+     */
+    channelsToSubscribe() {
+        const out = [];
+        if (this.cfg.appId)
+            out.push(`app:${this.cfg.appId}`);
+        if (this.cfg.workspaceId)
+            out.push(`workspace:${this.cfg.workspaceId}`);
+        if (this.cfg.userId)
+            out.push(`user:${this.cfg.userId}`);
+        return out;
+    }
+    // ── private ───────────────────────────────────────────────────────────────
+    async fetchServerConfig() {
+        const res = await this.cfg.fetchFn(`${this.cfg.apiBaseUrl}/realtime/config`, {
+            method: 'GET',
+            headers: { 'x-api-key': this.cfg.apiKey },
+        });
+        if (!res.ok) {
+            throw new Error(`realtime config fetch failed: ${res.status}`);
+        }
+        return (await res.json());
+    }
+    async authorize(channels) {
+        const token = this.cfg.getAuthToken?.() ?? this.cfg.apiKey;
+        const res = await this.cfg.fetchFn(`${this.cfg.apiBaseUrl}/realtime/authorize`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ channels }),
+        });
+        if (!res.ok) {
+            throw new Error(`realtime authorize failed: ${res.status}`);
+        }
+        return (await res.json());
+    }
+    openWebSocket(endpoint, auth) {
+        const ws = this.cfg.websocketFactory(endpoint);
+        this.ws = ws;
+        ws.onopen = () => {
+            if (this.ws !== ws)
+                return;
+            this.state = 'open';
+            this.reconnectDelayMs = this.cfg.reconnectBaseMs;
+            // Send connect with the signed token + channels. Centrifugo expects a
+            // command frame like `{ "connect": { "token": "..." }, "id": 1 }` and
+            // separate subscribe frames per channel. For v1 we send one connect
+            // and let the server-side token's `channels` claim handle subscription.
+            try {
+                ws.send(JSON.stringify({ id: 1, connect: { token: auth.signedToken } }));
+            }
+            catch {
+                // ignore
+            }
+            try {
+                this.onOpenHook?.();
+            }
+            catch {
+                // hook errors must not break the connection
+            }
+        };
+        ws.onmessage = (ev) => {
+            if (this.ws !== ws)
+                return;
+            // Centrifugo v5 JSON protocol keepalive: the server periodically sends
+            // an empty `{}` frame and expects an empty `{}` reply. Without this
+            // echo the server closes the connection on its pong-timeout and the
+            // SDK ends up in a perpetual reconnect loop.
+            if (typeof ev.data === 'string' && ev.data === '{}') {
+                try {
+                    ws.send('{}');
+                }
+                catch {
+                    // ignore — onclose will pick up a broken socket
+                }
+                return;
+            }
+            try {
+                const parsed = parseMessage(ev.data);
+                if (parsed)
+                    this.handleMessage(parsed);
+            }
+            catch {
+                // ignore malformed
+            }
+        };
+        ws.onclose = () => {
+            // Identity guard — if we've already replaced this ws (e.g. via
+            // reauthorize() dropping the ref before close), the late-firing onclose
+            // is from a stale socket. Don't flap state or fire hooks.
+            if (this.ws !== ws)
+                return;
+            this.state = 'closed';
+            try {
+                this.onCloseHook?.();
+            }
+            catch {
+                // hook errors must not block reconnect scheduling
+            }
+            this.scheduleReconnect();
+        };
+        ws.onerror = () => {
+            // Let onclose handle reconnect — errors are noisy but not actionable.
+        };
+    }
+    handleMessage(msg) {
+        switch (msg.kind) {
+            case 'flag.updated':
+                if (this.bridge && msg.flag)
+                    this.bridge.upsert(msg.flag);
+                break;
+            case 'flag.removed':
+                if (this.bridge && msg.key)
+                    this.bridge.remove(msg.key);
+                break;
+            case 'user.state_changed':
+                if (this.onUserStateHook) {
+                    try {
+                        this.onUserStateHook(msg);
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                break;
+            case 'subscription.plan_changed':
+                if (this.onSubscriptionPlanChangedHook) {
+                    try {
+                        this.onSubscriptionPlanChangedHook(msg);
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                break;
+            case 'payment.failed':
+            case 'payment.succeeded':
+            case 'subscription.created':
+            case 'subscription.updated':
+            case 'subscription.canceled':
+            case 'subscription.reactivated':
+            case 'subscription.trial_started':
+            case 'subscription.trial_ending_soon':
+            case 'subscription.trial_converted':
+            case 'subscription.trial_expired':
+            case 'dunning.entered':
+            case 'dunning.retry_scheduled':
+            case 'dunning.recovered':
+            case 'dunning.exhausted':
+                if (this.onBillingLifecycleHook) {
+                    try {
+                        this.onBillingLifecycleHook(msg);
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                break;
+            case 'entitlements.changed':
+                // bridge-api always publishes the payload-carrying shape (US-12);
+                // the pre-prod signal-only fallback was removed at milestone close-out.
+                if (this.onEntitlementsChangedHook) {
+                    try {
+                        this.onEntitlementsChangedHook(msg);
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                break;
+            case 'quota.updated':
+                if (this.onQuotaUpdatedHook) {
+                    try {
+                        this.onQuotaUpdatedHook(msg);
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                break;
+            case 'session.snapshot':
+                // Phase 3 (TBP-287/314) — first-paint snapshot. Defensive check on
+                // `data` because the wire shape is deeper than the other kinds and
+                // a partial server might omit it; we never want to call the hook
+                // with `undefined`.
+                if (this.onSnapshotHook && msg.data) {
+                    try {
+                        this.onSnapshotHook(msg);
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                break;
+        }
+    }
+    scheduleReconnect() {
+        if (this.stopped)
+            return;
+        if (this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            this.reconnectDelayMs = Math.min(this.reconnectDelayMs * 2, this.cfg.reconnectMaxMs);
+            void this.start();
+        }, this.reconnectDelayMs);
+        if (this.reconnectTimer?.unref)
+            this.reconnectTimer.unref();
+    }
+}
+function parseMessage(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    // Centrifugo wraps publish data in `{ push: { channel, pub: { data: {...} } } }`.
+    // We accept both that shape and a flat `{ kind: ... }` shape so the same
+    // client works with simpler transports too.
+    const data = parsed?.push?.pub?.data ??
+        parsed?.pub?.data ??
+        parsed;
+    if (!data || typeof data !== 'object' || typeof data.kind !== 'string')
+        return null;
+    return data;
+}
+//# sourceMappingURL=realtime.js.map

package/dist/flags/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/flags/realtime.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,4DAA4D;AAC5D,EAAE;AACF,4BAA4B;AAC5B,kFAAkF;AAClF,yDAAyD;AACzD,EAAE;AACF,4EAA4E;AAC5E,2CAA2C;AAC3C,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAuO9E,MAAM,OAAO,cAAc;IACR,GAAG,CASlB;IACM,EAAE,CAAiB;IACnB,KAAK,GAAoB,MAAM,CAAC;IAChC,gBAAgB,CAAS;IACzB,cAAc,CAAiC;IAC/C,MAAM,CAAe;IACrB,eAAe,CAAmC;IAClD,6BAA6B,CAAiD;IAC9E,sBAAsB,CAA0C;IAChE,kBAAkB,CAAsC;IACxD,yBAAyB,CAA6C;IAC9E,0EAA0E;IAC1E,oEAAoE;IAC5D,cAAc,CAAyC;IACvD,UAAU,CAAc;IACxB,WAAW,CAAc;IACzB,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,GAAyB;QACnC,MAAM,SAAS,GAAG,CAAC,CAAC,GAAW,EAAE,SAA6B,EAAE,EAAE;QAChE,8DAA8D;QAC9D,IAAK,UAAkB,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAGjC,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG;YACT,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK;YAC9B,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,IAAI;YAC5C,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,MAAM;YAC5C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,IAAI,SAAS;YACnD,OAAO,EAAE,GAAG,CAAC,OAAO,IAAK,CAAC,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAkB;YAC5F,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC;IACnD,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,MAAmB;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,qDAAqD;IACrD,cAAc,CAAC,IAAqC;QAClD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,4BAA4B,CAAC,IAAmD;QAC9E,IAAI,CAAC,6BAA6B,GAAG,IAAI,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,IAA4C;QAChE,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,IAAwC;QACxD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;IACjC,CAAC;IAED;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,IAA+C;QACtE,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,IAA2C;QACvD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAgB;QACxB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAgB;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY;YAAE,OAAO;QACxC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAClC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC;QACjD,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;YACpB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC;gBACH,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAyB;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO;QACrC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACpC,+EAA+E;QACjF,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,WAA+B;QAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,WAAW;YAAE,OAAO;QACjD,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;QACnC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,MAA0B;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO;QACvC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YACrC,qFAAqF;QACvF,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO;QAE7D,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpD,IAAI,YAAY,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;gBAC3D,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,IAAI,YAAY,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACvC,8DAA8D;gBAC9D,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAClC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAClC,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;IACxB,CAAC;IAED,6BAA6B;IAC7B,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,mBAAmB;QACjB,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,iBAAiB;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,kBAAkB,EAAE;YAC3E,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE;SAC1C,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyB,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,QAAkB;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,qBAAqB,EAAE;YAC9E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,KAAK,EAAE;gBAChC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;IACjD,CAAC;IAEO,aAAa,CAAC,QAAgB,EAAE,IAAuB;QAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;YACf,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;gBAAE,OAAO;YAC3B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC;YACjD,sEAAsE;YACtE,sEAAsE;YACtE,oEAAoE;YACpE,wEAAwE;YACxE,IAAI,CAAC;gBACH,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC,CAAC;QACF,EAAE,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE;YACpB,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;gBAAE,OAAO;YAC3B,uEAAuE;YACvE,oEAAoE;YACpE,oEAAoE;YACpE,6CAA6C;YAC7C,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACpD,IAAI,CAAC;oBACH,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;gBAAC,MAAM,CAAC;oBACP,gDAAgD;gBAClD,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,MAAM;oBAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB;YACrB,CAAC;QACH,CAAC,CAAC;QACF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;YAChB,+DAA+D;YAC/D,wEAAwE;YACxE,0DAA0D;YAC1D,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;gBAAE,OAAO;YAC3B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC;gBACH,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,kDAAkD;YACpD,CAAC;YACD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC,CAAC;QACF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;YAChB,sEAAsE;QACxE,CAAC,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,GAAoB;QACxC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,cAAc;gBACjB,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI;oBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1D,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG;oBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxD,MAAM;YACR,KAAK,oBAAoB;gBACvB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBACzB,IAAI,CAAC;wBACH,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;oBAC5B,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,KAAK,2BAA2B;gBAC9B,IAAI,IAAI,CAAC,6BAA6B,EAAE,CAAC;oBACvC,IAAI,CAAC;wBACH,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,CAAC;oBAC1C,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,KAAK,gBAAgB,CAAC;YACtB,KAAK,mBAAmB,CAAC;YACzB,KAAK,sBAAsB,CAAC;YAC5B,KAAK,sBAAsB,CAAC;YAC5B,KAAK,uBAAuB,CAAC;YAC7B,KAAK,0BAA0B,CAAC;YAChC,KAAK,4BAA4B,CAAC;YAClC,KAAK,gCAAgC,CAAC;YACtC,KAAK,8BAA8B,CAAC;YACpC,KAAK,4BAA4B,CAAC;YAClC,KAAK,iBAAiB,CAAC;YACvB,KAAK,yBAAyB,CAAC;YAC/B,KAAK,mBAAmB,CAAC;YACzB,KAAK,mBAAmB;gBACtB,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;oBAChC,IAAI,CAAC;wBACH,IAAI,CAAC,sBAAsB,CAAC,GAA8B,CAAC,CAAC;oBAC9D,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,KAAK,sBAAsB;gBACzB,kEAAkE;gBAClE,wEAAwE;gBACxE,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;oBACnC,IAAI,CAAC;wBACH,IAAI,CAAC,yBAAyB,CAAC,GAAiC,CAAC,CAAC;oBACpE,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,KAAK,eAAe;gBAClB,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBAC5B,IAAI,CAAC;wBACH,IAAI,CAAC,kBAAkB,CAAC,GAA0B,CAAC,CAAC;oBACtD,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,KAAK,kBAAkB;gBACrB,mEAAmE;gBACnE,mEAAmE;gBACnE,iEAAiE;gBACjE,oBAAoB;gBACpB,IAAI,IAAI,CAAC,cAAc,IAAK,GAA8B,CAAC,IAAI,EAAE,CAAC;oBAChE,IAAI,CAAC;wBACH,IAAI,CAAC,cAAc,CAAC,GAA6B,CAAC,CAAC;oBACrD,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,MAAM;QACV,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO;QAChC,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;YACpC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACrF,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC1B,IAAK,IAAI,CAAC,cAAsB,EAAE,KAAK;YAAG,IAAI,CAAC,cAAsB,CAAC,KAAK,EAAE,CAAC;IAChF,CAAC;CACF;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,kFAAkF;IAClF,yEAAyE;IACzE,4CAA4C;IAC5C,MAAM,IAAI,GACR,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;QACvB,MAAM,EAAE,GAAG,EAAE,IAAI;QACjB,MAAM,CAAC;IACT,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,IAAuB,CAAC;AACjC,CAAC"}

package/dist/flags/runtime-mode.d.ts

@@ -0,0 +1,32 @@
+export type BridgeRuntimeMode = 'channel' | 'pull';
+export interface PullCacheOptions {
+    /** TTL for cached values in ms. Default 30000 (30s). */
+    ttlMs?: number;
+    /** Optional override for the default "now" clock — useful in tests. */
+    now?: () => number;
+}
+/**
+ * Tiny TTL-bounded read cache for pull-mode SDKs.
+ *
+ * Semantics:
+ *   - `get(key, fetcher)` returns the cached value if not expired; otherwise
+ *     awaits `fetcher()` to populate and returns the fresh value.
+ *   - Concurrent `get(key, ...)` calls share the in-flight promise (no
+ *     thundering-herd against the upstream REST endpoint).
+ *   - `invalidate(key?)` clears a specific key or the entire cache.
+ *
+ * Best-effort: a fetcher rejection clears the in-flight promise so the next
+ * `get()` retries instead of returning a stale value forever.
+ */
+export declare class BridgePullCache {
+    private readonly _entries;
+    private readonly _ttlMs;
+    private readonly _now;
+    constructor(opts?: PullCacheOptions);
+    get<T>(key: string, fetcher: () => Promise<T>): Promise<T>;
+    /** Force a re-fetch on the next get(). Pass no args to clear all keys. */
+    invalidate(key?: string): void;
+    /** Number of cached entries currently held (test/diagnostic). */
+    size(): number;
+}
+//# sourceMappingURL=runtime-mode.d.ts.map

package/dist/flags/runtime-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mode.d.ts","sourceRoot":"","sources":["../../src/flags/runtime-mode.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAQD;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAExB,IAAI,CAAC,EAAE,gBAAgB;IAK7B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BhE,0EAA0E;IAC1E,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9B,iEAAiE;IACjE,IAAI,IAAI,MAAM;CAGf"}

package/dist/flags/runtime-mode.js

@@ -0,0 +1,84 @@
+// Phase 6 (TBP-290/340) — runtime-mode abstraction.
+//
+// `BridgeRuntimeMode` is orthogonal to `BridgeFlagsMode` (which governs the
+// flag-eval semantics on backend vs frontend). Runtime mode governs HOW the
+// SDK stays fresh:
+//
+//   'channel' — open a WebSocket and consume push events (live updates).
+//               Use for long-running processes: SvelteKit SSR servers, NestJS
+//               services, Express APIs serving many users from one process.
+//
+//   'pull'    — never open a WebSocket. Every read may hit REST with a small
+//               TTL cache to deduplicate close-in-time reads. Use for
+//               ephemeral runtimes: cron jobs, serverless functions, webhook
+//               handlers, CLI scripts.
+//
+// In 'pull' mode `bridge.events.handle()` is a no-op (push events don't exist
+// — for server-side event reactions, use Bridge webhooks instead).
+//
+// In 'channel' mode `bridge.refresh()` is supported but rarely needed (the
+// channel keeps state fresh automatically); in 'pull' mode `bridge.refresh()`
+// explicitly invalidates the cache so the next read re-fetches.
+/**
+ * Tiny TTL-bounded read cache for pull-mode SDKs.
+ *
+ * Semantics:
+ *   - `get(key, fetcher)` returns the cached value if not expired; otherwise
+ *     awaits `fetcher()` to populate and returns the fresh value.
+ *   - Concurrent `get(key, ...)` calls share the in-flight promise (no
+ *     thundering-herd against the upstream REST endpoint).
+ *   - `invalidate(key?)` clears a specific key or the entire cache.
+ *
+ * Best-effort: a fetcher rejection clears the in-flight promise so the next
+ * `get()` retries instead of returning a stale value forever.
+ */
+export class BridgePullCache {
+    _entries = new Map();
+    _ttlMs;
+    _now;
+    constructor(opts) {
+        this._ttlMs = opts?.ttlMs ?? 30_000;
+        this._now = opts?.now ?? (() => Date.now());
+    }
+    async get(key, fetcher) {
+        const existing = this._entries.get(key);
+        if (existing) {
+            if (existing.inflight)
+                return existing.inflight;
+            if (existing.expiresAt > this._now())
+                return existing.value;
+        }
+        const inflight = fetcher()
+            .then((v) => {
+            this._entries.set(key, {
+                value: v,
+                expiresAt: this._now() + this._ttlMs,
+            });
+            return v;
+        })
+            .catch((err) => {
+            // Clear so the next call retries instead of returning stale forever.
+            this._entries.delete(key);
+            throw err;
+        });
+        this._entries.set(key, {
+            value: existing?.value,
+            expiresAt: 0,
+            inflight,
+        });
+        return inflight;
+    }
+    /** Force a re-fetch on the next get(). Pass no args to clear all keys. */
+    invalidate(key) {
+        if (key === undefined) {
+            this._entries.clear();
+            return;
+        }
+        this._entries.delete(key);
+    }
+    /** Number of cached entries currently held (test/diagnostic). */
+    size() {
+        return this._entries.size;
+    }
+}
+//# sourceMappingURL=runtime-mode.js.map

package/dist/flags/runtime-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mode.js","sourceRoot":"","sources":["../../src/flags/runtime-mode.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,mBAAmB;AACnB,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAC5E,EAAE;AACF,6EAA6E;AAC7E,sEAAsE;AACtE,6EAA6E;AAC7E,uCAAuC;AACvC,EAAE;AACF,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,gEAAgE;AAiBhE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAClD,MAAM,CAAS;IACf,IAAI,CAAe;IAEpC,YAAY,IAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,KAAK,IAAI,MAAM,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,OAAyB;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAA8B,CAAC;QACrE,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,QAAQ;gBAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;YAChD,IAAI,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC;QAC9D,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,EAAE;aACvB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM;aACrC,CAAC,CAAC;YACH,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,qEAAqE;YACrE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE;YACrB,KAAK,EAAE,QAAQ,EAAE,KAAU;YAC3B,SAAS,EAAE,CAAC;YACZ,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0EAA0E;IAC1E,UAAU,CAAC,GAAY;QACrB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,iEAAiE;IACjE,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}