@optimystic/db-p2p-storage-rn 0.14.1 → 0.16.2

package/README.md

@@ -0,0 +1,65 @@
+# @optimystic/db-p2p-storage-rn
+
+React Native LevelDB storage backend for `@optimystic/db-p2p`. Lets a React
+Native peer persist Optimystic block data across app restarts using an
+on-device LevelDB. Provides:
+
+- **`LevelDBRawStorage`** — implements `IRawStorage` so an RN node persists
+  block metadata, revisions, pending transactions, committed transactions,
+  and materialized blocks.
+- **`LevelDBKVStore`** — implements `IKVStore` for the persistent
+  transaction state used to recover crashed two-phase commits.
+- **`loadOrCreateRNPeerKey`** — generates an Ed25519 libp2p private key on
+  first run and persists it in the same LevelDB, giving the RN peer a
+  stable, restart-surviving identity.
+- **`openOptimysticRNDb` / `wrapRNLevelDB`** — open/wrap helpers that adapt
+  the native `rn-leveldb` handle to the internal key/value interface.
+
+## Peer dependency
+
+The native store is [`rn-leveldb`](https://www.npmjs.com/package/rn-leveldb),
+declared as a **peer dependency** — the host app installs and pins the
+version it needs (same approach as `@nativescript-community/sqlite` for the
+`-storage-ns` package). This package never imports `rn-leveldb` directly;
+the caller passes the `LevelDB` constructor (wrapped as an open function) in,
+which keeps the package's unit tests runnable under plain Node (the tests use
+`classic-level` as a Node LevelDB surrogate).
+
+## Usage
+
+```ts
+import { createLibp2pNode } from '@optimystic/db-p2p/rn';
+import {
+  openOptimysticRNDb,
+  LevelDBRawStorage,
+  LevelDBKVStore,
+  loadOrCreateRNPeerKey,
+} from '@optimystic/db-p2p-storage-rn';
+import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+
+const db = openOptimysticRNDb({
+  openFn: (name, createIfMissing, errorIfExists) =>
+    new LevelDB(name, createIfMissing, errorIfExists),
+  WriteBatch: LevelDBWriteBatch,
+});
+const rawStorage = new LevelDBRawStorage(db);   // → IRawStorage
+const kvStore = new LevelDBKVStore(db);         // → IKVStore (txn recovery)
+const privateKey = await loadOrCreateRNPeerKey(db);
+
+const libp2p = await createLibp2pNode({
+  bootstrapNodes: [/* … */],
+  networkName: 'my-network',
+  privateKey,
+});
+```
+
+Use the Node-free `/rn` entry point of `@optimystic/db-p2p` so the Node-only
+TCP transport doesn't get bundled into the React Native app.
+
+## Related packages
+
+- **[@optimystic/db-p2p](../db-p2p)** — the distributed layer this backend
+  plugs into (repo/cluster/coordination + storage interfaces).
+- `@optimystic/db-p2p-storage-fs` — Node filesystem backend.
+- `@optimystic/db-p2p-storage-ns` — NativeScript (SQLite) backend.
+- `@optimystic/db-p2p-storage-web` — Browser (IndexedDB) backend.

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export { LevelDBRawStorage } from './leveldb-storage.js';
+export { LevelDBRawStorage, LevelDBStoreDriver } from './leveldb-storage.js';
 export { LevelDBKVStore } from './leveldb-kv-store.js';
 export { loadOrCreateRNPeerKey, DEFAULT_PEER_KEY_NAME } from './identity.js';
 export { openOptimysticRNDb, wrapRNLevelDB, DEFAULT_DB_NAME, type OpenOptimysticRNDbOptions, type RNLevelDBNative, type RNLevelDBWriteBatchNative, type RNLevelDBIteratorNative, type RNLevelDBWriteBatchCtor, type RNLevelDBOpenFn, } from './rn-opener.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/src/index.js

@@ -1,4 +1,4 @@
-export { LevelDBRawStorage } from './leveldb-storage.js';
+export { LevelDBRawStorage, LevelDBStoreDriver } from './leveldb-storage.js';
 export { LevelDBKVStore } from './leveldb-kv-store.js';
 export { loadOrCreateRNPeerKey, DEFAULT_PEER_KEY_NAME } from './identity.js';
 export { openOptimysticRNDb, wrapRNLevelDB, DEFAULT_DB_NAME, } from './rn-opener.js';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,aAAa,EACb,eAAe,GAOf,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACN,kBAAkB,EAClB,aAAa,EACb,eAAe,GAOf,MAAM,gBAAgB,CAAC"}

package/dist/src/keys.d.ts

@@ -30,6 +30,20 @@ export declare const TAG_MATERIALIZED = 5;
 export declare const TAG_KV = 16;
 export declare const TAG_IDENTITY = 32;
 export declare function metadataKey(blockId: string): Uint8Array;
