@proappstore/sdk 1.16.94 → 1.16.96

package/dist/offline/jobs.js

@@ -0,0 +1,204 @@
+import { OfflineError } from './store.js';
+import { offlineLock } from './locks.js';
+const validId = (id) => {
+    if (!id || id.length > 256)
+        throw new OfflineError('invalid', 'Work ids must contain 1–256 characters.');
+};
+const errorText = (error) => (error instanceof Error ? error.message : String(error)).slice(0, 1000);
+const checkAbort = (signal) => { if (signal?.aborted)
+    throw new DOMException('Work cancelled.', 'AbortError'); };
+export class LocalJobs {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    create(input) {
+        validId(input.id);
+        validId(input.kind);
+        return this.store.transaction(['jobs'], 'readwrite', (tx, done) => {
+            const request = tx.objectStore('jobs').get(input.id);
+            request.onsuccess = () => {
+                if (request.result) {
+                    tx.abort();
+                    return;
+                }
+                const row = { ...input, checkpoint: null, result: null, status: 'pending', attempts: 0, updatedAt: Date.now(), error: null };
+                tx.objectStore('jobs').put(row, row.id);
+                done(row);
+            };
+        });
+    }
+    get(id) { return this.store.read('jobs', id); }
+    list(options = {}) { return this.store.page('jobs', options); }
+    update(id, change) {
+        return this.store.transaction(['jobs'], 'readwrite', (tx, done) => {
+            const request = tx.objectStore('jobs').get(id);
+            request.onsuccess = () => {
+                if (!request.result) {
+                    tx.abort();
+                    return;
+                }
+                const next = { ...change(request.result), updatedAt: Date.now() };
+                tx.objectStore('jobs').put(next, id);
+                done(next);
+            };
+        });
+    }
+    async checkpoint(id, value) { await this.update(id, (row) => ({ ...row, checkpoint: value })); }
+    async setStatus(id, status) {
+        if (!['pending', 'running', 'paused', 'interrupted', 'completed', 'failed'].includes(status))
+            throw new OfflineError('invalid', 'Unknown local job status.');
+        await this.update(id, (row) => ({ ...row, status }));
+    }
+    /** No automatic execution. Re-entering run() passes the last committed checkpoint. */
+    async run(id, handler, options = {}) {
+        return this.store.runWork(() => offlineLock(`${this.store.databaseName}:jobs`, async () => {
+            checkAbort(options.signal);
+            const found = await this.get(id);
+            if (!found)
+                throw new OfflineError('invalid', 'Local job does not exist.');
+            if (found.status === 'completed')
+                return found;
+            await this.update(id, (row) => ({ ...row, status: 'running', attempts: row.attempts + 1, error: null }));
+            try {
+                const result = await handler(found.input, {
+                    savedCheckpoint: found.checkpoint, signal: options.signal,
+                    checkpoint: async (value) => { checkAbort(options.signal); await this.checkpoint(id, value); },
+                });
+                checkAbort(options.signal);
+                return await this.update(id, (row) => ({ ...row, result, status: 'completed' }));
+            }
+            catch (error) {
+                // A locked account deliberately prevents further writes; its running job
+                // can be recovered after the owner explicitly opens it again.
+                try {
+                    await this.update(id, (row) => ({ ...row, status: options.signal?.aborted ? 'paused' : 'failed', error: errorText(error) }));
+                }
+                catch { /* Preserve the original failure; no unlocked-account fallback. */ }
+                throw error;
+            }
+        }, true, options.signal ? { signal: options.signal } : {}), options.signal);
+    }
+    /** The same Web Lock excludes active SDK runners before recovery. */
+    async recover() {
+        return this.store.runWork(() => offlineLock(`${this.store.databaseName}:jobs`, () => this.store.transaction(['jobs'], 'readwrite', (tx, done) => {
+            let count = 0;
+            const request = tx.objectStore('jobs').openCursor();
+            request.onsuccess = () => {
+                const cursor = request.result;
+                if (!cursor) {
+                    done(count);
+                    return;
+                }
+                const row = cursor.value;
+                if (row.status === 'running') {
+                    cursor.update({ ...row, status: 'interrupted', updatedAt: Date.now() });
+                    count++;
+                }
+                cursor.continue();
+            };
+        }), true));
+    }
+}
+/** At-least-once delivery. Handlers MUST enforce server idempotency using operationId. */
+export class SyncQueue {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async enqueue(input) {
+        validId(input.id);
+        validId(input.kind);
+        if (input.idempotent !== true)
+            throw new OfflineError('invalid', 'Only explicitly idempotent operations may be queued.');
+        return this.store.transaction(['outbox'], 'readwrite', (tx, done) => {
+            const request = tx.objectStore('outbox').get(input.id);
+            request.onsuccess = () => {
+                // A duplicate id cannot replace another payload (including after delivery).
+                if (request.result) {
+                    tx.abort();
+                    return;
+                }
+                const row = { id: input.id, kind: input.kind, payload: input.payload, status: 'pending', attempts: 0, updatedAt: Date.now(), error: null };
+                tx.objectStore('outbox').put(row, row.id);
+                done(row);
+            };
+        });
+    }
+    get(id) { return this.store.read('outbox', id); }
+    list(options = {}) { return this.store.page('outbox', options); }
+    async change(id, status, error, increment = false) {
+        return this.store.transaction(['outbox'], 'readwrite', (tx, done) => {
+            const request = tx.objectStore('outbox').get(id);
+            request.onsuccess = () => {
+                if (!request.result) {
+                    tx.abort();
+                    return;
+                }
+                const row = request.result;
+                tx.objectStore('outbox').put({ ...row, status, error, attempts: row.attempts + Number(increment), updatedAt: Date.now() }, id);
+                done(undefined);
+            };
+        });
+    }
+    retry(id) {
+        return this.store.runWork(() => offlineLock(`${this.store.databaseName}:sync`, async () => {
+            const row = await this.get(id);
+            if (!row || row.status !== 'failed')
+                throw new OfflineError('invalid', 'Only a failed operation can be retried.');
+            await this.change(id, 'pending', null);
+        }, true));
+    }
+    /** Explicit caller action; never triggered automatically by an online event. */
+    flush(handlers, options = {}) {
+        const limit = options.limit ?? 50;
+        if (!Number.isInteger(limit) || limit < 1 || limit > 200)
+            throw new OfflineError('invalid', 'Flush limit must be between 1 and 200.');
+        return this.store.runWork(() => offlineLock(`${this.store.databaseName}:sync`, async () => {
+            checkAbort(options.signal);
+            const pending = await this.store.transaction(['outbox'], 'readonly', (tx, done) => {
+                const rows = [];
+                const request = tx.objectStore('outbox').openCursor();
+                request.onsuccess = () => {
+                    const cursor = request.result;
+                    if (!cursor || rows.length >= limit) {
+                        done(rows);
+                        return;
+                    }
+                    const row = cursor.value;
+                    // Running after acquiring the lock means a previous tab terminated.
+                    if (row.status === 'pending' || row.status === 'running')
+                        rows.push(row);
+                    cursor.continue();
+                };
+            });
+            let completed = 0, failed = 0;
+            for (const row of pending) {
+                checkAbort(options.signal);
+                this.store.assertAccess();
+                const handler = Object.hasOwn(handlers, row.kind) ? handlers[row.kind] : undefined;
+                if (!handler) {
+                    await this.change(row.id, 'failed', 'No handler registered for this operation.');
+                    failed++;
+                    continue;
+                }
+                await this.change(row.id, 'running', null, true);
+                try {
+                    await handler(row.payload, { operationId: row.id, signal: options.signal });
+                    await this.change(row.id, 'completed', null);
+                    completed++;
+                }
+                catch (error) {
+                    await this.change(row.id, options.signal?.aborted ? 'pending' : 'failed', errorText(error));
+                    if (options.signal?.aborted)
+                        throw error;
+                    failed++;
+                }
+            }
+            return { completed, failed };
+        }, true, options.signal ? { signal: options.signal } : {}), options.signal);
+    }
+}
+export function createLocalJobs(store) { return new LocalJobs(store); }
+export function createSyncQueue(store) { return new SyncQueue(store); }
+//# sourceMappingURL=jobs.js.map

