@backloghq/opslog 0.1.2 → 0.1.3

package/README.md

@@ -103,6 +103,8 @@ await store.batch(() => {         // Multiple ops, single disk write
 });
 ```
 
+Empty batches (no `set`/`delete` calls) are no-ops — no I/O is performed.
+
 ### History
 
 ```typescript

package/dist/store.js

@@ -46,7 +46,18 @@ export class Store {
         }
         else {
             // Load existing state
-            const { records, version: storedVersion } = await loadSnapshot(dir, manifest.currentSnapshot);
+            let snapshotData;
+            try {
+                snapshotData = await loadSnapshot(dir, manifest.currentSnapshot);
+            }
+            catch (err) {
+                const isNotFound = err instanceof Error && "code" in err && err.code === "ENOENT";
+                if (isNotFound) {
+                    throw new Error(`Snapshot file not found: ${manifest.currentSnapshot}. The data directory may be corrupted.`, { cause: err });
+                }
+                throw err;
+            }
+            const { records, version: storedVersion } = snapshotData;
             this.records = records;
             this.version = storedVersion;
             this.activeOpsPath = manifest.activeOps;
@@ -154,6 +165,7 @@ export class Store {
         this.batchOps = [];
         try {
             fn();
+            // Empty batches are no-ops — no I/O if fn() didn't call set/delete
             if (this.batchOps.length > 0) {
                 await appendOps(join(this.dir, this.activeOpsPath), this.batchOps);
                 this.ops.push(...this.batchOps);

package/dist/validate.js

@@ -17,8 +17,9 @@ export function validateManifest(raw) {
         throw new Error("Invalid manifest: not an object");
     }
     const obj = raw;
-    if (typeof obj.version !== "number")
-        throw new Error("Invalid manifest: missing version");
+    if (typeof obj.version !== "number" || !Number.isInteger(obj.version) || obj.version < 1) {
+        throw new Error("Invalid manifest: version must be a positive integer");
+    }
     if (typeof obj.currentSnapshot !== "string")
         throw new Error("Invalid manifest: missing currentSnapshot");
     if (typeof obj.activeOps !== "string")
@@ -46,8 +47,11 @@ export function validateSnapshot(raw) {
         throw new Error("Invalid snapshot: not an object");
     }
     const obj = raw;
-    if (typeof obj.version !== "number")
-        throw new Error("Invalid snapshot: missing version");
+    if (typeof obj.version !== "number" || !Number.isInteger(obj.version) || obj.version < 1) {
+        throw new Error("Invalid snapshot: version must be a positive integer");
+    }
+    if (typeof obj.timestamp !== "string")
+        throw new Error("Invalid snapshot: missing timestamp");
     if (typeof obj.records !== "object" || obj.records === null || Array.isArray(obj.records)) {
         throw new Error("Invalid snapshot: records must be an object");
     }
@@ -58,8 +62,9 @@ export function validateArchiveSegment(raw) {
         throw new Error("Invalid archive segment: not an object");
     }
     const obj = raw;
-    if (typeof obj.version !== "number")
-        throw new Error("Invalid archive segment: missing version");
+    if (typeof obj.version !== "number" || !Number.isInteger(obj.version) || obj.version < 1) {
+        throw new Error("Invalid archive segment: version must be a positive integer");
+    }
     if (typeof obj.period !== "string")
         throw new Error("Invalid archive segment: missing period");
     if (typeof obj.timestamp !== "string")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backloghq/opslog",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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",