@optimystic/db-p2p-storage-rn 0.13.0 → 0.13.5

package/dist/src/leveldb-storage.js

@@ -0,0 +1,138 @@
+import { drain } from './leveldb-like.js';
+import { TAG_PENDING, actionIdFromKey, blockEnvelopeRange, materializedKey, metadataKey, 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.
+ *
+ * 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.
+ */
+export class LevelDBRawStorage {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async getMetadata(blockId) {
+        const bytes = await this.db.get(metadataKey(blockId));
+        if (!bytes)
+            return undefined;
+        return JSON.parse(textDecoder.decode(bytes));
+    }
+    async saveMetadata(blockId, metadata) {
+        await this.db.put(metadataKey(blockId), textEncoder.encode(JSON.stringify(metadata)));
+    }
+    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)`.
+        const gte = revisionKey(blockId, lo);
+        const lt = revisionKey(blockId, hi + 1);
+        const entries = await drain(this.db.iterator({ gte, lt, reverse: !ascending }));
+        for (const [key, value] of entries) {
+            yield {
+                rev: revisionFromKey(key),
+                actionId: textDecoder.decode(value),
+            };
+        }
+    }
+    async getPendingTransaction(blockId, actionId) {
+        const bytes = await this.db.get(pendingKey(blockId, actionId));
+        if (!bytes)
+            return undefined;
+        return JSON.parse(textDecoder.decode(bytes));
+    }
+    async savePendingTransaction(blockId, actionId, transform) {
+        await this.db.put(pendingKey(blockId, actionId), textEncoder.encode(JSON.stringify(transform)));
+    }
+    async deletePendingTransaction(blockId, actionId) {
+        await this.db.delete(pendingKey(blockId, actionId));
+    }
+    async *listPendingTransactions(blockId) {
+        const range = blockEnvelopeRange(TAG_PENDING, blockId);
+        const entries = await drain(this.db.iterator({ gte: range.gte, lt: range.lt, keys: true }));
+        for (const [key] of entries) {
+            yield actionIdFromKey(key, blockId);
+        }
+    }
+    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)));
+        }
+        else {
+            await this.db.delete(key);
+        }
+    }
+    async getApproximateBytesUsed() {
+        try {
+            let total = 0;
+            const iter = this.db.iterator();
+            try {
+                while (true) {
+                    const entry = await iter.next();
+                    if (!entry)
+                        break;
+                    total += entry[0].byteLength + entry[1].byteLength;
+                }
+            }
+            finally {
+                await iter.close();
+            }
+            return total;
+        }
+        catch (err) {
+            log('getApproximateBytesUsed 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();
+    }
+}
+//# sourceMappingURL=leveldb-storage.js.map

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

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

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

@@ -0,0 +1,73 @@
+import type { LevelDBLike } from './leveldb-like.js';
+/**
+ * Minimal subset of `rn-leveldb`'s `LevelDB` 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-RN consumers).
+ *
+ * Matches the shape used by `@quereus/plugin-react-native-leveldb` so apps
+ * embedding both Optimystic and Quereus can share one native module.
+ */
+export interface RNLevelDBNative {
+    put(key: ArrayBuffer | string, value: ArrayBuffer | string): void;
+    getBuf(key: ArrayBuffer | string): ArrayBuffer | null;
+    delete(key: ArrayBuffer | string): void;
+    close(): void;
+    newIterator(): RNLevelDBIteratorNative;
+    write(batch: RNLevelDBWriteBatchNative): void;
+}
+export interface RNLevelDBWriteBatchNative {
+    put(key: ArrayBuffer | string, value: ArrayBuffer | string): void;
+    delete(key: ArrayBuffer | string): void;
+    close(): void;
+}
+export interface RNLevelDBIteratorNative {
+    valid(): boolean;
+    seek(target: ArrayBuffer | string): RNLevelDBIteratorNative;
+    seekToFirst(): RNLevelDBIteratorNative;
+    seekLast(): RNLevelDBIteratorNative;
+    next(): void;
+    prev(): void;
+    keyBuf(): ArrayBuffer;
+    valueBuf(): ArrayBuffer;
+    close(): void;
+}
+/** Constructor type for `rn-leveldb`'s `LevelDBWriteBatch`. */
+export type RNLevelDBWriteBatchCtor = new () => RNLevelDBWriteBatchNative;
+/**
+ * Open function shape — typically `(name, createIfMissing, errorIfExists) =>
+ * new LevelDB(name, createIfMissing, errorIfExists)`. The caller controls
+ * how `rn-leveldb` is imported so this package never directly imports it,
+ * which keeps the unit tests runnable under Node.
+ */
+export type RNLevelDBOpenFn = (name: string, createIfMissing: boolean, errorIfExists: boolean) => RNLevelDBNative;
+export declare const DEFAULT_DB_NAME = "optimystic";
+export interface OpenOptimysticRNDbOptions {
+    /** `rn-leveldb`'s `LevelDB` constructor wrapped as an open function. */
+    openFn: RNLevelDBOpenFn;
+    /** `rn-leveldb`'s `LevelDBWriteBatch` constructor. */
+    WriteBatch: RNLevelDBWriteBatchCtor;
+    /** Database name (LevelDB directory). Default `optimystic`. */
+    name?: string;
+    /** Whether to create the database if it doesn't exist. Default `true`. */
+    createIfMissing?: boolean;
+    /** Whether to error if the database already exists. Default `false`. */
+    errorIfExists?: boolean;
+}
+/**
+ * Opens (creating if needed) the Optimystic LevelDB database used by
+ * `LevelDBRawStorage`, `LevelDBKVStore`, and `loadOrCreateRNPeerKey`.
+ *
+ * The caller passes the `rn-leveldb` constructors in; this keeps the
+ * native module out of the package's static import graph. Apps embedding
+ * both Optimystic and Quereus can pass the same constructors to both —
+ * one native module, one Podfile entry.
+ */
+export declare function openOptimysticRNDb(options: OpenOptimysticRNDbOptions): LevelDBLike;
+/**
+ * Wraps an already-open `rn-leveldb` `LevelDB` instance to satisfy the
+ * `LevelDBLike` interface. Exported for callers that already hold a handle
+ * (rare — usually `openOptimysticRNDb` is the right entry point).
+ */
+export declare function wrapRNLevelDB(native: RNLevelDBNative, WriteBatch: RNLevelDBWriteBatchCtor): LevelDBLike;
+//# sourceMappingURL=rn-opener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rn-opener.d.ts","sourceRoot":"","sources":["../../src/rn-opener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EAEX,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACtD,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;IACd,WAAW,IAAI,uBAAuB,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,yBAAyB;IACzC,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,IAAI,OAAO,CAAC;IACjB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,uBAAuB,CAAC;IAC5D,WAAW,IAAI,uBAAuB,CAAC;IACvC,QAAQ,IAAI,uBAAuB,CAAC;IACpC,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,WAAW,CAAC;IACtB,QAAQ,IAAI,WAAW,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACd;AAED,+DAA+D;AAC/D,MAAM,MAAM,uBAAuB,GAAG,UAAU,yBAAyB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,KAAK,eAAe,CAAC;AAElH,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,MAAM,WAAW,yBAAyB;IACzC,wEAAwE;IACxE,MAAM,EAAE,eAAe,CAAC;IACxB,sDAAsD;IACtD,UAAU,EAAE,uBAAuB,CAAC;IACpC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,WAAW,CAOlF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,uBAAuB,GAAG,WAAW,CAEvG"}

package/dist/src/rn-opener.js

@@ -0,0 +1,200 @@
+export const DEFAULT_DB_NAME = 'optimystic';
+/**
+ * Opens (creating if needed) the Optimystic LevelDB database used by
+ * `LevelDBRawStorage`, `LevelDBKVStore`, and `loadOrCreateRNPeerKey`.
+ *
+ * The caller passes the `rn-leveldb` constructors in; this keeps the
+ * native module out of the package's static import graph. Apps embedding
+ * both Optimystic and Quereus can pass the same constructors to both —
+ * one native module, one Podfile entry.
+ */
+export function openOptimysticRNDb(options) {
+    const native = options.openFn(options.name ?? DEFAULT_DB_NAME, options.createIfMissing ?? true, options.errorIfExists ?? false);
+    return wrapRNLevelDB(native, options.WriteBatch);
+}
+/**
+ * Wraps an already-open `rn-leveldb` `LevelDB` instance to satisfy the
+ * `LevelDBLike` interface. Exported for callers that already hold a handle
+ * (rare — usually `openOptimysticRNDb` is the right entry point).
+ */
+export function wrapRNLevelDB(native, WriteBatch) {
+    return new RNLevelDBAdapter(native, WriteBatch);
+}
+class RNLevelDBAdapter {
+    native;
+    WriteBatch;
+    constructor(native, WriteBatch) {
+        this.native = native;
+        this.WriteBatch = WriteBatch;
+    }
+    async get(key) {
+        const result = this.native.getBuf(toArrayBuffer(key));
+        return result === null ? undefined : new Uint8Array(result);
+    }
+    async put(key, value) {
+        this.native.put(toArrayBuffer(key), toArrayBuffer(value));
+    }
+    async delete(key) {
+        this.native.delete(toArrayBuffer(key));
+    }
+    batch() {
+        return new RNLevelDBWriteBatchAdapter(this.native, new this.WriteBatch());
+    }
+    iterator(options = {}) {
+        return new RNLevelDBIteratorAdapter(this.native.newIterator(), options);
+    }
+    async close() {
+        this.native.close();
+    }
+}
+class RNLevelDBWriteBatchAdapter {
+    native;
+    batch;
+    constructor(native, batch) {
+        this.native = native;
+        this.batch = batch;
+    }
+    put(key, value) {
+        this.batch.put(toArrayBuffer(key), toArrayBuffer(value));
+        return this;
+    }
+    delete(key) {
+        this.batch.delete(toArrayBuffer(key));
+        return this;
+    }
+    async write() {
+        try {
+            this.native.write(this.batch);
+        }
+        finally {
+            this.batch.close();
+        }
+    }
+}
+class RNLevelDBIteratorAdapter {
+    iter;
+    opts;
+    positioned = false;
+    yielded = 0;
+    done = false;
+    constructor(iter, opts) {
+        this.iter = iter;
+        this.opts = opts;
+    }
+    async next() {
+        if (this.done)
+            return undefined;
+        if (this.opts.limit !== undefined && this.yielded >= this.opts.limit) {
+            this.done = true;
+            return undefined;
+        }
+        if (!this.positioned) {
+            this.positionInitial();
+            this.positioned = true;
+        }
+        else if (this.opts.reverse) {
+            this.iter.prev();
+        }
+        else {
+            this.iter.next();
+        }
+        if (!this.iter.valid()) {
+            this.done = true;
+            return undefined;
+        }
+        const key = new Uint8Array(this.iter.keyBuf());
+        // Range bounds: bail out as soon as we cross.
+        if (this.opts.reverse) {
+            if (this.opts.gte && compareBytes(key, this.opts.gte) < 0) {
+                this.done = true;
+                return undefined;
+            }
+            if (this.opts.gt && compareBytes(key, this.opts.gt) <= 0) {
+                this.done = true;
+                return undefined;
+            }
+        }
+        else {
+            if (this.opts.lt && compareBytes(key, this.opts.lt) >= 0) {
+                this.done = true;
+                return undefined;
+            }
+            if (this.opts.lte && compareBytes(key, this.opts.lte) > 0) {
+                this.done = true;
+                return undefined;
+            }
+        }
+        // `keys: true` means caller wants only keys; skip the `valueBuf` native call.
+        const value = this.opts.keys ? new Uint8Array(0) : new Uint8Array(this.iter.valueBuf());
+        this.yielded++;
+        return [key, value];
+    }
+    async close() {
+        this.iter.close();
+    }
+    positionInitial() {
+        if (this.opts.reverse) {
+            if (this.opts.lte !== undefined) {
+                this.iter.seek(toArrayBuffer(this.opts.lte));
+                if (!this.iter.valid()) {
+                    this.iter.seekLast();
+                }
+                else {
+                    const key = new Uint8Array(this.iter.keyBuf());
+                    if (compareBytes(key, this.opts.lte) > 0)
+                        this.iter.prev();
+                }
+            }
+            else if (this.opts.lt !== undefined) {
+                this.iter.seek(toArrayBuffer(this.opts.lt));
+                if (this.iter.valid()) {
+                    this.iter.prev();
+                }
+                else {
+                    this.iter.seekLast();
+                }
+            }
+            else {
+                this.iter.seekLast();
+            }
+        }
+        else {
+            if (this.opts.gte !== undefined) {
+                this.iter.seek(toArrayBuffer(this.opts.gte));
+            }
+            else if (this.opts.gt !== undefined) {
+                this.iter.seek(toArrayBuffer(this.opts.gt));
+                if (this.iter.valid()) {
+                    const key = new Uint8Array(this.iter.keyBuf());
+                    if (compareBytes(key, this.opts.gt) === 0)
+                        this.iter.next();
+                }
+            }
+            else {
+                this.iter.seekToFirst();
+            }
+        }
+    }
+}
+function toArrayBuffer(bytes) {
+    const buffer = bytes.buffer;
+    if (buffer instanceof ArrayBuffer
+        && bytes.byteOffset === 0
+        && bytes.byteLength === buffer.byteLength) {
+        return buffer;
+    }
+    const copy = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(copy).set(bytes);
+    return copy;
+}
+function compareBytes(a, b) {
+    const minLength = Math.min(a.length, b.length);
+    for (let i = 0; i < minLength; i++) {
+        const av = a[i];
+        const bv = b[i];
+        if (av !== bv)
+            return av - bv;
+    }
+    return a.length - b.length;
+}
+//# sourceMappingURL=rn-opener.js.map

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

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@optimystic/db-p2p-storage-rn",
-  "version": "0.13.0",
+  "version": "0.13.5",
   "type": "module",
-  "description": "React Native storage backend for @optimystic/db-p2p using MMKV",
+  "description": "React Native LevelDB storage backend for @optimystic/db-p2p",
   "main": "dist/src/index.js",
   "types": "./dist/src/index.d.ts",
   "files": [
@@ -30,7 +30,7 @@
     "p2p",
     "storage",
     "react-native",
-    "mmkv"
+    "leveldb"
   ],
   "scripts": {
     "clean": "rimraf dist",
@@ -39,26 +39,32 @@
     "test:verbose": "node --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",
+    "classic-level": "^3.0.0",
     "mocha": "^11.7.5",
     "rimraf": "^6.1.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@optimystic/db-core": "^0.13.0",
-    "@optimystic/db-p2p": "^0.13.0",
+    "@optimystic/db-core": "^0.13.5",
+    "@optimystic/db-p2p": "^0.13.5",
     "debug": "^4.4.3"
   },
   "peerDependencies": {
-    "react-native-mmkv": "^4.0.0"
+    "@libp2p/crypto": "^5.1.13",
+    "@libp2p/interface": "^3.1.0",
+    "rn-leveldb": "^3.11.0"
   },
   "peerDependenciesMeta": {
-    "react-native-mmkv": {
+    "rn-leveldb": {
       "optional": false
     }
   }

package/src/identity.ts

@@ -0,0 +1,33 @@
+import { generateKeyPair, privateKeyFromProtobuf, privateKeyToProtobuf } from '@libp2p/crypto/keys';
+import type { PrivateKey } from '@libp2p/interface';
+import type { LevelDBLike } from './leveldb-like.js';
+import { identityKey } from './keys.js';
+
+export const DEFAULT_PEER_KEY_NAME = 'peer-private-key';
+
+/**
+ * Loads the persisted React Native 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 under a dedicated identity tag —
+ * LevelDB stores arbitrary byte sequences natively, so there is no base64
+ * round-trip (unlike a text-only KV store). Mirrors the shape of
+ * `loadOrCreateBrowserPeerKey` and `loadOrCreateNSPeerKey`.
+ *
+ * The returned `PrivateKey` can be passed directly to
+ * `createLibp2pNode({ privateKey })`, giving a React Native peer a stable,
+ * restart-surviving identity.
+ */
+export async function loadOrCreateRNPeerKey(
+	db: LevelDBLike,
+	keyName: string = DEFAULT_PEER_KEY_NAME,
+): Promise<PrivateKey> {
+	const stored = await db.get(identityKey(keyName));
+	if (stored && stored.byteLength > 0) {
+		return privateKeyFromProtobuf(stored);
+	}
+	const key = await generateKeyPair('Ed25519');
+	const bytes = privateKeyToProtobuf(key);
+	await db.put(identityKey(keyName), bytes);
+	return key;
+}

package/src/index.ts

@@ -1,3 +1,14 @@
-export * from './mmkv-storage.js';
-export * from './mmkv-kv-store.js';
-
+export { LevelDBRawStorage } 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';