+/**
+ * Returns the inclusive lower / exclusive upper range covering every metadata
+ * key. Metadata keys are `TAG_METADATA || len(blockId) || blockId` with an empty
+ * suffix, so every metadata key sorts in `[TAG_METADATA, TAG_METADATA+1)`. The
+ * tag bytes are deliberately spaced (0x01, 0x02, ...) so `TAG_METADATA + 1` is
+ * the next tag byte and a clean exclusive upper bound — a revision / pending /
+ * transaction key for the same block (higher tag) falls outside this range.
+ */
+export declare function metadataRange(): {
+    gte: Uint8Array;
+    lt: Uint8Array;
+};
+/** Decode the `blockId` from a `metadataKey`-encoded key (empty suffix). */
+export declare function blockIdFromMetadataKey(key: Uint8Array): string;
 export declare function revisionKey(blockId: string, rev: number): Uint8Array;
 /** Decode the trailing 8-byte big-endian rev from a `revisionKey`-encoded key. */
 export declare function revisionFromKey(key: Uint8Array): number;

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

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,YAAY,IAAO,CAAC;AACjC,eAAO,MAAM,aAAa,IAAO,CAAC;AAClC,eAAO,MAAM,WAAW,IAAO,CAAC;AAChC,eAAO,MAAM,gBAAgB,IAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,IAAO,CAAC;AACrC,eAAO,MAAM,MAAM,KAAO,CAAC;AAC3B,eAAO,MAAM,YAAY,KAAO,CAAC;AA0BjC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAMpE;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAGvD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAExE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAE5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAE7E;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAapG;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAE7C;AAED,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAcjF;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEvD"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,YAAY,IAAO,CAAC;AACjC,eAAO,MAAM,aAAa,IAAO,CAAC;AAClC,eAAO,MAAM,WAAW,IAAO,CAAC;AAChC,eAAO,MAAM,gBAAgB,IAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,IAAO,CAAC;AACrC,eAAO,MAAM,MAAM,KAAO,CAAC;AAC3B,eAAO,MAAM,YAAY,KAAO,CAAC;AA0BjC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAEnE;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAI9D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAMpE;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAGvD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAExE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAE5E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAE7E;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAapG;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAE7C;AAED,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAcjF;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEvD"}

package/dist/src/keys.js

