zen-fs-config 0.3.19 → 0.3.21

package/dist/index.d.mts

@@ -170,6 +170,11 @@ interface IConfigRepo {
     getSyncRules(): Promise<SyncRulesMeta | null>;
     /** Write .meta/sync-rules.json. */
     updateSyncRules(meta: SyncRulesMeta): Promise<void>;
+    /**
+     * Sync .meta/ files (backends.json, sync-rules.json) to all replica backends.
+     * Called automatically by createConfigRepo() after setupSync().
+     */
+    syncMetaToReplicas(): Promise<void>;
     /** Dispose: stop all sync, release cache FS and resources. */
     dispose(): Promise<void>;
 }
@@ -254,6 +259,16 @@ declare class ConfigRepo implements IConfigRepo {
     }): Promise<SyncResult>;
     peekNodeConfig<T = unknown>(nodeId: string, path: string): Promise<T>;
     flush(): Promise<SyncResult[]>;
+    /**
+     * Sync .meta/ files (backends.json, sync-rules.json) to all replica backends.
+     *
+     * This ensures the backend topology is available on every replica, enabling
+     * any program that connects to any backend to discover the full topology.
+     *
+     * Called automatically by createConfigRepo() after setupSync().
+     * Can also be called manually after updateBackends() / updateSyncRules().
+     */
+    syncMetaToReplicas(): Promise<void>;
     getSyncStatuses(): Map<string, SyncPairStatus>;
     resolveConflict(conflictId: string, mergedContent: unknown): Promise<void>;
     listConflicts(): Promise<ConflictArchive[]>;

package/dist/index.d.ts

@@ -170,6 +170,11 @@ interface IConfigRepo {
     getSyncRules(): Promise<SyncRulesMeta | null>;
     /** Write .meta/sync-rules.json. */
     updateSyncRules(meta: SyncRulesMeta): Promise<void>;
+    /**
+     * Sync .meta/ files (backends.json, sync-rules.json) to all replica backends.
+     * Called automatically by createConfigRepo() after setupSync().
+     */
+    syncMetaToReplicas(): Promise<void>;
     /** Dispose: stop all sync, release cache FS and resources. */
     dispose(): Promise<void>;
 }
@@ -254,6 +259,16 @@ declare class ConfigRepo implements IConfigRepo {
     }): Promise<SyncResult>;
     peekNodeConfig<T = unknown>(nodeId: string, path: string): Promise<T>;
     flush(): Promise<SyncResult[]>;
+    /**
+     * Sync .meta/ files (backends.json, sync-rules.json) to all replica backends.
+     *
+     * This ensures the backend topology is available on every replica, enabling
+     * any program that connects to any backend to discover the full topology.
+     *
+     * Called automatically by createConfigRepo() after setupSync().
+     * Can also be called manually after updateBackends() / updateSyncRules().
+     */
+    syncMetaToReplicas(): Promise<void>;
     getSyncStatuses(): Map<string, SyncPairStatus>;
     resolveConflict(conflictId: string, mergedContent: unknown): Promise<void>;
     listConflicts(): Promise<ConflictArchive[]>;

package/dist/index.js

@@ -665,6 +665,35 @@ var ConfigRepo = class {
     const resultsMap = await this.syncEngine.syncAll();
     return Array.from(resultsMap.values());
   }
+  /**
+   * Sync .meta/ files (backends.json, sync-rules.json) to all replica backends.
+   *
+   * This ensures the backend topology is available on every replica, enabling
+   * any program that connects to any backend to discover the full topology.
+   *
+   * Called automatically by createConfigRepo() after setupSync().
+   * Can also be called manually after updateBackends() / updateSyncRules().
+   */
+  async syncMetaToReplicas() {
+    this.assertNotDisposed();
+    for (const metaFile of [BACKENDS_FILE, SYNC_RULES_FILE]) {
+      try {
+        const content = await this.cachedFS.readFile(metaFile);
+        const vPath = versionPathFor(metaFile);
+        const vContent = await this.cachedFS.readFile(vPath);
+        for (const [id, replica] of this.replicaBackends) {
+          try {
+            await replica.syncable.writeFile(metaFile, content);
+            await replica.syncable.writeFile(vPath, vContent);
+            console.log(`[ConfigRepo] Synced ${metaFile} + .version to replica ${id}`);
+          } catch (err) {
+            console.error(`[ConfigRepo] Failed to sync ${metaFile} to ${id}:`, err.message);
+          }
+        }
+      } catch {
+      }
+    }
+  }
   getSyncStatuses() {
     this.assertNotDisposed();
     return this.syncEngine.getStatusAll();
@@ -901,12 +930,14 @@ var ConfigRepo = class {
   async writeMetaFile(path, data) {
     console.log(`[writeMetaFile] ${path}, ensuring dir...`);
     await this.ensureDir(path);
-    console.log(`[writeMetaFile] ${path}, writing ${JSON.stringify(data).length} bytes...`);
-    await this.cachedFS.writeFile(
-      path,
-      new TextEncoder().encode(JSON.stringify(data, null, 2))
-    );
-    console.log(`[writeMetaFile] ${path} done`);
+    const bytes = new TextEncoder().encode(JSON.stringify(data, null, 2));
+    console.log(`[writeMetaFile] ${path}, writing ${bytes.length} bytes...`);
+    await this.cachedFS.writeFile(path, bytes);
+    const author = `${this.appId}/${this.nodeId}`;
+    const version = await incrementVersion(this.fullFS, path, bytes, author);
+    await this.ensureDir(versionPathFor(path));
+    await writeVersion(this.fullFS, versionPathFor(path), version);
+    console.log(`[writeMetaFile] ${path} done (version=${version.version})`);
   }
   async readMetaFile(path) {
     try {
@@ -1052,7 +1083,12 @@ async function createConfigRepo(appId, options) {
             replicas: backendsMeta.backends.map((b) => b.id)
           },
           { prefix: `${NODES_DIR}/`, direction: "none" },
-          { prefix: `${META_DIR}/`, direction: "none" }
+          {
+            prefix: `${META_DIR}/`,
+            direction: "one-way",
+            conflictStrategy: "source-wins",
+            replicas: backendsMeta.backends.map((b) => b.id)
+          }
         ]
       };
     }
@@ -1094,6 +1130,7 @@ async function createConfigRepo(appId, options) {
     backendsMeta.backends,
     options.primaryBackendId
   );
+  await repo.syncMetaToReplicas();
   await repo.load();
   return repo;
 }

