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

package/dist/usage/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usage/storage/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,4DAA4D;AAC5D,iCAAiC;AACjC,8BAA8B;AAC9B,sDAAsD;AACtD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,wEAAwE;AACxE,WAAW;AAEX,OAAO,EACL,YAAY,EACZ,SAAS,GAGV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAIL,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,OAA8B,EAAE;IACnE,IAAI,YAAY,EAAE;QAAE,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,SAAS,EAAE;QAAE,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/usage/storage/indexeddb-storage.d.ts

@@ -0,0 +1,18 @@
+import { type DurableStorage, type DurableStorageOptions, type QueuedEvent } from './durable-storage.js';
+export declare class IndexedDBStorage implements DurableStorage {
+    private _dbPromise?;
+    private maxSize;
+    constructor(opts?: DurableStorageOptions);
+    enqueue(event: QueuedEvent): Promise<void>;
+    peek(limit: number): Promise<QueuedEvent[]>;
+    remove(keys: string[]): Promise<void>;
+    markRetry(key: string, error: string): Promise<void>;
+    size(): Promise<number>;
+    configure(opts: {
+        maxSize?: number;
+    }): void;
+    close(): Promise<void>;
+    private _db;
+    private _enforceMaxSize;
+}
+//# sourceMappingURL=indexeddb-storage.d.ts.map

package/dist/usage/storage/indexeddb-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-storage.d.ts","sourceRoot":"","sources":["../../../src/usage/storage/indexeddb-storage.ts"],"names":[],"mappings":"AAkBA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAM9B,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,UAAU,CAAC,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,GAAE,qBAA0B;IAStC,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAa3C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAarC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAW7B,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,GAAG;YAmBG,eAAe;CA0B9B"}

package/dist/usage/storage/indexeddb-storage.js

