@optimystic/db-p2p-storage-fs 0.9.3 → 0.11.0

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

@@ -0,0 +1,13 @@
+import type { IKVStore } from '@optimystic/db-p2p';
+/** Filesystem-backed IKVStore. Keys may contain `/` separators which become subdirectories. */
+export declare class FileKVStore implements IKVStore {
+    private readonly basePath;
+    constructor(basePath: string);
+    get(key: string): Promise<string | undefined>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+    private listRecursive;
+    private keyToPath;
+}
+//# sourceMappingURL=file-kv-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-kv-store.d.ts","sourceRoot":"","sources":["../../src/file-kv-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,+FAA+F;AAC/F,qBAAa,WAAY,YAAW,QAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAS7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAS/B,aAAa;IAkB3B,OAAO,CAAC,SAAS;CAGjB"}

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

@@ -0,0 +1,65 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+/** Filesystem-backed IKVStore. Keys may contain `/` separators which become subdirectories. */
+export class FileKVStore {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async get(key) {
+        try {
+            return await fs.readFile(this.keyToPath(key), 'utf-8');
+        }
+        catch (err) {
+            if (err?.code === 'ENOENT')
+                return undefined;
+            throw err;
+        }
+    }
+    async set(key, value) {
+        const filePath = this.keyToPath(key);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, value);
+    }
+    async delete(key) {
+        try {
+            await fs.unlink(this.keyToPath(key));
+        }
+        catch (err) {
+            if (err?.code !== 'ENOENT')
+                throw err;
+        }
+    }
+    async list(prefix) {
+        // prefix like "coordinator/" → scan basePath/coordinator/ directory
+        const parts = prefix.split('/').filter(Boolean);
+        const dirPath = path.join(this.basePath, ...parts);
+        const results = [];
+        await this.listRecursive(dirPath, prefix, results);
+        return results;
+    }
+    async listRecursive(dirPath, prefix, results) {
+        let entries;
+        try {
+            entries = await fs.readdir(dirPath, { withFileTypes: true });
+        }
+        catch (err) {
+            if (err?.code === 'ENOENT')
+                return;
+            throw err;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const subPrefix = prefix + entry.name + '/';
+                await this.listRecursive(path.join(dirPath, entry.name), subPrefix, results);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.json')) {
+                results.push(prefix + entry.name.slice(0, -5));
+            }
+        }
+    }
+    keyToPath(key) {
+        return path.join(this.basePath, ...key.split('/')) + '.json';
+    }
+}
+//# sourceMappingURL=file-kv-store.js.map

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

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

package/dist/src/index.d.ts

@@ -1,2 +1,3 @@
 export * from './file-storage.js';
+export * from './file-kv-store.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/src/index.js

@@ -1,2 +1,3 @@
 export * from './file-storage.js';
+export * from './file-kv-store.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optimystic/db-p2p-storage-fs",
-  "version": "0.9.3",
+  "version": "0.11.0",
   "type": "module",
   "description": "Node.js filesystem storage backend for @optimystic/db-p2p",
   "main": "dist/src/index.js",
@@ -44,8 +44,8 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@optimystic/db-core": "^0.9.3",
-    "@optimystic/db-p2p": "^0.9.3",
+    "@optimystic/db-core": "^0.11.0",
+    "@optimystic/db-p2p": "^0.11.0",
     "debug": "^4.4.3"
   }
 }

package/src/file-kv-store.ts

@@ -0,0 +1,62 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import type { IKVStore } from '@optimystic/db-p2p';
+
+/** Filesystem-backed IKVStore. Keys may contain `/` separators which become subdirectories. */
+export class FileKVStore implements IKVStore {
+	constructor(private readonly basePath: string) {}
+
+	async get(key: string): Promise<string | undefined> {
+		try {
+			return await fs.readFile(this.keyToPath(key), 'utf-8');
+		} catch (err) {
+			if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') return undefined;
+			throw err;
+		}
+	}
+
+	async set(key: string, value: string): Promise<void> {
+		const filePath = this.keyToPath(key);
+		await fs.mkdir(path.dirname(filePath), { recursive: true });
+		await fs.writeFile(filePath, value);
+	}
+
+	async delete(key: string): Promise<void> {
+		try {
+			await fs.unlink(this.keyToPath(key));
+		} catch (err) {
+			if ((err as NodeJS.ErrnoException)?.code !== 'ENOENT') throw err;
+		}
+	}
+
+	async list(prefix: string): Promise<string[]> {
+		// prefix like "coordinator/" → scan basePath/coordinator/ directory
+		const parts = prefix.split('/').filter(Boolean);
+		const dirPath = path.join(this.basePath, ...parts);
+		const results: string[] = [];
+		await this.listRecursive(dirPath, prefix, results);
+		return results;
+	}
+
+	private async listRecursive(dirPath: string, prefix: string, results: string[]): Promise<void> {
+		let entries;
+		try {
+			entries = await fs.readdir(dirPath, { withFileTypes: true });
+		} catch (err) {
+			if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') return;
+			throw err;
+		}
+		for (const entry of entries) {
+			if (entry.isDirectory()) {
+				const subPrefix = prefix + entry.name + '/';
+				await this.listRecursive(path.join(dirPath, entry.name), subPrefix, results);
+			} else if (entry.isFile() && entry.name.endsWith('.json')) {
+				results.push(prefix + entry.name.slice(0, -5));
+			}
+		}
+	}
+
+	private keyToPath(key: string): string {
+		return path.join(this.basePath, ...key.split('/')) + '.json';
+	}
+}

package/src/index.ts

@@ -1 +1,2 @@
 export * from './file-storage.js';
+export * from './file-kv-store.js';