zen-fs-config 0.4.4 → 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
           },
           "/"
         );
@@ -1343,7 +1347,7 @@ async function createConfigRepo(appId, options = {}) {
     serializer,
     options.onConflict
   );
-  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID);
+  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID, options.syncPollIntervalMs);
   await repo.load();
   repo.syncMetaToReplicas().catch((err) => {
     console.error("[createConfigRepo] background syncMetaToReplicas failed:", err);

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
           },
           "/"
         );
@@ -1291,7 +1295,7 @@ async function createConfigRepo(appId, options = {}) {
     serializer,
     options.onConflict
   );
-  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID);
+  await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID, options.syncPollIntervalMs);
   await repo.load();
   repo.syncMetaToReplicas().catch((err) => {
     console.error("[createConfigRepo] background syncMetaToReplicas failed:", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.4.4",
+  "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"
   }
 }