zen-fs-config 0.5.34 → 0.5.37

package/dist/{backend-registry-7QGFWLM7.mjs → backend-registry-LELIKPQ4.mjs}

@@ -9,7 +9,7 @@ import {
   registerBackend,
   unregisterBackend,
   wrapZenFSFileSystem
-} from "./chunk-UDEOYFWS.mjs";
+} from "./chunk-4RP2AXAB.mjs";
 export {
   createBackend,
   getAccountFields,

package/dist/{cache-wrapper-XQCPZJCD.mjs → cache-wrapper-S5HRLRQX.mjs}

@@ -9,12 +9,23 @@ function wrapWithCache(backend, backendId, options) {
   } else {
     store = new MemoryCacheStore();
   }
+  try {
+    const purge = store.purgeKeepFiles?.();
+    if (purge && typeof purge.catch === "function") {
+      purge.catch(() => {
+      });
+    }
+  } catch {
+  }
   const wrapped = new CachedFileSystem(backend, store, {
     ttlMs: options.ttlMs ?? 0
   });
   if (typeof backend.shouldSync === "function") {
     wrapped.shouldSync = (...args) => backend.shouldSync(...args);
   }
+  if (typeof backend.writeFileWithMtime === "function") {
+    wrapped.writeFileWithMtime = (path, data, mtimeMs) => backend.writeFileWithMtime(path, data, mtimeMs);
+  }
   return wrapped;
 }
 export {

package/dist/{chunk-UDEOYFWS.mjs → chunk-4RP2AXAB.mjs}

@@ -137,7 +137,9 @@ registerBackend("InMemory", async (options) => {
     { key: "maxSize", label: "Max Size (bytes)", type: "text", placeholder: "104857600" },
     { key: "label", label: "Label", type: "text", placeholder: "zen-fs-config-1" }
   ],
-  defaultOptions: { maxSize: "", label: "" }
+  defaultOptions: { maxSize: "", label: "" },
+  // identity = store label (maxSize is just client-side capacity tuning)
+  identityFields: ["label"]
 });
 registerBackend("IndexedDB", async (options) => {
   const { IndexedDB } = await import("@zenfs/dom");
@@ -151,7 +153,9 @@ registerBackend("IndexedDB", async (options) => {
   fields: [
     { key: "storeName", label: "Store Name", type: "text", placeholder: "zen-fs-config" }
   ],
-  defaultOptions: { storeName: "" }
+  defaultOptions: { storeName: "" },
+  // identity = IndexedDB store name
+  identityFields: ["storeName"]
 });
 var _memCache = /* @__PURE__ */ new Map();
 function _cacheGet(key) {
@@ -260,7 +264,10 @@ registerBackend("GitHub", async (options) => {
     { key: "baseUrl", label: "API URL", type: "text", placeholder: "https://api.github.com" }
   ],
   defaultOptions: { owner: "", repo: "", branch: "main", token: "", baseUrl: "" },
-  accountFields: ["token", "owner", "baseUrl"]
+  accountFields: ["token", "owner", "baseUrl"],
+  // identity = the Git repo location (token is auth, but included so that
+  // same-repo different-credential backends are still treated as distinct)
+  identityFields: ["owner", "repo", "branch", "baseUrl"]
 });
 registerBackend("Gitee", async (options) => {
   const _gt = await importOptionalBackend("zen-fs-gitee");
@@ -290,7 +297,9 @@ registerBackend("Gitee", async (options) => {
     { key: "baseUrl", label: "API URL", type: "text", placeholder: "https://gitee.com/api/v5" }
   ],
   defaultOptions: { owner: "", repo: "", branch: "master", token: "", baseUrl: "" },
-  accountFields: ["token", "owner", "baseUrl"]
+  accountFields: ["token", "owner", "baseUrl"],
+  // identity = the Git repo location
+  identityFields: ["owner", "repo", "branch", "baseUrl"]
 });
 registerBackend("RemoteStorage", async (options) => {
   const _rs = await importOptionalBackend("zen-fs-remotestoragejs");
@@ -317,7 +326,11 @@ registerBackend("RemoteStorage", async (options) => {
     { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" }
   ],
   defaultOptions: { href: "", token: "", basePath: "/" },
-  accountFields: ["href", "token"]
+  accountFields: ["href", "token"],
+  // identity = the RemoteStorage account + subtree. Client tuning (persistCache,
+  // cacheFile, preciseMtime, headers, timeout) is intentionally excluded so two
+  // connections to the same endpoint with different tuning are deduplicated.
+  identityFields: ["href", "token", "basePath"]
 });
 
 export {

package/dist/index.d.mts

@@ -81,8 +81,10 @@ declare function purgeMtimeSidecars(fs: PurgeableFS$1, options?: PurgeMtimeOptio
  * metadata that keep real (empty) directories alive, and deleting them would
  * lose directory structure.
  *
- * The intentional `.keep` under `/.meta/` (used to keep the backends directory
- * alive) is protected and never deleted — see `protectedDirs`.
+ * The intentional `.keep` placeholder at `/.meta/backends/.keep` (used to keep
+ * the backends directory alive) is protected and never deleted — see
+ * `protectedDirs`. Any other `.keep` (including `/.meta/.keep`, which some older
+ * builds leaked into the local primary) is treated as a leak and purged.
  */
 /** Minimal async FS surface needed for the purge. */
 interface PurgeableFS {
@@ -98,9 +100,10 @@ interface PurgeKeepOptions {
     /** Report what would be deleted without unlinking anything. */
     dryRun?: boolean;
     /**
-     * Directories (and their subtrees) whose `.keep` files are NEVER deleted.
-     * Defaults to `['/.meta']` to protect the intentional backends placeholder
-     * that keeps `/.meta/backends` alive.
+     * Exact paths (or directories and their subtrees) whose `.keep` files are
+     * NEVER deleted. Defaults to `['/.meta/backends/.keep']` to protect the
+     * single intentional placeholder that keeps `/.meta/backends` alive. A leaked
+     * `.keep` elsewhere (e.g. `/.meta/.keep`, `/docs/.keep`) is still purged.
      */
     protectedDirs?: string[];
 }
@@ -664,6 +667,21 @@ interface BackendMetadata {
      * Fields not listed here are considered "storage location" fields.
      */
     accountFields?: string[];
+    /**
+     * Option keys that uniquely identify the backend's STORAGE ENDPOINT.
+     * Two descriptors of the same `type` whose `identityFields` values match are
+     * considered the SAME replica (e.g. same RemoteStorage `href`+`token`, or
+     * same Gitee `owner`+`repo`+`branch`) and are deduplicated — even if they
+     * differ in client-side tuning options such as `basePath`, `persistCache`,
+     * `maxSize`, etc.
+     *
+     * When omitted, dedup falls back to the FULL options blob (legacy behavior),
+     * so only types that declare `identityFields` gain the connection-aware
+     * dedup. At minimum include the endpoint-identifying fields; auth/credential
+     * fields may be included or omitted depending on whether same-location
+     * different-credential backends should be treated as distinct.
+     */
+    identityFields?: string[];
 }
 declare function registerBackend(type: string, factory: BackendFactory, metadata?: BackendMetadata): void;
 declare function unregisterBackend(type: string): boolean;

package/dist/index.d.ts

@@ -81,8 +81,10 @@ declare function purgeMtimeSidecars(fs: PurgeableFS$1, options?: PurgeMtimeOptio
  * metadata that keep real (empty) directories alive, and deleting them would
  * lose directory structure.
  *
- * The intentional `.keep` under `/.meta/` (used to keep the backends directory
- * alive) is protected and never deleted — see `protectedDirs`.
+ * The intentional `.keep` placeholder at `/.meta/backends/.keep` (used to keep
+ * the backends directory alive) is protected and never deleted — see
+ * `protectedDirs`. Any other `.keep` (including `/.meta/.keep`, which some older
+ * builds leaked into the local primary) is treated as a leak and purged.
  */
 /** Minimal async FS surface needed for the purge. */
 interface PurgeableFS {
@@ -98,9 +100,10 @@ interface PurgeKeepOptions {
     /** Report what would be deleted without unlinking anything. */
     dryRun?: boolean;
     /**
-     * Directories (and their subtrees) whose `.keep` files are NEVER deleted.
-     * Defaults to `['/.meta']` to protect the intentional backends placeholder
-     * that keeps `/.meta/backends` alive.
+     * Exact paths (or directories and their subtrees) whose `.keep` files are
+     * NEVER deleted. Defaults to `['/.meta/backends/.keep']` to protect the
+     * single intentional placeholder that keeps `/.meta/backends` alive. A leaked
+     * `.keep` elsewhere (e.g. `/.meta/.keep`, `/docs/.keep`) is still purged.
      */
     protectedDirs?: string[];
 }
@@ -664,6 +667,21 @@ interface BackendMetadata {
      * Fields not listed here are considered "storage location" fields.
      */
     accountFields?: string[];
+    /**
+     * Option keys that uniquely identify the backend's STORAGE ENDPOINT.
+     * Two descriptors of the same `type` whose `identityFields` values match are
+     * considered the SAME replica (e.g. same RemoteStorage `href`+`token`, or
+     * same Gitee `owner`+`repo`+`branch`) and are deduplicated — even if they
+     * differ in client-side tuning options such as `basePath`, `persistCache`,
+     * `maxSize`, etc.
+     *
+     * When omitted, dedup falls back to the FULL options blob (legacy behavior),
+     * so only types that declare `identityFields` gain the connection-aware
+     * dedup. At minimum include the endpoint-identifying fields; auth/credential
+     * fields may be included or omitted depending on whether same-location
+     * different-credential backends should be treated as distinct.
+     */
+    identityFields?: string[];
 }
 declare function registerBackend(type: string, factory: BackendFactory, metadata?: BackendMetadata): void;
 declare function unregisterBackend(type: string): boolean;

package/dist/index.js

@@ -231,7 +231,9 @@ var init_backend_registry = __esm({
         { key: "maxSize", label: "Max Size (bytes)", type: "text", placeholder: "104857600" },
         { key: "label", label: "Label", type: "text", placeholder: "zen-fs-config-1" }
       ],
-      defaultOptions: { maxSize: "", label: "" }
+      defaultOptions: { maxSize: "", label: "" },
+      // identity = store label (maxSize is just client-side capacity tuning)
+      identityFields: ["label"]
     });
     registerBackend("IndexedDB", async (options) => {
       const { IndexedDB } = await import("@zenfs/dom");
@@ -245,7 +247,9 @@ var init_backend_registry = __esm({
       fields: [
         { key: "storeName", label: "Store Name", type: "text", placeholder: "zen-fs-config" }
       ],
-      defaultOptions: { storeName: "" }
+      defaultOptions: { storeName: "" },
+      // identity = IndexedDB store name
+      identityFields: ["storeName"]
     });
     _memCache = /* @__PURE__ */ new Map();
     OPTIONAL_BACKEND_GLOBALS = {
@@ -309,7 +313,10 @@ var init_backend_registry = __esm({
         { key: "baseUrl", label: "API URL", type: "text", placeholder: "https://api.github.com" }
       ],
       defaultOptions: { owner: "", repo: "", branch: "main", token: "", baseUrl: "" },
-      accountFields: ["token", "owner", "baseUrl"]
+      accountFields: ["token", "owner", "baseUrl"],
+      // identity = the Git repo location (token is auth, but included so that
+      // same-repo different-credential backends are still treated as distinct)
+      identityFields: ["owner", "repo", "branch", "baseUrl"]
     });
     registerBackend("Gitee", async (options) => {
       const _gt = await importOptionalBackend("zen-fs-gitee");
@@ -339,7 +346,9 @@ var init_backend_registry = __esm({
         { key: "baseUrl", label: "API URL", type: "text", placeholder: "https://gitee.com/api/v5" }
       ],
       defaultOptions: { owner: "", repo: "", branch: "master", token: "", baseUrl: "" },
-      accountFields: ["token", "owner", "baseUrl"]
+      accountFields: ["token", "owner", "baseUrl"],
+      // identity = the Git repo location
+      identityFields: ["owner", "repo", "branch", "baseUrl"]
     });
     registerBackend("RemoteStorage", async (options) => {
       const _rs = await importOptionalBackend("zen-fs-remotestoragejs");
@@ -366,7 +375,11 @@ var init_backend_registry = __esm({
         { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" }
       ],
       defaultOptions: { href: "", token: "", basePath: "/" },
-      accountFields: ["href", "token"]
+      accountFields: ["href", "token"],
+      // identity = the RemoteStorage account + subtree. Client tuning (persistCache,
+      // cacheFile, preciseMtime, headers, timeout) is intentionally excluded so two
+      // connections to the same endpoint with different tuning are deduplicated.
+      identityFields: ["href", "token", "basePath"]
     });
   }
 });
@@ -385,12 +398,23 @@ function wrapWithCache(backend, backendId, options) {
   } else {
     store = new import_zen_fs_cache.MemoryCacheStore();
   }
+  try {
+    const purge = store.purgeKeepFiles?.();
+    if (purge && typeof purge.catch === "function") {
+      purge.catch(() => {
+      });
+    }
+  } catch {
+  }
   const wrapped = new import_zen_fs_cache.CachedFileSystem(backend, store, {
     ttlMs: options.ttlMs ?? 0
   });
   if (typeof backend.shouldSync === "function") {
     wrapped.shouldSync = (...args) => backend.shouldSync(...args);
   }
+  if (typeof backend.writeFileWithMtime === "function") {
+    wrapped.writeFileWithMtime = (path, data, mtimeMs) => backend.writeFileWithMtime(path, data, mtimeMs);
+  }
   return wrapped;
 }
 var import_zen_fs_cache;
@@ -1124,7 +1148,7 @@ function isKeepFile(fileName) {
   return fileName === ".keep";
 }
 var S_IFDIR2 = 16384;
-var DEFAULT_PROTECTED_DIRS = ["/.meta"];
+var DEFAULT_PROTECTED_DIRS = ["/.meta/backends/.keep"];
 function isDirectory2(stat) {
   return typeof stat.mode === "number" && (stat.mode & S_IFDIR2) === S_IFDIR2;
 }
@@ -1335,8 +1359,17 @@ function sortKeysDeep(obj) {
   }
   return sorted;
 }
+function identityOptions(type, options) {
+  const fields = getBackendMetadata(type)?.identityFields;
+  if (!fields || fields.length === 0) return options ?? {};
+  const subset = {};
+  for (const f of fields) {
+    if (options && options[f] !== void 0) subset[f] = options[f];
+  }
+  return subset;
+}
 function backendDedupKey(desc) {
-  return `${desc.type}:${stableOptionsKey(desc.options)}`;
+  return `${desc.type}:${stableOptionsKey(identityOptions(desc.type, desc.options))}`;
 }
 function backendAgeRank(b) {
   if (typeof b.createdAt === "number") return b.createdAt;

package/dist/index.mjs

@@ -9,7 +9,7 @@ import {
   registerBackend,
   unregisterBackend,
   wrapZenFSFileSystem
-} from "./chunk-UDEOYFWS.mjs";
+} from "./chunk-4RP2AXAB.mjs";
 
 // src/config-repo.ts
 import {
@@ -351,7 +351,7 @@ function registerFolderBackend() {
       const pathMod = await import("path");
       const dir = options.path;
       const store = new FolderStore({ path: dir, label: options.label, fs, pathMod });
-      return (await import("./backend-registry-7QGFWLM7.mjs")).wrapZenFSFileSystem({ backend: FolderBackend, path: dir, label: options.label });
+      return (await import("./backend-registry-LELIKPQ4.mjs")).wrapZenFSFileSystem({ backend: FolderBackend, path: dir, label: options.label });
     },
     {
       type: "Folder",
@@ -693,7 +693,7 @@ function isKeepFile(fileName) {
   return fileName === ".keep";
 }
 var S_IFDIR2 = 16384;
-var DEFAULT_PROTECTED_DIRS = ["/.meta"];
+var DEFAULT_PROTECTED_DIRS = ["/.meta/backends/.keep"];
 function isDirectory2(stat) {
   return typeof stat.mode === "number" && (stat.mode & S_IFDIR2) === S_IFDIR2;
 }
@@ -904,8 +904,17 @@ function sortKeysDeep(obj) {
   }
   return sorted;
 }
+function identityOptions(type, options) {
+  const fields = getBackendMetadata(type)?.identityFields;
+  if (!fields || fields.length === 0) return options ?? {};
+  const subset = {};
+  for (const f of fields) {
+    if (options && options[f] !== void 0) subset[f] = options[f];
+  }
+  return subset;
+}
 function backendDedupKey(desc) {
-  return `${desc.type}:${stableOptionsKey(desc.options)}`;
+  return `${desc.type}:${stableOptionsKey(identityOptions(desc.type, desc.options))}`;
 }
 function backendAgeRank(b) {
   if (typeof b.createdAt === "number") return b.createdAt;
@@ -1635,7 +1644,7 @@ var ConfigRepo = class {
         const instance = await createBackend(desc);
         let fsInstance = instance;
         if (this.cacheOptions) {
-          const { wrapWithCache } = await import("./cache-wrapper-XQCPZJCD.mjs");
+          const { wrapWithCache } = await import("./cache-wrapper-S5HRLRQX.mjs");
           fsInstance = wrapWithCache(instance, desc.id, this.cacheOptions);
           log2.log(`[ConfigRepo] Replica ${desc.id} wrapped with CachedFileSystem (store=${this.cacheOptions.storeType ?? "IdbCacheStore"})`);
         }

package/dist/zen-fs-config.js

@@ -24544,7 +24544,9 @@ var ZenFSConfig = (() => {
           { key: "maxSize", label: "Max Size (bytes)", type: "text", placeholder: "104857600" },
           { key: "label", label: "Label", type: "text", placeholder: "zen-fs-config-1" }
         ],
-        defaultOptions: { maxSize: "", label: "" }
+        defaultOptions: { maxSize: "", label: "" },
+        // identity = store label (maxSize is just client-side capacity tuning)
+        identityFields: ["label"]
       });
       registerBackend("IndexedDB", async (options) => {
         const { IndexedDB: IndexedDB2 } = await Promise.resolve().then(() => (init_dist5(), dist_exports2));
@@ -24558,7 +24560,9 @@ var ZenFSConfig = (() => {
         fields: [
           { key: "storeName", label: "Store Name", type: "text", placeholder: "zen-fs-config" }
         ],
-        defaultOptions: { storeName: "" }
+        defaultOptions: { storeName: "" },
+        // identity = IndexedDB store name
+        identityFields: ["storeName"]
       });
       _memCache = /* @__PURE__ */ new Map();
       OPTIONAL_BACKEND_GLOBALS = {
@@ -24622,7 +24626,10 @@ var ZenFSConfig = (() => {
           { key: "baseUrl", label: "API URL", type: "text", placeholder: "https://api.github.com" }
         ],
         defaultOptions: { owner: "", repo: "", branch: "main", token: "", baseUrl: "" },
-        accountFields: ["token", "owner", "baseUrl"]
+        accountFields: ["token", "owner", "baseUrl"],
+        // identity = the Git repo location (token is auth, but included so that
+        // same-repo different-credential backends are still treated as distinct)
+        identityFields: ["owner", "repo", "branch", "baseUrl"]
       });
       registerBackend("Gitee", async (options) => {
         const _gt = await importOptionalBackend("zen-fs-gitee");
@@ -24652,7 +24659,9 @@ var ZenFSConfig = (() => {
           { key: "baseUrl", label: "API URL", type: "text", placeholder: "https://gitee.com/api/v5" }
         ],
         defaultOptions: { owner: "", repo: "", branch: "master", token: "", baseUrl: "" },
-        accountFields: ["token", "owner", "baseUrl"]
+        accountFields: ["token", "owner", "baseUrl"],
+        // identity = the Git repo location
+        identityFields: ["owner", "repo", "branch", "baseUrl"]
       });
       registerBackend("RemoteStorage", async (options) => {
         const _rs = await importOptionalBackend("zen-fs-remotestoragejs");
@@ -24679,7 +24688,11 @@ var ZenFSConfig = (() => {
           { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" }
         ],
         defaultOptions: { href: "", token: "", basePath: "/" },
-        accountFields: ["href", "token"]
+        accountFields: ["href", "token"],
+        // identity = the RemoteStorage account + subtree. Client tuning (persistCache,
+        // cacheFile, preciseMtime, headers, timeout) is intentionally excluded so two
+        // connections to the same endpoint with different tuning are deduplicated.
+        identityFields: ["href", "token", "basePath"]
       });
     }
   });
@@ -24886,10 +24899,35 @@ var ZenFSConfig = (() => {
         }
         async exists(path) {
           try {
+            const innerType = this.inner?.constructor?.name ?? typeof this.inner;
+            const hasStat = typeof this.inner?.stat === "function";
+            const hasExists = typeof this.inner?.exists === "function";
+            const backendName = this.inner?.backendName ?? this.inner?.constructor?.name ?? "unknown";
+            console.log(`[CACHE-EXISTS] exists(${path}): inner=${innerType} backend=${backendName} hasStat=${hasStat} hasExists=${hasExists}`);
+            const statKey = `stat:${path}`;
+            const cachedStat = await this.store.get(statKey);
+            if (cachedStat) {
+              const age = Date.now() - cachedStat.cachedAt;
+              console.log(`[CACHE-EXISTS] exists(${path}): cached stat entry found, age=${age}ms, ttlMs=${this.ttlMs}`);
+            } else {
+              console.log(`[CACHE-EXISTS] exists(${path}): no cached stat entry`);
+            }
+            if (hasExists) {
+              console.log(`[CACHE-EXISTS] exists(${path}): \u2192 calling inner.exists() [backend=${backendName}]`);
+              const result = await this.inner.exists(path);
+              console.log(`[CACHE-EXISTS] exists(${path}): \u2190 inner.exists() [backend=${backendName}] \u2192 ${result}`);
+              return result;
+            }
+            console.log(`[CACHE-EXISTS] exists(${path}): no inner.exists(), falling back to inner.stat() [backend=${backendName}]`);
             await this.inner.stat(path);
+            console.log(`[CACHE-EXISTS] exists(${path}): \u2190 inner.stat() [backend=${backendName}] \u2192 OK (exists)`);
             return true;
           } catch (err2) {
-            if (this.isNotFound(err2)) return false;
+            if (this.isNotFound(err2)) {
+              console.log(`[CACHE-EXISTS] exists(${path}): \u2190 inner.stat() \u2192 NotFound`);
+              return false;
+            }
+            console.log(`[CACHE-EXISTS] exists(${path}): \u2190 inner.stat() \u2192 ERROR: ${err2}`);
             throw err2;
           }
         }
@@ -24922,7 +24960,10 @@ var ZenFSConfig = (() => {
           await this.invalidateMeta(path);
         }
         async unlink(path) {
+          const backendName = this.inner?.backendName ?? this.inner?.constructor?.name ?? "unknown";
+          console.log(`[CACHE-UNLINK] unlink(${path}): calling inner.unlink() [backend=${backendName}]`);
           await this.inner.unlink(path);
+          console.log(`[CACHE-UNLINK] unlink(${path}): inner.unlink() OK [backend=${backendName}], invalidating cache`);
           await this.invalidate(path);
         }
         async mkdir(path, options) {
@@ -24981,6 +25022,12 @@ var ZenFSConfig = (() => {
         async clear() {
           this.store.clear();
         }
+        async purgeKeepFiles() {
+          for (const key of Array.from(this.store.keys())) {
+            const base = key === "/" ? "" : key.split("/").pop() ?? "";
+            if (base === ".keep") this.store.delete(key);
+          }
+        }
       };
       IdbCacheStore = class {
         constructor(prefix = "zen-fs-cache:", dbName = "zen-fs-cache", storeName = "cache") {
@@ -25061,6 +25108,28 @@ var ZenFSConfig = (() => {
           } catch {
           }
         }
+        async purgeKeepFiles() {
+          try {
+            const db = await this.open();
+            await new Promise((resolve4, reject) => {
+              const tx = db.transaction(this.storeName, "readwrite");
+              const store = tx.objectStore(this.storeName);
+              const req = store.getAllKeys();
+              req.onsuccess = () => {
+                const keys = req.result ?? [];
+                for (const raw of keys) {
+                  const path = raw.startsWith(this.prefix) ? raw.slice(this.prefix.length) : raw;
+                  const base = path === "/" ? "" : path.split("/").pop() ?? "";
+                  if (base === ".keep") store.delete(raw);
+                }
+              };
+              req.onerror = () => reject(req.error);
+              tx.oncomplete = () => resolve4();
+              tx.onerror = () => reject(tx.error);
+            });
+          } catch {
+          }
+        }
       };
     }
   });
@@ -25079,12 +25148,23 @@ var ZenFSConfig = (() => {
     } else {
       store = new MemoryCacheStore();
     }
+    try {
+      const purge = store.purgeKeepFiles?.();
+      if (purge && typeof purge.catch === "function") {
+        purge.catch(() => {
+        });
+      }
+    } catch {
+    }
     const wrapped = new CachedFileSystem(backend, store, {
       ttlMs: options.ttlMs ?? 0
     });
     if (typeof backend.shouldSync === "function") {
       wrapped.shouldSync = (...args) => backend.shouldSync(...args);
     }
+    if (typeof backend.writeFileWithMtime === "function") {
+      wrapped.writeFileWithMtime = (path, data, mtimeMs) => backend.writeFileWithMtime(path, data, mtimeMs);
+    }
     return wrapped;
   }
   var init_cache_wrapper = __esm({
@@ -27001,7 +27081,7 @@ var ZenFSConfig = (() => {
     return fileName === ".keep";
   }
   var S_IFDIR3 = 16384;
-  var DEFAULT_PROTECTED_DIRS = ["/.meta"];
+  var DEFAULT_PROTECTED_DIRS = ["/.meta/backends/.keep"];
   function isDirectory4(stat5) {
     return typeof stat5.mode === "number" && (stat5.mode & S_IFDIR3) === S_IFDIR3;
   }
@@ -27212,8 +27292,17 @@ var ZenFSConfig = (() => {
     }
     return sorted;
   }
+  function identityOptions(type, options) {
+    const fields = getBackendMetadata(type)?.identityFields;
+    if (!fields || fields.length === 0) return options ?? {};
+    const subset = {};
+    for (const f of fields) {
+      if (options && options[f] !== void 0) subset[f] = options[f];
+    }
+    return subset;
+  }
   function backendDedupKey(desc) {
-    return `${desc.type}:${stableOptionsKey(desc.options)}`;
+    return `${desc.type}:${stableOptionsKey(identityOptions(desc.type, desc.options))}`;
   }
   function backendAgeRank(b) {
     if (typeof b.createdAt === "number") return b.createdAt;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.5.34",
+  "version": "0.5.37",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -80,7 +80,7 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^1.6.1",
-    "zen-fs-cache": "^1.0.1",
+    "zen-fs-cache": "^1.0.6",
     "zen-fs-sync": "^0.4.9"
   }
 }