package/dist/offline/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/offline/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqC,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASzC,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,EAAE;IAC7B,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,yCAAyC,CAAC,CAAC;AAC3G,CAAC,CAAC;AACF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9G,MAAM,UAAU,GAAG,CAAC,MAAoB,EAAE,EAAE,GAAG,IAAI,MAAM,EAAE,OAAO;IAAE,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/H,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IACpD,MAAM,CAAI,KAA6C;QACrD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;YAChE,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;gBACvB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBAC3C,MAAM,GAAG,GAAgB,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;gBAC1I,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrD,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,GAAG,CAAwC,EAAU,IAAuC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACjI,IAAI,CAAC,UAAqB,EAAE,IAAyB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,EAAU,EAAE,MAAmC;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;YAChE,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;gBACvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBAC5C,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAkB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC9E,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnD,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,UAAU,CAAI,EAAU,EAAE,KAAQ,IAAmB,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7H,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,MAAsB;QAChD,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;QAC7J,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,sFAAsF;IACtF,KAAK,CAAC,GAAG,CAAwC,EAAU,EAAE,OAAiC,EAAE,UAAoC,EAAE;QACpI,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,KAAK,IAAI,EAAE;YACxF,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAU,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;YAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO,KAAK,CAAC;YAC/C,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACzG,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE;oBACxC,eAAe,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM;oBACzD,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;iBAC/F,CAAC,CAAC;gBACH,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC3B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAsB,CAAC;YACxG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,yEAAyE;gBACzE,8DAA8D;gBAC9D,IAAI,CAAC;oBAAC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;gBAAC,CAAC;gBACrI,MAAM,CAAC,CAAC,kEAAkE,CAAC,CAAC;gBAC5E,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,CAAC;IACD,qEAAqE;IACrE,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;YAC9I,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;YACpD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;gBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;oBAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBACrC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAiB,CAAC;gBACrC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;gBACnH,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,CAAC,CAAC;QACJ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACb,CAAC;CACF;AAKD,0FAA0F;AAC1F,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IACpD,KAAK,CAAC,OAAO,CAAC,KAAuE;QACnF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,sDAAsD,CAAC,CAAC;QACzH,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;YAClE,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;gBACvB,4EAA4E;gBAC5E,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBAC3C,MAAM,GAAG,GAAkB,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;gBAC1J,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvD,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,GAAG,CAAC,EAAU,IAAmC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,CAAC,UAAqB,EAAE,IAA8B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9F,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA+B,EAAE,KAAoB,EAAE,SAAS,GAAG,KAAK;QACvG,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;YAClE,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;gBACvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAuB,CAAC;gBAC5C,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClJ,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,EAAU;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,KAAK,IAAI,EAAE;YACxF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;gBAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,yCAAyC,CAAC,CAAC;YAClH,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,gFAAgF;IAChF,KAAK,CAAC,QAAqC,EAAE,UAAoD,EAAE;QACjG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG;YAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,wCAAwC,CAAC,CAAC;QACtI,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,KAAK,IAAI,EAAE;YACxF,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAkB,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;gBACjG,MAAM,IAAI,GAAoB,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,CAAC;gBACtD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;oBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;oBAC9B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;wBAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAAC,OAAO;oBAAC,CAAC;oBAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAsB,CAAC;oBAC1C,oEAAoE;oBACpE,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;wBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACzE,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,IAAI,SAAS,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;YAC9B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACtD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnF,IAAI,CAAC,OAAO,EAAE,CAAC;oBAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,2CAA2C,CAAC,CAAC;oBAAC,MAAM,EAAE,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBACvH,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;oBAC5E,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;oBAAC,SAAS,EAAE,CAAC;gBAC5D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC5F,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;wBAAE,MAAM,KAAK,CAAC;oBACzC,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAC/B,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAmB,IAAe,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChG,MAAM,UAAU,eAAe,CAAC,KAAmB,IAAe,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/offline/locks.d.ts

