opfs-worker 0.2.1 → 0.2.3

package/dist/index.js

@@ -1,13 +1,1198 @@
-import { wrap } from 'comlink';
-import WorkerCtor from './worker?worker&inline';
-export * from './types';
-export * from './utils/errors';
-export * from './utils/helpers';
-export * from './utils/encoder';
-/**
- * Creates a new file system instance with inline worker
- * @returns Promise resolving to the file system interface
+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 R, s as U, w as C } from "./helpers-Co-qCBmA.js";
+const a = `/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
  */
-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"), $ = (t) => typeof t == "object" && t !== null || typeof t == "function", W = {
+  canHandle: (t) => $(t) && t[H],
+  serialize(t) {
+    const { port1: e, port2: r } = new MessageChannel();
+    return x(t, e), [r, [r]];
+  },
+  deserialize(t) {
+    return t.start(), Y(t);
+  }
+}, j = {
+  canHandle: (t) => $(t) && p in t,
+  serialize({ value: t }) {
+    let e;
+    return t instanceof Error ? e = {
+      isError: !0,
+      value: {
+        message: t.message,
+        name: t.name,
+        stack: t.stack
+      }
+    } : e = { isError: !1, value: t }, [e, []];
+  },
+  deserialize(t) {
+    throw t.isError ? Object.assign(new Error(t.value.message), t.value) : t.value;
+  }
+}, U = /* @__PURE__ */ new Map([
+  ["proxy", W],
+  ["throw", j]
+]);
+function V(t, e) {
+  for (const r of t)
+    if (e === r || r === "*" || r instanceof RegExp && r.test(e))
+      return !0;
+  return !1;
 }
