@rljson/fs-agent 0.0.4 → 0.0.5

package/README.public.md

@@ -314,6 +314,37 @@ Stops all syncing and cleans up resources.
 agent.dispose();
 ```
 
+##### `static fromClient(filePath, treeKey, client, socket, options?): Promise<FsAgent>`
+
+Factory method that creates an FsAgent wired to a `@rljson/server` Client. Returns an enhanced agent with simplified sync methods:
+
+```typescript
+import { Client } from '@rljson/server';
+
+const agent = await FsAgent.fromClient(
+  './my-project',
+  'sharedTree',
+  client,
+  socket,
+  { ignore: ['node_modules', '.git'] },
+);
+
+// Simplified sync (no need to manage Db/Connector manually)
+const stopToDb = await agent.syncToDbSimple({ notify: true });
+const stopFromDb = await agent.syncFromDbSimple({ cleanTarget: true });
+
+// Stop when done
+stopToDb();
+stopFromDb();
+```
+
+**Reconnect handling:** When the Client supports `onDisconnect` / `onReconnect` (available since `@rljson/server` ≥ 0.0.10), `fromClient()` automatically:
+
+- **Pauses** the filesystem watcher on disconnect (prevents futile sync attempts while the server is unreachable)
+- **Resumes** the watcher on reconnect (the server's bootstrap message triggers a catch-up sync via the Connector)
+
+No application code is needed — the wiring is built into `fromClient()`. Clients created with older server versions that lack these methods continue to work without interruption.
+
 ### FsScanner
 
 Low-level filesystem scanner (usually accessed via `agent.scanner`).

package/dist/README.public.md

@@ -314,6 +314,37 @@ Stops all syncing and cleans up resources.
 agent.dispose();
 ```
 
+##### `static fromClient(filePath, treeKey, client, socket, options?): Promise<FsAgent>`
+
+Factory method that creates an FsAgent wired to a `@rljson/server` Client. Returns an enhanced agent with simplified sync methods:
+
+```typescript
+import { Client } from '@rljson/server';
+
+const agent = await FsAgent.fromClient(
+  './my-project',
+  'sharedTree',
+  client,
+  socket,
+  { ignore: ['node_modules', '.git'] },
+);
+
+// Simplified sync (no need to manage Db/Connector manually)
+const stopToDb = await agent.syncToDbSimple({ notify: true });
+const stopFromDb = await agent.syncFromDbSimple({ cleanTarget: true });
+
+// Stop when done
+stopToDb();
+stopFromDb();
+```
+
+**Reconnect handling:** When the Client supports `onDisconnect` / `onReconnect` (available since `@rljson/server` ≥ 0.0.10), `fromClient()` automatically:
+
+- **Pauses** the filesystem watcher on disconnect (prevents futile sync attempts while the server is unreachable)
+- **Resumes** the watcher on reconnect (the server's bootstrap message triggers a catch-up sync via the Connector)
+
+No application code is needed — the wiring is built into `fromClient()`. Clients created with older server versions that lack these methods continue to work without interruption.
+
 ### FsScanner
 
 Low-level filesystem scanner (usually accessed via `agent.scanner`).

package/dist/fs-agent.js

@@ -1116,6 +1116,16 @@ class FsAgent {
     enhancedAgent.syncFromDbSimple = async (restoreOpts) => {
       return agent.syncFromDb(db, connector, treeKey, restoreOpts);
     };
+    if (typeof client.onDisconnect === "function") {
+      client.onDisconnect(() => {
+        agent.scanner.pauseWatch();
+      });
+    }
+    if (typeof client.onReconnect === "function") {
+      client.onReconnect(() => {
+        agent.scanner.resumeWatch();
+      });
+    }
     return enhancedAgent;
   }
   /** Example instance for test purposes */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rljson/fs-agent",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Rljson fs-agent description",
   "homepage": "https://github.com/rljson/fs-agent",
   "bugs": "https://github.com/rljson/fs-agent/issues",
@@ -20,20 +20,20 @@
   ],
   "type": "module",
   "devDependencies": {
-    "@rljson/server": "^0.0.6",
-    "@types/node": "^25.2.3",
-    "@typescript-eslint/eslint-plugin": "^8.56.0",
-    "@typescript-eslint/parser": "^8.56.0",
+    "@rljson/server": "^0.0.10",
+    "@types/node": "^25.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
     "@vitest/coverage-v8": "^4.0.18",
     "cross-env": "^10.1.0",
-    "eslint": "~9.39.2",
-    "eslint-plugin-jsdoc": "^62.5.5",
-    "eslint-plugin-tsdoc": "^0.5.0",
+    "eslint": "~9.39.3",
+    "eslint-plugin-jsdoc": "^62.7.1",
+    "eslint-plugin-tsdoc": "^0.5.2",
     "globals": "^17.3.0",
     "jsdoc": "^4.0.5",
     "read-pkg": "^10.1.0",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.56.0",
+    "typescript-eslint": "^8.56.1",
     "vite": "^7.3.1",
     "vite-node": "^5.3.0",
     "vite-plugin-dts": "^4.5.4",
@@ -43,11 +43,11 @@
   },
   "dependencies": {
     "@rljson/bs": "^0.0.21",
-    "@rljson/db": "^0.0.14",
+    "@rljson/db": "^0.0.15",
     "@rljson/hash": "^0.0.18",
     "@rljson/io": "^0.0.66",
     "@rljson/json": "^0.0.23",
-    "@rljson/rljson": "^0.0.76",
+    "@rljson/rljson": "^0.0.78",
     "socket.io": "^4.8.3",
     "socket.io-client": "^4.8.3"
   },