@gonvex/client 0.1.30 → 0.1.32

package/dist/optimistic.js

@@ -1,38 +1,78 @@
 /**
- * An ordered, in-memory view of mutations that have not settled yet.
+ * Ordered pending entity mutations layered over immutable authoritative data.
  *
- * Authoritative sync rows remain untouched. Consumers materialize this overlay
- * at read time, so rejecting an entry simply reveals the current server state.
+ * A source is one concrete sync/query subscription (including its arguments).
+ * Successful mutations remain pending until every source that exposed the
+ * optimistic row reports that mutation id in an authoritative update. This
+ * prevents a fast RPC acknowledgement from revealing an older subscription
+ * snapshot while its invalidation is still in flight.
  */
 export class OptimisticOverlay {
     entries = [];
     listeners = new Set();
     cache = new Map();
     version = 0;
-    /** Append a mutation's patches after every currently pending mutation. */
-    add(mutationId, patches) {
-        if (patches.length === 0)
+    settling = false;
+    add(mutationId, patches, options = {}) {
+        const normalized = patches.map(clonePatch).filter((patch) => patchEntity(patch) !== "");
+        if (normalized.length === 0)
             return;
-        this.entries.push({ mutationId, patches: patches.map(clonePatch) });
-        this.changed(affectedCollections(patches));
+        this.entries.push({
+            mutationId,
+            patches: normalized,
+            accepted: options.accepted === true,
+            targets: new Set(),
+            acknowledgedTargets: new Set(),
+        });
+        this.changed(affectedEntities(normalized));
     }
-    /** Remove patches after a successful authoritative server result. */
+    /** Reserve a live projection even when its first snapshot is still pending. */
+    expectSource(source, entity) {
+        let added = false;
+        for (const entry of this.entries) {
+            if (!entry.patches.some((patch) => patchEntity(patch) === entity))
+                continue;
+            if (entry.targets.has(source))
+                continue;
+            entry.targets.add(source);
+            added = true;
+        }
+        if (!added)
+            return;
+        this.version += 1;
+        this.cache.clear();
+    }
+    /** Mark the transport result successful without dropping visible optimism. */
+    accept(mutationId) {
+        const entry = this.entries.find((candidate) => candidate.mutationId === mutationId);
+        if (!entry)
+            return [];
+        entry.accepted = true;
+        return this.settleReadyEntries();
+    }
+    /** Compatibility alias. Prefer accept followed by authoritative acknowledge. */
     settle(mutationId) {
-        this.remove(mutationId);
+        this.accept(mutationId);
     }
     /** Remove patches after a deterministic server rejection. */
     reject(mutationId) {
         this.remove(mutationId);
     }
-    /** Materialize one collection without mutating its authoritative rows. */
-    apply(collection, rows, keyField) {
-        const cached = this.cache.get(collection);
+    apply(sourceOrEntity, entityOrRows, rowsOrKey, maybeKey) {
+        const legacy = Array.isArray(entityOrRows);
+        const source = legacy ? sourceOrEntity : sourceOrEntity;
+        const entity = legacy ? sourceOrEntity : entityOrRows;
+        const rows = (legacy ? entityOrRows : rowsOrKey);
+        const keyField = (legacy ? rowsOrKey : maybeKey);
+        const cacheKey = `${source}\u0000${entity}`;
+        const cached = this.cache.get(cacheKey);
         if (cached?.base === rows && cached.version === this.version)
             return cached.rows;
         let materialized = rows.slice();
         for (const entry of this.entries) {
+            let touched = false;
             for (const patch of entry.patches) {
-                if (patch.collection !== collection)
+                if (patchEntity(patch) !== entity)
                     continue;
                 const index = materialized.findIndex((row) => {
                     const key = row[keyField];
@@ -41,44 +81,124 @@ export class OptimisticOverlay {
                 if (patch.op === "patch") {
                     if (index >= 0) {
                         materialized[index] = { ...materialized[index], ...patch.fields };
+                        touched = true;
                     }
                 }
                 else if (patch.op === "insert") {
-                    if (index < 0) {
+                    if (index < 0)
                         materialized.push({ ...patch.fields, [keyField]: patch.rowId });
-                    }
+                    touched = true;
                 }
                 else if (index >= 0) {
                     materialized = [...materialized.slice(0, index), ...materialized.slice(index + 1)];
+                    touched = true;
                 }
             }
+            if (touched) {
+                entry.targets.add(source);
+            }
+            else if (entry.targets.has(source)) {
+                // The source cannot expose this row, so it is already reconciled from
+                // that source's perspective.
+                entry.acknowledgedTargets.add(source);
+            }
         }
-        this.cache.set(collection, { base: rows, version: this.version, rows: materialized });
+        this.cache.set(cacheKey, { base: rows, version: this.version, rows: materialized });
         return materialized;
     }
-    /** Subscribe to collections whose materialized rows may have changed. */
+    /** Record authoritative delivery for a source; returns fully reconciled ids. */
+    acknowledge(source, mutationIds) {
+        if (!mutationIds?.length)
+            return [];
+        const ids = new Set(mutationIds);
+        for (const entry of this.entries) {
+            if (ids.has(entry.mutationId) && entry.targets.has(source)) {
+                entry.acknowledgedTargets.add(source);
+            }
+        }
+        return this.settleReadyEntries();
+    }
+    /** Reconcile restored committed entries against an authoritative snapshot. */
+    acknowledgeMatching(source, entity, rows, keyField) {
+        for (const entry of this.entries) {
+            if (!entry.accepted || !entry.targets.has(source))
+                continue;
+            const patches = entry.patches.filter((patch) => {
+                if (patchEntity(patch) !== entity)
+                    return false;
+                if (patch.op === "delete")
+                    return patchMatchesRows(patch, rows, keyField);
+                return rows.some((row) => {
+                    const key = row[keyField];
+                    return key !== null && key !== undefined && String(key) === patch.rowId;
+                });
+            });
+            if (patches.length === 0 || !patches.every((patch) => patchMatchesRows(patch, rows, keyField)))
+                continue;
+            entry.acknowledgedTargets.add(source);
+        }
+        return this.settleReadyEntries();
+    }
+    /** Stop waiting for a subscription that no longer exists. */
+    removeSource(source) {
+        for (const entry of this.entries) {
+            entry.targets.delete(source);
+            entry.acknowledgedTargets.delete(source);
+        }
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(`${source}\u0000`))
+                this.cache.delete(key);
+        }
+        return this.settleReadyEntries();
+    }
     subscribe(listener) {
         this.listeners.add(listener);
         return () => this.listeners.delete(listener);
     }
-    /** Whether any pending mutation touches this collection row. */
-    pendingFor(collection, rowId) {
-        return this.entries.some((entry) => entry.patches.some((patch) => (patch.collection === collection && patch.rowId === rowId)));
+    pendingFor(entity, rowId) {
+        return this.entries.some((entry) => entry.patches.some((patch) => (patchEntity(patch) === entity && patch.rowId === rowId)));
+    }
+    settleReadyEntries() {
+        // Removing an entry emits a new materialized snapshot. Query/sync
+        // listeners may synchronously acknowledge that snapshot and re-enter this
+        // method, so only the outer settlement pass is allowed to splice entries.
+        // The nested acknowledgement still updates acknowledgedTargets; the outer
+        // reverse loop observes that state when it reaches the remaining entry.
+        if (this.settling)
+            return [];
+        this.settling = true;
+        const settled = [];
+        try {
+            for (let index = this.entries.length - 1; index >= 0; index -= 1) {
+                const entry = this.entries[index];
+                if (!entry?.accepted)
+                    continue;
+                if ([...entry.targets].some((target) => !entry.acknowledgedTargets.has(target)))
+                    continue;
+                this.entries.splice(index, 1);
+                settled.push(entry.mutationId);
+                this.changed(affectedEntities(entry.patches));
+            }
+            return settled.reverse();
+        }
+        finally {
+            this.settling = false;
+        }
     }
     remove(mutationId) {
         const index = this.entries.findIndex((entry) => entry.mutationId === mutationId);
         if (index < 0)
             return;
         const [entry] = this.entries.splice(index, 1);
-        this.changed(affectedCollections(entry.patches));
+        this.changed(affectedEntities(entry.patches));
     }
-    changed(collections) {
+    changed(entities) {
         this.version += 1;
         this.cache.clear();
-        for (const collection of collections) {
+        for (const entity of entities) {
             for (const listener of Array.from(this.listeners)) {
                 try {
-                    listener(collection);
+                    listener(entity);
                 }
                 catch {
                     // A view listener must not be able to break mutation delivery.
@@ -87,12 +207,81 @@ export class OptimisticOverlay {
         }
     }
 }
-function affectedCollections(patches) {
-    return new Set(patches.map((patch) => patch.collection));
+export function optimisticPatchesFromReference(definition, args) {
+    if (!definition?.entity)
+        return [];
+    const record = isRecord(args) ? args : {};
+    const configuredRowId = definition.rowIdPath.length > 0
+        ? readPath(record, definition.rowIdPath)
+        : undefined;
+    const rowId = String(configuredRowId ?? record.id ?? record._id ?? "");
+    const nested = readPath(record, definition.fieldsPath);
+    if (!rowId || !isRecord(nested))
+        return [];
+    return [{
+            entity: definition.entity,
+            rowId,
+            op: "patch",
+            fields: normalizeOptimisticFields(nested),
+        }];
+}
+function normalizeOptimisticFields(fields) {
+    const normalized = { ...fields };
+    for (const [key, value] of Object.entries(fields)) {
+        const camel = key.replace(/_([a-z0-9])/g, (_, character) => character.toUpperCase());
+        if (!(camel in normalized))
+            normalized[camel] = value;
+    }
+    return normalized;
+}
+function readPath(value, path) {
+    let current = value;
+    for (const segment of path) {
+        if (!isRecord(current))
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function patchEntity(patch) {
+    return String(patch.entity ?? patch.collection ?? "");
+}
+function affectedEntities(patches) {
+    return new Set(patches.map(patchEntity).filter(Boolean));
 }
 function clonePatch(patch) {
     if (patch.op === "delete")
         return { ...patch };
     return { ...patch, fields: { ...patch.fields } };
 }
+function patchMatchesRows(patch, rows, keyField) {
+    const row = rows.find((candidate) => {
+        const key = candidate[keyField];
+        return key !== null && key !== undefined && String(key) === patch.rowId;
+    });
+    if (patch.op === "delete")
+        return row === undefined;
+    if (!row)
+        return false;
+    return Object.entries(patch.fields).every(([key, value]) => valuesEqual(row[key], value));
+}
+function valuesEqual(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (Array.isArray(left) || Array.isArray(right)) {
+        return Array.isArray(left)
+            && Array.isArray(right)
+            && left.length === right.length
+            && left.every((value, index) => valuesEqual(value, right[index]));
+    }
+    if (!isRecord(left) || !isRecord(right))
+        return false;
+    const leftKeys = Object.keys(left).sort();
+    const rightKeys = Object.keys(right).sort();
+    return leftKeys.length === rightKeys.length
+        && leftKeys.every((key, index) => key === rightKeys[index] && valuesEqual(left[key], right[key]));
+}
 //# sourceMappingURL=optimistic.js.map

package/dist/optimistic.js.map

@@ -1 +1 @@
-{"version":3,"file":"optimistic.js","sourceRoot":"","sources":["../src/optimistic.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"optimistic.js","sourceRoot":"","sources":["../src/optimistic.ts"],"names":[],"mappings":"AA+CA;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,GAAmB,EAAE,CAAC;IAC7B,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;IAChD,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IACpD,OAAO,GAAG,CAAC,CAAC;IACZ,QAAQ,GAAG,KAAK,CAAC;IAEzB,GAAG,CAAC,UAAkB,EAAE,OAA0B,EAAE,UAAkC,EAAE;QACtF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACxF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,UAAU;YACV,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI;YACnC,OAAO,EAAE,IAAI,GAAG,EAAE;YAClB,mBAAmB,EAAE,IAAI,GAAG,EAAE;SAC/B,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,+EAA+E;IAC/E,YAAY,CAAC,MAAc,EAAE,MAAc;QACzC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC;gBAAE,SAAS;YAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YACxC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1B,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,8EAA8E;IAC9E,MAAM,CAAC,UAAkB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QACtB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,UAAkB;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAC,UAAkB;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAQD,KAAK,CACH,cAAsB,EACtB,YAAqC,EACrC,SAAkC,EAClC,QAAiB;QAEjB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAsB,CAAC;QAChE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAmB,CAAC;QACnE,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAW,CAAC;QAC3D,MAAM,QAAQ,GAAG,GAAG,MAAM,SAAS,MAAM,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAEjF,IAAI,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,MAAM;oBAAE,SAAS;gBAC5C,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;oBAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC1B,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC;gBAC1E,CAAC,CAAC,CAAC;gBACH,IAAI,KAAK,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;oBACzB,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;wBACf,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;wBAClE,OAAO,GAAG,IAAI,CAAC;oBACjB,CAAC;gBACH,CAAC;qBAAM,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;oBACjC,IAAI,KAAK,GAAG,CAAC;wBAAE,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;oBAC/E,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;qBAAM,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBACtB,YAAY,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;oBACnF,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;YACH,CAAC;YACD,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,sEAAsE;gBACtE,6BAA6B;gBAC7B,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACpF,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,gFAAgF;IAChF,WAAW,CAAC,MAAc,EAAE,WAA0C;QACpE,IAAI,CAAC,WAAW,EAAE,MAAM;YAAE,OAAO,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3D,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,8EAA8E;IAC9E,mBAAmB,CAAC,MAAc,EAAE,MAAc,EAAE,IAAoB,EAAE,QAAgB;QACxF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC7C,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,MAAM;oBAAE,OAAO,KAAK,CAAC;gBAChD,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ;oBAAE,OAAO,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;oBACvB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC1B,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC;gBAC1E,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAAE,SAAS;YACzG,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,6DAA6D;IAC7D,YAAY,CAAC,MAAc;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,QAAQ,CAAC;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,QAAkC;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,UAAU,CAAC,MAAc,EAAE,KAAa;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAChE,WAAW,CAAC,KAAK,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CACvD,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,kBAAkB;QACxB,kEAAkE;QAClE,0EAA0E;QAC1E,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;gBACjE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,CAAC,KAAK,EAAE,QAAQ;oBAAE,SAAS;gBAC/B,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAAE,SAAS;gBAC1F,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/B,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,UAAkB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACjF,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO;QACtB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAEO,OAAO,CAAC,QAAqB;QACnC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC;oBACH,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC;oBACP,+DAA+D;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAC5C,UAAoD,EACpD,IAAa;IAEb,IAAI,CAAC,UAAU,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QACrD,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC;QACxC,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,CAAC;YACN,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,KAAK;YACL,EAAE,EAAE,OAAO;YACX,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC;SAC1C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAAC,MAA+B;IAChE,MAAM,UAAU,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,SAAiB,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,KAAK,IAAI,UAAU,CAAC;YAAE,UAAU,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACxD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,IAAuB;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,WAAW,CAAC,KAAsB;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAmC;IAC3D,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAAC,KAAsB;IACxC,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IAC/C,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAsB,EAAE,IAAoB,EAAE,QAAgB;IACtF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,GAAG,KAAK,SAAS,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,KAAc;IAChD,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;eACrB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;eACpB,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;eAC5B,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;WACtC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC"}

package/dist/outbox.d.ts

@@ -4,10 +4,32 @@ export type MutationOutboxOptions = {
     indexedDB?: IDBFactory;
     IDBKeyRange?: typeof IDBKeyRange;
     enabled?: boolean;
+    /**
+     * Injectable durable record storage for runtimes without IndexedDB (React
+     * Native). When provided, the queue semantics still run in the SDK; the
+     * store only persists entries so they survive an app restart.
+     */
+    store?: OutboxStore;
+};
+/**
+ * A dumb durable record store backing {@link StoreMutationOutbox}. It holds
+ * whole entries keyed by id and knows nothing about queue semantics — total
+ * order, causal barriers, and inflight recovery all stay in the SDK.
+ */
+export type OutboxStore = {
+    /** Every persisted entry across all scopes; called once to hydrate. */
+    load(): Promise<MutationOutboxEntry[]>;
+    /** Insert or replace the entry with this id. */
+    put(entry: MutationOutboxEntry): Promise<void>;
+    delete(id: number): Promise<void>;
+    clear(scope?: string): Promise<void>;
+    close?(): void;
 };
 export type MutationOutboxEntry = {
     /** Auto-incremented sequence number. Lower ids always happened first. */
     id: number;
+    /** Authenticated project/tenant/user identity that owns this mutation. */
+    scope: string;
     path: string;
     args: unknown;
     idempotencyKey: string;
@@ -19,23 +41,28 @@ export type MutationOutboxEntry = {
     attempts: number;
     nextAttemptAt: number;
     lastError?: string;
-    state: "pending" | "inflight";
+    state: "pending" | "inflight" | "committed";
 };
 export type EnqueueMutation = {
+    scope: string;
     path: string;
     args: unknown;
     idempotencyKey?: string;
     entityKeys?: string[];
     patches?: OptimisticPatch[];
+    /** Direct online sends start inflight so the background drain cannot race them. */
+    state?: "pending" | "inflight";
 };
 export type MutationOutbox = {
     enqueue(mutation: EnqueueMutation): Promise<MutationOutboxEntry>;
-    loadAll(): Promise<MutationOutboxEntry[]>;
-    nextReady(now: number): Promise<MutationOutboxEntry | undefined>;
+    loadAll(scope: string): Promise<MutationOutboxEntry[]>;
+    nextReady(scope: string, now: number): Promise<MutationOutboxEntry | undefined>;
     markInflight(id: number): Promise<void>;
+    markCommitted(id: number): Promise<void>;
     ack(id: number): Promise<void>;
     fail(id: number, error: string): Promise<void>;
-    count(): Promise<number>;
+    count(scope: string): Promise<number>;
+    clear(scope: string): Promise<void>;
     subscribe(listener: () => void): () => void;
 };
 /**
@@ -63,24 +90,65 @@ export declare class DexieMutationOutbox implements MutationOutbox {
     private nextMemoryId;
     constructor(options?: MutationOutboxOptions);
     enqueue(mutation: EnqueueMutation): Promise<MutationOutboxEntry>;
-    loadAll(): Promise<MutationOutboxEntry[]>;
-    nextReady(now: number): Promise<MutationOutboxEntry | undefined>;
+    loadAll(scope: string): Promise<MutationOutboxEntry[]>;
+    nextReady(scope: string, now: number): Promise<MutationOutboxEntry | undefined>;
     markInflight(id: number): Promise<void>;
+    markCommitted(id: number): Promise<void>;
     ack(id: number): Promise<void>;
     fail(id: number, error: string): Promise<void>;
-    count(): Promise<number>;
+    count(scope: string): Promise<number>;
+    clear(scope: string): Promise<void>;
     subscribe(listener: () => void): () => void;
     private enqueueInMemory;
     private loadAllFromMemory;
     private markInflightInMemory;
+    private markCommittedInMemory;
     private ackInMemory;
     private failInMemory;
     private sortedMemoryEntries;
     private remember;
-    private replaceMemoryEntries;
+    private replaceMemoryEntriesForScope;
     private notify;
     private degradeToMemory;
     private open;
     private createDatabase;
 }
+/**
+ * The same totally ordered queue semantics as {@link DexieMutationOutbox},
+ * run entirely in memory with every state transition written through an
+ * injected {@link OutboxStore}. Hydration replays `store.load()` once and
+ * seeds the auto-increment id from the highest persisted id, so replayed
+ * entries keep their original ids, idempotency keys, and enqueue order.
+ *
+ * The store is an optimization for durability, not a prerequisite for the
+ * optimistic mutation path. A failing store permanently degrades this
+ * instance to the same queue semantics in memory for the current session.
+ */
+export declare class StoreMutationOutbox implements MutationOutbox {
+    private readonly store;
+    private readonly listeners;
+    private readonly entries;
+    private readonly ready;
+    private memoryOnly;
+    private nextId;
+    constructor(store: OutboxStore, options?: {
+        enabled?: boolean;
+    });
+    enqueue(mutation: EnqueueMutation): Promise<MutationOutboxEntry>;
+    loadAll(scope: string): Promise<MutationOutboxEntry[]>;
+    nextReady(scope: string, now: number): Promise<MutationOutboxEntry | undefined>;
+    markInflight(id: number): Promise<void>;
+    markCommitted(id: number): Promise<void>;
+    ack(id: number): Promise<void>;
+    fail(id: number, error: string): Promise<void>;
+    count(scope: string): Promise<number>;
+    clear(scope: string): Promise<void>;
+    subscribe(listener: () => void): () => void;
+    private hydrate;
+    private persistPut;
+    private persistDelete;
+    private sortedEntries;
+    private notify;
+    private degradeToMemory;
+}
 export declare function createMutationOutbox(options?: MutationOutboxOptions): MutationOutbox;