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

package/dist/flags/telemetry.d.ts

@@ -0,0 +1,79 @@
+import type { BridgeFlags } from './flag.js';
+export interface TelemetryBatcherConfig {
+    /** Bridge API base URL (e.g. https://api.thebridge.dev or http://localhost:3500). */
+    apiBaseUrl: string;
+    /** JWT-shaped workspace API key — sent as `x-api-key` header. */
+    apiKey: string;
+    /** Flush interval in ms. Default 30s. */
+    flushIntervalMs?: number;
+    /** Maximum events buffered before forcing a flush. Default 500. */
+    flushAtSize?: number;
+    /**
+     * Short debounce after any discovery / attribute-observation event, so
+     * first-sight items reach the admin near-instantly without waiting for the
+     * 30s eval cadence. Default 1000ms. Set higher to coalesce more aggressively
+     * or to 0 to flush synchronously.
+     */
+    firstSightFlushMs?: number;
+    /** When false, telemetry HTTP calls are skipped — useful for tests + opt-out apps. */
+    enabled?: boolean;
+}
+export declare class TelemetryBatcher {
+    private readonly evalBuffer;
+    private readonly discoveryBuffer;
+    private readonly attributeDeclBuffer;
+    private readonly attributeObsBuffer;
+    private readonly callSiteBuffer;
+    private readonly seenCallSites;
+    private timer?;
+    private firstSightTimer?;
+    private readonly cfg;
+    private flushing;
+    constructor(cfg: TelemetryBatcherConfig);
+    /** Schedule a near-instant flush in response to a first-sight event. Debounced
+     *  so a burst of first-sights collapses to a single flush. Discovery + attribute
+     *  observation paths both use this; eval events keep the 30s cadence. */
+    private scheduleFirstSightFlush;
+    /**
+     * Attach to a BridgeFlags instance. Registers hooks for eval + discovery
+     * + attribute-declaration events. Also starts the periodic flush timer.
+     */
+    attach(bridge: BridgeFlags): void;
+    /** Record a call-site sighting. Caller supplies the fingerprint. */
+    recordCallSite(flag: string, identity: string, fingerprint: string, devLabel?: string): void;
+    /** Hook entrypoint — coalesces eval events per (identity, flag, value, minute). */
+    private recordEval;
+    /** Hook entrypoint — discovery events are inherently dedupe'd by BridgeFlags.
+     *  Schedules a near-instant flush so a new flag shows up in the admin within
+     *  ~1s of first eval, not at the next 30s tick. */
+    private recordDiscovery;
+    /** Hook entrypoint — attribute type declarations (TBP-174, deprecated). */
+    private recordAttributeDeclaration;
+    /** Hook entrypoint — per-call attribute observations (TBP-178). Same near-
+     *  instant flush so a new dev-supplied attribute reaches the admin catalog
+     *  within ~1s of first eval. */
+    private recordAttributeObservation;
+    /** Begin periodic flushing. Idempotent. */
+    start(): void;
+    /** Stop the timer and force a final flush. Called on app shutdown / SDK teardown. */
+    stop(): Promise<void>;
+    /** Force a flush now. Returns when all in-flight HTTP calls settle. */
+    flush(): Promise<void>;
+    /** Telemetry surface for introspection / tests. */
+    stats(): {
+        evalQueue: number;
+        discoveryQueue: number;
+        attributeDeclQueue: number;
+        attributeObsQueue: number;
+        callSiteQueue: number;
+        seenCallSites: number;
+    };
+    private maybeFlushOnSize;
+    private flushEvals;
+    private flushDiscoveries;
+    private flushAttributeDeclarations;
+    private flushAttributeObservations;
+    private flushCallSites;
+    private post;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/flags/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/flags/telemetry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAGV,WAAW,EAGZ,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAuCD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuC;IAC3E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuC;IAC1E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAMvB;IACR,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,eAAe,CAAC,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmC;IACvD,OAAO,CAAC,QAAQ,CAAS;gBAEb,GAAG,EAAE,sBAAsB;IAWvC;;6EAEyE;IACzE,OAAO,CAAC,uBAAuB;IAS/B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAUjC,oEAAoE;IACpE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5F,mFAAmF;IACnF,OAAO,CAAC,UAAU;IAoBlB;;uDAEmD;IACnD,OAAO,CAAC,eAAe;IAWvB,2EAA2E;IAC3E,OAAO,CAAC,0BAA0B;IAUlC;;oCAEgC;IAChC,OAAO,CAAC,0BAA0B;IAWlC,2CAA2C;IAC3C,KAAK,IAAI,IAAI;IAUb,qFAAqF;IAC/E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B,mDAAmD;IACnD,KAAK,IAAI;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB;IAWD,OAAO,CAAC,gBAAgB;YAYV,UAAU;YAOV,gBAAgB;YAWhB,0BAA0B;YAe1B,0BAA0B;YAe1B,cAAc;YAMd,IAAI;CAoBnB"}

package/dist/flags/telemetry.js

@@ -0,0 +1,286 @@
+// SDK telemetry batcher (TBP-157).
+//
+// Wires the BridgeFlags hooks (`onEval`, `onDiscover`, `onIdentify`) to the
+// bridge-api ingest endpoints (`/v1/flags/eval-events`, `/v1/flags/discover`,
+// `/v1/flags/call-sites`). Coalesces eval events per (identity, flag, value)
+// per minute, dedupes call-site reports per (identity, fingerprint) for the
+// SDK runtime, and periodically flushes via HTTP.
+//
+// This module is platform-agnostic — it uses global `fetch` and a `setInterval`
+// timer. Framework SDKs construct it during bootstrap and pass the workspace
+// API key. On graceful shutdown they call `stop()` to flush pending events.
+export class TelemetryBatcher {
+    evalBuffer = new Map();
+    discoveryBuffer = [];
+    attributeDeclBuffer = [];
+    attributeObsBuffer = [];
+    callSiteBuffer = [];
+    seenCallSites = new Set(); // dedup per runtime: `identity|fingerprint`
+    timer;
+    firstSightTimer;
+    cfg;
+    flushing = false;
+    constructor(cfg) {
+        this.cfg = {
+            apiBaseUrl: cfg.apiBaseUrl.replace(/\/+$/, ''),
+            apiKey: cfg.apiKey,
+            flushIntervalMs: cfg.flushIntervalMs ?? 30_000,
+            flushAtSize: cfg.flushAtSize ?? 500,
+            firstSightFlushMs: cfg.firstSightFlushMs ?? 1_000,
+            enabled: cfg.enabled !== false,
+        };
+    }
+    /** Schedule a near-instant flush in response to a first-sight event. Debounced
+     *  so a burst of first-sights collapses to a single flush. Discovery + attribute
+     *  observation paths both use this; eval events keep the 30s cadence. */
+    scheduleFirstSightFlush() {
+        if (this.firstSightTimer)
+            return;
+        this.firstSightTimer = setTimeout(() => {
+            this.firstSightTimer = undefined;
+            void this.flush();
+        }, this.cfg.firstSightFlushMs);
+        if (this.firstSightTimer?.unref)
+            this.firstSightTimer.unref();
+    }
+    /**
+     * Attach to a BridgeFlags instance. Registers hooks for eval + discovery
+     * + attribute-declaration events. Also starts the periodic flush timer.
+     */
+    attach(bridge) {
+        bridge.setHooks({
+            onEval: (ev) => this.recordEval(ev),
+            onDiscover: (ev) => this.recordDiscovery(ev),
+            onAttributeDeclaration: (decl) => this.recordAttributeDeclaration(decl),
+            onAttributeObserved: (obs) => this.recordAttributeObservation(obs),
+        });
+        this.start();
+    }
+    /** Record a call-site sighting. Caller supplies the fingerprint. */
+    recordCallSite(flag, identity, fingerprint, devLabel) {
+        if (!identity || !fingerprint)
+            return;
+        const key = `${identity}|${fingerprint}`;
+        if (this.seenCallSites.has(key))
+            return;
+        this.seenCallSites.add(key);
+        this.callSiteBuffer.push({ flag, identity, fingerprint, devLabel, timestamp: Date.now() });
+        this.maybeFlushOnSize();
+    }
+    /** Hook entrypoint — coalesces eval events per (identity, flag, value, minute). */
+    recordEval(ev) {
+        const valueKey = canonicalValueKey(ev.value);
+        const bucketMinute = Math.floor(ev.timestamp / 60_000);
+        const key = `${ev.identity ?? ''}::${ev.flag}::${valueKey}::${ev.variantIndex}::${bucketMinute}`;
+        const existing = this.evalBuffer.get(key);
+        if (existing) {
+            existing.count++;
+        }
+        else {
+            this.evalBuffer.set(key, {
+                flag: ev.flag,
+                value: ev.value,
+                variantIndex: ev.variantIndex,
+                identity: ev.identity,
+                timestamp: ev.timestamp,
+                count: 1,
+            });
+        }
+        this.maybeFlushOnSize();
+    }
+    /** Hook entrypoint — discovery events are inherently dedupe'd by BridgeFlags.
+     *  Schedules a near-instant flush so a new flag shows up in the admin within
+     *  ~1s of first eval, not at the next 30s tick. */
+    recordDiscovery(ev) {
+        this.discoveryBuffer.push({
+            flag: ev.flag,
+            defaultValue: ev.defaultValue,
+            observedType: ev.observedType,
+            timestamp: ev.timestamp,
+        });
+        this.scheduleFirstSightFlush();
+        this.maybeFlushOnSize();
+    }
+    /** Hook entrypoint — attribute type declarations (TBP-174, deprecated). */
+    recordAttributeDeclaration(decl) {
+        this.attributeDeclBuffer.push({
+            name: decl.name,
+            type: decl.type,
+            timestamp: decl.timestamp,
+        });
+        this.scheduleFirstSightFlush();
+        this.maybeFlushOnSize();
+    }
+    /** Hook entrypoint — per-call attribute observations (TBP-178). Same near-
+     *  instant flush so a new dev-supplied attribute reaches the admin catalog
+     *  within ~1s of first eval. */
+    recordAttributeObservation(obs) {
+        this.attributeObsBuffer.push({
+            key: obs.key,
+            sampleValue: obs.sampleValue,
+            observedType: obs.observedType,
+            timestamp: obs.timestamp,
+        });
+        this.scheduleFirstSightFlush();
+        this.maybeFlushOnSize();
+    }
+    /** Begin periodic flushing. Idempotent. */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            void this.flush();
+        }, this.cfg.flushIntervalMs);
+        // Some runtimes (Node) keep the process alive on a timer; in the SDK
+        // context this is typically a browser, so it's a no-op there.
+        if (this.timer?.unref)
+            this.timer.unref();
+    }
+    /** Stop the timer and force a final flush. Called on app shutdown / SDK teardown. */
+    async stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        if (this.firstSightTimer) {
+            clearTimeout(this.firstSightTimer);
+            this.firstSightTimer = undefined;
+        }
+        await this.flush();
+    }
+    /** Force a flush now. Returns when all in-flight HTTP calls settle. */
+    async flush() {
+        if (!this.cfg.enabled) {
+            this.evalBuffer.clear();
+            this.discoveryBuffer.length = 0;
+            this.attributeDeclBuffer.length = 0;
+            this.attributeObsBuffer.length = 0;
+            this.callSiteBuffer.length = 0;
+            return;
+        }
+        if (this.flushing)
+            return; // single-flight; the next interval picks up the rest
+        this.flushing = true;
+        try {
+            await Promise.all([
+                this.flushEvals(),
+                this.flushDiscoveries(),
+                this.flushAttributeDeclarations(),
+                this.flushAttributeObservations(),
+                this.flushCallSites(),
+            ]);
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    /** Telemetry surface for introspection / tests. */
+    stats() {
+        return {
+            evalQueue: this.evalBuffer.size,
+            discoveryQueue: this.discoveryBuffer.length,
+            attributeDeclQueue: this.attributeDeclBuffer.length,
+            attributeObsQueue: this.attributeObsBuffer.length,
+            callSiteQueue: this.callSiteBuffer.length,
+            seenCallSites: this.seenCallSites.size,
+        };
+    }
+    maybeFlushOnSize() {
+        const total = this.evalBuffer.size +
+            this.discoveryBuffer.length +
+            this.attributeDeclBuffer.length +
+            this.attributeObsBuffer.length +
+            this.callSiteBuffer.length;
+        if (total >= this.cfg.flushAtSize) {
+            void this.flush();
+        }
+    }
+    async flushEvals() {
+        if (this.evalBuffer.size === 0)
+            return;
+        const events = Array.from(this.evalBuffer.values());
+        this.evalBuffer.clear();
+        await this.post('/v1/flags/eval-events', { events });
+    }
+    async flushDiscoveries() {
+        if (this.discoveryBuffer.length === 0)
+            return;
+        const events = this.discoveryBuffer.splice(0).map((d) => ({
+            kind: 'flag',
+            key: d.flag,
+            observedType: d.observedType,
+            timestamp: d.timestamp,
+        }));
+        await this.post('/v1/flags/discover', { events });
+    }
+    async flushAttributeDeclarations() {
+        if (this.attributeDeclBuffer.length === 0)
+            return;
+        // Attribute declarations are sent through the discovery endpoint with
+        // `kind: 'attribute'` + observedType. The admin UI's Discovered panel
+        // distinguishes declared vs inferred via the observedType + a future
+        // `declared: true` field (TODO once the backend supports the flag).
+        const events = this.attributeDeclBuffer.splice(0).map((d) => ({
+            kind: 'attribute',
+            key: d.name,
+            observedType: d.type,
+            timestamp: d.timestamp,
+        }));
+        await this.post('/v1/flags/discover', { events });
+    }
+    async flushAttributeObservations() {
+        if (this.attributeObsBuffer.length === 0)
+            return;
+        // Per-call attribute observations (TBP-178) — relayed to the same discovery
+        // endpoint with `kind: 'attribute'` + observedType + sampleValue. Backend
+        // accumulates distinct samples per (app, key) via `$addToSet`.
+        const events = this.attributeObsBuffer.splice(0).map((o) => ({
+            kind: 'attribute',
+            key: o.key,
+            sampleValue: o.sampleValue,
+            observedType: o.observedType,
+            timestamp: o.timestamp,
+        }));
+        await this.post('/v1/flags/discover', { events });
+    }
+    async flushCallSites() {
+        if (this.callSiteBuffer.length === 0)
+            return;
+        const events = this.callSiteBuffer.splice(0);
+        await this.post('/v1/flags/call-sites', { events });
+    }
+    async post(path, body) {
+        const url = `${this.cfg.apiBaseUrl}${path}`;
+        try {
+            await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': this.cfg.apiKey,
+                },
+                body: JSON.stringify(body),
+            });
+            // We don't currently inspect the response — accepted/rejected counts
+            // are useful for debugging but not actionable from the SDK side.
+            // A future hardening could log on non-2xx.
+        }
+        catch {
+            // Network errors swallowed — telemetry is best-effort. A future
+            // hardening could re-buffer with backoff, but losing some events is
+            // strictly preferred over breaking the SDK on a flaky network.
+        }
+    }
+}
+// ── helpers ─────────────────────────────────────────────────────────────────
+function canonicalValueKey(v) {
+    if (v === undefined)
+        return 'undefined';
+    try {
+        const s = JSON.stringify(v);
+        return s.length > 256 ? s.slice(0, 256) + '…' : s;
+    }
+    catch {
+        return String(v);
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/flags/telemetry.js.map

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

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAoChG"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAU1C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAwChG"}

package/dist/http.js

@@ -1,4 +1,10 @@
-import { HttpError } from './errors.js';
+import { BillingLockedError, HttpError } from './errors.js';
+import { emitBillingLock } from './billing/lock-signal.js';
+function isBillingLockedPayload(body) {
+    return (typeof body === 'object' &&
+        body !== null &&
+        body.reason === 'billing_locked');
+}
 export async function httpFetch(url, options, logger) {
     const { method = 'GET', headers = {}, body, credentials } = options;
     const fetchOptions = {
@@ -21,6 +27,10 @@ export async function httpFetch(url, options, logger) {
         catch {
             errorBody = await response.text().catch(() => null);
         }
+        if (response.status === 402 && isBillingLockedPayload(errorBody)) {
+            emitBillingLock(errorBody);
+            throw new BillingLockedError(errorBody);
+        }
         const message = typeof errorBody === 'object' && errorBody && 'message' in errorBody
             ? String(errorBody.message)
             : `HTTP ${response.status}: ${response.statusText}`;

package/dist/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,GAAW,EAAE,OAAoB,EAAE,MAAc;IAClF,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEpE,MAAM,YAAY,GAAgB;QAChC,MAAM;QACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE;KAC5D,CAAC;IAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,YAAY,CAAC,WAAW,GAAG,WAAW,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAI,SAAkB,CAAC;QACvB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,IAAI,SAAS,IAAI,SAAS;YAClF,CAAC,CAAC,MAAM,CAAE,SAAiB,CAAC,OAAO,CAAC;YACpC,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAc,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAI3D,SAAS,sBAAsB,CAAC,IAAa;IAC3C,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACZ,IAA6B,CAAC,MAAM,KAAK,gBAAgB,CAC3D,CAAC;AACJ,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,GAAW,EAAE,OAAoB,EAAE,MAAc;IAClF,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEpE,MAAM,YAAY,GAAgB;QAChC,MAAM;QACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE;KAC5D,CAAC;IAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,YAAY,CAAC,WAAW,GAAG,WAAW,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAI,SAAkB,CAAC;QACvB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjE,eAAe,CAAC,SAAS,CAAC,CAAC;YAC3B,MAAM,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,IAAI,SAAS,IAAI,SAAS;YAClF,CAAC,CAAC,MAAM,CAAE,SAAiB,CAAC,OAAO,CAAC;YACpC,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAc,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -4,12 +4,12 @@ export { TeamService } from './team-service.js';
 export type { TeamProfile, TeamProfileUpdateInput, TeamUser, TeamUserListResult, TeamUserUpdateInput, TeamWorkspace, TeamWorkspaceUpdateInput, } from './team-types.js';
 export { ApiTokenService } from './api-token-service.js';
 export type { ApiToken, AvailablePrivilege, CreateApiTokenInput, CreateApiTokenResponse, } from './api-token-service.js';
-export { BridgeAuthError, HttpError } from './errors.js';
+export { BridgeAuthError, HttpError, BillingLockedError } from './errors.js';
 export { LocalStorageAdapter, MemoryAdapter } from './token-storage.js';
 export { decodeJwtPayload, getTokenExpiry, isTokenExpired, shouldRefreshNow } from './token-utils.js';
 export { BridgeManagement } from './management/index.js';
 export { ManagementHttpClient } from './management-http.js';
-export type { ManagementConfig, AppResponse, UpdateAppRequest, CredentialsState, UpdateCredentialsRequest, TenantResponse, CreateTenantRequest, UpdateTenantRequest, UserResponse, InviteUserRequest, UpdateUserRequest, RoleResponse, CreateRoleRequest, UpdateRoleRequest, PrivilegeResponse, FlagResponse, CreateFlagInput, UpdateFlagInput, SegmentResponse, SegmentInput, Target, TargetValue, BrandingResponse, UpdateBrandingRequest, CssFileResponse, UpdateCssFileRequest, PlanResponse, CreatePlanRequest, UpdatePlanRequest, PlanPrice, TokenRecord, CreateTokenRequest, CreateTokenResponse, EventQuery, EventResult, OnboardingResponse, UpdateOnboardingRequest, SetupSSOParams, SetupSSOResult, SetupPaymentsParams, SetupPaymentsResult, SetupCommunicationParams, SetupCommunicationResult, SSOProvider, } from './management-types.js';
+export type { ManagementConfig, AppResponse, UpdateAppRequest, CredentialsState, UpdateCredentialsRequest, TenantResponse, CreateTenantRequest, UpdateTenantRequest, UserResponse, InviteUserRequest, UpdateUserRequest, RoleResponse, CreateRoleRequest, UpdateRoleRequest, PrivilegeResponse, FlagResponse, CreateFlagInput, UpdateFlagInput, SegmentResponse, SegmentInput, Target, TargetValue, FlagSchedule, BrandingResponse, UpdateBrandingRequest, CssFileResponse, UpdateCssFileRequest, PlanResponse, CreatePlanRequest, UpdatePlanRequest, PlanPrice, TokenRecord, CreateTokenRequest, CreateTokenResponse, EventQuery, EventResult, OnboardingResponse, UpdateOnboardingRequest, SetupSSOParams, SetupSSOResult, SetupPaymentsParams, SetupPaymentsResult, SetupCommunicationParams, SetupCommunicationResult, SSOProvider, } from './management-types.js';
 export { AppManagementService } from './management/app.service.js';
 export { TenantManagementService } from './management/tenant.service.js';
 export { UserManagementService } from './management/user.service.js';
@@ -21,4 +21,16 @@ export { TokenManagementService } from './management/token.service.js';
 export { EventManagementService } from './management/event.service.js';
 export { OnboardingManagementService } from './management/onboarding.service.js';
 export { ManagementWorkflows } from './management/workflows.js';
+export { OPERATORS, OPERATOR_VERSION, CONDITIONS_PER_RULE_MAX, isOperator, isOperatorValidForType, validOperatorsForType, evaluateCondition, validateConditions, bucket, evaluateBranch, evaluateRule, resolveAttribute, validateRule, BridgeFlags, BridgeIdentity, MemoryIdentityStorage, attachIdentity, generateAnonymousId, AttributeProviderRegistry, AuthAttributeProvider, BillingAttributeProvider, DevAttributeProvider, BridgePullCache, TelemetryBatcher, RealtimeClient, BRIDGE_CONTEXT_HEADER, serializeContext, deserializeContext, serverInstanceId, } from './flags/index.js';
+export type { Operator, AttributeType, Condition, ConditionValue, ValidationError, Branch, Rule, FlagState, EvalContext, EvalResult, RuleValidationError, CachedFlag, FlagEvalResult, FlagValueType, EvalTelemetry, DiscoveryTelemetry, BridgeFlagsHooks, DeclaredAttributeType, AttributeDeclaration, BridgeFlagsMode, FlagUsageReporterLike, AnonymousTrackingMode, IdentityStorage, AttributeProvider, AuthJwtClaims, AuthProviderConfig, BillingSnapshot, BillingProviderConfig, BillingProviderStores, AttributeGetter, AttributeBulkGetter, AttributesSetOptions, BridgeRuntimeMode, PullCacheOptions, TelemetryBatcherConfig, RealtimeClientConfig, RealtimeMessage, FlagUpdateMessage, FlagRemovedMessage, UserStateMessage, SubscriptionPlanChangedMessage, BillingLifecycleMessage, QuotaUpdatedMessage, EntitlementsChangedMessage, SessionSnapshotMessage, ConnectionState, WebSocketLike, } from './flags/index.js';
+export { useBridge } from './billing/use-bridge.js';
+export type { UseBridgeApi, UseBridgeEntitlementsApi, BillingEventHandlers, BillingGateState, } from './billing/use-bridge.js';
+export { BridgeSubscription } from './billing/bridge-subscription.js';
+export { fetchBillingState } from './billing/fetch-billing-state.js';
+export { QuotaStore } from './billing/quota-store.js';
+export type { QuotaSnapshot } from './billing/quota-store.js';
+export { EntitlementsStore } from './billing/entitlements-store.js';
+export type { EntitlementSnapshot } from './billing/entitlements-store.js';
+export { deriveNoticeState, deriveSeverity } from './billing/types.js';
+export type { BillingSubscriptionStatus, BillingSeverity, PastDueReason, BillingPlanRef, BillingSubscriptionState, BillingSubscriptionSnapshot, BillingNoticeState, BillingLockedPayload, MountOptions, } from './billing/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -5,7 +5,7 @@ export { TeamService } from './team-service.js';
 // API token management
 export { ApiTokenService } from './api-token-service.js';
 // Errors
-export { BridgeAuthError, HttpError } from './errors.js';
+export { BridgeAuthError, HttpError, BillingLockedError } from './errors.js';
 // Storage adapters (for custom configuration)
 export { LocalStorageAdapter, MemoryAdapter } from './token-storage.js';
 // Utilities
@@ -24,4 +24,19 @@ export { TokenManagementService } from './management/token.service.js';
 export { EventManagementService } from './management/event.service.js';
 export { OnboardingManagementService } from './management/onboarding.service.js';
 export { ManagementWorkflows } from './management/workflows.js';
+// ── Feature Flags 2.0 — locked operator set + branch evaluator ──────────────
+// Shared between bridge-api (server eval) and SDK consumers (client eval) so
+// there is no drift in semantics. See `flags/operators.ts` (per-condition
+// primitives) and `flags/evaluator.ts` (branch + rollout layer).
+export { OPERATORS, OPERATOR_VERSION, CONDITIONS_PER_RULE_MAX, isOperator, isOperatorValidForType, validOperatorsForType, evaluateCondition, validateConditions, bucket, evaluateBranch, evaluateRule, resolveAttribute, validateRule, BridgeFlags, BridgeIdentity, MemoryIdentityStorage, attachIdentity, generateAnonymousId, AttributeProviderRegistry, AuthAttributeProvider, BillingAttributeProvider, DevAttributeProvider, BridgePullCache, TelemetryBatcher, RealtimeClient, BRIDGE_CONTEXT_HEADER, serializeContext, deserializeContext, serverInstanceId, } from './flags/index.js';
+// ── Billing 2.0 — canonical SDK reactive surface (TBP-248 / US-2) ───────────
+// Parallel to FF 2.0's BridgeFlags surface. Do NOT unify with FF 2.0 yet —
+// REF-1 (post-feature) folds them. See TBP-248 for context.
+export { useBridge } from './billing/use-bridge.js';
+export { BridgeSubscription } from './billing/bridge-subscription.js';
+export { fetchBillingState } from './billing/fetch-billing-state.js';
+export { QuotaStore } from './billing/quota-store.js';
+// Billing 2.0 US-12 — entitlement cache + types.
+export { EntitlementsStore } from './billing/entitlements-store.js';
+export { deriveNoticeState, deriveSeverity } from './billing/types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAuC9C,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWhD,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQzD,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,8CAA8C;AAC9C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExE,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEtG,yCAAyC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA8B5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAuC9C,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWhD,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQzD,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE7E,8CAA8C;AAC9C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExE,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEtG,yCAAyC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA+B5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,+EAA+E;AAC/E,6EAA6E;AAC7E,0EAA0E;AAC1E,iEAAiE;AACjE,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,EACN,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAmD1B,+EAA+E;AAC/E,2EAA2E;AAC3E,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAOpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,iDAAiD;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/management-types.d.ts

@@ -189,6 +189,10 @@ export interface UpdateRoleRequest {
     privileges?: string[];
     isDefault?: boolean;
 }
+export type { Rule, Branch, FlagState } from './flags/evaluator.js';
+export type { FlagValueType } from './flags/flag.js';
+import type { Rule, FlagState } from './flags/evaluator.js';
+import type { FlagValueType } from './flags/flag.js';
 export interface TargetValue {
     operator: 'eq' | 'beginsWith' | 'endsWith' | 'contains' | 'lessThan' | 'greaterThan';
     value: string;
@@ -227,6 +231,19 @@ export interface SegmentInput {
     description?: string;
     targets?: Target[];
 }
+/**
+ * A scheduled future state transition (TBP-189).
+ *
+ * `null` clears any existing schedule on a write. The runner that flips the
+ * state at the appointed time is implemented separately; the management types
+ * just describe the persisted shape.
+ */
+export interface FlagSchedule {
+    /** ISO-8601 timestamp at which the transition fires. */
+    at: string;
+    /** Target state the runner will set when the timer fires. */
+    state: FlagState;
+}
 export interface FlagResponse {
     id: string;
     key: string;
@@ -235,6 +252,15 @@ export interface FlagResponse {
     segments: SegmentResponse[];
     targetValue?: boolean;
     enabled: boolean;
+    state?: FlagState;
+    valueType?: FlagValueType;
+    offValue?: unknown;
+    onValue?: unknown;
+    rule?: Rule | null;
+    schedule?: FlagSchedule | null;
+    evalCount?: number;
+    /** ISO-8601 timestamp of the most recent eval, or null when never evaluated. */
+    lastEvalAt?: string | null;
 }
 export interface CreateFlagInput {
     key: string;
@@ -243,6 +269,12 @@ export interface CreateFlagInput {
     segments?: string[];
     targetValue?: boolean;
     enabled?: boolean;
+    state?: FlagState;
+    valueType?: FlagValueType;
+    offValue?: unknown;
+    onValue?: unknown;
+    rule?: Rule | null;
+    schedule?: FlagSchedule | null;
 }
 export interface UpdateFlagInput {
     key?: string;
@@ -251,6 +283,12 @@ export interface UpdateFlagInput {
     segments?: string[];
     targetValue?: boolean;
     enabled?: boolean;
+    state?: FlagState;
+    valueType?: FlagValueType;
+    offValue?: unknown;
+    onValue?: unknown;
+    rule?: Rule | null;
+    schedule?: FlagSchedule | null;
 }
 export interface BrandingResponse {
     bgColor: string;