@@ -0,0 +1,159 @@
+// Billing 2.0 US-19 (TBP-270) — IndexedDB-backed `DurableStorage` (browser).
+//
+// Single object store `usage_queue` keyed on `idempotencyKey`. Uses the raw
+// IndexedDB API directly to avoid pulling `idb` (or any other dep) into
+// auth-core's tree.
+//
+// Schema versioning: v1 — single store, key-path `idempotencyKey`. If we
+// ever change shape we bump the DB version and add an `onupgradeneeded`
+// migration. v1 is intentionally minimal.
+//
+// Concurrency: each call opens a fresh transaction. The DB handle is cached
+// across calls (`_dbPromise`). IndexedDB itself serializes transactions.
+//
+// Tree-shake isolation: this file references `indexedDB` / `IDBDatabase`
+// directly — bundlers MUST NOT include this in Node-only builds. The
+// factory in `./index.ts` is the only consumer; `node-fs-storage.ts` lives
+// in a sibling file so the two never share a module graph.
+import { DEFAULT_MAX_SIZE, isBrowserEnv, } from './durable-storage.js';
+const DB_NAME = 'bridge-usage-queue';
+const DB_VERSION = 1;
+const STORE_NAME = 'usage_queue';
+export class IndexedDBStorage {
+    _dbPromise;
+    maxSize;
+    constructor(opts = {}) {
+        if (!isBrowserEnv()) {
+            throw new Error('[bridge-usage] IndexedDBStorage requires a browser environment (window + indexedDB).');
+        }
+        this.maxSize = opts.maxSize ?? DEFAULT_MAX_SIZE;
+    }
+    async enqueue(event) {
+        const db = await this._db();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            // `put` upserts on the idempotencyKey — same key = same logical event.
+            store.put(event);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error ?? new Error('enqueue tx failed'));
+            tx.onabort = () => reject(tx.error ?? new Error('enqueue tx aborted'));
+        });
+        await this._enforceMaxSize();
+    }
+    async peek(limit) {
+        if (limit <= 0)
+            return [];
+        const db = await this._db();
+        const events = await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readonly');
+            const store = tx.objectStore(STORE_NAME);
+            const req = store.getAll();
+            req.onsuccess = () => resolve((req.result ?? []));
+            req.onerror = () => reject(req.error ?? new Error('peek failed'));
+        });
+        return events.sort((a, b) => a.enqueuedAt - b.enqueuedAt).slice(0, limit);
+    }
+    async remove(keys) {
+        if (keys.length === 0)
+            return;
+        const db = await this._db();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            for (const k of keys)
+                store.delete(k);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error ?? new Error('remove tx failed'));
+            tx.onabort = () => reject(tx.error ?? new Error('remove tx aborted'));
+        });
+    }
+    async markRetry(key, error) {
+        const db = await this._db();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            const getReq = store.get(key);
+            getReq.onsuccess = () => {
+                const existing = getReq.result;
+                if (!existing) {
+                    resolve();
+                    return;
+                }
+                existing.retryCount = (existing.retryCount ?? 0) + 1;
+                existing.lastError = error;
+                store.put(existing);
+            };
+            getReq.onerror = () => reject(getReq.error ?? new Error('markRetry get failed'));
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error ?? new Error('markRetry tx failed'));
+            tx.onabort = () => reject(tx.error ?? new Error('markRetry tx aborted'));
+        });
+    }
+    async size() {
+        const db = await this._db();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readonly');
+            const store = tx.objectStore(STORE_NAME);
+            const req = store.count();
+            req.onsuccess = () => resolve(req.result ?? 0);
+            req.onerror = () => reject(req.error ?? new Error('size failed'));
+        });
+    }
+    configure(opts) {
+        if (typeof opts.maxSize === 'number' && opts.maxSize > 0) {
+            this.maxSize = opts.maxSize;
+        }
+    }
+    async close() {
+        if (!this._dbPromise)
+            return;
+        const db = await this._dbPromise;
+        db.close();
+        this._dbPromise = undefined;
+    }
+    _db() {
+        if (!this._dbPromise) {
+            this._dbPromise = new Promise((resolve, reject) => {
+                const req = indexedDB.open(DB_NAME, DB_VERSION);
+                req.onupgradeneeded = () => {
+                    const db = req.result;
+                    if (!db.objectStoreNames.contains(STORE_NAME)) {
+                        db.createObjectStore(STORE_NAME, { keyPath: 'idempotencyKey' });
+                    }
+                };
+                req.onsuccess = () => resolve(req.result);
+                req.onerror = () => reject(req.error ?? new Error('IndexedDB open failed'));
+                req.onblocked = () => reject(new Error('IndexedDB open blocked (another tab holds an older version)'));
+            });
+        }
+        return this._dbPromise;
+    }
+    async _enforceMaxSize() {
+        const currentSize = await this.size();
+        if (currentSize <= this.maxSize)
+            return;
+        const overflow = currentSize - this.maxSize;
+        // Read all, sort by enqueuedAt, drop the oldest N.
+        const db = await this._db();
+        const oldestKeys = await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readonly');
+            const store = tx.objectStore(STORE_NAME);
+            const req = store.getAll();
+            req.onsuccess = () => {
+                const all = (req.result ?? [])
+                    .sort((a, b) => a.enqueuedAt - b.enqueuedAt)
+                    .slice(0, overflow)
+                    .map((e) => e.idempotencyKey);
+                resolve(all);
+            };
+            req.onerror = () => reject(req.error ?? new Error('enforceMaxSize getAll failed'));
+        });
+        if (oldestKeys.length === 0)
+            return;
+        await this.remove(oldestKeys);
+        // eslint-disable-next-line no-console
+        console.warn(`[bridge-usage] queue at max-size (${this.maxSize}); dropping oldest event`);
+    }
+}
+//# sourceMappingURL=indexeddb-storage.js.map

package/dist/usage/storage/indexeddb-storage.js.map

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

package/dist/usage/storage/node-fs-storage.d.ts

