zen-fs-config 0.4.3 → 0.4.5

package/dist/index.d.mts

@@ -125,6 +125,12 @@ interface ConfigRepoOptions {
     serializer?: ConfigSerializer;
     /** Custom conflict handler. Called before auto-resolution. */
     onConflict?: (conflict: ConflictInfo) => Promise<unknown | null>;
+    /**
+     * Sync polling interval in milliseconds.
+     * Controls how often the sync engine checks for remote changes.
+     * Default: 1800000 (30 minutes).
+     */
+    syncPollIntervalMs?: number;
 }
 /** The main configuration repository interface. */
 interface IConfigRepo {
@@ -389,7 +395,7 @@ declare class ConfigRepo implements IConfigRepo {
     listConflicts(): Promise<ConflictArchive[]>;
     readConflictBackup(conflictId: string, fileType: 'source' | 'target' | 'resolved'): Promise<string>;
     dispose(): Promise<void>;
-    setupSync(backends: BackendDescriptor[], primaryBackendId: string): Promise<void>;
+    setupSync(backends: BackendDescriptor[], primaryBackendId: string, pollIntervalMs?: number): Promise<void>;
     private persistConfig;
     private reloadConfigCache;
     private handleConflict;

package/dist/index.d.ts

@@ -125,6 +125,12 @@ interface ConfigRepoOptions {
     serializer?: ConfigSerializer;
     /** Custom conflict handler. Called before auto-resolution. */
     onConflict?: (conflict: ConflictInfo) => Promise<unknown | null>;
+    /**
+     * Sync polling interval in milliseconds.
+     * Controls how often the sync engine checks for remote changes.
+     * Default: 1800000 (30 minutes).
+     */
+    syncPollIntervalMs?: number;
 }
 /** The main configuration repository interface. */
 interface IConfigRepo {
@@ -389,7 +395,7 @@ declare class ConfigRepo implements IConfigRepo {
     listConflicts(): Promise<ConflictArchive[]>;
     readConflictBackup(conflictId: string, fileType: 'source' | 'target' | 'resolved'): Promise<string>;
     dispose(): Promise<void>;
-    setupSync(backends: BackendDescriptor[], primaryBackendId: string): Promise<void>;
+    setupSync(backends: BackendDescriptor[], primaryBackendId: string, pollIntervalMs?: number): Promise<void>;
     private persistConfig;
     private reloadConfigCache;
     private handleConflict;

package/dist/index.js

@@ -263,6 +263,9 @@ function backendToSyncableFS(backend, name) {
       return backend.exists(path);
     }
   };
+  if (typeof backend.checkForUpdates === "function") {
+    syncable.checkForUpdates = () => backend.checkForUpdates();
+  }
   if (name) {
     syncable.backendName = name;
   } else if (backend.backendName) {
@@ -894,8 +897,8 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   // Internal — Setup
   // -----------------------------------------------------------------------
-  async setupSync(backends, primaryBackendId) {
-    console.log(`[ConfigRepo] setupSync: ${backends.length} backends, primary=${primaryBackendId}`);
+  async setupSync(backends, primaryBackendId, pollIntervalMs) {
+    console.log(`[ConfigRepo] setupSync: ${backends.length} backends, primary=${primaryBackendId} pollInterval=${pollIntervalMs ?? "default"}ms`);
     for (const desc of backends) {
       if (desc.id === primaryBackendId) continue;
       if (desc.enabled === false) {
@@ -911,7 +914,8 @@ var ConfigRepo = class {
           syncable,
           {
             direction: import_zen_fs_sync.SyncDirection.BiDirectional,
-            conflictStrategy: "source-wins"
+            conflictStrategy: "source-wins",
+            pollIntervalMs
           },
           "/"
         );
@@ -1089,27 +1093,39 @@ var ConfigRepo = class {
   async readAllBackendDescriptors() {
     try {
       const entries = await this.cachedFS.readdir(BACKENDS_DIR);
-      const descriptors = [];
+      const items = [];
       for (const entry of entries) {
         if (!entry.endsWith(".json")) continue;
+        const filePath = `${BACKENDS_DIR}/${entry}`;
         try {
-          const raw = await this.cachedFS.readFile(`${BACKENDS_DIR}/${entry}`);
+          const raw = await this.cachedFS.readFile(filePath);
           const desc = JSON.parse(new TextDecoder().decode(toUint8Array(raw)));
           if (desc.id && desc.type) {
-            descriptors.push(desc);
+            let mtime = 0;
+            try {
+              const stat = await this.cachedFS.stat(filePath);
+              mtime = stat.mtimeMs ?? 0;
+            } catch {
+            }
+            items.push({ desc, mtime });
           }
         } catch {
         }
       }
       const seen = /* @__PURE__ */ new Map();
       const duplicates = [];
-      descriptors.sort((a, b) => a.id.localeCompare(b.id));
-      for (const desc of descriptors) {
-        const key = `${desc.type}:${JSON.stringify(desc.options ?? {})}`;
-        if (seen.has(key)) {
-          duplicates.push(desc.id);
+      for (const item of items) {
+        const key = `${item.desc.type}:${JSON.stringify(item.desc.options ?? {})}`;
+        const existing = seen.get(key);
+        if (existing) {
+          if (item.mtime < existing.mtime) {
+            duplicates.push(existing.desc.id);
+            seen.set(key, item);
+          } else {
+            duplicates.push(item.desc.id);
+          }
         } else {
-          seen.set(key, desc.id);
+          seen.set(key, item);
         }
       }
       if (duplicates.length > 0) {
@@ -1120,7 +1136,7 @@ var ConfigRepo = class {
           await this.removeBackendDescriptor(dupId);
         }
       }
-      return descriptors.filter((d) => !duplicates.includes(d.id));
+      return Array.from(seen.values()).map((i) => i.desc);
     } catch {
       return [];
     }
@@ -1331,9 +1347,11 @@ async function createConfigRepo(appId, options = {}) {
     serializer,
     options.onConflict
   );
-  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID);
-  await repo.syncMetaToReplicas();
+  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID, options.syncPollIntervalMs);
   await repo.load();
+  repo.syncMetaToReplicas().catch((err) => {
+    console.error("[createConfigRepo] background syncMetaToReplicas failed:", err);
+  });
   return repo;
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -211,6 +211,9 @@ function backendToSyncableFS(backend, name) {
       return backend.exists(path);
     }
   };
+  if (typeof backend.checkForUpdates === "function") {
+    syncable.checkForUpdates = () => backend.checkForUpdates();
+  }
   if (name) {
     syncable.backendName = name;
   } else if (backend.backendName) {
@@ -842,8 +845,8 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   // Internal — Setup
   // -----------------------------------------------------------------------
-  async setupSync(backends, primaryBackendId) {
-    console.log(`[ConfigRepo] setupSync: ${backends.length} backends, primary=${primaryBackendId}`);
+  async setupSync(backends, primaryBackendId, pollIntervalMs) {
+    console.log(`[ConfigRepo] setupSync: ${backends.length} backends, primary=${primaryBackendId} pollInterval=${pollIntervalMs ?? "default"}ms`);
     for (const desc of backends) {
       if (desc.id === primaryBackendId) continue;
       if (desc.enabled === false) {
@@ -859,7 +862,8 @@ var ConfigRepo = class {
           syncable,
           {
             direction: SyncDirection.BiDirectional,
-            conflictStrategy: "source-wins"
+            conflictStrategy: "source-wins",
+            pollIntervalMs
           },
           "/"
         );
@@ -1037,27 +1041,39 @@ var ConfigRepo = class {
   async readAllBackendDescriptors() {
     try {
       const entries = await this.cachedFS.readdir(BACKENDS_DIR);
-      const descriptors = [];
+      const items = [];
       for (const entry of entries) {
         if (!entry.endsWith(".json")) continue;
+        const filePath = `${BACKENDS_DIR}/${entry}`;
         try {
-          const raw = await this.cachedFS.readFile(`${BACKENDS_DIR}/${entry}`);
+          const raw = await this.cachedFS.readFile(filePath);
           const desc = JSON.parse(new TextDecoder().decode(toUint8Array(raw)));
           if (desc.id && desc.type) {
-            descriptors.push(desc);
+            let mtime = 0;
+            try {
+              const stat = await this.cachedFS.stat(filePath);
+              mtime = stat.mtimeMs ?? 0;
+            } catch {
+            }
+            items.push({ desc, mtime });
           }
         } catch {
         }
       }
       const seen = /* @__PURE__ */ new Map();
       const duplicates = [];
-      descriptors.sort((a, b) => a.id.localeCompare(b.id));
-      for (const desc of descriptors) {
-        const key = `${desc.type}:${JSON.stringify(desc.options ?? {})}`;
-        if (seen.has(key)) {
-          duplicates.push(desc.id);
+      for (const item of items) {
+        const key = `${item.desc.type}:${JSON.stringify(item.desc.options ?? {})}`;
+        const existing = seen.get(key);
+        if (existing) {
+          if (item.mtime < existing.mtime) {
+            duplicates.push(existing.desc.id);
+            seen.set(key, item);
+          } else {
+            duplicates.push(item.desc.id);
+          }
         } else {
-          seen.set(key, desc.id);
+          seen.set(key, item);
         }
       }
       if (duplicates.length > 0) {
@@ -1068,7 +1084,7 @@ var ConfigRepo = class {
           await this.removeBackendDescriptor(dupId);
         }
       }
-      return descriptors.filter((d) => !duplicates.includes(d.id));
+      return Array.from(seen.values()).map((i) => i.desc);
     } catch {
       return [];
     }
@@ -1279,9 +1295,11 @@ async function createConfigRepo(appId, options = {}) {
     serializer,
     options.onConflict
   );
-  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID);
-  await repo.syncMetaToReplicas();
+  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID, options.syncPollIntervalMs);
   await repo.load();
+  repo.syncMetaToReplicas().catch((err) => {
+    console.error("[createConfigRepo] background syncMetaToReplicas failed:", err);
+  });
   return repo;
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -61,6 +61,6 @@
     "typescript": "^5.9.3",
     "vitest": "^1.6.1",
     "zen-fs-cache": "^1.0.1",
-    "zen-fs-sync": "^0.4.1"
+    "zen-fs-sync": "^0.4.3"
   }
 }