@ricsam/quickjs-fs 0.0.1 → 0.2.1

package/README.md

@@ -1,45 +1,72 @@
 # @ricsam/quickjs-fs
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@ricsam/quickjs-fs`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+File System Access API (OPFS-compatible).
+
+```typescript
+import { setupFs, createNodeDirectoryHandle } from "@ricsam/quickjs-fs";
+
+const handle = setupFs(context, {
+  getDirectory: async (path) => {
+    // Validate path access
+    if (!path.startsWith("/allowed")) {
+      throw new Error("Access denied");
+    }
+    return createNodeDirectoryHandle(`./sandbox${path}`);
+  },
+});
+```
+
+**Injected Globals:**
+- `fs.getDirectory(path)` - Entry point for file system access
+- `FileSystemDirectoryHandle`, `FileSystemFileHandle`
+- `FileSystemWritableFileStream`
+
+**Usage in QuickJS:**
+
+```javascript
+// Get directory handle
+const root = await fs.getDirectory("/data");
+
+// Read a file
+const fileHandle = await root.getFileHandle("config.json");
+const file = await fileHandle.getFile();
+const text = await file.text();
+const config = JSON.parse(text);
+
+// Write a file
+const outputHandle = await root.getFileHandle("output.txt", { create: true });
+const writable = await outputHandle.createWritable();
+await writable.write("Hello, World!");
+await writable.close();
+
+// Directory operations
+const subDir = await root.getDirectoryHandle("subdir", { create: true });
+await root.removeEntry("old-file.txt");
+await root.removeEntry("old-dir", { recursive: true });
+
+// Iterate directory
+for await (const [name, handle] of root.entries()) {
+  console.log(name, handle.kind); // "file" or "directory"
+}
+```
+
+#### Host Adapters
+
+**Node.js/Bun adapter:**
+
+```typescript
+import { createNodeDirectoryHandle } from "@ricsam/quickjs-fs";
+
+const dirHandle = createNodeDirectoryHandle("/path/to/directory");
+```
+
+**In-memory adapter (for testing):**
+
+```typescript
+import { createMemoryDirectoryHandle } from "@ricsam/quickjs-fs";
+
+const memFs = createMemoryDirectoryHandle({
+  "config.json": JSON.stringify({ debug: true }),
+  "data/users.json": JSON.stringify([]),
+});
+```

package/dist/cjs/directory-handle.cjs

@@ -0,0 +1,166 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/fs/src/handles/directory-handle.ts
+var exports_directory_handle = {};
+__export(exports_directory_handle, {
+  registerHostDirectoryHandle: () => registerHostDirectoryHandle,
+  pendingHostHandles: () => pendingHostHandles,
+  createFileSystemDirectoryHandleClass: () => createFileSystemDirectoryHandleClass
+});
+module.exports = __toCommonJS(exports_directory_handle);
+var import_quickjs_core = require("@ricsam/quickjs-core");
+var import_file_handle = require("./file-handle.ts");
+var nextHostHandleId = 0;
+var pendingHostHandles = new Map;
+function registerHostDirectoryHandle(handle) {
+  const id = nextHostHandleId++;
+  pendingHostHandles.set(id, { handle, name: handle.name });
+  return id;
+}
+function createFileSystemDirectoryHandleClass(context, stateMap) {
+  return import_quickjs_core.defineClass(context, stateMap, {
+    name: "FileSystemDirectoryHandle",
+    construct: (args) => {
+      const hostHandleId = args[0];
+      const pending = pendingHostHandles.get(hostHandleId);
+      if (!pending) {
+        throw new Error(`No pending host handle with ID ${hostHandleId}`);
+      }
+      pendingHostHandles.delete(hostHandleId);
+      return {
+        kind: "directory",
+        name: pending.name,
+        hostHandle: pending.handle
+      };
+    },
+    properties: {
+      kind: {
+        get() {
+          return "directory";
+        }
+      },
+      name: {
+        get() {
+          return this.name;
+        }
+      }
+    },
+    methods: {
+      async _getFileHandleInternal(name, options) {
+        const opts = options;
+        const hostFile = await this.hostHandle.getFileHandle(String(name), {
+          create: opts?.create
+        });
+        return { __fileHandleId: import_file_handle.registerHostFileHandle(hostFile) };
+      },
+      async _getDirectoryHandleInternal(name, options) {
+        const opts = options;
+        const hostDir = await this.hostHandle.getDirectoryHandle(String(name), {
+          create: opts?.create
+        });
+        return { __directoryHandleId: registerHostDirectoryHandle(hostDir) };
+      },
+      async removeEntry(name, options) {
+        const opts = options;
+        await this.hostHandle.removeEntry(String(name), {
+          recursive: opts?.recursive
+        });
+      },
+      async resolve(possibleDescendant) {
+        if (!possibleDescendant || typeof possibleDescendant !== "object") {
+          return null;
+        }
+        const descendant = possibleDescendant;
+        return this.hostHandle.resolve(descendant.hostHandle);
+      },
+      async entries() {
+        const result = [];
+        for await (const [name, handle] of this.hostHandle.entries()) {
+          if (handle.kind === "file") {
+            result.push([
+              name,
+              {
+                kind: "file",
+                name: handle.name,
+                hostHandle: handle
+              }
+            ]);
+          } else {
+            result.push([
+              name,
+              {
+                kind: "directory",
+                name: handle.name,
+                hostHandle: handle
+              }
+            ]);
+          }
+        }
+        return result;
+      },
+      async keys() {
+        const result = [];
+        for await (const name of this.hostHandle.keys()) {
+          result.push(name);
+        }
+        return result;
+      },
+      async values() {
+        const result = [];
+        for await (const handle of this.hostHandle.values()) {
+          if (handle.kind === "file") {
+            result.push({
+              kind: "file",
+              name: handle.name,
+              hostHandle: handle
+            });
+          } else {
+            result.push({
+              kind: "directory",
+              name: handle.name,
+              hostHandle: handle
+            });
+          }
+        }
+        return result;
+      },
+      async isSameEntry(other) {
+        if (!other || typeof other !== "object") {
+          return false;
+        }
+        const otherHandle = other;
+        return this.hostHandle === otherHandle.hostHandle;
+      }
+    }
+  });
+}
+})
+
+//# debugId=9FF50EE4CEB5814A64756E2164756E21

package/dist/cjs/directory-handle.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/handles/directory-handle.ts"],
+  "sourcesContent": [
+    "import type { StateMap } from \"@ricsam/quickjs-core\";\nimport { defineClass } from \"@ricsam/quickjs-core\";\nimport type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type {\n  FileSystemDirectoryHandleState,\n  FileSystemFileHandleState,\n  HostDirectoryHandle,\n} from \"../types.ts\";\nimport { registerHostFileHandle } from \"./file-handle.ts\";\n\n// Registry for pending host handles that will be picked up by constructor\nlet nextHostHandleId = 0;\nexport const pendingHostHandles = new Map<\n  number,\n  { handle: HostDirectoryHandle; name: string }\n>();\n\nexport function registerHostDirectoryHandle(\n  handle: HostDirectoryHandle\n): number {\n  const id = nextHostHandleId++;\n  pendingHostHandles.set(id, { handle, name: handle.name });\n  return id;\n}\n\n/**\n * Create the FileSystemDirectoryHandle class for QuickJS\n */\nexport function createFileSystemDirectoryHandleClass(\n  context: QuickJSContext,\n  stateMap: StateMap\n): QuickJSHandle {\n  return defineClass<FileSystemDirectoryHandleState>(context, stateMap, {\n    name: \"FileSystemDirectoryHandle\",\n    construct: (args) => {\n      // First argument is the host handle ID\n      const hostHandleId = args[0] as number;\n      const pending = pendingHostHandles.get(hostHandleId);\n      if (!pending) {\n        throw new Error(`No pending host handle with ID ${hostHandleId}`);\n      }\n      pendingHostHandles.delete(hostHandleId);\n      return {\n        kind: \"directory\" as const,\n        name: pending.name,\n        hostHandle: pending.handle,\n      };\n    },\n    properties: {\n      kind: {\n        get(this: FileSystemDirectoryHandleState) {\n          return \"directory\";\n        },\n      },\n      name: {\n        get(this: FileSystemDirectoryHandleState) {\n          return this.name;\n        },\n      },\n    },\n    methods: {\n      async _getFileHandleInternal(\n        this: FileSystemDirectoryHandleState,\n        name: unknown,\n        options?: unknown\n      ): Promise<{ __fileHandleId: number }> {\n        const opts = options as { create?: boolean } | undefined;\n        const hostFile = await this.hostHandle.getFileHandle(String(name), {\n          create: opts?.create,\n        });\n\n        return { __fileHandleId: registerHostFileHandle(hostFile) };\n      },\n      async _getDirectoryHandleInternal(\n        this: FileSystemDirectoryHandleState,\n        name: unknown,\n        options?: unknown\n      ): Promise<{ __directoryHandleId: number }> {\n        const opts = options as { create?: boolean } | undefined;\n        const hostDir = await this.hostHandle.getDirectoryHandle(String(name), {\n          create: opts?.create,\n        });\n\n        return { __directoryHandleId: registerHostDirectoryHandle(hostDir) };\n      },\n      async removeEntry(\n        this: FileSystemDirectoryHandleState,\n        name: unknown,\n        options?: unknown\n      ): Promise<void> {\n        const opts = options as { recursive?: boolean } | undefined;\n        await this.hostHandle.removeEntry(String(name), {\n          recursive: opts?.recursive,\n        });\n      },\n      async resolve(\n        this: FileSystemDirectoryHandleState,\n        possibleDescendant: unknown\n      ): Promise<string[] | null> {\n        if (!possibleDescendant || typeof possibleDescendant !== \"object\") {\n          return null;\n        }\n\n        const descendant = possibleDescendant as\n          | FileSystemFileHandleState\n          | FileSystemDirectoryHandleState;\n        return this.hostHandle.resolve(descendant.hostHandle);\n      },\n      async entries(\n        this: FileSystemDirectoryHandleState\n      ): Promise<\n        Array<\n          [string, FileSystemFileHandleState | FileSystemDirectoryHandleState]\n        >\n      > {\n        const result: Array<\n          [string, FileSystemFileHandleState | FileSystemDirectoryHandleState]\n        > = [];\n\n        for await (const [name, handle] of this.hostHandle.entries()) {\n          if (handle.kind === \"file\") {\n            result.push([\n              name,\n              {\n                kind: \"file\",\n                name: handle.name,\n                hostHandle: handle,\n              },\n            ]);\n          } else {\n            result.push([\n              name,\n              {\n                kind: \"directory\",\n                name: handle.name,\n                hostHandle: handle,\n              },\n            ]);\n          }\n        }\n\n        return result;\n      },\n      async keys(this: FileSystemDirectoryHandleState): Promise<string[]> {\n        const result: string[] = [];\n        for await (const name of this.hostHandle.keys()) {\n          result.push(name);\n        }\n        return result;\n      },\n      async values(\n        this: FileSystemDirectoryHandleState\n      ): Promise<\n        Array<FileSystemFileHandleState | FileSystemDirectoryHandleState>\n      > {\n        const result: Array<\n          FileSystemFileHandleState | FileSystemDirectoryHandleState\n        > = [];\n\n        for await (const handle of this.hostHandle.values()) {\n          if (handle.kind === \"file\") {\n            result.push({\n              kind: \"file\",\n              name: handle.name,\n              hostHandle: handle,\n            });\n          } else {\n            result.push({\n              kind: \"directory\",\n              name: handle.name,\n              hostHandle: handle,\n            });\n          }\n        }\n\n        return result;\n      },\n      async isSameEntry(\n        this: FileSystemDirectoryHandleState,\n        other: unknown\n      ): Promise<boolean> {\n        if (!other || typeof other !== \"object\") {\n          return false;\n        }\n        const otherHandle = other as FileSystemDirectoryHandleState;\n        return this.hostHandle === otherHandle.hostHandle;\n      },\n    },\n  });\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "9FF50EE4CEB5814A64756E2164756E21",
+  "names": []
+}

package/dist/cjs/file-handle.cjs

@@ -0,0 +1,125 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/fs/src/handles/file-handle.ts
+var exports_file_handle = {};
+__export(exports_file_handle, {
+  registerHostWritableStream: () => registerHostWritableStream,
+  registerHostFileHandle: () => registerHostFileHandle,
+  pendingWritableStreams: () => pendingWritableStreams,
+  pendingFileHandles: () => pendingFileHandles,
+  createFileSystemFileHandleClass: () => createFileSystemFileHandleClass
+});
+module.exports = __toCommonJS(exports_file_handle);
+var import_quickjs_core = require("@ricsam/quickjs-core");
+var nextFileHandleId = 0;
+var pendingFileHandles = new Map;
+var nextWritableStreamId = 0;
+var pendingWritableStreams = new Map;
+function registerHostFileHandle(handle) {
+  const id = nextFileHandleId++;
+  pendingFileHandles.set(id, { handle, name: handle.name });
+  return id;
+}
+function registerHostWritableStream(stream) {
+  const id = nextWritableStreamId++;
+  pendingWritableStreams.set(id, stream);
+  return id;
+}
+function createFileSystemFileHandleClass(context, stateMap) {
+  return import_quickjs_core.defineClass(context, stateMap, {
+    name: "FileSystemFileHandle",
+    construct: (args) => {
+      const hostHandleId = args[0];
+      const pending = pendingFileHandles.get(hostHandleId);
+      if (!pending) {
+        throw new Error(`No pending file handle with ID ${hostHandleId}`);
+      }
+      pendingFileHandles.delete(hostHandleId);
+      return {
+        kind: "file",
+        name: pending.name,
+        hostHandle: pending.handle
+      };
+    },
+    properties: {
+      kind: {
+        get() {
+          return "file";
+        }
+      },
+      name: {
+        get() {
+          return this.name;
+        }
+      }
+    },
+    methods: {
+      async getFile() {
+        const file = await this.hostHandle.getFile();
+        const buffer = await file.arrayBuffer();
+        const data = new Uint8Array(buffer);
+        return {
+          parts: [data],
+          type: file.type,
+          size: file.size,
+          name: file.name,
+          lastModified: file.lastModified,
+          webkitRelativePath: "",
+          async text() {
+            return new TextDecoder().decode(data);
+          },
+          async arrayBuffer() {
+            return buffer;
+          },
+          async bytes() {
+            return data;
+          }
+        };
+      },
+      async _createWritableInternal(options) {
+        const opts = options;
+        const hostStream = await this.hostHandle.createWritable({
+          keepExistingData: opts?.keepExistingData
+        });
+        return { __writableStreamId: registerHostWritableStream(hostStream) };
+      },
+      async isSameEntry(other) {
+        if (!other || typeof other !== "object") {
+          return false;
+        }
+        const otherHandle = other;
+        return this.hostHandle === otherHandle.hostHandle;
+      }
+    }
+  });
+}
+})
+
+//# debugId=03934374EFF6363C64756E2164756E21

package/dist/cjs/file-handle.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/handles/file-handle.ts"],
+  "sourcesContent": [
+    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type { StateMap } from \"@ricsam/quickjs-core\";\nimport { defineClass } from \"@ricsam/quickjs-core\";\nimport type { FileSystemFileHandleState, HostFileHandle, HostWritableFileStream } from \"../types.ts\";\n\n// Registry for pending host handles that will be picked up by constructor\nlet nextFileHandleId = 0;\nexport const pendingFileHandles = new Map<number, { handle: HostFileHandle; name: string }>();\nlet nextWritableStreamId = 0;\nexport const pendingWritableStreams = new Map<number, HostWritableFileStream>();\n\nexport function registerHostFileHandle(handle: HostFileHandle): number {\n  const id = nextFileHandleId++;\n  pendingFileHandles.set(id, { handle, name: handle.name });\n  return id;\n}\n\nexport function registerHostWritableStream(stream: HostWritableFileStream): number {\n  const id = nextWritableStreamId++;\n  pendingWritableStreams.set(id, stream);\n  return id;\n}\n\n/**\n * Create the FileSystemFileHandle class for QuickJS\n */\nexport function createFileSystemFileHandleClass(\n  context: QuickJSContext,\n  stateMap: StateMap\n): QuickJSHandle {\n  return defineClass<FileSystemFileHandleState>(context, stateMap, {\n    name: \"FileSystemFileHandle\",\n    construct: (args) => {\n      const hostHandleId = args[0] as number;\n      const pending = pendingFileHandles.get(hostHandleId);\n      if (!pending) {\n        throw new Error(`No pending file handle with ID ${hostHandleId}`);\n      }\n      pendingFileHandles.delete(hostHandleId);\n      return {\n        kind: \"file\" as const,\n        name: pending.name,\n        hostHandle: pending.handle,\n      };\n    },\n    properties: {\n      kind: {\n        get(this: FileSystemFileHandleState) {\n          return \"file\";\n        },\n      },\n      name: {\n        get(this: FileSystemFileHandleState) {\n          return this.name;\n        },\n      },\n    },\n    methods: {\n      async getFile(this: FileSystemFileHandleState): Promise<object> {\n        const file = await this.hostHandle.getFile();\n\n        // Convert native File to our internal File representation\n        const buffer = await file.arrayBuffer();\n        const data = new Uint8Array(buffer);\n\n        return {\n          parts: [data],\n          type: file.type,\n          size: file.size,\n          name: file.name,\n          lastModified: file.lastModified,\n          webkitRelativePath: \"\",\n          // Include methods that will be recognized\n          async text() {\n            return new TextDecoder().decode(data);\n          },\n          async arrayBuffer() {\n            return buffer;\n          },\n          async bytes() {\n            return data;\n          },\n        };\n      },\n      async _createWritableInternal(\n        this: FileSystemFileHandleState,\n        options?: unknown\n      ): Promise<{ __writableStreamId: number }> {\n        const opts = options as { keepExistingData?: boolean } | undefined;\n        const hostStream = await this.hostHandle.createWritable({\n          keepExistingData: opts?.keepExistingData,\n        });\n\n        return { __writableStreamId: registerHostWritableStream(hostStream) };\n      },\n      async isSameEntry(\n        this: FileSystemFileHandleState,\n        other: unknown\n      ): Promise<boolean> {\n        if (!other || typeof other !== \"object\") {\n          return false;\n        }\n        const otherHandle = other as FileSystemFileHandleState;\n        return this.hostHandle === otherHandle.hostHandle;\n      },\n    },\n  });\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE4B,IAA5B;AAIA,IAAI,mBAAmB;AAChB,IAAM,qBAAqB,IAAI;AACtC,IAAI,uBAAuB;AACpB,IAAM,yBAAyB,IAAI;AAEnC,SAAS,sBAAsB,CAAC,QAAgC;AAAA,EACrE,MAAM,KAAK;AAAA,EACX,mBAAmB,IAAI,IAAI,EAAE,QAAQ,MAAM,OAAO,KAAK,CAAC;AAAA,EACxD,OAAO;AAAA;AAGF,SAAS,0BAA0B,CAAC,QAAwC;AAAA,EACjF,MAAM,KAAK;AAAA,EACX,uBAAuB,IAAI,IAAI,MAAM;AAAA,EACrC,OAAO;AAAA;AAMF,SAAS,+BAA+B,CAC7C,SACA,UACe;AAAA,EACf,OAAO,gCAAuC,SAAS,UAAU;AAAA,IAC/D,MAAM;AAAA,IACN,WAAW,CAAC,SAAS;AAAA,MACnB,MAAM,eAAe,KAAK;AAAA,MAC1B,MAAM,UAAU,mBAAmB,IAAI,YAAY;AAAA,MACnD,IAAI,CAAC,SAAS;AAAA,QACZ,MAAM,IAAI,MAAM,kCAAkC,cAAc;AAAA,MAClE;AAAA,MACA,mBAAmB,OAAO,YAAY;AAAA,MACtC,OAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM,QAAQ;AAAA,QACd,YAAY,QAAQ;AAAA,MACtB;AAAA;AAAA,IAEF,YAAY;AAAA,MACV,MAAM;AAAA,QACJ,GAAG,GAAkC;AAAA,UACnC,OAAO;AAAA;AAAA,MAEX;AAAA,MACA,MAAM;AAAA,QACJ,GAAG,GAAkC;AAAA,UACnC,OAAO,KAAK;AAAA;AAAA,MAEhB;AAAA,IACF;AAAA,IACA,SAAS;AAAA,WACD,QAAO,GAAmD;AAAA,QAC9D,MAAM,OAAO,MAAM,KAAK,WAAW,QAAQ;AAAA,QAG3C,MAAM,SAAS,MAAM,KAAK,YAAY;AAAA,QACtC,MAAM,OAAO,IAAI,WAAW,MAAM;AAAA,QAElC,OAAO;AAAA,UACL,OAAO,CAAC,IAAI;AAAA,UACZ,MAAM,KAAK;AAAA,UACX,MAAM,KAAK;AAAA,UACX,MAAM,KAAK;AAAA,UACX,cAAc,KAAK;AAAA,UACnB,oBAAoB;AAAA,eAEd,KAAI,GAAG;AAAA,YACX,OAAO,IAAI,YAAY,EAAE,OAAO,IAAI;AAAA;AAAA,eAEhC,YAAW,GAAG;AAAA,YAClB,OAAO;AAAA;AAAA,eAEH,MAAK,GAAG;AAAA,YACZ,OAAO;AAAA;AAAA,QAEX;AAAA;AAAA,WAEI,wBAAuB,CAE3B,SACyC;AAAA,QACzC,MAAM,OAAO;AAAA,QACb,MAAM,aAAa,MAAM,KAAK,WAAW,eAAe;AAAA,UACtD,kBAAkB,MAAM;AAAA,QAC1B,CAAC;AAAA,QAED,OAAO,EAAE,oBAAoB,2BAA2B,UAAU,EAAE;AAAA;AAAA,WAEhE,YAAW,CAEf,OACkB;AAAA,QAClB,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AAAA,UACvC,OAAO;AAAA,QACT;AAAA,QACA,MAAM,cAAc;AAAA,QACpB,OAAO,KAAK,eAAe,YAAY;AAAA;AAAA,IAE3C;AAAA,EACF,CAAC;AAAA;",
+  "debugId": "03934374EFF6363C64756E2164756E21",
+  "names": []
+}

package/dist/cjs/index.cjs

@@ -0,0 +1,43 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/fs/src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  setupFs: () => import_setup.setupFs,
+  createNodeDirectoryHandle: () => import_node_adapter.createNodeDirectoryHandle,
+  createMemoryDirectoryHandle: () => import_memory_adapter.createMemoryDirectoryHandle
+});
+module.exports = __toCommonJS(exports_src);
+var import_setup = require("./setup.ts");
+var import_node_adapter = require("./node-adapter.ts");
+var import_memory_adapter = require("./memory-adapter.ts");
+})
+
+//# debugId=A9E29D78C7B0FEDC64756E2164756E21

package/dist/cjs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": [
+    "export { setupFs } from \"./setup.ts\";\nexport { createNodeDirectoryHandle } from \"./node-adapter.ts\";\nexport { createMemoryDirectoryHandle } from \"./memory-adapter.ts\";\n\nexport type {\n  SetupFsOptions,\n  FsHandle,\n  HostDirectoryHandle,\n  HostFileHandle,\n  HostWritableFileStream,\n  WriteParams,\n} from \"./types.ts\";\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAwB,IAAxB;AAC0C,IAA1C;AAC4C,IAA5C;",
+  "debugId": "A9E29D78C7B0FEDC64756E2164756E21",
+  "names": []
+}