zen-fs-config 0.5.12 → 0.5.14

package/dist/index.d.mts

@@ -485,6 +485,12 @@ declare class ConfigRepo implements IConfigRepo {
     private readonly pollIntervalMs?;
     /** Tombstone cache — avoids redundant reads within a single flush() cycle. */
     private tombstoneCache;
+    /**
+     * Tracks the background initial sync started by createConfigRepo().
+     * `flush()` and `dispose()` will await this if it hasn't completed yet,
+     * preventing concurrent syncEngine.syncAll() calls.
+     */
+    private initialSyncPromise;
     constructor(appId: string, nodeId: string, primaryBackendId: string, cachedFS: MinimalAsyncFS, serializer: PathAwareSerializer, onConflict?: (conflict: ConflictInfo) => Promise<unknown | null>, pollIntervalMs?: number, cacheOptions?: CacheOptions);
     /** Full path to this node's directory on the primary backend. */
     get nodePath(): string;
@@ -505,6 +511,13 @@ declare class ConfigRepo implements IConfigRepo {
      * to all backends instead of being treated as "missing file → re-create".
      */
     deleteFile(path: string): Promise<void>;
+    /**
+     * Background sync scheduled after a deleteFile() call.
+     * Uses a short debounce to coalesce multiple rapid deletions.
+     * If a sync is already in progress, the next poll will pick up the tombstone.
+     */
+    private postDeleteSyncTimer?;
+    private schedulePostDeleteSync;
     /**
      * Read all tombstones from the primary backend.
      * Results are cached within a flush() cycle to avoid redundant reads.
@@ -536,6 +549,12 @@ declare class ConfigRepo implements IConfigRepo {
      * backend descriptors) that watch()'s initial snapshot would skip.
      */
     initialSyncAndDedup(): Promise<void>;
+    /**
+     * Start the initial sync + dedup cycle in the background.
+     * `flush()` and `dispose()` will await this promise if it hasn't
+     * completed yet, preventing concurrent syncEngine operations.
+     */
+    startBackgroundSync(): void;
     /**
      * After sync: mark each tombstone as confirmed by all replica backends.
      */

package/dist/index.d.ts

@@ -485,6 +485,12 @@ declare class ConfigRepo implements IConfigRepo {
     private readonly pollIntervalMs?;
     /** Tombstone cache — avoids redundant reads within a single flush() cycle. */
     private tombstoneCache;
+    /**
+     * Tracks the background initial sync started by createConfigRepo().
+     * `flush()` and `dispose()` will await this if it hasn't completed yet,
+     * preventing concurrent syncEngine.syncAll() calls.
+     */
+    private initialSyncPromise;
     constructor(appId: string, nodeId: string, primaryBackendId: string, cachedFS: MinimalAsyncFS, serializer: PathAwareSerializer, onConflict?: (conflict: ConflictInfo) => Promise<unknown | null>, pollIntervalMs?: number, cacheOptions?: CacheOptions);
     /** Full path to this node's directory on the primary backend. */
     get nodePath(): string;
@@ -505,6 +511,13 @@ declare class ConfigRepo implements IConfigRepo {
      * to all backends instead of being treated as "missing file → re-create".
      */
     deleteFile(path: string): Promise<void>;
+    /**
+     * Background sync scheduled after a deleteFile() call.
+     * Uses a short debounce to coalesce multiple rapid deletions.
+     * If a sync is already in progress, the next poll will pick up the tombstone.
+     */
+    private postDeleteSyncTimer?;
+    private schedulePostDeleteSync;
     /**
      * Read all tombstones from the primary backend.
      * Results are cached within a flush() cycle to avoid redundant reads.
@@ -536,6 +549,12 @@ declare class ConfigRepo implements IConfigRepo {
      * backend descriptors) that watch()'s initial snapshot would skip.
      */
     initialSyncAndDedup(): Promise<void>;
+    /**
+     * Start the initial sync + dedup cycle in the background.
+     * `flush()` and `dispose()` will await this promise if it hasn't
+     * completed yet, preventing concurrent syncEngine operations.
+     */
+    startBackgroundSync(): void;
     /**
      * After sync: mark each tombstone as confirmed by all replica backends.
      */

package/dist/index.js

@@ -622,6 +622,12 @@ var ConfigRepo = class {
   pollIntervalMs;
   /** Tombstone cache — avoids redundant reads within a single flush() cycle. */
   tombstoneCache = null;
+  /**
+   * Tracks the background initial sync started by createConfigRepo().
+   * `flush()` and `dispose()` will await this if it hasn't completed yet,
+   * preventing concurrent syncEngine.syncAll() calls.
+   */
+  initialSyncPromise = null;
   constructor(appId, nodeId, primaryBackendId, cachedFS, serializer, onConflict, pollIntervalMs, cacheOptions) {
     this.appId = appId;
     this.nodeId = nodeId;
@@ -781,6 +787,10 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   async flush() {
     this.assertNotDisposed();
+    if (this.initialSyncPromise) {
+      await this.initialSyncPromise;
+      this.initialSyncPromise = null;
+    }
     await this.processTombstones();
     const resultsMap = await this.syncEngine.syncAll();
     this.invalidateTombstoneCache();
@@ -826,6 +836,25 @@ var ConfigRepo = class {
     }
     console.log(`[ConfigRepo] deleteFile: ${normalizedPath} (tombstone at ${tombstonePath})`);
     this.invalidateTombstoneCache();
+    this.schedulePostDeleteSync();
+  }
+  /**
+   * Background sync scheduled after a deleteFile() call.
+   * Uses a short debounce to coalesce multiple rapid deletions.
+   * If a sync is already in progress, the next poll will pick up the tombstone.
+   */
+  postDeleteSyncTimer;
+  schedulePostDeleteSync() {
+    if (this.postDeleteSyncTimer) {
+      clearTimeout(this.postDeleteSyncTimer);
+    }
+    this.postDeleteSyncTimer = setTimeout(() => {
+      this.postDeleteSyncTimer = void 0;
+      if (this.disposed) return;
+      this.syncEngine.syncAll().catch((err) => {
+        console.warn("[ConfigRepo] post-delete sync failed:", err);
+      });
+    }, 500);
   }
   /**
    * Read all tombstones from the primary backend.
@@ -876,7 +905,9 @@ var ConfigRepo = class {
     for (const tombstone of tombstones) {
       const tVersionPath = versionPathFor(tombstone.path);
       const existedOnPrimary = await this.safeExists(this.cachedFS, tombstone.path);
-      console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on primary \u2192 ${existedOnPrimary ? "EXISTS" : "not found"}`);
+      if (existedOnPrimary) {
+        console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on primary \u2192 EXISTS`);
+      }
       if (existedOnPrimary) {
         try {
           await this.cachedFS.unlink(tombstone.path);
@@ -892,8 +923,8 @@ var ConfigRepo = class {
       }
       for (const [replicaId, replica] of this.replicaBackends) {
         const existed = await this.safeExists(replica.instance, tombstone.path);
-        console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on ${replicaId} \u2192 ${existed ? "EXISTS" : "not found"}`);
         if (existed) {
+          console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on ${replicaId} \u2192 EXISTS`);
           try {
             await replica.instance.unlink(tombstone.path);
             console.log(`[ConfigRepo] tombstone ${tombstone.path}: deleted on ${replicaId}`);
@@ -949,6 +980,20 @@ var ConfigRepo = class {
     await this.processTombstones();
     this.syncEngine.watchAll();
   }
+  /**
+   * Start the initial sync + dedup cycle in the background.
+   * `flush()` and `dispose()` will await this promise if it hasn't
+   * completed yet, preventing concurrent syncEngine operations.
+   */
+  startBackgroundSync() {
+    this.initialSyncPromise = this.initialSyncAndDedup().then(() => {
+      console.log("[ConfigRepo] Background initial sync complete");
+    }).catch((err) => {
+      console.error("[ConfigRepo] Background initial sync failed:", err);
+    }).finally(() => {
+      this.initialSyncPromise = null;
+    });
+  }
   /**
    * After sync: mark each tombstone as confirmed by all replica backends.
    */
@@ -1096,7 +1141,15 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   async dispose() {
     if (this.disposed) return;
+    if (this.initialSyncPromise) {
+      await this.initialSyncPromise;
+      this.initialSyncPromise = null;
+    }
     this.disposed = true;
+    if (this.postDeleteSyncTimer) {
+      clearTimeout(this.postDeleteSyncTimer);
+      this.postDeleteSyncTimer = void 0;
+    }
     this.syncEngine.dispose();
     for (const [_id, replica] of this.replicaBackends) {
       if (replica.instance?.dispose) {
@@ -1137,7 +1190,24 @@ var ConfigRepo = class {
           {
             direction: import_zen_fs_sync.SyncDirection.BiDirectional,
             conflictStrategy: "source-wins",
-            pollIntervalMs
+            pollIntervalMs,
+            preSyncHook: async () => {
+              try {
+                this.invalidateTombstoneCache();
+                await this.processTombstones();
+              } catch (err) {
+                console.warn("[ConfigRepo] preSyncHook processTombstones failed:", err);
+              }
+            },
+            postSyncHook: async () => {
+              try {
+                this.invalidateTombstoneCache();
+                await this.processTombstones();
+                await this.updateTombstoneConfirmations();
+              } catch (err) {
+                console.warn("[ConfigRepo] postSyncHook tombstone processing failed:", err);
+              }
+            }
           },
           "/"
         );
@@ -1190,13 +1260,19 @@ var ConfigRepo = class {
     const appDir = `/${this.appId}`;
     try {
       const files = await this.walkDir(appDir);
-      for (const filePath of files) {
-        try {
-          const raw = await this.cachedFS.readFile(filePath);
-          const data = this.serializer.deserialize(toUint8Array(raw), filePath);
-          this.configCache.set(filePath, data);
-        } catch {
-        }
+      const readResults = await Promise.all(
+        files.map(async (filePath) => {
+          try {
+            const raw = await this.cachedFS.readFile(filePath);
+            const data = this.serializer.deserialize(toUint8Array(raw), filePath);
+            return { filePath, data };
+          } catch {
+            return null;
+          }
+        })
+      );
+      for (const item of readResults) {
+        if (item) this.configCache.set(item.filePath, item.data);
       }
     } catch {
     }
@@ -1283,17 +1359,23 @@ var ConfigRepo = class {
       const current = stack.pop();
       try {
         const entries = await this.cachedFS.readdir(current);
-        for (const entry of entries) {
-          if (entry.startsWith(".")) continue;
-          const fullPath = current === "/" ? `/${entry}` : `${current}/${entry}`;
-          try {
-            const stat = await this.cachedFS.stat(fullPath);
-            if (stat.mode !== void 0 && (stat.mode & 16384) === 16384) {
-              stack.push(fullPath);
-            } else {
-              results.push(fullPath);
+        const statResults = await Promise.all(
+          entries.filter((entry) => !entry.startsWith(".")).map(async (entry) => {
+            const fullPath = current === "/" ? `/${entry}` : `${current}/${entry}`;
+            try {
+              const stat = await this.cachedFS.stat(fullPath);
+              return { fullPath, stat };
+            } catch {
+              return null;
             }
-          } catch {
+          })
+        );
+        for (const item of statResults) {
+          if (!item) continue;
+          if (item.stat.mode !== void 0 && (item.stat.mode & 16384) === 16384) {
+            stack.push(item.fullPath);
+          } else {
+            results.push(item.fullPath);
           }
         }
       } catch {
@@ -1334,29 +1416,38 @@ var ConfigRepo = class {
   async readAllBackendDescriptors() {
     try {
       const entries = await this.cachedFS.readdir(BACKENDS_DIR);
-      const items = [];
-      const corruptFiles = [];
-      for (const entry of entries) {
-        if (!entry.endsWith(".json")) continue;
-        const filePath = `${BACKENDS_DIR}/${entry}`;
-        try {
-          const raw = await this.cachedFS.readFile(filePath);
-          const desc = JSON.parse(new TextDecoder().decode(toUint8Array(raw)));
-          if (desc.id && desc.type) {
-            let mtime = 0;
-            try {
-              const stat = await this.cachedFS.stat(filePath);
-              mtime = stat.mtimeMs ?? 0;
-            } catch {
+      const jsonEntries = entries.filter((e) => e.endsWith(".json"));
+      const readResults = await Promise.all(
+        jsonEntries.map(async (entry) => {
+          const filePath = `${BACKENDS_DIR}/${entry}`;
+          try {
+            const raw = await this.cachedFS.readFile(filePath);
+            const desc = JSON.parse(new TextDecoder().decode(toUint8Array(raw)));
+            if (desc.id && desc.type) {
+              let mtime = 0;
+              try {
+                const stat = await this.cachedFS.stat(filePath);
+                mtime = stat.mtimeMs ?? 0;
+              } catch {
+              }
+              return { kind: "ok", desc, mtime };
+            } else {
+              console.warn(`[ConfigRepo] Backend descriptor ${entry} is missing id/type fields, marking for cleanup`);
+              return { kind: "corrupt", filePath };
             }
-            items.push({ desc, mtime });
-          } else {
-            console.warn(`[ConfigRepo] Backend descriptor ${entry} is missing id/type fields, marking for cleanup`);
-            corruptFiles.push(filePath);
+          } catch (parseErr) {
+            console.warn(`[ConfigRepo] Backend descriptor ${entry} has corrupted JSON: ${parseErr}. Marking for cleanup.`);
+            return { kind: "corrupt", filePath };
           }
-        } catch (parseErr) {
-          console.warn(`[ConfigRepo] Backend descriptor ${entry} has corrupted JSON: ${parseErr}. Marking for cleanup.`);
-          corruptFiles.push(filePath);
+        })
+      );
+      const items = [];
+      const corruptFiles = [];
+      for (const result of readResults) {
+        if (result.kind === "ok") {
+          items.push({ desc: result.desc, mtime: result.mtime });
+        } else {
+          corruptFiles.push(result.filePath);
         }
       }
       for (const corruptPath of corruptFiles) {
@@ -1507,7 +1598,24 @@ var ConfigRepo = class {
       syncable,
       {
         direction: import_zen_fs_sync.SyncDirection.BiDirectional,
-        conflictStrategy: "source-wins"
+        conflictStrategy: "source-wins",
+        preSyncHook: async () => {
+          try {
+            this.invalidateTombstoneCache();
+            await this.processTombstones();
+          } catch (err) {
+            console.warn("[ConfigRepo] preSyncHook processTombstones failed:", err);
+          }
+        },
+        postSyncHook: async () => {
+          try {
+            this.invalidateTombstoneCache();
+            await this.processTombstones();
+            await this.updateTombstoneConfirmations();
+          } catch (err) {
+            console.warn("[ConfigRepo] postSyncHook tombstone processing failed:", err);
+          }
+        }
       },
       "/"
     );
@@ -1526,26 +1634,33 @@ var ConfigRepo = class {
       throw new Error("Cannot remove the local IndexedDB primary backend");
     }
     const replica = this.replicaBackends.get(id);
-    if (!replica) {
-      throw new Error(`Backend "${id}" is not a registered replica`);
-    }
     const descPath = this.backendFilePath(id);
-    try {
-      await replica.instance.unlink(descPath);
-    } catch {
-    }
-    await this.unlinkVersionSidecar(replica.instance, descPath);
-    try {
-      await this.deleteFile(descPath);
-    } catch {
-      await this.removeBackendDescriptor(id);
-    }
-    this.syncEngine.removePair(replica.pairId);
-    console.log(`[ConfigRepo] removeBackend: sync pair ${replica.pairId} removed`);
-    this.replicaBackends.delete(id);
-    if (replica.instance?.dispose) {
-      await replica.instance.dispose();
+    if (replica) {
+      try {
+        await replica.instance.unlink(descPath);
+      } catch {
+      }
+      await this.unlinkVersionSidecar(replica.instance, descPath);
+      try {
+        await this.deleteFile(descPath);
+      } catch {
+        await this.removeBackendDescriptor(id);
+      }
+      this.syncEngine.removePair(replica.pairId);
+      console.log(`[ConfigRepo] removeBackend: sync pair ${replica.pairId} removed`);
+      this.replicaBackends.delete(id);
+      if (replica.instance?.dispose) {
+        await replica.instance.dispose();
+      }
+    } else {
+      console.log(`[ConfigRepo] removeBackend: "${id}" not in replicaBackends, cleaning up descriptor only`);
+      try {
+        await this.deleteFile(descPath);
+      } catch {
+        await this.removeBackendDescriptor(id);
+      }
     }
+    this.schedulePostDeleteSync();
     console.log(`[ConfigRepo] removeBackend: ${id} removed (tombstone written, remote cleaned)`);
   }
   // -----------------------------------------------------------------------
@@ -1905,16 +2020,16 @@ async function createConfigRepo(appId, options = {}) {
     }
     console.log(`[createConfigRepo] Migration complete`);
   }
+  let allBackends = await tempRepo.readAllBackendDescriptors();
   if (options.backendInfo) {
     const replicaId = options.primaryBackendId || `${options.backendInfo.type}-replica`;
-    const allBackends2 = await tempRepo.readAllBackendDescriptors();
-    const hasReplica = allBackends2.some((b) => b.id === replicaId);
+    const hasReplica = allBackends.some((b) => b.id === replicaId);
     const newKey = backendDedupKey({
       id: replicaId,
       type: options.backendInfo.type,
       options: options.backendInfo.options
     });
-    const dupConfig = allBackends2.find((b) => backendDedupKey(b) === newKey);
+    const dupConfig = allBackends.find((b) => backendDedupKey(b) === newKey);
     if (!hasReplica && !dupConfig) {
       await tempRepo.writeBackendDescriptor({
         id: replicaId,
@@ -1922,13 +2037,13 @@ async function createConfigRepo(appId, options = {}) {
         options: options.backendInfo.options
       });
       console.log(`[createConfigRepo] Added replica backend: ${replicaId} (${options.backendInfo.type})`);
+      allBackends = [...allBackends, { id: replicaId, type: options.backendInfo.type, options: options.backendInfo.options }];
     } else if (dupConfig) {
       console.log(`[createConfigRepo] Replica with same config already registered as "${dupConfig.id}", skipping`);
     } else {
       console.log(`[createConfigRepo] Replica ${replicaId} already registered`);
     }
   }
-  const allBackends = await tempRepo.readAllBackendDescriptors();
   console.log(`[createConfigRepo] Replica backends: ${allBackends.map((b) => b.id).join(", ") || "(none)"}`);
   let nodeId = options.nodeId;
   if (!nodeId) {
@@ -1949,8 +2064,8 @@ async function createConfigRepo(appId, options = {}) {
   await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID, options.syncPollIntervalMs);
   await repo.load();
   if (repo.replicaCount > 0) {
-    console.log("[createConfigRepo] Initial sync + dedup cycle...");
-    await repo.initialSyncAndDedup();
+    console.log("[createConfigRepo] Starting background initial sync + dedup...");
+    repo.startBackgroundSync();
   }
   repo.syncMetaToReplicas().catch((err) => {
     console.error("[createConfigRepo] background syncMetaToReplicas failed:", err);

package/dist/index.mjs

@@ -532,6 +532,12 @@ var ConfigRepo = class {
   pollIntervalMs;
   /** Tombstone cache — avoids redundant reads within a single flush() cycle. */
   tombstoneCache = null;
+  /**
+   * Tracks the background initial sync started by createConfigRepo().
+   * `flush()` and `dispose()` will await this if it hasn't completed yet,
+   * preventing concurrent syncEngine.syncAll() calls.
+   */
+  initialSyncPromise = null;
   constructor(appId, nodeId, primaryBackendId, cachedFS, serializer, onConflict, pollIntervalMs, cacheOptions) {
     this.appId = appId;
     this.nodeId = nodeId;
@@ -691,6 +697,10 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   async flush() {
     this.assertNotDisposed();
+    if (this.initialSyncPromise) {
+      await this.initialSyncPromise;
+      this.initialSyncPromise = null;
+    }
     await this.processTombstones();
     const resultsMap = await this.syncEngine.syncAll();
     this.invalidateTombstoneCache();
@@ -736,6 +746,25 @@ var ConfigRepo = class {
     }
     console.log(`[ConfigRepo] deleteFile: ${normalizedPath} (tombstone at ${tombstonePath})`);
     this.invalidateTombstoneCache();
+    this.schedulePostDeleteSync();
+  }
+  /**
+   * Background sync scheduled after a deleteFile() call.
+   * Uses a short debounce to coalesce multiple rapid deletions.
+   * If a sync is already in progress, the next poll will pick up the tombstone.
+   */
+  postDeleteSyncTimer;
+  schedulePostDeleteSync() {
+    if (this.postDeleteSyncTimer) {
+      clearTimeout(this.postDeleteSyncTimer);
+    }
+    this.postDeleteSyncTimer = setTimeout(() => {
+      this.postDeleteSyncTimer = void 0;
+      if (this.disposed) return;
+      this.syncEngine.syncAll().catch((err) => {
+        console.warn("[ConfigRepo] post-delete sync failed:", err);
+      });
+    }, 500);
   }
   /**
    * Read all tombstones from the primary backend.
@@ -786,7 +815,9 @@ var ConfigRepo = class {
     for (const tombstone of tombstones) {
       const tVersionPath = versionPathFor(tombstone.path);
       const existedOnPrimary = await this.safeExists(this.cachedFS, tombstone.path);
-      console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on primary \u2192 ${existedOnPrimary ? "EXISTS" : "not found"}`);
+      if (existedOnPrimary) {
+        console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on primary \u2192 EXISTS`);
+      }
       if (existedOnPrimary) {
         try {
           await this.cachedFS.unlink(tombstone.path);
@@ -802,8 +833,8 @@ var ConfigRepo = class {
       }
       for (const [replicaId, replica] of this.replicaBackends) {
         const existed = await this.safeExists(replica.instance, tombstone.path);
-        console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on ${replicaId} \u2192 ${existed ? "EXISTS" : "not found"}`);
         if (existed) {
+          console.log(`[ConfigRepo] tombstone check: ${tombstone.path} on ${replicaId} \u2192 EXISTS`);
           try {
             await replica.instance.unlink(tombstone.path);
             console.log(`[ConfigRepo] tombstone ${tombstone.path}: deleted on ${replicaId}`);
@@ -859,6 +890,20 @@ var ConfigRepo = class {
     await this.processTombstones();
     this.syncEngine.watchAll();
   }
+  /**
+   * Start the initial sync + dedup cycle in the background.
+   * `flush()` and `dispose()` will await this promise if it hasn't
+   * completed yet, preventing concurrent syncEngine operations.
+   */
+  startBackgroundSync() {
+    this.initialSyncPromise = this.initialSyncAndDedup().then(() => {
+      console.log("[ConfigRepo] Background initial sync complete");
+    }).catch((err) => {
+      console.error("[ConfigRepo] Background initial sync failed:", err);
+    }).finally(() => {
+      this.initialSyncPromise = null;
+    });
+  }
   /**
    * After sync: mark each tombstone as confirmed by all replica backends.
    */
@@ -1006,7 +1051,15 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   async dispose() {
     if (this.disposed) return;
+    if (this.initialSyncPromise) {
+      await this.initialSyncPromise;
+      this.initialSyncPromise = null;
+    }
     this.disposed = true;
+    if (this.postDeleteSyncTimer) {
+      clearTimeout(this.postDeleteSyncTimer);
+      this.postDeleteSyncTimer = void 0;
+    }
     this.syncEngine.dispose();
     for (const [_id, replica] of this.replicaBackends) {
       if (replica.instance?.dispose) {
@@ -1047,7 +1100,24 @@ var ConfigRepo = class {
           {
             direction: SyncDirection.BiDirectional,
             conflictStrategy: "source-wins",
-            pollIntervalMs
+            pollIntervalMs,
+            preSyncHook: async () => {
+              try {
+                this.invalidateTombstoneCache();
+                await this.processTombstones();
+              } catch (err) {
+                console.warn("[ConfigRepo] preSyncHook processTombstones failed:", err);
+              }
+            },
+            postSyncHook: async () => {
+              try {
+                this.invalidateTombstoneCache();
+                await this.processTombstones();
+                await this.updateTombstoneConfirmations();
+              } catch (err) {
+                console.warn("[ConfigRepo] postSyncHook tombstone processing failed:", err);
+              }
+            }
           },
           "/"
         );
@@ -1100,13 +1170,19 @@ var ConfigRepo = class {
     const appDir = `/${this.appId}`;
     try {
       const files = await this.walkDir(appDir);
-      for (const filePath of files) {
-        try {
-          const raw = await this.cachedFS.readFile(filePath);
-          const data = this.serializer.deserialize(toUint8Array(raw), filePath);
-          this.configCache.set(filePath, data);
-        } catch {
-        }
+      const readResults = await Promise.all(
+        files.map(async (filePath) => {
+          try {
+            const raw = await this.cachedFS.readFile(filePath);
+            const data = this.serializer.deserialize(toUint8Array(raw), filePath);
+            return { filePath, data };
+          } catch {
+            return null;
+          }
+        })
+      );
+      for (const item of readResults) {
+        if (item) this.configCache.set(item.filePath, item.data);
       }
     } catch {
     }
@@ -1193,17 +1269,23 @@ var ConfigRepo = class {
       const current = stack.pop();
       try {
         const entries = await this.cachedFS.readdir(current);
-        for (const entry of entries) {
-          if (entry.startsWith(".")) continue;
-          const fullPath = current === "/" ? `/${entry}` : `${current}/${entry}`;
-          try {
-            const stat = await this.cachedFS.stat(fullPath);
-            if (stat.mode !== void 0 && (stat.mode & 16384) === 16384) {
-              stack.push(fullPath);
-            } else {
-              results.push(fullPath);
+        const statResults = await Promise.all(
+          entries.filter((entry) => !entry.startsWith(".")).map(async (entry) => {
+            const fullPath = current === "/" ? `/${entry}` : `${current}/${entry}`;
+            try {
+              const stat = await this.cachedFS.stat(fullPath);
+              return { fullPath, stat };
+            } catch {
+              return null;
             }
-          } catch {
+          })
+        );
+        for (const item of statResults) {
+          if (!item) continue;
+          if (item.stat.mode !== void 0 && (item.stat.mode & 16384) === 16384) {
+            stack.push(item.fullPath);
+          } else {
+            results.push(item.fullPath);
           }
         }
       } catch {
@@ -1244,29 +1326,38 @@ var ConfigRepo = class {
   async readAllBackendDescriptors() {
     try {
       const entries = await this.cachedFS.readdir(BACKENDS_DIR);
-      const items = [];
-      const corruptFiles = [];
-      for (const entry of entries) {
-        if (!entry.endsWith(".json")) continue;
-        const filePath = `${BACKENDS_DIR}/${entry}`;
-        try {
-          const raw = await this.cachedFS.readFile(filePath);
-          const desc = JSON.parse(new TextDecoder().decode(toUint8Array(raw)));
-          if (desc.id && desc.type) {
-            let mtime = 0;
-            try {
-              const stat = await this.cachedFS.stat(filePath);
-              mtime = stat.mtimeMs ?? 0;
-            } catch {
+      const jsonEntries = entries.filter((e) => e.endsWith(".json"));
+      const readResults = await Promise.all(
+        jsonEntries.map(async (entry) => {
+          const filePath = `${BACKENDS_DIR}/${entry}`;
+          try {
+            const raw = await this.cachedFS.readFile(filePath);
+            const desc = JSON.parse(new TextDecoder().decode(toUint8Array(raw)));
+            if (desc.id && desc.type) {
+              let mtime = 0;
+              try {
+                const stat = await this.cachedFS.stat(filePath);
+                mtime = stat.mtimeMs ?? 0;
+              } catch {
+              }
+              return { kind: "ok", desc, mtime };
+            } else {
+              console.warn(`[ConfigRepo] Backend descriptor ${entry} is missing id/type fields, marking for cleanup`);
+              return { kind: "corrupt", filePath };
             }
-            items.push({ desc, mtime });
-          } else {
-            console.warn(`[ConfigRepo] Backend descriptor ${entry} is missing id/type fields, marking for cleanup`);
-            corruptFiles.push(filePath);
+          } catch (parseErr) {
+            console.warn(`[ConfigRepo] Backend descriptor ${entry} has corrupted JSON: ${parseErr}. Marking for cleanup.`);
+            return { kind: "corrupt", filePath };
           }
-        } catch (parseErr) {
-          console.warn(`[ConfigRepo] Backend descriptor ${entry} has corrupted JSON: ${parseErr}. Marking for cleanup.`);
-          corruptFiles.push(filePath);
+        })
+      );
+      const items = [];
+      const corruptFiles = [];
+      for (const result of readResults) {
+        if (result.kind === "ok") {
+          items.push({ desc: result.desc, mtime: result.mtime });
+        } else {
+          corruptFiles.push(result.filePath);
         }
       }
       for (const corruptPath of corruptFiles) {
@@ -1417,7 +1508,24 @@ var ConfigRepo = class {
       syncable,
       {
         direction: SyncDirection.BiDirectional,
-        conflictStrategy: "source-wins"
+        conflictStrategy: "source-wins",
+        preSyncHook: async () => {
+          try {
+            this.invalidateTombstoneCache();
+            await this.processTombstones();
+          } catch (err) {
+            console.warn("[ConfigRepo] preSyncHook processTombstones failed:", err);
+          }
+        },
+        postSyncHook: async () => {
+          try {
+            this.invalidateTombstoneCache();
+            await this.processTombstones();
+            await this.updateTombstoneConfirmations();
+          } catch (err) {
+            console.warn("[ConfigRepo] postSyncHook tombstone processing failed:", err);
+          }
+        }
       },
       "/"
     );
@@ -1436,26 +1544,33 @@ var ConfigRepo = class {
       throw new Error("Cannot remove the local IndexedDB primary backend");
     }
     const replica = this.replicaBackends.get(id);
-    if (!replica) {
-      throw new Error(`Backend "${id}" is not a registered replica`);
-    }
     const descPath = this.backendFilePath(id);
-    try {
-      await replica.instance.unlink(descPath);
-    } catch {
-    }
-    await this.unlinkVersionSidecar(replica.instance, descPath);
-    try {
-      await this.deleteFile(descPath);
-    } catch {
-      await this.removeBackendDescriptor(id);
-    }
-    this.syncEngine.removePair(replica.pairId);
-    console.log(`[ConfigRepo] removeBackend: sync pair ${replica.pairId} removed`);
-    this.replicaBackends.delete(id);
-    if (replica.instance?.dispose) {
-      await replica.instance.dispose();
+    if (replica) {
+      try {
+        await replica.instance.unlink(descPath);
+      } catch {
+      }
+      await this.unlinkVersionSidecar(replica.instance, descPath);
+      try {
+        await this.deleteFile(descPath);
+      } catch {
+        await this.removeBackendDescriptor(id);
+      }
+      this.syncEngine.removePair(replica.pairId);
+      console.log(`[ConfigRepo] removeBackend: sync pair ${replica.pairId} removed`);
+      this.replicaBackends.delete(id);
+      if (replica.instance?.dispose) {
+        await replica.instance.dispose();
+      }
+    } else {
+      console.log(`[ConfigRepo] removeBackend: "${id}" not in replicaBackends, cleaning up descriptor only`);
+      try {
+        await this.deleteFile(descPath);
+      } catch {
+        await this.removeBackendDescriptor(id);
+      }
     }
+    this.schedulePostDeleteSync();
     console.log(`[ConfigRepo] removeBackend: ${id} removed (tombstone written, remote cleaned)`);
   }
   // -----------------------------------------------------------------------
@@ -1815,16 +1930,16 @@ async function createConfigRepo(appId, options = {}) {
     }
     console.log(`[createConfigRepo] Migration complete`);
   }
+  let allBackends = await tempRepo.readAllBackendDescriptors();
   if (options.backendInfo) {
     const replicaId = options.primaryBackendId || `${options.backendInfo.type}-replica`;
-    const allBackends2 = await tempRepo.readAllBackendDescriptors();
-    const hasReplica = allBackends2.some((b) => b.id === replicaId);
+    const hasReplica = allBackends.some((b) => b.id === replicaId);
     const newKey = backendDedupKey({
       id: replicaId,
       type: options.backendInfo.type,
       options: options.backendInfo.options
     });
-    const dupConfig = allBackends2.find((b) => backendDedupKey(b) === newKey);
+    const dupConfig = allBackends.find((b) => backendDedupKey(b) === newKey);
     if (!hasReplica && !dupConfig) {
       await tempRepo.writeBackendDescriptor({
         id: replicaId,
@@ -1832,13 +1947,13 @@ async function createConfigRepo(appId, options = {}) {
         options: options.backendInfo.options
       });
       console.log(`[createConfigRepo] Added replica backend: ${replicaId} (${options.backendInfo.type})`);
+      allBackends = [...allBackends, { id: replicaId, type: options.backendInfo.type, options: options.backendInfo.options }];
     } else if (dupConfig) {
       console.log(`[createConfigRepo] Replica with same config already registered as "${dupConfig.id}", skipping`);
     } else {
       console.log(`[createConfigRepo] Replica ${replicaId} already registered`);
     }
   }
-  const allBackends = await tempRepo.readAllBackendDescriptors();
   console.log(`[createConfigRepo] Replica backends: ${allBackends.map((b) => b.id).join(", ") || "(none)"}`);
   let nodeId = options.nodeId;
   if (!nodeId) {
@@ -1859,8 +1974,8 @@ async function createConfigRepo(appId, options = {}) {
   await repo.setupSync(allBackends, LOCAL_IDB_BACKEND_ID, options.syncPollIntervalMs);
   await repo.load();
   if (repo.replicaCount > 0) {
-    console.log("[createConfigRepo] Initial sync + dedup cycle...");
-    await repo.initialSyncAndDedup();
+    console.log("[createConfigRepo] Starting background initial sync + dedup...");
+    repo.startBackgroundSync();
   }
   repo.syncMetaToReplicas().catch((err) => {
     console.error("[createConfigRepo] background syncMetaToReplicas failed:", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.5.12",
+  "version": "0.5.14",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -44,7 +44,7 @@
     "@zenfs/core": ">=2.3.0",
     "@zenfs/dom": ">=1.0.0",
     "zen-fs-cache": ">=1.0.0",
-    "zen-fs-sync": ">=0.1.0"
+    "zen-fs-sync": ">=0.4.6"
   },
   "peerDependenciesMeta": {
     "@zenfs/dom": {
@@ -61,6 +61,6 @@
     "typescript": "^5.9.3",
     "vitest": "^1.6.1",
     "zen-fs-cache": "^1.0.1",
-    "zen-fs-sync": "^0.4.3"
+    "zen-fs-sync": "^0.4.6"
   }
 }