@proappstore/sdk 1.16.95 → 1.16.96

package/README.md

@@ -29,6 +29,12 @@ Options:
 | `proApiBase` | `https://api.proappstore.online` | Platform API base URL |
 | `dataApiBase` | `https://data-{appId}.proappstore.online`, or `/.pas/data` in `platform-cookie` mode | Per-app data worker URL |
 
+## Offline content (opt-in)
+
+Import `createOfflineStore`, `createDownloadManager`, `createLocalJobs` and `createSyncQueue` from `@proappstore/sdk/offline`. Local records and blobs use transactional IndexedDB, explicit device/account scope and retention; public model downloads require version, size and SHA-256 pins. Durable jobs recover checkpoints, and the optional queue flushes only explicitly idempotent operations. Account access callbacks are local policy, not server authorization.
+
+`<AppShell access="local" app={app}>` renders local features without inventing an authenticated user; the default remains authenticated. Keep auth responses out of service-worker caches and checkpoint active work before updates. See the [offline guide](https://docs.proappstore.online/offline-apps/) for API usage, retention, quota, update and browser/device limits.
+
 ## Types
 
 ```ts

package/dist/index.d.ts

@@ -58,7 +58,7 @@ export { AdminConsole, AdminErrorBoundary, useAdminContext, useAction } from './
 export type { AdminConsoleProps, AdminContextValue, UseActionOptions, ActionInvoker } from './admin.js';
 export type { ProProviderProps } from './provider.js';
 export { AppShell, ProShell } from './shell.js';
-export type { AppShellProps, AppShellRenderContext, AppShellNavContext, ProShellProps, ProShellRenderContext, ProShellNavContext, MenuItem, ShellErrorContext } from './shell.js';
+export type { AppShellProps, AppShellRenderContext, LocalAppShellRenderContext, AppShellNavContext, ProShellProps, ProShellRenderContext, ProShellNavContext, MenuItem, ShellErrorContext } from './shell.js';
 export { useToast, useOnline } from './shell-resilience.js';
 export type { ToastApi, ToastOptions, ShellToastVariant } from './shell-resilience.js';
 export { PageHeader, useDocumentTitle } from './page.js';

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/offline/downloads.d.ts

@@ -0,0 +1,44 @@
+import { type OfflineStore } from './store.js';
+export interface DownloadManifest {
+    id: string;
+    version: string;
+    url: string;
+    sha256: string;
+    bytes: number;
+}
+export interface DownloadProgress {
+    loaded: number;
+    total: number;
+    resumed: boolean;
+}
+export interface DownloadStatus {
+    state: 'partial' | 'ready';
+    loaded: number;
+    total: number;
+}
+export interface DownloadOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: DownloadProgress) => void;
+}
+export interface DownloadManagerOptions {
+    fetch?: typeof fetch;
+    maxBytes?: number;
+    checkpointBytes?: number;
+}
+export declare class DownloadManager {
+    private readonly store;
+    private readonly fetcher;
+    private readonly maxBytes;
+    private readonly checkpointBytes;
+    constructor(store: OfflineStore, options?: DownloadManagerOptions);
+    status(manifest: DownloadManifest): Promise<DownloadStatus | null>;
+    get(manifest: DownloadManifest): Promise<Blob | null>;
+    private verify;
+    private readReady;
+    remove(manifest: DownloadManifest): Promise<void>;
+    private removeByKey;
+    download(manifest: DownloadManifest, options?: DownloadOptions): Promise<Blob>;
+    private transfer;
+}
+export declare function createDownloadManager(store: OfflineStore, options?: DownloadManagerOptions): DownloadManager;
+//# sourceMappingURL=downloads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.d.ts","sourceRoot":"","sources":["../../src/offline/downloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAM7D,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC7G,MAAM,WAAW,gBAAgB;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AACrF,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAE7F,MAAM,WAAW,eAAe;IAAG,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAAE;AAC5G,MAAM,WAAW,sBAAsB;IAAG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE;AAsB7G,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBACZ,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,sBAA2B;IAShF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKlE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YAK7C,MAAM;YAON,SAAS;IAUjB,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,OAAO,CAAC,WAAW;IAUb,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;YAK1E,QAAQ;CAgFvB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAAgD"}

package/dist/offline/downloads.js

@@ -0,0 +1,221 @@
+import { OfflineError } from './store.js';
+import { offlineLock } from './locks.js';
+function assetKey(manifest, maxBytes) {
+    if (!manifest.id || manifest.id.length > 128 || !manifest.version || manifest.version.length > 128 ||
+        !/^[a-f0-9]{64}$/i.test(manifest.sha256) || !Number.isSafeInteger(manifest.bytes) || manifest.bytes <= 0 || manifest.bytes > maxBytes) {
+        throw new OfflineError('invalid', 'Download requires an id, version, SHA-256 and byte size within the configured limit.');
+    }
+    let url;
+    try {
+        url = new URL(manifest.url);
+    }
+    catch {
+        throw new OfflineError('invalid', 'Download URL must be absolute.');
+    }
+    const local = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);
+    if ((url.protocol !== 'https:' && !(url.protocol === 'http:' && local)) || url.username || url.password ||
+        url.pathname.startsWith('/.pas/') || url.hostname === 'api.proappstore.online' || url.hostname.startsWith('data-')) {
+        throw new OfflineError('invalid', 'Only public immutable assets may use the download manager; authenticated endpoints are excluded.');
+    }
+    return JSON.stringify([manifest.id, manifest.version, manifest.sha256.toLowerCase(), manifest.bytes, url.href]);
+}
+const partKey = (id, n) => `download-part:${id}:${n}`;
+const readyKey = (id) => `download-ready:${id}`;
+const abort = (signal) => { if (signal?.aborted)
+    throw new DOMException('Download cancelled.', 'AbortError'); };
+const strongEtag = (value) => value && /^"[^"\r\n]+"$/.test(value) ? value : null;
+export class DownloadManager {
+    store;
+    fetcher;
+    maxBytes;
+    checkpointBytes;
+    constructor(store, options = {}) {
+        this.store = store;
+        if (!options.fetch && typeof globalThis.fetch !== 'function')
+            throw new OfflineError('unavailable', 'Fetch is unavailable on this device.');
+        this.fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.maxBytes = options.maxBytes ?? 512 * 1024 * 1024;
+        this.checkpointBytes = options.checkpointBytes ?? 1024 * 1024;
+        if (!Number.isSafeInteger(this.maxBytes) || this.maxBytes <= 0 || !Number.isSafeInteger(this.checkpointBytes) || this.checkpointBytes <= 0) {
+            throw new OfflineError('invalid', 'Download byte limits must be positive integers.');
+        }
+    }
+    async status(manifest) {
+        manifest = Object.freeze({ ...manifest });
+        const row = await this.store.read('downloads', assetKey(manifest, this.maxBytes));
+        return row ? { state: row.state, loaded: row.loaded, total: row.total } : null;
+    }
+    async get(manifest) {
+        manifest = Object.freeze({ ...manifest });
+        const id = assetKey(manifest, this.maxBytes);
+        return this.store.runWork(() => offlineLock(`${this.store.databaseName}:${id}`, () => this.readReady(id, manifest), true));
+    }
+    async verify(blob, manifest) {
+        if (!globalThis.crypto?.subtle)
+            throw new OfflineError('unavailable', 'SHA-256 verification requires a secure browser context.');
+        const digest = await crypto.subtle.digest('SHA-256', await blob.arrayBuffer());
+        const hash = Array.from(new Uint8Array(digest), (n) => n.toString(16).padStart(2, '0')).join('');
+        this.store.assertAccess();
+        if (blob.size !== manifest.bytes || hash !== manifest.sha256.toLowerCase())
+            throw new OfflineError('integrity', 'Downloaded bytes do not match the pinned model.');
+    }
+    async readReady(id, manifest) {
+        const row = await this.store.read('downloads', id);
+        if (row?.state !== 'ready')
+            return null;
+        const blob = await this.store.read('blobs', readyKey(id));
+        try {
+            if (!blob)
+                throw new OfflineError('integrity', 'The downloaded asset is missing.');
+            await this.verify(blob, manifest);
+            return blob;
+        }
+        catch (error) {
+            await this.removeByKey(id);
+            throw error;
+        }
+    }
+    async remove(manifest) {
+        manifest = Object.freeze({ ...manifest });
+        const id = assetKey(manifest, this.maxBytes);
+        return this.store.runWork(() => offlineLock(`${this.store.databaseName}:${id}`, () => this.removeByKey(id), true));
+    }
+    removeByKey(id) {
+        return this.store.transaction(['downloads', 'blobs'], 'readwrite', (tx, done) => {
+            const request = tx.objectStore('downloads').get(id);
+            request.onsuccess = () => {
+                const row = request.result;
+                for (let n = 0; n < (row?.chunks ?? 0); n++)
+                    tx.objectStore('blobs').delete(partKey(id, n));
+                tx.objectStore('blobs').delete(readyKey(id));
+                tx.objectStore('downloads').delete(id);
+                done(undefined);
+            };
+        });
+    }
+    async download(manifest, options = {}) {
+        manifest = Object.freeze({ ...manifest });
+        const id = assetKey(manifest, this.maxBytes);
+        return this.store.runWork(() => offlineLock(`${this.store.databaseName}:${id}`, () => this.transfer(id, manifest, options), true, options.signal ? { signal: options.signal } : {}), options.signal);
+    }
+    async transfer(id, manifest, options) {
+        abort(options.signal);
+        const cached = await this.readReady(id, manifest);
+        if (cached) {
+            abort(options.signal);
+            options.onProgress?.({ loaded: cached.size, total: cached.size, resumed: false });
+            return cached;
+        }
+        let row = await this.store.read('downloads', id);
+        if (row && row.loaded < manifest.bytes && !row.etag) {
+            await this.removeByKey(id);
+            row = null;
+        }
+        let current = row ?? { state: 'partial', loaded: 0, total: manifest.bytes, chunks: 0, etag: null };
+        let resumed = current.loaded > 0;
+        let pending = [];
+        let pendingBytes = 0;
+        const checkpoint = async () => {
+            if (!pendingBytes)
+                return;
+            const blob = new Blob(pending);
+            const next = { ...current, loaded: current.loaded + pendingBytes, chunks: current.chunks + 1 };
+            await this.store.transaction(['downloads', 'blobs'], 'readwrite', (tx, done) => {
+                tx.objectStore('blobs').put(blob, partKey(id, current.chunks));
+                tx.objectStore('downloads').put(next, id);
+                done(undefined);
+            });
+            current = next;
+            pending = [];
+            pendingBytes = 0;
+        };
+        try {
+            if (current.loaded < manifest.bytes) {
+                const headers = new Headers();
+                if (current.loaded && current.etag) {
+                    headers.set('Range', `bytes=${current.loaded}-`);
+                    headers.set('If-Range', current.etag);
+                }
+                const response = await this.fetcher(manifest.url, { headers, credentials: 'omit', redirect: 'error', cache: 'no-store', ...(options.signal ? { signal: options.signal } : {}) });
+                if (response.status === 200 && current.loaded) {
+                    resumed = false;
+                    await this.removeByKey(id);
+                    current = { state: 'partial', loaded: 0, total: manifest.bytes, chunks: 0, etag: null };
+                }
+                else if (response.status === 206) {
+                    const range = /^bytes (\d+)-(\d+)\/(\d+)$/.exec(response.headers.get('Content-Range') ?? '');
+                    if (!current.loaded || !current.etag || strongEtag(response.headers.get('ETag')) !== current.etag || !range ||
+                        Number(range[1]) !== current.loaded || Number(range[2]) !== manifest.bytes - 1 || Number(range[3]) !== manifest.bytes) {
+                        await response.body?.cancel();
+                        await this.removeByKey(id);
+                        throw new OfflineError('integrity', 'The resumed response does not match the saved asset version and range.');
+                    }
+                }
+                else if (response.status !== 200) {
+                    await response.body?.cancel();
+                    throw new OfflineError('network', `Download failed with HTTP ${response.status}.`);
+                }
+                current.etag = strongEtag(response.headers.get('ETag'));
+                if (!response.body)
+                    throw new OfflineError('network', 'Download has no response body.');
+                const reader = response.body.getReader();
+                try {
+                    for (;;) {
+                        abort(options.signal);
+                        this.store.assertAccess();
+                        const result = await reader.read();
+                        if (result.done)
+                            break;
+                        if (current.loaded + pendingBytes + result.value.byteLength > manifest.bytes)
+                            throw new OfflineError('integrity', 'Download exceeds its declared byte size.');
+                        // Store independent chunks, never rewrite the already downloaded prefix.
+                        pending.push(result.value.slice().buffer);
+                        pendingBytes += result.value.byteLength;
+                        if (pendingBytes >= this.checkpointBytes)
+                            await checkpoint();
+                        options.onProgress?.({ loaded: current.loaded + pendingBytes, total: manifest.bytes, resumed });
+                    }
+                    await checkpoint();
+                }
+                catch (error) {
+                    await reader.cancel().catch(() => { });
+                    if (!(error instanceof OfflineError && error.code === 'integrity'))
+                        await checkpoint();
+                    throw error;
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            }
+            abort(options.signal);
+            if (current.loaded !== manifest.bytes)
+                throw new OfflineError('network', 'Download ended before the declared byte size. Retry to resume.');
+            const parts = [];
+            for (let n = 0; n < current.chunks; n++) {
+                const part = await this.store.read('blobs', partKey(id, n));
+                if (!part)
+                    throw new OfflineError('integrity', 'A saved download chunk is missing.');
+                parts.push(part);
+            }
+            const complete = new Blob(parts, { type: 'application/octet-stream' });
+            await this.verify(complete, manifest);
+            abort(options.signal);
+            await this.store.transaction(['downloads', 'blobs'], 'readwrite', (tx, done) => {
+                tx.objectStore('blobs').put(complete, readyKey(id));
+                for (let n = 0; n < current.chunks; n++)
+                    tx.objectStore('blobs').delete(partKey(id, n));
+                tx.objectStore('downloads').put({ ...current, state: 'ready', chunks: 0 }, id);
+                done(undefined);
+            });
+            options.onProgress?.({ loaded: manifest.bytes, total: manifest.bytes, resumed });
+            return complete;
+        }
+        catch (error) {
+            if (error instanceof OfflineError && error.code === 'integrity')
+                await this.removeByKey(id);
+            throw error;
+        }
+    }
+}
+export function createDownloadManager(store, options = {}) { return new DownloadManager(store, options); }
+//# sourceMappingURL=downloads.js.map

package/dist/offline/downloads.js.map

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

package/dist/offline/jobs.d.ts

@@ -0,0 +1,78 @@
+import { type LocalPage, type OfflineStore } from './store.js';
+export type LocalJobStatus = 'pending' | 'running' | 'paused' | 'interrupted' | 'completed' | 'failed';
+export interface LocalJob<I = unknown, C = unknown, R = unknown> {
+    id: string;
+    kind: string;
+    input: I;
+    checkpoint: C | null;
+    result: R | null;
+    status: LocalJobStatus;
+    attempts: number;
+    updatedAt: number;
+    error: string | null;
+}
+export interface LocalJobContext<C = unknown> {
+    savedCheckpoint: C | null;
+    checkpoint: (value: C) => Promise<void>;
+    signal: AbortSignal | undefined;
+}
+export type LocalJobHandler<I = unknown, C = unknown, R = unknown> = (input: I, context: LocalJobContext<C>) => Promise<R>;
+export declare class LocalJobs {
+    private readonly store;
+    constructor(store: OfflineStore);
+    create<I>(input: {
+        id: string;
+        kind: string;
+        input: I;
+    }): Promise<LocalJob<I>>;
+    get<I = unknown, C = unknown, R = unknown>(id: string): Promise<LocalJob<I, C, R> | null>;
+    list(options?: LocalPage): Promise<LocalJob[]>;
+    private update;
+    checkpoint<C>(id: string, value: C): Promise<void>;
+    setStatus(id: string, status: LocalJobStatus): Promise<void>;
+    /** No automatic execution. Re-entering run() passes the last committed checkpoint. */
+    run<I = unknown, C = unknown, R = unknown>(id: string, handler: LocalJobHandler<I, C, R>, options?: {
+        signal?: AbortSignal;
+    }): Promise<LocalJob<I, C, R>>;
+    /** The same Web Lock excludes active SDK runners before recovery. */
+    recover(): Promise<number>;
+}
+export interface SyncOperation {
+    id: string;
+    kind: string;
+    payload: unknown;
+    status: 'pending' | 'running' | 'failed' | 'completed';
+    attempts: number;
+    updatedAt: number;
+    error: string | null;
+}
+export type SyncHandler = (payload: unknown, context: {
+    operationId: string;
+    signal: AbortSignal | undefined;
+}) => Promise<void>;
+/** At-least-once delivery. Handlers MUST enforce server idempotency using operationId. */
+export declare class SyncQueue {
+    private readonly store;
+    constructor(store: OfflineStore);
+    enqueue(input: {
+        id: string;
+        kind: string;
+        payload: unknown;
+        idempotent: true;
+    }): Promise<SyncOperation>;
+    get(id: string): Promise<SyncOperation | null>;
+    list(options?: LocalPage): Promise<SyncOperation[]>;
+    private change;
+    retry(id: string): Promise<void>;
+    /** Explicit caller action; never triggered automatically by an online event. */
+    flush(handlers: Record<string, SyncHandler>, options?: {
+        signal?: AbortSignal;
+        limit?: number;
+    }): Promise<{
+        completed: number;
+        failed: number;
+    }>;
+}
+export declare function createLocalJobs(store: OfflineStore): LocalJobs;
+export declare function createSyncQueue(store: OfflineStore): SyncQueue;
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/offline/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAG7E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AACvG,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAC7D,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3E,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACnF;AACD,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAAI,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE;AACrJ,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAO3H,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAChD,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAW9E,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACzF,IAAI,CAAC,OAAO,GAAE,SAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAClD,OAAO,CAAC,MAAM;IAUR,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,sFAAsF;IAChF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAuBnK,qEAAqE;IAC/D,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAajC;AAED,MAAM,WAAW,aAAa;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAChM,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjI,0FAA0F;AAC1F,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAC1C,OAAO,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAa9G,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAC9C,IAAI,CAAC,OAAO,GAAE,SAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;YACzC,MAAM;IAUpB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhC,gFAAgF;IAChF,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAmCrJ;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAiC;AAChG,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAiC"}

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