opfs-worker 0.2.6 → 0.3.1

package/dist/index.js

@@ -1,21 +1,21 @@
-import { wrap as i, proxy as o } from "comlink";
-import { D as d, F as p, O as u, b as y, a as w, P as m, c as g, S as v, T as F, e as S, k as E, d as b, l as P, h as x, o as T, f as A, m as O, g as D, j as _, n as I, i as C, r as k, s as U, w as R } from "./helpers-C0nyU6hv.js";
+import { wrap as i } from "comlink";
+import { D as d, F as f, O as p, b as u, a as y, P as m, c as w, S as g, T as v, e as b, k as E, d as S, l as F, h as P, o as x, f as D, m as T, g as C, j as A, n as O, i as _, r as I, s as U, w as R } from "./helpers-DxFcNkZe.js";
 const a = `/**
  * @license
  * Copyright 2019 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const H = Symbol("Comlink.proxy"), R = Symbol("Comlink.endpoint"), B = Symbol("Comlink.releaseProxy"), D = Symbol("Comlink.finalizer"), E = Symbol("Comlink.thrown"), $ = (e) => typeof e == "object" && e !== null || typeof e == "function", W = {
+const H = Symbol("Comlink.proxy"), R = Symbol("Comlink.endpoint"), B = Symbol("Comlink.releaseProxy"), C = 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 I(e, t), [r, [r]];
+    return x(e, t), [r, [r]];
   },
   deserialize(e) {
     return e.start(), Y(e);
   }
 }, j = {
-  canHandle: (e) => $(e) && E in e,
+  canHandle: (e) => $(e) && p in e,
   serialize({ value: e }) {
     let t;
     return e instanceof Error ? t = {
@@ -40,15 +40,15 @@ function V(e, t) {
       return !0;
   return !1;
 }
-function I(e, t = globalThis, r = ["*"]) {
-  t.addEventListener("message", function n(i) {
-    if (!i || !i.data)
+function x(e, t = globalThis, r = ["*"]) {
+  t.addEventListener("message", function i(n) {
+    if (!n || !n.data)
       return;
-    if (!V(r, i.origin)) {
-      console.warn(\`Invalid origin '\${i.origin}' for comlink proxy\`);
+    if (!V(r, n.origin)) {
+      console.warn(\`Invalid origin '\${n.origin}' for comlink proxy\`);
       return;
     }
-    const { id: a, type: s, path: o } = Object.assign({ path: [] }, i.data), l = (i.data.argumentList || []).map(y);
+    const { id: a, type: s, path: o } = Object.assign({ path: [] }, n.data), l = (n.data.argumentList || []).map(d);
     let h;
     try {
       const u = o.slice(0, -1).reduce((f, g) => f[g], e), w = o.reduce((f, g) => f[g], e);
@@ -57,7 +57,7 @@ function I(e, t = globalThis, r = ["*"]) {
           h = w;
           break;
         case "SET":
-          u[o.slice(-1)[0]] = y(i.data.value), h = !0;
+          u[o.slice(-1)[0]] = d(n.data.value), h = !0;
           break;
         case "APPLY":
           h = w.apply(u, l);
@@ -71,7 +71,7 @@ function I(e, t = globalThis, r = ["*"]) {
         case "ENDPOINT":
           {
             const { port1: f, port2: g } = new MessageChannel();
-            I(e, g), h = J(f, [f]);
+            x(e, g), h = J(f, [f]);
           }
           break;
         case "RELEASE":
@@ -81,15 +81,15 @@ function I(e, t = globalThis, r = ["*"]) {
           return;
       }
     } catch (u) {
-      h = { value: u, [E]: 0 };
+      h = { value: u, [p]: 0 };
     }
-    Promise.resolve(h).catch((u) => ({ value: u, [E]: 0 })).then((u) => {
+    Promise.resolve(h).catch((u) => ({ value: u, [p]: 0 })).then((u) => {
       const [w, f] = A(u);
-      t.postMessage(Object.assign(Object.assign({}, w), { id: a }), f), s === "RELEASE" && (t.removeEventListener("message", n), L(t), D in e && typeof e[D] == "function" && e[D]());
+      t.postMessage(Object.assign(Object.assign({}, w), { id: a }), f), s === "RELEASE" && (t.removeEventListener("message", i), L(t), C in e && typeof e[C] == "function" && e[C]());
     }).catch((u) => {
       const [w, f] = A({
         value: new TypeError("Unserializable return value"),
-        [E]: 0
+        [p]: 0
       });
       t.postMessage(Object.assign(Object.assign({}, w), { id: a }), f);
     });
@@ -103,8 +103,8 @@ function L(e) {
 }
 function Y(e, t) {
   const r = /* @__PURE__ */ new Map();
-  return e.addEventListener("message", function(i) {
-    const { data: a } = i;
+  return e.addEventListener("message", function(n) {
+    const { data: a } = n;
     if (!a || !a.id)
       return;
     const s = r.get(a.id);
@@ -116,81 +116,81 @@ function Y(e, t) {
       }
   }), M(e, r, [], t);
 }
-function p(e) {
+function E(e) {
   if (e)
     throw new Error("Proxy has been released and is not useable");
 }
 function U(e) {
-  return d(e, /* @__PURE__ */ new Map(), {
+  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 && U(e);
+const S = /* @__PURE__ */ new WeakMap(), D = "FinalizationRegistry" in globalThis && new FinalizationRegistry((e) => {
+  const t = (S.get(e) || 0) - 1;
+  S.set(e, t), t === 0 && U(e);
 });
 function X(e, t) {
-  const r = (F.get(t) || 0) + 1;
-  F.set(t, r), S && S.register(e, t, e);
+  const r = (S.get(t) || 0) + 1;
+  S.set(t, r), D && D.register(e, t, e);
 }
 function q(e) {
-  S && S.unregister(e);
+  D && D.unregister(e);
 }
-function M(e, t, r = [], n = function() {
+function M(e, t, r = [], i = function() {
 }) {
-  let i = !1;
-  const a = new Proxy(n, {
+  let n = !1;
+  const a = new Proxy(i, {
     get(s, o) {
-      if (p(i), o === B)
+      if (E(n), o === B)
         return () => {
-          q(a), U(e), t.clear(), i = !0;
+          q(a), U(e), t.clear(), n = !0;
         };
       if (o === "then") {
         if (r.length === 0)
           return { then: () => a };
-        const l = d(e, t, {
+        const l = y(e, t, {
           type: "GET",
           path: r.map((h) => h.toString())
-        }).then(y);
+        }).then(d);
         return l.then.bind(l);
       }
       return M(e, t, [...r, o]);
     },
     set(s, o, l) {
-      p(i);
+      E(n);
       const [h, u] = A(l);
-      return d(e, t, {
+      return y(e, t, {
         type: "SET",
         path: [...r, o].map((w) => w.toString()),
         value: h
-      }, u).then(y);
+      }, u).then(d);
     },
     apply(s, o, l) {
-      p(i);
+      E(n);
       const h = r[r.length - 1];
       if (h === R)
-        return d(e, t, {
+        return y(e, t, {
           type: "ENDPOINT"
-        }).then(y);
+        }).then(d);
       if (h === "bind")
         return M(e, t, r.slice(0, -1));
-      const [u, w] = N(l);
-      return d(e, t, {
+      const [u, w] = v(l);
+      return y(e, t, {
         type: "APPLY",
         path: r.map((f) => f.toString()),
         argumentList: u
-      }, w).then(y);
+      }, w).then(d);
     },
     construct(s, o) {
-      p(i);
-      const [l, h] = N(o);
-      return d(e, t, {
+      E(n);
+      const [l, h] = v(o);
+      return y(e, t, {
         type: "CONSTRUCT",
         path: r.map((u) => u.toString()),
         argumentList: l
-      }, h).then(y);
+      }, h).then(d);
     }
   });
   return X(a, e), a;
@@ -198,7 +198,7 @@ function M(e, t, r = [], n = function() {
 function K(e) {
   return Array.prototype.concat.apply([], e);
 }
-function N(e) {
+function v(e) {
   const t = e.map(A);
   return [t.map((r) => r[0]), K(t.map((r) => r[1]))];
 }
@@ -212,14 +212,14 @@ function Q(e) {
 function A(e) {
   for (const [t, r] of z)
     if (r.canHandle(e)) {
-      const [n, i] = r.serialize(e);
+      const [i, n] = r.serialize(e);
       return [
         {
           type: "HANDLER",
           name: t,
-          value: n
+          value: i
         },
-        i
+        n
       ];
     }
   return [
@@ -230,7 +230,7 @@ function A(e) {
     _.get(e) || []
   ];
 }
-function y(e) {
+function d(e) {
   switch (e.type) {
     case "HANDLER":
       return z.get(e.name).deserialize(e.value);
@@ -238,18 +238,18 @@ function y(e) {
       return e.value;
   }
 }
-function d(e, t, r, n) {
-  return new Promise((i) => {
+function y(e, t, r, i) {
+  return new Promise((n) => {
     const a = Z();
-    t.set(a, i), e.start && e.start(), e.postMessage(Object.assign({ id: a }, r), n);
+    t.set(a, n), e.start && e.start(), e.postMessage(Object.assign({ id: a }, r), i);
   });
 }
 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, n) {
-    super(t), this.code = r, this.path = n, this.name = "OPFSError";
+  constructor(t, r, i) {
+    super(t), this.code = r, this.path = i, this.name = "OPFSError";
   }
 }
 class tt extends c {
@@ -257,17 +257,17 @@ class tt extends c {
     super("OPFS is not supported in this browser", "OPFS_NOT_SUPPORTED");
   }
 }
-class T extends c {
+class b extends c {
   constructor() {
     super("OPFS is not mounted", "OPFS_NOT_MOUNTED");
   }
 }
-class k extends c {
+class N extends c {
   constructor(t, r) {
     super(t, "INVALID_PATH", r);
   }
 }
-class O extends c {
+class T extends c {
   constructor(t) {
     super(\`File not found: \${t}\`, "FILE_NOT_FOUND", t);
   }
@@ -323,8 +323,8 @@ function rt(e, t = "utf-8") {
 function nt(e) {
   const t = new Uint8Array(e.length * 2);
   for (let r = 0; r < e.length; r++) {
-    const n = e.charCodeAt(r);
-    t[r * 2] = n & 255, t[r * 2 + 1] = n >> 8;
+    const i = e.charCodeAt(r);
+    t[r * 2] = i & 255, t[r * 2 + 1] = i >> 8;
   }
   return t;
 }
@@ -350,33 +350,33 @@ function ot() {
     throw new tt();
 }
 function m(e) {
-  return Array.isArray(e) ? e : e.split("/").filter(Boolean);
+  return Array.isArray(e) ? e : (e.startsWith("~/") ? e.slice(2) : e).split("/").filter(Boolean);
 }
-function P(e) {
+function I(e) {
   return typeof e == "string" ? e ?? "/" : \`/\${e.join("/")}\`;
 }
-function b(e) {
+function O(e) {
   const t = m(e);
   return t[t.length - 1] || "";
 }
-function x(e) {
+function P(e) {
   const t = m(e);
-  return t.pop(), P(t);
+  return t.pop(), I(t);
 }
-function C(e) {
-  return !e || e === "/" ? "/" : e.startsWith("/") ? e : \`/\${e}\`;
+function F(e) {
+  return !e || e === "/" ? "/" : e.startsWith("~/") ? \`/\${e.slice(2)}\` : e.startsWith("/") ? e : \`/\${e}\`;
 }
 function ct(e) {
-  const t = m(e), r = [];
-  for (const n of t)
+  const t = F(e), r = m(t), i = [];
+  for (const n of r)
     if (!(n === "." || n === ""))
       if (n === "..") {
-        if (r.length === 0)
+        if (i.length === 0)
           continue;
-        r.pop();
+        i.pop();
       } else
-        r.push(n);
-  return P(r);
+        i.push(n);
+  return I(i);
 }
 function lt(e, t = "utf-8") {
   return typeof e == "string" ? et(e, t) : e instanceof Uint8Array ? e : new Uint8Array(e);
@@ -384,26 +384,26 @@ function lt(e, t = "utf-8") {
 async function ht(e) {
   const t = await e.createSyncAccessHandle();
   try {
-    const r = t.getSize(), n = new Uint8Array(r);
-    return t.read(n, { at: 0 }), n;
+    const r = t.getSize(), i = new Uint8Array(r);
+    return t.read(i, { at: 0 }), i;
   } finally {
     t.close();
   }
 }
-async function v(e, t, r, n = {}) {
-  let i = null;
+async function k(e, t, r, i = {}) {
+  let n = null;
   try {
-    i = await e.createSyncAccessHandle();
-    const a = lt(t, r), s = n.append ? i.getSize() : 0;
-    i.write(a, { at: s }), n.truncate && !n.append && i.truncate(a.byteLength), i.flush();
+    n = await e.createSyncAccessHandle();
+    const a = lt(t, r), s = i.append ? n.getSize() : 0;
+    n.write(a, { at: s }), i.truncate && !i.append && n.truncate(a.byteLength), n.flush();
   } catch (a) {
     console.error(a);
-    const s = n.append ? "append" : "write";
+    const s = i.append ? "append" : "write";
     throw new c(\`Failed to \${s} file\`, \`\${s.toUpperCase()}_FAILED\`);
   } finally {
-    if (i)
+    if (n)
       try {
-        i.close();
+        n.close();
       } catch {
       }
   }
@@ -411,8 +411,8 @@ async function v(e, t, r, n = {}) {
 async function ut(e, t = "SHA-1", r = 50 * 1024 * 1024) {
   if (e instanceof File && (e = await e.arrayBuffer()), e.byteLength > r)
     throw new Error(\`File size \${e.byteLength} bytes exceeds maximum allowed size \${r} bytes\`);
-  const n = new Uint8Array(e), i = await crypto.subtle.digest(t, n);
-  return Array.from(new Uint8Array(i)).map((s) => s.toString(16).padStart(2, "0")).join("");
+  const i = new Uint8Array(e), n = await crypto.subtle.digest(t, i);
+  return Array.from(new Uint8Array(n)).map((s) => s.toString(16).padStart(2, "0")).join("");
 }
 async function ft(e) {
   const t = await e.arrayBuffer();
@@ -421,8 +421,6 @@ async function ft(e) {
 class wt {
   /** 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 */
@@ -431,11 +429,14 @@ class wt {
   scanning = !1;
   /** Promise to prevent concurrent mount operations */
   mountingPromise = null;
+  /** BroadcastChannel instance for sending events */
+  broadcastChannel = null;
   /** Configuration options */
   options = {
     watchInterval: 1e3,
     maxFileSize: 50 * 1024 * 1024,
-    hashAlgorithm: null
+    hashAlgorithm: null,
+    broadcastChannel: "opfs-worker"
   };
   /**
    * Notify about internal changes to the file system
@@ -447,34 +448,39 @@ class wt {
    * @param type - The type of change (create, change, delete)
    */
   async notifyChange(t) {
-    if (!this.watchCallback)
+    if (!this.options.broadcastChannel)
       return;
     let r;
     if (this.options.hashAlgorithm && !t.isDirectory && t.type !== "removed")
       try {
-        const n = await this.stat(t.path);
-        n.isFile && n.hash && (r = n.hash);
-      } catch (n) {
-        console.warn(\`Failed to calculate hash for \${t.path}:\`, n);
+        const i = await this.stat(t.path);
+        i.isFile && i.hash && (r = i.hash);
+      } catch (i) {
+        console.warn(\`Failed to calculate hash for \${t.path}:\`, i);
       }
-    this.watchCallback({
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      ...t,
-      ...r && { hash: r }
-    });
+    try {
+      this.broadcastChannel || (this.broadcastChannel = new BroadcastChannel(this.options.broadcastChannel));
+      const i = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...t,
+        ...r && { hash: r }
+      };
+      this.broadcastChannel.postMessage(i);
+    } catch (i) {
+      console.warn("Failed to send event via BroadcastChannel:", i);
+    }
   }
   /**
    * Creates a new OPFSFileSystem instance
    * 
-   * @param watchCallback - Optional callback for file change events
    * @param options - Optional configuration options
    * @param options.watchInterval - Polling interval in milliseconds for file watching
    * @param options.hashAlgorithm - Hash algorithm for file hashing
    * @param options.maxFileSize - Maximum file size for hashing in bytes (default: 50MB)
    * @throws {OPFSError} If OPFS is not supported in the current browser
    */
-  constructor(t, r) {
-    ot(), t && (this.watchCallback = t), r && this.setOptions(r), this.mount("/");
+  constructor(t) {
+    ot(), t && this.setOptions(t), this.mount("/");
   }
   /**
    * Initialize the file system within a given directory
@@ -498,26 +504,18 @@ class wt {
    * \`\`\`
    */
   async mount(t = "/") {
-    return this.mountingPromise && await this.mountingPromise, this.mountingPromise = new Promise(async (r, n) => {
+    return this.mountingPromise && await this.mountingPromise, this.mountingPromise = new Promise(async (r, i) => {
       this.root = null;
       try {
-        const i = await navigator.storage.getDirectory();
-        t === "/" ? this.root = i : this.root = await this.getDirectoryHandle(t, !0, i), r(!0);
-      } catch (i) {
-        console.error(i), n(new c("Failed to initialize OPFS", "INIT_FAILED"));
+        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), i(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
-   */
-  setWatchCallback(t) {
-    this.watchCallback = t;
-  }
   /**
    * Update configuration options
    * 
@@ -525,9 +523,10 @@ class wt {
    * @param options.watchInterval - Polling interval in milliseconds for file watching
    * @param options.hashAlgorithm - Hash algorithm for file hashing
    * @param options.maxFileSize - Maximum file size for hashing in bytes
+   * @param options.broadcastChannel - Custom name for the broadcast channel
    */
   setOptions(t) {
-    t.watchInterval !== void 0 && (this.options.watchInterval = t.watchInterval), t.hashAlgorithm !== void 0 && (this.options.hashAlgorithm = t.hashAlgorithm), t.maxFileSize !== void 0 && (this.options.maxFileSize = t.maxFileSize);
+    t.watchInterval !== void 0 && (this.options.watchInterval = t.watchInterval), t.hashAlgorithm !== void 0 && (this.options.hashAlgorithm = t.hashAlgorithm), t.maxFileSize !== void 0 && (this.options.maxFileSize = t.maxFileSize), t.broadcastChannel !== void 0 && (this.broadcastChannel && this.options.broadcastChannel !== t.broadcastChannel && (this.broadcastChannel.close(), this.broadcastChannel = null), this.options.broadcastChannel = t.broadcastChannel);
   }
   /**
    * Automatically mount the OPFS root if not already mounted
@@ -565,12 +564,12 @@ class wt {
    * const docsDir2 = await fs.getDirectoryHandle(['users', 'john', 'documents'], true);
    * \`\`\`
    */
-  async getDirectoryHandle(t, r = !1, n = this.root) {
-    if (!n)
-      throw new T();
-    const i = Array.isArray(t) ? t : m(t);
-    let a = n;
-    for (const s of i)
+  async getDirectoryHandle(t, r = !1, i = this.root) {
+    if (!i)
+      throw new b();
+    const n = Array.isArray(t) ? t : m(t);
+    let a = i;
+    for (const s of n)
       a = await a.getDirectoryHandle(s, { create: r });
     return a;
   }
@@ -593,14 +592,14 @@ class wt {
    * const fileHandle2 = await fs.getFileHandle(['config', 'settings.json'], true);
    * \`\`\`
    */
-  async getFileHandle(t, r = !1, n = this.root) {
-    if (!n)
-      throw new T();
-    const i = m(t);
-    if (i.length === 0)
-      throw new k("Path must not be empty", Array.isArray(t) ? t.join("/") : t);
-    const a = i.pop();
-    return (await this.getDirectoryHandle(i, r, n)).getFileHandle(a, { create: r });
+  async getFileHandle(t, r = !1, i = this.root) {
+    if (!i)
+      throw new b();
+    const n = m(t);
+    if (n.length === 0)
+      throw new N("Path must not be empty", Array.isArray(t) ? t.join("/") : t);
+    const a = n.pop();
+    return (await this.getDirectoryHandle(n, r, i)).getFileHandle(a, { create: r });
   }
   /**
    * Get a complete index of all files and directories in the file system
@@ -622,10 +621,10 @@ class wt {
    * \`\`\`
    */
   async index() {
-    const t = /* @__PURE__ */ new Map(), r = async (n) => {
-      const i = await this.readdir(n, { withFileTypes: !0 });
-      for (const a of i) {
-        const s = \`\${n === "/" ? "" : n}/\${a.name}\`;
+    const t = /* @__PURE__ */ new Map(), r = async (i) => {
+      const n = await this.readDir(i);
+      for (const a of n) {
+        const s = \`\${i === "/" ? "" : i}/\${a.name}\`;
         try {
           const o = await this.stat(s);
           t.set(s, o), o.isDirectory && await r(s);
@@ -646,10 +645,10 @@ class wt {
   async readFile(t, r = "utf-8") {
     await this.ensureMounted();
     try {
-      const n = await this.getFileHandle(t, !1), i = await ht(n);
-      return r === "binary" ? i : rt(i, r);
-    } catch (n) {
-      throw console.error(n), new O(t);
+      const i = await this.getFileHandle(t, !1), n = await ht(i);
+      return r === "binary" ? n : rt(n, r);
+    } catch (i) {
+      throw console.error(i), new T(t);
     }
   }
   /**
@@ -677,10 +676,10 @@ class wt {
    * await fs.writeFile('/data/utf16.txt', 'Hello World', 'utf-16le');
    * \`\`\`
    */
-  async writeFile(t, r, n) {
+  async writeFile(t, r, i) {
     await this.ensureMounted();
-    const i = await this.getFileHandle(t, !0);
-    await v(i, r, n, { truncate: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
+    const n = await this.getFileHandle(t, !0);
+    await k(n, r, i, { truncate: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
   }
   /**
    * Append data to a file
@@ -704,10 +703,10 @@ class wt {
    * await fs.appendFile('/data/binary.dat', additionalData);
    * \`\`\`
    */
-  async appendFile(t, r, n) {
+  async appendFile(t, r, i) {
     await this.ensureMounted();
-    const i = await this.getFileHandle(t, !0);
-    await v(i, r, n, { append: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
+    const n = await this.getFileHandle(t, !0);
+    await k(n, r, i, { append: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
   }
   /**
    * Create a directory
@@ -732,16 +731,16 @@ class wt {
    */
   async mkdir(t, r) {
     if (await this.ensureMounted(), !this.root)
-      throw new T();
-    const n = r?.recursive ?? !1, i = m(t);
+      throw new b();
+    const i = r?.recursive ?? !1, n = m(t);
     let a = this.root;
-    for (let s = 0; s < i.length; s++) {
-      const o = i[s];
+    for (let s = 0; s < n.length; s++) {
+      const o = n[s];
       try {
-        a = await a.getDirectoryHandle(o, { create: n || s === i.length - 1 });
+        a = await a.getDirectoryHandle(o, { create: i || s === n.length - 1 });
       } catch (l) {
         throw l.name === "NotFoundError" ? new c(
-          \`Parent directory does not exist: \${P(i.slice(0, s + 1))}\`,
+          \`Parent directory does not exist: \${I(n.slice(0, s + 1))}\`,
           "ENOENT"
         ) : l.name === "TypeMismatchError" ? new c(\`Path segment is not a directory: \${o}\`, "ENOTDIR") : new c("Failed to create directory", "MKDIR_FAILED");
       }
@@ -780,9 +779,9 @@ class wt {
         isFile: !1,
         isDirectory: !0
       };
-    const r = b(t), n = await this.getDirectoryHandle(x(t), !1), i = this.options.hashAlgorithm !== null;
+    const r = O(t), i = await this.getDirectoryHandle(P(t), !1), n = this.options.hashAlgorithm !== null;
     try {
-      const s = await (await n.getFileHandle(r, { create: !1 })).getFile(), o = {
+      const s = await (await i.getFileHandle(r, { create: !1 })).getFile(), o = {
         kind: "file",
         size: s.size,
         mtime: new Date(s.lastModified).toISOString(),
@@ -790,7 +789,7 @@ class wt {
         isFile: !0,
         isDirectory: !1
       };
-      if (i && this.options.hashAlgorithm)
+      if (n && this.options.hashAlgorithm)
         try {
           const l = await ut(s, this.options.hashAlgorithm, this.options.maxFileSize);
           o.hash = l;
@@ -803,7 +802,7 @@ class wt {
         throw new c("Failed to stat (file)", "STAT_FAILED");
     }
     try {
-      return await n.getDirectoryHandle(r, { create: !1 }), {
+      return await i.getDirectoryHandle(r, { create: !1 }), {
         kind: "directory",
         size: 0,
         mtime: (/* @__PURE__ */ new Date(0)).toISOString(),
@@ -815,27 +814,37 @@ class wt {
       throw a.name === "NotFoundError" ? new c(\`No such file or directory: \${t}\`, "ENOENT") : new c("Failed to stat (directory)", "STAT_FAILED");
     }
   }
-  async readdir(t, r) {
+  /**
+   * Read a directory's contents
+   * 
+   * Lists all files and subdirectories within the specified directory.
+   * 
+   * @param path - The path to the directory to read
+   * @returns Promise that resolves to an array of detailed file/directory information
+   * @throws {OPFSError} If the directory does not exist or cannot be accessed
+   * 
+   * @example
+   * \`\`\`typescript
+   * // Get detailed information about files and directories
+   * const detailed = await fs.readDir('/users/john/documents');
+   * detailed.forEach(item => {
+   *   console.log(\`\${item.name} - \${item.isFile ? 'file' : 'directory'}\`);
+   * });
+   * \`\`\`
+   */
+  async readDir(t) {
     await this.ensureMounted();
-    const n = r?.withFileTypes ?? !1, i = await this.getDirectoryHandle(t, !1);
-    if (n) {
-      const a = [];
-      for await (const [s, o] of i.entries()) {
-        const l = o.kind === "file";
-        a.push({
-          name: s,
-          kind: o.kind,
-          isFile: l,
-          isDirectory: !l
-        });
-      }
-      return a;
-    } else {
-      const a = [];
-      for await (const [s] of i.entries())
-        a.push(s);
-      return a;
+    const r = await this.getDirectoryHandle(t, !1), i = [];
+    for await (const [n, a] of r.entries()) {
+      const s = a.kind === "file";
+      i.push({
+        name: n,
+        kind: a.kind,
+        isFile: s,
+        isDirectory: !s
+      });
     }
+    return i;
   }
   /**
    * Check if a file or directory exists
@@ -854,26 +863,26 @@ class wt {
   async exists(t) {
     if (await this.ensureMounted(), t === "/")
       return !0;
-    const r = b(t);
-    let n = null;
+    const r = O(t);
+    let i = null;
     try {
-      n = await this.getDirectoryHandle(x(t), !1);
-    } catch (i) {
-      throw (i.name === "NotFoundError" || i.name === "TypeMismatchError") && (n = null), i;
+      i = await this.getDirectoryHandle(P(t), !1);
+    } catch (n) {
+      throw (n.name === "NotFoundError" || n.name === "TypeMismatchError") && (i = null), n;
     }
-    if (!n || !r)
+    if (!i || !r)
       return !1;
     try {
-      return await n.getFileHandle(r, { create: !1 }), !0;
-    } catch (i) {
-      if (i.name !== "NotFoundError" && i.name !== "TypeMismatchError")
-        throw i;
+      return await i.getFileHandle(r, { create: !1 }), !0;
+    } catch (n) {
+      if (n.name !== "NotFoundError" && n.name !== "TypeMismatchError")
+        throw n;
     }
     try {
-      return await n.getDirectoryHandle(r, { create: !1 }), !0;
-    } catch (i) {
-      if (i.name !== "NotFoundError" && i.name !== "TypeMismatchError")
-        throw i;
+      return await i.getDirectoryHandle(r, { create: !1 }), !0;
+    } catch (n) {
+      if (n.name !== "NotFoundError" && n.name !== "TypeMismatchError")
+        throw n;
     }
     return !1;
   }
@@ -899,10 +908,10 @@ class wt {
   async clear(t = "/") {
     await this.ensureMounted();
     try {
-      const r = await this.readdir(t, { withFileTypes: !0 });
-      for (const n of r) {
-        const i = \`\${t === "/" ? "" : t}/\${n.name}\`;
-        await this.remove(i, { recursive: !0 });
+      const r = await this.readDir(t);
+      for (const i of r) {
+        const n = \`\${t === "/" ? "" : t}/\${i.name}\`;
+        await this.remove(n, { recursive: !0 });
       }
       await this.notifyChange({ path: t, type: "changed", isDirectory: !0 });
     } catch (r) {
@@ -935,20 +944,20 @@ class wt {
    */
   async remove(t, r) {
     await this.ensureMounted();
-    const n = r?.recursive ?? !1, i = r?.force ?? !1;
+    const i = r?.recursive ?? !1, n = r?.force ?? !1;
     if (t === "/")
       throw new c("Cannot remove root directory", "EROOT");
-    const a = b(t);
+    const a = O(t);
     if (!a)
-      throw new k("Invalid path", t);
-    const s = await this.getDirectoryHandle(x(t), !1);
+      throw new N("Invalid path", t);
+    const s = await this.getDirectoryHandle(P(t), !1);
     try {
-      await s.removeEntry(a, { recursive: n });
+      await s.removeEntry(a, { recursive: i });
     } catch (o) {
       if (o.name === "NotFoundError") {
-        if (!i)
+        if (!n)
           throw new c(\`No such file or directory: \${t}\`, "ENOENT");
-      } else throw o.name === "InvalidModificationError" ? new c(\`Directory not empty: \${t}. Use recursive option to force removal.\`, "ENOTEMPTY") : o.name === "TypeMismatchError" && !n ? new c(\`Cannot remove directory without recursive option: \${t}\`, "EISDIR") : new c(\`Failed to remove path: \${t}\`, "RM_FAILED");
+      } else throw o.name === "InvalidModificationError" ? new c(\`Directory not empty: \${t}. Use recursive option to force removal.\`, "ENOTEMPTY") : o.name === "TypeMismatchError" && !i ? new c(\`Cannot remove directory without recursive option: \${t}\`, "EISDIR") : new c(\`Failed to remove path: \${t}\`, "RM_FAILED");
     }
     await this.notifyChange({ path: t, type: "removed", isDirectory: !1 });
   }
@@ -975,7 +984,7 @@ class wt {
     try {
       const r = ct(t);
       if (!await this.exists(r))
-        throw new O(r);
+        throw new T(r);
       return r;
     } catch (r) {
       throw r instanceof c ? r : new c(\`Failed to resolve path: \${t}\`, "REALPATH_FAILED");
@@ -1001,10 +1010,10 @@ class wt {
     await this.ensureMounted();
     try {
       if (!await this.exists(t))
-        throw new O(t);
+        throw new T(t);
       await this.copy(t, r, { recursive: !0 }), await this.remove(t, { recursive: !0 }), await this.notifyChange({ path: t, type: "removed", isDirectory: !1 }), await this.notifyChange({ path: r, type: "added", isDirectory: !1 });
-    } catch (n) {
-      throw n instanceof c ? n : new c(\`Failed to rename from \${t} to \${r}\`, "RENAME_FAILED");
+    } catch (i) {
+      throw i instanceof c ? i : new c(\`Failed to rename from \${t} to \${r}\`, "RENAME_FAILED");
     }
   }
   /**
@@ -1032,10 +1041,10 @@ class wt {
    * await fs.copy('/source', '/dest', { recursive: true, force: false });
    * \`\`\`
    */
-  async copy(t, r, n) {
+  async copy(t, r, i) {
     await this.ensureMounted();
     try {
-      const i = n?.recursive ?? !1, a = n?.force ?? !0;
+      const n = i?.recursive ?? !1, a = i?.force ?? !0;
       if (!await this.exists(t))
         throw new c(\`Source does not exist: \${t}\`, "ENOENT");
       if (await this.exists(r) && !a)
@@ -1044,18 +1053,18 @@ class wt {
         const h = await this.readFile(t, "binary");
         await this.writeFile(r, h);
       } else {
-        if (!i)
+        if (!n)
           throw new c(\`Cannot copy directory without recursive option: \${t}\`, "EISDIR");
         await this.mkdir(r, { recursive: !0 });
-        const h = await this.readdir(t, { withFileTypes: !0 });
+        const h = await this.readDir(t);
         for (const u of h) {
           const w = \`\${t}/\${u.name}\`, f = \`\${r}/\${u.name}\`;
           await this.copy(w, f, { recursive: !0, force: a });
         }
       }
       await this.notifyChange({ path: r, type: "added", isDirectory: !1 });
-    } catch (i) {
-      throw i instanceof c ? i : new c(\`Failed to copy from \${t} to \${r}\`, "CP_FAILED");
+    } catch (n) {
+      throw n instanceof c ? n : new c(\`Failed to copy from \${t} to \${r}\`, "CP_FAILED");
     }
   }
   /**
@@ -1063,8 +1072,8 @@ class wt {
    */
   async watch(t) {
     await this.ensureMounted();
-    const r = C(t), n = await this.buildSnapshot(r);
-    this.watchers.set(r, n), this.watchTimer || (this.watchTimer = setInterval(() => {
+    const r = F(t), i = await this.buildSnapshot(r);
+    this.watchers.set(r, i), this.watchTimer || (this.watchTimer = setInterval(() => {
       this.scanWatches();
     }, this.options.watchInterval));
   }
@@ -1072,21 +1081,30 @@ class wt {
    * Stop watching a previously watched path
    */
   unwatch(t) {
-    const r = C(t);
+    const r = F(t);
     this.watchers.delete(r), this.watchers.size === 0 && this.watchTimer && (clearInterval(this.watchTimer), this.watchTimer = null);
   }
+  /**
+   * Dispose of resources and clean up the file system instance
+   * 
+   * This method should be called when the file system instance is no longer needed
+   * to properly clean up resources like the broadcast channel and watch timers.
+   */
+  dispose() {
+    this.broadcastChannel && (this.broadcastChannel.close(), this.broadcastChannel = null), this.watchTimer && (clearInterval(this.watchTimer), this.watchTimer = null), this.watchers.clear();
+  }
   async buildSnapshot(t) {
-    const r = /* @__PURE__ */ new Map(), n = async (i) => {
-      const a = await this.stat(i);
-      if (r.set(i, a), a.isDirectory) {
-        const s = await this.readdir(i, { withFileTypes: !0 });
+    const r = /* @__PURE__ */ new Map(), i = async (n) => {
+      const a = await this.stat(n);
+      if (r.set(n, a), a.isDirectory) {
+        const s = await this.readDir(n);
         for (const o of s) {
-          const l = \`\${i === "/" ? "" : i}/\${o.name}\`;
-          await n(l);
+          const l = \`\${n === "/" ? "" : n}/\${o.name}\`;
+          await i(l);
         }
       }
     };
-    return await n(t), r;
+    return await i(t), r;
   }
   async scanWatches() {
     if (!this.scanning) {
@@ -1094,19 +1112,22 @@ class wt {
       try {
         await Promise.all(
           [...this.watchers.entries()].map(async ([t, r]) => {
-            let n;
+            let i;
             try {
-              n = await this.buildSnapshot(t);
+              i = await this.buildSnapshot(t);
             } catch {
-              n = /* @__PURE__ */ new Map();
+              i = /* @__PURE__ */ new Map();
             }
-            for (const [i, a] of n) {
-              const s = r.get(i);
-              s ? (s.mtime !== a.mtime || s.size !== a.size) && await this.notifyChange({ path: i, type: "changed", isDirectory: !1 }) : await this.notifyChange({ path: i, type: "added", isDirectory: !1 });
+            for (const [n, a] of i) {
+              const s = r.get(n);
+              s ? (s.mtime !== a.mtime || s.size !== a.size) && await this.notifyChange({ path: n, type: "changed", isDirectory: a.isDirectory }) : await this.notifyChange({ path: n, type: "added", isDirectory: a.isDirectory });
             }
-            for (const i of r.keys())
-              n.has(i) || await this.notifyChange({ path: i, type: "removed", isDirectory: !1 });
-            this.watchers.set(t, n);
+            for (const n of r.keys())
+              if (!i.has(n)) {
+                const a = r.get(n);
+                await this.notifyChange({ path: n, type: "removed", isDirectory: a?.isDirectory ?? !1 });
+              }
+            this.watchers.set(t, i);
           })
         );
       } finally {
@@ -1146,72 +1167,69 @@ class wt {
     await this.ensureMounted();
     try {
       (r?.cleanBefore ?? !1) && await this.clear("/");
-      for (const [i, a] of t) {
-        const s = C(i);
+      for (const [n, a] of t) {
+        const s = F(n);
         let o;
         a instanceof Blob ? o = await ft(a) : o = a, await this.writeFile(s, o);
       }
       await this.notifyChange({ path: "/", type: "changed", isDirectory: !0 });
-    } catch (n) {
-      throw n instanceof c ? n : new c("Failed to sync file system", "SYNC_FAILED");
+    } catch (i) {
+      throw i instanceof c ? i : new c("Failed to sync file system", "SYNC_FAILED");
     }
   }
 }
-typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && I(new wt());
-//# sourceMappingURL=worker-CHy3JxL1.js.map
+typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && x(new wt());
+//# sourceMappingURL=worker-DilNsKoO.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) {
+function o(t) {
   let n;
   try {
     if (n = r && (self.URL || self.webkitURL).createObjectURL(r), !n) throw "";
-    const t = new Worker(n, {
+    const e = new Worker(n, {
       type: "module",
-      name: e?.name
+      name: t?.name
     });
-    return t.addEventListener("error", () => {
+    return e.addEventListener("error", () => {
       (self.URL || self.webkitURL).revokeObjectURL(n);
-    }), t;
+    }), e;
   } catch {
     return new Worker(
       "data:text/javascript;charset=utf-8," + encodeURIComponent(a),
       {
         type: "module",
-        name: e?.name
+        name: t?.name
       }
     );
   }
 }
-function h(e, n) {
-  const t = i(new s());
-  return e && t.setWatchCallback(
-    e ? o(e) : () => {
-    }
-  ), n && t.setOptions(n), t;
+function c(t) {
+  const n = i(new o());
+  return t && n.setOptions(t), n;
 }
 export {
   d as DirectoryNotFoundError,
-  p as FileNotFoundError,
-  u as OPFSError,
-  y as OPFSNotMountedError,
-  w as OPFSNotSupportedError,
+  f as FileNotFoundError,
+  p as OPFSError,
+  u as OPFSNotMountedError,
+  y as OPFSNotSupportedError,
   m as PathError,
-  g as PermissionError,
-  v as StorageError,
-  F as TimeoutError,
-  S as basename,
+  w as PermissionError,
+  g as StorageError,
+  v as TimeoutError,
+  b as basename,
   E as calculateFileHash,
-  b as checkOPFSSupport,
-  P as convertBlobToUint8Array,
-  x as createBuffer,
-  h as createWorker,
-  T as decodeBuffer,
-  A as dirname,
-  O as encodeString,
-  D as extname,
-  _ as joinPath,
-  I as normalizePath,
-  C as readFileData,
-  k as resolvePath,
+  S as checkOPFSSupport,
+  F as convertBlobToUint8Array,
+  P as createBuffer,
+  c as createWorker,
+  x as decodeBuffer,
+  D as dirname,
+  T as encodeString,
+  C as extname,
+  A as joinPath,
+  O as normalizePath,
+  _ as readFileData,
+  I as resolvePath,
   U as splitPath,
   R as writeFileData
 };