opfs-worker 0.2.6 → 0.3.1

package/dist/index.cjs

@@ -1,19 +1,19 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("comlink"),n=require("./helpers-FvdHLObV.cjs"),o=`/**
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("comlink"),n=require("./helpers-B87wz5kv.cjs"),i=`/**
  * @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 = {
@@ -38,15 +38,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);
@@ -55,7 +55,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);
@@ -69,7 +69,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":
@@ -79,15 +79,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);
     });
@@ -101,8 +101,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);
@@ -114,81 +114,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;
@@ -196,7 +196,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]))];
 }
@@ -210,14 +210,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 [
@@ -228,7 +228,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);
@@ -236,18 +236,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 {
@@ -255,17 +255,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);
   }
@@ -321,8 +321,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;
 }
@@ -348,33 +348,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);
@@ -382,26 +382,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 {
       }
   }
@@ -409,8 +409,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();
@@ -419,8 +419,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 */
@@ -429,11 +427,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
@@ -445,34 +446,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
@@ -496,26 +502,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
    * 
@@ -523,9 +521,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
@@ -563,12 +562,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;
   }
@@ -591,14 +590,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
@@ -620,10 +619,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);
@@ -644,10 +643,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);
     }
   }
   /**
@@ -675,10 +674,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
@@ -702,10 +701,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
@@ -730,16 +729,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");
       }
@@ -778,9 +777,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(),
@@ -788,7 +787,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;
@@ -801,7 +800,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(),
@@ -813,27 +812,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
@@ -852,26 +861,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;
   }
@@ -897,10 +906,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) {
@@ -933,20 +942,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 });
   }
@@ -973,7 +982,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");
@@ -999,10 +1008,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");
     }
   }
   /**
@@ -1030,10 +1039,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)
@@ -1042,18 +1051,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");
     }
   }
   /**
@@ -1061,8 +1070,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));
   }
@@ -1070,21 +1079,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) {
@@ -1092,19 +1110,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 {
@@ -1144,18 +1165,18 @@ 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
-`,i=typeof self<"u"&&self.Blob&&new Blob(["URL.revokeObjectURL(import.meta.url);",o],{type:"text/javascript;charset=utf-8"});function s(r){let t;try{if(t=i&&(self.URL||self.webkitURL).createObjectURL(i),!t)throw"";const e=new Worker(t,{type:"module",name:r?.name});return e.addEventListener("error",()=>{(self.URL||self.webkitURL).revokeObjectURL(t)}),e}catch{return new Worker("data:text/javascript;charset=utf-8,"+encodeURIComponent(o),{type:"module",name:r?.name})}}function c(r,t){const e=a.wrap(new s);return r&&e.setWatchCallback(r?a.proxy(r):()=>{}),t&&e.setOptions(t),e}exports.DirectoryNotFoundError=n.DirectoryNotFoundError;exports.FileNotFoundError=n.FileNotFoundError;exports.OPFSError=n.OPFSError;exports.OPFSNotMountedError=n.OPFSNotMountedError;exports.OPFSNotSupportedError=n.OPFSNotSupportedError;exports.PathError=n.PathError;exports.PermissionError=n.PermissionError;exports.StorageError=n.StorageError;exports.TimeoutError=n.TimeoutError;exports.basename=n.basename;exports.calculateFileHash=n.calculateFileHash;exports.checkOPFSSupport=n.checkOPFSSupport;exports.convertBlobToUint8Array=n.convertBlobToUint8Array;exports.createBuffer=n.createBuffer;exports.decodeBuffer=n.decodeBuffer;exports.dirname=n.dirname;exports.encodeString=n.encodeString;exports.extname=n.extname;exports.joinPath=n.joinPath;exports.normalizePath=n.normalizePath;exports.readFileData=n.readFileData;exports.resolvePath=n.resolvePath;exports.splitPath=n.splitPath;exports.writeFileData=n.writeFileData;exports.createWorker=c;
+typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && x(new wt());
+//# sourceMappingURL=worker-DilNsKoO.js.map
+`,a=typeof self<"u"&&self.Blob&&new Blob(["URL.revokeObjectURL(import.meta.url);",i],{type:"text/javascript;charset=utf-8"});function s(e){let t;try{if(t=a&&(self.URL||self.webkitURL).createObjectURL(a),!t)throw"";const r=new Worker(t,{type:"module",name:e?.name});return r.addEventListener("error",()=>{(self.URL||self.webkitURL).revokeObjectURL(t)}),r}catch{return new Worker("data:text/javascript;charset=utf-8,"+encodeURIComponent(i),{type:"module",name:e?.name})}}function c(e){const t=o.wrap(new s);return e&&t.setOptions(e),t}exports.DirectoryNotFoundError=n.DirectoryNotFoundError;exports.FileNotFoundError=n.FileNotFoundError;exports.OPFSError=n.OPFSError;exports.OPFSNotMountedError=n.OPFSNotMountedError;exports.OPFSNotSupportedError=n.OPFSNotSupportedError;exports.PathError=n.PathError;exports.PermissionError=n.PermissionError;exports.StorageError=n.StorageError;exports.TimeoutError=n.TimeoutError;exports.basename=n.basename;exports.calculateFileHash=n.calculateFileHash;exports.checkOPFSSupport=n.checkOPFSSupport;exports.convertBlobToUint8Array=n.convertBlobToUint8Array;exports.createBuffer=n.createBuffer;exports.decodeBuffer=n.decodeBuffer;exports.dirname=n.dirname;exports.encodeString=n.encodeString;exports.extname=n.extname;exports.joinPath=n.joinPath;exports.normalizePath=n.normalizePath;exports.readFileData=n.readFileData;exports.resolvePath=n.resolvePath;exports.splitPath=n.splitPath;exports.writeFileData=n.writeFileData;exports.createWorker=c;
 //# sourceMappingURL=index.cjs.map