opfs-worker 0.2.0 → 0.2.2

package/dist/index.js

@@ -1,26 +1,1186 @@
-/**
- * Main export for OPFS Worker library
- *
- * This is the main entry point for the library, providing both the inline worker
- * functionality and all the necessary types and interfaces.
- *
- * @example
- * ```typescript
- * import { createWorker, type OPFSWorker } from 'opfs-worker';
- *
- * const fs = await createWorker();
- * await fs.mount('/my-app');
- * await fs.writeFile('/test.txt', 'Hello World');
- * ```
+import { wrap as i, proxy as o } from "comlink";
+import { D as u, F as d, O as p, b as w, a as y, P as m, c as g, S as v, T as E, e as S, k as F, d as b, l as P, h as x, o as A, f as T, m as O, g as I, j as _, n as D, i as k, r as C, s as U, w as R } from "./helpers-Co-qCBmA.js";
+const a = `/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
  */
-import { wrap } from 'comlink';
-import WorkerCtor from './worker?worker&inline';
-// Export all types
-export * from './types';
-/**
- * Creates a new file system instance with inline worker
- * @returns Promise resolving to the file system interface
- */
-export function createWorker() {
-    return wrap(new WorkerCtor());
+const H = Symbol("Comlink.proxy"), R = Symbol("Comlink.endpoint"), B = Symbol("Comlink.releaseProxy"), T = Symbol("Comlink.finalizer"), p = Symbol("Comlink.thrown"), $ = (e) => typeof e == "object" && e !== null || typeof e == "function", W = {
+  canHandle: (e) => $(e) && e[H],
+  serialize(e) {
+    const { port1: t, port2: r } = new MessageChannel();
+    return O(e, t), [r, [r]];
+  },
+  deserialize(e) {
+    return e.start(), Y(e);
+  }
+}, j = {
+  canHandle: (e) => $(e) && p in e,
+  serialize({ value: e }) {
+    let t;
+    return e instanceof Error ? t = {
+      isError: !0,
+      value: {
+        message: e.message,
+        name: e.name,
+        stack: e.stack
+      }
+    } : t = { isError: !1, value: e }, [t, []];
+  },
+  deserialize(e) {
+    throw e.isError ? Object.assign(new Error(e.value.message), e.value) : e.value;
+  }
+}, U = /* @__PURE__ */ new Map([
+  ["proxy", W],
+  ["throw", j]
+]);
+function V(e, t) {
+  for (const r of e)
+    if (t === r || r === "*" || r instanceof RegExp && r.test(t))
+      return !0;
+  return !1;
+}
+function O(e, t = globalThis, r = ["*"]) {
+  t.addEventListener("message", function a(n) {
+    if (!n || !n.data)
+      return;
+    if (!V(r, n.origin)) {
+      console.warn(\`Invalid origin '\${n.origin}' for comlink proxy\`);
+      return;
+    }
+    const { id: s, type: o, path: i } = Object.assign({ path: [] }, n.data), l = (n.data.argumentList || []).map(d);
+    let u;
+    try {
+      const f = i.slice(0, -1).reduce((h, g) => h[g], e), w = i.reduce((h, g) => h[g], e);
+      switch (o) {
+        case "GET":
+          u = w;
+          break;
+        case "SET":
+          f[i.slice(-1)[0]] = d(n.data.value), u = !0;
+          break;
+        case "APPLY":
+          u = w.apply(f, l);
+          break;
+        case "CONSTRUCT":
+          {
+            const h = new w(...l);
+            u = Q(h);
+          }
+          break;
+        case "ENDPOINT":
+          {
+            const { port1: h, port2: g } = new MessageChannel();
+            O(e, g), u = J(h, [h]);
+          }
+          break;
+        case "RELEASE":
+          u = void 0;
+          break;
+        default:
+          return;
+      }
+    } catch (f) {
+      u = { value: f, [p]: 0 };
+    }
+    Promise.resolve(u).catch((f) => ({ value: f, [p]: 0 })).then((f) => {
+      const [w, h] = A(f);
+      t.postMessage(Object.assign(Object.assign({}, w), { id: s }), h), o === "RELEASE" && (t.removeEventListener("message", a), L(t), T in e && typeof e[T] == "function" && e[T]());
+    }).catch((f) => {
+      const [w, h] = A({
+        value: new TypeError("Unserializable return value"),
+        [p]: 0
+      });
+      t.postMessage(Object.assign(Object.assign({}, w), { id: s }), h);
+    });
+  }), t.start && t.start();
+}
+function G(e) {
+  return e.constructor.name === "MessagePort";
+}
+function L(e) {
+  G(e) && e.close();
+}
+function Y(e, t) {
+  const r = /* @__PURE__ */ new Map();
+  return e.addEventListener("message", function(n) {
+    const { data: s } = n;
+    if (!s || !s.id)
+      return;
+    const o = r.get(s.id);
+    if (o)
+      try {
+        o(s);
+      } finally {
+        r.delete(s.id);
+      }
+  }), x(e, r, [], t);
+}
+function E(e) {
+  if (e)
+    throw new Error("Proxy has been released and is not useable");
+}
+function z(e) {
+  return y(e, /* @__PURE__ */ new Map(), {
+    type: "RELEASE"
+  }).then(() => {
+    L(e);
+  });
+}
+const F = /* @__PURE__ */ new WeakMap(), S = "FinalizationRegistry" in globalThis && new FinalizationRegistry((e) => {
+  const t = (F.get(e) || 0) - 1;
+  F.set(e, t), t === 0 && z(e);
+});
+function X(e, t) {
+  const r = (F.get(t) || 0) + 1;
+  F.set(t, r), S && S.register(e, t, e);
+}
+function q(e) {
+  S && S.unregister(e);
+}
+function x(e, t, r = [], a = function() {
+}) {
+  let n = !1;
+  const s = new Proxy(a, {
+    get(o, i) {
+      if (E(n), i === B)
+        return () => {
+          q(s), z(e), t.clear(), n = !0;
+        };
+      if (i === "then") {
+        if (r.length === 0)
+          return { then: () => s };
+        const l = y(e, t, {
+          type: "GET",
+          path: r.map((u) => u.toString())
+        }).then(d);
+        return l.then.bind(l);
+      }
+      return x(e, t, [...r, i]);
+    },
+    set(o, i, l) {
+      E(n);
+      const [u, f] = A(l);
+      return y(e, t, {
+        type: "SET",
+        path: [...r, i].map((w) => w.toString()),
+        value: u
+      }, f).then(d);
+    },
+    apply(o, i, l) {
+      E(n);
+      const u = r[r.length - 1];
+      if (u === R)
+        return y(e, t, {
+          type: "ENDPOINT"
+        }).then(d);
+      if (u === "bind")
+        return x(e, t, r.slice(0, -1));
+      const [f, w] = v(l);
+      return y(e, t, {
+        type: "APPLY",
+        path: r.map((h) => h.toString()),
+        argumentList: f
+      }, w).then(d);
+    },
+    construct(o, i) {
+      E(n);
+      const [l, u] = v(i);
+      return y(e, t, {
+        type: "CONSTRUCT",
+        path: r.map((f) => f.toString()),
+        argumentList: l
+      }, u).then(d);
+    }
+  });
+  return X(s, e), s;
+}
+function K(e) {
+  return Array.prototype.concat.apply([], e);
+}
+function v(e) {
+  const t = e.map(A);
+  return [t.map((r) => r[0]), K(t.map((r) => r[1]))];
+}
+const _ = /* @__PURE__ */ new WeakMap();
+function J(e, t) {
+  return _.set(e, t), e;
+}
+function Q(e) {
+  return Object.assign(e, { [H]: !0 });
+}
+function A(e) {
+  for (const [t, r] of U)
+    if (r.canHandle(e)) {
+      const [a, n] = r.serialize(e);
+      return [
+        {
+          type: "HANDLER",
+          name: t,
+          value: a
+        },
+        n
+      ];
+    }
+  return [
+    {
+      type: "RAW",
+      value: e
+    },
+    _.get(e) || []
+  ];
+}
+function d(e) {
+  switch (e.type) {
+    case "HANDLER":
+      return U.get(e.name).deserialize(e.value);
+    case "RAW":
+      return e.value;
+  }
+}
+function y(e, t, r, a) {
+  return new Promise((n) => {
+    const s = Z();
+    t.set(s, n), e.start && e.start(), e.postMessage(Object.assign({ id: s }, r), a);
+  });
+}
+function Z() {
+  return new Array(4).fill(0).map(() => Math.floor(Math.random() * Number.MAX_SAFE_INTEGER).toString(16)).join("-");
+}
+class c extends Error {
+  constructor(t, r, a) {
+    super(t), this.code = r, this.path = a, this.name = "OPFSError";
+  }
+}
+class ee extends c {
+  constructor() {
+    super("OPFS is not supported in this browser", "OPFS_NOT_SUPPORTED");
+  }
+}
+class D extends c {
+  constructor() {
+    super("OPFS is not mounted", "OPFS_NOT_MOUNTED");
+  }
+}
+class k extends c {
+  constructor(t, r) {
+    super(t, "INVALID_PATH", r);
+  }
+}
+class b extends c {
+  constructor(t) {
+    super(\`File not found: \${t}\`, "FILE_NOT_FOUND", t);
+  }
+}
+function te(e, t = "utf-8") {
+  switch (t) {
+    case "utf8":
+    case "utf-8":
+      return new TextEncoder().encode(e);
+    case "utf16le":
+    case "ucs2":
+    case "ucs-2":
+      return ne(e);
+    case "ascii":
+      return ie(e);
+    case "latin1":
+      return se(e);
+    case "binary":
+      return Uint8Array.from(e, (r) => r.charCodeAt(0));
+    case "base64":
+      return Uint8Array.from(atob(e), (r) => r.charCodeAt(0));
+    case "hex":
+      if (!/^[\\da-f]+$/i.test(e) || e.length % 2 !== 0)
+        throw new c("Invalid hex string", "INVALID_HEX_FORMAT");
+      return Uint8Array.from(e.match(/.{1,2}/g).map((r) => parseInt(r, 16)));
+    default:
+      return console.warn("Encoding not supported, falling back to UTF-8"), new TextEncoder().encode(e);
+  }
+}
+function re(e, t = "utf-8") {
+  switch (t) {
+    case "utf8":
+    case "utf-8":
+      return new TextDecoder().decode(e);
+    case "utf16le":
+    case "ucs2":
+    case "ucs-2":
+      return ae(e);
+    case "latin1":
+      return String.fromCharCode(...e);
+    case "binary":
+      return String.fromCharCode(...e);
+    case "ascii":
+      return String.fromCharCode(...e.map((r) => r & 127));
+    case "base64":
+      return btoa(String.fromCharCode(...e));
+    case "hex":
+      return Array.from(e).map((r) => r.toString(16).padStart(2, "0")).join("");
+    default:
+      return console.warn("Unsupported encoding, falling back to UTF-8"), new TextDecoder().decode(e);
+  }
+}
+function ne(e) {
+  const t = new Uint8Array(e.length * 2);
+  for (let r = 0; r < e.length; r++) {
+    const a = e.charCodeAt(r);
+    t[r * 2] = a & 255, t[r * 2 + 1] = a >> 8;
+  }
+  return t;
+}
+function ae(e) {
+  e.length % 2 !== 0 && (console.warn("Invalid UTF-16LE buffer length, truncating last byte"), e = e.slice(0, e.length - 1));
+  const t = new Uint16Array(e.buffer, e.byteOffset, e.byteLength / 2);
+  return String.fromCharCode(...t);
+}
+function se(e) {
+  const t = new Uint8Array(e.length);
+  for (let r = 0; r < e.length; r++)
+    t[r] = e.charCodeAt(r) & 255;
+  return t;
+}
+function ie(e) {
+  const t = new Uint8Array(e.length);
+  for (let r = 0; r < e.length; r++)
+    t[r] = e.charCodeAt(r) & 127;
+  return t;
+}
+function oe() {
+  if (!("storage" in navigator) || !("getDirectory" in navigator.storage))
+    throw new ee();
+}
+function m(e) {
+  return Array.isArray(e) ? e : e.split("/").filter(Boolean);
+}
+function N(e) {
+  return typeof e == "string" ? e ?? "/" : \`/\${e.join("/")}\`;
+}
+function P(e) {
+  const t = m(e);
+  return t[t.length - 1] || "";
+}
+function M(e) {
+  const t = m(e);
+  return t.pop(), N(t);
+}
+function I(e) {
+  return !e || e === "/" ? "/" : e.startsWith("/") ? e : \`/\${e}\`;
+}
+function ce(e) {
+  const t = m(e), r = [];
+  for (const a of t)
+    if (!(a === "." || a === ""))
+      if (a === "..") {
+        if (r.length === 0)
+          continue;
+        r.pop();
+      } else
+        r.push(a);
+  return N(r);
+}
+function le(e, t = "utf-8") {
+  return typeof e == "string" ? te(e, t) : e instanceof Uint8Array ? e : new Uint8Array(e);
+}
+async function ue(e) {
+  const t = await e.createSyncAccessHandle();
+  try {
+    const r = t.getSize(), a = new Uint8Array(r);
+    return t.read(a, { at: 0 }), a;
+  } finally {
+    t.close();
+  }
+}
+async function C(e, t, r, a = {}) {
+  let n = null;
+  try {
+    n = await e.createSyncAccessHandle();
+    const s = le(t, r), o = a.append ? n.getSize() : 0;
+    n.write(s, { at: o }), a.truncate && !a.append && n.truncate(s.byteLength), n.flush();
+  } catch (s) {
+    console.error(s);
+    const o = a.append ? "append" : "write";
+    throw new c(\`Failed to \${o} file\`, \`\${o.toUpperCase()}_FAILED\`);
+  } finally {
+    if (n)
+      try {
+        n.close();
+      } catch {
+      }
+  }
+}
+async function fe(e, t = "SHA-1") {
+  try {
+    const r = new Uint8Array(e), a = await crypto.subtle.digest(t, r);
+    return Array.from(new Uint8Array(a)).map((s) => s.toString(16).padStart(2, "0")).join("");
+  } catch (r) {
+    throw console.warn(\`Failed to calculate \${t} hash:\`, r), r;
+  }
+}
+async function he(e) {
+  const t = await e.arrayBuffer();
+  return new Uint8Array(t);
+}
+class we {
+  /** Root directory handle for the file system */
+  root = null;
+  /** Watch event callback */
+  watchCallback = null;
+  /** Map of watched paths to their last known state */
+  watchers = /* @__PURE__ */ new Map();
+  /** Interval handle for polling watched paths */
+  watchTimer = null;
+  /** Polling interval in milliseconds */
+  watchInterval = 1e3;
+  /** Flag to avoid concurrent scans */
+  scanning = !1;
+  /** Promise to prevent concurrent mount operations */
+  mountingPromise = null;
+  /**
+   * Creates a new OPFSFileSystem instance
+   * 
+   * @param watchCallback - Optional callback for file change events
+   * @param watchOptions - Optional configuration for watching
+   * @throws {OPFSError} If OPFS is not supported in the current browser
+   */
+  constructor(t, r) {
+    oe(), t && (this.watchCallback = t, r?.watchInterval && (this.watchInterval = r.watchInterval)), this.mount("/");
+  }
+  /**
+   * Initialize the file system within a given directory
+   * 
+   * This method sets up the root directory for all subsequent operations.
+   * If no root is specified, it will use the OPFS root directory.
+   * 
+   * @param root - The root path for the file system (default: '/')
+   * @returns Promise that resolves to true if initialization was successful
+   * @throws {OPFSError} If initialization fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * const fs = new OPFSFileSystem();
+   * 
+   * // Use OPFS root (default)
+   * await fs.mount();
+   * 
+   * // Use custom directory
+   * await fs.mount('/my-app');
+   * \`\`\`
+   */
+  async mount(t = "/") {
+    return this.mountingPromise && await this.mountingPromise, this.mountingPromise = new Promise(async (r, a) => {
+      this.root = null;
+      try {
+        const n = await navigator.storage.getDirectory();
+        t === "/" ? this.root = n : this.root = await this.getDirectoryHandle(t, !0, n), r(!0);
+      } catch (n) {
+        console.error(n), a(new c("Failed to initialize OPFS", "INIT_FAILED"));
+      } finally {
+        this.mountingPromise = null;
+      }
+    }), this.mountingPromise;
+  }
+  /**
+   * Set the watch callback for file change events
+   * 
+   * @param callback - The callback function to invoke when files change
+   * @param options - Optional configuration for watching
+   */
+  setWatchCallback(t, r) {
+    this.watchCallback = t, r?.watchInterval && (this.watchInterval = r.watchInterval);
+  }
+  /**
+   * Automatically mount the OPFS root if not already mounted
+   * 
+   * This method is called internally when file operations are performed
+   * without explicitly mounting first.
+   * 
+   * @returns Promise that resolves when auto-mount is complete
+   * @throws {OPFSError} If auto-mount fails
+   */
+  async ensureMounted() {
+    if (!this.root) {
+      if (this.mountingPromise) {
+        await this.mountingPromise;
+        return;
+      }
+      throw new c("OPFS not mounted", "NOT_MOUNTED");
+    }
+  }
+  /**
+   * Get a directory handle from a path
+   * 
+   * Navigates through the directory structure to find or create a directory
+   * at the specified path.
+   * 
+   * @param path - The path to the directory (string or array of segments)
+   * @param create - Whether to create the directory if it doesn't exist (default: false)
+   * @param from - The directory to start from (default: root directory)
+   * @returns Promise that resolves to the directory handle
+   * @throws {OPFSError} If the directory cannot be accessed or created
+   * 
+   * @example
+   * \`\`\`typescript
+   * const docsDir = await fs.getDirectoryHandle('/users/john/documents', true);
+   * const docsDir2 = await fs.getDirectoryHandle(['users', 'john', 'documents'], true);
+   * \`\`\`
+   */
+  async getDirectoryHandle(t, r = !1, a = this.root) {
+    if (!a)
+      throw new D();
+    const n = Array.isArray(t) ? t : m(t);
+    let s = a;
+    for (const o of n)
+      s = await s.getDirectoryHandle(o, { create: r });
+    return s;
+  }
+  /**
+   * Get a file handle from a path
+   * 
+   * Navigates to the parent directory and retrieves or creates a file handle
+   * for the specified file path.
+   * 
+   * @param path - The path to the file (string or array of segments)
+   * @param create - Whether to create the file if it doesn't exist (default: false)
+   * @param from - The directory to start from (default: root directory)
+   * @returns Promise that resolves to the file handle
+   * @throws {PathError} If the path is empty
+   * @throws {OPFSError} If the file cannot be accessed or created
+   * 
+   * @example
+   * \`\`\`typescript
+   * const fileHandle = await fs.getFileHandle('/config/settings.json', true);
+   * const fileHandle2 = await fs.getFileHandle(['config', 'settings.json'], true);
+   * \`\`\`
+   */
+  async getFileHandle(t, r = !1, a = this.root) {
+    if (!a)
+      throw new D();
+    const n = m(t);
+    if (n.length === 0)
+      throw new k("Path must not be empty", Array.isArray(t) ? t.join("/") : t);
+    const s = n.pop();
+    return (await this.getDirectoryHandle(n, r, a)).getFileHandle(s, { create: r });
+  }
+  /**
+   * Recursively list all files and directories with their stats
+   * 
+   * Traverses the entire file system starting from the root and returns
+   * a Map containing all paths and their corresponding file statistics.
+   * 
+   * @param options - Options for indexing
+   * @param options.includeHash - Whether to calculate file hash (default: false)
+   * @param options.hashAlgorithm - Hash algorithm to use (default: 'SHA-1', fastest)
+   * @returns Promise that resolves to a Map of path => FileStat
+   * @throws {OPFSError} If the indexing operation fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Basic index without hash
+   * const index = await fs.index();
+   * 
+   * // Index with file hash
+   * const indexWithHash = await fs.index({ 
+   *   includeHash: true,
+   *   hashAlgorithm: 'SHA-1'
+   * });
+   * 
+   * // Iterate through all files and directories
+   * for (const [path, stat] of index) {
+   *   console.log(\`\${path}: \${stat.isFile ? 'file' : 'directory'} (\${stat.size} bytes)\`);
+   *   if (stat.hash) console.log(\`  Hash: \${stat.hash}\`);
+   * }
+   * 
+   * // Get specific file stats
+   * const fileStats = index.get('/data/config.json');
+   * if (fileStats) {
+   *   console.log(\`File size: \${fileStats.size} bytes\`);
+   *   if (fileStats.hash) console.log(\`Hash: \${fileStats.hash}\`);
+   * }
+   * \`\`\`
+   */
+  async index(t) {
+    const r = /* @__PURE__ */ new Map(), a = async (n) => {
+      const s = await this.readdir(n, { withFileTypes: !0 });
+      for (const o of s) {
+        const i = \`\${n === "/" ? "" : n}/\${o.name}\`;
+        try {
+          const l = await this.stat(i, t);
+          r.set(i, l), l.isDirectory && await a(i);
+        } catch (l) {
+          console.warn(\`Skipping broken entry: \${i}\`, l);
+        }
+      }
+    };
+    return r.set("/", {
+      kind: "directory",
+      size: 0,
+      mtime: (/* @__PURE__ */ new Date(0)).toISOString(),
+      ctime: (/* @__PURE__ */ new Date(0)).toISOString(),
+      isFile: !1,
+      isDirectory: !0
+    }), await a("/"), r;
+  }
+  async readFile(t, r = "utf-8") {
+    await this.ensureMounted();
+    try {
+      const a = await this.getFileHandle(t, !1), n = await ue(a);
+      return r === "binary" ? n : re(n, r);
+    } catch (a) {
+      throw console.error(a), new b(t);
+    }
+  }
+  /**
+   * Write data to a file
+   * 
+   * Creates or overwrites a file with the specified data. If the file already
+   * exists, it will be truncated before writing.
+   * 
+   * @param path - The path to the file to write
+   * @param data - The data to write to the file (string, Uint8Array, or ArrayBuffer)
+   * @param encoding - The encoding to use when writing string data (default: 'utf-8')
+   * @returns Promise that resolves when the write operation is complete
+   * @throws {OPFSError} If writing the file fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Write text data
+   * await fs.writeFile('/config/settings.json', JSON.stringify({ theme: 'dark' }));
+   * 
+   * // Write binary data
+   * const binaryData = new Uint8Array([1, 2, 3, 4, 5]);
+   * await fs.writeFile('/data/binary.dat', binaryData);
+   * 
+   * // Write with specific encoding
+   * await fs.writeFile('/data/utf16.txt', 'Hello World', 'utf-16le');
+   * \`\`\`
+   */
+  async writeFile(t, r, a) {
+    await this.ensureMounted();
+    const n = await this.getFileHandle(t, !0);
+    await C(n, r, a, { truncate: !0 });
+  }
+  /**
+   * Append data to a file
+   * 
+   * Adds data to the end of an existing file. If the file doesn't exist,
+   * it will be created.
+   * 
+   * @param path - The path to the file to append to
+   * @param data - The data to append to the file (string, Uint8Array, or ArrayBuffer)
+   * @param encoding - The encoding to use when appending string data (default: 'utf-8')
+   * @returns Promise that resolves when the append operation is complete
+   * @throws {OPFSError} If appending to the file fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Append text to a log file
+   * await fs.appendFile('/logs/app.log', \`[\${new Date().toISOString()}] User logged in\\n\`);
+   * 
+   * // Append binary data
+   * const additionalData = new Uint8Array([6, 7, 8]);
+   * await fs.appendFile('/data/binary.dat', additionalData);
+   * \`\`\`
+   */
+  async appendFile(t, r, a) {
+    await this.ensureMounted();
+    const n = await this.getFileHandle(t, !0);
+    await C(n, r, a, { append: !0 });
+  }
+  /**
+   * Create a directory
+   * 
+   * Creates a new directory at the specified path. If the recursive option
+   * is enabled, parent directories will be created as needed.
+   * 
+   * @param path - The path where the directory should be created
+   * @param options - Options for directory creation
+   * @param options.recursive - Whether to create parent directories if they don't exist (default: false)
+   * @returns Promise that resolves when the directory is created
+   * @throws {OPFSError} If the directory cannot be created
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Create a single directory
+   * await fs.mkdir('/users/john');
+   * 
+   * // Create nested directories
+   * await fs.mkdir('/users/john/documents/projects', { recursive: true });
+   * \`\`\`
+   */
+  async mkdir(t, r) {
+    if (await this.ensureMounted(), !this.root)
+      throw new D();
+    const a = r?.recursive ?? !1, n = m(t);
+    let s = this.root;
+    for (let o = 0; o < n.length; o++) {
+      const i = n[o];
+      try {
+        s = await s.getDirectoryHandle(i, { create: a || o === n.length - 1 });
+      } catch (l) {
+        throw l.name === "NotFoundError" ? new c(
+          \`Parent directory does not exist: \${N(n.slice(0, o + 1))}\`,
+          "ENOENT"
+        ) : l.name === "TypeMismatchError" ? new c(\`Path segment is not a directory: \${i}\`, "ENOTDIR") : new c("Failed to create directory", "MKDIR_FAILED");
+      }
+    }
+  }
+  /**
+   * Get file or directory stats
+   * 
+   * Retrieves metadata about a file or directory, including size, modification time,
+   * type information, and optionally file hashes.
+   * 
+   * @param path - The path to the file or directory
+   * @param options - Options for stat operation
+   * @param options.includeHash - Whether to calculate file hash (default: false, only for files)
+   * @param options.hashAlgorithm - Hash algorithm to use (default: 'SHA-1', fastest)
+   * @returns Promise that resolves to file/directory statistics
+   * @throws {OPFSError} If the file or directory does not exist or cannot be accessed
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Basic stats
+   * const stats = await fs.stat('/config/settings.json');
+   * console.log(\`File size: \${stats.size} bytes\`);
+   * console.log(\`Is file: \${stats.isFile}\`);
+   * console.log(\`Modified: \${stats.mtime}\`);
+   * 
+   * // Stats with hash (SHA-1 is fastest)
+   * const statsWithHash = await fs.stat('/config/settings.json', { 
+   *   includeHash: true,
+   *   hashAlgorithm: 'SHA-1'
+   * });
+   * console.log(\`Hash: \${statsWithHash.hash}\`);
+   * \`\`\`
+   */
+  async stat(t, r) {
+    await this.ensureMounted();
+    const a = P(t), n = await this.getDirectoryHandle(M(t), !1), s = r?.includeHash ?? !1, o = r?.hashAlgorithm ?? "SHA-1";
+    try {
+      const l = await (await n.getFileHandle(a, { create: !1 })).getFile(), u = {
+        kind: "file",
+        size: l.size,
+        mtime: new Date(l.lastModified).toISOString(),
+        ctime: new Date(l.lastModified).toISOString(),
+        isFile: !0,
+        isDirectory: !1
+      };
+      if (s)
+        try {
+          const f = new Uint8Array(await l.arrayBuffer()), w = await fe(f, o);
+          u.hash = w;
+        } catch (f) {
+          console.warn(\`Failed to calculate hash for \${t}:\`, f);
+        }
+      return u;
+    } catch (i) {
+      if (i.name !== "TypeMismatchError" && i.name !== "NotFoundError")
+        throw new c("Failed to stat (file)", "STAT_FAILED");
+    }
+    try {
+      return await n.getDirectoryHandle(a, { create: !1 }), {
+        kind: "directory",
+        size: 0,
+        mtime: (/* @__PURE__ */ new Date(0)).toISOString(),
+        ctime: (/* @__PURE__ */ new Date(0)).toISOString(),
+        isFile: !1,
+        isDirectory: !0
+      };
+    } catch (i) {
+      throw i.name === "NotFoundError" ? new c(\`No such file or directory: \${t}\`, "ENOENT") : new c("Failed to stat (directory)", "STAT_FAILED");
+    }
+  }
+  async readdir(t, r) {
+    await this.ensureMounted();
+    const a = r?.withFileTypes ?? !1, n = await this.getDirectoryHandle(t, !1);
+    if (a) {
+      const s = [];
+      for await (const [o, i] of n.entries()) {
+        const l = i.kind === "file";
+        s.push({
+          name: o,
+          kind: i.kind,
+          isFile: l,
+          isDirectory: !l
+        });
+      }
+      return s;
+    } else {
+      const s = [];
+      for await (const [o] of n.entries())
+        s.push(o);
+      return s;
+    }
+  }
+  /**
+   * Check if a file or directory exists
+   * 
+   * Verifies if a file or directory exists at the specified path.
+   * 
+   * @param path - The path to check
+   * @returns Promise that resolves to true if the file or directory exists, false otherwise  
+   * 
+   * @example
+   * \`\`\`typescript
+   * const exists = await fs.exists('/config/settings.json');
+   * console.log(\`File exists: \${exists}\`);
+   * \`\`\`
+   */
+  async exists(t) {
+    await this.ensureMounted();
+    const r = P(t);
+    let a = null;
+    try {
+      a = await this.getDirectoryHandle(M(t), !1);
+    } catch (n) {
+      throw (n.name === "NotFoundError" || n.name === "TypeMismatchError") && (a = null), n;
+    }
+    if (!a || !r)
+      return !1;
+    try {
+      return await a.getFileHandle(r, { create: !1 }), !0;
+    } catch (n) {
+      if (n.name !== "NotFoundError" && n.name !== "TypeMismatchError")
+        throw n;
+    }
+    try {
+      return await a.getDirectoryHandle(r, { create: !1 }), !0;
+    } catch (n) {
+      if (n.name !== "NotFoundError" && n.name !== "TypeMismatchError")
+        throw n;
+    }
+    return !1;
+  }
+  /**
+   * Clear all contents of a directory without removing the directory itself
+   * 
+   * Removes all files and subdirectories within the specified directory,
+   * but keeps the directory itself.
+   * 
+   * @param path - The path to the directory to clear (default: '/')
+   * @returns Promise that resolves when all contents are removed
+   * @throws {OPFSError} If the operation fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Clear root directory contents
+   * await fs.clear('/');
+   * 
+   * // Clear specific directory contents
+   * await fs.clear('/data');
+   * \`\`\`
+   */
+  async clear(t = "/") {
+    await this.ensureMounted();
+    try {
+      const r = await this.readdir(t, { withFileTypes: !0 });
+      for (const a of r) {
+        const n = \`\${t === "/" ? "" : t}/\${a.name}\`;
+        await this.remove(n, { recursive: !0 });
+      }
+    } catch (r) {
+      throw r instanceof c ? r : new c(\`Failed to clear directory: \${t}\`, "CLEAR_FAILED");
+    }
+  }
+  /**
+   * Remove files and directories
+   * 
+   * Removes files and directories. Similar to Node.js fs.rm().
+   * 
+   * @param path - The path to remove
+   * @param options - Options for removal
+   * @param options.recursive - Whether to remove directories and their contents recursively (default: false)
+   * @param options.force - Whether to ignore errors if the path doesn't exist (default: false)
+   * @returns Promise that resolves when the removal is complete
+   * @throws {OPFSError} If the removal fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Remove a file
+   * await fs.rm('/path/to/file.txt');
+   * 
+   * // Remove a directory and all its contents
+   * await fs.rm('/path/to/directory', { recursive: true });
+   * 
+   * // Remove with force (ignore if doesn't exist)
+   * await fs.rm('/maybe/exists', { force: true });
+   * \`\`\`
+   */
+  async remove(t, r) {
+    await this.ensureMounted();
+    const a = r?.recursive ?? !1, n = r?.force ?? !1, s = P(t);
+    if (!s)
+      throw new k("Invalid path", t);
+    const o = await this.getDirectoryHandle(M(t), !1);
+    try {
+      await o.removeEntry(s, { recursive: a });
+    } catch (i) {
+      if (i.name === "NotFoundError") {
+        if (!n)
+          throw new c(\`No such file or directory: \${t}\`, "ENOENT");
+      } else throw i.name === "InvalidModificationError" ? new c(\`Directory not empty: \${t}. Use recursive option to force removal.\`, "ENOTEMPTY") : i.name === "TypeMismatchError" && !a ? new c(\`Cannot remove directory without recursive option: \${t}\`, "EISDIR") : new c(\`Failed to remove path: \${t}\`, "RM_FAILED");
+    }
+  }
+  /**
+   * Resolve a path to an absolute path
+   * 
+   * Resolves relative paths and normalizes path segments (like '..' and '.').
+   * Similar to Node.js fs.realpath() but without symlink resolution since OPFS doesn't support symlinks.
+   * 
+   * @param path - The path to resolve
+   * @returns Promise that resolves to the absolute normalized path
+   * @throws {FileNotFoundError} If the path does not exist
+   * @throws {OPFSError} If path resolution fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Resolve relative path
+   * const absolute = await fs.realpath('./config/../data/file.txt');
+   * console.log(absolute); // '/data/file.txt'
+   * \`\`\`
+   */
+  async realpath(t) {
+    await this.ensureMounted();
+    try {
+      const r = ce(t);
+      if (!await this.exists(r))
+        throw new b(r);
+      return r;
+    } catch (r) {
+      throw r instanceof c ? r : new c(\`Failed to resolve path: \${t}\`, "REALPATH_FAILED");
+    }
+  }
+  /**
+   * Rename a file or directory
+   * 
+   * Changes the name of a file or directory. If the target path already exists,
+   * it will be replaced.
+   * 
+   * @param oldPath - The current path of the file or directory
+   * @param newPath - The new path for the file or directory
+   * @returns Promise that resolves when the rename operation is complete
+   * @throws {OPFSError} If the rename operation fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * await fs.rename('/old/path/file.txt', '/new/path/renamed.txt');
+   * \`\`\`
+   */
+  async rename(t, r) {
+    await this.ensureMounted();
+    try {
+      if (!await this.exists(t))
+        throw new b(t);
+      await this.copy(t, r, { recursive: !0 }), await this.remove(t, { recursive: !0 });
+    } catch (a) {
+      throw a instanceof c ? a : new c(\`Failed to rename from \${t} to \${r}\`, "RENAME_FAILED");
+    }
+  }
+  /**
+   * Copy files and directories
+   * 
+   * Copies files and directories. Similar to Node.js fs.cp().
+   * 
+   * @param source - The source path to copy from
+   * @param destination - The destination path to copy to
+   * @param options - Options for copying
+   * @param options.recursive - Whether to copy directories recursively (default: false)
+   * @param options.force - Whether to overwrite existing files (default: true)
+   * @returns Promise that resolves when the copy operation is complete
+   * @throws {OPFSError} If the copy operation fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Copy a file
+   * await fs.copy('/source/file.txt', '/dest/file.txt');
+   * 
+   * // Copy a directory and all its contents
+   * await fs.copy('/source/dir', '/dest/dir', { recursive: true });
+   * 
+   * // Copy without overwriting existing files
+   * await fs.copy('/source', '/dest', { recursive: true, force: false });
+   * \`\`\`
+   */
+  async copy(t, r, a) {
+    await this.ensureMounted();
+    try {
+      const n = a?.recursive ?? !1, s = a?.force ?? !0;
+      if (!await this.exists(t))
+        throw new c(\`Source does not exist: \${t}\`, "ENOENT");
+      if (await this.exists(r) && !s)
+        throw new c(\`Destination already exists: \${r}\`, "EEXIST");
+      if ((await this.stat(t)).isFile) {
+        const u = await this.readFile(t, "binary");
+        await this.writeFile(r, u);
+      } else {
+        if (!n)
+          throw new c(\`Cannot copy directory without recursive option: \${t}\`, "EISDIR");
+        await this.mkdir(r, { recursive: !0 });
+        const u = await this.readdir(t, { withFileTypes: !0 });
+        for (const f of u) {
+          const w = \`\${t}/\${f.name}\`, h = \`\${r}/\${f.name}\`;
+          await this.copy(w, h, { recursive: !0, force: s });
+        }
+      }
+    } catch (n) {
+      throw n instanceof c ? n : new c(\`Failed to copy from \${t} to \${r}\`, "CP_FAILED");
+    }
+  }
+  /**
+   * Start watching a file or directory for changes
+   */
+  async watch(t) {
+    await this.ensureMounted();
+    const r = I(t), a = await this.buildSnapshot(r);
+    this.watchers.set(r, a), this.watchTimer || (this.watchTimer = setInterval(() => {
+      this.scanWatches();
+    }, this.watchInterval));
+  }
+  /**
+   * Stop watching a previously watched path
+   */
+  unwatch(t) {
+    const r = I(t);
+    this.watchers.delete(r), this.watchers.size === 0 && this.watchTimer && (clearInterval(this.watchTimer), this.watchTimer = null);
+  }
+  async buildSnapshot(t) {
+    const r = /* @__PURE__ */ new Map(), a = async (n) => {
+      const s = await this.stat(n);
+      if (r.set(n, s), s.isDirectory) {
+        const o = await this.readdir(n, { withFileTypes: !0 });
+        for (const i of o) {
+          const l = \`\${n === "/" ? "" : n}/\${i.name}\`;
+          await a(l);
+        }
+      }
+    };
+    return await a(t), r;
+  }
+  async scanWatches() {
+    if (!this.scanning) {
+      this.scanning = !0;
+      try {
+        await Promise.all(
+          [...this.watchers.entries()].map(async ([t, r]) => {
+            let a;
+            try {
+              a = await this.buildSnapshot(t);
+            } catch {
+              a = /* @__PURE__ */ new Map();
+            }
+            const n = [];
+            for (const [s, o] of a) {
+              const i = r.get(s);
+              i ? (i.mtime !== o.mtime || i.size !== o.size) && n.push({ path: s, type: "change" }) : n.push({ path: s, type: "create" });
+            }
+            for (const s of r.keys())
+              a.has(s) || n.push({ path: s, type: "delete" });
+            if (n.length && this.watchCallback)
+              for (const s of n)
+                this.watchCallback(s);
+            this.watchers.set(t, a);
+          })
+        );
+      } finally {
+        this.scanning = !1;
+      }
+    }
+  }
+  /**
+   * Synchronize the file system with external data
+   * 
+   * Syncs the file system with an array of entries containing paths and data.
+   * This is useful for importing data from external sources or syncing with remote data.
+   * 
+   * @param entries - Array of [path, data] tuples to sync
+   * @param options - Options for synchronization
+   * @param options.cleanBefore - Whether to clear the file system before syncing (default: false)
+   * @returns Promise that resolves when synchronization is complete
+   * @throws {OPFSError} If the synchronization fails
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Sync with external data
+   * const entries: [string, string | Uint8Array | Blob][] = [
+   *   ['/config.json', JSON.stringify({ theme: 'dark' })],
+   *   ['/data/binary.dat', new Uint8Array([1, 2, 3, 4])],
+   *   ['/upload.txt', new Blob(['file content'], { type: 'text/plain' })]
+   * ];
+   * 
+   * // Sync without clearing existing files
+   * await fs.sync(entries);
+   * 
+   * // Clean file system and then sync
+   * await fs.sync(entries, { cleanBefore: true });
+   * \`\`\`
+   */
+  async sync(t, r) {
+    await this.ensureMounted();
+    try {
+      (r?.cleanBefore ?? !1) && await this.clear("/");
+      for (const [n, s] of t) {
+        const o = I(n);
+        let i;
+        s instanceof Blob ? i = await he(s) : i = s, await this.writeFile(o, i);
+      }
+    } catch (a) {
+      throw a instanceof c ? a : new c("Failed to sync file system", "SYNC_FAILED");
+    }
+  }
+}
+typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && O(new we());
+//# sourceMappingURL=worker-CMvl9yOu.js.map
+`, r = typeof self < "u" && self.Blob && new Blob(["URL.revokeObjectURL(import.meta.url);", a], { type: "text/javascript;charset=utf-8" });
+function s(e) {
+  let n;
+  try {
+    if (n = r && (self.URL || self.webkitURL).createObjectURL(r), !n) throw "";
+    const t = new Worker(n, {
+      type: "module",
+      name: e?.name
+    });
+    return t.addEventListener("error", () => {
+      (self.URL || self.webkitURL).revokeObjectURL(n);
+    }), t;
+  } catch {
+    return new Worker(
+      "data:text/javascript;charset=utf-8," + encodeURIComponent(a),
+      {
+        type: "module",
+        name: e?.name
+      }
+    );
+  }
+}
+function l(e, n) {
+  const t = i(new s());
+  return e && t.setWatchCallback(o(e), n), t;
 }
+export {
+  u as DirectoryNotFoundError,
+  d as FileNotFoundError,
+  p as OPFSError,
+  w as OPFSNotMountedError,
+  y as OPFSNotSupportedError,
+  m as PathError,
+  g as PermissionError,
+  v as StorageError,
+  E as TimeoutError,
+  S as basename,
+  F as calculateFileHash,
+  b as checkOPFSSupport,
+  P as convertBlobToUint8Array,
+  x as createBuffer,
+  l as createWorker,
+  A as decodeBuffer,
+  T as dirname,
+  O as encodeString,
+  I as extname,
+  _ as joinPath,
+  D as normalizePath,
+  k as readFileData,
+  C as resolvePath,
+  U as splitPath,
+  R as writeFileData
+};
+//# sourceMappingURL=index.js.map