zen-fs-config 0.5.39 → 0.5.41

package/dist/{backend-registry-3FVPYPZL.mjs → backend-registry-RBKWNJZI.mjs}

@@ -9,7 +9,7 @@ import {
   registerBackend,
   unregisterBackend,
   wrapZenFSFileSystem
-} from "./chunk-6OS2F54Z.mjs";
+} from "./chunk-S2S3XBK2.mjs";
 export {
   createBackend,
   getAccountFields,

package/dist/{chunk-6OS2F54Z.mjs → chunk-S2S3XBK2.mjs}

@@ -122,6 +122,9 @@ async function wrapZenFSFileSystem(config) {
   if (typeof isolatedFS.writeFileWithMtime === "function") {
     backend.writeFileWithMtime = (path, data, mtimeMs) => isolatedFS.writeFileWithMtime(path, data, mtimeMs);
   }
+  if (typeof isolatedFS.shouldSync === "function") {
+    backend.shouldSync = (...args) => isolatedFS.shouldSync(...args);
+  }
   return backend;
 }
 var inMemoryCounter = 0;
@@ -185,7 +188,8 @@ var OPTIONAL_BACKEND_GLOBALS = {
   // third-party Gitee widget) would shadow the real backend and break mounting
   // with "Invalid mount configuration".
   "zen-fs-gitee": ["ZenFSGitee"],
-  "zen-fs-remotestoragejs": ["ZenFSRemoteStorage", "RemoteStorageFileSystem"]
+  "zen-fs-remotestoragejs": ["ZenFSRemoteStorage", "RemoteStorageFileSystem"],
+  "zen-fs-webdav": ["ZenFSWebDAV"]
 };
 async function importOptionalBackend(pkg) {
   const candidates = OPTIONAL_BACKEND_GLOBALS[pkg];
@@ -273,9 +277,9 @@ registerBackend("GitHub", async (options) => {
 registerBackend("Gitee", async (options) => {
   const _gt = await importOptionalBackend("zen-fs-gitee");
   const Gitee = _gt?.Gitee ?? _gt?.default;
-  if (typeof Gitee !== "function") {
+  if (!Gitee || typeof Gitee !== "function" && typeof Gitee.create !== "function") {
     throw new Error(
-      `Backend package "zen-fs-gitee" loaded, but its Gitee export is not a constructor (typeof=${typeof Gitee}). Load its UMD bundle so it exposes the global "ZenFSGitee".`
+      `Backend package "zen-fs-gitee" loaded, but its Gitee export is not a usable backend (typeof=${typeof Gitee}). Load its UMD bundle so it exposes the global "ZenFSGitee".`
     );
   }
   return wrapZenFSFileSystem({
@@ -302,6 +306,39 @@ registerBackend("Gitee", async (options) => {
   // identity = the Git repo location
   identityFields: ["owner", "repo", "branch", "baseUrl"]
 });
+async function resolveRemoteStorageHref(href) {
+  const raw = String(href ?? "").trim();
+  if (!raw) throw new Error("RemoteStorage href is required.");
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(raw)) return raw.replace(/\/+$/, "");
+  const match = raw.match(/^(?:acct:)?([^@/]+)@([^@/]+)$/);
+  if (!match) {
+    throw new Error(
+      `RemoteStorage href "${raw}" is neither an absolute URL nor a user address (user@domain).`
+    );
+  }
+  const user = match[1];
+  const domain = match[2];
+  const webfingerUrl = `https://${domain}/.well-known/webfinger?resource=acct:${encodeURIComponent(user)}@${encodeURIComponent(domain)}`;
+  let response;
+  try {
+    response = await globalThis.fetch(webfingerUrl, {
+      headers: { Accept: "application/jrd+json, application/json" }
+    });
+  } catch (err) {
+    throw new Error(
+      `RemoteStorage WebFinger request failed (${webfingerUrl}): ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (!response.ok) {
+    throw new Error(`RemoteStorage WebFinger lookup failed (HTTP ${response.status}): ${webfingerUrl}`);
+  }
+  const jrd = await response.json();
+  const link = (jrd?.links ?? []).find(
+    (item) => item && item.rel === "http://tools.ietf.org/id/draft-dejong-remotestorage" && item.href
+  );
+  if (!link) throw new Error(`WebFinger response has no RemoteStorage link: ${webfingerUrl}`);
+  return String(link.href).replace(/\/+$/, "");
+}
 registerBackend("RemoteStorage", async (options) => {
   const _rs = await importOptionalBackend("zen-fs-remotestoragejs");
   const RemoteStorageFileSystem = _rs?.RemoteStorageFileSystem ?? _rs?.default ?? (typeof _rs === "function" ? _rs : void 0);
@@ -311,7 +348,7 @@ registerBackend("RemoteStorage", async (options) => {
     );
   }
   return new RemoteStorageFileSystem({
-    href: options.href,
+    href: await resolveRemoteStorageHref(options.href),
     token: options.token,
     basePath: options.basePath || void 0,
     preciseMtime: true,
@@ -322,7 +359,7 @@ registerBackend("RemoteStorage", async (options) => {
   label: "RemoteStorage",
   icon: "\u{1F4E1}",
   fields: [
-    { key: "href", label: "User Address (href)", type: "text", placeholder: "user@5apps.com", required: true },
+    { key: "href", label: "User Address / Storage URL (href)", type: "text", placeholder: "user@5apps.com \u6216 https://storage.5apps.com/user", required: true },
     { key: "token", label: "Bearer Token", type: "password", placeholder: "rs-xxxxxxxx", required: true },
     { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" }
   ],
@@ -333,6 +370,53 @@ registerBackend("RemoteStorage", async (options) => {
   // connections to the same endpoint with different tuning are deduplicated.
   identityFields: ["href", "token", "basePath"]
 });
+registerBackend("WebDAV", async (options) => {
+  const _dav = await importOptionalBackend("zen-fs-webdav");
+  const SyncableWebDAVFS = _dav?.SyncableWebDAVFS ?? _dav?.default?.SyncableWebDAVFS ?? globalThis.ZenFSWebDAV?.SyncableWebDAVFS;
+  if (typeof SyncableWebDAVFS !== "function") {
+    throw new Error(
+      `Backend package "zen-fs-webdav" loaded, but its SyncableWebDAVFS export is not a constructor (typeof=${typeof SyncableWebDAVFS}). Run: npm install zen-fs-webdav, or load its UMD bundle via <script src=".../zen-fs-webdav.global.js"> so it exposes the global "ZenFSWebDAV".`
+    );
+  }
+  const instance = new SyncableWebDAVFS({
+    baseUrl: options.baseUrl,
+    username: options.username,
+    password: options.password,
+    token: options.token,
+    headers: options.headers,
+    timeout: options.timeout,
+    preciseMtime: true
+  });
+  if (options.purgeLegacyMtime === true) {
+    try {
+      await instance.purgeLegacyMtimeSidecars({ root: options.basePath ?? "/" });
+    } catch {
+    }
+  }
+  return instance;
+}, {
+  type: "WebDAV",
+  label: "WebDAV",
+  icon: "\u2601\uFE0F",
+  fields: [
+    { key: "baseUrl", label: "Base URL", type: "text", placeholder: "https://dav.example.com/remote.php/dav/files/user/", required: true },
+    { key: "username", label: "Username", type: "text", placeholder: "admin" },
+    { key: "password", label: "Password", type: "password" },
+    { key: "token", label: "Token", type: "password", placeholder: "Bearer token (optional)" },
+    { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" },
+    { key: "purgeLegacyMtime", label: "Purge legacy .mtime sidecars", type: "select", options: [
+      { value: "false", label: "no (default)" },
+      { value: "true", label: "yes (one-time migration)" }
+    ] }
+  ],
+  defaultOptions: { baseUrl: "", username: "", password: "", token: "", basePath: "/", purgeLegacyMtime: "false" },
+  // accountFields: credentials live on the endpoint, so a data-sync group can
+  // reuse them from an already-connected config-sync WebDAV backend.
+  accountFields: ["username", "password", "token"],
+  // identity = the WebDAV endpoint. Credentials are auth, not location, so two
+  // connections to the same URL are deduplicated as one replica.
+  identityFields: ["baseUrl"]
+});
 
 export {
   registerBackend,

package/dist/index.js

@@ -165,6 +165,9 @@ async function wrapZenFSFileSystem(config) {
   if (typeof isolatedFS.writeFileWithMtime === "function") {
     backend.writeFileWithMtime = (path, data, mtimeMs) => isolatedFS.writeFileWithMtime(path, data, mtimeMs);
   }
+  if (typeof isolatedFS.shouldSync === "function") {
+    backend.shouldSync = (...args) => isolatedFS.shouldSync(...args);
+  }
   return backend;
 }
 function _cacheGet(key) {
@@ -212,6 +215,39 @@ async function importOptionalBackend(pkg) {
     );
   }
 }
+async function resolveRemoteStorageHref(href) {
+  const raw = String(href ?? "").trim();
+  if (!raw) throw new Error("RemoteStorage href is required.");
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(raw)) return raw.replace(/\/+$/, "");
+  const match = raw.match(/^(?:acct:)?([^@/]+)@([^@/]+)$/);
+  if (!match) {
+    throw new Error(
+      `RemoteStorage href "${raw}" is neither an absolute URL nor a user address (user@domain).`
+    );
+  }
+  const user = match[1];
+  const domain = match[2];
+  const webfingerUrl = `https://${domain}/.well-known/webfinger?resource=acct:${encodeURIComponent(user)}@${encodeURIComponent(domain)}`;
+  let response;
+  try {
+    response = await globalThis.fetch(webfingerUrl, {
+      headers: { Accept: "application/jrd+json, application/json" }
+    });
+  } catch (err) {
+    throw new Error(
+      `RemoteStorage WebFinger request failed (${webfingerUrl}): ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (!response.ok) {
+    throw new Error(`RemoteStorage WebFinger lookup failed (HTTP ${response.status}): ${webfingerUrl}`);
+  }
+  const jrd = await response.json();
+  const link = (jrd?.links ?? []).find(
+    (item) => item && item.rel === "http://tools.ietf.org/id/draft-dejong-remotestorage" && item.href
+  );
+  if (!link) throw new Error(`WebFinger response has no RemoteStorage link: ${webfingerUrl}`);
+  return String(link.href).replace(/\/+$/, "");
+}
 var registry, metadataRegistry, inMemoryCounter, _memCache, OPTIONAL_BACKEND_GLOBALS;
 var init_backend_registry = __esm({
   "src/backend-registry.ts"() {
@@ -260,7 +296,8 @@ var init_backend_registry = __esm({
       // third-party Gitee widget) would shadow the real backend and break mounting
       // with "Invalid mount configuration".
       "zen-fs-gitee": ["ZenFSGitee"],
-      "zen-fs-remotestoragejs": ["ZenFSRemoteStorage", "RemoteStorageFileSystem"]
+      "zen-fs-remotestoragejs": ["ZenFSRemoteStorage", "RemoteStorageFileSystem"],
+      "zen-fs-webdav": ["ZenFSWebDAV"]
     };
     registerBackend("GitHub", async (options) => {
       const _gh = await importOptionalBackend("zen-fs-github");
@@ -322,9 +359,9 @@ var init_backend_registry = __esm({
     registerBackend("Gitee", async (options) => {
       const _gt = await importOptionalBackend("zen-fs-gitee");
       const Gitee = _gt?.Gitee ?? _gt?.default;
-      if (typeof Gitee !== "function") {
+      if (!Gitee || typeof Gitee !== "function" && typeof Gitee.create !== "function") {
         throw new Error(
-          `Backend package "zen-fs-gitee" loaded, but its Gitee export is not a constructor (typeof=${typeof Gitee}). Load its UMD bundle so it exposes the global "ZenFSGitee".`
+          `Backend package "zen-fs-gitee" loaded, but its Gitee export is not a usable backend (typeof=${typeof Gitee}). Load its UMD bundle so it exposes the global "ZenFSGitee".`
         );
       }
       return wrapZenFSFileSystem({
@@ -360,7 +397,7 @@ var init_backend_registry = __esm({
         );
       }
       return new RemoteStorageFileSystem({
-        href: options.href,
+        href: await resolveRemoteStorageHref(options.href),
         token: options.token,
         basePath: options.basePath || void 0,
         preciseMtime: true,
@@ -371,7 +408,7 @@ var init_backend_registry = __esm({
       label: "RemoteStorage",
       icon: "\u{1F4E1}",
       fields: [
-        { key: "href", label: "User Address (href)", type: "text", placeholder: "user@5apps.com", required: true },
+        { key: "href", label: "User Address / Storage URL (href)", type: "text", placeholder: "user@5apps.com \u6216 https://storage.5apps.com/user", required: true },
         { key: "token", label: "Bearer Token", type: "password", placeholder: "rs-xxxxxxxx", required: true },
         { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" }
       ],
@@ -382,6 +419,53 @@ var init_backend_registry = __esm({
       // connections to the same endpoint with different tuning are deduplicated.
       identityFields: ["href", "token", "basePath"]
     });
+    registerBackend("WebDAV", async (options) => {
+      const _dav = await importOptionalBackend("zen-fs-webdav");
+      const SyncableWebDAVFS = _dav?.SyncableWebDAVFS ?? _dav?.default?.SyncableWebDAVFS ?? globalThis.ZenFSWebDAV?.SyncableWebDAVFS;
+      if (typeof SyncableWebDAVFS !== "function") {
+        throw new Error(
+          `Backend package "zen-fs-webdav" loaded, but its SyncableWebDAVFS export is not a constructor (typeof=${typeof SyncableWebDAVFS}). Run: npm install zen-fs-webdav, or load its UMD bundle via <script src=".../zen-fs-webdav.global.js"> so it exposes the global "ZenFSWebDAV".`
+        );
+      }
+      const instance = new SyncableWebDAVFS({
+        baseUrl: options.baseUrl,
+        username: options.username,
+        password: options.password,
+        token: options.token,
+        headers: options.headers,
+        timeout: options.timeout,
+        preciseMtime: true
+      });
+      if (options.purgeLegacyMtime === true) {
+        try {
+          await instance.purgeLegacyMtimeSidecars({ root: options.basePath ?? "/" });
+        } catch {
+        }
+      }
+      return instance;
+    }, {
+      type: "WebDAV",
+      label: "WebDAV",
+      icon: "\u2601\uFE0F",
+      fields: [
+        { key: "baseUrl", label: "Base URL", type: "text", placeholder: "https://dav.example.com/remote.php/dav/files/user/", required: true },
+        { key: "username", label: "Username", type: "text", placeholder: "admin" },
+        { key: "password", label: "Password", type: "password" },
+        { key: "token", label: "Token", type: "password", placeholder: "Bearer token (optional)" },
+        { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" },
+        { key: "purgeLegacyMtime", label: "Purge legacy .mtime sidecars", type: "select", options: [
+          { value: "false", label: "no (default)" },
+          { value: "true", label: "yes (one-time migration)" }
+        ] }
+      ],
+      defaultOptions: { baseUrl: "", username: "", password: "", token: "", basePath: "/", purgeLegacyMtime: "false" },
+      // accountFields: credentials live on the endpoint, so a data-sync group can
+      // reuse them from an already-connected config-sync WebDAV backend.
+      accountFields: ["username", "password", "token"],
+      // identity = the WebDAV endpoint. Credentials are auth, not location, so two
+      // connections to the same URL are deduplicated as one replica.
+      identityFields: ["baseUrl"]
+    });
   }
 });
 
@@ -1367,6 +1451,12 @@ function identityOptions(type, options) {
   for (const f of fields) {
     if (options && options[f] !== void 0) subset[f] = options[f];
   }
+  if (type === "Gitee" || type === "GitHub") {
+    const defaultEndpoint = type === "Gitee" ? "https://gitee.com/api/v5" : "https://api.github.com";
+    const raw = options && options.baseUrl;
+    const value = typeof raw === "string" && raw.trim() !== "" ? raw : defaultEndpoint;
+    subset["baseUrl"] = value.replace(/\/+$/, "");
+  }
   return subset;
 }
 function backendDedupKey(desc) {
@@ -2757,10 +2847,15 @@ var ConfigRepo = class {
     }
     const descPath = this.appDataGroupFilePath(id);
     try {
-      await this.cachedFS.unlink(descPath);
-    } catch {
+      await this.deleteFile(descPath);
+    } catch (err) {
+      log2.log(`[ConfigRepo] removeAppDataGroup: deleteFile failed for "${id}":`, err);
+      try {
+        await this.cachedFS.unlink(descPath);
+      } catch {
+      }
+      await this.unlinkVersionSidecar(this.cachedFS, descPath);
     }
-    await this.unlinkVersionSidecar(this.cachedFS, descPath);
     log2.log(`[ConfigRepo] removeAppDataGroup: "${id}" removed`);
   }
   async listAccountBackends() {
@@ -3143,12 +3238,25 @@ async function connect(appId, options = {}) {
       onConflict: options.onConflict,
       syncPollIntervalMs: options.syncPollIntervalMs
     });
-    const dataGroup2 = await repo2.createAppDataGroup("default", []);
+    const appDataGroups2 = [];
+    const descriptors2 = await repo2.listAppDataGroups();
+    for (const d of descriptors2) {
+      try {
+        appDataGroups2.push(await repo2.getAppDataGroup(d.id));
+      } catch (err) {
+        log3(`connect: failed to load app data group "${d.id}":`, err);
+      }
+    }
+    let dataGroup2 = appDataGroups2[0];
+    if (!dataGroup2) {
+      dataGroup2 = await repo2.createAppDataGroup("default", []);
+      appDataGroups2.push(dataGroup2);
+    }
     return {
       groupType: options.groupType ?? "config-sync",
       repo: repo2,
       dataGroup: dataGroup2,
-      appDataGroups: [dataGroup2]
+      appDataGroups: appDataGroups2
     };
   }
   const { type, options: backendOptions } = options.backendInfo;

package/dist/index.mjs

@@ -9,7 +9,7 @@ import {
   registerBackend,
   unregisterBackend,
   wrapZenFSFileSystem
-} from "./chunk-6OS2F54Z.mjs";
+} from "./chunk-S2S3XBK2.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-3FVPYPZL.mjs")).wrapZenFSFileSystem({ backend: FolderBackend, path: dir, label: options.label });
+      return (await import("./backend-registry-RBKWNJZI.mjs")).wrapZenFSFileSystem({ backend: FolderBackend, path: dir, label: options.label });
     },
     {
       type: "Folder",
@@ -911,6 +911,12 @@ function identityOptions(type, options) {
   for (const f of fields) {
     if (options && options[f] !== void 0) subset[f] = options[f];
   }
+  if (type === "Gitee" || type === "GitHub") {
+    const defaultEndpoint = type === "Gitee" ? "https://gitee.com/api/v5" : "https://api.github.com";
+    const raw = options && options.baseUrl;
+    const value = typeof raw === "string" && raw.trim() !== "" ? raw : defaultEndpoint;
+    subset["baseUrl"] = value.replace(/\/+$/, "");
+  }
   return subset;
 }
 function backendDedupKey(desc) {
@@ -2301,10 +2307,15 @@ var ConfigRepo = class {
     }
     const descPath = this.appDataGroupFilePath(id);
     try {
-      await this.cachedFS.unlink(descPath);
-    } catch {
+      await this.deleteFile(descPath);
+    } catch (err) {
+      log2.log(`[ConfigRepo] removeAppDataGroup: deleteFile failed for "${id}":`, err);
+      try {
+        await this.cachedFS.unlink(descPath);
+      } catch {
+      }
+      await this.unlinkVersionSidecar(this.cachedFS, descPath);
     }
-    await this.unlinkVersionSidecar(this.cachedFS, descPath);
     log2.log(`[ConfigRepo] removeAppDataGroup: "${id}" removed`);
   }
   async listAccountBackends() {
@@ -2686,12 +2697,25 @@ async function connect(appId, options = {}) {
       onConflict: options.onConflict,
       syncPollIntervalMs: options.syncPollIntervalMs
     });
-    const dataGroup2 = await repo2.createAppDataGroup("default", []);
+    const appDataGroups2 = [];
+    const descriptors2 = await repo2.listAppDataGroups();
+    for (const d of descriptors2) {
+      try {
+        appDataGroups2.push(await repo2.getAppDataGroup(d.id));
+      } catch (err) {
+        log3(`connect: failed to load app data group "${d.id}":`, err);
+      }
+    }
+    let dataGroup2 = appDataGroups2[0];
+    if (!dataGroup2) {
+      dataGroup2 = await repo2.createAppDataGroup("default", []);
+      appDataGroups2.push(dataGroup2);
+    }
     return {
       groupType: options.groupType ?? "config-sync",
       repo: repo2,
       dataGroup: dataGroup2,
-      appDataGroups: [dataGroup2]
+      appDataGroups: appDataGroups2
     };
   }
   const { type, options: backendOptions } = options.backendInfo;

package/dist/zen-fs-config.js

@@ -24478,6 +24478,9 @@ var ZenFSConfig = (() => {
     if (typeof isolatedFS.writeFileWithMtime === "function") {
       backend.writeFileWithMtime = (path, data, mtimeMs) => isolatedFS.writeFileWithMtime(path, data, mtimeMs);
     }
+    if (typeof isolatedFS.shouldSync === "function") {
+      backend.shouldSync = (...args) => isolatedFS.shouldSync(...args);
+    }
     return backend;
   }
   function _cacheGet(key) {
@@ -24525,6 +24528,39 @@ var ZenFSConfig = (() => {
       );
     }
   }
+  async function resolveRemoteStorageHref(href) {
+    const raw = String(href ?? "").trim();
+    if (!raw) throw new Error("RemoteStorage href is required.");
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(raw)) return raw.replace(/\/+$/, "");
+    const match = raw.match(/^(?:acct:)?([^@/]+)@([^@/]+)$/);
+    if (!match) {
+      throw new Error(
+        `RemoteStorage href "${raw}" is neither an absolute URL nor a user address (user@domain).`
+      );
+    }
+    const user = match[1];
+    const domain = match[2];
+    const webfingerUrl = `https://${domain}/.well-known/webfinger?resource=acct:${encodeURIComponent(user)}@${encodeURIComponent(domain)}`;
+    let response;
+    try {
+      response = await globalThis.fetch(webfingerUrl, {
+        headers: { Accept: "application/jrd+json, application/json" }
+      });
+    } catch (err2) {
+      throw new Error(
+        `RemoteStorage WebFinger request failed (${webfingerUrl}): ${err2 instanceof Error ? err2.message : String(err2)}`
+      );
+    }
+    if (!response.ok) {
+      throw new Error(`RemoteStorage WebFinger lookup failed (HTTP ${response.status}): ${webfingerUrl}`);
+    }
+    const jrd = await response.json();
+    const link5 = (jrd?.links ?? []).find(
+      (item) => item && item.rel === "http://tools.ietf.org/id/draft-dejong-remotestorage" && item.href
+    );
+    if (!link5) throw new Error(`WebFinger response has no RemoteStorage link: ${webfingerUrl}`);
+    return String(link5.href).replace(/\/+$/, "");
+  }
   var registry, metadataRegistry, inMemoryCounter, _memCache, OPTIONAL_BACKEND_GLOBALS;
   var init_backend_registry = __esm({
     "src/backend-registry.ts"() {
@@ -24573,7 +24609,8 @@ var ZenFSConfig = (() => {
         // third-party Gitee widget) would shadow the real backend and break mounting
         // with "Invalid mount configuration".
         "zen-fs-gitee": ["ZenFSGitee"],
-        "zen-fs-remotestoragejs": ["ZenFSRemoteStorage", "RemoteStorageFileSystem"]
+        "zen-fs-remotestoragejs": ["ZenFSRemoteStorage", "RemoteStorageFileSystem"],
+        "zen-fs-webdav": ["ZenFSWebDAV"]
       };
       registerBackend("GitHub", async (options) => {
         const _gh = await importOptionalBackend("zen-fs-github");
@@ -24635,9 +24672,9 @@ var ZenFSConfig = (() => {
       registerBackend("Gitee", async (options) => {
         const _gt = await importOptionalBackend("zen-fs-gitee");
         const Gitee = _gt?.Gitee ?? _gt?.default;
-        if (typeof Gitee !== "function") {
+        if (!Gitee || typeof Gitee !== "function" && typeof Gitee.create !== "function") {
           throw new Error(
-            `Backend package "zen-fs-gitee" loaded, but its Gitee export is not a constructor (typeof=${typeof Gitee}). Load its UMD bundle so it exposes the global "ZenFSGitee".`
+            `Backend package "zen-fs-gitee" loaded, but its Gitee export is not a usable backend (typeof=${typeof Gitee}). Load its UMD bundle so it exposes the global "ZenFSGitee".`
           );
         }
         return wrapZenFSFileSystem({
@@ -24673,7 +24710,7 @@ var ZenFSConfig = (() => {
           );
         }
         return new RemoteStorageFileSystem({
-          href: options.href,
+          href: await resolveRemoteStorageHref(options.href),
           token: options.token,
           basePath: options.basePath || void 0,
           preciseMtime: true,
@@ -24684,7 +24721,7 @@ var ZenFSConfig = (() => {
         label: "RemoteStorage",
         icon: "\u{1F4E1}",
         fields: [
-          { key: "href", label: "User Address (href)", type: "text", placeholder: "user@5apps.com", required: true },
+          { key: "href", label: "User Address / Storage URL (href)", type: "text", placeholder: "user@5apps.com \u6216 https://storage.5apps.com/user", required: true },
           { key: "token", label: "Bearer Token", type: "password", placeholder: "rs-xxxxxxxx", required: true },
           { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" }
         ],
@@ -24695,6 +24732,53 @@ var ZenFSConfig = (() => {
         // connections to the same endpoint with different tuning are deduplicated.
         identityFields: ["href", "token", "basePath"]
       });
+      registerBackend("WebDAV", async (options) => {
+        const _dav = await importOptionalBackend("zen-fs-webdav");
+        const SyncableWebDAVFS = _dav?.SyncableWebDAVFS ?? _dav?.default?.SyncableWebDAVFS ?? globalThis.ZenFSWebDAV?.SyncableWebDAVFS;
+        if (typeof SyncableWebDAVFS !== "function") {
+          throw new Error(
+            `Backend package "zen-fs-webdav" loaded, but its SyncableWebDAVFS export is not a constructor (typeof=${typeof SyncableWebDAVFS}). Run: npm install zen-fs-webdav, or load its UMD bundle via <script src=".../zen-fs-webdav.global.js"> so it exposes the global "ZenFSWebDAV".`
+          );
+        }
+        const instance = new SyncableWebDAVFS({
+          baseUrl: options.baseUrl,
+          username: options.username,
+          password: options.password,
+          token: options.token,
+          headers: options.headers,
+          timeout: options.timeout,
+          preciseMtime: true
+        });
+        if (options.purgeLegacyMtime === true) {
+          try {
+            await instance.purgeLegacyMtimeSidecars({ root: options.basePath ?? "/" });
+          } catch {
+          }
+        }
+        return instance;
+      }, {
+        type: "WebDAV",
+        label: "WebDAV",
+        icon: "\u2601\uFE0F",
+        fields: [
+          { key: "baseUrl", label: "Base URL", type: "text", placeholder: "https://dav.example.com/remote.php/dav/files/user/", required: true },
+          { key: "username", label: "Username", type: "text", placeholder: "admin" },
+          { key: "password", label: "Password", type: "password" },
+          { key: "token", label: "Token", type: "password", placeholder: "Bearer token (optional)" },
+          { key: "basePath", label: "Base Path", type: "text", placeholder: "/zen-fs-config/" },
+          { key: "purgeLegacyMtime", label: "Purge legacy .mtime sidecars", type: "select", options: [
+            { value: "false", label: "no (default)" },
+            { value: "true", label: "yes (one-time migration)" }
+          ] }
+        ],
+        defaultOptions: { baseUrl: "", username: "", password: "", token: "", basePath: "/", purgeLegacyMtime: "false" },
+        // accountFields: credentials live on the endpoint, so a data-sync group can
+        // reuse them from an already-connected config-sync WebDAV backend.
+        accountFields: ["username", "password", "token"],
+        // identity = the WebDAV endpoint. Credentials are auth, not location, so two
+        // connections to the same URL are deduplicated as one replica.
+        identityFields: ["baseUrl"]
+      });
     }
   });
 
@@ -27300,6 +27384,12 @@ var ZenFSConfig = (() => {
     for (const f of fields) {
       if (options && options[f] !== void 0) subset[f] = options[f];
     }
+    if (type === "Gitee" || type === "GitHub") {
+      const defaultEndpoint = type === "Gitee" ? "https://gitee.com/api/v5" : "https://api.github.com";
+      const raw = options && options.baseUrl;
+      const value = typeof raw === "string" && raw.trim() !== "" ? raw : defaultEndpoint;
+      subset["baseUrl"] = value.replace(/\/+$/, "");
+    }
     return subset;
   }
   function backendDedupKey(desc) {
@@ -28690,10 +28780,15 @@ var ZenFSConfig = (() => {
       }
       const descPath = this.appDataGroupFilePath(id);
       try {
-        await this.cachedFS.unlink(descPath);
-      } catch {
+        await this.deleteFile(descPath);
+      } catch (err2) {
+        log6.log(`[ConfigRepo] removeAppDataGroup: deleteFile failed for "${id}":`, err2);
+        try {
+          await this.cachedFS.unlink(descPath);
+        } catch {
+        }
+        await this.unlinkVersionSidecar(this.cachedFS, descPath);
       }
-      await this.unlinkVersionSidecar(this.cachedFS, descPath);
       log6.log(`[ConfigRepo] removeAppDataGroup: "${id}" removed`);
     }
     async listAccountBackends() {
@@ -29076,12 +29171,25 @@ var ZenFSConfig = (() => {
         onConflict: options.onConflict,
         syncPollIntervalMs: options.syncPollIntervalMs
       });
-      const dataGroup2 = await repo2.createAppDataGroup("default", []);
+      const appDataGroups2 = [];
+      const descriptors2 = await repo2.listAppDataGroups();
+      for (const d of descriptors2) {
+        try {
+          appDataGroups2.push(await repo2.getAppDataGroup(d.id));
+        } catch (err2) {
+          log7(`connect: failed to load app data group "${d.id}":`, err2);
+        }
+      }
+      let dataGroup2 = appDataGroups2[0];
+      if (!dataGroup2) {
+        dataGroup2 = await repo2.createAppDataGroup("default", []);
+        appDataGroups2.push(dataGroup2);
+      }
       return {
         groupType: options.groupType ?? "config-sync",
         repo: repo2,
         dataGroup: dataGroup2,
-        appDataGroups: [dataGroup2]
+        appDataGroups: appDataGroups2
       };
     }
     const { type, options: backendOptions } = options.backendInfo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.5.39",
+  "version": "0.5.41",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -52,7 +52,8 @@
     "zen-fs-sync": ">=0.4.7",
     "zen-fs-github": "*",
     "zen-fs-gitee": "*",
-    "zen-fs-remotestoragejs": "*"
+    "zen-fs-remotestoragejs": "*",
+    "zen-fs-webdav": "*"
   },
   "dependencies": {
     "@richard432/localstorage-logger": "^0.1.0"
@@ -72,6 +73,9 @@
     },
     "zen-fs-remotestoragejs": {
       "optional": true
+    },
+    "zen-fs-webdav": {
+      "optional": true
     }
   },
   "devDependencies": {