package/dist/index.mjs

@@ -616,6 +616,35 @@ var ConfigRepo = class {
     const resultsMap = await this.syncEngine.syncAll();
     return Array.from(resultsMap.values());
   }
+  /**
+   * Sync .meta/ files (backends.json, sync-rules.json) to all replica backends.
+   *
+   * This ensures the backend topology is available on every replica, enabling
+   * any program that connects to any backend to discover the full topology.
+   *
+   * Called automatically by createConfigRepo() after setupSync().
+   * Can also be called manually after updateBackends() / updateSyncRules().
+   */
+  async syncMetaToReplicas() {
+    this.assertNotDisposed();
+    for (const metaFile of [BACKENDS_FILE, SYNC_RULES_FILE]) {
+      try {
+        const content = await this.cachedFS.readFile(metaFile);
+        const vPath = versionPathFor(metaFile);
+        const vContent = await this.cachedFS.readFile(vPath);
+        for (const [id, replica] of this.replicaBackends) {
+          try {
+            await replica.syncable.writeFile(metaFile, content);
+            await replica.syncable.writeFile(vPath, vContent);
+            console.log(`[ConfigRepo] Synced ${metaFile} + .version to replica ${id}`);
+          } catch (err) {
+            console.error(`[ConfigRepo] Failed to sync ${metaFile} to ${id}:`, err.message);
+          }
+        }
+      } catch {
+      }
+    }
+  }
   getSyncStatuses() {
     this.assertNotDisposed();
     return this.syncEngine.getStatusAll();
@@ -852,12 +881,14 @@ var ConfigRepo = class {
   async writeMetaFile(path, data) {
     console.log(`[writeMetaFile] ${path}, ensuring dir...`);
     await this.ensureDir(path);
-    console.log(`[writeMetaFile] ${path}, writing ${JSON.stringify(data).length} bytes...`);
-    await this.cachedFS.writeFile(
-      path,
-      new TextEncoder().encode(JSON.stringify(data, null, 2))
-    );
-    console.log(`[writeMetaFile] ${path} done`);
+    const bytes = new TextEncoder().encode(JSON.stringify(data, null, 2));
+    console.log(`[writeMetaFile] ${path}, writing ${bytes.length} bytes...`);
+    await this.cachedFS.writeFile(path, bytes);
+    const author = `${this.appId}/${this.nodeId}`;
+    const version = await incrementVersion(this.fullFS, path, bytes, author);
+    await this.ensureDir(versionPathFor(path));
+    await writeVersion(this.fullFS, versionPathFor(path), version);
+    console.log(`[writeMetaFile] ${path} done (version=${version.version})`);
   }
   async readMetaFile(path) {
     try {
@@ -1003,7 +1034,12 @@ async function createConfigRepo(appId, options) {
             replicas: backendsMeta.backends.map((b) => b.id)
           },
           { prefix: `${NODES_DIR}/`, direction: "none" },
-          { prefix: `${META_DIR}/`, direction: "none" }
+          {
+            prefix: `${META_DIR}/`,
+            direction: "one-way",
+            conflictStrategy: "source-wins",
+            replicas: backendsMeta.backends.map((b) => b.id)
+          }
         ]
       };
     }
@@ -1045,6 +1081,7 @@ async function createConfigRepo(appId, options) {
     backendsMeta.backends,
     options.primaryBackendId
   );
+  await repo.syncMetaToReplicas();
   await repo.load();
   return repo;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",