@spinajs/http-socket-client 0.0.0-stage → 3.0.0

package/lib/cjs/node/file-outbox.d.ts

@@ -0,0 +1,40 @@
+import type { FailedOutboxEntry, OutboxEntry, OutboxInput, OutboxStore } from '../outbox.js';
+export interface FileOutboxOptions {
+    /** Test seam: the rename that publishes the temp file. */
+    rename?: (from: string, to: string) => Promise<void>;
+    /** Base of the backoff between rename retries (grows linearly, capped at 5x). Default 10. */
+    retryDelayMs?: number;
+}
+/**
+ * The outbox of a Node service, in one JSON file. Every write goes through a temp file, fsync and rename,
+ * so a crash leaves the old queue or the new one, never a torn one. Changes that queue up while a write
+ * is in flight are committed together by the next one. Payloads must survive a JSON round trip unchanged:
+ * `add` refuses binary, Dates, Maps, class instances and non-finite numbers. One process at a time per file.
+ *
+ * The whole queue is rewritten on every commit, so the cost of a write grows with the queue size: meant
+ * for queues of up to some thousands of entries.
+ */
+export declare class FileOutboxStore implements OutboxStore {
+    readonly path: string;
+    private cache;
+    private queue;
+    private flushing;
+    private readonly renameFile;
+    private readonly retryDelayMs;
+    constructor(path: string, options?: FileOutboxOptions);
+    add<P>(input: OutboxInput<P>): Promise<OutboxEntry<P>>;
+    pending(): Promise<OutboxEntry[]>;
+    remove(seq: number): Promise<void>;
+    fail(entry: FailedOutboxEntry): Promise<void>;
+    failed(): Promise<FailedOutboxEntry[]>;
+    clearFailed(seqs?: readonly number[]): Promise<void>;
+    private submit;
+    private flush;
+    private load;
+    private write;
+    /** Windows and antivirus scanners briefly hold the target open, which fails the rename with EPERM/EBUSY/EACCES. */
+    private publish;
+    /** Makes the rename itself durable. Windows cannot open a directory for fsync, so it is skipped there. */
+    private syncDirectory;
+}
+//# sourceMappingURL=file-outbox.d.ts.map

package/lib/cjs/node/file-outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-outbox.d.ts","sourceRoot":"","sources":["../../../src/node/file-outbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAU7F,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA0DD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,WAAW;aAQ/B,IAAI,EAAE,MAAM;IAP9B,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8C;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,YACkB,IAAI,EAAE,MAAM,EAC5B,OAAO,GAAE,iBAAsB,EAIhC;IAEM,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAkB5D;IAEM,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAEvC;IAEM,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxC;IAEM,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnD;IAEM,MAAM,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAE5C;IAEM,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1D;IAED,OAAO,CAAC,MAAM;YAUA,KAAK;YAwBL,IAAI;YAqCJ,KAAK;IAuBnB,mHAAmH;YACrG,OAAO;IAarB,0GAA0G;YAC5F,aAAa;CAkB5B"}

package/lib/cjs/node/file-outbox.js

