@optimystic/db-p2p-storage-rn 0.1.1

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mmkv-storage.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,cAAc,mBAAmB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,2 @@
+export * from './mmkv-storage.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":"AAAA,cAAc,mBAAmB,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-rn';
+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/mmkv-storage.d.ts

@@ -0,0 +1,47 @@
+import type { BlockId, IBlock, Transform, ActionId, ActionRev } from '@optimystic/db-core';
+import type { BlockMetadata, IRawStorage } from '@optimystic/db-p2p';
+/** MMKV storage interface matching react-native-mmkv */
+export interface MMKV {
+    getString(key: string): string | undefined;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+    getAllKeys(): string[];
+    contains(key: string): boolean;
+}
+export interface MMKVStorageOptions {
+    /** The MMKV instance to use */
+    mmkv: MMKV;
+    /** Optional prefix for all keys to namespace this storage */
+    prefix?: string;
+}
+export declare class MMKVRawStorage implements IRawStorage {
+    private readonly mmkv;
+    private readonly prefix;
+    constructor(options: MMKVStorageOptions);
+    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>;
+    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>;
+    listRevisions(blockId: BlockId, startRev: number, endRev: number): AsyncIterable<ActionRev>;
+    getMaterializedBlock(blockId: BlockId, actionId: ActionId): Promise<IBlock | undefined>;
+    saveMaterializedBlock(blockId: BlockId, actionId: ActionId, block?: IBlock): Promise<void>;
+    promotePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void>;
+    private metadataKey;
+    private revisionKey;
+    private pendingKey;
+    private transactionKey;
+    private materializedKey;
+    private pendingIndexKey;
+    private getJson;
+    private setJson;
+    private getPendingIndex;
+    private addToPendingIndex;
+    private removeFromPendingIndex;
+}
+//# sourceMappingURL=mmkv-storage.d.ts.map

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

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

package/dist/src/mmkv-storage.js