@@ -0,0 +1,29 @@
+import { type DurableStorage, type DurableStorageOptions, type QueuedEvent } from './durable-storage.js';
+export declare class NodeFsStorage implements DurableStorage {
+    private maxSize;
+    private dirPromise?;
+    private writeChain;
+    private fsP?;
+    private pathP?;
+    private osP?;
+    private readonly explicitDir?;
+    constructor(opts?: DurableStorageOptions);
+    enqueue(event: QueuedEvent): Promise<void>;
+    peek(limit: number): Promise<QueuedEvent[]>;
+    remove(keys: string[]): Promise<void>;
+    markRetry(key: string, error: string): Promise<void>;
+    size(): Promise<number>;
+    configure(opts: {
+        maxSize?: number;
+    }): void;
+    close(): Promise<void>;
+    private _serialize;
+    private _readAll;
+    private _enforceMaxSizeLocked;
+    private _files;
+    private _fs;
+    private _path;
+    private _os;
+    private _dir;
+}
+//# sourceMappingURL=node-fs-storage.d.ts.map

package/dist/usage/storage/node-fs-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs-storage.d.ts","sourceRoot":"","sources":["../../../src/usage/storage/node-fs-storage.ts"],"names":[],"mappings":"AAqBA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAM9B,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,GAAG,CAAC,CAAoB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAsB;IACpC,OAAO,CAAC,GAAG,CAAC,CAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAE1B,IAAI,GAAE,qBAA0B;IAUtC,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAM3C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,UAAU;YAOJ,QAAQ;YA8BR,qBAAqB;YAcrB,MAAM;IAOpB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,IAAI;CAab"}

package/dist/usage/storage/node-fs-storage.js

