@quereus/plugin-leveldb 0.4.1 → 0.5.0

package/README.md

@@ -5,6 +5,7 @@ LevelDB storage plugin for Quereus. Provides persistent storage for Node.js envi
 ## Features
 
 - **Fast**: LevelDB offers excellent read/write performance for key-value workloads
+- **Transaction isolation**: Read-your-own-writes and snapshot isolation by default
 - **Sorted keys**: Efficient range queries with ordered iteration
 - **ACID batches**: Atomic writes across multiple keys
 - **Compression**: Built-in Snappy compression for reduced disk usage
@@ -12,7 +13,7 @@ LevelDB storage plugin for Quereus. Provides persistent storage for Node.js envi
 ## Installation
 
 ```bash
-npm install @quereus/plugin-leveldb @quereus/store
+npm install @quereus/plugin-leveldb @quereus/store @quereus/isolation
 ```
 
 ## Quick Start
@@ -27,9 +28,26 @@ const db = new Database();
 await registerPlugin(db, leveldbPlugin, { basePath: './data' });
 
 await db.exec(`
-  create table users (id integer primary key, name text)
-  using store
+	create table users (id integer primary key, name text)
+	using store
 `);
+
+// Full transaction isolation enabled by default
+await db.exec('BEGIN');
+await db.exec(`INSERT INTO users VALUES (1, 'Alice')`);
+const user = await db.get('SELECT * FROM users WHERE id = 1'); // Sees uncommitted insert
+await db.exec('COMMIT');
+```
+
+### Disabling Isolation
+
+If you need maximum performance and don't require read-your-own-writes within transactions:
+
+```typescript
+await registerPlugin(db, leveldbPlugin, { 
+	basePath: './data',
+	isolation: false  // Disable isolation layer
+});
 ```
 
 ### Direct Usage with Provider
@@ -37,16 +55,18 @@ await db.exec(`
 ```typescript
 import { Database } from '@quereus/quereus';
 import { createLevelDBProvider } from '@quereus/plugin-leveldb';
-import { StoreModule } from '@quereus/store';
+import { createIsolatedStoreModule } from '@quereus/store';
 
 const db = new Database();
 const provider = createLevelDBProvider({ basePath: './data' });
-const storeModule = new StoreModule(provider);
+
+// With isolation (recommended)
+const storeModule = createIsolatedStoreModule({ provider });
 db.registerModule('store', storeModule);
 
 await db.exec(`
-  create table users (id integer primary key, name text)
-  using store
+	create table users (id integer primary key, name text)
+	using store
 `);
 ```
 

package/dist/src/plugin.d.ts

@@ -25,6 +25,12 @@ export interface LevelDBPluginConfig {
      * @default 'store'
      */
     moduleName?: string;
+    /**
+     * Enable transaction isolation (read-your-own-writes, snapshot isolation).
+     * When true, wraps the store module with an isolation layer.
+     * @default true
+     */
+    isolation?: boolean;
 }
 /**
  * Register the LevelDB plugin with a database.
@@ -32,7 +38,7 @@ export interface LevelDBPluginConfig {
 export default function register(_db: Database, config?: Record<string, SqlValue>): {
     vtables: {
         name: string;
-        module: StoreModule;
+        module: import("@quereus/isolation").IsolationModule | StoreModule;
     }[];
 };
 //# sourceMappingURL=plugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;;;;;EAqBtC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAA6B,MAAM,gBAAgB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;;;;;EAwBrC"}

package/dist/src/plugin.js

@@ -3,7 +3,7 @@
  *
  * Registers a StoreModule backed by LevelDB for Node.js environments.
  */
-import { StoreModule } from '@quereus/store';
+import { StoreModule, createIsolatedStoreModule } from '@quereus/store';
 import { LevelDBProvider } from './provider.js';
 /**
  * Register the LevelDB plugin with a database.
@@ -12,11 +12,14 @@ export default function register(_db, config = {}) {
     const basePath = config.basePath ?? './data';
     const createIfMissing = config.createIfMissing !== false;
     const moduleName = config.moduleName ?? 'store';
+    const isolation = config.isolation ?? true;
     const provider = new LevelDBProvider({
         basePath,
         createIfMissing,
     });
-    const storeModule = new StoreModule(provider);
+    const storeModule = isolation
+        ? createIsolatedStoreModule({ provider })
+        : new StoreModule(provider);
     return {
         vtables: [
             {

package/dist/src/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA0BhD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,GAAa,EACb,SAAmC,EAAE;IAErC,MAAM,QAAQ,GAAI,MAAM,CAAC,QAAmB,IAAI,QAAQ,CAAC;IACzD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC;IACzD,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAE5D,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;QACnC,QAAQ;QACR,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE9C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,WAAW;aACpB;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAiChD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAa,EACb,SAAmC,EAAE;IAErC,MAAM,QAAQ,GAAI,MAAM,CAAC,QAAmB,IAAI,QAAQ,CAAC;IACzD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC;IACzD,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAC5D,MAAM,SAAS,GAAI,MAAM,CAAC,SAAqB,IAAI,IAAI,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;QACpC,QAAQ;QACR,eAAe;KACf,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,SAAS;QAC5B,CAAC,CAAC,yBAAyB,CAAC,EAAE,QAAQ,EAAE,CAAC;QACzC,CAAC,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7B,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,WAAW;aACnB;SACD;KACD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quereus/plugin-leveldb",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "type": "module",
   "description": "LevelDB storage plugin for Quereus - Node.js persistent storage",
   "keywords": [
@@ -37,8 +37,9 @@
     }
   },
   "peerDependencies": {
-    "@quereus/quereus": "^0.12.1",
-    "@quereus/store": "^0.5.1"
+    "@quereus/isolation": "^0.2.0",
+    "@quereus/quereus": "^0.13.0",
+    "@quereus/store": "^0.6.0"
   },
   "engines": {
     "quereus": "^0.24.0"
@@ -70,6 +71,13 @@
         "type": "string",
         "default": "store",
         "help": "Name to register the virtual table module under"
+      },
+      {
+        "key": "isolation",
+        "label": "Transaction Isolation",
+        "type": "boolean",
+        "default": true,
+        "help": "Enable transaction isolation (read-your-own-writes, snapshot isolation)"
       }
     ]
   },
@@ -83,6 +91,7 @@
     "classic-level": "^2.0.0"
   },
   "devDependencies": {
+    "@quereus/isolation": "*",
     "@quereus/quereus": "*",
     "@quereus/store": "*",
     "@types/mocha": "^10.0.10",