@quereus/store 0.3.6 → 0.3.7

package/dist/src/common/transaction.js

@@ -0,0 +1,156 @@
+/**
+ * Transaction coordinator for virtual table modules.
+ *
+ * Manages a shared WriteBatch across all tables in a transaction,
+ * providing multi-table atomicity.
+ */
+import { QuereusError, StatusCode } from '@quereus/quereus';
+/**
+ * Coordinates transactions across multiple tables.
+ *
+ * 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.
+ */
+export class TransactionCoordinator {
+    store;
+    eventEmitter;
+    // Transaction state
+    inTransaction = false;
+    pendingOps = [];
+    pendingEvents = [];
+    savepoints = new Map();
+    callbacks = [];
+    constructor(store, eventEmitter) {
+        this.store = store;
+        this.eventEmitter = eventEmitter;
+    }
+    /** Register callbacks for transaction lifecycle events. */
+    registerCallbacks(callbacks) {
+        this.callbacks.push(callbacks);
+    }
+    /** Check if a transaction is active. */
+    isInTransaction() {
+        return this.inTransaction;
+    }
+    /** Begin a transaction. */
+    begin() {
+        if (this.inTransaction) {
+            // Already in transaction - no-op (matches SQLite semantics)
+            return;
+        }
+        this.inTransaction = true;
+        this.pendingOps = [];
+        this.pendingEvents = [];
+        this.savepoints.clear();
+    }
+    /** Queue a put operation. */
+    put(key, value) {
+        if (!this.inTransaction) {
+            throw new QuereusError('Cannot queue operation outside transaction', StatusCode.MISUSE);
+        }
+        this.pendingOps.push({ type: 'put', key, value });
+    }
+    /** Queue a delete operation. */
+    delete(key) {
+        if (!this.inTransaction) {
+            throw new QuereusError('Cannot queue operation outside transaction', StatusCode.MISUSE);
+        }
+        this.pendingOps.push({ type: 'delete', key });
+    }
+    /** Queue a data change event (fired on commit). */
+    queueEvent(event) {
+        if (!this.inTransaction) {
+            // If not in transaction, emit immediately
+            this.eventEmitter?.emitDataChange(event);
+            return;
+        }
+        this.pendingEvents.push(event);
+    }
+    /** Commit the transaction. */
+    async commit() {
+        if (!this.inTransaction) {
+            return;
+        }
+        try {
+            // Write all pending operations atomically
+            if (this.pendingOps.length > 0) {
+                const batch = this.store.batch();
+                for (const op of this.pendingOps) {
+                    if (op.type === 'put') {
+                        batch.put(op.key, op.value);
+                    }
+                    else {
+                        batch.delete(op.key);
+                    }
+                }
+                await batch.write();
+            }
+            // Fire all pending events
+            for (const event of this.pendingEvents) {
+                this.eventEmitter?.emitDataChange(event);
+            }
+            // Notify callbacks
+            for (const cb of this.callbacks) {
+                cb.onCommit();
+            }
+        }
+        finally {
+            this.clearTransaction();
+        }
+    }
+    /** Rollback the transaction. */
+    rollback() {
+        if (!this.inTransaction) {
+            return;
+        }
+        // Notify callbacks
+        for (const cb of this.callbacks) {
+            cb.onRollback();
+        }
+        this.clearTransaction();
+    }
+    /** Create a savepoint. */
+    createSavepoint(index) {
+        if (!this.inTransaction) {
+            // Start implicit transaction
+            this.begin();
+        }
+        this.savepoints.set(index, {
+            opIndex: this.pendingOps.length,
+            eventIndex: this.pendingEvents.length,
+        });
+    }
+    /** Release a savepoint (no-op, just removes from map). */
+    releaseSavepoint(index) {
+        this.savepoints.delete(index);
+    }
+    /** Rollback to a savepoint. */
+    rollbackToSavepoint(index) {
+        const savepoint = this.savepoints.get(index);
+        if (!savepoint) {
+            throw new QuereusError(`Savepoint ${index} not found`, StatusCode.NOTFOUND);
+        }
+        // Truncate operations and events back to savepoint
+        this.pendingOps = this.pendingOps.slice(0, savepoint.opIndex);
+        this.pendingEvents = this.pendingEvents.slice(0, savepoint.eventIndex);
+        // Remove this savepoint and any created after it
+        for (const [idx] of this.savepoints) {
+            if (idx >= index) {
+                this.savepoints.delete(idx);
+            }
+        }
+    }
+    /** Clear all transaction state. */
+    clearTransaction() {
+        this.inTransaction = false;
+        this.pendingOps = [];
+        this.pendingEvents = [];
+        this.savepoints.clear();
+    }
+    /** Get the underlying store for direct reads. */
+    getStore() {
+        return this.store;
+    }
+}
+//# sourceMappingURL=transaction.js.map

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

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

package/dist/src/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Abstract Store Module for Quereus
+ *
+ * Provides the generic StoreModule and KVStore abstractions for persistent storage.
+ * Concrete implementations (LevelDB, IndexedDB) are in separate plugin packages:
+ *   - @quereus/plugin-leveldb (Node.js)
+ *   - @quereus/plugin-indexeddb (Browser)
+ *
+ * Usage:
+ *   import { StoreModule, type KVStoreProvider } from '@quereus/store';
+ *
+ *   const provider: KVStoreProvider = createYourProvider();
+ *   const module = new StoreModule(provider);
+ *   db.registerVtabModule('store', module);
+ */
+export * from './common/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,cAAc,mBAAmB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,18 @@
+/**
+ * Abstract Store Module for Quereus
+ *
+ * Provides the generic StoreModule and KVStore abstractions for persistent storage.
+ * Concrete implementations (LevelDB, IndexedDB) are in separate plugin packages:
+ *   - @quereus/plugin-leveldb (Node.js)
+ *   - @quereus/plugin-indexeddb (Browser)
+ *
+ * Usage:
+ *   import { StoreModule, type KVStoreProvider } from '@quereus/store';
+ *
+ *   const provider: KVStoreProvider = createYourProvider();
+ *   const module = new StoreModule(provider);
+ *   db.registerVtabModule('store', module);
+ */
+// Export all common utilities and abstractions
+export * from './common/index.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,+CAA+C;AAC/C,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quereus/store",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "type": "module",
   "description": "Abstract key-value storage module for Quereus",
   "keywords": [