@optimystic/db-p2p-storage-ns 0.14.1 → 0.16.3

package/README.md

@@ -3,9 +3,12 @@
 SQLite-backed storage backend for Optimystic NativeScript peers (iOS and
 Android, native — not React Native). Provides:
 
-- **`SqliteRawStorage`** — implements `IRawStorage` so a NativeScript node
-  persists block metadata, revisions, pending transactions, committed
-  transactions, and materialized blocks across app restarts.
+- **`SqliteRawStorage`** — the `IRawStorage` a NativeScript node uses to
+  persist block metadata, revisions, pending transactions, committed
+  transactions, and materialized blocks across app restarts. It is a thin
+  shell over the shared `KvRawStorage` kernel driven by `SqliteStoreDriver`:
+  the kernel owns all JSON serialization, the driver maps the five logical
+  stores onto the five SQLite tables.
 - **`SqliteKVStore`** — implements `IKVStore` for the persistent transaction
   state used to recover crashed two-phase commits.
 - **`loadOrCreateNSPeerKey`** — generates an Ed25519 libp2p private key on
@@ -61,23 +64,34 @@ const libp2p = await createLibp2pNode({
 });
 ```
 
-The same handle is shared by all three consumers. SQLite serializes writes
-inside a single connection; reads/writes are short-lived enough that
-single-connection contention is a non-issue for a client peer.
+The same handle is shared by all three consumers. SQLite allows at most one
+open transaction per connection, so the wrapper serializes every mutating
+operation — `exec`, statement `run`, and whole `transaction` bodies — on a
+per-connection FIFO mutex. Without it, two concurrent `transaction` bodies
+would each `BEGIN` on the shared connection; the second nests, throws, and its
+rollback discards the first's still-open writes. Reads (`get`/`all`) stay off
+the mutex to preserve read concurrency.
 
 ## Persistence model
 
 The package opens a single SQLite database (`optimystic.sqlite` by default
-in the NativeScript app's documents directory) with six tables:
-
-| Table          | Key                              | Value                            |
-|----------------|----------------------------------|----------------------------------|
-| `metadata`     | `block_id`                       | `BlockMetadata` (JSON)           |
-| `revisions`    | `(block_id, rev)`                | `action_id`                      |
-| `pending`      | `(block_id, action_id)`          | `Transform` (JSON)               |
-| `transactions` | `(block_id, action_id)`          | `Transform` (JSON)               |
-| `materialized` | `(block_id, action_id)`          | `IBlock` (JSON)                  |
-| `kv`           | `key`                            | `s_val` (TEXT) or `b_val` (BLOB) |
+in the NativeScript app's documents directory) with six tables. The five
+block-storage tables keep their original columns and keys, but their value
+columns are now **BLOB**: `SqliteStoreDriver` binds/reads the kernel's raw
+`Uint8Array` bytes and the shared `KvRawStorage` kernel owns the JSON/UTF-8
+codec. SQLite stores a `Uint8Array` as a BLOB and returns it as a `Uint8Array`,
+so bytes round-trip exactly (a TEXT column would risk UTF-8-coercing non-ASCII
+JSON bytes). The "Decoded" column is the logical type the kernel decodes back
+into; keys stay TEXT/INTEGER.
+
+| Table          | Key                              | Stored value | Decoded (logical) type |
+|----------------|----------------------------------|--------------|------------------------|
+| `metadata`     | `block_id`                       | `BLOB`       | `BlockMetadata`        |
+| `revisions`    | `(block_id, rev)`                | `BLOB` (`action_id` col) | `ActionId`     |
+| `pending`      | `(block_id, action_id)`          | `BLOB`       | `Transform`            |
+| `transactions` | `(block_id, action_id)`          | `BLOB`       | `Transform`            |
+| `materialized` | `(block_id, action_id)`          | `BLOB`       | `IBlock`               |
+| `kv`           | `key`                            | `s_val` (TEXT) or `b_val` (BLOB) | — (not kernel-backed) |
 
 Pragmas: `journal_mode = WAL`, `synchronous = NORMAL`, `foreign_keys = OFF`.
 Schema is versioned via `PRAGMA user_version`.

package/dist/src/connection-mutex.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Per-connection FIFO mutex for the shared SQLite handle.
+ *
+ * SQLite allows at most one open transaction per connection, so every mutating
+ * operation on a shared connection (plain writes AND transaction bodies) must be
+ * serialized or a concurrent `BEGIN` will nest and cross-rollback another
+ * operation's still-open writes.
+ *
+ * This is deliberately NOT the global `Latches` keyed map from
+ * `@optimystic/db-core` — that is process-wide and keyed by string. Here we want
+ * one mutex bound to one connection instance, so the wrapper holds its own.
+ *
+ * The chain tail is kept non-rejecting: a failing task must not poison the queue
+ * for the operations behind it, so `serialize` continues the chain regardless of
+ * the prior task's outcome while still surfacing each task's own result/error to
+ * its own caller.
+ */
+export declare class ConnectionMutex {
+    private tail;
+    /**
+     * Queue `task` behind all previously-queued tasks and run it once they settle.
+     * Resolves/rejects with `task`'s own outcome; never rejects the shared tail.
+     */
+    serialize<T>(task: () => Promise<T> | T): Promise<T>;
+}
+//# sourceMappingURL=connection-mutex.d.ts.map

package/dist/src/connection-mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-mutex.d.ts","sourceRoot":"","sources":["../../src/connection-mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,IAAI,CAAuC;IAEnD;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQpD"}

package/dist/src/connection-mutex.js

@@ -0,0 +1,33 @@
+/**
+ * Per-connection FIFO mutex for the shared SQLite handle.
+ *
+ * SQLite allows at most one open transaction per connection, so every mutating
+ * operation on a shared connection (plain writes AND transaction bodies) must be
+ * serialized or a concurrent `BEGIN` will nest and cross-rollback another
+ * operation's still-open writes.
+ *
+ * This is deliberately NOT the global `Latches` keyed map from
+ * `@optimystic/db-core` — that is process-wide and keyed by string. Here we want
+ * one mutex bound to one connection instance, so the wrapper holds its own.
+ *
+ * The chain tail is kept non-rejecting: a failing task must not poison the queue
+ * for the operations behind it, so `serialize` continues the chain regardless of
+ * the prior task's outcome while still surfacing each task's own result/error to
+ * its own caller.
+ */
+export class ConnectionMutex {
+    tail = Promise.resolve();
+    /**
+     * Queue `task` behind all previously-queued tasks and run it once they settle.
+     * Resolves/rejects with `task`'s own outcome; never rejects the shared tail.
+     */
+    serialize(task) {
+        // Run `task` whether the prior task fulfilled or rejected.
+        const run = this.tail.then(task, task);
+        // Advance the tail with a settled-either-way promise so a rejection here
+        // does not reject the next task's `.then(task, task)` prematurely.
+        this.tail = run.then(() => undefined, () => undefined);
+        return run;
+    }
+}
+//# sourceMappingURL=connection-mutex.js.map

package/dist/src/connection-mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-mutex.js","sourceRoot":"","sources":["../../src/connection-mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAe;IACnB,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnD;;;OAGG;IACH,SAAS,CAAI,IAA0B;QACtC,2DAA2D;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,yEAAyE;QACzE,mEAAmE;QACnE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC;IACZ,CAAC;CACD"}

package/dist/src/db.d.ts

@@ -19,7 +19,7 @@ export type SqliteRow = Record<string, SqliteParam>;
  *
  * Both `node:sqlite` and `@nativescript-community/sqlite` cache parsed SQL
  * internally, so re-binding a prepared statement is cheaper than re-parsing a
- * raw `execSQL`. The storage classes prepare each query once per instance.
+ * raw `execute`. The storage classes prepare each query once per instance.
  */
 export interface SqliteStatement {
     /** Execute with the given bind parameters, ignoring any returned rows. */
@@ -29,20 +29,50 @@ export interface SqliteStatement {
     /** Execute and return all rows (already drained — safe to await between yields). */
     all(...params: SqliteParam[]): Promise<SqliteRow[]>;
 }
+/**
+ * Statements that execute directly on an already-OPEN transaction.
+ *
+ * Handed to the `transaction(fn)` callback. Its prepared statements run on the
+ * raw connection *inside* the mutex slot the transaction already holds, so they
+ * must NOT re-acquire the connection mutex — doing so would deadlock (the
+ * transaction body holds the only slot). This is the explicit-context seam the
+ * fix threads through instead of a shared `inTransaction` flag, which cannot
+ * tell an inner statement (bypass the lock) from a concurrent external write
+ * (block on it).
+ */
+export interface SqliteTransaction {
+    /** Prepare a statement bound to the open transaction; bypasses the mutex. */
+    prepare(sql: string): SqliteStatement;
+}
 /**
  * Minimal SQLite driver surface used by this package.
  *
  * Wraps either the NativeScript plugin (in production) or a Node SQLite
  * driver (in tests). Async on every method so the NS plugin's I/O can be
  * Promised — even where the underlying call is synchronous.
+ *
+ * A single connection is shared across the storage classes, so every mutating
+ * operation (`exec`, statement `run`, and `transaction` bodies) is serialized on
+ * a per-connection FIFO mutex. Reads (`get`/`all`) are intentionally left
+ * unserialized to preserve read concurrency.
  */
 export interface SqliteDb {
-    /** Execute one or more semicolon-separated statements; no result rows. */
+    /** Execute one or more semicolon-separated statements; no result rows. Mutex-guarded. */
     exec(sql: string): Promise<void>;
-    /** Prepare a parameterized statement for repeated execution. */
+    /** Prepare a parameterized statement for repeated execution (writes are mutex-guarded). */
     prepare(sql: string): SqliteStatement;
-    /** Run `fn` inside `BEGIN ... COMMIT` (rolls back on throw). */
-    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Run `fn` inside `BEGIN IMMEDIATE ... COMMIT` (rolls back on throw), holding
+     * the connection mutex for the whole body. `fn` receives a `SqliteTransaction`
+     * whose statements run directly on the open transaction without re-locking.
+     *
+     * NOTE: `fn` must issue its writes through the provided `tx`, never through a
+     * class-level statement from `db.prepare(...)` (those re-acquire the mutex and
+     * deadlock behind the slot this transaction holds), and must not call
+     * `db.transaction(...)` again — nested calls deadlock for the same reason. No
+     * current caller does either; guard here if that ever changes.
+     */
+    transaction<T>(fn: (tx: SqliteTransaction) => Promise<T>): Promise<T>;
     /** Release the underlying handle. */
     close(): Promise<void>;
 }
@@ -51,17 +81,33 @@ export declare const DEFAULT_DB_VERSION = 1;
 /**
  * Schema for the NativeScript storage backend.
  *
- * Mirrors the IndexedDB object stores 1:1:
- * - `metadata` → per-block `BlockMetadata` (JSON).
- * - `revisions` → revision lookup keyed by `(block_id, rev)`.
- * - `pending` → uncommitted transforms keyed by `(block_id, action_id)`.
- * - `transactions` → committed transforms keyed by `(block_id, action_id)`.
- * - `materialized` → materialized blocks keyed by `(block_id, action_id)`.
+ * Mirrors the IndexedDB object stores 1:1. The five block-storage stores keep
+ * their original columns and keys, but their value columns are now BLOB: the
+ * shared `KvRawStorage` kernel (driven by `SqliteStoreDriver`) owns all JSON /
+ * UTF-8 (de)serialization, so the driver only ever binds/reads the kernel's raw
+ * `Uint8Array` values. SQLite stores a `Uint8Array` as a BLOB and returns it as
+ * a `Uint8Array`, so bytes round-trip exactly (a TEXT column would risk UTF-8
+ * coercion corrupting non-ASCII JSON bytes). Keys stay TEXT/INTEGER.
+ * - `metadata` → per-block `BlockMetadata` bytes keyed by `block_id`.
+ * - `revisions` → revision lookup keyed by `(block_id, rev)`; `action_id` column
+ *   holds the kernel's encoded `ActionId` bytes (BLOB).
+ * - `pending` → uncommitted transform bytes keyed by `(block_id, action_id)`.
+ * - `transactions` → committed transform bytes keyed by `(block_id, action_id)`.
+ * - `materialized` → materialized block bytes keyed by `(block_id, action_id)`.
  * - `kv` → generic string keyspace shared by `IKVStore` (`s_val`) and the
- *   identity helper (`b_val`). The two columns avoid a base64 round-trip
- *   for the libp2p private key.
+ *   identity helper (`b_val`). NOT kernel-backed; unchanged. The two columns
+ *   avoid a base64 round-trip for the libp2p private key.
+ *
+ * NOTE: value columns changed TEXT→BLOB with the kernel refactor, but every
+ * statement is `CREATE TABLE IF NOT EXISTS` — so a database file created by a
+ * pre-refactor build keeps its old TEXT-column schema, and its rows hold JSON
+ * *strings* the kernel now reads back and `TextDecoder.decode`s (garbling /
+ * throwing). There is no migration. Safe today because this backend is
+ * NativeScript-only with no shipped production data; if a build ever ships to
+ * devices that later upgrade, add a `user_version` bump that drops+recreates
+ * these five tables (or a real migration) before assuming BLOB rows.
  */
-export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS metadata (\n\tblock_id TEXT PRIMARY KEY,\n\tvalue    TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS revisions (\n\tblock_id  TEXT    NOT NULL,\n\trev       INTEGER NOT NULL,\n\taction_id TEXT    NOT NULL,\n\tPRIMARY KEY (block_id, rev)\n);\n\nCREATE TABLE IF NOT EXISTS pending (\n\tblock_id  TEXT NOT NULL,\n\taction_id TEXT NOT NULL,\n\tvalue     TEXT NOT NULL,\n\tPRIMARY KEY (block_id, action_id)\n);\n\nCREATE TABLE IF NOT EXISTS transactions (\n\tblock_id  TEXT NOT NULL,\n\taction_id TEXT NOT NULL,\n\tvalue     TEXT NOT NULL,\n\tPRIMARY KEY (block_id, action_id)\n);\n\nCREATE TABLE IF NOT EXISTS materialized (\n\tblock_id  TEXT NOT NULL,\n\taction_id TEXT NOT NULL,\n\tvalue     TEXT NOT NULL,\n\tPRIMARY KEY (block_id, action_id)\n);\n\nCREATE TABLE IF NOT EXISTS kv (\n\tkey    TEXT PRIMARY KEY,\n\ts_val  TEXT,\n\tb_val  BLOB\n);\n";
+export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS metadata (\n\tblock_id TEXT PRIMARY KEY,\n\tvalue    BLOB NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS revisions (\n\tblock_id  TEXT    NOT NULL,\n\trev       INTEGER NOT NULL,\n\taction_id BLOB    NOT NULL,\n\tPRIMARY KEY (block_id, rev)\n);\n\nCREATE TABLE IF NOT EXISTS pending (\n\tblock_id  TEXT NOT NULL,\n\taction_id TEXT NOT NULL,\n\tvalue     BLOB NOT NULL,\n\tPRIMARY KEY (block_id, action_id)\n);\n\nCREATE TABLE IF NOT EXISTS transactions (\n\tblock_id  TEXT NOT NULL,\n\taction_id TEXT NOT NULL,\n\tvalue     BLOB NOT NULL,\n\tPRIMARY KEY (block_id, action_id)\n);\n\nCREATE TABLE IF NOT EXISTS materialized (\n\tblock_id  TEXT NOT NULL,\n\taction_id TEXT NOT NULL,\n\tvalue     BLOB NOT NULL,\n\tPRIMARY KEY (block_id, action_id)\n);\n\nCREATE TABLE IF NOT EXISTS kv (\n\tkey    TEXT PRIMARY KEY,\n\ts_val  TEXT,\n\tb_val  BLOB\n);\n";
 /**
  * Apply pragmas, run the schema DDL, and stamp `user_version` so future
  * migrations can branch on it. Idempotent — safe to call on every open.

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

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AAE9D,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,0EAA0E;IAC1E,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,gEAAgE;IAChE,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC9D,oFAAoF;IACpF,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACpD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACxB,0EAA0E;IAC1E,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,gEAAgE;IAChE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,gEAAgE;IAChE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,qCAAqC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,+2BAuCtB,CAAC;AAQF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,MAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAInG;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AAE9D,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,0EAA0E;IAC1E,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,gEAAgE;IAChE,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC9D,oFAAoF;IACpF,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACpD;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IACjC,6EAA6E;IAC7E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,QAAQ;IACxB,yFAAyF;IACzF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,2FAA2F;IAC3F,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC;;;;;;;;;;OAUG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,qCAAqC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,UAAU,+2BAuCtB,CAAC;AAQF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,MAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnG;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC"}

package/dist/src/db.js

@@ -15,47 +15,63 @@ export const DEFAULT_DB_VERSION = 1;
 /**
  * Schema for the NativeScript storage backend.
  *
- * Mirrors the IndexedDB object stores 1:1:
- * - `metadata` → per-block `BlockMetadata` (JSON).
- * - `revisions` → revision lookup keyed by `(block_id, rev)`.
- * - `pending` → uncommitted transforms keyed by `(block_id, action_id)`.
- * - `transactions` → committed transforms keyed by `(block_id, action_id)`.
- * - `materialized` → materialized blocks keyed by `(block_id, action_id)`.
+ * Mirrors the IndexedDB object stores 1:1. The five block-storage stores keep
+ * their original columns and keys, but their value columns are now BLOB: the
+ * shared `KvRawStorage` kernel (driven by `SqliteStoreDriver`) owns all JSON /
+ * UTF-8 (de)serialization, so the driver only ever binds/reads the kernel's raw
+ * `Uint8Array` values. SQLite stores a `Uint8Array` as a BLOB and returns it as
+ * a `Uint8Array`, so bytes round-trip exactly (a TEXT column would risk UTF-8
+ * coercion corrupting non-ASCII JSON bytes). Keys stay TEXT/INTEGER.
+ * - `metadata` → per-block `BlockMetadata` bytes keyed by `block_id`.
+ * - `revisions` → revision lookup keyed by `(block_id, rev)`; `action_id` column
+ *   holds the kernel's encoded `ActionId` bytes (BLOB).
+ * - `pending` → uncommitted transform bytes keyed by `(block_id, action_id)`.
+ * - `transactions` → committed transform bytes keyed by `(block_id, action_id)`.
+ * - `materialized` → materialized block bytes keyed by `(block_id, action_id)`.
  * - `kv` → generic string keyspace shared by `IKVStore` (`s_val`) and the
- *   identity helper (`b_val`). The two columns avoid a base64 round-trip
- *   for the libp2p private key.
+ *   identity helper (`b_val`). NOT kernel-backed; unchanged. The two columns
+ *   avoid a base64 round-trip for the libp2p private key.
+ *
+ * NOTE: value columns changed TEXT→BLOB with the kernel refactor, but every
+ * statement is `CREATE TABLE IF NOT EXISTS` — so a database file created by a
+ * pre-refactor build keeps its old TEXT-column schema, and its rows hold JSON
+ * *strings* the kernel now reads back and `TextDecoder.decode`s (garbling /
+ * throwing). There is no migration. Safe today because this backend is
+ * NativeScript-only with no shipped production data; if a build ever ships to
+ * devices that later upgrade, add a `user_version` bump that drops+recreates
+ * these five tables (or a real migration) before assuming BLOB rows.
  */
 export const SCHEMA_SQL = `
 CREATE TABLE IF NOT EXISTS metadata (
 	block_id TEXT PRIMARY KEY,
-	value    TEXT NOT NULL
+	value    BLOB NOT NULL
 );
 
 CREATE TABLE IF NOT EXISTS revisions (
 	block_id  TEXT    NOT NULL,
 	rev       INTEGER NOT NULL,
-	action_id TEXT    NOT NULL,
+	action_id BLOB    NOT NULL,
 	PRIMARY KEY (block_id, rev)
 );
 
 CREATE TABLE IF NOT EXISTS pending (
 	block_id  TEXT NOT NULL,
 	action_id TEXT NOT NULL,
-	value     TEXT NOT NULL,
+	value     BLOB NOT NULL,
 	PRIMARY KEY (block_id, action_id)
 );
 
 CREATE TABLE IF NOT EXISTS transactions (
 	block_id  TEXT NOT NULL,
 	action_id TEXT NOT NULL,
-	value     TEXT NOT NULL,
+	value     BLOB NOT NULL,
 	PRIMARY KEY (block_id, action_id)
 );
 
 CREATE TABLE IF NOT EXISTS materialized (
 	block_id  TEXT NOT NULL,
 	action_id TEXT NOT NULL,
-	value     TEXT NOT NULL,
+	value     BLOB NOT NULL,
 	PRIMARY KEY (block_id, action_id)
 );
 
