@optimystic/db-p2p-storage-ns 0.13.4

package/dist/src/sqlite-storage.d.ts

@@ -0,0 +1,38 @@
+import type { ActionId, ActionRev, BlockId, IBlock, Transform } from '@optimystic/db-core';
+import type { BlockMetadata, IRawStorage } from '@optimystic/db-p2p';
+import type { SqliteDb } from './db.js';
+/**
+ * SQLite-backed `IRawStorage` implementation for NativeScript peers.
+ *
+ * Every CRUD operation goes through a prepared statement bound once in the
+ * constructor. `listRevisions` and `listPendingTransactions` issue
+ * `SELECT … ORDER BY` queries bounded by `block_id` (and `rev` for revisions)
+ * and drain the results into an array before yielding — matching the
+ * `IndexedDBRawStorage` pattern, where holding a cursor live across consumer
+ * awaits would invalidate the underlying transaction.
+ *
+ * `promotePendingTransaction` runs as a single `BEGIN; INSERT…; DELETE…; COMMIT;`
+ * via `SqliteDb.transaction(fn)`, so the move is atomic across crashes —
+ * unlike the MMKV adapter, which has to maintain a separate pending-index row.
+ */
+export declare class SqliteRawStorage implements IRawStorage {
+    private readonly db;
+    private readonly stmts;
+    constructor(db: SqliteDb);
+    getMetadata(blockId: BlockId): Promise<BlockMetadata | undefined>;
+    saveMetadata(blockId: BlockId, metadata: BlockMetadata): Promise<void>;
+    getRevision(blockId: BlockId, rev: number): Promise<ActionId | undefined>;
+    saveRevision(blockId: BlockId, rev: number, actionId: ActionId): Promise<void>;
+    listRevisions(blockId: BlockId, startRev: number, endRev: number): AsyncIterable<ActionRev>;
+    getPendingTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined>;
+    savePendingTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void>;
+    deletePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void>;
+    listPendingTransactions(blockId: BlockId): AsyncIterable<ActionId>;
+    getTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined>;
+    saveTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void>;
+    getMaterializedBlock(blockId: BlockId, actionId: ActionId): Promise<IBlock | undefined>;
+    saveMaterializedBlock(blockId: BlockId, actionId: ActionId, block?: IBlock): Promise<void>;
+    getApproximateBytesUsed(): Promise<number>;
+    promotePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void>;
+}
+//# sourceMappingURL=sqlite-storage.d.ts.map

package/dist/src/sqlite-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-storage.d.ts","sourceRoot":"","sources":["../../src/sqlite-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,SAAS,CAAC;AAKzD;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAqBvC,OAAO,CAAC,QAAQ,CAAC,EAAE;IApB/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAkBpB;gBAE2B,EAAE,EAAE,QAAQ;IAsBnC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAMjE,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAKzE,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC;IAW5F,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAM3F,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjG,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC;IAOnE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAMpF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAMvF,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1F,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAa1C,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAUpF"}

package/dist/src/sqlite-storage.js