@@ -0,0 +1,234 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileOutboxStore = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const RENAME_RETRIES = 5;
+const TRANSIENT = new Set(['EPERM', 'EBUSY', 'EACCES']);
+const empty = () => ({ version: 1, seq: 0, pending: [], failed: [] });
+const isEntry = (value) => typeof value === 'object' && value !== null && typeof value.seq === 'number';
+/** Where JSON would change the value, eg. `payload.bytes is a Uint8Array`; null when it survives a JSON round trip. */
+function jsonChange(value, path) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean') {
+        return null;
+    }
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? null : `${path} is ${value}`;
+    }
+    if (Array.isArray(value)) {
+        for (let i = 0; i < value.length; i++) {
+            const changed = value[i] === undefined ? `${path}[${i}] is undefined` : jsonChange(value[i], `${path}[${i}]`);
+            if (changed !== null) {
+                return changed;
+            }
+        }
+        return null;
+    }
+    if (typeof value === 'object') {
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && proto !== null) {
+            return `${path} is a ${proto.constructor?.name || 'class instance'}`;
+        }
+        for (const [key, item] of Object.entries(value)) {
+            // dropped from the file as from the wire, so the command is sent the same
+            if (item === undefined) {
+                continue;
+            }
+            const changed = jsonChange(item, `${path}.${key}`);
+            if (changed !== null) {
+                return changed;
+            }
+        }
+        return null;
+    }
+    // a top-level undefined payload stays undefined; a function or symbol inside is dropped
+    return path === 'payload' && value === undefined ? null : `${path} is a ${typeof value}`;
+}
+/**
+ * The outbox of a Node service, in one JSON file. Every write goes through a temp file, fsync and rename,
+ * so a crash leaves the old queue or the new one, never a torn one. Changes that queue up while a write
+ * is in flight are committed together by the next one. Payloads must survive a JSON round trip unchanged:
+ * `add` refuses binary, Dates, Maps, class instances and non-finite numbers. One process at a time per file.
+ *
+ * The whole queue is rewritten on every commit, so the cost of a write grows with the queue size: meant
+ * for queues of up to some thousands of entries.
+ */
+class FileOutboxStore {
+    constructor(path, options = {}) {
+        this.path = path;
+        this.cache = null;
+        this.queue = [];
+        this.flushing = false;
+        this.renameFile = options.rename ?? promises_1.rename;
+        this.retryDelayMs = options.retryDelayMs ?? 10;
+    }
+    add(input) {
+        try {
+            // A payload that cannot be serialized must fail its own caller, not the batch it would share a write with.
+            JSON.stringify(input.payload);
+            // The cache holds the payload itself and the file its JSON form: a payload JSON changes would be sent differently after a restart.
+            const changed = jsonChange(input.payload, 'payload');
+            if (changed !== null) {
+                throw new TypeError(`FileOutboxStore keeps payloads as JSON, which would change ${changed}: encode it as JSON first, eg. bytes as base64`);
+            }
+        }
+        catch (err) {
+            return Promise.reject(err);
+        }
+        return this.submit(true, (state) => {
+            const entry = { seq: ++state.seq, name: input.name, payload: structuredClone(input.payload), createdAt: Date.now(), ...(input.key !== undefined ? { key: input.key } : {}) };
+            state.pending.push(entry);
+            return structuredClone(entry);
+        });
+    }
+    pending() {
+        return this.submit(false, (state) => structuredClone(state.pending));
+    }
+    remove(seq) {
+        return this.submit(true, (state) => {
+            state.pending = state.pending.filter((entry) => entry.seq !== seq);
+        });
+    }
+    fail(entry) {
+        return this.submit(true, (state) => {
+            const index = state.pending.findIndex((pending) => pending.seq === entry.seq);
+            if (index < 0) {
+                return;
+            }
+            state.pending.splice(index, 1);
+            state.failed.push(structuredClone(entry));
+            state.failed.sort((a, b) => a.seq - b.seq);
+        });
+    }
+    failed() {
+        return this.submit(false, (state) => structuredClone(state.failed));
+    }
+    clearFailed(seqs) {
+        return this.submit(true, (state) => {
+            state.failed = seqs === undefined ? [] : state.failed.filter((entry) => !seqs.includes(entry.seq));
+        });
+    }
+    submit(writes, run) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ run, writes, resolve: resolve, reject });
+            if (!this.flushing) {
+                this.flushing = true;
+                void this.flush();
+            }
+        });
+    }
+    async flush() {
+        try {
+            while (this.queue.length > 0) {
+                const batch = this.queue;
+                this.queue = [];
+                try {
+                    const state = await this.load();
+                    const results = batch.map((job) => job.run(state));
+                    if (batch.some((job) => job.writes)) {
+                        await this.write(state);
+                    }
+                    batch.forEach((job, i) => job.resolve(results[i]));
+                }
+                catch (err) {
+                    // Jobs mutated the cache in place: the file still holds the last committed queue, so reload from it.
+                    this.cache = null;
+                    batch.forEach((job) => job.reject(err));
+                }
+            }
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    async load() {
+        if (this.cache) {
+            return this.cache;
+        }
+        let text;
+        try {
+            text = await (0, promises_1.readFile)(this.path, 'utf8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return (this.cache = empty());
+            }
+            throw err;
+        }
+        let state;
+        try {
+            state = JSON.parse(text);
+        }
+        catch (err) {
+            throw new Error(`outbox file ${this.path} is damaged: ${err.message}`);
+        }
+        if (state?.version !== 1 || typeof state.seq !== 'number' || !Array.isArray(state.pending) || !Array.isArray(state.failed)) {
+            throw new Error(`outbox file ${this.path} is not a version 1 outbox`);
+        }
+        const entries = [...state.pending, ...state.failed];
+        if (!entries.every(isEntry)) {
+            throw new Error(`outbox file ${this.path} holds a malformed entry`);
+        }
+        if (entries.some((entry) => entry.seq > state.seq)) {
+            throw new Error(`outbox file ${this.path} has a seq counter behind its entries`);
+        }
+        return (this.cache = state);
+    }
+    async write(state) {
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(this.path), { recursive: true });
+        const temp = `${this.path}.tmp`;
+        try {
+            const file = await (0, promises_1.open)(temp, 'w');
+            try {
+                await file.writeFile(JSON.stringify(state));
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
+            await this.publish(temp);
+        }
+        catch (err) {
+            await (0, promises_1.unlink)(temp).catch(() => undefined);
+            throw err;
+        }
+        // An error here means the batch may have persisted although it rejects: at-least-once, and the idempotency key makes the retry safe.
+        await this.syncDirectory();
+    }
+    /** Windows and antivirus scanners briefly hold the target open, which fails the rename with EPERM/EBUSY/EACCES. */
+    async publish(temp) {
+        for (let attempt = 1;; attempt++) {
+            try {
+                return await this.renameFile(temp, this.path);
+            }
+            catch (err) {
+                if (attempt > RENAME_RETRIES || !TRANSIENT.has(err.code ?? '')) {
+                    throw err;
+                }
+                await new Promise((resolve) => setTimeout(resolve, this.retryDelayMs * Math.min(attempt, 5)));
+            }
+        }
+    }
+    /** Makes the rename itself durable. Windows cannot open a directory for fsync, so it is skipped there. */
+    async syncDirectory() {
+        if (process.platform === 'win32') {
+            return;
+        }
+        try {
+            const dir = await (0, promises_1.open)((0, node_path_1.dirname)(this.path), 'r');
+            try {
+                await dir.sync();
+            }
+            finally {
+                await dir.close();
+            }
+        }
+        catch (err) {
+            if (!['EINVAL', 'EISDIR', 'EPERM'].includes(err.code ?? '')) {
+                throw err;
+            }
+        }
+    }
+}
+exports.FileOutboxStore = FileOutboxStore;
+//# sourceMappingURL=file-outbox.js.map

package/lib/cjs/node/file-outbox.js.map

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

package/lib/cjs/node/index.d.ts

@@ -0,0 +1,4 @@
+export * from '../index.js';
+export { FileOutboxStore } from './file-outbox.js';
+export type { FileOutboxOptions } from './file-outbox.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/cjs/node/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileOutboxStore = void 0;
+__exportStar(require("../index.js"), exports);
+var file_outbox_js_1 = require("./file-outbox.js");
+Object.defineProperty(exports, "FileOutboxStore", { enumerable: true, get: function () { return file_outbox_js_1.FileOutboxStore; } });
+//# sourceMappingURL=index.js.map

package/lib/cjs/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,mDAAmD;AAA1C,iHAAA,eAAe,OAAA"}

package/lib/cjs/outbox-indexeddb.d.ts

@@ -0,0 +1,38 @@
+import type { FailedOutboxEntry, OutboxEntry, OutboxInput, OutboxStore } from './outbox.js';
+export interface IndexedDbOutboxOptions {
+    /** The IndexedDB to use; the global `indexedDB` when omitted ( tests pass fake-indexeddb's ). */
+    factory?: IDBFactory;
+    /** Refuse a second live store on the same name via `navigator.locks`. Default: on with the global IndexedDB, off with a custom `factory`. */
+    exclusive?: boolean;
+}
+/**
+ * Keeps the outbox in the IndexedDB database `spinajs-outbox:<name>`, so a reload resumes the queue
+ * ( spec �6 step 5 ). `seq` comes from the object store's key generator, which never reuses a value and
+ * is advanced in the transaction that stores the entry. Every method is one transaction and resolves on
+ * its `complete` event, with strict durability.
+ *
+ * One live client per name: with the global IndexedDB and where `navigator.locks` exists, a second store on the same name is refused
+ * while the first is open. The app must persist and reuse its `clientId` with this store, because
+ * queued entries carry keys derived from it.
+ */
+export declare class IndexedDbOutboxStore implements OutboxStore {
+    readonly name: string;
+    private readonly options;
+    private db;
+    private releaseLock;
+    private lockDone;
+    constructor(name: string, options?: IndexedDbOutboxOptions);
+    add<P>(input: OutboxInput<P>): Promise<OutboxEntry<P>>;
+    pending(): Promise<OutboxEntry[]>;
+    remove(seq: number): Promise<void>;
+    fail(entry: FailedOutboxEntry): Promise<void>;
+    failed(): Promise<FailedOutboxEntry[]>;
+    clearFailed(seqs?: readonly number[]): Promise<void>;
+    /** Closes the database connection and releases the name; the next call opens it again. */
+    close(): Promise<void>;
+    private acquireLock;
+    private open;
+    private run;
+    private begin;
+}
+//# sourceMappingURL=outbox-indexeddb.d.ts.map

package/lib/cjs/outbox-indexeddb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-indexeddb.d.ts","sourceRoot":"","sources":["../../src/outbox-indexeddb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5F,MAAM,WAAW,sBAAsB;IACrC,iGAAiG;IACjG,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,6IAA6I;IAC7I,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAuBD;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,YAAW,WAAW;aAK1B,IAAI,EAAE,MAAM;IAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJlE,OAAO,CAAC,EAAE,CAAqC;IAC/C,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAiC;IAEjD,YAA4B,IAAI,EAAE,MAAM,EAAmB,OAAO,GAAE,sBAA2B,EAAI;IAEtF,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAKlE;IAEY,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAE7C;IAEY,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9C;IAEY,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzD;IAEY,MAAM,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAElD;IAEY,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE;IAED,0FAA0F;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAWlC;YAEa,WAAW;IA0BzB,OAAO,CAAC,IAAI;YAyDE,GAAG;IA2CjB,OAAO,CAAC,KAAK;CAGd"}

package/lib/cjs/outbox-indexeddb.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexedDbOutboxStore = void 0;
+const PENDING = 'pending';
+const FAILED = 'failed';
+// A bump needs an `onblocked` strategy for connections of other tabs that ignore `versionchange`.
+const VERSION = 1;
+function explain(err, name) {
+    const kind = err?.name;
+    switch (kind) {
+        case 'QuotaExceededError':
+            return new Error('outbox is full (QuotaExceededError)', { cause: err });
+        case 'VersionError':
+            return new Error(`outbox database "${name}" was written by a newer version of this code`, { cause: err });
+        case 'NotFoundError':
+            return new Error(`outbox database "${name}" has no expected object store`, { cause: err });
+        default:
+            return err;
+    }
+}
+/**
+ * Keeps the outbox in the IndexedDB database `spinajs-outbox:<name>`, so a reload resumes the queue
+ * ( spec �6 step 5 ). `seq` comes from the object store's key generator, which never reuses a value and
+ * is advanced in the transaction that stores the entry. Every method is one transaction and resolves on
+ * its `complete` event, with strict durability.
+ *
+ * One live client per name: with the global IndexedDB and where `navigator.locks` exists, a second store on the same name is refused
+ * while the first is open. The app must persist and reuse its `clientId` with this store, because
+ * queued entries carry keys derived from it.
+ */
+class IndexedDbOutboxStore {
+    constructor(name, options = {}) {
+        this.name = name;
+        this.options = options;
+        this.db = null;
+        this.releaseLock = null;
+        this.lockDone = null;
+    }
+    async add(input) {
+        const record = { name: input.name, payload: input.payload, createdAt: Date.now(), ...(input.key !== undefined ? { key: input.key } : {}) };
+        const seq = await this.run([PENDING], 'readwrite', (tx) => tx.objectStore(PENDING).add(record));
+        // structuredClone: the caller must not share the payload with what was stored
+        return { ...structuredClone(record), seq: seq };
+    }
+    async pending() {
+        return (await this.run([PENDING], 'readonly', (tx) => tx.objectStore(PENDING).getAll()));
+    }
+    async remove(seq) {
+        await this.run([PENDING], 'readwrite', (tx) => tx.objectStore(PENDING).delete(seq));
+    }
+    async fail(entry) {
+        await this.run([PENDING, FAILED], 'readwrite', (tx) => {
+            const pending = tx.objectStore(PENDING);
+            const found = pending.getKey(entry.seq);
+            found.onsuccess = () => {
+                if (found.result !== undefined) {
+                    pending.delete(entry.seq);
+                    tx.objectStore(FAILED).put(entry);
+                }
+            };
+            return found;
+        });
+    }
+    async failed() {
+        return (await this.run([FAILED], 'readonly', (tx) => tx.objectStore(FAILED).getAll()));
+    }
+    async clearFailed(seqs) {
+        await this.run([FAILED], 'readwrite', (tx) => {
+            const failed = tx.objectStore(FAILED);
+            if (seqs === undefined) {
+                return failed.clear();
+            }
+            let last = failed.count();
+            for (const seq of seqs) {
+                last = failed.delete(seq);
+            }
+            return last;
+        });
+    }
+    /** Closes the database connection and releases the name; the next call opens it again. */
+    async close() {
+        const opening = this.db;
+        (await opening?.catch(() => null))?.close();
+        if (this.db === opening) {
+            this.db = null;
+        }
+        this.releaseLock?.();
+        this.releaseLock = null;
+        // the lock is free once its request settled
+        await this.lockDone;
+        this.lockDone = null;
+    }
+    async acquireLock() {
+        const locks = globalThis.navigator?.locks;
+        const exclusive = this.options.exclusive ?? this.options.factory === undefined;
+        if (!exclusive || !locks || this.releaseLock) {
+            return;
+        }
+        const taken = await new Promise((resolve) => {
+            this.lockDone = locks.request(`spinajs-outbox:${this.name}`, { ifAvailable: true }, async (lock) => {
+                if (!lock) {
+                    resolve(false);
+                    return;
+                }
+                await new Promise((release) => {
+                    this.releaseLock = release;
+                    resolve(true);
+                });
+            });
+        });
+        if (!taken) {
+            throw new Error(`outbox "${this.name}" is already open in another tab or client; only one live client per name is allowed`);
+        }
+    }
+    open() {
+        if (this.db) {
+            return this.db;
+        }
+        const opening = this.acquireLock().then(() => new Promise((resolve, reject) => {
+            const factory = this.options.factory ?? globalThis.indexedDB;
+            if (!factory) {
+                reject(new Error('IndexedDB is not available here; pass IndexedDbOutboxOptions.factory'));
+                return;
+            }
+            const request = factory.open(`spinajs-outbox:${this.name}`, VERSION);
+            request.onupgradeneeded = () => {
+                request.result.createObjectStore(PENDING, { keyPath: 'seq', autoIncrement: true });
+                request.result.createObjectStore(FAILED, { keyPath: 'seq' });
+            };
+            request.onsuccess = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(PENDING) || !db.objectStoreNames.contains(FAILED)) {
+                    db.close();
+                    reject(new Error(`database "spinajs-outbox:${this.name}" is not an outbox: missing object stores`));
+                    return;
+                }
+                // A newer schema in another tab waits for this connection to go away; the next call reopens it.
+                const forget = () => {
+                    db.close();
+                    if (this.db === opening) {
+                        this.db = null;
+                    }
+                };
+                db.onversionchange = forget;
+                db.onclose = forget;
+                resolve(db);
+            };
+            request.onerror = () => reject(explain(request.error, this.name));
+        }));
+        // a failed open is tried again by the next call
+        opening.catch(() => {
+            if (this.db === opening) {
+                this.db = null;
+            }
+            if (!this.db) {
+                this.releaseLock?.();
+                this.releaseLock = null;
+            }
+        });
+        this.db = opening;
+        return opening;
+    }
+    async run(stores, mode, work) {
+        let db = await this.open();
+        let tx;
+        try {
+            tx = this.begin(db, stores, mode);
+        }
+        catch (err) {
+            if (err.name !== 'InvalidStateError') {
+                throw explain(err, this.name);
+            }
+            // the connection was closed behind our back: reopen once
+            if (this.db) {
+                this.db = null;
+            }
+            db = await this.open();
+            try {
+                tx = this.begin(db, stores, mode);
+            }
+            catch (again) {
+                throw explain(again, this.name);
+            }
+        }
+        return new Promise((resolve, reject) => {
+            let request;
+            try {
+                request = work(tx);
+            }
+            catch (err) {
+                // e.g. a payload structured clone cannot copy: nothing of this call may commit
+                try {
+                    tx.abort();
+                }
+                catch {
+                    // already finished
+                }
+                reject(explain(err, this.name));
+                return;
+            }
+            tx.oncomplete = () => resolve(request.result);
+            // `tx.error` is only set by the time of `abort`, never at `error`
+            tx.onabort = () => reject(explain(tx.error ?? request.error, this.name) ?? new Error('IndexedDB transaction aborted'));
+        });
+    }
+    // strict: the commit reaches the disk before `complete`, which a durable command relies on
+    begin(db, stores, mode) {
+        return db.transaction(stores, mode, { durability: 'strict' });
+    }
+}
+exports.IndexedDbOutboxStore = IndexedDbOutboxStore;
+//# sourceMappingURL=outbox-indexeddb.js.map