@@ -0,0 +1,180 @@
+// Billing 2.0 US-19 (TBP-270) — Filesystem-backed `DurableStorage` (Node).
+//
+// Stores the queue as JSON Lines (`.jsonl`) under a configurable directory
+// (default `~/.bridge/usage-queue/queue.jsonl`).
+//
+// Design choices (v1):
+//   - Append-only writes for `enqueue` (cheap, durable).
+//   - `remove` rewrites the whole file without the removed keys. Acceptable
+//     for v1 — the queue rarely exceeds a few KB in practice. If it ever
+//     gets large enough that rewrites hurt, we can switch to SQLite (better-
+//     sqlite3) or a tombstone scheme.
+//   - `peek` reads + parses the file each call. Same v1 trade-off.
+//   - Concurrency safety inside a single process: an in-memory promise chain
+//     serializes all writes. We do NOT attempt multi-process locking — bridge
+//     SDK consumers run a single process per app instance.
+//
+// Tree-shake isolation: this file uses `node:fs/promises` and `node:path` via
+// `await import()` so bundlers that target the browser can statically prove
+// the module never executes the imports. The IndexedDB sibling never reaches
+// into this file's graph.
+import { DEFAULT_MAX_SIZE, isNodeEnv, } from './durable-storage.js';
+export class NodeFsStorage {
+    maxSize;
+    dirPromise;
+    writeChain = Promise.resolve();
+    fsP;
+    pathP;
+    osP;
+    explicitDir;
+    constructor(opts = {}) {
+        if (!isNodeEnv()) {
+            throw new Error('[bridge-usage] NodeFsStorage requires a Node environment (process.versions.node).');
+        }
+        this.maxSize = opts.maxSize ?? DEFAULT_MAX_SIZE;
+        this.explicitDir = opts.nodeDir;
+    }
+    async enqueue(event) {
+        await this._serialize(async () => {
+            const { fs, file } = await this._files();
+            const line = JSON.stringify(event) + '\n';
+            await fs.appendFile(file, line, 'utf8');
+            await this._enforceMaxSizeLocked();
+        });
+    }
+    async peek(limit) {
+        if (limit <= 0)
+            return [];
+        const events = await this._readAll();
+        return events.sort((a, b) => a.enqueuedAt - b.enqueuedAt).slice(0, limit);
+    }
+    async remove(keys) {
+        if (keys.length === 0)
+            return;
+        const dropSet = new Set(keys);
+        await this._serialize(async () => {
+            const { fs, file } = await this._files();
+            const events = await this._readAll();
+            const kept = events.filter((e) => !dropSet.has(e.idempotencyKey));
+            const body = kept.map((e) => JSON.stringify(e)).join('\n');
+            await fs.writeFile(file, body.length > 0 ? body + '\n' : '', 'utf8');
+        });
+    }
+    async markRetry(key, error) {
+        await this._serialize(async () => {
+            const { fs, file } = await this._files();
+            const events = await this._readAll();
+            let touched = false;
+            for (const e of events) {
+                if (e.idempotencyKey === key) {
+                    e.retryCount = (e.retryCount ?? 0) + 1;
+                    e.lastError = error;
+                    touched = true;
+                }
+            }
+            if (!touched)
+                return;
+            const body = events.map((e) => JSON.stringify(e)).join('\n');
+            await fs.writeFile(file, body.length > 0 ? body + '\n' : '', 'utf8');
+        });
+    }
+    async size() {
+        const events = await this._readAll();
+        return events.length;
+    }
+    configure(opts) {
+        if (typeof opts.maxSize === 'number' && opts.maxSize > 0) {
+            this.maxSize = opts.maxSize;
+        }
+    }
+    async close() {
+        // No persistent handles to close — we open/close on each call.
+        await this.writeChain.catch(() => undefined);
+    }
+    // --- internals ---
+    _serialize(fn) {
+        const next = this.writeChain.then(fn, fn);
+        // Keep the chain rejection-tolerant so one failure doesn't poison the queue.
+        this.writeChain = next.catch(() => undefined);
+        return next;
+    }
+    async _readAll() {
+        const { fs, file } = await this._files();
+        let raw;
+        try {
+            raw = await fs.readFile(file, 'utf8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw err;
+        }
+        if (!raw)
+            return [];
+        const out = [];
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed &&
+                    typeof parsed.idempotencyKey === 'string' &&
+                    typeof parsed.metric === 'string') {
+                    out.push(parsed);
+                }
+            }
+            catch {
+                // Skip malformed lines — better to lose one event than block the queue.
+            }
+        }
+        return out;
+    }
+    async _enforceMaxSizeLocked() {
+        const events = await this._readAll();
+        if (events.length <= this.maxSize)
+            return;
+        const sorted = events.sort((a, b) => a.enqueuedAt - b.enqueuedAt);
+        const kept = sorted.slice(sorted.length - this.maxSize);
+        const { fs, file } = await this._files();
+        const body = kept.map((e) => JSON.stringify(e)).join('\n');
+        await fs.writeFile(file, body.length > 0 ? body + '\n' : '', 'utf8');
+        // eslint-disable-next-line no-console
+        console.warn(`[bridge-usage] queue at max-size (${this.maxSize}); dropping oldest event`);
+    }
+    async _files() {
+        const fs = await this._fs();
+        const dir = await this._dir();
+        const path = await this._path();
+        return { fs, file: path.join(dir, 'queue.jsonl') };
+    }
+    _fs() {
+        if (!this.fsP)
+            this.fsP = import('node:fs/promises');
+        return this.fsP;
+    }
+    _path() {
+        if (!this.pathP)
+            this.pathP = import('node:path');
+        return this.pathP;
+    }
+    _os() {
+        if (!this.osP)
+            this.osP = import('node:os');
+        return this.osP;
+    }
+    _dir() {
+        if (!this.dirPromise) {
+            this.dirPromise = (async () => {
+                const fs = await this._fs();
+                const path = await this._path();
+                const os = await this._os();
+                const dir = this.explicitDir ?? path.join(os.homedir(), '.bridge', 'usage-queue');
+                await fs.mkdir(dir, { recursive: true });
+                return dir;
+            })();
+        }
+        return this.dirPromise;
+    }
+}
+//# sourceMappingURL=node-fs-storage.js.map

package/dist/usage/storage/node-fs-storage.js.map

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

package/dist/usage/storage/noop-storage.d.ts