@@ -65,8 +81,8 @@ CREATE TABLE IF NOT EXISTS kv (
 	b_val  BLOB
 );
 `;
+// Assignment-form pragmas return no rows, so they go through exec()/execute().
 const PRAGMAS_SQL = `
-PRAGMA journal_mode = WAL;
 PRAGMA synchronous = NORMAL;
 PRAGMA foreign_keys = OFF;
 `;
@@ -75,6 +91,12 @@ PRAGMA foreign_keys = OFF;
  * migrations can branch on it. Idempotent — safe to call on every open.
  */
 export async function applySchema(db, version = DEFAULT_DB_VERSION) {
+    // `PRAGMA journal_mode = WAL` returns the resulting mode as a row. The NS
+    // Android plugin maps exec()→execSQL, which rejects row-returning statements
+    // ("Queries can be performed using ... query or rawQuery methods only"), so
+    // this pragma must run through a query method. prepare().get() does that on
+    // every driver (NS plugin → get()/rawQuery; node:sqlite/better-sqlite3 → get()).
+    await db.prepare('PRAGMA journal_mode = WAL').get();
     await db.exec(PRAGMAS_SQL);
     await db.exec(SCHEMA_SQL);
     await db.exec(`PRAGMA user_version = ${version}`);

package/dist/src/db.js.map

@@ -1 +1 @@
-{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA0CH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCzB,CAAC;AAEF,MAAM,WAAW,GAAG;;;;CAInB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAY,EAAE,UAAkB,kBAAkB;IACnF,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,IAAI,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAyEH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCzB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,GAAG;;;CAGnB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAY,EAAE,UAAkB,kBAAkB;IACnF,0EAA0E;IAC1E,6EAA6E;IAC7E,4EAA4E;IAC5E,4EAA4E;IAC5E,iFAAiF;IACjF,MAAM,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,GAAG,EAAE,CAAC;IACpD,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,IAAI,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
 export type { OptimysticNSDBHandle, SqliteDb, SqliteStatement, SqliteParam, SqliteRow } from './db.js';
 export { DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
 export { openOptimysticNSDb, wrapNSPluginDb } from './ns-opener.js';
-export { SqliteRawStorage } from './sqlite-storage.js';
+export { SqliteRawStorage, SqliteStoreDriver } from './sqlite-storage.js';
 export { SqliteKVStore } from './sqlite-kv-store.js';
 export { loadOrCreateNSPeerKey, DEFAULT_PEER_KEY_NAME } from './identity.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/index.js

@@ -1,6 +1,6 @@
 export { DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
 export { openOptimysticNSDb, wrapNSPluginDb } from './ns-opener.js';
-export { SqliteRawStorage } from './sqlite-storage.js';
+export { SqliteRawStorage, SqliteStoreDriver } from './sqlite-storage.js';
 export { SqliteKVStore } from './sqlite-kv-store.js';
 export { loadOrCreateNSPeerKey, DEFAULT_PEER_KEY_NAME } from './identity.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/ns-opener.d.ts

@@ -6,7 +6,7 @@ import { type OptimysticNSDBHandle, type SqliteDb } from './db.js';
  * at typecheck time on non-NativeScript consumers).
  */
 interface NSPluginDb {
-    execSQL(sql: string, params?: ReadonlyArray<unknown>): unknown;
+    execute(sql: string, params?: ReadonlyArray<unknown>): unknown;
     get(sql: string, params?: ReadonlyArray<unknown>): Promise<Record<string, unknown> | null | undefined> | Record<string, unknown> | null | undefined;
     select(sql: string, params?: ReadonlyArray<unknown>): Promise<Array<Record<string, unknown>>> | Array<Record<string, unknown>>;
     close(): void | Promise<void>;
@@ -17,9 +17,13 @@ interface NSPluginDb {
  * the migration to `version`.
  *
  * The returned `SqliteDb` handle is safe to share across `SqliteRawStorage`,
- * `SqliteKVStore`, and `loadOrCreateNSPeerKey` — SQLite serializes writes
- * inside the connection, and our reads/writes are short-lived enough that
- * single-connection contention is a non-issue for a client peer.
+ * `SqliteKVStore`, and `loadOrCreateNSPeerKey`. Because SQLite allows at most
+ * one open transaction per connection, the wrapper serializes every mutating
+ * operation — `exec`, statement `run`, and whole `transaction` bodies — through
+ * a per-connection FIFO mutex. Without it, two concurrent `transaction` bodies
+ * would each `BEGIN` on the shared connection; the second would nest and its
+ * rollback would silently discard the first's still-open writes. Reads
+ * (`get`/`all`) stay off the mutex to preserve read concurrency.
  *
  * `path` may be passed in as the full filesystem path if the caller wants
  * to control file placement; otherwise the plugin's documents-directory
@@ -31,6 +35,11 @@ export declare function openOptimysticNSDb(name?: string, version?: number): Pro
  * internal `SqliteDb` interface used by the storage classes. Exported only
  * for callers that already hold an open NS-plugin handle and want to skip
  * the opener (rare — typically users just call `openOptimysticNSDb`).
+ *
+ * NOTE: the serialization mutex lives on the wrapper, not the raw handle. Wrap
+ * a given raw connection exactly once — two wrappers over one handle each hold
+ * their own mutex and would not serialize against each other, reintroducing the
+ * cross-rollback this fix closes.
  */
 export declare function wrapNSPluginDb(raw: NSPluginDb): SqliteDb;
 export {};

package/dist/src/ns-opener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ns-opener.d.ts","sourceRoot":"","sources":["../../src/ns-opener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAA0D,MAAM,SAAS,CAAC;AAE7K;;;;;GAKG;AACH,UAAU,UAAU;IACnB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC/D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACpJ,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/H,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACvC,IAAI,GAAE,MAAwB,EAC9B,OAAO,GAAE,MAA2B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAM/B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CAExD"}
+{"version":3,"file":"ns-opener.d.ts","sourceRoot":"","sources":["../../src/ns-opener.ts"],"names":[],"mappings":"AACA,OAAO,EAAoD,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAkF,MAAM,SAAS,CAAC;AAErM;;;;;GAKG;AACH,UAAU,UAAU;IACnB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC/D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACpJ,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/H,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACvC,IAAI,GAAE,MAAwB,EAC9B,OAAO,GAAE,MAA2B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAM/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CAExD"}

package/dist/src/ns-opener.js

@@ -1,3 +1,4 @@
+import { ConnectionMutex } from './connection-mutex.js';
 import { applySchema, DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
 /**
  * Opens (creating if needed) the Optimystic SQLite database at `name` under
@@ -5,9 +6,13 @@ import { applySchema, DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
  * the migration to `version`.
  *
  * The returned `SqliteDb` handle is safe to share across `SqliteRawStorage`,
- * `SqliteKVStore`, and `loadOrCreateNSPeerKey` — SQLite serializes writes
- * inside the connection, and our reads/writes are short-lived enough that
- * single-connection contention is a non-issue for a client peer.
+ * `SqliteKVStore`, and `loadOrCreateNSPeerKey`. Because SQLite allows at most
+ * one open transaction per connection, the wrapper serializes every mutating
+ * operation — `exec`, statement `run`, and whole `transaction` bodies — through
+ * a per-connection FIFO mutex. Without it, two concurrent `transaction` bodies
+ * would each `BEGIN` on the shared connection; the second would nest and its
+ * rollback would silently discard the first's still-open writes. Reads
+ * (`get`/`all`) stay off the mutex to preserve read concurrency.
  *
  * `path` may be passed in as the full filesystem path if the caller wants
  * to control file placement; otherwise the plugin's documents-directory
@@ -25,45 +30,63 @@ export async function openOptimysticNSDb(name = DEFAULT_DB_NAME, version = DEFAU
  * internal `SqliteDb` interface used by the storage classes. Exported only
  * for callers that already hold an open NS-plugin handle and want to skip
  * the opener (rare — typically users just call `openOptimysticNSDb`).
+ *
+ * NOTE: the serialization mutex lives on the wrapper, not the raw handle. Wrap
+ * a given raw connection exactly once — two wrappers over one handle each hold
+ * their own mutex and would not serialize against each other, reintroducing the
+ * cross-rollback this fix closes.
  */
 export function wrapNSPluginDb(raw) {
     return new NSPluginDbWrapper(raw);
 }
 class NSPluginDbWrapper {
     raw;
+    mutex = new ConnectionMutex();
     constructor(raw) {
         this.raw = raw;
     }
     async exec(sql) {
-        // The plugin's execSQL accepts a single statement; split semicolon-
+        // The plugin's execute accepts a single statement; split semicolon-
         // separated DDL so callers can pass the full schema in one go.
         const statements = sql
             .split(';')
             .map(s => s.trim())
             .filter(s => s.length > 0);
-        for (const statement of statements) {
-            await this.raw.execSQL(statement);
-        }
+        await this.mutex.serialize(async () => {
+            for (const statement of statements) {
+                await this.raw.execute(statement);
+            }
+        });
     }
     prepare(sql) {
-        return new NSPluginStatement(this.raw, sql);
+        // Outside-transaction statement: writes go through the mutex.
+        return new NSPluginStatement(this.raw, sql, this.mutex);
     }
     async transaction(fn) {
-        await this.raw.execSQL('BEGIN');
-        try {
-            const result = await fn();
-            await this.raw.execSQL('COMMIT');
-            return result;
-        }
-        catch (err) {
+        return this.mutex.serialize(async () => {
+            // BEGIN IMMEDIATE takes the write lock up front rather than deferring
+            // it to the first write, so contention surfaces here and not mid-body.
+            await this.raw.execute('BEGIN IMMEDIATE');
             try {
-                await this.raw.execSQL('ROLLBACK');
+                // Statements bound to the open transaction bypass the mutex — we
+                // already hold the slot; re-locking would deadlock.
+                const tx = {
+                    prepare: (sql) => new NSPluginStatement(this.raw, sql),
+                };
+                const result = await fn(tx);
+                await this.raw.execute('COMMIT');
+                return result;
             }
-            catch {
-                // Swallow rollback failures so we surface the original error.
+            catch (err) {
+                try {
+                    await this.raw.execute('ROLLBACK');
+                }
+                catch {
+                    // Swallow rollback failures so we surface the original error.
+                }
+                throw err;
             }
-            throw err;
-        }
+        });
     }
     async close() {
         await this.raw.close();
@@ -72,20 +95,42 @@ class NSPluginDbWrapper {
 class NSPluginStatement {
     raw;
     sql;
-    constructor(raw, sql) {
+    mutex;
+    /**
+     * @param mutex When present, `run` is serialized on the connection mutex
+     *   (outside-transaction writes). When absent, `run` executes directly on the
+     *   raw connection — used for statements bound to an already-open transaction
+     *   that already holds the mutex slot.
+     */
+    constructor(raw, sql, mutex) {
         this.raw = raw;
         this.sql = sql;
+        this.mutex = mutex;
     }
     async run(...params) {
-        await this.raw.execSQL(this.sql, params);
+        if (this.mutex) {
+            await this.mutex.serialize(() => this.raw.execute(this.sql, params));
+        }
+        else {
+            await this.raw.execute(this.sql, params);
+        }
     }
     async get(...params) {
+        // NOTE: reads run directly on the connection, unserialized, to preserve read
+        // concurrency. A read issued while a write transaction is open on this same
+        // connection observes that transaction's UNCOMMITTED rows (read-your-connection
+        // semantics). Fine today: the only transaction writer is same-block promote
+        // under the commit latch, and cross-block reads are independent. If a future
+        // caller reads a block on this connection while another op's transaction on the
+        // same rows is mid-flight, it may see uncommitted state — serialize reads too if
+        // that ever matters.
         const row = await this.raw.get(this.sql, params);
         if (row === null || row === undefined)
             return undefined;
         return row;
     }
     async all(...params) {
+        // NOTE: unserialized read — see the note on `get` above re: uncommitted reads.
         const rows = await this.raw.select(this.sql, params);
         return rows;
     }

package/dist/src/ns-opener.js.map

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