@@ -0,0 +1,6 @@
+export declare function offlineLock<T>(name: string, work: () => Promise<T>, requireBrowserLock?: boolean, options?: {
+    mode?: 'shared' | 'exclusive';
+    signal?: AbortSignal;
+    ifAvailable?: boolean;
+}): Promise<T>;
+//# sourceMappingURL=locks.d.ts.map

package/dist/offline/locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/offline/locks.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,kBAAkB,UAAQ,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAuB/M"}

package/dist/offline/locks.js

@@ -0,0 +1,47 @@
+import { OfflineError } from './store.js';
+// Web Locks coordinate tabs/workers. Non-browser tests use realm-local queues.
+const queues = new Map();
+const readers = new Map();
+export async function offlineLock(name, work, requireBrowserLock = false, options = {}) {
+    if (typeof navigator !== 'undefined' && navigator.locks) {
+        return navigator.locks.request(`pas:${name}`, options, (lock) => {
+            if (!lock)
+                throw new OfflineError('busy', 'Local work is active. Cancel or finish it before clearing storage.');
+            return work();
+        });
+    }
+    if (requireBrowserLock && (typeof window !== 'undefined' || typeof self !== 'undefined'))
+        throw new OfflineError('unavailable', 'This browser cannot coordinate offline work between tabs.');
+    const run = () => { if (options.signal?.aborted)
+        throw new DOMException('Work cancelled.', 'AbortError'); return work(); };
+    if (options.ifAvailable && ((readers.get(name) ?? 0) > 0 || queues.has(name)))
+        throw new OfflineError('busy', 'Local work is active. Cancel or finish it before clearing storage.');
+    if (options.mode === 'shared') {
+        // Purge uses ifAvailable and never queues a writer ahead of nested readers.
+        const exclusive = queues.get(name);
+        if (exclusive)
+            await exclusive.catch(() => { });
+        readers.set(name, (readers.get(name) ?? 0) + 1);
+        try {
+            return await run();
+        }
+        finally {
+            const count = (readers.get(name) ?? 1) - 1;
+            if (count)
+                readers.set(name, count);
+            else
+                readers.delete(name);
+        }
+    }
+    const prior = queues.get(name) ?? Promise.resolve();
+    const next = prior.catch(() => { }).then(run);
+    queues.set(name, next);
+    try {
+        return await next;
+    }
+    finally {
+        if (queues.get(name) === next)
+            queues.delete(name);
+    }
+}
+//# sourceMappingURL=locks.js.map