@@ -0,0 +1,133 @@
+import { createLogger } from './logger.js';
+const log = createLogger('storage:sqlite');
+/**
+ * SQLite-backed `IRawStorage` implementation for NativeScript peers.
+ *
+ * Every CRUD operation goes through a prepared statement bound once in the
+ * constructor. `listRevisions` and `listPendingTransactions` issue
+ * `SELECT … ORDER BY` queries bounded by `block_id` (and `rev` for revisions)
+ * and drain the results into an array before yielding — matching the
+ * `IndexedDBRawStorage` pattern, where holding a cursor live across consumer
+ * awaits would invalidate the underlying transaction.
+ *
+ * `promotePendingTransaction` runs as a single `BEGIN; INSERT…; DELETE…; COMMIT;`
+ * via `SqliteDb.transaction(fn)`, so the move is atomic across crashes —
+ * unlike the MMKV adapter, which has to maintain a separate pending-index row.
+ */
+export class SqliteRawStorage {
+    db;
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.stmts = {
+            getMetadata: db.prepare('SELECT value FROM metadata WHERE block_id = ?'),
+            saveMetadata: db.prepare('INSERT OR REPLACE INTO metadata (block_id, value) VALUES (?, ?)'),
+            getRevision: db.prepare('SELECT action_id FROM revisions WHERE block_id = ? AND rev = ?'),
+            saveRevision: db.prepare('INSERT OR REPLACE INTO revisions (block_id, rev, action_id) VALUES (?, ?, ?)'),
+            listRevisionsAsc: db.prepare('SELECT rev, action_id FROM revisions WHERE block_id = ? AND rev BETWEEN ? AND ? ORDER BY rev ASC'),
+            listRevisionsDesc: db.prepare('SELECT rev, action_id FROM revisions WHERE block_id = ? AND rev BETWEEN ? AND ? ORDER BY rev DESC'),
+            getPending: db.prepare('SELECT value FROM pending WHERE block_id = ? AND action_id = ?'),
+            savePending: db.prepare('INSERT OR REPLACE INTO pending (block_id, action_id, value) VALUES (?, ?, ?)'),
+            deletePending: db.prepare('DELETE FROM pending WHERE block_id = ? AND action_id = ?'),
+            listPending: db.prepare('SELECT action_id FROM pending WHERE block_id = ? ORDER BY action_id ASC'),
+            getTransaction: db.prepare('SELECT value FROM transactions WHERE block_id = ? AND action_id = ?'),
+            saveTransaction: db.prepare('INSERT OR REPLACE INTO transactions (block_id, action_id, value) VALUES (?, ?, ?)'),
+            getMaterialized: db.prepare('SELECT value FROM materialized WHERE block_id = ? AND action_id = ?'),
+            saveMaterialized: db.prepare('INSERT OR REPLACE INTO materialized (block_id, action_id, value) VALUES (?, ?, ?)'),
+            deleteMaterialized: db.prepare('DELETE FROM materialized WHERE block_id = ? AND action_id = ?'),
+            pageCount: db.prepare('PRAGMA page_count'),
+            pageSize: db.prepare('PRAGMA page_size'),
+        };
+    }
+    async getMetadata(blockId) {
+        const row = await this.stmts.getMetadata.get(blockId);
+        if (!row)
+            return undefined;
+        return JSON.parse(row.value);
+    }
+    async saveMetadata(blockId, metadata) {
+        await this.stmts.saveMetadata.run(blockId, JSON.stringify(metadata));
+    }
+    async getRevision(blockId, rev) {
+        const row = await this.stmts.getRevision.get(blockId, rev);
+        return row ? row.action_id : undefined;
+    }
+    async saveRevision(blockId, rev, actionId) {
+        await this.stmts.saveRevision.run(blockId, rev, actionId);
+    }
+    async *listRevisions(blockId, startRev, endRev) {
+        const ascending = startRev <= endRev;
+        const lo = ascending ? startRev : endRev;
+        const hi = ascending ? endRev : startRev;
+        const stmt = ascending ? this.stmts.listRevisionsAsc : this.stmts.listRevisionsDesc;
+        const rows = await stmt.all(blockId, lo, hi);
+        for (const row of rows) {
+            yield { rev: row.rev, actionId: row.action_id };
+        }
+    }
+    async getPendingTransaction(blockId, actionId) {
+        const row = await this.stmts.getPending.get(blockId, actionId);
+        if (!row)
+            return undefined;
+        return JSON.parse(row.value);
+    }
+    async savePendingTransaction(blockId, actionId, transform) {
+        await this.stmts.savePending.run(blockId, actionId, JSON.stringify(transform));
+    }
+    async deletePendingTransaction(blockId, actionId) {
+        await this.stmts.deletePending.run(blockId, actionId);
+    }
+    async *listPendingTransactions(blockId) {
+        const rows = await this.stmts.listPending.all(blockId);
+        for (const row of rows) {
+            yield row.action_id;
+        }
+    }
+    async getTransaction(blockId, actionId) {
+        const row = await this.stmts.getTransaction.get(blockId, actionId);
+        if (!row)
+            return undefined;
+        return JSON.parse(row.value);
+    }
+    async saveTransaction(blockId, actionId, transform) {
+        await this.stmts.saveTransaction.run(blockId, actionId, JSON.stringify(transform));
+    }
+    async getMaterializedBlock(blockId, actionId) {
+        const row = await this.stmts.getMaterialized.get(blockId, actionId);
+        if (!row)
+            return undefined;
+        return JSON.parse(row.value);
+    }
+    async saveMaterializedBlock(blockId, actionId, block) {
+        if (block) {
+            await this.stmts.saveMaterialized.run(blockId, actionId, JSON.stringify(block));
+        }
+        else {
+            await this.stmts.deleteMaterialized.run(blockId, actionId);
+        }
+    }
+    async getApproximateBytesUsed() {
+        try {
+            const pageCountRow = await this.stmts.pageCount.get();
+            const pageSizeRow = await this.stmts.pageSize.get();
+            const pages = pageCountRow?.page_count ?? 0;
+            const size = pageSizeRow?.page_size ?? 0;
+            return pages * size;
+        }
+        catch (err) {
+            log('PRAGMA page_count/page_size failed: %o', err);
+            return 0;
+        }
+    }
+    async promotePendingTransaction(blockId, actionId) {
+        await this.db.transaction(async () => {
+            const row = await this.stmts.getPending.get(blockId, actionId);
+            if (!row) {
+                throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
+            }
+            await this.stmts.saveTransaction.run(blockId, actionId, row.value);
+            await this.stmts.deletePending.run(blockId, actionId);
+        });
+    }
+}
+//# sourceMappingURL=sqlite-storage.js.map