@@ -0,0 +1,129 @@
+import { createLogger } from './logger.js';
+const log = createLogger('storage:mmkv');
+export class MMKVRawStorage {
+    mmkv;
+    prefix;
+    constructor(options) {
+        this.mmkv = options.mmkv;
+        this.prefix = options.prefix ?? 'optimystic:';
+    }
+    async getMetadata(blockId) {
+        return this.getJson(this.metadataKey(blockId));
+    }
+    async saveMetadata(blockId, metadata) {
+        this.setJson(this.metadataKey(blockId), metadata);
+    }
+    async getRevision(blockId, rev) {
+        return this.mmkv.getString(this.revisionKey(blockId, rev));
+    }
+    async saveRevision(blockId, rev, actionId) {
+        this.mmkv.set(this.revisionKey(blockId, rev), actionId);
+    }
+    async getPendingTransaction(blockId, actionId) {
+        return this.getJson(this.pendingKey(blockId, actionId));
+    }
+    async savePendingTransaction(blockId, actionId, transform) {
+        this.setJson(this.pendingKey(blockId, actionId), transform);
+        this.addToPendingIndex(blockId, actionId);
+    }
+    async deletePendingTransaction(blockId, actionId) {
+        this.mmkv.delete(this.pendingKey(blockId, actionId));
+        this.removeFromPendingIndex(blockId, actionId);
+    }
+    async *listPendingTransactions(blockId) {
+        const index = this.getPendingIndex(blockId);
+        for (const actionId of index) {
+            if (this.mmkv.contains(this.pendingKey(blockId, actionId))) {
+                yield actionId;
+            }
+        }
+    }
+    async getTransaction(blockId, actionId) {
+        return this.getJson(this.transactionKey(blockId, actionId));
+    }
+    async saveTransaction(blockId, actionId, transform) {
+        this.setJson(this.transactionKey(blockId, actionId), transform);
+    }
+    async *listRevisions(blockId, startRev, endRev) {
+        const ascending = startRev <= endRev;
+        for (let rev = startRev; ascending ? rev <= endRev : rev >= endRev; ascending ? ++rev : --rev) {
+            const actionId = await this.getRevision(blockId, rev);
+            if (actionId) {
+                yield { actionId, rev };
+            }
+        }
+    }
+    async getMaterializedBlock(blockId, actionId) {
+        return this.getJson(this.materializedKey(blockId, actionId));
+    }
+    async saveMaterializedBlock(blockId, actionId, block) {
+        const key = this.materializedKey(blockId, actionId);
+        if (block) {
+            this.setJson(key, block);
+        }
+        else {
+            this.mmkv.delete(key);
+        }
+    }
+    async promotePendingTransaction(blockId, actionId) {
+        const pendingKey = this.pendingKey(blockId, actionId);
+        const content = this.mmkv.getString(pendingKey);
+        if (!content) {
+            throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
+        }
+        this.mmkv.set(this.transactionKey(blockId, actionId), content);
+        this.mmkv.delete(pendingKey);
+        this.removeFromPendingIndex(blockId, actionId);
+    }
+    metadataKey(blockId) {
+        return `${this.prefix}${blockId}:meta`;
+    }
+    revisionKey(blockId, rev) {
+        return `${this.prefix}${blockId}:rev:${rev}`;
+    }
+    pendingKey(blockId, actionId) {
+        return `${this.prefix}${blockId}:pend:${actionId}`;
+    }
+    transactionKey(blockId, actionId) {
+        return `${this.prefix}${blockId}:trx:${actionId}`;
+    }
+    materializedKey(blockId, actionId) {
+        return `${this.prefix}${blockId}:block:${actionId}`;
+    }
+    pendingIndexKey(blockId) {
+        return `${this.prefix}${blockId}:pend-idx`;
+    }
+    getJson(key) {
+        const value = this.mmkv.getString(key);
+        if (!value)
+            return undefined;
+        try {
+            return JSON.parse(value);
+        }
+        catch (err) {
+            log('Failed to parse JSON for key %s: %o', key, err);
+            return undefined;
+        }
+    }
+    setJson(key, value) {
+        this.mmkv.set(key, JSON.stringify(value));
+    }
+    getPendingIndex(blockId) {
+        return this.getJson(this.pendingIndexKey(blockId)) ?? [];
+    }
+    addToPendingIndex(blockId, actionId) {
+        const index = this.getPendingIndex(blockId);
+        if (!index.includes(actionId)) {
+            index.push(actionId);
+            this.setJson(this.pendingIndexKey(blockId), index);
+        }
+    }
+    removeFromPendingIndex(blockId, actionId) {
+        const index = this.getPendingIndex(blockId);
+        const filtered = index.filter(id => id !== actionId);
+        if (filtered.length !== index.length) {
+            this.setJson(this.pendingIndexKey(blockId), filtered);
+        }
+    }
+}
+//# sourceMappingURL=mmkv-storage.js.map

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

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@optimystic/db-p2p-storage-rn",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "React Native storage backend for @optimystic/db-p2p using MMKV",
+  "main": "dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gotchoices/optimystic.git",
+    "directory": "packages/db-p2p-storage-rn"
+  },
+  "author": "Got Choices Foundation",
+  "license": "MIT",
+  "keywords": [
+    "optimystic",
+    "database",
+    "p2p",
+    "storage",
+    "react-native",
+    "mmkv"
+  ],
+  "scripts": {
+    "clean": "aegir clean",
+    "build": "aegir build --env node",
+    "lint": "aegir lint",
+    "test": "aegir test",
+    "test:node": "aegir test -t node",
+    "dep-check": "aegir dep-check"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.12",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^25.1.0",
+    "aegir": "^47.0.26",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@optimystic/db-core": "^0.4.1",
+    "@optimystic/db-p2p": "^0.1.2",
+    "debug": "^4.4.3"
+  },
+  "peerDependencies": {
+    "react-native-mmkv": "^3.0.0 || ^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-mmkv": {
+      "optional": false
+    }
+  },
+  "aegir": {
+    "build": {
+      "bundle": false
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './mmkv-storage.js';
+

package/src/logger.ts

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

package/src/mmkv-storage.ts

@@ -0,0 +1,172 @@
+import type { BlockId, IBlock, Transform, ActionId, ActionRev } from '@optimystic/db-core';
+import type { BlockMetadata, IRawStorage } from '@optimystic/db-p2p';
+import { createLogger } from './logger.js';
+
+const log = createLogger('storage:mmkv');
+
+/** MMKV storage interface matching react-native-mmkv */
+export interface MMKV {
+	getString(key: string): string | undefined;
+	set(key: string, value: string): void;
+	delete(key: string): void;
+	getAllKeys(): string[];
+	contains(key: string): boolean;
+}
+
+export interface MMKVStorageOptions {
+	/** The MMKV instance to use */
+	mmkv: MMKV;
+	/** Optional prefix for all keys to namespace this storage */
+	prefix?: string;
+}
+
+export class MMKVRawStorage implements IRawStorage {
+	private readonly mmkv: MMKV;
+	private readonly prefix: string;
+
+	constructor(options: MMKVStorageOptions) {
+		this.mmkv = options.mmkv;
+		this.prefix = options.prefix ?? 'optimystic:';
+	}
+
+	async getMetadata(blockId: BlockId): Promise<BlockMetadata | undefined> {
+		return this.getJson<BlockMetadata>(this.metadataKey(blockId));
+	}
+
+	async saveMetadata(blockId: BlockId, metadata: BlockMetadata): Promise<void> {
+		this.setJson(this.metadataKey(blockId), metadata);
+	}
+
+	async getRevision(blockId: BlockId, rev: number): Promise<ActionId | undefined> {
+		return this.mmkv.getString(this.revisionKey(blockId, rev)) as ActionId | undefined;
+	}
+
+	async saveRevision(blockId: BlockId, rev: number, actionId: ActionId): Promise<void> {
+		this.mmkv.set(this.revisionKey(blockId, rev), actionId);
+	}
+
+	async getPendingTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined> {
+		return this.getJson<Transform>(this.pendingKey(blockId, actionId));
+	}
+
+	async savePendingTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void> {
+		this.setJson(this.pendingKey(blockId, actionId), transform);
+		this.addToPendingIndex(blockId, actionId);
+	}
+
+	async deletePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void> {
+		this.mmkv.delete(this.pendingKey(blockId, actionId));
+		this.removeFromPendingIndex(blockId, actionId);
+	}
+
+	async *listPendingTransactions(blockId: BlockId): AsyncIterable<ActionId> {
+		const index = this.getPendingIndex(blockId);
+		for (const actionId of index) {
+			if (this.mmkv.contains(this.pendingKey(blockId, actionId as ActionId))) {
+				yield actionId as ActionId;
+			}
+		}
+	}
+
+	async getTransaction(blockId: BlockId, actionId: ActionId): Promise<Transform | undefined> {
+		return this.getJson<Transform>(this.transactionKey(blockId, actionId));
+	}
+
+	async saveTransaction(blockId: BlockId, actionId: ActionId, transform: Transform): Promise<void> {
+		this.setJson(this.transactionKey(blockId, actionId), transform);
+	}
+
+	async *listRevisions(blockId: BlockId, startRev: number, endRev: number): AsyncIterable<ActionRev> {
+		const ascending = startRev <= endRev;
+		for (let rev = startRev; ascending ? rev <= endRev : rev >= endRev; ascending ? ++rev : --rev) {
+			const actionId = await this.getRevision(blockId, rev);
+			if (actionId) {
+				yield { actionId, rev };
+			}
+		}
+	}
+
+	async getMaterializedBlock(blockId: BlockId, actionId: ActionId): Promise<IBlock | undefined> {
+		return this.getJson<IBlock>(this.materializedKey(blockId, actionId));
+	}
+
+	async saveMaterializedBlock(blockId: BlockId, actionId: ActionId, block?: IBlock): Promise<void> {
+		const key = this.materializedKey(blockId, actionId);
+		if (block) {
+			this.setJson(key, block);
+		} else {
+			this.mmkv.delete(key);
+		}
+	}
+
+	async promotePendingTransaction(blockId: BlockId, actionId: ActionId): Promise<void> {
+		const pendingKey = this.pendingKey(blockId, actionId);
+		const content = this.mmkv.getString(pendingKey);
+		if (!content) {
+			throw new Error(`Pending action ${actionId} not found for block ${blockId}`);
+		}
+		this.mmkv.set(this.transactionKey(blockId, actionId), content);
+		this.mmkv.delete(pendingKey);
+		this.removeFromPendingIndex(blockId, actionId);
+	}
+
+	private metadataKey(blockId: BlockId): string {
+		return `${this.prefix}${blockId}:meta`;
+	}
+
+	private revisionKey(blockId: BlockId, rev: number): string {
+		return `${this.prefix}${blockId}:rev:${rev}`;
+	}
+
+	private pendingKey(blockId: BlockId, actionId: ActionId): string {
+		return `${this.prefix}${blockId}:pend:${actionId}`;
+	}
+
+	private transactionKey(blockId: BlockId, actionId: ActionId): string {
+		return `${this.prefix}${blockId}:trx:${actionId}`;
+	}
+
+	private materializedKey(blockId: BlockId, actionId: ActionId): string {
+		return `${this.prefix}${blockId}:block:${actionId}`;
+	}
+
+	private pendingIndexKey(blockId: BlockId): string {
+		return `${this.prefix}${blockId}:pend-idx`;
+	}
+
+	private getJson<T>(key: string): T | undefined {
+		const value = this.mmkv.getString(key);
+		if (!value) return undefined;
+		try {
+			return JSON.parse(value) as T;
+		} catch (err) {
+			log('Failed to parse JSON for key %s: %o', key, err);
+			return undefined;
+		}
+	}
+
+	private setJson(key: string, value: unknown): void {
+		this.mmkv.set(key, JSON.stringify(value));
+	}
+
+	private getPendingIndex(blockId: BlockId): string[] {
+		return this.getJson<string[]>(this.pendingIndexKey(blockId)) ?? [];
+	}
+
+	private addToPendingIndex(blockId: BlockId, actionId: ActionId): void {
+		const index = this.getPendingIndex(blockId);
+		if (!index.includes(actionId)) {
+			index.push(actionId);
+			this.setJson(this.pendingIndexKey(blockId), index);
+		}
+	}
+
+	private removeFromPendingIndex(blockId: BlockId, actionId: ActionId): void {
+		const index = this.getPendingIndex(blockId);
+		const filtered = index.filter(id => id !== actionId);
+		if (filtered.length !== index.length) {
+			this.setJson(this.pendingIndexKey(blockId), filtered);
+		}
+	}
+}
+