zen-fs-config 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -160,6 +160,14 @@ interface IConfigRepo {
     resolveConflict(conflictId: string, mergedContent: unknown): Promise<void>;
     /** List all conflict archives. */
     listConflicts(): Promise<ConflictArchive[]>;
+    /** Read .meta/backends.json. */
+    getBackends(): Promise<BackendsMeta | null>;
+    /** Write .meta/backends.json. */
+    updateBackends(meta: BackendsMeta): Promise<void>;
+    /** Read .meta/sync-rules.json. */
+    getSyncRules(): Promise<SyncRulesMeta | null>;
+    /** Write .meta/sync-rules.json. */
+    updateSyncRules(meta: SyncRulesMeta): Promise<void>;
     /** Dispose: stop all sync, release cache FS and resources. */
     dispose(): Promise<void>;
 }
@@ -252,6 +260,10 @@ declare class ConfigRepo implements IConfigRepo {
     private walkDir;
     writeMetaFile(path: string, data: BackendsMeta | SyncRulesMeta): Promise<void>;
     readMetaFile<T>(path: string): Promise<T | null>;
+    getBackends(): Promise<BackendsMeta | null>;
+    updateBackends(meta: BackendsMeta): Promise<void>;
+    getSyncRules(): Promise<SyncRulesMeta | null>;
+    updateSyncRules(meta: SyncRulesMeta): Promise<void>;
     private tryParse;
     private assertNotDisposed;
 }

package/dist/index.d.ts

@@ -160,6 +160,14 @@ interface IConfigRepo {
     resolveConflict(conflictId: string, mergedContent: unknown): Promise<void>;
     /** List all conflict archives. */
     listConflicts(): Promise<ConflictArchive[]>;
+    /** Read .meta/backends.json. */
+    getBackends(): Promise<BackendsMeta | null>;
+    /** Write .meta/backends.json. */
+    updateBackends(meta: BackendsMeta): Promise<void>;
+    /** Read .meta/sync-rules.json. */
+    getSyncRules(): Promise<SyncRulesMeta | null>;
+    /** Write .meta/sync-rules.json. */
+    updateSyncRules(meta: SyncRulesMeta): Promise<void>;
     /** Dispose: stop all sync, release cache FS and resources. */
     dispose(): Promise<void>;
 }
@@ -252,6 +260,10 @@ declare class ConfigRepo implements IConfigRepo {
     private walkDir;
     writeMetaFile(path: string, data: BackendsMeta | SyncRulesMeta): Promise<void>;
     readMetaFile<T>(path: string): Promise<T | null>;
+    getBackends(): Promise<BackendsMeta | null>;
+    updateBackends(meta: BackendsMeta): Promise<void>;
+    getSyncRules(): Promise<SyncRulesMeta | null>;
+    updateSyncRules(meta: SyncRulesMeta): Promise<void>;
     private tryParse;
     private assertNotDisposed;
 }

package/dist/index.js

@@ -364,6 +364,99 @@ registerBackend("InMemory", async (options) => {
   };
   return backend;
 });
