@optimystic/db-p2p-storage-ns 0.13.4

package/README.md

@@ -0,0 +1,118 @@
+# @optimystic/db-p2p-storage-ns
+
+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.
+- **`SqliteKVStore`** — implements `IKVStore` for the persistent transaction
+  state used to recover crashed two-phase commits.
+- **`loadOrCreateNSPeerKey`** — generates an Ed25519 libp2p private key on
+  first run and persists it as a BLOB in the same SQLite database, giving
+  the NativeScript peer a stable, restart-surviving identity.
+
+This package targets NativeScript apps (iOS + Android via the
+[`@nativescript-community/sqlite`](https://github.com/nativescript-community/sqlite)
+plugin). It cannot run in plain Node, browsers, or React Native — use the
+sibling adapter for each of those:
+
+- `@optimystic/db-p2p-storage-fs` — Node filesystem
+- `@optimystic/db-p2p-storage-rn` — React Native (MMKV)
+- `@optimystic/db-p2p-storage-web` — Browser (IndexedDB)
+
+## Install
+
+```bash
+yarn add @optimystic/db-p2p-storage-ns @optimystic/db-p2p @optimystic/db-core \
+         @nativescript-community/sqlite
+```
+
+`@nativescript-community/sqlite` is a peer dependency — the host app pins the
+version it needs (same approach as `react-native-mmkv` for the RN package).
+
+Use the Node-free `/rn` entry point of `@optimystic/db-p2p` so the Node-only
+TCP transport doesn't get bundled into the NativeScript app:
+
+```ts
+import { createLibp2pNode } from '@optimystic/db-p2p/rn';
+```
+
+## Usage
+
+```ts
+import { createLibp2pNode } from '@optimystic/db-p2p/rn';
+import {
+  openOptimysticNSDb,
+  SqliteRawStorage,
+  SqliteKVStore,
+  loadOrCreateNSPeerKey,
+} from '@optimystic/db-p2p-storage-ns';
+
+const db = await openOptimysticNSDb();           // single shared handle
+const rawStorage = new SqliteRawStorage(db);     // → IRawStorage
+const kvStore = new SqliteKVStore(db);           // → IKVStore (txn recovery)
+const privateKey = await loadOrCreateNSPeerKey(db);
+
+const libp2p = await createLibp2pNode({
+  bootstrapNodes: [/* … */],
+  networkName: 'my-network',
+  privateKey,
+});
+```
+
+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.
+
+## 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) |
+
+Pragmas: `journal_mode = WAL`, `synchronous = NORMAL`, `foreign_keys = OFF`.
+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.
+
+`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.
+
+## 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:
+
+```ts
+await db.prepare('DELETE FROM kv WHERE key = ?').run('peer-private-key');
+```
+
+To wipe the entire backing store (debugging / dev reset), delete the
+underlying SQLite file.
+
+## Tests
+
+`yarn test` runs the spec suite under Node's built-in `node:sqlite` driver
+(Node 22+ — default-enabled on Node 23+). Production code only depends on
+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.

package/dist/src/db.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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 declare const DEFAULT_DB_NAME = "optimystic.sqlite";
+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)`.
+ * - `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 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";
+/**
+ * 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 declare function applySchema(db: SqliteDb, version?: number): Promise<void>;
+/**
+ * Public handle returned by `openOptimysticNSDb`. Consumers pass it to
+ * `SqliteRawStorage`, `SqliteKVStore`, and `loadOrCreateNSPeerKey`.
+ */
+export type OptimysticNSDBHandle = SqliteDb;
+//# sourceMappingURL=db.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/db.js

@@ -0,0 +1,82 @@
+/**
+ * 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.
+ */
+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, version = DEFAULT_DB_VERSION) {
+    await db.exec(PRAGMAS_SQL);
+    await db.exec(SCHEMA_SQL);
+    await db.exec(`PRAGMA user_version = ${version}`);
+}
+//# sourceMappingURL=db.js.map

package/dist/src/db.js.map

@@ -0,0 +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"}

package/dist/src/identity.d.ts

@@ -0,0 +1,17 @@
+import type { PrivateKey } from '@libp2p/interface';
+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.
+ *
+ * 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 declare function loadOrCreateNSPeerKey(db: SqliteDb, keyName?: string): Promise<PrivateKey>;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/identity.js

@@ -0,0 +1,28 @@
+import { generateKeyPair, privateKeyFromProtobuf, privateKeyToProtobuf } from '@libp2p/crypto/keys';
+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, keyName = DEFAULT_PEER_KEY_NAME) {
+    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;
+}
+//# sourceMappingURL=identity.js.map

package/dist/src/identity.js.map

@@ -0,0 +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"}

package/dist/src/index.d.ts

@@ -0,0 +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 { 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

@@ -0,0 +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"}

package/dist/src/index.js

@@ -0,0 +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 { 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

@@ -0,0 +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"}

package/dist/src/logger.d.ts

@@ -0,0 +1,3 @@
+import debug from 'debug';
+export declare function createLogger(subNamespace: string): debug.Debugger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,CAEjE"}

package/dist/src/logger.js

@@ -0,0 +1,6 @@
+import debug from 'debug';
+const BASE_NAMESPACE = 'optimystic:db-p2p-storage-ns';
+export function createLogger(subNamespace) {
+    return debug(`${BASE_NAMESPACE}:${subNamespace}`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAEtD,MAAM,UAAU,YAAY,CAAC,YAAoB;IAChD,OAAO,KAAK,CAAC,GAAG,cAAc,IAAI,YAAY,EAAE,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,37 @@
+import { type OptimysticNSDBHandle, type SqliteDb } 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>;
+}
+/**
+ * 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 declare function openOptimysticNSDb(name?: string, version?: number): Promise<OptimysticNSDBHandle>;
+/**
+ * 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 declare function wrapNSPluginDb(raw: NSPluginDb): SqliteDb;
+export {};
+//# sourceMappingURL=ns-opener.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/ns-opener.js

@@ -0,0 +1,93 @@
+import { applySchema, 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
+ * 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 = DEFAULT_DB_NAME, version = DEFAULT_DB_VERSION) {
+    const plugin = (await import('@nativescript-community/sqlite'));
+    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) {
+    return new NSPluginDbWrapper(raw);
+}
+class NSPluginDbWrapper {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async exec(sql) {
+        // 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) {
+        return new NSPluginStatement(this.raw, sql);
+    }
+    async transaction(fn) {
+        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() {
+        await this.raw.close();
+    }
+}
+class NSPluginStatement {
+    raw;
+    sql;
+    constructor(raw, sql) {
+        this.raw = raw;
+        this.sql = sql;
+    }
+    async run(...params) {
+        await this.raw.execSQL(this.sql, params);
+    }
+    async get(...params) {
+        const row = await this.raw.get(this.sql, params);
+        if (row === null || row === undefined)
+            return undefined;
+        return row;
+    }
+    async all(...params) {
+        const rows = await this.raw.select(this.sql, params);
+        return rows;
+    }
+}
+//# sourceMappingURL=ns-opener.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ns-opener.js","sourceRoot":"","sources":["../../src/ns-opener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAoG,MAAM,SAAS,CAAC;AAmB7K;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,OAAe,eAAe,EAC9B,UAAkB,kBAAkB;IAEpC,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,gCAA0C,CAAC,CAA8B,CAAC;IACvG,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAe;IAC7C,OAAO,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,iBAAiB;IACO;IAA7B,YAA6B,GAAe;QAAf,QAAG,GAAH,GAAG,CAAY;IAAG,CAAC;IAEhD,KAAK,CAAC,IAAI,CAAC,GAAW;QACrB,oEAAoE;QACpE,+DAA+D;QAC/D,MAAM,UAAU,GAAG,GAAG;aACpB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAED,OAAO,CAAC,GAAW;QAClB,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,WAAW,CAAI,EAAoB;QACxC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACjC,OAAO,MAAM,CAAC;QACf,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACR,8DAA8D;YAC/D,CAAC;YACD,MAAM,GAAG,CAAC;QACX,CAAC;IACF,CAAC;IAED,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACD;AAED,MAAM,iBAAiB;IACO;IAAkC;IAA/D,YAA6B,GAAe,EAAmB,GAAW;QAA7C,QAAG,GAAH,GAAG,CAAY;QAAmB,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE9E,KAAK,CAAC,GAAG,CAAC,GAAG,MAAqB;QACjC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAG,MAAqB;QACjC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxD,OAAO,GAAgB,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAG,MAAqB;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO,IAAmB,CAAC;IAC5B,CAAC;CACD"}

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

@@ -0,0 +1,24 @@
+import type { IKVStore } from '@optimystic/db-p2p';
+import type { SqliteDb } 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 declare class SqliteKVStore implements IKVStore {
+    private readonly stmts;
+    private readonly prefix;
+    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[]>;
+}
+//# sourceMappingURL=sqlite-kv-store.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/sqlite-kv-store.js

@@ -0,0 +1,50 @@
+/**
+ * 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 {
+    stmts;
+    prefix;
+    constructor(db, prefix = '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) {
+        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, value) {
+        await this.stmts.set.run(this.prefix + key, value);
+    }
+    async delete(key) {
+        await this.stmts.delete.run(this.prefix + key);
+    }
+    async list(prefix) {
+        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.slice(this.prefix.length));
+    }
+}
+//# sourceMappingURL=sqlite-kv-store.js.map

package/dist/src/sqlite-kv-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-kv-store.js","sourceRoot":"","sources":["../../src/sqlite-kv-store.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IACR,KAAK,CAKpB;IACe,MAAM,CAAS;IAEhC,YAAY,EAAY,EAAE,SAAiB,iBAAiB;QAC3D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG;YACZ,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC;YACrD,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,8GAA8G,CAAC;YAC/H,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,8BAA8B,CAAC;YAClD,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,gEAAgE,CAAC;SAClF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACpB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QACnC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACvB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACxB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACxC,8EAA8E;QAC9E,0EAA0E;QAC1E,2EAA2E;QAC3E,4EAA4E;QAC5E,+EAA+E;QAC/E,MAAM,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAE,GAAG,CAAC,GAAc,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC;CACD"}