package/dist/src/sqlite-storage.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@optimystic/db-p2p-storage-ns",
+  "version": "0.13.4",
+  "type": "module",
+  "description": "NativeScript SQLite storage backend for @optimystic/db-p2p",
+  "main": "dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gotchoices/optimystic.git",
+    "directory": "packages/db-p2p-storage-ns"
+  },
+  "author": "Got Choices Foundation",
+  "license": "MIT",
+  "keywords": [
+    "optimystic",
+    "database",
+    "p2p",
+    "storage",
+    "nativescript",
+    "sqlite"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc",
+    "test": "node --no-warnings=ExperimentalWarning --import ./register.mjs node_modules/mocha/bin/mocha.js \"test/**/*.spec.ts\" --colors --reporter min",
+    "test:verbose": "node --no-warnings=ExperimentalWarning --import ./register.mjs node_modules/mocha/bin/mocha.js \"test/**/*.spec.ts\" --colors --reporter spec"
+  },
+  "devDependencies": {
+    "@libp2p/crypto": "^5.1.13",
+    "@libp2p/interface": "^3.1.0",
+    "@libp2p/peer-id": "^6.0.4",
+    "@types/chai": "^5.2.3",
+    "@types/debug": "^4.1.12",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^25.1.0",
+    "chai": "^6.2.2",
+    "mocha": "^11.7.5",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@optimystic/db-core": "^0.13.4",
+    "@optimystic/db-p2p": "^0.13.4",
+    "debug": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@libp2p/crypto": "^5.1.13",
+    "@libp2p/interface": "^3.1.0",
+    "@nativescript-community/sqlite": "^3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@nativescript-community/sqlite": {
+      "optional": false
+    }
+  }
+}

package/src/db.ts