@@ -0,0 +1,17 @@
+import { type DurableStorage, type DurableStorageOptions, type QueuedEvent } from './durable-storage.js';
+export declare class InMemoryStorage implements DurableStorage {
+    private readonly map;
+    private maxSize;
+    constructor(opts?: DurableStorageOptions);
+    enqueue(event: QueuedEvent): Promise<void>;
+    peek(limit: number): Promise<QueuedEvent[]>;
+    remove(keys: string[]): Promise<void>;
+    markRetry(key: string, error: string): Promise<void>;
+    size(): Promise<number>;
+    configure(opts: {
+        maxSize?: number;
+    }): void;
+    close(): Promise<void>;
+    private _enforceMaxSize;
+}
+//# sourceMappingURL=noop-storage.d.ts.map

package/dist/usage/storage/noop-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-storage.d.ts","sourceRoot":"","sources":["../../../src/usage/storage/noop-storage.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,eAAgB,YAAW,cAAc;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkC;IACtD,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,GAAE,qBAA0B;IAItC,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ3C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,eAAe;CAmBxB"}

package/dist/usage/storage/noop-storage.js

@@ -0,0 +1,67 @@
+// Billing 2.0 US-19 (TBP-270) — In-memory `DurableStorage` impl.
+//
+// Used as a fallback when neither browser nor Node env is detected (SSR
+// edge runtimes, sandboxed iframes with IndexedDB disabled, etc.). NOT
+// durable across process crashes — but matches the API surface so the
+// UsageReporter doesn't need to branch.
+import { DEFAULT_MAX_SIZE, } from './durable-storage.js';
+export class InMemoryStorage {
+    map = new Map();
+    maxSize;
+    constructor(opts = {}) {
+        this.maxSize = opts.maxSize ?? DEFAULT_MAX_SIZE;
+    }
+    async enqueue(event) {
+        this.map.set(event.idempotencyKey, event);
+        this._enforceMaxSize();
+    }
+    async peek(limit) {
+        // Iteration order on Map is insertion order, which matches enqueuedAt for
+        // typical use. We still sort defensively in case `enqueue` was called with
+        // historical timestamps (e.g. hydrated-from-elsewhere).
+        const all = Array.from(this.map.values()).sort((a, b) => a.enqueuedAt - b.enqueuedAt);
+        return all.slice(0, Math.max(0, limit));
+    }
+    async remove(keys) {
+        for (const k of keys)
+            this.map.delete(k);
+    }
+    async markRetry(key, error) {
+        const existing = this.map.get(key);
+        if (!existing)
+            return;
+        existing.retryCount += 1;
+        existing.lastError = error;
+    }
+    async size() {
+        return this.map.size;
+    }
+    configure(opts) {
+        if (typeof opts.maxSize === 'number' && opts.maxSize > 0) {
+            this.maxSize = opts.maxSize;
+            this._enforceMaxSize();
+        }
+    }
+    async close() {
+        // no-op
+    }
+    _enforceMaxSize() {
+        while (this.map.size > this.maxSize) {
+            // Drop oldest by enqueuedAt
+            let oldestKey;
+            let oldestTs = Number.POSITIVE_INFINITY;
+            for (const ev of this.map.values()) {
+                if (ev.enqueuedAt < oldestTs) {
+                    oldestTs = ev.enqueuedAt;
+                    oldestKey = ev.idempotencyKey;
+                }
+            }
+            if (oldestKey === undefined)
+                break;
+            this.map.delete(oldestKey);
+            // eslint-disable-next-line no-console
+            console.warn(`[bridge-usage] queue at max-size (${this.maxSize}); dropping oldest event`);
+        }
+    }
+}
+//# sourceMappingURL=noop-storage.js.map

