@quereus/store 3.3.0 → 4.0.0

package/dist/src/common/transaction.js

@@ -1,37 +1,94 @@
 /**
  * Transaction coordinator for virtual table modules.
  *
- * Manages a shared WriteBatch across all tables in a transaction,
- * providing multi-table atomicity.
+ * Manages a shared WriteBatch across all tables in a storage MODULE,
+ * providing cross-table atomicity.
  */
 import { QuereusError, StatusCode } from '@quereus/quereus';
-/** Hex-encode a key for use as a Map key. */
-function keyToHex(key) {
-    return Array.from(key).map(b => b.toString(16).padStart(2, '0')).join('');
-}
+import { bytesToHex, compareBytes } from './bytes.js';
+/** Shared empty view returned when a store has no pending ops. */
+const EMPTY_PENDING = Object.freeze({
+    puts: new Map(),
+    deletes: new Set(),
+});
+const EMPTY_ORDERED = Object.freeze({
+    puts: [],
+    deletes: new Set(),
+});
 /**
- * Coordinates transactions across multiple tables.
+ * Coordinates transactions across the tables of one storage MODULE.
+ *
+ * A single coordinator is shared by every {@link KVStore}-backed connection the
+ * module owns (see `StoreModule.getCoordinator`). All mutations within a
+ * transaction are buffered, addressed by their explicit target store handle.
+ * On commit, every store's ops are written — in ONE {@link AtomicBatch} when the
+ * provider exposes a shared commit domain, else one per-store batch — and events
+ * are fired. On rollback, the buffer and events are discarded. Because the
+ * engine commits connections sequentially and commit/rollback are idempotent
+ * (`if (!this.inTransaction) return`), the first connection to commit flushes
+ * ALL the module's accumulated ops in one batch; the rest no-op. This gives
+ * cross-table all-or-nothing commit: a transaction touching tables A and B can
+ * never persist A but not B.
  *
- * All mutations within a transaction are buffered in a shared WriteBatch.
- * On commit, the batch is written atomically and events are fired.
- * On rollback, the batch and events are discarded.
+ * Buffered ops are additionally indexed per target store with last-write-wins
+ * semantics (see {@link getPendingOpsForStore} / {@link getOrderedPendingOps}),
+ * so reads that need to see intra-transaction writes are O(1) rather than a
+ * re-scan of the op log. Every op carries an explicit store handle — data ops,
+ * index ops, and backing-host writes alike — so two tables' data ops never
+ * collide: each table's data store is a distinct handle and buckets separately.
  */
 export class TransactionCoordinator {
-    store;
     eventEmitter;
+    /**
+     * Optional factory yielding an {@link AtomicBatch} that spans the provider's
+     * stores. Re-evaluated per commit so a provider that gains/loses the
+     * capability (or is swapped under test) is always honored; returning
+     * `undefined` falls back to the per-store {@link KVStore.batch} loop.
+     */
+    atomicBatchFactory;
     // Transaction state
     inTransaction = false;
     pendingOps = [];
     pendingEvents = [];
     savepointStack = [];
     callbacks = [];
-    constructor(store, eventEmitter) {
-        this.store = store;
+    /**
+     * Incremental last-write-wins index over `pendingOps`, bucketed per target
+     * store handle. Every op is addressed by its concrete store, so a table's
+     * data store and each of its secondary-index stores bucket separately, and
+     * two different tables (different data-store handles) never share a bucket.
+     */
+    pendingIndex = new Map();
+    constructor(eventEmitter, atomicBatchFactory) {
         this.eventEmitter = eventEmitter;
+        this.atomicBatchFactory = atomicBatchFactory;
     }
-    /** Register callbacks for transaction lifecycle events. */
+    /**
+     * Register callbacks for transaction lifecycle events.
+     *
+     * Returns a disposer that removes this EXACT pair (identity-matched). The splice
+     * runs only at teardown — never inside the commit/rollback fire loops — so there
+     * is no iterate-during-mutate hazard. The coordinator is module-wide and never
+     * prunes on its own, so a hard table eviction (drop / recreate / rename) MUST
+     * call its disposer; otherwise the pair's closures — and the {@link StoreTable}
+     * they capture — stay pinned for the module's lifetime (the leak this fixes).
+     */
     registerCallbacks(callbacks) {
         this.callbacks.push(callbacks);
+        return () => {
+            const i = this.callbacks.indexOf(callbacks);
+            if (i >= 0)
+                this.callbacks.splice(i, 1);
+        };
+    }
+    /**
+     * Number of registered lifecycle-callback pairs. Introspection for tests
+     * (regression coverage that hard eviction deregisters its pair, so the count
+     * stays O(live tables) rather than O(drop/recreate cycles)); not part of the
+     * transactional contract.
+     */
+    get callbackCount() {
+        return this.callbacks.length;
     }
     /** Check if a transaction is active. */
     isInTransaction() {
@@ -47,20 +104,29 @@ export class TransactionCoordinator {
         this.pendingOps = [];
         this.pendingEvents = [];
         this.savepointStack = [];
+        this.pendingIndex = new Map();
     }
-    /** Queue a put operation. If store is provided, targets that store instead of the default. */
+    /** Queue a put operation targeting `store`. */
     put(key, value, store) {
         if (!this.inTransaction) {
             throw new QuereusError('Cannot queue operation outside transaction', StatusCode.MISUSE);
         }
         this.pendingOps.push({ type: 'put', store, key, value });
+        const bucket = this.bucketFor(store);
+        const hex = bytesToHex(key);
+        bucket.puts.set(hex, { key, value });
+        bucket.deletes.delete(hex);
     }
-    /** Queue a delete operation. If store is provided, targets that store instead of the default. */
+    /** Queue a delete operation targeting `store`. */
     delete(key, store) {
         if (!this.inTransaction) {
             throw new QuereusError('Cannot queue operation outside transaction', StatusCode.MISUSE);
         }
         this.pendingOps.push({ type: 'delete', store, key });
+        const bucket = this.bucketFor(store);
+        const hex = bytesToHex(key);
+        bucket.deletes.add(hex);
+        bucket.puts.delete(hex);
     }
     /** Queue a data change event (fired on commit). */
     queueEvent(event) {
@@ -77,30 +143,53 @@ export class TransactionCoordinator {
             return;
         }
         try {
-            // Group pending operations by target store
+            // Group pending operations by target store handle. Each physical store
+            // appears once, so the atomic path never double-opens a store and the
+            // fallback path writes one batch per store.
             if (this.pendingOps.length > 0) {
                 const opsByStore = new Map();
                 for (const op of this.pendingOps) {
-                    const target = op.store ?? this.store;
-                    let ops = opsByStore.get(target);
+                    let ops = opsByStore.get(op.store);
                     if (!ops) {
                         ops = [];
-                        opsByStore.set(target, ops);
+                        opsByStore.set(op.store, ops);
                     }
                     ops.push(op);
                 }
-                // Write a batch per store
-                for (const [targetStore, ops] of opsByStore) {
-                    const batch = targetStore.batch();
-                    for (const op of ops) {
-                        if (op.type === 'put') {
-                            batch.put(op.key, op.value);
+                // Atomic path — when the provider exposes a shared commit domain, queue
+                // every grouped op into ONE AtomicBatch (spanning every touched store of
+                // every table) and commit once. This is what makes a multi-table
+                // transaction all-or-nothing.
+                const atomicBatch = this.atomicBatchFactory?.();
+                if (atomicBatch) {
+                    for (const [store, ops] of opsByStore) {
+                        for (const op of ops) {
+                            if (op.type === 'put') {
+                                atomicBatch.put(store, op.key, op.value);
+                            }
+                            else {
+                                atomicBatch.delete(store, op.key);
+                            }
                         }
-                        else {
-                            batch.delete(op.key);
+                    }
+                    await atomicBatch.write();
+                }
+                else {
+                    // Fallback path — one batch per store, written sequentially. No worse
+                    // than the prior per-table commits, which were already non-atomic
+                    // across tables.
+                    for (const [store, ops] of opsByStore) {
+                        const batch = store.batch();
+                        for (const op of ops) {
+                            if (op.type === 'put') {
+                                batch.put(op.key, op.value);
+                            }
+                            else {
+                                batch.delete(op.key);
+                            }
                         }
+                        await batch.write();
                     }
-                    await batch.write();
                 }
             }
             // Fire all pending events
@@ -127,30 +216,81 @@ export class TransactionCoordinator {
         }
         this.clearTransaction();
     }
-    /** Create a savepoint at the given depth. */
-    createSavepoint(_depth) {
+    /**
+     * Create a savepoint at the given depth (depth-idempotent).
+     *
+     * The coordinator is module-wide: `Database.registerConnection` replays the
+     * active savepoint stack onto every newly-registered connection, and
+     * `_createSavepointBroadcast` broadcasts each new savepoint to all active
+     * connections — so N connections (plus lazy-registration replay) all push the
+     * SAME depth onto this one shared stack. Pushing only when the stack length
+     * equals the requested depth keeps each depth recorded once: a `length > depth`
+     * call means a sibling connection (or replay) already recorded it → no-op.
+     */
+    createSavepoint(depth) {
         if (!this.inTransaction) {
             // Start implicit transaction
             this.begin();
         }
+        if (this.savepointStack.length !== depth) {
+            // Already recorded by a sibling connection or the registration replay —
+            // a duplicate push here would corrupt depth accounting (two stack entries
+            // for one logical savepoint).
+            return;
+        }
         this.savepointStack.push({
             opIndex: this.pendingOps.length,
             eventIndex: this.pendingEvents.length,
         });
     }
-    /** Release savepoints down to the target depth. */
+    /**
+     * Release savepoints down to the target depth.
+     *
+     * Depth-addressed and idempotent under repeated same-target calls (setting
+     * `length = targetDepth` twice is a no-op the second time). When the target
+     * depth exceeds the current stack size (e.g. after a store DDL-commit —
+     * `replaceContents`/`renameTable` — cleared the stack while the engine still
+     * broadcasts the savepoint), warns and returns without padding the array.
+     * Mirrors `vtab/memory/layer/connection.ts` `releaseSavepoint`.
+     */
     releaseSavepoint(targetDepth) {
+        if (targetDepth > this.savepointStack.length) {
+            // Setting Array.length to a value larger than the current length pads with
+            // undefined slots, corrupting subsequent rollback-to / release lookups.
+            // The most likely cause is a DDL-commit (replaceContents / renameTable)
+            // that cleared the stack while the engine still holds open savepoints.
+            console.warn(`[TransactionCoordinator] release savepoint depth ${targetDepth} out of range `
+                + `(stack size: ${this.savepointStack.length}); transaction was committed out from under it`);
+            return;
+        }
         this.savepointStack.length = targetDepth;
     }
-    /** Rollback to a savepoint at the target depth (preserves the savepoint). */
+    /**
+     * Rollback to a savepoint at the target depth (preserves the savepoint).
+     *
+     * Depth-addressed and idempotent under repeated same-target calls: re-slicing
+     * `pendingOps`/`pendingEvents` back to the snapshot indices and rebuilding the
+     * index is stable when nothing was queued in between. When the target depth is
+     * out of range (e.g. after a store DDL-commit — `replaceContents`/`renameTable`
+     * — cleared the stack while the engine still broadcasts the savepoint), warns
+     * and returns rather than throwing. Degrades to DDL-commits semantics: the
+     * committed DDL and everything before it stays committed. Mirrors
+     * `vtab/memory/layer/connection.ts` `rollbackToSavepoint`.
+     */
     rollbackToSavepoint(targetDepth) {
         if (targetDepth >= this.savepointStack.length) {
-            throw new QuereusError(`Savepoint depth ${targetDepth} not found`, StatusCode.NOTFOUND);
+            console.warn(`[TransactionCoordinator] rollback-to savepoint depth ${targetDepth} out of range `
+                + `(stack size: ${this.savepointStack.length}); transaction was committed out from under it`);
+            return;
         }
         const snapshot = this.savepointStack[targetDepth];
         // Truncate operations and events back to the snapshot
         this.pendingOps = this.pendingOps.slice(0, snapshot.opIndex);
         this.pendingEvents = this.pendingEvents.slice(0, snapshot.eventIndex);
+        // Rebuild the pending index from the truncated log: last-write-wins can't
+        // be incrementally undone (the pre-image is gone), and rollback-to is rare
+        // enough that an O(ops) replay is fine.
+        this.rebuildPendingIndex();
         // Remove savepoints above the target, but preserve the target itself
         this.savepointStack.length = targetDepth + 1;
     }
@@ -160,35 +300,56 @@ export class TransactionCoordinator {
         this.pendingOps = [];
         this.pendingEvents = [];
         this.savepointStack = [];
+        this.pendingIndex = new Map();
     }
-    /** Get the underlying store for direct reads. */
-    getStore() {
-        return this.store;
+    /** Get or create the mutable index bucket for a store handle. */
+    bucketFor(store) {
+        let bucket = this.pendingIndex.get(store);
+        if (!bucket) {
+            bucket = { puts: new Map(), deletes: new Set() };
+            this.pendingIndex.set(store, bucket);
+        }
+        return bucket;
     }
-    /**
-     * Snapshot pending ops targeting the given store (or the default if omitted),
-     * collapsed to last-write-wins. Used by reads that need to see
-     * intra-transaction writes (e.g. UNIQUE constraint checks).
-     */
-    getPendingOpsForStore(store) {
-        const target = store ?? this.store;
-        const puts = new Map();
-        const deletes = new Set();
+    /** Rebuild the per-store index by replaying the (truncated) op log. */
+    rebuildPendingIndex() {
+        this.pendingIndex = new Map();
         for (const op of this.pendingOps) {
-            const opStore = op.store ?? this.store;
-            if (opStore !== target)
-                continue;
-            const hex = keyToHex(op.key);
+            const bucket = this.bucketFor(op.store);
+            const hex = bytesToHex(op.key);
             if (op.type === 'put') {
-                puts.set(hex, { key: op.key, value: op.value });
-                deletes.delete(hex);
+                bucket.puts.set(hex, { key: op.key, value: op.value });
+                bucket.deletes.delete(hex);
             }
             else {
-                deletes.add(hex);
-                puts.delete(hex);
+                bucket.deletes.add(hex);
+                bucket.puts.delete(hex);
             }
         }
-        return { puts, deletes };
+    }
+    /**
+     * Pending ops targeting `store`, collapsed to last-write-wins. Used by reads
+     * that need to see intra-transaction writes (e.g. UNIQUE constraint checks).
+     * O(1): returns the live indexed view (see {@link PendingStoreOps} for
+     * caveats).
+     */
+    getPendingOpsForStore(store) {
+        return this.pendingIndex.get(store) ?? EMPTY_PENDING;
+    }
+    /**
+     * Key-ordered pending view for `store`: puts sorted ascending by encoded key
+     * bytes plus the delete set — the merge input for read-your-own-writes scans.
+     * Copies and sorts on demand (pending sets are transaction-sized), so the
+     * returned view is a stable snapshot even when coordinator mutations interleave
+     * with a long-lived merge scan.
+     */
+    getOrderedPendingOps(store) {
+        const bucket = this.pendingIndex.get(store);
+        if (!bucket || (bucket.puts.size === 0 && bucket.deletes.size === 0)) {
+            return EMPTY_ORDERED;
+        }
+        const puts = Array.from(bucket.puts.values()).sort((a, b) => compareBytes(a.key, b.key));
+        return { puts, deletes: new Set(bucket.deletes) };
     }
 }
 //# sourceMappingURL=transaction.js.map

package/dist/src/common/transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../src/common/transaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAY5D,6CAA6C;AAC7C,SAAS,QAAQ,CAAC,GAAe;IAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAwBD;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IACzB,KAAK,CAAU;IACf,YAAY,CAAqB;IAEzC,oBAAoB;IACZ,aAAa,GAAG,KAAK,CAAC;IACtB,UAAU,GAAgB,EAAE,CAAC;IAC7B,aAAa,GAAsB,EAAE,CAAC;IACtC,cAAc,GAAwB,EAAE,CAAC;IACzC,SAAS,GAA2B,EAAE,CAAC;IAE/C,YAAY,KAAc,EAAE,YAAgC;QAC1D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,2DAA2D;IAC3D,iBAAiB,CAAC,SAA+B;QAC/C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,wCAAwC;IACxC,eAAe;QACb,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,2BAA2B;IAC3B,KAAK;QACH,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,4DAA4D;YAC5D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,8FAA8F;IAC9F,GAAG,CAAC,GAAe,EAAE,KAAiB,EAAE,KAAe;QACrD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,YAAY,CAAC,4CAA4C,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,iGAAiG;IACjG,MAAM,CAAC,GAAe,EAAE,KAAe;QACrC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,YAAY,CAAC,4CAA4C,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,mDAAmD;IACnD,UAAU,CAAC,KAAsB;QAC/B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,0CAA0C;YAC1C,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,2CAA2C;YAC3C,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;gBACnD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACjC,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;oBACtC,IAAI,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACjC,IAAI,CAAC,GAAG,EAAE,CAAC;wBAAC,GAAG,GAAG,EAAE,CAAC;wBAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;oBAAC,CAAC;oBACpD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;gBAED,0BAA0B;gBAC1B,KAAK,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;oBAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;oBAClC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;wBACrB,IAAI,EAAE,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;4BACtB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAM,CAAC,CAAC;wBAC/B,CAAC;6BAAM,CAAC;4BACN,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;wBACvB,CAAC;oBACH,CAAC;oBACD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;gBACtB,CAAC;YACH,CAAC;YAED,0BAA0B;YAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC;YAED,mBAAmB;YACnB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,EAAE,CAAC,QAAQ,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,mBAAmB;QACnB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,EAAE,CAAC,UAAU,EAAE,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED,6CAA6C;IAC7C,eAAe,CAAC,MAAc;QAC5B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,6BAA6B;YAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;YAC/B,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM;SACtC,CAAC,CAAC;IACL,CAAC;IAED,mDAAmD;IACnD,gBAAgB,CAAC,WAAmB;QAClC,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,WAAW,CAAC;IAC3C,CAAC;IAED,6EAA6E;IAC7E,mBAAmB,CAAC,WAAmB;QACrC,IAAI,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;YAC9C,MAAM,IAAI,YAAY,CAAC,mBAAmB,WAAW,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAElD,sDAAsD;QACtD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEtE,qEAAqE;QACrE,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,mCAAmC;IAC3B,gBAAgB;QACtB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,iDAAiD;IACjD,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,qBAAqB,CAAC,KAAe;QACnC,MAAM,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkD,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;YACvC,IAAI,OAAO,KAAK,MAAM;gBAAE,SAAS;YACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAM,EAAE,CAAC,CAAC;gBACjD,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../src/common/transaction.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quereus/store",
-  "version": "3.3.0",
+  "version": "4.0.0",
   "type": "module",
   "description": "Abstract key-value storage module for Quereus",
   "keywords": [
@@ -40,12 +40,12 @@
     "test:single": "cd ../.. && node --import ./packages/quereus-store/register.mjs node_modules/mocha/bin/mocha.js --bail"
   },
   "peerDependencies": {
-    "@quereus/isolation": "^3.3.0",
-    "@quereus/quereus": "^3.3.0"
+    "@quereus/isolation": "^4.0.0",
+    "@quereus/quereus": "^4.0.0"
   },
   "dependencies": {
-    "@quereus/isolation": "^3.3.0",
-    "@quereus/quereus": "^3.3.0"
+    "@quereus/isolation": "^4.0.0",
+    "@quereus/quereus": "^4.0.0"
   },
   "devDependencies": {
     "@types/mocha": "^10.0.10",