@quereus/plugin-nativescript-sqlite 4.3.1 → 4.3.2

package/README.md

@@ -1,195 +1,195 @@
-# @quereus/plugin-nativescript-sqlite
-
-SQLite storage plugin for Quereus on NativeScript. Provides persistent storage for iOS and Android mobile apps using the [`@quereus/store`](../quereus-store/) module.
-
-## 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
-- **WITHOUT ROWID**: Optimized key-value table structure
-
-## Installation
-
-```bash
-npm install @quereus/plugin-nativescript-sqlite @quereus/store @quereus/isolation @nativescript-community/sqlite
-```
-
-Or with NativeScript CLI:
-
-```bash
-ns plugin add @quereus/plugin-nativescript-sqlite
-ns plugin add @nativescript-community/sqlite
-```
-
-## Quick Start
-
-### With registerPlugin (Recommended)
-
-```typescript
-import { openOrCreate } from '@nativescript-community/sqlite';
-import { Database, registerPlugin } from '@quereus/quereus';
-import sqlitePlugin from '@quereus/plugin-nativescript-sqlite/plugin';
-
-// Open or create the SQLite database
-const sqliteDb = openOrCreate('quereus.db');
-
-// Create Quereus database and register the plugin
-const db = new Database();
-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
-`);
-
-// 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, sqlitePlugin, { 
-	db: sqliteDb,
-	isolation: false  // Disable isolation layer
-});
-```
-
-### Direct Usage with Provider
-
-```typescript
-import { openOrCreate } from '@nativescript-community/sqlite';
-import { Database } from '@quereus/quereus';
-import { createSQLiteProvider } from '@quereus/plugin-nativescript-sqlite';
-import { createIsolatedStoreModule } from '@quereus/store';
-
-
-const sqliteDb = openOrCreate('quereus.db');
-const provider = createSQLiteProvider({ db: sqliteDb });
-const storeModule = new StoreModule(provider);
-
-const db = new Database();
-db.registerModule('store', storeModule);
-
-await db.exec(`
-  create table users (id integer primary key, name text)
-  using store
-`);
-```
-
-## API
-
-### SQLiteStore
-
-Low-level KVStore implementation backed by a SQLite table:
-
-```typescript
-import { openOrCreate } from '@nativescript-community/sqlite';
-import { SQLiteStore } from '@quereus/plugin-nativescript-sqlite';
-
-const sqliteDb = openOrCreate('myapp.db');
-const store = SQLiteStore.create(sqliteDb, 'my_kv_table');
-
-// Key-value operations (keys and values are Uint8Array)
-await store.put(key, value);
-const data = await store.get(key);
-await store.delete(key);
-
-// Range iteration
-for await (const { key, value } of store.iterate({ gte: startKey, lt: endKey })) {
-  console.log(key, value);
-}
-
-// Batch writes (atomic)
-const batch = store.batch();
-batch.put(key1, value1);
-batch.put(key2, value2);
-batch.delete(key3);
-await batch.write();
-
-await store.close();
-```
-
-### SQLiteProvider
-
-Factory for managing multiple stores in a single SQLite database:
-
-```typescript
-import { openOrCreate } from '@nativescript-community/sqlite';
-import { createSQLiteProvider } from '@quereus/plugin-nativescript-sqlite';
-
-const sqliteDb = openOrCreate('quereus.db');
-const provider = createSQLiteProvider({ db: sqliteDb });
-
-// Each store gets its own table: quereus_main_users, quereus_main_orders, etc.
-const userStore = await provider.getStore('main', 'users');
-const orderStore = await provider.getStore('main', 'orders');
-const catalogStore = await provider.getCatalogStore();
-
-await provider.closeStore('main', 'users');
-await provider.closeAll();  // Also closes the SQLite database
-```
-
-## Configuration
-
-### Plugin Settings
-
-| Setting | Type | Default | Description |
-|---------|------|---------|-------------|
-| `db` | SQLiteDatabase | **required** | SQLite database from `openOrCreate()` |
-| `tablePrefix` | string | `'quereus_'` | Prefix for all table names |
-| `moduleName` | string | `'store'` | Virtual table module name for `USING` clause |
-
-### SQLiteStore Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `db` | SQLiteDatabase | **required** | The SQLite database instance |
-| `tableName` | string | `'kv'` | Table name for this store |
-
-## How It Works
-
-### Key Storage
-
-Keys and values are stored as BLOBs (binary). SQLite compares BLOBs using `memcmp()`, which provides correct lexicographic byte ordering - exactly what's needed for range scans.
-
-### Table Structure
-
-Each store creates a table with this schema:
-
-```sql
-create table quereus_main_users (
-  key blob primary key,
-  value blob
-) without rowid
-```
-
-The `WITHOUT ROWID` optimization is ideal for key-value workloads where the key is the primary lookup.
-
-## Platform Support
-
-| Platform | Status |
-|----------|--------|
-| iOS | ✅ Supported |
-| Android | ✅ Supported |
-| NativeScript 8+ | ✅ Supported |
-
-## Related Packages
-
-- [`@quereus/store`](../quereus-store/) - Core storage module (StoreModule, StoreTable)
-- [`@quereus/plugin-leveldb`](../quereus-plugin-leveldb/) - LevelDB plugin for Node.js
-- [`@quereus/plugin-indexeddb`](../quereus-plugin-indexeddb/) - IndexedDB plugin for browsers
-
-## License
-
-MIT
-
+# @quereus/plugin-nativescript-sqlite
+
+SQLite storage plugin for Quereus on NativeScript. Provides persistent storage for iOS and Android mobile apps using the [`@quereus/store`](../quereus-store/) module.
+
+## Features
+
+- **Native SQLite**: Uses the device's built-in SQLite via `@nativescript-community/sqlite`
+- **Transaction isolation**: Read-committed + read-your-own-writes by default (no write-write conflict detection; not snapshot isolation)
+- **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
+- **WITHOUT ROWID**: Optimized key-value table structure
+
+## Installation
+
+```bash
+npm install @quereus/plugin-nativescript-sqlite @quereus/store @quereus/isolation @nativescript-community/sqlite
+```
+
+Or with NativeScript CLI:
+
+```bash
+ns plugin add @quereus/plugin-nativescript-sqlite
+ns plugin add @nativescript-community/sqlite
+```
+
+## Quick Start
+
+### With registerPlugin (Recommended)
+
+```typescript
+import { openOrCreate } from '@nativescript-community/sqlite';
+import { Database, registerPlugin } from '@quereus/quereus';
+import sqlitePlugin from '@quereus/plugin-nativescript-sqlite/plugin';
+
+// Open or create the SQLite database
+const sqliteDb = openOrCreate('quereus.db');
+
+// Create Quereus database and register the plugin
+const db = new Database();
+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
+`);
+
+// 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, sqlitePlugin, { 
+	db: sqliteDb,
+	isolation: false  // Disable isolation layer
+});
+```
+
+### Direct Usage with Provider
+
+```typescript
+import { openOrCreate } from '@nativescript-community/sqlite';
+import { Database } from '@quereus/quereus';
+import { createSQLiteProvider } from '@quereus/plugin-nativescript-sqlite';
+import { createIsolatedStoreModule } from '@quereus/store';
+
+
+const sqliteDb = openOrCreate('quereus.db');
+const provider = createSQLiteProvider({ db: sqliteDb });
+const storeModule = new StoreModule(provider);
+
+const db = new Database();
+db.registerModule('store', storeModule);
+
+await db.exec(`
+  create table users (id integer primary key, name text)
+  using store
+`);
+```
+
+## API
+
+### SQLiteStore
+
+Low-level KVStore implementation backed by a SQLite table:
+
+```typescript
+import { openOrCreate } from '@nativescript-community/sqlite';
+import { SQLiteStore } from '@quereus/plugin-nativescript-sqlite';
+
+const sqliteDb = openOrCreate('myapp.db');
+const store = SQLiteStore.create(sqliteDb, 'my_kv_table');
+
+// Key-value operations (keys and values are Uint8Array)
+await store.put(key, value);
+const data = await store.get(key);
+await store.delete(key);
+
+// Range iteration
+for await (const { key, value } of store.iterate({ gte: startKey, lt: endKey })) {
+  console.log(key, value);
+}
+
+// Batch writes (atomic)
+const batch = store.batch();
+batch.put(key1, value1);
+batch.put(key2, value2);
+batch.delete(key3);
+await batch.write();
+
+await store.close();
+```
+
+### SQLiteProvider
+
+Factory for managing multiple stores in a single SQLite database:
+
+```typescript
+import { openOrCreate } from '@nativescript-community/sqlite';
+import { createSQLiteProvider } from '@quereus/plugin-nativescript-sqlite';
+
+const sqliteDb = openOrCreate('quereus.db');
+const provider = createSQLiteProvider({ db: sqliteDb });
+
+// Each store gets its own table: quereus_main_users, quereus_main_orders, etc.
+const userStore = await provider.getStore('main', 'users');
+const orderStore = await provider.getStore('main', 'orders');
+const catalogStore = await provider.getCatalogStore();
+
+await provider.closeStore('main', 'users');
+await provider.closeAll();  // Also closes the SQLite database
+```
+
+## Configuration
+
+### Plugin Settings
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| `db` | SQLiteDatabase | **required** | SQLite database from `openOrCreate()` |
+| `tablePrefix` | string | `'quereus_'` | Prefix for all table names |
+| `moduleName` | string | `'store'` | Virtual table module name for `USING` clause |
+
+### SQLiteStore Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `db` | SQLiteDatabase | **required** | The SQLite database instance |
+| `tableName` | string | `'kv'` | Table name for this store |
+
+## How It Works
+
+### Key Storage
+
+Keys and values are stored as BLOBs (binary). SQLite compares BLOBs using `memcmp()`, which provides correct lexicographic byte ordering - exactly what's needed for range scans.
+
+### Table Structure
+
+Each store creates a table with this schema:
+
+```sql
+create table quereus_main_users (
+  key blob primary key,
+  value blob
+) without rowid
+```
+
+The `WITHOUT ROWID` optimization is ideal for key-value workloads where the key is the primary lookup.
+
+## Platform Support
+
+| Platform | Status |
+|----------|--------|
+| iOS | ✅ Supported |
+| Android | ✅ Supported |
+| NativeScript 8+ | ✅ Supported |
+
+## Related Packages
+
+- [`@quereus/store`](../quereus-store/) - Core storage module (StoreModule, StoreTable)
+- [`@quereus/plugin-leveldb`](../quereus-plugin-leveldb/) - LevelDB plugin for Node.js
+- [`@quereus/plugin-indexeddb`](../quereus-plugin-indexeddb/) - IndexedDB plugin for browsers
+
+## License
+
+MIT
+