package/dist/usage/storage/noop-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-storage.js","sourceRoot":"","sources":["../../../src/usage/storage/noop-storage.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,wEAAwE;AACxE,uEAAuE;AACvE,sEAAsE;AACtE,wCAAwC;AAExC,OAAO,EACL,gBAAgB,GAIjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,OAAO,eAAe;IACT,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,OAAO,CAAS;IAExB,YAAY,OAA8B,EAAE;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAkB;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,0EAA0E;QAC1E,2EAA2E;QAC3E,wDAAwD;QACxD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACtF,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAc;QACzB,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAa;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC;QACzB,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,IAA0B;QAClC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,QAAQ;IACV,CAAC;IAEO,eAAe;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,4BAA4B;YAC5B,IAAI,SAA6B,CAAC;YAClC,IAAI,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC;YACxC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnC,IAAI,EAAE,CAAC,UAAU,GAAG,QAAQ,EAAE,CAAC;oBAC7B,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC;oBACzB,SAAS,GAAG,EAAE,CAAC,cAAc,CAAC;gBAChC,CAAC;YACH,CAAC;YACD,IAAI,SAAS,KAAK,SAAS;gBAAE,MAAM;YACnC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACV,qCAAqC,IAAI,CAAC,OAAO,0BAA0B,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/usage/usage-reporter.d.ts

@@ -0,0 +1,64 @@
+import { type DurableStorage } from './storage/index.js';
+export interface UsageReporterOptions {
+    /** Bridge API base URL (e.g. https://api.thebridge.dev or http://localhost:3500). */
+    apiBaseUrl: string;
+    /** Accessor for the current user's access token. Returns null when unauthenticated. */
+    getAccessToken: () => string | null;
+    /** Optional logger. Defaults to a `console`-shaped stub that warns on failures. */
+    logger?: {
+        warn(...args: unknown[]): void;
+    };
+    /** Maximum events drained per flush. Default 10. */
+    batchSize?: number;
+    /** Debounce window before flushing the queue. Default 1000ms. */
+    flushIntervalMs?: number;
+    /** Optional fetch override — primarily for tests. */
+    fetchFn?: typeof fetch;
+    /**
+     * Durable storage backend. Defaults to `createDurableStorage()` which
+     * auto-detects browser / Node / fallback. Tests can inject `InMemoryStorage`.
+     */
+    storage?: DurableStorage;
+}
+export interface QueueStatus {
+    /** Current queue depth (events awaiting flush). */
+    queueDepth: number;
+    /** Sum of retryCount across all queued events. */
+    retryCount: number;
+    /** Unix ms of the last flush attempt (success or failure). Null if never flushed. */
+    lastFlushTimestamp: number | null;
+    /** Last error message recorded during a flush, or null if last flush was clean. */
+    lastFlushError: string | null;
+}
+export declare class UsageReporter {
+    private readonly apiBaseUrl;
+    private readonly getAccessToken;
+    private readonly logger;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private readonly fetchFn;
+    private readonly storage;
+    private timer;
+    private stopped;
+    private flushing;
+    private _lastFlushTimestamp;
+    private _lastFlushError;
+    constructor(opts: UsageReporterOptions);
+    /**
+     * Enqueue a usage event. Non-blocking — schedules a debounced flush.
+     * `idempotencyKey` is auto-generated via `crypto.randomUUID()` when omitted
+     * and persisted with the event so crash/restart replays use the SAME key.
+     */
+    report(metric: string, value?: number, idempotencyKey?: string): void;
+    /** Force an immediate drain of the queue. Resolves once all in-flight POSTs settle. */
+    flushNow(): Promise<void>;
+    /** Read-only queue observability — for dev-facing monitoring. */
+    getQueueStatus(): Promise<QueueStatus>;
+    /** Cancel pending timer and drain. Idempotent — safe to call multiple times. */
+    shutdown(): void;
+    private _maybeHydrate;
+    private _scheduleFlush;
+    private _flush;
+    private _flushInner;
+}
+//# sourceMappingURL=usage-reporter.d.ts.map

package/dist/usage/usage-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reporter.d.ts","sourceRoot":"","sources":["../../src/usage/usage-reporter.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,cAAc,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpC,mFAAmF;IACnF,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5C,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAA4B;IAG5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,eAAe,CAAuB;gBAElC,IAAI,EAAE,oBAAoB;IActC;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAkB/E,uFAAuF;IAC1E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtC,iEAAiE;IACpD,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAYnD,gFAAgF;IACzE,QAAQ,IAAI,IAAI;YAeT,aAAa;IAY3B,OAAO,CAAC,cAAc;YASR,MAAM;YASN,WAAW;CAgF1B"}