package/lib/cjs/outbox-indexeddb.js.map

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

package/lib/cjs/outbox.d.ts

@@ -0,0 +1,53 @@
+import type { SocketError } from '@spinajs/http-socket-common';
+/** A durable command waiting for its reply. */
+export interface OutboxEntry<P = unknown> {
+    /** Queue position: assigned by the store, strictly increasing, never reused. */
+    readonly seq: number;
+    readonly name: string;
+    readonly payload: P;
+    /** Idempotency key chosen by the app; the queue persists `${clientId}:<random nonce>` when absent. */
+    readonly key?: string;
+    /** ms epoch */
+    readonly createdAt: number;
+}
+/** An entry the server refused for good; it stays until the app clears it. */
+export interface FailedOutboxEntry<P = unknown> extends OutboxEntry<P> {
+    readonly error: SocketError;
+    /** ms epoch */
+    readonly failedAt: number;
+}
+export interface OutboxInput<P = unknown> {
+    name: string;
+    payload: P;
+    key?: string;
+}
+/**
+ * Where durable commands wait for their reply. Every method resolves only once its change is durable
+ * in the store's medium: the queue sends a command after `add` resolved. One SocketClient at a time per store.
+ */
+export interface OutboxStore {
+    add<P>(input: OutboxInput<P>): Promise<OutboxEntry<P>>;
+    /** Entries not yet acknowledged, ascending `seq`. */
+    pending(): Promise<OutboxEntry[]>;
+    /** Removes an acknowledged entry; an unknown seq is ignored. */
+    remove(seq: number): Promise<void>;
+    /** Moves the pending entry `entry.seq` to the failed list as `entry`; ignored when that seq is not pending. */
+    fail(entry: FailedOutboxEntry): Promise<void>;
+    /** The failed list, ascending `seq`: export it before clearing it. */
+    failed(): Promise<FailedOutboxEntry[]>;
+    /** Removes failed entries; all of them when `seqs` is omitted. */
+    clearFailed(seqs?: readonly number[]): Promise<void>;
+}
+/** Keeps nothing across reloads: the default when no store is given. Entries are cloned in and out, as a persistent store would. */
+export declare class MemoryOutboxStore implements OutboxStore {
+    private seq;
+    private readonly entries;
+    private readonly failures;
+    add<P>(input: OutboxInput<P>): Promise<OutboxEntry<P>>;
+    pending(): Promise<OutboxEntry[]>;
+    remove(seq: number): Promise<void>;
+    fail(entry: FailedOutboxEntry): Promise<void>;
+    failed(): Promise<FailedOutboxEntry[]>;
+    clearFailed(seqs?: readonly number[]): Promise<void>;
+}
+//# sourceMappingURL=outbox.d.ts.map