package/dist/offline/locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.js","sourceRoot":"","sources":["../../src/offline/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;AACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,IAAY,EAAE,IAAsB,EAAE,kBAAkB,GAAG,KAAK,EAAE,UAA0F,EAAE;IACjM,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,YAAY,CAAC,MAAM,EAAE,oEAAoE,CAAC,CAAC;YAChH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,kBAAkB,IAAI,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,IAAI,KAAK,WAAW,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,aAAa,EAAE,2DAA2D,CAAC,CAAC;IAC7L,MAAM,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3H,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,MAAM,EAAE,oEAAoE,CAAC,CAAC;IACpL,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,4EAA4E;QAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,SAAS;YAAE,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC;YAAC,OAAO,MAAM,GAAG,EAAE,CAAC;QAAC,CAAC;gBACnB,CAAC;YAAC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAAC,IAAI,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;;gBAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;IACzH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC;QAAC,OAAO,MAAM,IAAI,CAAC;IAAC,CAAC;YAClB,CAAC;QAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;AACjE,CAAC"}

package/dist/offline/store.d.ts

@@ -0,0 +1,94 @@
+/** Intentional local content, not a cache of authenticated API responses. */
+export type OfflineScope = Readonly<{
+    kind: 'device';
+} | {
+    kind: 'account';
+    ownerId: string;
+}>;
+export type OfflineErrorCode = 'unavailable' | 'closed' | 'access-denied' | 'quota' | 'blocked' | 'invalid' | 'storage' | 'integrity' | 'network' | 'busy';
+export declare class OfflineError extends Error {
+    readonly code: OfflineErrorCode;
+    constructor(code: OfflineErrorCode, message: string, options?: ErrorOptions);
+}
+export type OfflineStoreOptions = {
+    appId: string;
+    indexedDB?: IDBFactory;
+} & ({
+    scope: {
+        kind: 'device';
+    };
+    canAccess?: () => boolean;
+} | {
+    scope: {
+        kind: 'account';
+        ownerId: string;
+    };
+    canAccess: () => boolean;
+});
+export interface LocalRecord<T = unknown> {
+    id: string;
+    value: T;
+    updatedAt: number;
+    blobBytes: number;
+    blobType: string | null;
+}
+export interface LocalWrite<T = unknown> {
+    id: string;
+    value: T;
+    blob?: Blob;
+}
+export interface LocalPage {
+    after?: string;
+    limit?: number;
+}
+export type OfflineTable = 'records' | 'blobs' | 'downloads' | 'jobs' | 'outbox';
+export declare const OFFLINE_SCHEMA_VERSION = 2;
+export declare function offlineFailure(error: unknown): OfflineError;
+/** Every handle stays bound to one app/owner. close() locks it; clear() deletes it. */
+export declare class OfflineStore {
+    readonly scope: OfflineScope;
+    readonly appId: string;
+    readonly databaseName: string;
+    private readonly factory;
+    private readonly canAccess;
+    private closed;
+    private readonly active;
+    constructor(options: OfflineStoreOptions);
+    assertAccess(): void;
+    close(): void;
+    private open;
+    /** @internal Shared transaction primitive for the opt-in offline modules. */
+    transaction<T>(tables: OfflineTable[], mode: IDBTransactionMode, work: (tx: IDBTransaction, done: (value: T) => void) => void): Promise<T>;
+    /** @internal */
+    read<T>(table: OfflineTable, id: string): Promise<T | null>;
+    /** @internal */
+    write<T>(table: OfflineTable, id: string, value: T): Promise<void>;
+    /** @internal Bounded cursor listing; metadata stores contain no audio bytes. */
+    page<T>(table: OfflineTable, options?: LocalPage): Promise<T[]>;
+    put<T>(entry: LocalWrite<T>): Promise<LocalRecord<T>>;
+    get<T = unknown>(id: string): Promise<LocalRecord<T> | null>;
+    getBlob(id: string): Promise<Blob | null>;
+    list<T = unknown>(options?: LocalPage): Promise<LocalRecord<T>[]>;
+    delete(id: string): Promise<void>;
+    /** @internal Shared lease excludes purge until durable work finishes. */
+    runWork<T>(work: () => Promise<T>, signal?: AbortSignal): Promise<T>;
+    /** Rejects busy while SDK jobs/downloads/sync are active. Cancel and await runners before retrying. */
+    clear(): Promise<void>;
+    /** Portable JSON export of one user-selected record, including an optional base64 blob. */
+    exportRecord(id: string): Promise<Blob>;
+}
+export declare function createOfflineStore(options: OfflineStoreOptions): OfflineStore;
+/** Call on explicit logout/account changes; closing never deletes unsynced work. */
+export declare function bindOfflineAccount(store: OfflineStore, auth: {
+    onChange: (listener: (user: {
+        id: string;
+    } | null) => void) => () => void;
+}): () => void;
+/** Persistence is a request, never a promise that the browser cannot remove data. */
+export declare function localStorageStatus(requestPersistence?: boolean): Promise<{
+    supported: boolean;
+    persisted: boolean;
+    usage: number | null;
+    quota: number | null;
+}>;
+//# sourceMappingURL=store.d.ts.map

