@optimystic/db-p2p-storage-ns 1.15.0 → 1.16.0

package/README.md

@@ -6,9 +6,10 @@ Android, native — not React Native). Provides:
 - **`SqliteRawStorage`** — the `IRawStorage` a NativeScript node uses to
   persist block metadata, revisions, pending transactions, committed
   transactions, commit proofs, 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 six logical stores onto the six SQLite tables.
+  It is the shared `KvRawStorage` kernel over a `WriteGroupDriver` over
+  `SqliteBatchBackend`: the kernel owns all JSON serialization, the driver
+  holds each group of writes in memory until it is flushed, and the backend
+  applies the group as one SQLite transaction over the six tables.
 - **`SqliteKVStore`** — implements `IKVStore` for the persistent transaction
   state used to recover crashed two-phase commits.
 - **`loadOrCreateNSPeerKey`** — generates an Ed25519 libp2p private key on
@@ -72,27 +73,40 @@ 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.
 
+Close the storage before the handle, and the handle last:
+
+```ts
+await rawStorage.close();   // flushes what it still holds, syncs it, disarms its timers
+await kvStore.flush();
+await db.close();
+```
+
+`SqliteRawStorage.close()` does not close the shared handle. A write the
+storage still holds when the handle is closed under it is lost, and a timer it
+still has armed would fire on a closed connection.
+
 ## Persistence model
 
 The package opens a single SQLite database (`optimystic.sqlite` by default
-in the NativeScript app's documents directory) with seven tables. The six
+in the NativeScript app's documents directory) with eight tables. The six
 block-storage tables keep their original columns and keys, but their value
-columns are now **BLOB**: `SqliteStoreDriver` binds/reads the kernel's raw
+columns are **BLOB**: `SqliteBatchBackend` 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`            |
-| `proofs`       | `(block_id, rev)`                | `BLOB`       | `BlockCommitProof`     |
-| `materialized` | `(block_id, action_id)`          | `BLOB`       | `IBlock`               |
-| `kv`           | `key`                            | `s_val` (TEXT) or `b_val` (BLOB) | — (not kernel-backed) |
+| 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`            |
+| `proofs`          | `(block_id, rev)`                | `BLOB`       | `BlockCommitProof`     |
+| `materialized`    | `(block_id, action_id)`          | `BLOB`       | `IBlock`               |
+| `kv`              | `key`                            | `s_val` (TEXT) or `b_val` (BLOB) | — (not kernel-backed) |
+| `durability_mark` | `id` (always 1)                  | `n` (INTEGER), a counter nothing reads | — (the row a sync commits when it has nothing else to write) |
 
 Pragmas: `journal_mode = WAL`, `synchronous = NORMAL`, `foreign_keys = OFF`.
 Schema is versioned via `PRAGMA user_version`.
@@ -100,21 +114,64 @@ Schema is versioned via `PRAGMA user_version`.
 `listRevisions` and `listPendingTransactions` issue bounded
 `SELECT … ORDER BY` queries — never `SELECT * FROM <table>` + JS filter —
 so list latency stays bounded as the tables grow.
-`promotePendingTransaction` runs as a single `BEGIN; INSERT…; DELETE…; COMMIT;`
-inside `SqliteDb.transaction(fn)`, so the move is atomic across crashes —
-unlike the MMKV adapter, which has to maintain a separate pending-index row.
+`promotePendingTransaction` records two entries of one write group — the
+committed row's insert and the pending row's delete — applied in that group's
+transaction, so the move is atomic across crashes.
 
 `getApproximateBytesUsed()` returns `page_count × page_size` from PRAGMAs.
 This is the SQLite database-file footprint; it is **not** a per-block figure.
 That's adequate for `StorageMonitor` — which uses the value as an advisory
 ring-selection input.
 
+## Durability
+
+`SqliteRawStorage` reports `durability: 'power-loss'`. A write resolves into
+memory and is served from there; `flush()` applies every write made since the
+last flush as **one SQLite transaction**, so a group lands whole or not at all.
+In write-ahead-log mode a commit appends the group's frames to one append-only
+log file, each frame checksummed over the frames before it, and recovery stops
+at the first bad frame, so what a power cut leaves is a prefix of the committed
+groups, in order. Under `synchronous = NORMAL` a commit does not wait for the
+disk; a commit under `FULL` syncs the log, and with it every earlier commit on
+the database. So:
+
+- a strict `flush()` (no `withinMs`, or 0) commits the group under `FULL` and
+  resolves once it is on disk;
+- a relaxed `flush({ withinMs })` — what a node uses for a write its cohort
+  also holds, see [storage.md §How long a write may wait for its sync](../db-p2p/docs/storage.md#how-long-a-write-may-wait-for-its-sync) —
+  commits under `NORMAL` and resolves at once; one `FULL` commit by the earliest
+  deadline, or a strict flush before then, syncs every group committed since the
+  last sync. `whenDurable()` resolves once the groups flushed so far are synced.
+
+What a crash loses:
+
+| Crash | Lost |
+|---|---|
+| the app's process | a group not yet flushed, still in memory; nothing a flush has resolved for |
+| a power cut or operating-system crash | at most the groups still inside their window, always the most recent ones, each whole; nothing a strict flush has resolved for, and nothing once the window has passed |
+
+`SqliteDb.transaction(fn, { synced: true })` is the primitive: inside the
+connection mutex slot it sets `PRAGMA synchronous = FULL`, runs
+`BEGIN IMMEDIATE … COMMIT`, and restores `NORMAL` afterwards, after a rollback
+too. `syncSqliteDb(db)` is a synced transaction that bumps the one-row
+`durability_mark` table, so a sync with no rows of its own still has a frame to
+commit; `SqliteKVStore.flush()` runs it when the store wrote since its last
+flush, and `loadOrCreateNSPeerKey` runs it after writing a newly generated key,
+so a power cut right after first start cannot give the node a different
+identity next time.
+
+A failed commit or sync latches the storage: every later write, flush and
+`whenDurable()` rejects with `StoreFailedError` until the app reopens the store
+(rule 5 of the flush contract,
+[storage.md §6](../db-p2p/docs/storage.md#6-a-write-survives-a-crash-once-a-flush-called-after-it-has-resolved)).
+
 ## Identity
 
 `loadOrCreateNSPeerKey(db, keyName?)` writes the libp2p private key as raw
 protobuf bytes (`Uint8Array`) into the `kv` table's `b_val` column under
-`keyName` (default `peer-private-key`). SQLite stores BLOBs natively — no
-base64 round-trip. To rotate the identity, delete that one row:
+`keyName` (default `peer-private-key`), synced before it returns. SQLite stores
+BLOBs natively — no base64 round-trip. To rotate the identity, delete that one
+row:
 
 ```ts
 await db.prepare('DELETE FROM kv WHERE key = ?').run('peer-private-key');
@@ -130,4 +187,5 @@ underlying SQLite file.
 the package-private `SqliteDb` interface, so the Node driver is a faithful
 behavioural surrogate for the NativeScript plugin. The suite never imports
 `@nativescript-community/sqlite`, so the plugin's native bindings don't need
-to be installed to run tests.
+to be installed to run tests. No test cuts the power: that a committed group
+survives one rests on SQLite's write-ahead log, as stated above.

package/dist/src/db.d.ts

@@ -44,6 +44,17 @@ export interface SqliteTransaction {
     /** Prepare a statement bound to the open transaction; bypasses the mutex. */
     prepare(sql: string): SqliteStatement;
 }
+/** Options of {@link SqliteDb.transaction}. */
+export interface SqliteTransactionOptions {
+    /**
+     * Commit under `PRAGMA synchronous = FULL`, which in write-ahead-log mode syncs the log file at
+     * this commit. The log is one append-only file, so that sync covers every frame before it: every
+     * earlier `NORMAL` commit on this database, whichever store or helper made it. The pragma is set
+     * inside the mutex slot the transaction holds and restored to `NORMAL` after the commit, or after
+     * the rollback, so no other write on the connection pays for the sync by accident. Default false.
+     */
+    readonly synced?: boolean;
+}
 /**
  * Minimal SQLite driver surface used by this package.
  *
@@ -65,6 +76,10 @@ export interface SqliteDb {
      * 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.
+     * With `options.synced` the commit also syncs the write-ahead log, which makes
+     * this transaction and every earlier commit on the database survive a power
+     * cut (see {@link SqliteTransactionOptions.synced}); without it the commit
+     * survives a crash of this process only, until a later synced commit.
      *
      * 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
@@ -72,10 +87,27 @@ export interface SqliteDb {
      * `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>;
+    transaction<T>(fn: (tx: SqliteTransaction) => Promise<T>, options?: SqliteTransactionOptions): Promise<T>;
     /** Release the underlying handle. */
     close(): Promise<void>;
 }
+/** The raw connection surface {@link runTransaction} drives: one statement at a time, no rows back. */
+export interface TransactionConnection {
+    execute(sql: string): Promise<void> | void;
+}
+/**
+ * The transaction protocol both `SqliteDb` implementations run inside their mutex slot: with
+ * `synced`, `PRAGMA synchronous = FULL` first; then `BEGIN IMMEDIATE`, the body, and `COMMIT`, or
+ * `ROLLBACK` when the body or the commit throws; then, synced, `PRAGMA synchronous = NORMAL`
+ * whichever way the transaction ended, so the connection's default is restored before the slot is
+ * released. `BEGIN IMMEDIATE` takes the write lock up front rather than deferring it to the first
+ * write, so contention surfaces here and not mid-body.
+ *
+ * A failure of the restore after a failed body is logged rather than thrown, so the body's error,
+ * the one that matters, is the one the caller sees; after a committed body it is thrown, since the
+ * connection would otherwise sync every later commit unasked.
+ */
+export declare function runTransaction<T>(conn: TransactionConnection, tx: SqliteTransaction, fn: (tx: SqliteTransaction) => Promise<T>, options?: SqliteTransactionOptions): Promise<T>;
 export declare const DEFAULT_DB_NAME = "optimystic.sqlite";
 export declare const DEFAULT_DB_VERSION = 1;
 /**
@@ -83,11 +115,11 @@ export declare const DEFAULT_DB_VERSION = 1;
  *
  * Mirrors the IndexedDB object stores 1:1. The six 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.
+ * shared `KvRawStorage` kernel (over `WriteGroupDriver` over `SqliteBatchBackend`)
+ * owns all JSON / UTF-8 (de)serialization, so the backend 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).
@@ -100,6 +132,12 @@ export declare const DEFAULT_DB_VERSION = 1;
  * - `kv` → generic string keyspace shared by `IKVStore` (`s_val`) and the
  *   identity helper (`b_val`). NOT kernel-backed; unchanged. The two columns
  *   avoid a base64 round-trip for the libp2p private key.
+ * - `durability_mark` → one row, bumped by `syncSqliteDb` (`sqlite-sync.ts`) so a
+ *   sync that has no rows of its own to write still has a frame to commit.
+ *
+ * NOTE: this package's SQL is uppercase throughout, predating the lowercase rule in
+ * AGENTS.md, and new statements have kept to it rather than mix cases within one file;
+ * convert the package in one pass rather than statement by statement.
  *
  * 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
@@ -110,7 +148,7 @@ export declare const DEFAULT_DB_VERSION = 1;
  * devices that later upgrade, add a `user_version` bump that drops+recreates
  * these six 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    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 proofs (\n\tblock_id TEXT    NOT NULL,\n\trev      INTEGER NOT NULL,\n\tvalue    BLOB    NOT NULL,\n\tPRIMARY KEY (block_id, rev)\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";
+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 proofs (\n\tblock_id TEXT    NOT NULL,\n\trev      INTEGER NOT NULL,\n\tvalue    BLOB    NOT NULL,\n\tPRIMARY KEY (block_id, rev)\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\nCREATE TABLE IF NOT EXISTS durability_mark (\n\tid INTEGER PRIMARY KEY CHECK (id = 1),\n\tn  INTEGER NOT NULL\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;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,UAAU,mhCA8CtB,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"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,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,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;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;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1G,qCAAqC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,uGAAuG;AACvG,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACrC,IAAI,EAAE,qBAAqB,EAC3B,EAAE,EAAE,iBAAiB,EACrB,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAmBD,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,UAAU,woCAmDtB,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

@@ -10,6 +10,61 @@
  * The wrapper is **package-private**: only `openOptimysticNSDb` is exported to
  * consumers; the `SqliteDb` interface is an internal seam for tests.
  */
+import { createLogger } from './logger.js';
+const log = createLogger('db');
+/**
+ * The transaction protocol both `SqliteDb` implementations run inside their mutex slot: with
+ * `synced`, `PRAGMA synchronous = FULL` first; then `BEGIN IMMEDIATE`, the body, and `COMMIT`, or
+ * `ROLLBACK` when the body or the commit throws; then, synced, `PRAGMA synchronous = NORMAL`
+ * whichever way the transaction ended, so the connection's default is restored before the slot is
+ * released. `BEGIN IMMEDIATE` takes the write lock up front rather than deferring it to the first
+ * write, so contention surfaces here and not mid-body.
+ *
+ * A failure of the restore after a failed body is logged rather than thrown, so the body's error,
+ * the one that matters, is the one the caller sees; after a committed body it is thrown, since the
+ * connection would otherwise sync every later commit unasked.
+ */
+export async function runTransaction(conn, tx, fn, options) {
+    const synced = options?.synced === true;
+    if (synced)
+        await conn.execute('PRAGMA synchronous = FULL');
+    let result;
+    try {
+        result = await commitOrRollBack(conn, tx, fn);
+    }
+    catch (err) {
+        if (synced) {
+            try {
+                await conn.execute('PRAGMA synchronous = NORMAL');
+            }
+            catch (restoreErr) {
+                log('restoring synchronous = NORMAL failed after a failed transaction: %o', restoreErr);
+            }
+        }
+        throw err;
+    }
+    if (synced)
+        await conn.execute('PRAGMA synchronous = NORMAL');
+    return result;
+}
+async function commitOrRollBack(conn, tx, fn) {
+    await conn.execute('BEGIN IMMEDIATE');
+    try {
+        const result = await fn(tx);
+        await conn.execute('COMMIT');
+        return result;
+    }
+    catch (err) {
+        try {
+            await conn.execute('ROLLBACK');
+        }
+        catch (rollbackErr) {
+            // The original error is the one to surface; the rollback's is only logged.
+            log('rollback failed after a failed transaction: %o', rollbackErr);
+        }
+        throw err;
+    }
+}
 export const DEFAULT_DB_NAME = 'optimystic.sqlite';
 export const DEFAULT_DB_VERSION = 1;
 /**
@@ -17,11 +72,11 @@ export const DEFAULT_DB_VERSION = 1;
  *
  * Mirrors the IndexedDB object stores 1:1. The six 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.
+ * shared `KvRawStorage` kernel (over `WriteGroupDriver` over `SqliteBatchBackend`)
+ * owns all JSON / UTF-8 (de)serialization, so the backend 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).
@@ -34,6 +89,12 @@ export const DEFAULT_DB_VERSION = 1;
  * - `kv` → generic string keyspace shared by `IKVStore` (`s_val`) and the
  *   identity helper (`b_val`). NOT kernel-backed; unchanged. The two columns
  *   avoid a base64 round-trip for the libp2p private key.
+ * - `durability_mark` → one row, bumped by `syncSqliteDb` (`sqlite-sync.ts`) so a
+ *   sync that has no rows of its own to write still has a frame to commit.
+ *
+ * NOTE: this package's SQL is uppercase throughout, predating the lowercase rule in
+ * AGENTS.md, and new statements have kept to it rather than mix cases within one file;
+ * convert the package in one pass rather than statement by statement.
  *
  * 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
@@ -90,6 +151,11 @@ CREATE TABLE IF NOT EXISTS kv (
 	s_val  TEXT,
 	b_val  BLOB
 );
+
+CREATE TABLE IF NOT EXISTS durability_mark (
+	id INTEGER PRIMARY KEY CHECK (id = 1),
+	n  INTEGER NOT NULL
+);
 `;
 // Assignment-form pragmas return no rows, so they go through exec()/execute().
 const PRAGMAS_SQL = `

package/dist/src/db.js.map

@@ -1 +1 @@
-{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CzB,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"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AA8F/B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,IAA2B,EAC3B,EAAqB,EACrB,EAAyC,EACzC,OAAkC;IAElC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,IAAI,MAAM;QAAE,MAAM,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC5D,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACrB,GAAG,CAAC,sEAAsE,EAAE,UAAU,CAAC,CAAC;YACzF,CAAC;QACF,CAAC;QACD,MAAM,GAAG,CAAC;IACX,CAAC;IACD,IAAI,MAAM;QAAE,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC;AACf,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAI,IAA2B,EAAE,EAAqB,EAAE,EAAyC;IAC/H,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACtB,2EAA2E;YAC3E,GAAG,CAAC,gDAAgD,EAAE,WAAW,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,GAAG,CAAC;IACX,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDzB,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/identity.d.ts

@@ -3,7 +3,9 @@ import type { SqliteDb } from './db.js';
 export declare const DEFAULT_PEER_KEY_NAME = "peer-private-key";
 /**
  * Loads the persisted NativeScript peer's libp2p private key, or generates a
- * fresh Ed25519 key on first call and persists it.
+ * fresh Ed25519 key on first call, persists it, and syncs the database before
+ * returning it, so a power cut right after first start cannot give the node a
+ * different peer id next time. An existing key is read as it is.
  *
  * The key is stored as raw protobuf bytes in the `kv` table's `b_val` column
  * under `keyName`. SQLite stores BLOB natively, so there is no base64

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

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAC1C,EAAE,EAAE,QAAQ,EACZ,OAAO,GAAE,MAA8B,GACrC,OAAO,CAAC,UAAU,CAAC,CAYrB"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAC1C,EAAE,EAAE,QAAQ,EACZ,OAAO,GAAE,MAA8B,GACrC,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/dist/src/identity.js

@@ -1,8 +1,11 @@
 import { generateKeyPair, privateKeyFromProtobuf, privateKeyToProtobuf } from '@libp2p/crypto/keys';
+import { syncSqliteDb } from './sqlite-sync.js';
 export const DEFAULT_PEER_KEY_NAME = 'peer-private-key';
 /**
  * Loads the persisted NativeScript peer's libp2p private key, or generates a
- * fresh Ed25519 key on first call and persists it.
+ * fresh Ed25519 key on first call, persists it, and syncs the database before
+ * returning it, so a power cut right after first start cannot give the node a
+ * different peer id next time. An existing key is read as it is.
  *
  * The key is stored as raw protobuf bytes in the `kv` table's `b_val` column
  * under `keyName`. SQLite stores BLOB natively, so there is no base64
@@ -23,6 +26,7 @@ export async function loadOrCreateNSPeerKey(db, keyName = DEFAULT_PEER_KEY_NAME)
     await db
         .prepare('INSERT INTO kv (key, s_val, b_val) VALUES (?, NULL, ?) ON CONFLICT(key) DO UPDATE SET b_val = excluded.b_val')
         .run(keyName, bytes);
+    await syncSqliteDb(db);
     return key;
 }
 //# sourceMappingURL=identity.js.map

package/dist/src/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,EAAY,EACZ,UAAkB,qBAAqB;IAEvC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC;IAC1B,IAAI,MAAM,YAAY,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE;SACN,OAAO,CAAC,8GAA8G,CAAC;SACvH,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC;AACZ,CAAC"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,EAAY,EACZ,UAAkB,qBAAqB;IAEvC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC;IAC1B,IAAI,MAAM,YAAY,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE;SACN,OAAO,CAAC,8GAA8G,CAAC;SACvH,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtB,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/src/index.d.ts

@@ -1,7 +1,9 @@
-export type { OptimysticNSDBHandle, SqliteDb, SqliteStatement, SqliteParam, SqliteRow } from './db.js';
+export type { OptimysticNSDBHandle, SqliteDb, SqliteStatement, SqliteTransaction, SqliteTransactionOptions, SqliteParam, SqliteRow } from './db.js';
 export { DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
 export { openOptimysticNSDb, wrapNSPluginDb } from './ns-opener.js';
-export { SqliteRawStorage, SqliteStoreDriver } from './sqlite-storage.js';
+export { SqliteRawStorage, SqliteBatchBackend } from './sqlite-storage.js';
+export type { SqliteRawStorageOptions, SqliteBatchBackendOptions } from './sqlite-storage.js';
+export { syncSqliteDb } from './sqlite-sync.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,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,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,iBAAiB,EAAE,wBAAwB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpJ,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,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,7 @@
 export { DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
 export { openOptimysticNSDb, wrapNSPluginDb } from './ns-opener.js';
-export { SqliteRawStorage, SqliteStoreDriver } from './sqlite-storage.js';
+export { SqliteRawStorage, SqliteBatchBackend } from './sqlite-storage.js';
+export { syncSqliteDb } from './sqlite-sync.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,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,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,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

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":"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"}
+{"version":3,"file":"ns-opener.d.ts","sourceRoot":"","sources":["../../src/ns-opener.ts"],"names":[],"mappings":"AACA,OAAO,EAAoE,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAiH,MAAM,SAAS,CAAC;AAEpP;;;;;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,5 +1,5 @@
 import { ConnectionMutex } from './connection-mutex.js';
-import { applySchema, DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
+import { applySchema, runTransaction, DEFAULT_DB_NAME, DEFAULT_DB_VERSION } from './db.js';
 /**
  * Opens (creating if needed) the Optimystic SQLite database at `name` under
  * the NativeScript app's documents directory, applies WAL pragmas, and runs
@@ -62,31 +62,11 @@ class NSPluginDbWrapper {
         // Outside-transaction statement: writes go through the mutex.
         return new NSPluginStatement(this.raw, sql, this.mutex);
     }
-    async transaction(fn) {
-        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 {
-                // 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 (err) {
-                try {
-                    await this.raw.execute('ROLLBACK');
-                }
-                catch {
-                    // Swallow rollback failures so we surface the original error.
-                }
-                throw err;
-            }
-        });
+    async transaction(fn, options) {
+        return this.mutex.serialize(() => runTransaction({ execute: async (sql) => { await this.raw.execute(sql); } }, 
+        // Statements bound to the open transaction bypass the mutex — we
+        // already hold the slot; re-locking would deadlock.
+        { prepare: (sql) => new NSPluginStatement(this.raw, sql) }, fn, options));
     }
     async close() {
         await this.raw.close();
@@ -119,11 +99,16 @@ class NSPluginStatement {
         // 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 block's write 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.
+        // semantics). Fine today: the one transaction writer of the block tables is
+        // `SqliteBatchBackend.commit`, and every row it is writing is held by the
+        // `WriteGroupDriver` overlay above it until the batch is durable. A point read of
+        // such a row is answered by the overlay and never reaches this connection; a
+        // listing does reach it, and may see the batch's uncommitted rows, but merges the
+        // overlay over them, so it answers the same whether the transaction has committed
+        // or not (and a rolled-back batch latches the store). The key-value store and the
+        // identity helper write other tables, by autocommit statements, and the sync's
+        // `durability_mark` row is read by nobody. If a reader of a batch's rows ever
+        // bypasses the overlay, serialize reads too.
         const row = await this.raw.get(this.sql, params);
         if (row === null || row === undefined)
             return undefined;

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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"}

package/dist/src/sqlite-kv-store.d.ts

@@ -1,4 +1,4 @@
-import type { IKVStore } from '@optimystic/db-p2p';
+import { type IKVStore } from '@optimystic/db-p2p';
 import type { SqliteDb } from './db.js';
 /**
  * SQLite-backed `IKVStore` adapter for NativeScript peers.
@@ -11,14 +11,28 @@ import type { SqliteDb } from './db.js';
  *
  * Only the `s_val` column is read or written here; the `b_val` column is
  * reserved for binary identity material.
+ *
+ * Writes are autocommit statements: each is visible, and survives a crash of this process, once it
+ * resolves, and the write-ahead log keeps them in order. `flush()` makes them survive a power cut:
+ * when anything was written since the last flush it runs `syncSqliteDb`, one synced commit that
+ * syncs the shared log and with it every earlier write on the connection; otherwise it resolves at
+ * once. A failed sync latches the store, after which every write and flush throws
+ * `StoreFailedError` (rule 5 of the flush contract on `RawStoreDriver.flush`); reads keep working.
  */
 export declare class SqliteKVStore implements IKVStore {
+    private readonly db;
     private readonly stmts;
     private readonly prefix;
+    /** Set once a write has resolved, cleared by the flush that syncs it. */
+    private dirty;
+    private fault;
     constructor(db: SqliteDb, prefix?: string);
     get(key: string): Promise<string | undefined>;
     set(key: string, value: string): Promise<void>;
     delete(key: string): Promise<void>;
     list(prefix: string): Promise<string[]>;
+    /** `IKVStore.flush`: one synced commit when this store wrote since its last flush, otherwise nothing. */
+    flush(): Promise<void>;
+    private throwIfFailed;
 }
 //# sourceMappingURL=sqlite-kv-store.d.ts.map

package/dist/src/sqlite-kv-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-kv-store.d.ts","sourceRoot":"","sources":["../../src/sqlite-kv-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,SAAS,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAKpB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAE,MAA0B;IAUtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAO7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAW7C"}
+{"version":3,"file":"sqlite-kv-store.d.ts","sourceRoot":"","sources":["../../src/sqlite-kv-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,SAAS,CAAC;AAGzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAYjC,OAAO,CAAC,QAAQ,CAAC,EAAE;IAX/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAKpB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,yEAAyE;IACzE,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAiC;gBAEjB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAE,MAA0B;IAUvE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAO7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY7C,yGAAyG;IACnG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,OAAO,CAAC,aAAa;CAGrB"}