@@ -0,0 +1,131 @@
+/**
+ * Internal SQLite shim and Optimystic schema for the NativeScript storage backend.
+ *
+ * The storage classes (`SqliteRawStorage`, `SqliteKVStore`) and the identity
+ * helper (`loadOrCreateNSPeerKey`) only depend on the `SqliteDb` interface
+ * defined here — never on `@nativescript-community/sqlite` directly. That lets
+ * the suite run under Node mocha against a `node:sqlite` or `better-sqlite3`
+ * driver, matching the pattern `db-p2p-storage-web` uses with `fake-indexeddb`.
+ *
+ * The wrapper is **package-private**: only `openOptimysticNSDb` is exported to
+ * consumers; the `SqliteDb` interface is an internal seam for tests.
+ */
+
+/** SQL parameter value — covers everything `IRawStorage` and `IKVStore` write. */
+export type SqliteParam = string | number | Uint8Array | null;
+
+/** A single row returned from a SQL query, keyed by column name. */
+export type SqliteRow = Record<string, SqliteParam>;
+
+/**
+ * A prepared statement bound to a single SQL string.
+ *
+ * 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.
+ */
+export interface SqliteStatement {
+	/** Execute with the given bind parameters, ignoring any returned rows. */
+	run(...params: SqliteParam[]): Promise<void>;
+	/** Execute and return the first row, or `undefined` if none. */
+	get(...params: SqliteParam[]): Promise<SqliteRow | undefined>;
+	/** Execute and return all rows (already drained — safe to await between yields). */
+	all(...params: SqliteParam[]): Promise<SqliteRow[]>;
+}
+
+/**
+ * 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.
+ */
+export interface SqliteDb {
+	/** Execute one or more semicolon-separated statements; no result rows. */
+	exec(sql: string): Promise<void>;
+	/** Prepare a parameterized statement for repeated execution. */
+	prepare(sql: string): SqliteStatement;
+	/** Run `fn` inside `BEGIN ... COMMIT` (rolls back on throw). */
+	transaction<T>(fn: () => Promise<T>): Promise<T>;
+	/** Release the underlying handle. */
+	close(): Promise<void>;
+}
+
+export const DEFAULT_DB_NAME = 'optimystic.sqlite';
+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)`.
+ * - `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.
+ */
+export const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS metadata (
+	block_id TEXT PRIMARY KEY,
+	value    TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS revisions (
+	block_id  TEXT    NOT NULL,
+	rev       INTEGER NOT NULL,
+	action_id TEXT    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,
+	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,
+	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,
+	PRIMARY KEY (block_id, action_id)
+);
+
+CREATE TABLE IF NOT EXISTS kv (
+	key    TEXT PRIMARY KEY,
+	s_val  TEXT,
+	b_val  BLOB
+);
+`;
+
+const PRAGMAS_SQL = `
+PRAGMA journal_mode = WAL;
+PRAGMA synchronous = NORMAL;
+PRAGMA foreign_keys = OFF;
+`;
+
+/**
+ * Apply pragmas, run the schema DDL, and stamp `user_version` so future
+ * migrations can branch on it. Idempotent — safe to call on every open.
+ */
+export async function applySchema(db: SqliteDb, version: number = DEFAULT_DB_VERSION): Promise<void> {
+	await db.exec(PRAGMAS_SQL);
+	await db.exec(SCHEMA_SQL);
+	await db.exec(`PRAGMA user_version = ${version}`);
+}
+
+/**
+ * Public handle returned by `openOptimysticNSDb`. Consumers pass it to
+ * `SqliteRawStorage`, `SqliteKVStore`, and `loadOrCreateNSPeerKey`.
+ */
+export type OptimysticNSDBHandle = SqliteDb;

package/src/identity.ts

@@ -0,0 +1,34 @@
+import { generateKeyPair, privateKeyFromProtobuf, privateKeyToProtobuf } from '@libp2p/crypto/keys';
+import type { PrivateKey } from '@libp2p/interface';
+import type { SqliteDb } from './db.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.
+ *
+ * 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
+ * round-trip — unlike text-only key/value stores.
+ *
+ * The returned `PrivateKey` can be passed directly to
+ * `createLibp2pNode({ privateKey })`, giving a NativeScript peer a stable,
+ * restart-surviving identity.
+ */
+export async function loadOrCreateNSPeerKey(
+	db: SqliteDb,
+	keyName: string = DEFAULT_PEER_KEY_NAME,
+): Promise<PrivateKey> {
+	const row = await db.prepare('SELECT b_val FROM kv WHERE key = ?').get(keyName);
+	const stored = row?.b_val;
+	if (stored instanceof Uint8Array && stored.length > 0) {
+		return privateKeyFromProtobuf(stored);
+	}
+	const key = await generateKeyPair('Ed25519');
+	const bytes = privateKeyToProtobuf(key);
+	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);
+	return key;
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+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 { SqliteKVStore } from './sqlite-kv-store.js';
+export { loadOrCreateNSPeerKey, DEFAULT_PEER_KEY_NAME } from './identity.js';

package/src/logger.ts

@@ -0,0 +1,7 @@
+import debug from 'debug';
+
+const BASE_NAMESPACE = 'optimystic:db-p2p-storage-ns';
+
+export function createLogger(subNamespace: string): debug.Debugger {
+	return debug(`${BASE_NAMESPACE}:${subNamespace}`);
+}

package/src/ns-opener.ts

@@ -0,0 +1,112 @@
+import { applySchema, DEFAULT_DB_NAME, DEFAULT_DB_VERSION, type OptimysticNSDBHandle, type SqliteDb, type SqliteParam, type SqliteRow, type SqliteStatement } from './db.js';
+
+/**
+ * Minimal subset of `@nativescript-community/sqlite`'s `Db` we depend on.
+ * Re-declared locally so this module's *types* don't pull in the plugin's
+ * declarations (the plugin is a peer dependency that may not be installed
+ * at typecheck time on non-NativeScript consumers).
+ */
+interface NSPluginDb {
+	execSQL(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>;
+}
+
+interface NSPluginModule {
+	openOrCreate(path: string): NSPluginDb | Promise<NSPluginDb>;
+}
+
+/**
+ * Opens (creating if needed) the Optimystic SQLite database at `name` under
+ * the NativeScript app's documents directory, applies WAL pragmas, and runs
+ * 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.
+ *
+ * `path` may be passed in as the full filesystem path if the caller wants
+ * to control file placement; otherwise the plugin's documents-directory
+ * default is used.
+ */
+export async function openOptimysticNSDb(
+	name: string = DEFAULT_DB_NAME,
+	version: number = DEFAULT_DB_VERSION,
+): Promise<OptimysticNSDBHandle> {
+	const plugin = (await import('@nativescript-community/sqlite' as string)) as unknown as NSPluginModule;
+	const raw = await plugin.openOrCreate(name);
+	const wrapped = wrapNSPluginDb(raw);
+	await applySchema(wrapped, version);
+	return wrapped;
+}
+
+/**
+ * Wraps a `@nativescript-community/sqlite` `Db` instance to satisfy the
+ * 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`).
+ */
+export function wrapNSPluginDb(raw: NSPluginDb): SqliteDb {
+	return new NSPluginDbWrapper(raw);
+}
+
+class NSPluginDbWrapper implements SqliteDb {
+	constructor(private readonly raw: NSPluginDb) {}
+
+	async exec(sql: string): Promise<void> {
+		// The plugin's execSQL 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);
+		}
+	}
+
+	prepare(sql: string): SqliteStatement {
+		return new NSPluginStatement(this.raw, sql);
+	}
+
+	async transaction<T>(fn: () => Promise<T>): Promise<T> {
+		await this.raw.execSQL('BEGIN');
+		try {
+			const result = await fn();
+			await this.raw.execSQL('COMMIT');
+			return result;
+		} catch (err) {
+			try {
+				await this.raw.execSQL('ROLLBACK');
+			} catch {
+				// Swallow rollback failures so we surface the original error.
+			}
+			throw err;
+		}
+	}
+
+	async close(): Promise<void> {
+		await this.raw.close();
+	}
+}
+
+class NSPluginStatement implements SqliteStatement {
+	constructor(private readonly raw: NSPluginDb, private readonly sql: string) {}
+
+	async run(...params: SqliteParam[]): Promise<void> {
+		await this.raw.execSQL(this.sql, params);
+	}
+
+	async get(...params: SqliteParam[]): Promise<SqliteRow | undefined> {
+		const row = await this.raw.get(this.sql, params);
+		if (row === null || row === undefined) return undefined;
+		return row as SqliteRow;
+	}
+
+	async all(...params: SqliteParam[]): Promise<SqliteRow[]> {
+		const rows = await this.raw.select(this.sql, params);
+		return rows as SqliteRow[];
+	}
+}

