zen-fs-config 0.3.0 → 0.3.2

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

@@ -316,23 +316,16 @@ function hasBackend(type) {
 function listBackends() {
   return Array.from(registry.keys());
 }
-var inMemoryCounter = 0;
-registerBackend("InMemory", async (options) => {
+async function wrapZenFSFileSystem(config) {
   const zenfs = await import("@zenfs/core");
-  const { InMemory } = zenfs;
-  const maxSize = options.maxSize ?? 100 * 1024 * 1024;
-  const label = options.label ?? `zen-fs-config-${++inMemoryCounter}`;
-  await zenfs.configureSingle({ backend: InMemory, maxSize, label });
-  const pfs = zenfs.fs.promises;
-  const backend = {
+  const isolatedFS = await zenfs.resolveMountConfig(config);
+  const pfs = isolatedFS.promises;
+  return {
     async readFile(path, ...args) {
-      if (args.length > 0) {
-        return pfs.readFile(path, ...args);
-      }
-      return pfs.readFile(path);
+      return args.length > 0 ? pfs.readFile(path, ...args) : pfs.readFile(path);
     },
-    async writeFile(path, data, options2) {
-      return pfs.writeFile(path, data, options2);
+    async writeFile(path, data, options) {
+      return pfs.writeFile(path, data, options);
     },
     async readdir(path) {
       const entries = await pfs.readdir(path);
@@ -349,8 +342,8 @@ registerBackend("InMemory", async (options) => {
         return false;
       }
     },
-    async mkdir(path, options2) {
-      return pfs.mkdir(path, options2);
+    async mkdir(path, options) {
+      return pfs.mkdir(path, options);
     },
     async unlink(path) {
       return pfs.unlink(path);
@@ -362,54 +355,21 @@ registerBackend("InMemory", async (options) => {
       return pfs.rename(oldPath, newPath);
     }
   };
-  return backend;
+}
+var inMemoryCounter = 0;
+registerBackend("InMemory", async (options) => {
+  const { InMemory } = await import("@zenfs/core");
+  const maxSize = options.maxSize ?? 100 * 1024 * 1024;
+  const label = options.label ?? `zen-fs-config-${++inMemoryCounter}`;
+  return wrapZenFSFileSystem({ backend: InMemory, maxSize, label });
 });
 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;
+  return wrapZenFSFileSystem({ backend: IndexedDB, storeName });
 });
 registerBackend("WebStorage", async (options) => {
-  const zenfs = await import("@zenfs/core");
   const { WebStorage } = await import("@zenfs/dom");
   const storageType = options.storageType ?? "localStorage";
   let storage;
@@ -418,44 +378,7 @@ registerBackend("WebStorage", async (options) => {
   } 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;
+  return wrapZenFSFileSystem({ backend: WebStorage, storage });
 });
 registerBackend("GitHub", async (options) => {
   const token = options.token ?? "";
@@ -883,6 +806,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;
@@ -901,6 +826,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

@@ -269,23 +269,16 @@ function hasBackend(type) {
 function listBackends() {
   return Array.from(registry.keys());
 }
-var inMemoryCounter = 0;
-registerBackend("InMemory", async (options) => {
+async function wrapZenFSFileSystem(config) {
   const zenfs = await import("@zenfs/core");
-  const { InMemory } = zenfs;
-  const maxSize = options.maxSize ?? 100 * 1024 * 1024;
-  const label = options.label ?? `zen-fs-config-${++inMemoryCounter}`;
-  await zenfs.configureSingle({ backend: InMemory, maxSize, label });
-  const pfs = zenfs.fs.promises;
-  const backend = {
+  const isolatedFS = await zenfs.resolveMountConfig(config);
+  const pfs = isolatedFS.promises;
+  return {
     async readFile(path, ...args) {
-      if (args.length > 0) {
-        return pfs.readFile(path, ...args);
-      }
-      return pfs.readFile(path);
+      return args.length > 0 ? pfs.readFile(path, ...args) : pfs.readFile(path);
     },
-    async writeFile(path, data, options2) {
-      return pfs.writeFile(path, data, options2);
+    async writeFile(path, data, options) {
+      return pfs.writeFile(path, data, options);
     },
     async readdir(path) {
       const entries = await pfs.readdir(path);
@@ -302,8 +295,8 @@ registerBackend("InMemory", async (options) => {
         return false;
       }
     },
-    async mkdir(path, options2) {
-      return pfs.mkdir(path, options2);
+    async mkdir(path, options) {
+      return pfs.mkdir(path, options);
     },
     async unlink(path) {
       return pfs.unlink(path);
@@ -315,54 +308,21 @@ registerBackend("InMemory", async (options) => {
       return pfs.rename(oldPath, newPath);
     }
   };
-  return backend;
+}
+var inMemoryCounter = 0;
+registerBackend("InMemory", async (options) => {
+  const { InMemory } = await import("@zenfs/core");
+  const maxSize = options.maxSize ?? 100 * 1024 * 1024;
+  const label = options.label ?? `zen-fs-config-${++inMemoryCounter}`;
+  return wrapZenFSFileSystem({ backend: InMemory, maxSize, label });
 });
 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;
+  return wrapZenFSFileSystem({ backend: IndexedDB, storeName });
 });
 registerBackend("WebStorage", async (options) => {
-  const zenfs = await import("@zenfs/core");
   const { WebStorage } = await import("@zenfs/dom");
   const storageType = options.storageType ?? "localStorage";
   let storage;
@@ -371,44 +331,7 @@ registerBackend("WebStorage", async (options) => {
   } 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;
+  return wrapZenFSFileSystem({ backend: WebStorage, storage });
 });
 registerBackend("GitHub", async (options) => {
   const token = options.token ?? "";
@@ -836,6 +759,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;
@@ -854,6 +779,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.3.0",
+  "version": "0.3.2",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",