@backloghq/opslog 0.4.0 → 0.4.1

package/dist/store.d.ts

@@ -47,18 +47,19 @@ export declare class Store<T = Record<string, unknown>> {
     loadArchive(segment: string): Promise<Map<string, T>>;
     stats(): StoreStats;
     /**
-     * Reload state from the backend (multi-writer mode).
-     * Re-reads the manifest, snapshot, and all agent WAL files.
-     * Use this to pick up writes from other agents.
+     * Reload state from the backend.
+     * In multi-writer mode: re-reads manifest, snapshot, and all agent WAL files.
+     * In single-writer/readOnly mode: re-reads the active ops file for new entries.
+     * Use this to pick up writes from other agents or processes.
      */
     refresh(): Promise<void>;
     private watchTimer;
     private watchCallback;
     /**
-     * Tail the WAL for new operations. Re-reads the active ops file
-     * and replays any new operations since the last known count.
+     * Tail the WAL for new operations.
+     * In single-writer/readOnly: re-reads the active ops file for new entries.
+     * In multi-writer: re-reads ALL agent WAL files from the manifest.
      * Returns the newly applied operations.
-     * Works in any mode (single-writer readOnly, multi-writer, etc).
      */
     tail(): Promise<Operation<T>[]>;
     /**

package/dist/store.js

@@ -299,30 +299,41 @@ export class Store {
         };
     }
     /**
-     * Reload state from the backend (multi-writer mode).
-     * Re-reads the manifest, snapshot, and all agent WAL files.
-     * Use this to pick up writes from other agents.
+     * Reload state from the backend.
+     * In multi-writer mode: re-reads manifest, snapshot, and all agent WAL files.
+     * In single-writer/readOnly mode: re-reads the active ops file for new entries.
+     * Use this to pick up writes from other agents or processes.
      */
     async refresh() {
         this.ensureOpen();
-        if (!this.isMultiWriter()) {
-            throw new Error("refresh() is only available in multi-writer mode");
+        if (this.isMultiWriter()) {
+            return this.serialize(() => this._refresh());
         }
-        return this.serialize(() => this._refresh());
+        // Single-writer / readOnly: just tail the active ops file
+        await this.tail();
     }
     // --- WAL tailing ---
     watchTimer = null;
     watchCallback = null;
     /**
-     * Tail the WAL for new operations. Re-reads the active ops file
-     * and replays any new operations since the last known count.
+     * Tail the WAL for new operations.
+     * In single-writer/readOnly: re-reads the active ops file for new entries.
+     * In multi-writer: re-reads ALL agent WAL files from the manifest.
      * Returns the newly applied operations.
-     * Works in any mode (single-writer readOnly, multi-writer, etc).
      */
     async tail() {
         this.ensureOpen();
         const prevCount = this.ops.length;
-        // Re-read the ops file for new entries
+        if (this.isMultiWriter()) {
+            // Multi-writer: full refresh to pick up all agents' writes
+            await this.serialize(() => this._refresh());
+            // Return the difference
+            if (this.ops.length > prevCount) {
+                return this.ops.slice(prevCount);
+            }
+            return [];
+        }
+        // Single-writer / readOnly: just re-read our ops file
         const allOps = (await this.backend.readOps(this.activeOpsPath));
         if (allOps.length <= prevCount)
             return [];

package/package.json

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