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

package/dist/billing/quota-store.js

@@ -0,0 +1,180 @@
+// Billing 2.0 US-11 (TBP-263) — SDK quota cache + reactive surface.
+//
+// In-memory store keyed on metric. The store is the single source of truth
+// for `useBridge().quota(metric)`:
+//   - First call for a metric → hydrate via `GET /usage/quota/:metric`, mark
+//     the entry as "loading" so subscribers see `undefined` until the server
+//     replies.
+//   - Live `quota.updated` pushes (via RealtimeClient.setOnQuotaUpdated) replace
+//     the cached snapshot — last-write-wins.
+//   - Subscribers receive snapshot notifications on every cache mutation.
+//
+// Framework-agnostic. bridge-svelte wraps `subscribe()` in a Svelte 5 rune.
+import { httpFetch } from '../http.js';
+const noopLogger = {
+    debug: () => { },
+    warn: () => { },
+    error: () => { },
+};
+export class QuotaStore {
+    _snapshots = new Map();
+    _hydrating = new Set();
+    _listeners = new Set();
+    /**
+     * 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.
+     */
+    _opts = null;
+    _logger = noopLogger;
+    /** Wire HTTP options + optional logger. Framework wrappers call this once. */
+    configure(opts, logger = noopLogger) {
+        this._opts = opts;
+        this._logger = logger;
+    }
+    /** Current cached snapshot for a metric, or undefined while hydrating / unconfigured. */
+    get(metric) {
+        return this._snapshots.get(metric);
+    }
+    /** All cached snapshots. */
+    getAll() {
+        return new Map(this._snapshots);
+    }
+    /** Subscribe to per-metric snapshot changes. Returns an unsubscribe fn. */
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => {
+            this._listeners.delete(listener);
+        };
+    }
+    /**
+     * 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) {
+        const cached = this._snapshots.get(metric);
+        if (cached)
+            return cached;
+        if (this._hydrating.has(metric))
+            return undefined;
+        if (!this._opts || !this._opts.accessToken)
+            return undefined;
+        this._hydrating.add(metric);
+        void this._fetchSnapshot(metric);
+        return 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) {
+        const snap = {
+            metric: msg.metric,
+            used: msg.used,
+            limit: msg.limit,
+            remaining: msg.remaining,
+            percent_used: msg.limit > 0 ? msg.used / msg.limit : 0,
+            // US-12 — server now publishes `policy`; fall back to `'metered'` when
+            // an older bridge-api hasn't shipped US-12 yet so existing UI stays
+            // visually identical.
+            policy: msg.policy === 'hard' ? 'hard' : 'metered',
+            warningLevel: msg.warningLevel ?? null,
+            label: msg.metric,
+        };
+        this._snapshots.set(msg.metric, snap);
+        this._hydrating.delete(msg.metric);
+        this._notify(msg.metric, snap);
+    }
+    /**
+     * 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, snapshot) {
+        this._hydrating.delete(metric);
+        if (!snapshot) {
+            // Server returned null → no quota configured. Notify with undefined so
+            // subscribers can show an "unmetered" UI state without an extra check.
+            this._snapshots.delete(metric);
+            this._notify(metric, undefined);
+            return;
+        }
+        const snap = {
+            metric,
+            used: snapshot.used,
+            limit: snapshot.limit,
+            remaining: snapshot.remaining,
+            percent_used: snapshot.limit > 0 ? snapshot.used / snapshot.limit : 0,
+            // US-12 — accept the server-supplied policy; fall back to `'metered'`
+            // for older bridge-api responses.
+            policy: snapshot.policy === 'hard' ? 'hard' : 'metered',
+            warningLevel: snapshot.warningLevel ?? null,
+            label: metric,
+        };
+        this._snapshots.set(metric, snap);
+        this._notify(metric, snap);
+    }
+    /**
+     * Wire the store to a RealtimeClient so `quota.updated` pushes flow into
+     * `applyQuotaUpdated`. Idempotent: re-attaching replaces the hook.
+     */
+    attach(rt) {
+        rt.setOnQuotaUpdated((msg) => this.applyQuotaUpdated(msg));
+    }
+    /** Test-only: clear cache + listeners. */
+    __resetForTests() {
+        this._snapshots.clear();
+        this._hydrating.clear();
+        this._listeners.clear();
+        this._opts = null;
+    }
+    _notify(metric, snap) {
+        for (const listener of this._listeners) {
+            try {
+                listener(metric, snap);
+            }
+            catch {
+                // ignore — listener errors must not break the cache
+            }
+        }
+    }
+    async _fetchSnapshot(metric) {
+        if (!this._opts || !this._opts.accessToken) {
+            this._hydrating.delete(metric);
+            return;
+        }
+        const url = `${this._opts.apiBaseUrl.replace(/\/+$/, '')}/usage/quota/${encodeURIComponent(metric)}`;
+        try {
+            const body = await httpFetch(url, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${this._opts.accessToken}`,
+                    'x-app-id': this._opts.appId,
+                },
+            }, this._logger);
+            this.applyInitialSnapshot(metric, body
+                ? {
+                    metric: body.metric,
+                    used: body.used,
+                    limit: body.limit,
+                    remaining: body.remaining,
+                    warningLevel: body.warningLevel,
+                    policy: body.policy,
+                }
+                : null);
+        }
+        catch (err) {
+            // Hydration is best-effort. Drop the hydrating mark so a later push or
+            // a manual retry can re-populate. Log at warn so the consumer can
+            // diagnose if every fetch is failing.
+            this._logger.warn('[bridge.quota] hydrate failed', err instanceof Error ? err.message : err);
+            this._hydrating.delete(metric);
+        }
+    }
+}
+//# sourceMappingURL=quota-store.js.map

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

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

package/dist/billing/types.d.ts

@@ -0,0 +1,64 @@
+export type BillingSubscriptionStatus = 'trial' | 'active' | 'past_due' | 'cancel_at_period_end' | 'canceled';
+export type BillingSeverity = 'info' | 'warn' | 'critical' | 'locked';
+export type PastDueReason = 'card_declined' | 'trial_expired' | 'card_removed' | null;
+export interface BillingPlanRef {
+    slug: string;
+    name: string;
+}
+/**
+ * Snapshot of canonical billing state exposed by `useBridge().subscription`.
+ * Phase A (US-1, US-2) ships `plan` + `status`. Phase B (US-5..US-9) adds
+ * the optional fields below as lifecycle events arrive.
+ */
+export interface BillingSubscriptionState {
+    plan: BillingPlanRef;
+    status: BillingSubscriptionStatus;
+    pastDueReason?: PastDueReason;
+    cardLast4?: string;
+    hasCardOnFile?: boolean;
+    endsAt?: string;
+    daysLeft?: number;
+    nextRetryAt?: string;
+    finalRetryAt?: string;
+    gateEngaged?: boolean;
+    renewsAt?: string;
+    /** Where to send a locked workspace to recover access (e.g. `/billing`). */
+    recoveryUrl?: string;
+}
+/**
+ * Wire contract for a billing-locked 402 response. Single source of truth shared
+ * by the SDK (detection) and bridge-api (emission, Step 2). `reason` is the
+ * detection discriminator — any 402 carrying `reason: 'billing_locked'` is a lock.
+ */
+export interface BillingLockedPayload {
+    reason: 'billing_locked';
+    billing: {
+        status: BillingSubscriptionStatus;
+        gateEngaged: boolean;
+        recoveryUrl?: string;
+    };
+}
+export interface BillingSubscriptionSnapshot {
+    state: BillingSubscriptionState | null;
+    loading: boolean;
+    error: string | null;
+}
+export interface MountOptions {
+    apiBaseUrl: string;
+    accessToken: string;
+    appId: string;
+}
+/**
+ * Canonical UI states derived from `BillingSubscriptionState` for the
+ * `<BridgeBillingNotice />` component. Pure derivation — not stored on
+ * the snapshot.
+ */
+export type BillingNoticeState = 'active' | 'trial_active' | 'trial_ending_soon' | 'cancel_at_period_end' | 'canceled' | 'past_due' | 'past_due_trial' | 'dunning_active' | 'dunning_final_retry' | 'dunning_exhausted';
+/**
+ * Derive the UI state from the canonical subscription snapshot. Used by
+ * `<BridgeBillingNotice />` and admin-ui badges to pick the right copy +
+ * severity tokens. Pure function — no side effects.
+ */
+export declare function deriveNoticeState(state: BillingSubscriptionState | null): BillingNoticeState;
+export declare function deriveSeverity(noticeState: BillingNoticeState): BillingSeverity;
+//# sourceMappingURL=types.d.ts.map

package/dist/billing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/billing/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,QAAQ,GACR,UAAU,GACV,sBAAsB,GACtB,UAAU,CAAC;AAEf,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,IAAI,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,yBAAyB,CAAC;IAElC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE;QACP,MAAM,EAAE,yBAAyB,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,cAAc,GACd,mBAAmB,GACnB,sBAAsB,GACtB,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,mBAAmB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,GAAG,kBAAkB,CAgB5F;AAeD,wBAAgB,cAAc,CAAC,WAAW,EAAE,kBAAkB,GAAG,eAAe,CAE/E"}

package/dist/billing/types.js

@@ -0,0 +1,49 @@
+// Billing 2.0 reactive surface types — parallel to FF 2.0.
+// Do NOT merge with existing `SubscriptionStatus` (Stripe-direct path);
+// unification is REF-1 post-feature.
+/**
+ * Derive the UI state from the canonical subscription snapshot. Used by
+ * `<BridgeBillingNotice />` and admin-ui badges to pick the right copy +
+ * severity tokens. Pure function — no side effects.
+ */
+export function deriveNoticeState(state) {
+    if (!state)
+        return 'active';
+    if (state.gateEngaged)
+        return 'dunning_exhausted';
+    if (state.status === 'canceled')
+        return 'canceled';
+    if (state.status === 'cancel_at_period_end')
+        return 'cancel_at_period_end';
+    if (state.status === 'past_due') {
+        if (state.pastDueReason === 'trial_expired')
+            return 'past_due_trial';
+        if (state.finalRetryAt)
+            return 'dunning_final_retry';
+        if (state.nextRetryAt)
+            return 'dunning_active';
+        return 'past_due';
+    }
+    if (state.status === 'trial') {
+        if (state.daysLeft !== undefined && state.daysLeft <= 3)
+            return 'trial_ending_soon';
+        return 'trial_active';
+    }
+    return 'active';
+}
+const SEVERITY_BY_STATE = {
+    active: 'info',
+    trial_active: 'info',
+    trial_ending_soon: 'warn',
+    cancel_at_period_end: 'info',
+    canceled: 'warn',
+    past_due: 'warn',
+    past_due_trial: 'warn',
+    dunning_active: 'warn',
+    dunning_final_retry: 'critical',
+    dunning_exhausted: 'locked',
+};
+export function deriveSeverity(noticeState) {
+    return SEVERITY_BY_STATE[noticeState];
+}
+//# sourceMappingURL=types.js.map

package/dist/billing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/billing/types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,wEAAwE;AACxE,qCAAqC;AAmFrC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAsC;IACtE,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,mBAAmB,CAAC;IAClD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,sBAAsB;QAAE,OAAO,sBAAsB,CAAC;IAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,aAAa,KAAK,eAAe;YAAE,OAAO,gBAAgB,CAAC;QACrE,IAAI,KAAK,CAAC,YAAY;YAAE,OAAO,qBAAqB,CAAC;QACrD,IAAI,KAAK,CAAC,WAAW;YAAE,OAAO,gBAAgB,CAAC;QAC/C,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC;YAAE,OAAO,mBAAmB,CAAC;QACpF,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,iBAAiB,GAAgD;IACrE,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,MAAM;IACpB,iBAAiB,EAAE,MAAM;IACzB,oBAAoB,EAAE,MAAM;IAC5B,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,MAAM;IACtB,mBAAmB,EAAE,UAAU;IAC/B,iBAAiB,EAAE,QAAQ;CAC5B,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,WAA+B;IAC5D,OAAO,iBAAiB,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,131 @@
+import type { BillingLifecycleMessage, EntitlementsChangedMessage, QuotaUpdatedMessage, RealtimeClient, SubscriptionPlanChangedMessage } from '../flags/realtime.js';
+import { BridgeSubscription } from './bridge-subscription.js';
+import { EntitlementsStore, type EntitlementSnapshot } from './entitlements-store.js';
+import { QuotaStore, type QuotaSnapshot } from './quota-store.js';
+import type { BillingNoticeState, BillingSeverity } from './types.js';
+/** Resolved billing-gate view for the current snapshot. */
+export interface BillingGateState {
+    locked: boolean;
+    severity: BillingSeverity;
+    noticeState: BillingNoticeState;
+    recoveryUrl?: string;
+}
+/**
+ * BillingLifecycleMessage's discriminator union includes `'entitlements.changed'`
+ * as a signal-only kind. US-12 introduces a parallel payload-carrying variant
+ * (EntitlementsChangedMessage) routed through `setOnEntitlementsChanged`. The
+ * dev-handler table accepts either shape under that key — the dispatch site
+ * routes per-message based on the presence of `entitlements`.
+ */
+type EntitlementsChangedHandlerArg = BillingLifecycleMessage | EntitlementsChangedMessage;
+export type BillingEventHandlers = {
+    [K in Exclude<BillingLifecycleMessage['kind'], 'entitlements.changed'>]?: (msg: BillingLifecycleMessage) => void;
+} & {
+    /**
+     * TBP-360 — handler for canonical plan-change pushes. Lives on its own kind
+     * (SubscriptionPlanChangedMessage) outside `BillingLifecycleMessage`, but is
+     * exposed through the same multi-subscriber dispatch so bridge-svelte's
+     * `bridge.events.handle({ 'subscription.plan_changed': fn })` works.
+     */
+    'subscription.plan_changed'?: (msg: SubscriptionPlanChangedMessage) => void;
+    /**
+     * Billing 2.0 US-11 — handler for live quota counter pushes. Mirrors the
+     * lifecycle-event handler pattern: framework wrappers + dev consumers can
+     * both register; both fire on every matching event.
+     */
+    'quota.updated'?: (msg: QuotaUpdatedMessage) => void;
+    /**
+     * Billing 2.0 US-12 — handler for live entitlement snapshot pushes. Fires
+     * alongside the EntitlementsStore cache replacement so dev consumers
+     * (analytics, audit, etc.) can react to the same event the UI gates on.
+     * Receives the payload-carrying `EntitlementsChangedMessage` (US-12 shape);
+     * the legacy signal-only lifecycle variant fans out through the lifecycle
+     * dispatch like other lifecycle kinds.
+     */
+    'entitlements.changed'?: (msg: EntitlementsChangedHandlerArg) => void;
+};
+/**
+ * Billing 2.0 US-12 — top-level entitlements accessor. Mirrors the
+ * fail-closed semantics of `EntitlementsStore.can` so consumers can write
+ * `bridge.entitlements.can('ai_completions')` without holding a store ref.
+ */
+export interface UseBridgeEntitlementsApi {
+    can(name: string): boolean;
+    all(): EntitlementSnapshot;
+}
+export interface UseBridgeApi {
+    subscription: BridgeSubscription;
+    /**
+     * Billing 2.0 US-11 — reactive quota snapshot for a single metric. The
+     * first call for a given metric kicks off a `GET /usage/quota/:metric`
+     * hydration; while in flight, returns `undefined`. Once hydrated (and on
+     * every subsequent `quota.updated` push), returns the full snapshot.
+     *
+     * Framework wrappers (bridge-svelte's `useBridge().quota(metric)`) wrap
+     * this in a runes-aware proxy so Svelte components re-render on push.
+     */
+    quota(metric: string): QuotaSnapshot | undefined;
+    /**
+     * Direct access to the underlying QuotaStore — framework wrappers use this
+     * to subscribe to push notifications and re-render on cache mutations.
+     */
+    readonly quotas: QuotaStore;
+    /**
+     * Billing 2.0 US-12 — top-level entitlements accessor (`bridge.entitlements.can(name)`).
+     * Fail-closed: returns false until hydration completes and the key is
+     * explicitly true.
+     */
+    readonly entitlements: UseBridgeEntitlementsApi;
+    /**
+     * Direct access to the underlying EntitlementsStore — framework wrappers
+     * use this to subscribe to snapshot replacements and re-render UI.
+     */
+    readonly entitlementsStore: EntitlementsStore;
+    /**
+     * Register dev-supplied side-effect handlers for canonical lifecycle events
+     * (analytics, Slack, audit, etc.) — separate from the UI rendering path
+     * which is owned by `<BridgeBillingNotice />`. Per locked decision #9, dev
+     * handlers run alongside UI handlers; both fire on every matching event.
+     *
+     * Caller must call `attachToRealtimeClient(rt)` once (typically done by
+     * the framework wrapper) before any handlers can fire.
+     */
+    handle(handlers: BillingEventHandlers): () => void;
+    /**
+     * Wire the surface to a Milestone K RealtimeClient. Framework wrappers
+     * (bridge-svelte / bridge-react / ...) call this once during init.
+     */
+    attachToRealtimeClient(rt: RealtimeClient): void;
+    /**
+     * Billing 2.0 soft gate — true when the workspace is billing-locked
+     * (`gateEngaged`). Fail-closed: false until state is known. Use for
+     * proactively disabling write actions in the UI.
+     */
+    isLocked(): boolean;
+    /**
+     * Resolved gate view (locked + severity + notice state + recoveryUrl) derived
+     * from the current snapshot. Drives custom lockscreens without re-deriving.
+     */
+    gateState(): BillingGateState;
+    /**
+     * Imperative guard — throws `BillingLockedError` if the workspace is locked.
+     * Node-safe; use to wrap a write before it leaves the client/server.
+     */
+    assertNotLocked(): void;
+}
+/**
+ * Billing 2.0 reactive SDK shell. Phase A exposes `.subscription` reactivity;
+ * Phase B adds `.handle(...)` for dev-supplied side-effect handlers + the
+ * `attachToRealtimeClient(rt)` wiring entry point.
+ *
+ * Parallel to FF 2.0's existing reactive surface — do NOT unify. REF-1
+ * (post-feature) folds them together.
+ */
+export declare function useBridge(): UseBridgeApi;
+/**
+ * Test-only: drop the singleton so each test starts with a fresh surface.
+ * Not exported from the package entry — internal to the test suite.
+ */
+export declare function __resetUseBridgeForTests(): void;
+export {};
+//# sourceMappingURL=use-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-bridge.d.ts","sourceRoot":"","sources":["../../src/billing/use-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,8BAA8B,EAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,kBAAkB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,KAAK,6BAA6B,GAC9B,uBAAuB,GACvB,0BAA0B,CAAC;AAE/B,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CACxE,GAAG,EAAE,uBAAuB,KACzB,IAAI;CACV,GAAG;IACF;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,CAAC,GAAG,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAC5E;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACrD;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,6BAA6B,KAAK,IAAI,CAAC;CACvE,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,GAAG,IAAI,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,kBAAkB,CAAC;IACjC;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IACnD;;;OAGG;IACH,sBAAsB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,IAAI,gBAAgB,CAAC;IAC9B;;;OAGG;IACH,eAAe,IAAI,IAAI,CAAC;CACzB;AAQD;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,YAAY,CA2IxC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAa/C"}

package/dist/billing/use-bridge.js

@@ -0,0 +1,181 @@
+import { BillingLockedError } from '../errors.js';
+import { BridgeSubscription } from './bridge-subscription.js';
+import { setBillingLockHandler } from './lock-signal.js';
+import { EntitlementsStore, } from './entitlements-store.js';
+import { QuotaStore } from './quota-store.js';
+import { deriveNoticeState, deriveSeverity } from './types.js';
+let _singleton = null;
+let _devHandlers = [];
+let _attachedRt;
+let _quotaStore = null;
+let _entitlementsStore = null;
+/**
+ * Billing 2.0 reactive SDK shell. Phase A exposes `.subscription` reactivity;
+ * Phase B adds `.handle(...)` for dev-supplied side-effect handlers + the
+ * `attachToRealtimeClient(rt)` wiring entry point.
+ *
+ * Parallel to FF 2.0's existing reactive surface — do NOT unify. REF-1
+ * (post-feature) folds them together.
+ */
+export function useBridge() {
+    if (!_singleton) {
+        const subscription = new BridgeSubscription();
+        const quotaStore = new QuotaStore();
+        const entitlementsStore = new EntitlementsStore();
+        _quotaStore = quotaStore;
+        _entitlementsStore = entitlementsStore;
+        _singleton = {
+            subscription,
+            quotas: quotaStore,
+            quota(metric) {
+                return quotaStore.ensureHydrated(metric);
+            },
+            entitlementsStore,
+            entitlements: {
+                can(name) {
+                    return entitlementsStore.can(name);
+                },
+                all() {
+                    return entitlementsStore.all();
+                },
+            },
+            handle(handlers) {
+                _devHandlers.push(handlers);
+                // Idempotent attach to existing rt if available
+                return () => {
+                    _devHandlers = _devHandlers.filter((h) => h !== handlers);
+                };
+            },
+            attachToRealtimeClient(rt) {
+                if (_attachedRt === rt)
+                    return;
+                _attachedRt = rt;
+                subscription.attach(rt);
+                // TBP-360 — RealtimeClient stores ONE hook per kind; subscription.attach
+                // above already set the plan-change hook. Replace it with a composite
+                // that applies the subscription patch AND fans out to dev handlers
+                // registered via `useBridge().handle({ 'subscription.plan_changed' })`.
+                rt.setOnSubscriptionPlanChanged((msg) => {
+                    subscription._applyPlanChanged(msg);
+                    for (const handlers of _devHandlers) {
+                        const fn = handlers['subscription.plan_changed'];
+                        if (fn) {
+                            try {
+                                fn(msg);
+                            }
+                            catch {
+                                // ignore — dev handler errors don't affect SDK state
+                            }
+                        }
+                    }
+                });
+                // Funnel lifecycle events to dev handlers AFTER the subscription
+                // surface has patched its own state.
+                rt.setOnBillingLifecycle((msg) => {
+                    // Patch the snapshot first (BridgeSubscription.attach above already
+                    // registered its own hook; the RealtimeClient stores ONE hook per
+                    // kind, so re-set means we replace it). We replicate the snapshot
+                    // patch + dev fan-out here so both run.
+                    subscription._applyLifecycle(msg);
+                    for (const handlers of _devHandlers) {
+                        // `handlers[msg.kind]` is union-typed across kinds; cast at the
+                        // call site so each handler receives its declared message shape.
+                        const fn = handlers[msg.kind];
+                        if (fn) {
+                            try {
+                                fn(msg);
+                            }
+                            catch {
+                                // ignore — dev handler errors don't affect SDK state
+                            }
+                        }
+                    }
+                });
+                // US-11 — wire quota.updated pushes into the store AND fan out to
+                // dev handlers that registered for 'quota.updated'.
+                rt.setOnQuotaUpdated((msg) => {
+                    quotaStore.applyQuotaUpdated(msg);
+                    for (const handlers of _devHandlers) {
+                        const fn = handlers['quota.updated'];
+                        if (fn) {
+                            try {
+                                fn(msg);
+                            }
+                            catch {
+                                // ignore — dev handler errors don't affect SDK state
+                            }
+                        }
+                    }
+                });
+                // US-12 — wire entitlements.changed pushes into the store AND fan
+                // out to dev handlers that registered for 'entitlements.changed'.
+                rt.setOnEntitlementsChanged((msg) => {
+                    entitlementsStore.applyEntitlementsChanged(msg.entitlements);
+                    for (const handlers of _devHandlers) {
+                        const fn = handlers['entitlements.changed'];
+                        if (fn) {
+                            try {
+                                fn(msg);
+                            }
+                            catch {
+                                // ignore — dev handler errors don't affect SDK state
+                            }
+                        }
+                    }
+                });
+                // US-12 — initial REST hydration on attach. Fire-and-forget; failures
+                // are logged at warn inside the store. Subsequent pushes overwrite.
+                void entitlementsStore.hydrate();
+            },
+            isLocked() {
+                return subscription.snapshot().state?.gateEngaged ?? false;
+            },
+            gateState() {
+                const state = subscription.snapshot().state;
+                const noticeState = deriveNoticeState(state);
+                return {
+                    locked: state?.gateEngaged ?? false,
+                    severity: deriveSeverity(noticeState),
+                    noticeState,
+                    recoveryUrl: state?.recoveryUrl,
+                };
+            },
+            assertNotLocked() {
+                const state = subscription.snapshot().state;
+                if (state?.gateEngaged) {
+                    throw new BillingLockedError({
+                        reason: 'billing_locked',
+                        billing: {
+                            status: state.status,
+                            gateEngaged: true,
+                            recoveryUrl: state.recoveryUrl,
+                        },
+                    });
+                }
+            },
+        };
+        // Auto-flip the store when any SDK call hits a billing-locked 402, so a
+        // caught BillingLockedError surfaces in the notice/gate with no extra wiring.
+        setBillingLockHandler((payload) => subscription.markLocked(payload));
+    }
+    return _singleton;
+}
+/**
+ * Test-only: drop the singleton so each test starts with a fresh surface.
+ * Not exported from the package entry — internal to the test suite.
+ */
+export function __resetUseBridgeForTests() {
+    _singleton = null;
+    _devHandlers = [];
+    _attachedRt = undefined;
+    setBillingLockHandler(null);
+    if (_quotaStore) {
+        _quotaStore.__resetForTests();
+    }
+    _quotaStore = null;
+    if (_entitlementsStore) {
+        _entitlementsStore.__resetForTests();
+    }
+    _entitlementsStore = null;
+}
+//# sourceMappingURL=use-bridge.js.map

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

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