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

package/dist/billing/bridge-subscription.d.ts

@@ -0,0 +1,71 @@
+import type { Logger } from '../logger.js';
+import type { RealtimeClient, SubscriptionPlanChangedMessage } from '../flags/realtime.js';
+import type { BillingLockedPayload, BillingSubscriptionSnapshot, BillingSubscriptionState, MountOptions } from './types.js';
+type Listener = (snapshot: BillingSubscriptionSnapshot) => void;
+/**
+ * Reactive container for the canonical Billing 2.0 subscription state.
+ * Framework-agnostic; consumers attach a listener via `subscribe()` and read
+ * the current value via `snapshot()`. Compatible with the Svelte store
+ * contract (`subscribe(listener) => unsubscribe`).
+ *
+ * Parallel to the FF 2.0 `BridgeFlags` reactive surface — do NOT unify yet.
+ * REF-1 (post-feature) will fold them together.
+ */
+export declare class BridgeSubscription {
+    private _state;
+    private _loading;
+    private _error;
+    private _listeners;
+    /** Current snapshot. */
+    snapshot(): BillingSubscriptionSnapshot;
+    /**
+     * Subscribe to snapshot changes. Invokes the listener immediately with the
+     * current snapshot (Svelte-store compatible). Returns an unsubscribe fn.
+     */
+    subscribe(listener: Listener): () => void;
+    /** Replace the cached state and notify subscribers. */
+    hydrate(state: BillingSubscriptionState): void;
+    setLoading(loading: boolean): void;
+    setError(error: string | null): void;
+    /**
+     * Fetch `GET /billing/state` once and hydrate. Idempotent on success — the
+     * SDK caches the result in memory and any subsequent `mount()` call is
+     * effectively a manual refetch. US-3 adds the live push that updates the
+     * cache without a refetch.
+     *
+     * HTTP is intentionally inside auth-core here (per US-2 AC) so framework
+     * wrappers don't each reimplement the fetch.
+     */
+    mount(opts: MountOptions, logger?: Logger): Promise<void>;
+    /**
+     * Flip the store into the locked state from a caught `BillingLockedError`.
+     * Patches `gateEngaged`/`status`/`recoveryUrl` so the notice + gate react
+     * immediately even when no prior `mount()` baseline exists.
+     */
+    markLocked(payload: BillingLockedPayload): void;
+    /**
+     * Billing 2.0 — attach to a Milestone K RealtimeClient so canonical
+     * lifecycle events on the workspace channel patch the reactive store.
+     * Handles US-3 plan-change + US-4+ lifecycle (payment.*, subscription.*,
+     * dunning.*, entitlements.*). Idempotent: re-attaching replaces hooks.
+     * Framework SDKs call this once after constructing both the RealtimeClient
+     * and the BridgeSubscription instance.
+     */
+    attach(rt: RealtimeClient): void;
+    /**
+     * TBP-360 — Hydrate from a `subscription.plan_changed` push. Extracted into
+     * a public-but-internal method so `useBridge().attachToRealtimeClient` can
+     * install a composite hook (subscription hydrate + dev-handler fan-out)
+     * without re-implementing the patch logic.
+     */
+    _applyPlanChanged(msg: SubscriptionPlanChangedMessage): void;
+    /**
+     * Patch the snapshot based on a lifecycle event. Conservative — only
+     * touches the fields the event semantically affects. Callers can still
+     * trigger a full refetch via `mount(opts)` to re-sync from the server.
+     */
+    private _applyLifecycle;
+    private _notify;
+}
+export {};
+//# sourceMappingURL=bridge-subscription.d.ts.map

package/dist/billing/bridge-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-subscription.d.ts","sourceRoot":"","sources":["../../src/billing/bridge-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAEV,cAAc,EACd,8BAA8B,EAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EAExB,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,KAAK,QAAQ,GAAG,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAC;AAQhE;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAuB;IAEzC,wBAAwB;IACxB,QAAQ,IAAI,2BAA2B;IAQvC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAQzC,uDAAuD;IACvD,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI;IAM9C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMlC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKpC;;;;;;;;OAQG;IACG,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,GAAE,MAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3E;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAW/C;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAKhC;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,8BAA8B,GAAG,IAAI;IAO5D;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAwEvB,OAAO,CAAC,OAAO;CAMhB"}

