zen-fs-config 0.2.1 → 0.3.1

package/dist/index.d.mts

@@ -136,6 +136,8 @@ interface IConfigRepo {
     readonly nodeId: string;
     /** ZenFS-compatible fs object, context-isolated to this app's directories. */
     readonly fs: typeof node_fs;
+    /** Un-chrooted fs for low-level browsing (includes /.meta/, all app dirs). */
+    readonly rootFS: typeof node_fs;
     /** Load or reload configuration from a raw string. */
     load(rawConfig: string): Promise<void>;
     /** Read a config value. */
@@ -229,6 +231,8 @@ declare class ConfigRepo implements IConfigRepo {
     readonly nodeId: string;
     /** Chroot-isolated fs for app-facing API. Typed as `any` to match `typeof import('node:fs')` duck-typically. */
     readonly fs: any;
+    /** Un-chrooted fs for low-level browsing. */
+    readonly rootFS: any;
     private cachedFS;
     private fullFS;
     private serializer;

package/dist/index.d.ts

@@ -136,6 +136,8 @@ interface IConfigRepo {
     readonly nodeId: string;
     /** ZenFS-compatible fs object, context-isolated to this app's directories. */
     readonly fs: typeof node_fs;
+    /** Un-chrooted fs for low-level browsing (includes /.meta/, all app dirs). */
+    readonly rootFS: typeof node_fs;
     /** Load or reload configuration from a raw string. */
     load(rawConfig: string): Promise<void>;
     /** Read a config value. */
@@ -229,6 +231,8 @@ declare class ConfigRepo implements IConfigRepo {
     readonly nodeId: string;
     /** Chroot-isolated fs for app-facing API. Typed as `any` to match `typeof import('node:fs')` duck-typically. */
     readonly fs: any;
+    /** Un-chrooted fs for low-level browsing. */
+    readonly rootFS: any;
     private cachedFS;
     private fullFS;
     private serializer;

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 ?? "";
@@ -790,6 +883,8 @@ var ConfigRepo = class {
   nodeId;
   /** Chroot-isolated fs for app-facing API. Typed as `any` to match `typeof import('node:fs')` duck-typically. */
   fs;
+  /** Un-chrooted fs for low-level browsing. */
+  rootFS;
   cachedFS;
   fullFS;
   serializer;
@@ -808,6 +903,7 @@ var ConfigRepo = class {
     this.onConflictCallback = onConflict;
     this.fullFS = cachedFSToSyncableFS(cachedFS);
     this.fs = createChrootFS(cachedFS, `/${appId}`);
+    this.rootFS = createChrootFS(cachedFS, "/");
   }
   // -----------------------------------------------------------------------
   // IConfigRepo — Load

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 ?? "";
@@ -743,6 +836,8 @@ var ConfigRepo = class {
   nodeId;
   /** Chroot-isolated fs for app-facing API. Typed as `any` to match `typeof import('node:fs')` duck-typically. */
   fs;
+  /** Un-chrooted fs for low-level browsing. */
+  rootFS;
   cachedFS;
   fullFS;
   serializer;
@@ -761,6 +856,7 @@ var ConfigRepo = class {
     this.onConflictCallback = onConflict;
     this.fullFS = cachedFSToSyncableFS(cachedFS);
     this.fs = createChrootFS(cachedFS, `/${appId}`);
+    this.rootFS = createChrootFS(cachedFS, "/");
   }
   // -----------------------------------------------------------------------
   // IConfigRepo — Load

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "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"
   }
 }