@@ -54,6 +54,23 @@ function concat(...parts) {
 export function metadataKey(blockId) {
     return encodeBlockEnvelope(TAG_METADATA, blockId);
 }
+/**
+ * Returns the inclusive lower / exclusive upper range covering every metadata
+ * key. Metadata keys are `TAG_METADATA || len(blockId) || blockId` with an empty
+ * suffix, so every metadata key sorts in `[TAG_METADATA, TAG_METADATA+1)`. The
+ * tag bytes are deliberately spaced (0x01, 0x02, ...) so `TAG_METADATA + 1` is
+ * the next tag byte and a clean exclusive upper bound — a revision / pending /
+ * transaction key for the same block (higher tag) falls outside this range.
+ */
+export function metadataRange() {
+    return { gte: Uint8Array.of(TAG_METADATA), lt: Uint8Array.of(TAG_METADATA + 1) };
+}
+/** Decode the `blockId` from a `metadataKey`-encoded key (empty suffix). */
+export function blockIdFromMetadataKey(key) {
+    const view = new DataView(key.buffer, key.byteOffset, key.byteLength);
+    const blockIdLen = view.getUint32(1, false);
+    return textDecoder.decode(key.subarray(5, 5 + blockIdLen));
+}
 export function revisionKey(blockId, rev) {
     const envelope = encodeBlockEnvelope(TAG_REVISIONS, blockId);
     const out = new Uint8Array(envelope.length + 8);

package/dist/src/keys.js.map

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

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

@@ -1,35 +1,56 @@
-import type { ActionId, ActionRev, BlockId, IBlock, Transform } from '@optimystic/db-core';
-import type { BlockMetadata, IRawStorage } from '@optimystic/db-p2p';
+import type { ActionId, BlockId } from '@optimystic/db-core';
+import { KvRawStorage, type RawStoreDriver } from '@optimystic/db-p2p';
 import { type LevelDBLike } from './leveldb-like.js';
 /**
- * LevelDB-backed `IRawStorage` implementation for React Native peers.
+ * LevelDB {@link RawStoreDriver}: the five logical block-storage stores mapped
+ * into a single ordered byte keyspace, partitioned by a leading tag byte (see
+ * `./keys.ts`). LevelDB is already one ordered byte-keyspace, so this driver is
+ * mostly key encoding — the tag-prefixed byte scheme in `keys.ts` stays in this
+ * package; the kernel deals in logical keys.
  *
- * All data lives in a single LevelDB database; per-store partitioning is by a
- * leading tag byte (see `./keys.ts`). `listRevisions` and
- * `listPendingTransactions` use range iterators with explicit bounds, drained
- * into an array before yielding (same rationale as the IndexedDB / SQLite
- * backends — a native iterator must not stay open across consumer awaits).
- *
- * `promotePendingTransaction` runs as a single `WriteBatch`, making the
- * pending → committed move atomic against crashes.
+ * `KvRawStorage` now owns all JSON/UTF-8 serialization, so this driver only ever
+ * reads/writes raw `Uint8Array` values — no `TextEncoder`/`TextDecoder` for
+ * values, and no `JSON.parse`/`stringify`. A value round-trips as the exact bytes
+ * the kernel wrote. Everything LevelDB-specific stays here: the tag-range scans
+ * (drained snapshot-first before yielding, so a native iterator never straddles a
+ * consumer's `await`), and the single `WriteBatch` that makes `promote` atomic.
  */
-export declare class LevelDBRawStorage implements IRawStorage {
+export declare class LevelDBStoreDriver implements RawStoreDriver {
     private readonly db;
     constructor(db: LevelDBLike);
-    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>;
+    getMetadata(blockId: BlockId): Promise<Uint8Array | undefined>;
+    putMetadata(blockId: BlockId, value: Uint8Array): Promise<void>;
+    getRevision(blockId: BlockId, rev: number): Promise<Uint8Array | undefined>;
+    putRevision(blockId: BlockId, rev: number, value: Uint8Array): Promise<void>;
+    rangeRevisions(blockId: BlockId, lo: number, hi: number, reverse: boolean): AsyncIterable<[number, Uint8Array]>;
+    getPending(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putPending(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    deletePending(blockId: BlockId, actionId: ActionId): Promise<void>;
+    listPendingActionIds(blockId: BlockId): AsyncIterable<ActionId>;
+    getTransaction(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putTransaction(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    getMaterialized(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined>;
+    putMaterialized(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void>;
+    deleteMaterialized(blockId: BlockId, actionId: ActionId): Promise<void>;
+    promote(blockId: BlockId, actionId: ActionId): Promise<void>;
+    listBlockIds(): AsyncIterable<BlockId>;
+    approximateBytesUsed(): Promise<number>;
+}
+/**
+ * LevelDB-backed {@link IRawStorage} for React Native peers, now a thin shell
+ * over the shared {@link KvRawStorage} kernel driven by a {@link LevelDBStoreDriver}.
+ * The public name/constructor (`new LevelDBRawStorage(db)`) is unchanged so
+ * existing imports keep resolving; the kernel supplies the `IRawStorage` surface
+ * and the driver supplies LevelDB behavior.
+ *
+ * `listBlockIds`/`getApproximateBytesUsed` are re-declared here as always-present
+ * (the LevelDB driver always implements them, so the kernel constructor always
+ * wires them) — the base declares them optional, but every RN consumer relies on
+ * them.
+ */
+export declare class LevelDBRawStorage extends KvRawStorage {
+    listBlockIds: () => AsyncIterable<BlockId>;
+    getApproximateBytesUsed: () => Promise<number>;
+    constructor(db: LevelDBLike);
 }
 //# sourceMappingURL=leveldb-storage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"leveldb-storage.d.ts","sourceRoot":"","sources":["../../src/leveldb-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,EAAS,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmB5D;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,WAAW;IAEtC,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;IAMzE,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;IAkB5F,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;IAQnE,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;IAS1F,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAoB1C,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAapF"}
+{"version":3,"file":"leveldb-storage.d.ts","sourceRoot":"","sources":["../../src/leveldb-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkB5D;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,WAAW;IAItC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAI9D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAI3E,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAgBhH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIjF,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC;IAWhE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIrF,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAItF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvF,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3D,YAAY,IAAI,aAAa,CAAC,OAAO,CAAC;IAgBvC,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;CAyB7C;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC1C,YAAY,EAAE,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,uBAAuB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;gBAE3C,EAAE,EAAE,WAAW;CAG3B"}

package/dist/src/leveldb-storage.js

@@ -1,105 +1,124 @@
+import { KvRawStorage } from '@optimystic/db-p2p';
 import { drain } from './leveldb-like.js';
-import { TAG_PENDING, actionIdFromKey, blockEnvelopeRange, materializedKey, metadataKey, pendingKey, revisionFromKey, revisionKey, transactionKey, } from './keys.js';
+import { TAG_PENDING, actionIdFromKey, blockEnvelopeRange, blockIdFromMetadataKey, materializedKey, metadataKey, metadataRange, pendingKey, revisionFromKey, revisionKey, transactionKey, } from './keys.js';
 import { createLogger } from './logger.js';
 const log = createLogger('storage:leveldb');
-const textEncoder = new TextEncoder();
-const textDecoder = new TextDecoder();
 /**
- * LevelDB-backed `IRawStorage` implementation for React Native peers.
+ * LevelDB {@link RawStoreDriver}: the five logical block-storage stores mapped
+ * into a single ordered byte keyspace, partitioned by a leading tag byte (see
+ * `./keys.ts`). LevelDB is already one ordered byte-keyspace, so this driver is
+ * mostly key encoding — the tag-prefixed byte scheme in `keys.ts` stays in this
+ * package; the kernel deals in logical keys.
  *
- * All data lives in a single LevelDB database; per-store partitioning is by a
- * leading tag byte (see `./keys.ts`). `listRevisions` and
- * `listPendingTransactions` use range iterators with explicit bounds, drained
- * into an array before yielding (same rationale as the IndexedDB / SQLite
- * backends — a native iterator must not stay open across consumer awaits).
- *
- * `promotePendingTransaction` runs as a single `WriteBatch`, making the
- * pending → committed move atomic against crashes.
+ * `KvRawStorage` now owns all JSON/UTF-8 serialization, so this driver only ever
+ * reads/writes raw `Uint8Array` values — no `TextEncoder`/`TextDecoder` for
+ * values, and no `JSON.parse`/`stringify`. A value round-trips as the exact bytes
+ * the kernel wrote. Everything LevelDB-specific stays here: the tag-range scans
+ * (drained snapshot-first before yielding, so a native iterator never straddles a
+ * consumer's `await`), and the single `WriteBatch` that makes `promote` atomic.
  */
-export class LevelDBRawStorage {
+export class LevelDBStoreDriver {
     db;
     constructor(db) {
         this.db = db;
     }
+    // --- metadata ---
     async getMetadata(blockId) {
-        const bytes = await this.db.get(metadataKey(blockId));
-        if (!bytes)
-            return undefined;
-        return JSON.parse(textDecoder.decode(bytes));
+        return this.db.get(metadataKey(blockId));
     }
-    async saveMetadata(blockId, metadata) {
-        await this.db.put(metadataKey(blockId), textEncoder.encode(JSON.stringify(metadata)));
+    async putMetadata(blockId, value) {
+        await this.db.put(metadataKey(blockId), value);
     }
+    // --- revisions ---
     async getRevision(blockId, rev) {
-        const bytes = await this.db.get(revisionKey(blockId, rev));
-        if (!bytes)
-            return undefined;
-        return textDecoder.decode(bytes);
-    }
-    async saveRevision(blockId, rev, actionId) {
-        await this.db.put(revisionKey(blockId, rev), textEncoder.encode(actionId));
-    }
-    async *listRevisions(blockId, startRev, endRev) {
-        const ascending = startRev <= endRev;
-        const lo = ascending ? startRev : endRev;
-        const hi = ascending ? endRev : startRev;
-        // `revisionKey(blockId, hi)` is exactly the inclusive upper bound; LevelDB
-        // uses exclusive `lt`, so request `lte` via `lt = key(hi)+0x01` would
-        // require an extra byte. Easier: use `lt = revisionKey(blockId, hi+1)`.
+        return this.db.get(revisionKey(blockId, rev));
+    }
+    async putRevision(blockId, rev, value) {
+        await this.db.put(revisionKey(blockId, rev), value);
+    }
+    async *rangeRevisions(blockId, lo, hi, reverse) {
+        // Revs are encoded 8-byte big-endian (`revisionKey`), so byte order == numeric
+        // order and `revisionKey(blockId, hi)` is exactly the inclusive upper bound;
+        // LevelDB's upper bound is exclusive (`lt`), so use `lt = revisionKey(hi + 1)`.
         const gte = revisionKey(blockId, lo);
         const lt = revisionKey(blockId, hi + 1);
-        const entries = await drain(this.db.iterator({ gte, lt, reverse: !ascending }));
+        // Drain before yielding — a native LevelDB iterator must not stay open across
+        // the consumer's awaits (the kernel's drain-before-yield contract).
+        const entries = await drain(this.db.iterator({ gte, lt, reverse }));
         for (const [key, value] of entries) {
-            yield {
-                rev: revisionFromKey(key),
-                actionId: textDecoder.decode(value),
-            };
+            yield [revisionFromKey(key), value];
         }
     }
-    async getPendingTransaction(blockId, actionId) {
-        const bytes = await this.db.get(pendingKey(blockId, actionId));
-        if (!bytes)
-            return undefined;
-        return JSON.parse(textDecoder.decode(bytes));
+    // --- pending ---
+    async getPending(blockId, actionId) {
+        return this.db.get(pendingKey(blockId, actionId));
     }
-    async savePendingTransaction(blockId, actionId, transform) {
-        await this.db.put(pendingKey(blockId, actionId), textEncoder.encode(JSON.stringify(transform)));
+    async putPending(blockId, actionId, value) {
+        await this.db.put(pendingKey(blockId, actionId), value);
     }
-    async deletePendingTransaction(blockId, actionId) {
+    async deletePending(blockId, actionId) {
         await this.db.delete(pendingKey(blockId, actionId));
     }
-    async *listPendingTransactions(blockId) {
+    async *listPendingActionIds(blockId) {
         const range = blockEnvelopeRange(TAG_PENDING, blockId);
+        // Drain before yielding, same rationale as rangeRevisions.
         const entries = await drain(this.db.iterator({ gte: range.gte, lt: range.lt, keys: true }));
         for (const [key] of entries) {
             yield actionIdFromKey(key, blockId);
         }
     }
+    // --- transactions ---
     async getTransaction(blockId, actionId) {
-        const bytes = await this.db.get(transactionKey(blockId, actionId));
-        if (!bytes)
-            return undefined;
-        return JSON.parse(textDecoder.decode(bytes));
-    }
-    async saveTransaction(blockId, actionId, transform) {
-        await this.db.put(transactionKey(blockId, actionId), textEncoder.encode(JSON.stringify(transform)));
-    }
-    async getMaterializedBlock(blockId, actionId) {
-        const bytes = await this.db.get(materializedKey(blockId, actionId));
-        if (!bytes)
-            return undefined;
-        return JSON.parse(textDecoder.decode(bytes));
-    }
-    async saveMaterializedBlock(blockId, actionId, block) {
-        const key = materializedKey(blockId, actionId);
-        if (block) {
-            await this.db.put(key, textEncoder.encode(JSON.stringify(block)));
+        return this.db.get(transactionKey(blockId, actionId));
+    }
+    async putTransaction(blockId, actionId, value) {
+        await this.db.put(transactionKey(blockId, actionId), value);
+    }
+    // --- materialized ---
+    async getMaterialized(blockId, actionId) {
+        return this.db.get(materializedKey(blockId, actionId));
+    }
+    async putMaterialized(blockId, actionId, value) {
+        await this.db.put(materializedKey(blockId, actionId), value);
+    }
+    // The kernel owns the put-or-delete branch of `saveMaterializedBlock`, so the
+    // driver exposes delete as a separate op.
+    async deleteMaterialized(blockId, actionId) {
+        await this.db.delete(materializedKey(blockId, actionId));
+    }
+    // --- promote (the only cross-key atomic op) ---
+    async promote(blockId, actionId) {
+        const pKey = pendingKey(blockId, actionId);
+        const value = await this.db.get(pKey);
+        if (!value) {
+            throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
         }
-        else {
-            await this.db.delete(key);
+        // The single `WriteBatch` IS the atomic move: a crash leaves either the
+        // pending or the committed entry, never both/neither.
+        const tKey = transactionKey(blockId, actionId);
+        await this.db
+            .batch()
+            .put(tKey, value)
+            .delete(pKey)
+            .write();
+    }
+    // --- optional passthroughs ---
+    async *listBlockIds() {
+        // Scan the whole TAG_METADATA keyspace; each metadata key is one distinct
+        // block id (empty suffix). keys:true skips values — we only need the ids.
+        // Drained before yielding (same discipline as the range scans): a native
+        // iterator must not stay open across consumer awaits.
+        const range = metadataRange();
+        const entries = await drain(this.db.iterator({ gte: range.gte, lt: range.lt, keys: true }));
+        for (const [key] of entries) {
+            yield blockIdFromMetadataKey(key);
         }
     }
-    async getApproximateBytesUsed() {
+    // NOTE: full-scan byte sum — O(total bytes) per call. Fine as an advisory
+    // StorageMonitor input at current sizes; if a StorageMonitor ever polls this
+    // on a large db, replace with the kernel's incremental write-path counter
+    // (see the seam NOTE in kv-raw-storage.ts's saveMetadata).
+    async approximateBytesUsed() {
         try {
             let total = 0;
             const iter = this.db.iterator();
@@ -117,22 +136,26 @@ export class LevelDBRawStorage {
             return total;
         }
         catch (err) {
-            log('getApproximateBytesUsed iterator failed: %o', err);
+            log('approximateBytesUsed iterator failed: %o', err);
             return 0;
         }
     }
-    async promotePendingTransaction(blockId, actionId) {
-        const pKey = pendingKey(blockId, actionId);
-        const value = await this.db.get(pKey);
-        if (!value) {
-            throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
-        }
-        const tKey = transactionKey(blockId, actionId);
-        await this.db
-            .batch()
-            .put(tKey, value)
-            .delete(pKey)
-            .write();
+}
+/**
+ * LevelDB-backed {@link IRawStorage} for React Native peers, now a thin shell
+ * over the shared {@link KvRawStorage} kernel driven by a {@link LevelDBStoreDriver}.
+ * The public name/constructor (`new LevelDBRawStorage(db)`) is unchanged so
+ * existing imports keep resolving; the kernel supplies the `IRawStorage` surface
+ * and the driver supplies LevelDB behavior.
+ *
+ * `listBlockIds`/`getApproximateBytesUsed` are re-declared here as always-present
+ * (the LevelDB driver always implements them, so the kernel constructor always
+ * wires them) — the base declares them optional, but every RN consumer relies on
+ * them.
+ */
+export class LevelDBRawStorage extends KvRawStorage {
+    constructor(db) {
+        super(new LevelDBStoreDriver(db));
     }
 }
 //# sourceMappingURL=leveldb-storage.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optimystic/db-p2p-storage-rn",
-  "version": "0.14.1",
+  "version": "0.16.2",
   "type": "module",
   "description": "React Native LevelDB storage backend for @optimystic/db-p2p",
   "main": "dist/src/index.js",
@@ -54,8 +54,8 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@optimystic/db-core": "^0.14.1",
-    "@optimystic/db-p2p": "^0.14.1",
+    "@optimystic/db-core": "^0.16.2",
+    "@optimystic/db-p2p": "^0.16.2",
     "debug": "^4.4.3"
   },
   "peerDependencies": {

package/src/index.ts

@@ -1,4 +1,4 @@
-export { LevelDBRawStorage } from './leveldb-storage.js';
+export { LevelDBRawStorage, LevelDBStoreDriver } from './leveldb-storage.js';
 export { LevelDBKVStore } from './leveldb-kv-store.js';
 export { loadOrCreateRNPeerKey, DEFAULT_PEER_KEY_NAME } from './identity.js';
 export {

package/src/keys.ts

@@ -59,6 +59,25 @@ export function metadataKey(blockId: string): Uint8Array {
 	return encodeBlockEnvelope(TAG_METADATA, blockId);
 }
 
+/**
+ * Returns the inclusive lower / exclusive upper range covering every metadata
+ * key. Metadata keys are `TAG_METADATA || len(blockId) || blockId` with an empty
+ * suffix, so every metadata key sorts in `[TAG_METADATA, TAG_METADATA+1)`. The
+ * tag bytes are deliberately spaced (0x01, 0x02, ...) so `TAG_METADATA + 1` is
+ * the next tag byte and a clean exclusive upper bound — a revision / pending /
+ * transaction key for the same block (higher tag) falls outside this range.
+ */
+export function metadataRange(): { gte: Uint8Array; lt: Uint8Array } {
+	return { gte: Uint8Array.of(TAG_METADATA), lt: Uint8Array.of(TAG_METADATA + 1) };
+}
+
+/** Decode the `blockId` from a `metadataKey`-encoded key (empty suffix). */
+export function blockIdFromMetadataKey(key: Uint8Array): string {
+	const view = new DataView(key.buffer, key.byteOffset, key.byteLength);
+	const blockIdLen = view.getUint32(1, false);
+	return textDecoder.decode(key.subarray(5, 5 + blockIdLen));
+}
+
 export function revisionKey(blockId: string, rev: number): Uint8Array {
 	const envelope = encodeBlockEnvelope(TAG_REVISIONS, blockId);
 	const out = new Uint8Array(envelope.length + 8);

package/src/leveldb-storage.ts

@@ -1,12 +1,14 @@
-import type { ActionId, ActionRev, BlockId, IBlock, Transform } from '@optimystic/db-core';
-import type { BlockMetadata, IRawStorage } from '@optimystic/db-p2p';
+import type { ActionId, BlockId } from '@optimystic/db-core';
+import { KvRawStorage, type RawStoreDriver } from '@optimystic/db-p2p';
 import { drain, type LevelDBLike } from './leveldb-like.js';
 import {
 	TAG_PENDING,
 	actionIdFromKey,
 	blockEnvelopeRange,
+	blockIdFromMetadataKey,
 	materializedKey,
 	metadataKey,
+	metadataRange,
 	pendingKey,
 	revisionFromKey,
 	revisionKey,
@@ -16,110 +18,143 @@ import { createLogger } from './logger.js';
 
 const log = createLogger('storage:leveldb');
 
-const textEncoder = new TextEncoder();
-const textDecoder = new TextDecoder();
-
 /**
- * LevelDB-backed `IRawStorage` implementation for React Native peers.
- *
- * All data lives in a single LevelDB database; per-store partitioning is by a
- * leading tag byte (see `./keys.ts`). `listRevisions` and
- * `listPendingTransactions` use range iterators with explicit bounds, drained
- * into an array before yielding (same rationale as the IndexedDB / SQLite
- * backends — a native iterator must not stay open across consumer awaits).
+ * LevelDB {@link RawStoreDriver}: the five logical block-storage stores mapped
+ * into a single ordered byte keyspace, partitioned by a leading tag byte (see
+ * `./keys.ts`). LevelDB is already one ordered byte-keyspace, so this driver is
+ * mostly key encoding — the tag-prefixed byte scheme in `keys.ts` stays in this
+ * package; the kernel deals in logical keys.
  *
- * `promotePendingTransaction` runs as a single `WriteBatch`, making the
- * pending → committed move atomic against crashes.
+ * `KvRawStorage` now owns all JSON/UTF-8 serialization, so this driver only ever
+ * reads/writes raw `Uint8Array` values — no `TextEncoder`/`TextDecoder` for
+ * values, and no `JSON.parse`/`stringify`. A value round-trips as the exact bytes
+ * the kernel wrote. Everything LevelDB-specific stays here: the tag-range scans
+ * (drained snapshot-first before yielding, so a native iterator never straddles a
+ * consumer's `await`), and the single `WriteBatch` that makes `promote` atomic.
  */
-export class LevelDBRawStorage implements IRawStorage {
+export class LevelDBStoreDriver implements RawStoreDriver {
 	constructor(private readonly db: LevelDBLike) {}
 
-	async getMetadata(blockId: BlockId): Promise<BlockMetadata | undefined> {
-		const bytes = await this.db.get(metadataKey(blockId));
-		if (!bytes) return undefined;
-		return JSON.parse(textDecoder.decode(bytes)) as BlockMetadata;
+	// --- metadata ---
+
+	async getMetadata(blockId: BlockId): Promise<Uint8Array | undefined> {
+		return this.db.get(metadataKey(blockId));
 	}
 
-	async saveMetadata(blockId: BlockId, metadata: BlockMetadata): Promise<void> {
-		await this.db.put(metadataKey(blockId), textEncoder.encode(JSON.stringify(metadata)));
+	async putMetadata(blockId: BlockId, value: Uint8Array): Promise<void> {
+		await this.db.put(metadataKey(blockId), value);
 	}
 
-	async getRevision(blockId: BlockId, rev: number): Promise<ActionId | undefined> {
-		const bytes = await this.db.get(revisionKey(blockId, rev));
-		if (!bytes) return undefined;
-		return textDecoder.decode(bytes) as ActionId;
+	// --- revisions ---
+
+	async getRevision(blockId: BlockId, rev: number): Promise<Uint8Array | undefined> {
+		return this.db.get(revisionKey(blockId, rev));
 	}
 
-	async saveRevision(blockId: BlockId, rev: number, actionId: ActionId): Promise<void> {
-		await this.db.put(revisionKey(blockId, rev), textEncoder.encode(actionId));
+	async putRevision(blockId: BlockId, rev: number, value: Uint8Array): Promise<void> {
+		await this.db.put(revisionKey(blockId, rev), value);
 	}
 
-	async *listRevisions(blockId: BlockId, startRev: number, endRev: number): AsyncIterable<ActionRev> {
-		const ascending = startRev <= endRev;
-		const lo = ascending ? startRev : endRev;
-		const hi = ascending ? endRev : startRev;
-		// `revisionKey(blockId, hi)` is exactly the inclusive upper bound; LevelDB
-		// uses exclusive `lt`, so request `lte` via `lt = key(hi)+0x01` would
-		// require an extra byte. Easier: use `lt = revisionKey(blockId, hi+1)`.
+	async *rangeRevisions(blockId: BlockId, lo: number, hi: number, reverse: boolean): AsyncIterable<[number, Uint8Array]> {
+		// Revs are encoded 8-byte big-endian (`revisionKey`), so byte order == numeric
+		// order and `revisionKey(blockId, hi)` is exactly the inclusive upper bound;
+		// LevelDB's upper bound is exclusive (`lt`), so use `lt = revisionKey(hi + 1)`.
 		const gte = revisionKey(blockId, lo);
 		const lt = revisionKey(blockId, hi + 1);
-		const entries = await drain(this.db.iterator({ gte, lt, reverse: !ascending }));
+		// Drain before yielding — a native LevelDB iterator must not stay open across
+		// the consumer's awaits (the kernel's drain-before-yield contract).
+		const entries = await drain(this.db.iterator({ gte, lt, reverse }));
 		for (const [key, value] of entries) {
-			yield {
-				rev: revisionFromKey(key),
-				actionId: textDecoder.decode(value) as ActionId,
-			};
+			yield [revisionFromKey(key), value];
 		}
 	}
 
-	async getPendingTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined> {
-		const bytes = await this.db.get(pendingKey(blockId, actionId));
-		if (!bytes) return undefined;
-		return JSON.parse(textDecoder.decode(bytes)) as Transform;
+	// --- pending ---
+
+	async getPending(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined> {
+		return this.db.get(pendingKey(blockId, actionId));
 	}
 
-	async savePendingTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void> {
-		await this.db.put(pendingKey(blockId, actionId), textEncoder.encode(JSON.stringify(transform)));
+	async putPending(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void> {
+		await this.db.put(pendingKey(blockId, actionId), value);
 	}
 
-	async deletePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void> {
+	async deletePending(blockId: BlockId, actionId: ActionId): Promise<void> {
 		await this.db.delete(pendingKey(blockId, actionId));
 	}
 
-	async *listPendingTransactions(blockId: BlockId): AsyncIterable<ActionId> {
+	async *listPendingActionIds(blockId: BlockId): AsyncIterable<ActionId> {
 		const range = blockEnvelopeRange(TAG_PENDING, blockId);
+		// Drain before yielding, same rationale as rangeRevisions.
 		const entries = await drain(this.db.iterator({ gte: range.gte, lt: range.lt, keys: true }));
 		for (const [key] of entries) {
 			yield actionIdFromKey(key, blockId) as ActionId;
 		}
 	}
 
-	async getTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined> {
-		const bytes = await this.db.get(transactionKey(blockId, actionId));
-		if (!bytes) return undefined;
-		return JSON.parse(textDecoder.decode(bytes)) as Transform;
+	// --- transactions ---
+
+	async getTransaction(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined> {
+		return this.db.get(transactionKey(blockId, actionId));
+	}
+
+	async putTransaction(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void> {
+		await this.db.put(transactionKey(blockId, actionId), value);
+	}
+
+	// --- materialized ---
+
+	async getMaterialized(blockId: BlockId, actionId: ActionId): Promise<Uint8Array | undefined> {
+		return this.db.get(materializedKey(blockId, actionId));
 	}
 
-	async saveTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void> {
-		await this.db.put(transactionKey(blockId, actionId), textEncoder.encode(JSON.stringify(transform)));
+	async putMaterialized(blockId: BlockId, actionId: ActionId, value: Uint8Array): Promise<void> {
+		await this.db.put(materializedKey(blockId, actionId), value);
 	}
 
-	async getMaterializedBlock(blockId: BlockId, actionId: ActionId): Promise<IBlock | undefined> {
-		const bytes = await this.db.get(materializedKey(blockId, actionId));
-		if (!bytes) return undefined;
-		return JSON.parse(textDecoder.decode(bytes)) as IBlock;
+	// The kernel owns the put-or-delete branch of `saveMaterializedBlock`, so the
+	// driver exposes delete as a separate op.
+	async deleteMaterialized(blockId: BlockId, actionId: ActionId): Promise<void> {
+		await this.db.delete(materializedKey(blockId, actionId));
 	}
 
-	async saveMaterializedBlock(blockId: BlockId, actionId: ActionId, block?: IBlock): Promise<void> {
-		const key = materializedKey(blockId, actionId);
-		if (block) {
-			await this.db.put(key, textEncoder.encode(JSON.stringify(block)));
-		} else {
-			await this.db.delete(key);
+	// --- promote (the only cross-key atomic op) ---
+
+	async promote(blockId: BlockId, actionId: ActionId): Promise<void> {
+		const pKey = pendingKey(blockId, actionId);
+		const value = await this.db.get(pKey);
+		if (!value) {
+			throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
 		}
+		// The single `WriteBatch` IS the atomic move: a crash leaves either the
+		// pending or the committed entry, never both/neither.
+		const tKey = transactionKey(blockId, actionId);
+		await this.db
+			.batch()
+			.put(tKey, value)
+			.delete(pKey)
+			.write();
 	}
 
-	async getApproximateBytesUsed(): Promise<number> {
+	// --- optional passthroughs ---
+
+	async *listBlockIds(): AsyncIterable<BlockId> {
+		// Scan the whole TAG_METADATA keyspace; each metadata key is one distinct
+		// block id (empty suffix). keys:true skips values — we only need the ids.
+		// Drained before yielding (same discipline as the range scans): a native
+		// iterator must not stay open across consumer awaits.
+		const range = metadataRange();
+		const entries = await drain(this.db.iterator({ gte: range.gte, lt: range.lt, keys: true }));
+		for (const [key] of entries) {
+			yield blockIdFromMetadataKey(key) as BlockId;
+		}
+	}
+
+	// NOTE: full-scan byte sum — O(total bytes) per call. Fine as an advisory
+	// StorageMonitor input at current sizes; if a StorageMonitor ever polls this
+	// on a large db, replace with the kernel's incremental write-path counter
+	// (see the seam NOTE in kv-raw-storage.ts's saveMetadata).
+	async approximateBytesUsed(): Promise<number> {
 		try {
 			let total = 0;
 			const iter = this.db.iterator();
@@ -134,22 +169,35 @@ export class LevelDBRawStorage implements IRawStorage {
 			}
 			return total;
 		} catch (err) {
-			log('getApproximateBytesUsed iterator failed: %o', err);
+			log('approximateBytesUsed iterator failed: %o', err);
 			return 0;
 		}
 	}
 
-	async promotePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void> {
-		const pKey = pendingKey(blockId, actionId);
-		const value = await this.db.get(pKey);
-		if (!value) {
-			throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
-		}
-		const tKey = transactionKey(blockId, actionId);
-		await this.db
-			.batch()
-			.put(tKey, value)
-			.delete(pKey)
-			.write();
+	// NOTE: intentionally NO close(). The `LevelDBLike` handle is shared with
+	// `LevelDBKVStore` and `loadOrCreateRNPeerKey` (one db per RN peer — see the
+	// README usage), so the driver must not own its lifecycle; closing it here
+	// would break the other two. Same rationale as the IndexedDB driver. The
+	// kernel never wires the optional close() regardless.
+}
+
+/**
+ * LevelDB-backed {@link IRawStorage} for React Native peers, now a thin shell
+ * over the shared {@link KvRawStorage} kernel driven by a {@link LevelDBStoreDriver}.
+ * The public name/constructor (`new LevelDBRawStorage(db)`) is unchanged so
+ * existing imports keep resolving; the kernel supplies the `IRawStorage` surface
+ * and the driver supplies LevelDB behavior.
+ *
+ * `listBlockIds`/`getApproximateBytesUsed` are re-declared here as always-present
+ * (the LevelDB driver always implements them, so the kernel constructor always
+ * wires them) — the base declares them optional, but every RN consumer relies on
+ * them.
+ */
+export class LevelDBRawStorage extends KvRawStorage {
+	declare listBlockIds: () => AsyncIterable<BlockId>;
+	declare getApproximateBytesUsed: () => Promise<number>;
+
+	constructor(db: LevelDBLike) {
+		super(new LevelDBStoreDriver(db));
 	}
 }