@rljson/fs-agent 0.0.8 → 0.0.9

package/dist/fs-agent.d.ts

@@ -74,6 +74,8 @@ export interface TimeoutConfig {
      */
     debounceMs?: number;
 }
+/** Filename for sync error log written to the sync folder */
+export declare const SYNC_ERROR_FILE = ".sync-errors.log";
 /**
  * Orchestrates filesystem operations with tree structures and blob storage
  */
@@ -111,6 +113,13 @@ export declare class FsAgent {
      * Gets the current timeout configuration
      */
     get timeouts(): Required<TimeoutConfig>;
+    /**
+     * Appends a sync error entry to the error log file in the sync folder.
+     * Uses synchronous I/O to guarantee the write completes even in catch blocks.
+     * @param context - Label identifying where the error occurred
+     * @param err - The error value caught
+     */
+    _writeSyncError(context: string, err: unknown): void;
     /**
      * Wraps a promise with a timeout.
      * Rejects with a descriptive error if the promise does not settle

package/dist/fs-agent.js

@@ -1,9 +1,9 @@
 import { BsMem } from "@rljson/bs";
 import { Route, createTreesTableCfg } from "@rljson/rljson";
+import { watch, appendFileSync } from "fs";
 import { stat, readFile, mkdir, writeFile, readdir, utimes, rm } from "fs/promises";
 import { dirname, join, sep } from "path";
 import { hip } from "@rljson/hash";
-import { watch } from "fs";
 import { Db } from "@rljson/db";
 import { IoMem, createSocketPair } from "@rljson/io";
 import { Server, Client } from "@rljson/server";
@@ -486,6 +486,7 @@ const DEFAULT_TIMEOUTS = {
   syncCallback: 25e3,
   debounceMs: 300
 };
+const SYNC_ERROR_FILE = ".sync-errors.log";
 class FsAgent {
   _scanner;
   _adapter;
@@ -505,7 +506,11 @@ class FsAgent {
     this._db = options.db;
     this._treeKey = options.treeKey;
     this._timeouts = { ...DEFAULT_TIMEOUTS, ...options.timeouts };
-    this._scanner = new FsScanner(rootPath, { ...options, bs: this._bs });
+    this._scanner = new FsScanner(rootPath, {
+      ...options,
+      ignore: [...options.ignore || [], SYNC_ERROR_FILE],
+      bs: this._bs
+    });
     this._adapter = new FsBlobAdapter(this._bs);
     if (this._db && this._treeKey) {
       this._startAutoSync().catch(() => {
@@ -544,6 +549,23 @@ class FsAgent {
   get timeouts() {
     return this._timeouts;
   }
+  /**
+   * Appends a sync error entry to the error log file in the sync folder.
+   * Uses synchronous I/O to guarantee the write completes even in catch blocks.
+   * @param context - Label identifying where the error occurred
+   * @param err - The error value caught
+   */
+  _writeSyncError(context, err) {
+    try {
+      const ts = (/* @__PURE__ */ new Date()).toISOString();
+      const msg = err instanceof Error ? `${err.message}
+${err.stack}` : String(err);
+      const entry = `[${ts}] ${context}: ${msg}
+`;
+      appendFileSync(join(this._rootPath, SYNC_ERROR_FILE), entry);
+    } catch {
+    }
+  }
   /**
    * Wraps a promise with a timeout.
    * Rejects with a descriptive error if the promise does not settle
@@ -772,6 +794,14 @@ class FsAgent {
         if (error instanceof Error && error.message.startsWith("Timeout")) {
           throw error;
         }
+        const errMsg = error instanceof Error ? error.message : String(error);
+        console.warn(
+          `[FsAgent] _fetchTreeRecursively: db.get failed for hash=${currentHash.slice(0, 8)}…: ${errMsg}`
+        );
+        this._writeSyncError(
+          `fetchTree/db.get(${currentHash.slice(0, 8)}…)`,
+          error
+        );
         continue;
       }
       const treeData = result?.rljson?.[treeKey];
@@ -938,7 +968,9 @@ class FsAgent {
             if (ref) {
               await this._sendRef(connector, ref);
             }
-          } catch {
+          } catch (err) {
+            console.error("[FsAgent] syncToDb failed:", err);
+            this._writeSyncError("syncToDb", err);
           }
         }
       }, this._timeouts.debounceMs);
@@ -1027,12 +1059,21 @@ class FsAgent {
           this._timeouts.fetchTree,
           `syncFromDb → fetchTree(${treeKey}@${treeRef.slice(0, 8)}…)`
         );
+        const incomingNodeCount = incomingTree.trees.size;
+        console.log(
+          `[FsAgent] syncFromDb: fetched tree with ${incomingNodeCount} nodes for ref=${treeRef.slice(0, 8)}…`
+        );
         const currentTree = await FsAgent._withTimeout(
           this.extract(),
           this._timeouts.extract,
           `syncFromDb → extract(${this._rootPath})`
         );
         if (this._treesHaveEquivalentContent(currentTree, incomingTree)) {
+          const incomingFiles = this._getFileContentMap(incomingTree);
+          const currentFiles = this._getFileContentMap(currentTree);
+          console.log(
+            `[FsAgent] syncFromDb: equivalent content, skipping restore (incoming=${incomingFiles.size} entries, current=${currentFiles.size} entries, ref=${treeRef.slice(0, 8)}…)`
+          );
           return;
         }
         await FsAgent._withTimeout(
@@ -1047,7 +1088,9 @@ class FsAgent {
         });
         this._lastSentRef = postRestoreRef;
         this._lastSentContentKey = this._contentKeyFromTree(postRestoreTree);
-      } catch {
+      } catch (err) {
+        console.error("[FsAgent] syncFromDb processRef failed:", err);
+        this._writeSyncError("syncFromDb/processRef", err);
       } finally {
         this._scanner.resumeWatch();
       }
@@ -1201,5 +1244,6 @@ export {
   FsBlobAdapter,
   FsDbAdapter,
   FsScanner,
+  SYNC_ERROR_FILE,
   runClientServerSetup
 };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { FsAgent, type FsAgentOptions, type RestoreOptions, type TimeoutConfig, } from './fs-agent.ts';
+export { FsAgent, SYNC_ERROR_FILE, type FsAgentOptions, type RestoreOptions, type TimeoutConfig, } from './fs-agent.ts';
 export { FsBlobAdapter, type BlobToFileOptions, type FileBlobMeta, type FileToBlobOptions, } from './fs-blob-adapter.ts';
 export { FsDbAdapter, type StoreFsTreeOptions } from './fs-db-adapter.ts';
 export { FsScanner, type FsChange, type FsChangeCallback, type FsChangeType, type FsNodeMeta, type FsScanOptions, type FsTree, } from './fs-scanner.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rljson/fs-agent",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Rljson fs-agent description",
   "homepage": "https://github.com/rljson/fs-agent",
   "bugs": "https://github.com/rljson/fs-agent/issues",