@quereus/plugin-indexeddb 0.4.2 → 0.5.0

package/README.md

@@ -5,13 +5,14 @@ IndexedDB storage plugin for Quereus. Provides persistent storage for browser en
 ## Features
 
 - **Browser-native**: Uses IndexedDB for reliable persistent storage
+- **Transaction isolation**: Read-your-own-writes and snapshot isolation by default
 - **Cross-tab sync**: BroadcastChannel-based synchronization across browser tabs
 - **Async iteration**: Efficient range queries with cursor-based iteration
 
 ## Installation
 
 ```bash
-npm install @quereus/plugin-indexeddb @quereus/store
+npm install @quereus/plugin-indexeddb @quereus/store @quereus/isolation
 ```
 
 ## Quick Start
@@ -26,6 +27,23 @@ const db = new Database();
 await registerPlugin(db, indexeddbPlugin, { prefix: 'myapp' });
 
 await db.exec(`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, indexeddbPlugin, { 
+	prefix: 'myapp',
+	isolation: false  // Disable isolation layer
+});
 ```
 
 ### Direct Usage with Provider
@@ -33,11 +51,13 @@ await db.exec(`create table users (id integer primary key, name text) using stor
 ```typescript
 import { Database } from '@quereus/quereus';
 import { createIndexedDBProvider } from '@quereus/plugin-indexeddb';
-import { StoreModule } from '@quereus/store';
+import { createIsolatedStoreModule } from '@quereus/store';
 
 const db = new Database();
 const provider = createIndexedDBProvider({ prefix: 'myapp' });
-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`);

package/dist/src/plugin.d.ts

@@ -20,6 +20,12 @@ export interface IndexedDBPluginConfig {
      * @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 IndexedDB plugin with a database.
@@ -27,7 +33,7 @@ export interface IndexedDBPluginConfig {
 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,qBAAqB;IACpC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;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;;;;;EAmBtC"}
+{"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,qBAAqB;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;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;;;;;EAsBrC"}

package/dist/src/plugin.js

@@ -3,7 +3,7 @@
  *
  * Registers a StoreModule backed by IndexedDB for browser environments.
  */
-import { StoreModule } from '@quereus/store';
+import { StoreModule, createIsolatedStoreModule } from '@quereus/store';
 import { IndexedDBProvider } from './provider.js';
 /**
  * Register the IndexedDB plugin with a database.
@@ -11,10 +11,13 @@ import { IndexedDBProvider } from './provider.js';
 export default function register(_db, config = {}) {
     const databaseName = config.databaseName ?? 'quereus';
     const moduleName = config.moduleName ?? 'store';
+    const isolation = config.isolation ?? true;
     const provider = new IndexedDBProvider({
         databaseName,
     });
-    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,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAoBlD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,GAAa,EACb,SAAmC,EAAE;IAErC,MAAM,YAAY,GAAI,MAAM,CAAC,YAAuB,IAAI,SAAS,CAAC;IAClE,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAE5D,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;QACrC,YAAY;KACb,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,iBAAiB,EAAE,MAAM,eAAe,CAAC;AA2BlD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAa,EACb,SAAmC,EAAE;IAErC,MAAM,YAAY,GAAI,MAAM,CAAC,YAAuB,IAAI,SAAS,CAAC;IAClE,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAC5D,MAAM,SAAS,GAAI,MAAM,CAAC,SAAqB,IAAI,IAAI,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;QACtC,YAAY;KACZ,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-indexeddb",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "type": "module",
   "description": "IndexedDB storage plugin for Quereus - browser persistent storage",
   "keywords": [
@@ -38,8 +38,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"
@@ -64,6 +65,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)"
       }
     ]
   },
@@ -74,6 +82,7 @@
     "test": "cd ../.. && node --import ./packages/quereus-plugin-indexeddb/register.mjs node_modules/mocha/bin/mocha.js \"packages/quereus-plugin-indexeddb/test/**/*.spec.ts\" --colors"
   },
   "devDependencies": {
+    "@quereus/isolation": "*",
     "@quereus/quereus": "*",
     "@quereus/store": "*",
     "@types/chai": "^5.2.2",