+function x(t, e = globalThis, r = ["*"]) {
+  e.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: i, type: o, path: s } = Object.assign({ path: [] }, n.data), l = (n.data.argumentList || []).map(d);
+    let u;
+    try {
+      const f = s.slice(0, -1).reduce((h, g) => h[g], t), w = s.reduce((h, g) => h[g], t);
+      switch (o) {
+        case "GET":
+          u = w;
+          break;
+        case "SET":
+          f[s.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();
+            x(t, 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);
+      e.postMessage(Object.assign(Object.assign({}, w), { id: i }), h), o === "RELEASE" && (e.removeEventListener("message", a), L(e), T in t && typeof t[T] == "function" && t[T]());
+    }).catch((f) => {
+      const [w, h] = A({
+        value: new TypeError("Unserializable return value"),
+        [p]: 0
+      });
+      e.postMessage(Object.assign(Object.assign({}, w), { id: i }), h);
+    });
+  }), e.start && e.start();
+}
+function G(t) {
+  return t.constructor.name === "MessagePort";
+}
+function L(t) {
+  G(t) && t.close();
+}
+function Y(t, e) {
+  const r = /* @__PURE__ */ new Map();
+  return t.addEventListener("message", function(n) {
+    const { data: i } = n;
+    if (!i || !i.id)
+      return;
+    const o = r.get(i.id);
+    if (o)
+      try {
+        o(i);
+      } finally {
+        r.delete(i.id);
+      }
+  }), O(t, r, [], e);
+}
+function E(t) {
+  if (t)
+    throw new Error("Proxy has been released and is not useable");
+}
+function z(t) {
+  return y(t, /* @__PURE__ */ new Map(), {
+    type: "RELEASE"
+  }).then(() => {
+    L(t);
+  });
+}
+const F = /* @__PURE__ */ new WeakMap(), S = "FinalizationRegistry" in globalThis && new FinalizationRegistry((t) => {
+  const e = (F.get(t) || 0) - 1;
+  F.set(t, e), e === 0 && z(t);
+});
+function X(t, e) {
+  const r = (F.get(e) || 0) + 1;
+  F.set(e, r), S && S.register(t, e, t);
+}
+function q(t) {
+  S && S.unregister(t);
+}
+function O(t, e, r = [], a = function() {
+}) {
+  let n = !1;
+  const i = new Proxy(a, {
+    get(o, s) {
+      if (E(n), s === B)
+        return () => {
+          q(i), z(t), e.clear(), n = !0;
+        };
+      if (s === "then") {
+        if (r.length === 0)
+          return { then: () => i };
+        const l = y(t, e, {
+          type: "GET",
+          path: r.map((u) => u.toString())
+        }).then(d);
+        return l.then.bind(l);
+      }
+      return O(t, e, [...r, s]);
+    },
+    set(o, s, l) {
+      E(n);
+      const [u, f] = A(l);
+      return y(t, e, {
+        type: "SET",
+        path: [...r, s].map((w) => w.toString()),
+        value: u
+      }, f).then(d);
+    },
+    apply(o, s, l) {
+      E(n);
+      const u = r[r.length - 1];
+      if (u === R)
+        return y(t, e, {
+          type: "ENDPOINT"
+        }).then(d);
+      if (u === "bind")
+        return O(t, e, r.slice(0, -1));
+      const [f, w] = N(l);
+      return y(t, e, {
+        type: "APPLY",
+        path: r.map((h) => h.toString()),
+        argumentList: f
+      }, w).then(d);
+    },
+    construct(o, s) {
+      E(n);
+      const [l, u] = N(s);
+      return y(t, e, {
+        type: "CONSTRUCT",
+        path: r.map((f) => f.toString()),
+        argumentList: l
+      }, u).then(d);
+    }
+  });
+  return X(i, t), i;
+}
+function K(t) {
+  return Array.prototype.concat.apply([], t);
+}
+function N(t) {
+  const e = t.map(A);
+  return [e.map((r) => r[0]), K(e.map((r) => r[1]))];
+}
+const _ = /* @__PURE__ */ new WeakMap();
+function J(t, e) {
+  return _.set(t, e), t;
+}
+function Q(t) {
+  return Object.assign(t, { [H]: !0 });
+}
+function A(t) {
+  for (const [e, r] of U)
+    if (r.canHandle(t)) {
+      const [a, n] = r.serialize(t);
+      return [
+        {
+          type: "HANDLER",
+          name: e,
+          value: a
+        },
+        n
+      ];
+    }
+  return [
+    {
+      type: "RAW",
+      value: t
+    },
+    _.get(t) || []
+  ];
+}
+function d(t) {
+  switch (t.type) {
+    case "HANDLER":
+      return U.get(t.name).deserialize(t.value);
+    case "RAW":
+      return t.value;
+  }
+}
+function y(t, e, r, a) {
+  return new Promise((n) => {
+    const i = Z();
+    e.set(i, n), t.start && t.start(), t.postMessage(Object.assign({ id: i }, 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(e, r, a) {
+    super(e), 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(e, r) {
+    super(e, "INVALID_PATH", r);
+  }
+}
+class b extends c {
+  constructor(e) {
+    super(\`File not found: \${e}\`, "FILE_NOT_FOUND", e);
+  }
+}
+function te(t, e = "utf-8") {
+  switch (e) {
+    case "utf8":
+    case "utf-8":
+      return new TextEncoder().encode(t);
+    case "utf16le":
+    case "ucs2":
+    case "ucs-2":
+      return ne(t);
+    case "ascii":
+      return se(t);
+    case "latin1":
+      return ie(t);
+    case "binary":
+      return Uint8Array.from(t, (r) => r.charCodeAt(0));
+    case "base64":
+      return Uint8Array.from(atob(t), (r) => r.charCodeAt(0));
+    case "hex":
+      if (!/^[\\da-f]+$/i.test(t) || t.length % 2 !== 0)
+        throw new c("Invalid hex string", "INVALID_HEX_FORMAT");
+      return Uint8Array.from(t.match(/.{1,2}/g).map((r) => parseInt(r, 16)));
+    default:
+      return console.warn("Encoding not supported, falling back to UTF-8"), new TextEncoder().encode(t);
+  }
+}
+function re(t, e = "utf-8") {
+  switch (e) {
+    case "utf8":
+    case "utf-8":
+      return new TextDecoder().decode(t);
+    case "utf16le":
+    case "ucs2":
+    case "ucs-2":
+      return ae(t);
+    case "latin1":
+      return String.fromCharCode(...t);
+    case "binary":
+      return String.fromCharCode(...t);
+    case "ascii":
+      return String.fromCharCode(...t.map((r) => r & 127));
+    case "base64":
+      return btoa(String.fromCharCode(...t));
+    case "hex":
+      return Array.from(t).map((r) => r.toString(16).padStart(2, "0")).join("");
+    default:
+      return console.warn("Unsupported encoding, falling back to UTF-8"), new TextDecoder().decode(t);
+  }
+}
+function ne(t) {
+  const e = new Uint8Array(t.length * 2);
+  for (let r = 0; r < t.length; r++) {
+    const a = t.charCodeAt(r);
+    e[r * 2] = a & 255, e[r * 2 + 1] = a >> 8;
+  }
+  return e;
+}
+function ae(t) {
+  t.length % 2 !== 0 && (console.warn("Invalid UTF-16LE buffer length, truncating last byte"), t = t.slice(0, t.length - 1));
+  const e = new Uint16Array(t.buffer, t.byteOffset, t.byteLength / 2);
+  return String.fromCharCode(...e);
+}
+function ie(t) {
+  const e = new Uint8Array(t.length);
+  for (let r = 0; r < t.length; r++)
+    e[r] = t.charCodeAt(r) & 255;
+  return e;
+}
+function se(t) {
+  const e = new Uint8Array(t.length);
+  for (let r = 0; r < t.length; r++)
+    e[r] = t.charCodeAt(r) & 127;
+  return e;
+}
+function oe() {
+  if (!("storage" in navigator) || !("getDirectory" in navigator.storage))
+    throw new ee();
+}
+function m(t) {
+  return Array.isArray(t) ? t : t.split("/").filter(Boolean);
+}
+function v(t) {
+  return typeof t == "string" ? t ?? "/" : \`/\${t.join("/")}\`;
+}
+function I(t) {
+  const e = m(t);
+  return e[e.length - 1] || "";
+}
+function P(t) {
+  const e = m(t);
+  return e.pop(), v(e);
+}
+function M(t) {
+  return !t || t === "/" ? "/" : t.startsWith("/") ? t : \`/\${t}\`;
+}
+function ce(t) {
+  const e = m(t), r = [];
+  for (const a of e)
+    if (!(a === "." || a === ""))
+      if (a === "..") {
+        if (r.length === 0)
+          continue;
+        r.pop();
+      } else
+        r.push(a);
+  return v(r);
+}
+function le(t, e = "utf-8") {
+  return typeof t == "string" ? te(t, e) : t instanceof Uint8Array ? t : new Uint8Array(t);
+}
+async function ue(t) {
+  const e = await t.createSyncAccessHandle();
+  try {
+    const r = e.getSize(), a = new Uint8Array(r);
+    return e.read(a, { at: 0 }), a;
+  } finally {
+    e.close();
+  }
+}
+async function C(t, e, r, a = {}) {
+  let n = null;
+  try {
+    n = await t.createSyncAccessHandle();
+    const i = le(e, r), o = a.append ? n.getSize() : 0;
+    n.write(i, { at: o }), a.truncate && !a.append && n.truncate(i.byteLength), n.flush();
+  } catch (i) {
+    console.error(i);
+    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(t, e = "SHA-1") {
+  try {
+    const r = new Uint8Array(t), a = await crypto.subtle.digest(e, r);
+    return Array.from(new Uint8Array(a)).map((i) => i.toString(16).padStart(2, "0")).join("");
+  } catch (r) {
+    throw console.warn(\`Failed to calculate \${e} hash:\`, r), r;
+  }
+}
+async function he(t) {
+  const e = await t.arrayBuffer();
+  return new Uint8Array(e);
+}
+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(e, r) {
+    oe(), e && (this.watchCallback = e, 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(e = "/") {
+    return this.mountingPromise && await this.mountingPromise, this.mountingPromise = new Promise(async (r, a) => {
+      this.root = null;
+      try {
+        const n = await navigator.storage.getDirectory();
+        e === "/" ? this.root = n : this.root = await this.getDirectoryHandle(e, !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(e, r) {
+    this.watchCallback = e, 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(e, r = !1, a = this.root) {
+    if (!a)
+      throw new D();
+    const n = Array.isArray(e) ? e : m(e);
+    let i = a;
+    for (const o of n)
+      i = await i.getDirectoryHandle(o, { create: r });
+    return i;
+  }
+  /**
+   * 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(e, r = !1, a = this.root) {
+    if (!a)
+      throw new D();
+    const n = m(e);
+    if (n.length === 0)
+      throw new k("Path must not be empty", Array.isArray(e) ? e.join("/") : e);
+    const i = n.pop();
+    return (await this.getDirectoryHandle(n, r, a)).getFileHandle(i, { 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(e) {
+    const r = /* @__PURE__ */ new Map(), a = async (n) => {
+      const i = await this.readdir(n, { withFileTypes: !0 });
+      for (const o of i) {
+        const s = \`\${n === "/" ? "" : n}/\${o.name}\`;
+        try {
+          const l = await this.stat(s, e);
+          r.set(s, l), l.isDirectory && await a(s);
+        } catch (l) {
+          console.warn(\`Skipping broken entry: \${s}\`, 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(e, r = "utf-8") {
+    await this.ensureMounted();
+    try {
+      const a = await this.getFileHandle(e, !1), n = await ue(a);
+      return r === "binary" ? n : re(n, r);
+    } catch (a) {
+      throw console.error(a), new b(e);
+    }
+  }
+  /**
+   * 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(e, r, a) {
+    await this.ensureMounted();
+    const n = await this.getFileHandle(e, !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(e, r, a) {
+    await this.ensureMounted();
+    const n = await this.getFileHandle(e, !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(e, r) {
+    if (await this.ensureMounted(), !this.root)
+      throw new D();
+    const a = r?.recursive ?? !1, n = m(e);
+    let i = this.root;
+    for (let o = 0; o < n.length; o++) {
+      const s = n[o];
+      try {
+        i = await i.getDirectoryHandle(s, { create: a || o === n.length - 1 });
+      } catch (l) {
+        throw l.name === "NotFoundError" ? new c(
+          \`Parent directory does not exist: \${v(n.slice(0, o + 1))}\`,
+          "ENOENT"
+        ) : l.name === "TypeMismatchError" ? new c(\`Path segment is not a directory: \${s}\`, "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(e, r) {
+    if (await this.ensureMounted(), e === "/")
+      return {
+        kind: "directory",
+        size: 0,
+        mtime: (/* @__PURE__ */ new Date(0)).toISOString(),
+        ctime: (/* @__PURE__ */ new Date(0)).toISOString(),
+        isFile: !1,
+        isDirectory: !0
+      };
+    const a = I(e), n = await this.getDirectoryHandle(P(e), !1), i = 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 (i)
+        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 \${e}:\`, f);
+        }
+      return u;
+    } catch (s) {
+      if (s.name !== "TypeMismatchError" && s.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 (s) {
+      throw s.name === "NotFoundError" ? new c(\`No such file or directory: \${e}\`, "ENOENT") : new c("Failed to stat (directory)", "STAT_FAILED");
+    }
+  }
+  async readdir(e, r) {
+    await this.ensureMounted();
+    const a = r?.withFileTypes ?? !1, n = await this.getDirectoryHandle(e, !1);
+    if (a) {
+      const i = [];
+      for await (const [o, s] of n.entries()) {
+        const l = s.kind === "file";
+        i.push({
+          name: o,
+          kind: s.kind,
+          isFile: l,
+          isDirectory: !l
+        });
+      }
+      return i;
+    } else {
+      const i = [];
+      for await (const [o] of n.entries())
+        i.push(o);
+      return i;
+    }
+  }
+  /**
+   * 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(e) {
+    if (await this.ensureMounted(), e === "/")
+      return !0;
+    const r = I(e);
+    let a = null;
+    try {
+      a = await this.getDirectoryHandle(P(e), !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(e = "/") {
+    await this.ensureMounted();
+    try {
+      const r = await this.readdir(e, { withFileTypes: !0 });
+      for (const a of r) {
+        const n = \`\${e === "/" ? "" : e}/\${a.name}\`;
+        await this.remove(n, { recursive: !0 });
+      }
+    } catch (r) {
+      throw r instanceof c ? r : new c(\`Failed to clear directory: \${e}\`, "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(e, r) {
+    await this.ensureMounted();
+    const a = r?.recursive ?? !1, n = r?.force ?? !1;
+    if (e === "/")
+      throw new c("Cannot remove root directory", "EROOT");
+    const i = I(e);
+    if (!i)
+      throw new k("Invalid path", e);
+    const o = await this.getDirectoryHandle(P(e), !1);
+    try {
+      await o.removeEntry(i, { recursive: a });
+    } catch (s) {
+      if (s.name === "NotFoundError") {
+        if (!n)
+          throw new c(\`No such file or directory: \${e}\`, "ENOENT");
+      } else throw s.name === "InvalidModificationError" ? new c(\`Directory not empty: \${e}. Use recursive option to force removal.\`, "ENOTEMPTY") : s.name === "TypeMismatchError" && !a ? new c(\`Cannot remove directory without recursive option: \${e}\`, "EISDIR") : new c(\`Failed to remove path: \${e}\`, "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(e) {
+    await this.ensureMounted();
+    try {
+      const r = ce(e);
+      if (!await this.exists(r))
+        throw new b(r);
+      return r;
+    } catch (r) {
+      throw r instanceof c ? r : new c(\`Failed to resolve path: \${e}\`, "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(e, r) {
+    await this.ensureMounted();
+    try {
+      if (!await this.exists(e))
+        throw new b(e);
+      await this.copy(e, r, { recursive: !0 }), await this.remove(e, { recursive: !0 });
+    } catch (a) {
+      throw a instanceof c ? a : new c(\`Failed to rename from \${e} 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(e, r, a) {
+    await this.ensureMounted();
+    try {
+      const n = a?.recursive ?? !1, i = a?.force ?? !0;
+      if (!await this.exists(e))
+        throw new c(\`Source does not exist: \${e}\`, "ENOENT");
+      if (await this.exists(r) && !i)
+        throw new c(\`Destination already exists: \${r}\`, "EEXIST");
+      if ((await this.stat(e)).isFile) {
+        const u = await this.readFile(e, "binary");
+        await this.writeFile(r, u);
+      } else {
+        if (!n)
+          throw new c(\`Cannot copy directory without recursive option: \${e}\`, "EISDIR");
+        await this.mkdir(r, { recursive: !0 });
+        const u = await this.readdir(e, { withFileTypes: !0 });
+        for (const f of u) {
+          const w = \`\${e}/\${f.name}\`, h = \`\${r}/\${f.name}\`;
+          await this.copy(w, h, { recursive: !0, force: i });
+        }
+      }
+    } catch (n) {
+      throw n instanceof c ? n : new c(\`Failed to copy from \${e} to \${r}\`, "CP_FAILED");
+    }
+  }
+  /**
+   * Start watching a file or directory for changes
+   */
+  async watch(e) {
+    await this.ensureMounted();
+    const r = M(e), 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(e) {
+    const r = M(e);
+    this.watchers.delete(r), this.watchers.size === 0 && this.watchTimer && (clearInterval(this.watchTimer), this.watchTimer = null);
+  }
+  async buildSnapshot(e) {
+    const r = /* @__PURE__ */ new Map(), a = async (n) => {
+      const i = await this.stat(n);
+      if (r.set(n, i), i.isDirectory) {
+        const o = await this.readdir(n, { withFileTypes: !0 });
+        for (const s of o) {
+          const l = \`\${n === "/" ? "" : n}/\${s.name}\`;
+          await a(l);
+        }
+      }
+    };
+    return await a(e), r;
+  }
+  async scanWatches() {
+    if (!this.scanning) {
+      this.scanning = !0;
+      try {
+        await Promise.all(
+          [...this.watchers.entries()].map(async ([e, r]) => {
+            let a;
+            try {
+              a = await this.buildSnapshot(e);
+            } catch {
+              a = /* @__PURE__ */ new Map();
+            }
+            const n = [];
+            for (const [i, o] of a) {
+              const s = r.get(i);
+              s ? (s.mtime !== o.mtime || s.size !== o.size) && n.push({ path: i, type: "change" }) : n.push({ path: i, type: "create" });
+            }
+            for (const i of r.keys())
+              a.has(i) || n.push({ path: i, type: "delete" });
+            if (n.length && this.watchCallback)
+              for (const i of n)
+                this.watchCallback(i);
+            this.watchers.set(e, 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(e, r) {
+    await this.ensureMounted();
+    try {
+      (r?.cleanBefore ?? !1) && await this.clear("/");
+      for (const [n, i] of e) {
+        const o = M(n);
+        let s;
+        i instanceof Blob ? s = await he(i) : s = i, await this.writeFile(o, s);
+      }
+    } catch (a) {
+      throw a instanceof c ? a : new c("Failed to sync file system", "SYNC_FAILED");
+    }
+  }
+}
+typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && x(new we());
+//# sourceMappingURL=worker-CRHhlrlS.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,
+  R as resolvePath,
+  U as splitPath,
+  C as writeFileData
+};
+//# sourceMappingURL=index.js.map