@quereus/plugin-nativescript-sqlite 0.3.1 → 0.4.1

package/README.md

@@ -5,6 +5,7 @@ SQLite storage plugin for Quereus on NativeScript. Provides persistent storage f
 ## Features
 
 - **Native SQLite**: Uses the device's built-in SQLite via `@nativescript-community/sqlite`
+- **Transaction isolation**: Read-your-own-writes and snapshot isolation by default
 - **Order-preserving keys**: BLOB keys with `memcmp()` comparison ensure correct lexicographic byte ordering
 - **Single database file**: All stores share one SQLite database (separate tables)
 - **ACID transactions**: SQLite transactions for atomic batch writes
@@ -13,7 +14,7 @@ SQLite storage plugin for Quereus on NativeScript. Provides persistent storage f
 ## Installation
 
 ```bash
-npm install @quereus/plugin-nativescript-sqlite @quereus/store @nativescript-community/sqlite
+npm install @quereus/plugin-nativescript-sqlite @quereus/store @quereus/isolation @nativescript-community/sqlite
 ```
 
 Or with NativeScript CLI:
@@ -41,13 +42,26 @@ await registerPlugin(db, sqlitePlugin, { db: sqliteDb });
 
 // Create tables using the 'store' module
 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
 `);
 
-// Use standard SQL
+// Full transaction isolation enabled by default
+await db.exec('BEGIN');
 await db.exec(`insert into users values (1, 'Alice')`);
-const users = await db.all(`select * from users`);
+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, sqlitePlugin, { 
+	db: sqliteDb,
+	isolation: false  // Disable isolation layer
+});
 ```
 
 ### Direct Usage with Provider
@@ -56,7 +70,8 @@ const users = await db.all(`select * from users`);
 import { openOrCreate } from '@nativescript-community/sqlite';
 import { Database } from '@quereus/quereus';
 import { createSQLiteProvider } from '@quereus/plugin-nativescript-sqlite';
-import { StoreModule } from '@quereus/store';
+import { createIsolatedStoreModule } from '@quereus/store';
+
 
 const sqliteDb = openOrCreate('quereus.db');
 const provider = createSQLiteProvider({ db: sqliteDb });

package/dist/src/plugin.d.ts

@@ -25,6 +25,12 @@ export interface SQLitePluginConfig {
      * @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 NativeScript SQLite plugin with a database.
@@ -48,7 +54,7 @@ export interface SQLitePluginConfig {
 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;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,EAAE,EAAE,cAAc,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;;;;;EA6BtC"}
+{"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;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;OAGG;IACH,EAAE,EAAE,cAAc,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;;;;;EAgCrC"}

package/dist/src/plugin.js

@@ -3,7 +3,7 @@
  *
  * Registers a StoreModule backed by SQLite for NativeScript mobile environments.
  */
-import { StoreModule } from '@quereus/store';
+import { StoreModule, createIsolatedStoreModule } from '@quereus/store';
 import { SQLiteProvider } from './provider.js';
 /**
  * Register the NativeScript SQLite plugin with a database.
@@ -33,11 +33,14 @@ export default function register(_db, config = {}) {
     }
     const tablePrefix = config.tablePrefix ?? 'quereus_';
     const moduleName = config.moduleName ?? 'store';
+    const isolation = config.isolation ?? true;
     const provider = new SQLiteProvider({
         db: sqliteDb,
         tablePrefix,
     });
-    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,cAAc,EAAE,MAAM,eAAe,CAAC;AA0B/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC9B,GAAa,EACb,SAAmC,EAAE;IAErC,uCAAuC;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAA+B,CAAC;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,2FAA2F;YAC3F,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAI,MAAM,CAAC,WAAsB,IAAI,UAAU,CAAC;IACjE,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAE5D,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QAClC,EAAE,EAAE,QAAQ;QACZ,WAAW;KACZ,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,cAAc,EAAE,MAAM,eAAe,CAAC;AAiC/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAa,EACb,SAAmC,EAAE;IAErC,uCAAuC;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAA+B,CAAC;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,2FAA2F;YAC3F,uEAAuE,CACvE,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAI,MAAM,CAAC,WAAsB,IAAI,UAAU,CAAC;IACjE,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAC5D,MAAM,SAAS,GAAI,MAAM,CAAC,SAAqB,IAAI,IAAI,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QACnC,EAAE,EAAE,QAAQ;QACZ,WAAW;KACX,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-nativescript-sqlite",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "type": "module",
   "description": "NativeScript SQLite storage plugin for Quereus - mobile persistent storage",
   "keywords": [
@@ -42,8 +42,9 @@
   },
   "peerDependencies": {
     "@nativescript-community/sqlite": "^3.0.0",
-    "@quereus/quereus": "^0.12.1",
-    "@quereus/store": "^0.5.1"
+    "@quereus/isolation": "^0.2.1",
+    "@quereus/quereus": "^0.14.0",
+    "@quereus/store": "^0.6.1"
   },
   "engines": {
     "quereus": "^0.24.0"
@@ -68,6 +69,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)"
       }
     ]
   },
@@ -78,17 +86,18 @@
     "test": "cd ../.. && node --import ./packages/quereus-plugin-nativescript-sqlite/register.mjs node_modules/mocha/bin/mocha.js \"packages/quereus-plugin-nativescript-sqlite/test/**/*.spec.ts\" --colors"
   },
   "devDependencies": {
+    "@quereus/isolation": "*",
     "@quereus/quereus": "*",
     "@quereus/store": "*",
     "@types/better-sqlite3": "^7.6.13",
     "@types/chai": "^5.2.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.15.29",
-    "better-sqlite3": "^12.5.0",
+    "@types/node": "^25.0.9",
+    "better-sqlite3": "^12.6.0",
     "chai": "^6.2.2",
     "mocha": "^11.7.5",
     "rimraf": "^6.1.2",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }