opfs-worker 0.2.6 → 0.3.1

package/dist/raw.js

@@ -1,10 +1,8 @@
-import { expose as E } from "comlink";
-import { d as S, O as n, b as l, s as w, P as g, i as v, o as I, F as f, w as F, j as T, e as y, f as u, k as M, r as A, n as d, l as $ } from "./helpers-C0nyU6hv.js";
-class O {
+import { expose as p } from "comlink";
+import { d as S, O as n, b as l, s as w, P as g, i as v, o as I, F as f, w as D, j as C, e as d, f as y, k as M, r as T, n as u, l as b } from "./helpers-DxFcNkZe.js";
+class A {
   /** 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 */
@@ -13,11 +11,14 @@ class O {
   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
@@ -29,7 +30,7 @@ class O {
    * @param type - The type of change (create, change, delete)
    */
   async notifyChange(t) {
-    if (!this.watchCallback)
+    if (!this.options.broadcastChannel)
       return;
     let e;
     if (this.options.hashAlgorithm && !t.isDirectory && t.type !== "removed")
@@ -39,24 +40,29 @@ class O {
       } catch (i) {
         console.warn(`Failed to calculate hash for ${t.path}:`, i);
       }
-    this.watchCallback({
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      ...t,
-      ...e && { hash: e }
-    });
+    try {
+      this.broadcastChannel || (this.broadcastChannel = new BroadcastChannel(this.options.broadcastChannel));
+      const i = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...t,
+        ...e && { hash: e }
+      };
+      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, e) {
-    S(), t && (this.watchCallback = t), e && this.setOptions(e), this.mount("/");
+  constructor(t) {
+    S(), t && this.setOptions(t), this.mount("/");
   }
   /**
    * Initialize the file system within a given directory
@@ -83,23 +89,15 @@ class O {
     return this.mountingPromise && await this.mountingPromise, this.mountingPromise = new Promise(async (e, i) => {
       this.root = null;
       try {
-        const r = await navigator.storage.getDirectory();
-        t === "/" ? this.root = r : this.root = await this.getDirectoryHandle(t, !0, r), e(!0);
-      } catch (r) {
-        console.error(r), i(new n("Failed to initialize OPFS", "INIT_FAILED"));
+        const a = await navigator.storage.getDirectory();
+        t === "/" ? this.root = a : this.root = await this.getDirectoryHandle(t, !0, a), e(!0);
+      } catch (a) {
+        console.error(a), i(new n("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
    * 
@@ -107,9 +105,10 @@ class O {
    * @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
@@ -150,11 +149,11 @@ class O {
   async getDirectoryHandle(t, e = !1, i = this.root) {
     if (!i)
       throw new l();
-    const r = Array.isArray(t) ? t : w(t);
-    let a = i;
-    for (const s of r)
-      a = await a.getDirectoryHandle(s, { create: e });
-    return a;
+    const a = Array.isArray(t) ? t : w(t);
+    let r = i;
+    for (const s of a)
+      r = await r.getDirectoryHandle(s, { create: e });
+    return r;
   }
   /**
    * Get a file handle from a path
@@ -178,11 +177,11 @@ class O {
   async getFileHandle(t, e = !1, i = this.root) {
     if (!i)
       throw new l();
-    const r = w(t);
-    if (r.length === 0)
+    const a = w(t);
+    if (a.length === 0)
       throw new g("Path must not be empty", Array.isArray(t) ? t.join("/") : t);
-    const a = r.pop();
-    return (await this.getDirectoryHandle(r, e, i)).getFileHandle(a, { create: e });
+    const r = a.pop();
+    return (await this.getDirectoryHandle(a, e, i)).getFileHandle(r, { create: e });
   }
   /**
    * Get a complete index of all files and directories in the file system
@@ -205,9 +204,9 @@ class O {
    */
   async index() {
     const t = /* @__PURE__ */ new Map(), e = async (i) => {
-      const r = await this.readdir(i, { withFileTypes: !0 });
-      for (const a of r) {
-        const s = `${i === "/" ? "" : i}/${a.name}`;
+      const a = await this.readDir(i);
+      for (const r of a) {
+        const s = `${i === "/" ? "" : i}/${r.name}`;
         try {
           const o = await this.stat(s);
           t.set(s, o), o.isDirectory && await e(s);
@@ -228,8 +227,8 @@ class O {
   async readFile(t, e = "utf-8") {
     await this.ensureMounted();
     try {
-      const i = await this.getFileHandle(t, !1), r = await v(i);
-      return e === "binary" ? r : I(r, e);
+      const i = await this.getFileHandle(t, !1), a = await v(i);
+      return e === "binary" ? a : I(a, e);
     } catch (i) {
       throw console.error(i), new f(t);
     }
@@ -261,8 +260,8 @@ class O {
    */
   async writeFile(t, e, i) {
     await this.ensureMounted();
-    const r = await this.getFileHandle(t, !0);
-    await F(r, e, i, { truncate: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
+    const a = await this.getFileHandle(t, !0);
+    await D(a, e, i, { truncate: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
   }
   /**
    * Append data to a file
@@ -288,8 +287,8 @@ class O {
    */
   async appendFile(t, e, i) {
     await this.ensureMounted();
-    const r = await this.getFileHandle(t, !0);
-    await F(r, e, i, { append: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
+    const a = await this.getFileHandle(t, !0);
+    await D(a, e, i, { append: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
   }
   /**
    * Create a directory
@@ -315,15 +314,15 @@ class O {
   async mkdir(t, e) {
     if (await this.ensureMounted(), !this.root)
       throw new l();
-    const i = e?.recursive ?? !1, r = w(t);
-    let a = this.root;
-    for (let s = 0; s < r.length; s++) {
-      const o = r[s];
+    const i = e?.recursive ?? !1, a = w(t);
+    let r = this.root;
+    for (let s = 0; s < a.length; s++) {
+      const o = a[s];
       try {
-        a = await a.getDirectoryHandle(o, { create: i || s === r.length - 1 });
+        r = await r.getDirectoryHandle(o, { create: i || s === a.length - 1 });
       } catch (c) {
         throw c.name === "NotFoundError" ? new n(
-          `Parent directory does not exist: ${T(r.slice(0, s + 1))}`,
+          `Parent directory does not exist: ${C(a.slice(0, s + 1))}`,
           "ENOENT"
         ) : c.name === "TypeMismatchError" ? new n(`Path segment is not a directory: ${o}`, "ENOTDIR") : new n("Failed to create directory", "MKDIR_FAILED");
       }
@@ -362,7 +361,7 @@ class O {
         isFile: !1,
         isDirectory: !0
       };
-    const e = y(t), i = await this.getDirectoryHandle(u(t), !1), r = this.options.hashAlgorithm !== null;
+    const e = d(t), i = await this.getDirectoryHandle(y(t), !1), a = this.options.hashAlgorithm !== null;
     try {
       const s = await (await i.getFileHandle(e, { create: !1 })).getFile(), o = {
         kind: "file",
@@ -372,7 +371,7 @@ class O {
         isFile: !0,
         isDirectory: !1
       };
-      if (r && this.options.hashAlgorithm)
+      if (a && this.options.hashAlgorithm)
         try {
           const c = await M(s, this.options.hashAlgorithm, this.options.maxFileSize);
           o.hash = c;
@@ -380,8 +379,8 @@ class O {
           console.warn(`Failed to calculate hash for ${t}:`, c);
         }
       return o;
-    } catch (a) {
-      if (a.name !== "TypeMismatchError" && a.name !== "NotFoundError")
+    } catch (r) {
+      if (r.name !== "TypeMismatchError" && r.name !== "NotFoundError")
         throw new n("Failed to stat (file)", "STAT_FAILED");
     }
     try {
@@ -393,31 +392,41 @@ class O {
         isFile: !1,
         isDirectory: !0
       };
-    } catch (a) {
-      throw a.name === "NotFoundError" ? new n(`No such file or directory: ${t}`, "ENOENT") : new n("Failed to stat (directory)", "STAT_FAILED");
+    } catch (r) {
+      throw r.name === "NotFoundError" ? new n(`No such file or directory: ${t}`, "ENOENT") : new n("Failed to stat (directory)", "STAT_FAILED");
     }
   }
-  async readdir(t, e) {
+  /**
+   * 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 i = e?.withFileTypes ?? !1, r = await this.getDirectoryHandle(t, !1);
-    if (i) {
-      const a = [];
-      for await (const [s, o] of r.entries()) {
-        const c = o.kind === "file";
-        a.push({
-          name: s,
-          kind: o.kind,
-          isFile: c,
-          isDirectory: !c
-        });
-      }
-      return a;
-    } else {
-      const a = [];
-      for await (const [s] of r.entries())
-        a.push(s);
-      return a;
+    const e = await this.getDirectoryHandle(t, !1), i = [];
+    for await (const [a, r] of e.entries()) {
+      const s = r.kind === "file";
+      i.push({
+        name: a,
+        kind: r.kind,
+        isFile: s,
+        isDirectory: !s
+      });
     }
+    return i;
   }
   /**
    * Check if a file or directory exists
@@ -436,26 +445,26 @@ class O {
   async exists(t) {
     if (await this.ensureMounted(), t === "/")
       return !0;
-    const e = y(t);
+    const e = d(t);
     let i = null;
     try {
-      i = await this.getDirectoryHandle(u(t), !1);
-    } catch (r) {
-      throw (r.name === "NotFoundError" || r.name === "TypeMismatchError") && (i = null), r;
+      i = await this.getDirectoryHandle(y(t), !1);
+    } catch (a) {
+      throw (a.name === "NotFoundError" || a.name === "TypeMismatchError") && (i = null), a;
     }
     if (!i || !e)
       return !1;
     try {
       return await i.getFileHandle(e, { create: !1 }), !0;
-    } catch (r) {
-      if (r.name !== "NotFoundError" && r.name !== "TypeMismatchError")
-        throw r;
+    } catch (a) {
+      if (a.name !== "NotFoundError" && a.name !== "TypeMismatchError")
+        throw a;
     }
     try {
       return await i.getDirectoryHandle(e, { create: !1 }), !0;
-    } catch (r) {
-      if (r.name !== "NotFoundError" && r.name !== "TypeMismatchError")
-        throw r;
+    } catch (a) {
+      if (a.name !== "NotFoundError" && a.name !== "TypeMismatchError")
+        throw a;
     }
     return !1;
   }
@@ -481,10 +490,10 @@ class O {
   async clear(t = "/") {
     await this.ensureMounted();
     try {
-      const e = await this.readdir(t, { withFileTypes: !0 });
+      const e = await this.readDir(t);
       for (const i of e) {
-        const r = `${t === "/" ? "" : t}/${i.name}`;
-        await this.remove(r, { recursive: !0 });
+        const a = `${t === "/" ? "" : t}/${i.name}`;
+        await this.remove(a, { recursive: !0 });
       }
       await this.notifyChange({ path: t, type: "changed", isDirectory: !0 });
     } catch (e) {
@@ -517,18 +526,18 @@ class O {
    */
   async remove(t, e) {
     await this.ensureMounted();
-    const i = e?.recursive ?? !1, r = e?.force ?? !1;
+    const i = e?.recursive ?? !1, a = e?.force ?? !1;
     if (t === "/")
       throw new n("Cannot remove root directory", "EROOT");
-    const a = y(t);
-    if (!a)
+    const r = d(t);
+    if (!r)
       throw new g("Invalid path", t);
-    const s = await this.getDirectoryHandle(u(t), !1);
+    const s = await this.getDirectoryHandle(y(t), !1);
     try {
-      await s.removeEntry(a, { recursive: i });
+      await s.removeEntry(r, { recursive: i });
     } catch (o) {
       if (o.name === "NotFoundError") {
-        if (!r)
+        if (!a)
           throw new n(`No such file or directory: ${t}`, "ENOENT");
       } else throw o.name === "InvalidModificationError" ? new n(`Directory not empty: ${t}. Use recursive option to force removal.`, "ENOTEMPTY") : o.name === "TypeMismatchError" && !i ? new n(`Cannot remove directory without recursive option: ${t}`, "EISDIR") : new n(`Failed to remove path: ${t}`, "RM_FAILED");
     }
@@ -555,7 +564,7 @@ class O {
   async realpath(t) {
     await this.ensureMounted();
     try {
-      const e = A(t);
+      const e = T(t);
       if (!await this.exists(e))
         throw new f(e);
       return e;
@@ -617,27 +626,27 @@ class O {
   async copy(t, e, i) {
     await this.ensureMounted();
     try {
-      const r = i?.recursive ?? !1, a = i?.force ?? !0;
+      const a = i?.recursive ?? !1, r = i?.force ?? !0;
       if (!await this.exists(t))
         throw new n(`Source does not exist: ${t}`, "ENOENT");
-      if (await this.exists(e) && !a)
+      if (await this.exists(e) && !r)
         throw new n(`Destination already exists: ${e}`, "EEXIST");
       if ((await this.stat(t)).isFile) {
         const h = await this.readFile(t, "binary");
         await this.writeFile(e, h);
       } else {
-        if (!r)
+        if (!a)
           throw new n(`Cannot copy directory without recursive option: ${t}`, "EISDIR");
         await this.mkdir(e, { recursive: !0 });
-        const h = await this.readdir(t, { withFileTypes: !0 });
+        const h = await this.readDir(t);
         for (const m of h) {
-          const D = `${t}/${m.name}`, p = `${e}/${m.name}`;
-          await this.copy(D, p, { recursive: !0, force: a });
+          const F = `${t}/${m.name}`, E = `${e}/${m.name}`;
+          await this.copy(F, E, { recursive: !0, force: r });
         }
       }
       await this.notifyChange({ path: e, type: "added", isDirectory: !1 });
-    } catch (r) {
-      throw r instanceof n ? r : new n(`Failed to copy from ${t} to ${e}`, "CP_FAILED");
+    } catch (a) {
+      throw a instanceof n ? a : new n(`Failed to copy from ${t} to ${e}`, "CP_FAILED");
     }
   }
   /**
@@ -645,7 +654,7 @@ class O {
    */
   async watch(t) {
     await this.ensureMounted();
-    const e = d(t), i = await this.buildSnapshot(e);
+    const e = u(t), i = await this.buildSnapshot(e);
     this.watchers.set(e, i), this.watchTimer || (this.watchTimer = setInterval(() => {
       this.scanWatches();
     }, this.options.watchInterval));
@@ -654,16 +663,25 @@ class O {
    * Stop watching a previously watched path
    */
   unwatch(t) {
-    const e = d(t);
+    const e = u(t);
     this.watchers.delete(e), 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 e = /* @__PURE__ */ new Map(), i = async (r) => {
-      const a = await this.stat(r);
-      if (e.set(r, a), a.isDirectory) {
-        const s = await this.readdir(r, { withFileTypes: !0 });
+    const e = /* @__PURE__ */ new Map(), i = async (a) => {
+      const r = await this.stat(a);
+      if (e.set(a, r), r.isDirectory) {
+        const s = await this.readDir(a);
         for (const o of s) {
-          const c = `${r === "/" ? "" : r}/${o.name}`;
+          const c = `${a === "/" ? "" : a}/${o.name}`;
           await i(c);
         }
       }
@@ -682,12 +700,15 @@ class O {
             } catch {
               i = /* @__PURE__ */ new Map();
             }
-            for (const [r, a] of i) {
-              const s = e.get(r);
-              s ? (s.mtime !== a.mtime || s.size !== a.size) && await this.notifyChange({ path: r, type: "changed", isDirectory: !1 }) : await this.notifyChange({ path: r, type: "added", isDirectory: !1 });
+            for (const [a, r] of i) {
+              const s = e.get(a);
+              s ? (s.mtime !== r.mtime || s.size !== r.size) && await this.notifyChange({ path: a, type: "changed", isDirectory: r.isDirectory }) : await this.notifyChange({ path: a, type: "added", isDirectory: r.isDirectory });
             }
-            for (const r of e.keys())
-              i.has(r) || await this.notifyChange({ path: r, type: "removed", isDirectory: !1 });
+            for (const a of e.keys())
+              if (!i.has(a)) {
+                const r = e.get(a);
+                await this.notifyChange({ path: a, type: "removed", isDirectory: r?.isDirectory ?? !1 });
+              }
             this.watchers.set(t, i);
           })
         );
@@ -728,10 +749,10 @@ class O {
     await this.ensureMounted();
     try {
       (e?.cleanBefore ?? !1) && await this.clear("/");
-      for (const [r, a] of t) {
-        const s = d(r);
+      for (const [a, r] of t) {
+        const s = u(a);
         let o;
-        a instanceof Blob ? o = await $(a) : o = a, await this.writeFile(s, o);
+        r instanceof Blob ? o = await b(r) : o = r, await this.writeFile(s, o);
       }
       await this.notifyChange({ path: "/", type: "changed", isDirectory: !0 });
     } catch (i) {
@@ -739,8 +760,8 @@ class O {
     }
   }
 }
-typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && E(new O());
+typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && p(new A());
 export {
-  O as OPFSWorker
+  A as OPFSWorker
 };
 //# sourceMappingURL=raw.js.map