@backloghq/opslog 0.5.1 → 0.6.0

package/dist/backend.d.ts

@@ -27,4 +27,9 @@ export declare class FsBackend implements StorageBackend {
     acquireCompactionLock(): Promise<LockHandle>;
     releaseCompactionLock(handle: LockHandle): Promise<void>;
     getManifestVersion(): Promise<string | null>;
+    writeBlob(relativePath: string, content: Buffer): Promise<void>;
+    readBlob(relativePath: string): Promise<Buffer>;
+    listBlobs(prefix: string): Promise<string[]>;
+    deleteBlob(relativePath: string): Promise<void>;
+    deleteBlobDir(prefix: string): Promise<void>;
 }

package/dist/backend.js

@@ -1,5 +1,5 @@
-import { mkdir, open, readdir, stat, unlink, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { mkdir, open, readdir, readFile, rm, stat, unlink, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
 import { appendOp, appendOps, readOps, truncateLastOp } from "./wal.js";
 import { loadSnapshot, writeSnapshot } from "./snapshot.js";
 import { readManifest, writeManifest } from "./manifest.js";
@@ -131,4 +131,30 @@ export class FsBackend {
             return null;
         }
     }
+    // -- Blob storage --
+    async writeBlob(relativePath, content) {
+        const fullPath = join(this.dir, relativePath);
+        await mkdir(dirname(fullPath), { recursive: true });
+        await writeFile(fullPath, content);
+    }
+    async readBlob(relativePath) {
+        return readFile(join(this.dir, relativePath));
+    }
+    async listBlobs(prefix) {
+        try {
+            return await readdir(join(this.dir, prefix));
+        }
+        catch {
+            return [];
+        }
+    }
+    async deleteBlob(relativePath) {
+        try {
+            await unlink(join(this.dir, relativePath));
+        }
+        catch { /* ignore if not found */ }
+    }
+    async deleteBlobDir(prefix) {
+        await rm(join(this.dir, prefix), { recursive: true, force: true });
+    }
 }

package/dist/types.d.ts

@@ -102,4 +102,14 @@ export interface StorageBackend {
     acquireCompactionLock(): Promise<LockHandle>;
     releaseCompactionLock(handle: LockHandle): Promise<void>;
     getManifestVersion(): Promise<string | null>;
+    /** Write a blob at a relative path. Creates directories as needed. */
+    writeBlob(relativePath: string, content: Buffer): Promise<void>;
+    /** Read a blob from a relative path. */
+    readBlob(relativePath: string): Promise<Buffer>;
+    /** List blob names under a prefix directory. */
+    listBlobs(prefix: string): Promise<string[]>;
+    /** Delete a single blob. */
+    deleteBlob(relativePath: string): Promise<void>;
+    /** Delete all blobs under a prefix directory. */
+    deleteBlobDir(prefix: string): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backloghq/opslog",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Embedded event-sourced document store. Append-only operation log with immutable snapshots, zero native dependencies.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,7 @@
   "license": "MIT",
   "type": "module",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "files": [
     "dist/",