package/dist/offline/store.d.ts.map

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

package/dist/offline/store.js

@@ -0,0 +1,260 @@
+import { offlineLock } from './locks.js';
+export class OfflineError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'OfflineError';
+    }
+}
+const TABLES = ['records', 'blobs', 'downloads', 'jobs', 'outbox'];
+export const OFFLINE_SCHEMA_VERSION = 2;
+export function offlineFailure(error) {
+    if (error instanceof OfflineError)
+        return error;
+    return new OfflineError(error instanceof DOMException && error.name === 'QuotaExceededError' ? 'quota' : 'storage', 'Local storage operation failed.', { cause: error });
+}
+function key(value) {
+    if (!value || value.length > 512)
+        throw new OfflineError('invalid', 'A non-empty key of at most 512 characters is required.');
+    return value;
+}
+/** Every handle stays bound to one app/owner. close() locks it; clear() deletes it. */
+export class OfflineStore {
+    scope;
+    appId;
+    databaseName;
+    factory;
+    canAccess;
+    closed = false;
+    active = new Set();
+    constructor(options) {
+        this.appId = key(options.appId);
+        this.scope = Object.freeze({ ...options.scope });
+        if (this.scope.kind !== 'device' && this.scope.kind !== 'account')
+            throw new OfflineError('invalid', 'Unknown local-content scope.');
+        if (this.scope.kind === 'account') {
+            key(this.scope.ownerId);
+            if (typeof options.canAccess !== 'function')
+                throw new OfflineError('invalid', 'Account-local content requires an explicit canAccess decision.');
+        }
+        this.canAccess = options.canAccess;
+        this.databaseName = `pas-offline:${JSON.stringify([this.appId, this.scope.kind, this.scope.kind === 'account' ? this.scope.ownerId : null])}`;
+        const factory = options.indexedDB ?? globalThis.indexedDB;
+        if (!factory)
+            throw new OfflineError('unavailable', 'IndexedDB is unavailable on this device.');
+        this.factory = factory;
+        this.assertAccess();
+    }
+    assertAccess() {
+        if (this.closed)
+            throw new OfflineError('closed', 'This local-content handle has been closed.');
+        if (this.canAccess && !this.canAccess()) {
+            this.close();
+            throw new OfflineError('access-denied', 'Local content is locked for this account.');
+        }
+    }
+    close() {
+        this.closed = true;
+        for (const tx of this.active) {
+            try {
+                tx.abort();
+            }
+            catch { /* Already committed. */ }
+        }
+    }
+    open() {
+        this.assertAccess();
+        return new Promise((resolve, reject) => {
+            let refused = false;
+            let request;
+            try {
+                request = this.factory.open(this.databaseName, OFFLINE_SCHEMA_VERSION);
+            }
+            catch (error) {
+                reject(offlineFailure(error));
+                return;
+            }
+            request.onupgradeneeded = () => {
+                // Version 1 held records/blobs; version 2 adds resumable work. Existing data survives.
+                for (const table of TABLES)
+                    if (!request.result.objectStoreNames.contains(table))
+                        request.result.createObjectStore(table);
+            };
+            request.onblocked = () => {
+                refused = true;
+                reject(new OfflineError('blocked', 'Another tab is blocking the local database upgrade. Close it and retry.'));
+            };
+            request.onerror = () => reject(offlineFailure(request.error));
+            request.onsuccess = () => {
+                const db = request.result;
+                db.onversionchange = () => db.close();
+                if (refused) {
+                    db.close();
+                    return;
+                }
+                try {
+                    this.assertAccess();
+                    resolve(db);
+                }
+                catch (error) {
+                    db.close();
+                    reject(error);
+                }
+            };
+        });
+    }
+    /** @internal Shared transaction primitive for the opt-in offline modules. */
+    async transaction(tables, mode, work) {
+        const db = await this.open();
+        try {
+            this.assertAccess();
+            return await new Promise((resolve, reject) => {
+                const tx = db.transaction(tables, mode);
+                this.active.add(tx);
+                let value;
+                let thrown;
+                tx.oncomplete = () => {
+                    this.active.delete(tx);
+                    try {
+                        this.assertAccess();
+                        resolve(value);
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                };
+                tx.onabort = () => { this.active.delete(tx); reject(offlineFailure(thrown ?? tx.error)); };
+                tx.onerror = () => { };
+                try {
+                    work(tx, (next) => { value = next; });
+                }
+                catch (error) {
+                    thrown = error;
+                    tx.abort();
+                }
+            });
+        }
+        catch (error) {
+            throw offlineFailure(error);
+        }
+        finally {
+            db.close();
+        }
+    }
+    /** @internal */
+    read(table, id) {
+        return this.transaction([table], 'readonly', (tx, done) => {
+            const request = tx.objectStore(table).get(id);
+            request.onsuccess = () => done(request.result ?? null);
+        });
+    }
+    /** @internal */
+    write(table, id, value) {
+        return this.transaction([table], 'readwrite', (tx, done) => { tx.objectStore(table).put(value, id); done(undefined); });
+    }
+    /** @internal Bounded cursor listing; metadata stores contain no audio bytes. */
+    page(table, options = {}) {
+        const limit = options.limit ?? 50;
+        if (!Number.isInteger(limit) || limit < 1 || limit > 200)
+            throw new OfflineError('invalid', 'Page limit must be between 1 and 200.');
+        return this.transaction([table], 'readonly', (tx, done) => {
+            const rows = [];
+            const request = tx.objectStore(table).openCursor();
+            request.onsuccess = () => {
+                const cursor = request.result;
+                if (!cursor || rows.length >= limit) {
+                    done(rows);
+                    return;
+                }
+                if (options.after === undefined || String(cursor.key) > options.after)
+                    rows.push(cursor.value);
+                if (rows.length === limit)
+                    done(rows);
+                else
+                    cursor.continue();
+            };
+        });
+    }
+    async put(entry) {
+        key(entry.id);
+        const record = { id: entry.id, value: entry.value, updatedAt: Date.now(), blobBytes: entry.blob?.size ?? 0, blobType: entry.blob?.type ?? null };
+        return this.transaction(['records', 'blobs'], 'readwrite', (tx, done) => {
+            tx.objectStore('records').put(record, entry.id);
+            if (entry.blob)
+                tx.objectStore('blobs').put(entry.blob, `record:${entry.id}`);
+            else
+                tx.objectStore('blobs').delete(`record:${entry.id}`);
+            done(record);
+        });
+    }
+    get(id) { return this.read('records', key(id)); }
+    getBlob(id) { return this.read('blobs', `record:${key(id)}`); }
+    list(options = {}) { return this.page('records', options); }
+    delete(id) {
+        key(id);
+        return this.transaction(['records', 'blobs'], 'readwrite', (tx, done) => {
+            tx.objectStore('records').delete(id);
+            tx.objectStore('blobs').delete(`record:${id}`);
+            done(undefined);
+        });
+    }
+    /** @internal Shared lease excludes purge until durable work finishes. */
+    runWork(work, signal) {
+        return offlineLock(`${this.databaseName}:work`, work, true, { mode: 'shared', ...(signal ? { signal } : {}) });
+    }
+    /** Rejects busy while SDK jobs/downloads/sync are active. Cancel and await runners before retrying. */
+    clear() {
+        return offlineLock(`${this.databaseName}:work`, () => this.transaction(TABLES, 'readwrite', (tx, done) => { for (const table of TABLES)
+            tx.objectStore(table).clear(); done(undefined); }), true, { ifAvailable: true });
+    }
+    /** Portable JSON export of one user-selected record, including an optional base64 blob. */
+    async exportRecord(id) {
+        const snapshot = await this.transaction(['records', 'blobs'], 'readonly', (tx, done) => {
+            const record = tx.objectStore('records').get(key(id));
+            const blob = tx.objectStore('blobs').get(`record:${id}`);
+            blob.onsuccess = () => done({ record: record.result ?? null, blob: blob.result ?? null });
+        });
+        if (!snapshot.record)
+            throw new OfflineError('invalid', 'The local record does not exist.');
+        let base64 = null;
+        if (snapshot.blob) {
+            const bytes = new Uint8Array(await snapshot.blob.arrayBuffer());
+            const parts = [];
+            for (let start = 0; start < bytes.length; start += 0x8000)
+                parts.push(String.fromCharCode(...bytes.subarray(start, start + 0x8000)));
+            base64 = btoa(parts.join(''));
+        }
+        this.assertAccess();
+        return new Blob([JSON.stringify({ format: 'pas-local-record', version: 1, appId: this.appId, scope: this.scope, record: snapshot.record, base64 })], { type: 'application/json' });
+    }
+}
+export function createOfflineStore(options) { return new OfflineStore(options); }
+/** Call on explicit logout/account changes; closing never deletes unsynced work. */
+export function bindOfflineAccount(store, auth) {
+    const scope = store.scope;
+    if (scope.kind !== 'account')
+        throw new OfflineError('invalid', 'Only account-local stores bind to account changes.');
+    // Broadcast only a revocation bit within this app/owner namespace; never credentials.
+    const channel = typeof BroadcastChannel === 'undefined' ? null : new BroadcastChannel(`${store.databaseName}:access`);
+    if (channel)
+        channel.onmessage = (event) => { if (event.data === 'lock')
+            store.close(); };
+    const unsubscribe = auth.onChange((user) => {
+        if (!user || user.id !== scope.ownerId) {
+            store.close();
+            channel?.postMessage('lock');
+        }
+    });
+    return () => { unsubscribe(); channel?.close(); };
+}
+/** Persistence is a request, never a promise that the browser cannot remove data. */
+export async function localStorageStatus(requestPersistence = false) {
+    const storage = typeof navigator === 'undefined' ? undefined : navigator.storage;
+    if (!storage)
+        return { supported: false, persisted: false, usage: null, quota: null };
+    const estimate = await storage.estimate();
+    const persisted = (await storage.persisted()) || (requestPersistence ? await storage.persist() : false);
+    return { supported: true, persisted, usage: estimate.usage ?? null, quota: estimate.quota ?? null };
+}
+//# sourceMappingURL=store.js.map