package/src/sqlite-kv-store.ts

@@ -0,0 +1,61 @@
+import type { IKVStore } from '@optimystic/db-p2p';
+import type { SqliteDb, SqliteStatement } from './db.js';
+
+/**
+ * SQLite-backed `IKVStore` adapter for NativeScript peers.
+ *
+ * Stored keys are namespaced with `prefix` so the `kv` table can be shared
+ * with the identity helper (which uses the `b_val` column) without collisions.
+ * `list(prefix)` issues a bounded `SELECT key FROM kv WHERE key >= ? AND key < ?`
+ * — never `SELECT * FROM kv` + JS-side filter — so listing latency stays
+ * bounded as the table grows.
+ *
+ * Only the `s_val` column is read or written here; the `b_val` column is
+ * reserved for binary identity material.
+ */
+export class SqliteKVStore implements IKVStore {
+	private readonly stmts: {
+		get: SqliteStatement;
+		set: SqliteStatement;
+		delete: SqliteStatement;
+		list: SqliteStatement;
+	};
+	private readonly prefix: string;
+
+	constructor(db: SqliteDb, prefix: string = 'optimystic:txn:') {
+		this.prefix = prefix;
+		this.stmts = {
+			get: db.prepare('SELECT s_val FROM kv WHERE key = ?'),
+			set: db.prepare('INSERT INTO kv (key, s_val, b_val) VALUES (?, ?, NULL) ON CONFLICT(key) DO UPDATE SET s_val = excluded.s_val'),
+			delete: db.prepare('DELETE FROM kv WHERE key = ?'),
+			list: db.prepare('SELECT key FROM kv WHERE key >= ? AND key < ? ORDER BY key ASC'),
+		};
+	}
+
+	async get(key: string): Promise<string | undefined> {
+		const row = await this.stmts.get.get(this.prefix + key);
+		if (!row) return undefined;
+		const value = row.s_val;
+		return typeof value === 'string' ? value : undefined;
+	}
+
+	async set(key: string, value: string): Promise<void> {
+		await this.stmts.set.run(this.prefix + key, value);
+	}
+
+	async delete(key: string): Promise<void> {
+		await this.stmts.delete.run(this.prefix + key);
+	}
+
+	async list(prefix: string): Promise<string[]> {
+		const fullPrefix = this.prefix + prefix;
+		// SQLite TEXT columns compare with BINARY collation by default — byte-by-byte
+		// over the UTF-8 encoding. U+10FFFF (`\u{10FFFF}`) is the highest Unicode
+		// code point, encoded as `F4 8F BF BF`; since the only valid UTF-8 leading
+		// bytes go up to 0xF4, any string starting with `fullPrefix` sorts strictly
+		// below `fullPrefix + '\u{10FFFF}'`, so the bound is exact for all valid keys.
+		const upper = fullPrefix + '\u{10FFFF}';
+		const rows = await this.stmts.list.all(fullPrefix, upper);
+		return rows.map(row => (row.key as string).slice(this.prefix.length));
+	}
+}