+var idbCounter = 0;
+registerBackend("IndexedDB", async (options) => {
+  const zenfs = await import("@zenfs/core");
+  const { IndexedDB } = await import("@zenfs/dom");
+  const storeName = options.storeName ?? `zen-fs-config-${++idbCounter}`;
+  await zenfs.configureSingle({ backend: IndexedDB, storeName });
+  const pfs = zenfs.fs.promises;
+  const backend = {
+    async readFile(path, ...args) {
+      return args.length > 0 ? pfs.readFile(path, ...args) : pfs.readFile(path);
+    },
+    async writeFile(path, data, options2) {
+      return pfs.writeFile(path, data, options2);
+    },
+    async readdir(path) {
+      const entries = await pfs.readdir(path);
+      return entries.map((e) => typeof e === "string" ? e : e.name);
+    },
+    async stat(path, ...args) {
+      return pfs.stat(path, ...args);
+    },
+    async exists(path) {
+      try {
+        await pfs.stat(path);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    async mkdir(path, options2) {
+      return pfs.mkdir(path, options2);
+    },
+    async unlink(path) {
+      return pfs.unlink(path);
+    },
+    async rmdir(path) {
+      return pfs.rmdir(path);
+    },
+    async rename(oldPath, newPath) {
+      return pfs.rename(oldPath, newPath);
+    }
+  };
+  return backend;
+});
+registerBackend("WebStorage", async (options) => {
+  const zenfs = await import("@zenfs/core");
+  const { WebStorage } = await import("@zenfs/dom");
+  const storageType = options.storageType ?? "localStorage";
+  let storage;
+  if (storageType === "sessionStorage" && typeof sessionStorage !== "undefined") {
+    storage = sessionStorage;
+  } else {
+    storage = localStorage;
+  }
+  await zenfs.configureSingle({ backend: WebStorage, storage });
+  const pfs = zenfs.fs.promises;
+  const backend = {
+    async readFile(path, ...args) {
+      return args.length > 0 ? pfs.readFile(path, ...args) : pfs.readFile(path);
+    },
+    async writeFile(path, data, options2) {
+      return pfs.writeFile(path, data, options2);
+    },
+    async readdir(path) {
+      const entries = await pfs.readdir(path);
+      return entries.map((e) => typeof e === "string" ? e : e.name);
+    },
+    async stat(path, ...args) {
+      return pfs.stat(path, ...args);
+    },
+    async exists(path) {
+      try {
+        await pfs.stat(path);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    async mkdir(path, options2) {
+      return pfs.mkdir(path, options2);
+    },
+    async unlink(path) {
+      return pfs.unlink(path);
+    },
+    async rmdir(path) {
+      return pfs.rmdir(path);
+    },
+    async rename(oldPath, newPath) {
+      return pfs.rename(oldPath, newPath);
+    }
+  };
+  return backend;
+});
 registerBackend("GitHub", async (options) => {
   const token = options.token ?? "";
   const owner = options.owner ?? "";
@@ -1194,6 +1287,25 @@ var ConfigRepo = class {
       return null;
     }
   }
+  // -----------------------------------------------------------------------
+  // IConfigRepo — Meta file access (no chroot)
+  // -----------------------------------------------------------------------
+  async getBackends() {
+    this.assertNotDisposed();
+    return this.readMetaFile(BACKENDS_FILE);
+  }
+  async updateBackends(meta) {
+    this.assertNotDisposed();
+    await this.writeMetaFile(BACKENDS_FILE, meta);
+  }
+  async getSyncRules() {
+    this.assertNotDisposed();
+    return this.readMetaFile(SYNC_RULES_FILE);
+  }
+  async updateSyncRules(meta) {
+    this.assertNotDisposed();
+    await this.writeMetaFile(SYNC_RULES_FILE, meta);
+  }
   tryParse(content) {
     try {
       return JSON.parse(content);

package/dist/index.mjs

@@ -317,6 +317,99 @@ registerBackend("InMemory", async (options) => {
   };
   return backend;
 });
+var idbCounter = 0;
+registerBackend("IndexedDB", async (options) => {
+  const zenfs = await import("@zenfs/core");
+  const { IndexedDB } = await import("@zenfs/dom");
+  const storeName = options.storeName ?? `zen-fs-config-${++idbCounter}`;
+  await zenfs.configureSingle({ backend: IndexedDB, storeName });
+  const pfs = zenfs.fs.promises;
+  const backend = {
+    async readFile(path, ...args) {
+      return args.length > 0 ? pfs.readFile(path, ...args) : pfs.readFile(path);
+    },
+    async writeFile(path, data, options2) {
+      return pfs.writeFile(path, data, options2);
+    },
+    async readdir(path) {
+      const entries = await pfs.readdir(path);
+      return entries.map((e) => typeof e === "string" ? e : e.name);
+    },
+    async stat(path, ...args) {
+      return pfs.stat(path, ...args);
+    },
+    async exists(path) {
+      try {
+        await pfs.stat(path);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    async mkdir(path, options2) {
+      return pfs.mkdir(path, options2);
+    },
+    async unlink(path) {
+      return pfs.unlink(path);
+    },
+    async rmdir(path) {
+      return pfs.rmdir(path);
+    },
+    async rename(oldPath, newPath) {
+      return pfs.rename(oldPath, newPath);
+    }
+  };
+  return backend;
+});
+registerBackend("WebStorage", async (options) => {
+  const zenfs = await import("@zenfs/core");
+  const { WebStorage } = await import("@zenfs/dom");
+  const storageType = options.storageType ?? "localStorage";
+  let storage;
+  if (storageType === "sessionStorage" && typeof sessionStorage !== "undefined") {
+    storage = sessionStorage;
+  } else {
+    storage = localStorage;
+  }
+  await zenfs.configureSingle({ backend: WebStorage, storage });
+  const pfs = zenfs.fs.promises;
+  const backend = {
+    async readFile(path, ...args) {
+      return args.length > 0 ? pfs.readFile(path, ...args) : pfs.readFile(path);
+    },
+    async writeFile(path, data, options2) {
+      return pfs.writeFile(path, data, options2);
+    },
+    async readdir(path) {
+      const entries = await pfs.readdir(path);
+      return entries.map((e) => typeof e === "string" ? e : e.name);
+    },
+    async stat(path, ...args) {
+      return pfs.stat(path, ...args);
+    },
+    async exists(path) {
+      try {
+        await pfs.stat(path);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    async mkdir(path, options2) {
+      return pfs.mkdir(path, options2);
+    },
+    async unlink(path) {
+      return pfs.unlink(path);
+    },
+    async rmdir(path) {
+      return pfs.rmdir(path);
+    },
+    async rename(oldPath, newPath) {
+      return pfs.rename(oldPath, newPath);
+    }
+  };
+  return backend;
+});
 registerBackend("GitHub", async (options) => {
   const token = options.token ?? "";
   const owner = options.owner ?? "";
@@ -1147,6 +1240,25 @@ var ConfigRepo = class {
       return null;
     }
   }
+  // -----------------------------------------------------------------------
+  // IConfigRepo — Meta file access (no chroot)
+  // -----------------------------------------------------------------------
+  async getBackends() {
+    this.assertNotDisposed();
+    return this.readMetaFile(BACKENDS_FILE);
+  }
+  async updateBackends(meta) {
+    this.assertNotDisposed();
+    await this.writeMetaFile(BACKENDS_FILE, meta);
+  }
+  async getSyncRules() {
+    this.assertNotDisposed();
+    return this.readMetaFile(SYNC_RULES_FILE);
+  }
+  async updateSyncRules(meta) {
+    this.assertNotDisposed();
+    await this.writeMetaFile(SYNC_RULES_FILE, meta);
+  }
   tryParse(content) {
     try {
       return JSON.parse(content);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -47,5 +47,8 @@
     "typescript": "^5.9.3",
     "zen-fs-cache": "^1.0.1",
     "zen-fs-sync": "^0.1.0"
+  },
+  "dependencies": {
+    "@zenfs/dom": "^1.2.9"
   }
 }