package/dist/src/plugin.d.ts

@@ -26,7 +26,8 @@ export interface SQLitePluginConfig {
      */
     moduleName?: string;
     /**
-     * Enable transaction isolation (read-your-own-writes, snapshot isolation).
+     * Enable transaction isolation (read-committed + read-your-own-writes, no
+     * write-write conflict detection — NOT snapshot isolation).
      * When true, wraps the store module with an isolation layer.
      * @default true
      */

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,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"}
+{"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;;;;;OAKG;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.map

@@ -1 +1 @@
-{"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"}
+{"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;AAkC/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/dist/src/store.js

@@ -39,11 +39,11 @@ export class SQLiteStore {
     ensureTable() {
         // Use WITHOUT ROWID for better key-value performance
         // Keys are BLOBs - SQLite uses memcmp() for correct byte ordering
-        this.db.execute(`
-      create table if not exists ${this.tableName} (
-        key blob primary key,
-        value blob
-      ) without rowid
+        this.db.execute(`
+      create table if not exists ${this.tableName} (
+        key blob primary key,
+        value blob
+      ) without rowid
     `);
     }
     async get(key) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quereus/plugin-nativescript-sqlite",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "type": "module",
   "description": "NativeScript SQLite storage plugin for Quereus - mobile persistent storage",
   "keywords": [
@@ -42,9 +42,9 @@
   },
   "peerDependencies": {
     "@nativescript-community/sqlite": "^3.0.0",
-    "@quereus/isolation": "^4.3.1",
-    "@quereus/quereus": "^4.3.1",
-    "@quereus/store": "^4.3.1"
+    "@quereus/isolation": "^4.3.2",
+    "@quereus/quereus": "^4.3.2",
+    "@quereus/store": "^4.3.2"
   },
   "engines": {
     "quereus": "^0.24.0"
@@ -82,12 +82,13 @@
   "scripts": {
     "clean": "rimraf dist",
     "build": "tsc",
+    "lint": "echo 'No lint configured'",
     "typecheck": "tsc --noEmit",
     "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\" --reporter min --colors"
   },
   "dependencies": {
-    "@quereus/quereus": "^4.3.1",
-    "@quereus/store": "^4.3.1"
+    "@quereus/quereus": "^4.3.2",
+    "@quereus/store": "^4.3.2"
   },
   "devDependencies": {
     "@quereus/isolation": "*",