package/dist/billing/bridge-subscription.js

@@ -0,0 +1,209 @@
+import { fetchBillingState } from './fetch-billing-state.js';
+const noopLogger = {
+    debug: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Reactive container for the canonical Billing 2.0 subscription state.
+ * Framework-agnostic; consumers attach a listener via `subscribe()` and read
+ * the current value via `snapshot()`. Compatible with the Svelte store
+ * contract (`subscribe(listener) => unsubscribe`).
+ *
+ * Parallel to the FF 2.0 `BridgeFlags` reactive surface — do NOT unify yet.
+ * REF-1 (post-feature) will fold them together.
+ */
+export class BridgeSubscription {
+    _state = null;
+    _loading = false;
+    _error = null;
+    _listeners = new Set();
+    /** Current snapshot. */
+    snapshot() {
+        return {
+            state: this._state,
+            loading: this._loading,
+            error: this._error,
+        };
+    }
+    /**
+     * Subscribe to snapshot changes. Invokes the listener immediately with the
+     * current snapshot (Svelte-store compatible). Returns an unsubscribe fn.
+     */
+    subscribe(listener) {
+        this._listeners.add(listener);
+        listener(this.snapshot());
+        return () => {
+            this._listeners.delete(listener);
+        };
+    }
+    /** Replace the cached state and notify subscribers. */
+    hydrate(state) {
+        this._state = state;
+        this._error = null;
+        this._notify();
+    }
+    setLoading(loading) {
+        if (this._loading === loading)
+            return;
+        this._loading = loading;
+        this._notify();
+    }
+    setError(error) {
+        this._error = error;
+        this._notify();
+    }
+    /**
+     * Fetch `GET /billing/state` once and hydrate. Idempotent on success — the
+     * SDK caches the result in memory and any subsequent `mount()` call is
+     * effectively a manual refetch. US-3 adds the live push that updates the
+     * cache without a refetch.
+     *
+     * HTTP is intentionally inside auth-core here (per US-2 AC) so framework
+     * wrappers don't each reimplement the fetch.
+     */
+    async mount(opts, logger = noopLogger) {
+        this.setLoading(true);
+        this.setError(null);
+        try {
+            const state = await fetchBillingState(opts, logger);
+            this.hydrate(state);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to load billing state';
+            this.setError(message);
+        }
+        finally {
+            this.setLoading(false);
+        }
+    }
+    /**
+     * Flip the store into the locked state from a caught `BillingLockedError`.
+     * Patches `gateEngaged`/`status`/`recoveryUrl` so the notice + gate react
+     * immediately even when no prior `mount()` baseline exists.
+     */
+    markLocked(payload) {
+        const current = this._state;
+        const next = current
+            ? { ...current }
+            : { plan: { slug: 'unknown', name: 'Unknown' }, status: payload.billing.status };
+        next.status = payload.billing.status;
+        next.gateEngaged = payload.billing.gateEngaged;
+        if (payload.billing.recoveryUrl)
+            next.recoveryUrl = payload.billing.recoveryUrl;
+        this.hydrate(next);
+    }
+    /**
+     * Billing 2.0 — attach to a Milestone K RealtimeClient so canonical
+     * lifecycle events on the workspace channel patch the reactive store.
+     * Handles US-3 plan-change + US-4+ lifecycle (payment.*, subscription.*,
+     * dunning.*, entitlements.*). Idempotent: re-attaching replaces hooks.
+     * Framework SDKs call this once after constructing both the RealtimeClient
+     * and the BridgeSubscription instance.
+     */
+    attach(rt) {
+        rt.setOnSubscriptionPlanChanged((msg) => this._applyPlanChanged(msg));
+        rt.setOnBillingLifecycle((msg) => this._applyLifecycle(msg));
+    }
+    /**
+     * TBP-360 — Hydrate from a `subscription.plan_changed` push. Extracted into
+     * a public-but-internal method so `useBridge().attachToRealtimeClient` can
+     * install a composite hook (subscription hydrate + dev-handler fan-out)
+     * without re-implementing the patch logic.
+     */
+    _applyPlanChanged(msg) {
+        this.hydrate({
+            plan: msg.to,
+            status: msg.status,
+        });
+    }
+    /**
+     * Patch the snapshot based on a lifecycle event. Conservative — only
+     * touches the fields the event semantically affects. Callers can still
+     * trigger a full refetch via `mount(opts)` to re-sync from the server.
+     */
+    _applyLifecycle(msg) {
+        const current = this._state;
+        if (!current) {
+            // No baseline yet; lifecycle events can't reconstruct a full state
+            // from scratch — they're patches. Skip; consumer should mount first.
+            return;
+        }
+        const next = { ...current };
+        switch (msg.kind) {
+            case 'payment.failed':
+                next.status = 'past_due';
+                next.pastDueReason = msg.pastDueReason ?? 'card_declined';
+                if (msg.cardLast4)
+                    next.cardLast4 = msg.cardLast4;
+                break;
+            case 'payment.succeeded':
+            case 'dunning.recovered':
+                next.status = 'active';
+                next.pastDueReason = null;
+                next.nextRetryAt = undefined;
+                next.finalRetryAt = undefined;
+                next.gateEngaged = false;
+                break;
+            case 'subscription.canceled':
+                next.status = 'canceled';
+                if (msg.endsAt)
+                    next.endsAt = msg.endsAt;
+                break;
+            case 'subscription.reactivated':
+                next.status = 'active';
+                next.endsAt = undefined;
+                break;
+            case 'subscription.trial_started':
+                next.status = 'trial';
+                if (msg.endsAt)
+                    next.endsAt = msg.endsAt;
+                if (msg.daysLeft !== undefined)
+                    next.daysLeft = msg.daysLeft;
+                if (msg.hasCardOnFile !== undefined)
+                    next.hasCardOnFile = msg.hasCardOnFile;
+                break;
+            case 'subscription.trial_ending_soon':
+                if (msg.daysLeft !== undefined)
+                    next.daysLeft = msg.daysLeft;
+                break;
+            case 'subscription.trial_converted':
+                next.status = 'active';
+                next.endsAt = undefined;
+                next.daysLeft = undefined;
+                break;
+            case 'subscription.trial_expired':
+                next.status = 'past_due';
+                next.pastDueReason = 'trial_expired';
+                break;
+            case 'dunning.entered':
+            case 'dunning.retry_scheduled':
+                next.status = 'past_due';
+                if (msg.nextRetryAt)
+                    next.nextRetryAt = msg.nextRetryAt;
+                if (msg.finalRetryAt)
+                    next.finalRetryAt = msg.finalRetryAt;
+                break;
+            case 'dunning.exhausted':
+                next.status = 'past_due';
+                next.gateEngaged = msg.gateEngaged ?? true;
+                break;
+            case 'entitlements.changed':
+                // Pure signal — consumer apps re-read entitlements. No status mutation here.
+                break;
+            case 'subscription.created':
+            case 'subscription.updated':
+                // No-op on the cached snapshot. Mount fetches the full state if the
+                // consumer needs the new values.
+                break;
+        }
+        this.hydrate(next);
+    }
+    _notify() {
+        const snap = this.snapshot();
+        for (const listener of this._listeners) {
+            listener(snap);
+        }
+    }
+}
+//# sourceMappingURL=bridge-subscription.js.map

package/dist/billing/bridge-subscription.js.map

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

package/dist/billing/entitlements-store.d.ts

@@ -0,0 +1,61 @@
+import type { Logger } from '../logger.js';
+/** Public entitlement snapshot shape — a flat boolean map. */
+export type EntitlementSnapshot = Record<string, boolean>;
+type Listener = (snapshot: EntitlementSnapshot) => void;
+interface ConfigureOptions {
+    apiBaseUrl: string;
+    /**
+     * Returns the current Bearer access token, or null when unauthenticated
+     * (hydrate is skipped). Lazy so the wrapper can rotate tokens without
+     * reconfiguring the store.
+     */
+    getAccessToken: () => string | null;
+}
+export declare class EntitlementsStore {
+    private _cache;
+    private _hydrated;
+    private _hydrating;
+    private _subscribers;
+    private _opts;
+    private _logger;
+    /** Wire HTTP options + optional logger. Framework wrappers call this once. */
+    configure(opts: ConfigureOptions, logger?: Logger): void;
+    /** Has the initial REST fetch completed? Drives fail-closed reads. */
+    isHydrated(): boolean;
+    /**
+     * Initial-hydration fetch. Idempotent — concurrent callers share one
+     * round-trip; subsequent calls after success are no-ops unless the caller
+     * explicitly resets. Failures leave the store unhydrated; `can()` keeps
+     * returning false until a live push or a retry succeeds.
+     */
+    hydrate(): Promise<void>;
+    /**
+     * Wholesale-replace the cache from a server-pushed snapshot. The server
+     * publishes the FULL set on every change so the SDK never has to merge
+     * partial deltas — last-write-wins.
+     */
+    applyEntitlementsChanged(snapshot: EntitlementSnapshot): void;
+    /**
+     * Fail-closed read.
+     *   - Before hydration: returns `false`.
+     *   - After hydration with a key NOT in the cache: returns `false`.
+     *   - After hydration with a key in the cache: returns the boolean.
+     *
+     * Consumers gate UX with `{#if bridge.entitlements.can('ai_completions')}`
+     * — fail-closed protects against showing privileged UX on a cold start.
+     */
+    can(name: string): boolean;
+    /** All cached entitlements (shallow copy). */
+    all(): EntitlementSnapshot;
+    /**
+     * Subscribe to snapshot changes. Returns an unsubscribe fn.
+     * Does NOT invoke immediately with the current snapshot — the consumer can
+     * read `all()` synchronously if it needs the initial value.
+     */
+    subscribe(cb: Listener): () => void;
+    /** Test-only: clear cache + listeners. */
+    __resetForTests(): void;
+    private _notify;
+}
+export {};
+//# sourceMappingURL=entitlements-store.d.ts.map

package/dist/billing/entitlements-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements-store.d.ts","sourceRoot":"","sources":["../../src/billing/entitlements-store.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,KAAK,QAAQ,GAAG,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAExD,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACrC;AAQD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAsB;IAErC,8EAA8E;IAC9E,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAE,MAAmB,GAAG,IAAI;IAKpE,sEAAsE;IACtE,UAAU,IAAI,OAAO;IAIrB;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B9B;;;;OAIG;IACH,wBAAwB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAM7D;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B,8CAA8C;IAC9C,GAAG,IAAI,mBAAmB;IAI1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOnC,0CAA0C;IAC1C,eAAe,IAAI,IAAI;IAQvB,OAAO,CAAC,OAAO;CAUhB"}

package/dist/billing/entitlements-store.js

@@ -0,0 +1,127 @@
+// Billing 2.0 US-12 (TBP-264) — SDK entitlement cache + reactive surface.
+//
+// Backs `useBridge().entitlements.can(name)`. Holds the boolean map published
+// by the bridge-api EntitlementService:
+//   - `hydrate()` — `GET /entitlements` once on attach.
+//   - `applyEntitlementsChanged(snapshot)` — replaces cache wholesale on every
+//     `entitlements.changed` push from the workspace channel. Last-write-wins.
+//   - `can(name)` — fail-closed: returns `false` until hydrated and only `true`
+//     when the key is explicitly present and `true`.
+//
+// Framework-agnostic. Subscribers receive a snapshot notification on every
+// cache mutation; the bridge-svelte/react wrappers wire those into reactive
+// containers.
+import { httpFetch } from '../http.js';
+const noopLogger = {
+    debug: () => { },
+    warn: () => { },
+    error: () => { },
+};
+export class EntitlementsStore {
+    _cache = {};
+    _hydrated = false;
+    _hydrating = false;
+    _subscribers = new Set();
+    _opts = null;
+    _logger = noopLogger;
+    /** Wire HTTP options + optional logger. Framework wrappers call this once. */
+    configure(opts, logger = noopLogger) {
+        this._opts = opts;
+        this._logger = logger;
+    }
+    /** Has the initial REST fetch completed? Drives fail-closed reads. */
+    isHydrated() {
+        return this._hydrated;
+    }
+    /**
+     * Initial-hydration fetch. Idempotent — concurrent callers share one
+     * round-trip; subsequent calls after success are no-ops unless the caller
+     * explicitly resets. Failures leave the store unhydrated; `can()` keeps
+     * returning false until a live push or a retry succeeds.
+     */
+    async hydrate() {
+        if (this._hydrated || this._hydrating)
+            return;
+        if (!this._opts)
+            return;
+        const token = this._opts.getAccessToken();
+        if (!token)
+            return;
+        this._hydrating = true;
+        try {
+            const url = `${this._opts.apiBaseUrl.replace(/\/+$/, '')}/entitlements`;
+            const body = await httpFetch(url, {
+                method: 'GET',
+                headers: { Authorization: `Bearer ${token}` },
+            }, this._logger);
+            this._cache = { ...(body?.entitlements ?? {}) };
+            this._hydrated = true;
+            this._notify();
+        }
+        catch (err) {
+            this._logger.warn('[bridge.entitlements] hydrate failed', err instanceof Error ? err.message : err);
+        }
+        finally {
+            this._hydrating = false;
+        }
+    }
+    /**
+     * Wholesale-replace the cache from a server-pushed snapshot. The server
+     * publishes the FULL set on every change so the SDK never has to merge
+     * partial deltas — last-write-wins.
+     */
+    applyEntitlementsChanged(snapshot) {
+        this._cache = { ...snapshot };
+        this._hydrated = true;
+        this._notify();
+    }
+    /**
+     * Fail-closed read.
+     *   - Before hydration: returns `false`.
+     *   - After hydration with a key NOT in the cache: returns `false`.
+     *   - After hydration with a key in the cache: returns the boolean.
+     *
+     * Consumers gate UX with `{#if bridge.entitlements.can('ai_completions')}`
+     * — fail-closed protects against showing privileged UX on a cold start.
+     */
+    can(name) {
+        if (!this._hydrated)
+            return false;
+        return this._cache[name] === true;
+    }
+    /** All cached entitlements (shallow copy). */
+    all() {
+        return { ...this._cache };
+    }
+    /**
+     * Subscribe to snapshot changes. Returns an unsubscribe fn.
+     * Does NOT invoke immediately with the current snapshot — the consumer can
+     * read `all()` synchronously if it needs the initial value.
+     */
+    subscribe(cb) {
+        this._subscribers.add(cb);
+        return () => {
+            this._subscribers.delete(cb);
+        };
+    }
+    /** Test-only: clear cache + listeners. */
+    __resetForTests() {
+        this._cache = {};
+        this._hydrated = false;
+        this._hydrating = false;
+        this._subscribers.clear();
+        this._opts = null;
+    }
+    _notify() {
+        const snap = this.all();
+        for (const cb of this._subscribers) {
+            try {
+                cb(snap);
+            }
+            catch {
+                // ignore — listener errors must not break the cache
+            }
+        }
+    }
+}
+//# sourceMappingURL=entitlements-store.js.map

package/dist/billing/entitlements-store.js.map

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

package/dist/billing/fetch-billing-state.d.ts

@@ -0,0 +1,9 @@
+import type { Logger } from '../logger.js';
+import type { BillingSubscriptionState, MountOptions } from './types.js';
+/**
+ * Pure, isomorphic read of `GET /billing/state`. No store, no realtime — server
+ * plugins (bridge-nextjs) call this directly; the client store's `mount()` wraps
+ * it. A billing-locked workspace throws `BillingLockedError` via the http chokepoint.
+ */
+export declare function fetchBillingState(opts: MountOptions, logger?: Logger): Promise<BillingSubscriptionState>;
+//# sourceMappingURL=fetch-billing-state.d.ts.map

package/dist/billing/fetch-billing-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-billing-state.d.ts","sourceRoot":"","sources":["../../src/billing/fetch-billing-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQzE;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,YAAY,EAClB,MAAM,GAAE,MAAmB,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CAanC"}

package/dist/billing/fetch-billing-state.js

@@ -0,0 +1,22 @@
+import { httpFetch } from '../http.js';
+const noopLogger = {
+    debug: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Pure, isomorphic read of `GET /billing/state`. No store, no realtime — server
+ * plugins (bridge-nextjs) call this directly; the client store's `mount()` wraps
+ * it. A billing-locked workspace throws `BillingLockedError` via the http chokepoint.
+ */
+export async function fetchBillingState(opts, logger = noopLogger) {
+    const url = `${opts.apiBaseUrl}/billing/state`;
+    return httpFetch(url, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${opts.accessToken}`,
+            'x-app-id': opts.appId,
+        },
+    }, logger);
+}
+//# sourceMappingURL=fetch-billing-state.js.map

package/dist/billing/fetch-billing-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-billing-state.js","sourceRoot":"","sources":["../../src/billing/fetch-billing-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC,MAAM,UAAU,GAAW;IACzB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAkB,EAClB,SAAiB,UAAU;IAE3B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,gBAAgB,CAAC;IAC/C,OAAO,SAAS,CACd,GAAG,EACH;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;YAC3C,UAAU,EAAE,IAAI,CAAC,KAAK;SACvB;KACF,EACD,MAAM,CACP,CAAC;AACJ,CAAC"}

package/dist/billing/lock-signal.d.ts

@@ -0,0 +1,6 @@
+import type { BillingLockedPayload } from './types.js';
+type LockHandler = (payload: BillingLockedPayload) => void;
+export declare function setBillingLockHandler(fn: LockHandler | null): void;
+export declare function emitBillingLock(payload: BillingLockedPayload): void;
+export {};
+//# sourceMappingURL=lock-signal.d.ts.map

package/dist/billing/lock-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-signal.d.ts","sourceRoot":"","sources":["../../src/billing/lock-signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMvD,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAI3D,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAElE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAEnE"}

package/dist/billing/lock-signal.js

@@ -0,0 +1,8 @@
+let handler = null;
+export function setBillingLockHandler(fn) {
+    handler = fn;
+}
+export function emitBillingLock(payload) {
+    handler?.(payload);
+}
+//# sourceMappingURL=lock-signal.js.map

package/dist/billing/lock-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-signal.js","sourceRoot":"","sources":["../../src/billing/lock-signal.ts"],"names":[],"mappings":"AAQA,IAAI,OAAO,GAAuB,IAAI,CAAC;AAEvC,MAAM,UAAU,qBAAqB,CAAC,EAAsB;IAC1D,OAAO,GAAG,EAAE,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA6B;IAC3D,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/dist/billing/quota-store.d.ts

@@ -0,0 +1,86 @@
+import type { Logger } from '../logger.js';
+import type { QuotaUpdatedMessage, RealtimeClient } from '../flags/realtime.js';
+/** Public quota snapshot shape exposed to SDK consumers. */
+export interface QuotaSnapshot {
+    metric: string;
+    used: number;
+    limit: number;
+    remaining: number;
+    /** Convenience: `used / limit` clamped to [0, +inf). */
+    percent_used: number;
+    /**
+     * US-12 — server-driven per-metric policy.
+     *   - `metered` → Stripe bills the overage automatically; NO entitlement
+     *     produced; UI shows "metered usage" copy.
+     *   - `hard`    → entitlement flips to false at the cap; UI gates on
+     *     `useBridge().entitlements.can(<key>)` instead of on the counter.
+     *
+     * Default for backward compatibility (pre-US-12 server payload missing
+     * `policy`): `'metered'`.
+     */
+    policy: 'hard' | 'metered';
+    warningLevel: null | 'approaching' | 'critical';
+    /** Display label. US-11 uses the raw metric key; framework wrappers can override. */
+    label: string;
+}
+type Listener = (metric: string, snap: QuotaSnapshot | undefined) => void;
+interface MountOptions {
+    apiBaseUrl: string;
+    /** Bearer access token. Null when unauthenticated — hydrate is skipped. */
+    accessToken: string | null;
+    appId: string;
+}
+export declare class QuotaStore {
+    private _snapshots;
+    private _hydrating;
+    private _listeners;
+    /**
+     * Options used for hydration HTTP. Set via `configure()` before the first
+     * `get(metric)` call; otherwise hydration is skipped and only live pushes
+     * populate the cache.
+     */
+    private _opts;
+    private _logger;
+    /** Wire HTTP options + optional logger. Framework wrappers call this once. */
+    configure(opts: MountOptions, logger?: Logger): void;
+    /** Current cached snapshot for a metric, or undefined while hydrating / unconfigured. */
+    get(metric: string): QuotaSnapshot | undefined;
+    /** All cached snapshots. */
+    getAll(): Map<string, QuotaSnapshot>;
+    /** Subscribe to per-metric snapshot changes. Returns an unsubscribe fn. */
+    subscribe(listener: Listener): () => void;
+    /**
+     * Lazy hydration entry point. On the first call for a metric, kicks off a
+     * `GET /usage/quota/:metric` round-trip and marks the metric as hydrating.
+     * Subsequent calls are no-ops until the response arrives or a live push
+     * lands.
+     *
+     * Non-blocking — returns the current cached snapshot (or undefined) and
+     * lets the fetch resolve asynchronously. Consumers re-render via the
+     * subscriber notification.
+     */
+    ensureHydrated(metric: string): QuotaSnapshot | undefined;
+    /**
+     * Apply a live `quota.updated` payload to the cache. Last-write-wins;
+     * notifies subscribers. Hydration is implicitly cleared if it was pending.
+     */
+    applyQuotaUpdated(msg: QuotaUpdatedMessage): void;
+    /**
+     * Apply the result of an initial-hydration REST fetch. Same semantics as a
+     * live push but driven by the server's `GET /usage/quota/:metric` reply.
+     */
+    applyInitialSnapshot(metric: string, snapshot: (Omit<QuotaSnapshot, 'percent_used' | 'policy' | 'label'> & {
+        policy?: 'hard' | 'metered';
+    }) | null): void;
+    /**
+     * Wire the store to a RealtimeClient so `quota.updated` pushes flow into
+     * `applyQuotaUpdated`. Idempotent: re-attaching replaces the hook.
+     */
+    attach(rt: RealtimeClient): void;
+    /** Test-only: clear cache + listeners. */
+    __resetForTests(): void;
+    private _notify;
+    private _fetchSnapshot;
+}
+export {};
+//# sourceMappingURL=quota-store.d.ts.map

package/dist/billing/quota-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-store.d.ts","sourceRoot":"","sources":["../../src/billing/quota-store.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,YAAY,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC;IAChD,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,CAAC;AAE1E,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAuB;IACzC;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAsB;IAErC,8EAA8E;IAC9E,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,GAAE,MAAmB,GAAG,IAAI;IAKhE,yFAAyF;IACzF,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9C,4BAA4B;IAC5B,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAIpC,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAUzD;;;OAGG;IACH,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAmBjD;;;OAGG;IACH,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EACJ,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG;QAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,CAAC,GACF,IAAI,GACP,IAAI;IAyBP;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAIhC,0CAA0C;IAC1C,eAAe,IAAI,IAAI;IAOvB,OAAO,CAAC,OAAO;YAUD,cAAc;CAkD7B"}