opfs-worker 0.2.1 → 0.2.3

package/dist/raw.js

@@ -1,6 +1,6 @@
-import { expose as p } from "comlink";
-import { d as v, O as o, b as f, s as y, P as E, i as I, o as S, F as d, w as g, j as T, e as u, f as m, k as H, r as $, n as F, l as A } from "./helpers-Co-qCBmA.js";
-class N {
+import { expose as v } from "comlink";
+import { d as I, O as o, b as f, s as u, P as g, i as p, o as S, F as d, w as E, j as T, e as m, f as y, k as M, r as H, n as F, l as P } from "./helpers-Co-qCBmA.js";
+class $ {
   /** Root directory handle for the file system */
   root = null;
   /** Watch event callback */
@@ -13,19 +13,23 @@ class N {
   watchInterval = 1e3;
   /** Flag to avoid concurrent scans */
   scanning = !1;
+  /** Promise to prevent concurrent mount operations */
+  mountingPromise = null;
   /**
    * Creates a new OPFSFileSystem instance
    * 
+   * @param watchCallback - Optional callback for file change events
+   * @param watchOptions - Optional configuration for watching
    * @throws {OPFSError} If OPFS is not supported in the current browser
    */
-  constructor() {
-    v();
+  constructor(t, e) {
+    I(), t && (this.watchCallback = t, e?.watchInterval && (this.watchInterval = e.watchInterval)), this.mount("/");
   }
   /**
    * Initialize the file system within a given directory
    * 
    * This method sets up the root directory for all subsequent operations.
-   * It must be called before any other file system operations.
+   * If no root is specified, it will use the OPFS root directory.
    * 
    * @param root - The root path for the file system (default: '/')
    * @returns Promise that resolves to true if initialization was successful
@@ -34,15 +38,52 @@ class N {
    * @example
    * ```typescript
    * const fs = new OPFSFileSystem();
-   * const success = await fs.init('/my-app');
+   * 
+   * // Use OPFS root (default)
+   * await fs.mount();
+   * 
+   * // Use custom directory
+   * await fs.mount('/my-app');
    * ```
    */
-  async mount(t = "/", e, a) {
-    try {
-      const r = await navigator.storage.getDirectory();
-      return this.root = await this.getDirectoryHandle(t, !0, r), e && (this.watchCallback = e, a?.watchInterval && (this.watchInterval = a.watchInterval)), !0;
-    } catch (r) {
-      throw console.error(r), new o("Failed to initialize OPFS", "INIT_FAILED");
+  async mount(t = "/") {
+    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 o("Failed to initialize OPFS", "INIT_FAILED"));
+      } finally {
+        this.mountingPromise = null;
+      }
+    }), this.mountingPromise;
+  }
+  /**
+   * Set the watch callback for file change events
+   * 
+   * @param callback - The callback function to invoke when files change
+   * @param options - Optional configuration for watching
+   */
+  setWatchCallback(t, e) {
+    this.watchCallback = t, e?.watchInterval && (this.watchInterval = e.watchInterval);
+  }
+  /**
+   * Automatically mount the OPFS root if not already mounted
+   * 
+   * This method is called internally when file operations are performed
+   * without explicitly mounting first.
+   * 
+   * @returns Promise that resolves when auto-mount is complete
+   * @throws {OPFSError} If auto-mount fails
+   */
+  async ensureMounted() {
+    if (!this.root) {
+      if (this.mountingPromise) {
+        await this.mountingPromise;
+        return;
+      }
+      throw new o("OPFS not mounted", "NOT_MOUNTED");
     }
   }
   /**
@@ -63,14 +104,14 @@ class N {
    * const docsDir2 = await fs.getDirectoryHandle(['users', 'john', 'documents'], true);
    * ```
    */
-  async getDirectoryHandle(t, e = !1, a = this.root) {
-    if (!a)
+  async getDirectoryHandle(t, e = !1, i = this.root) {
+    if (!i)
       throw new f();
-    const r = Array.isArray(t) ? t : y(t);
-    let i = a;
+    const r = Array.isArray(t) ? t : u(t);
+    let a = i;
     for (const n of r)
-      i = await i.getDirectoryHandle(n, { create: e });
-    return i;
+      a = await a.getDirectoryHandle(n, { create: e });
+    return a;
   }
   /**
    * Get a file handle from a path
@@ -91,14 +132,14 @@ class N {
    * const fileHandle2 = await fs.getFileHandle(['config', 'settings.json'], true);
    * ```
    */
-  async getFileHandle(t, e = !1, a = this.root) {
-    if (!a)
+  async getFileHandle(t, e = !1, i = this.root) {
+    if (!i)
       throw new f();
-    const r = y(t);
+    const r = u(t);
     if (r.length === 0)
-      throw new E("Path must not be empty", Array.isArray(t) ? t.join("/") : t);
-    const i = r.pop();
-    return (await this.getDirectoryHandle(r, e, a)).getFileHandle(i, { create: e });
+      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 });
   }
   /**
    * Recursively list all files and directories with their stats
@@ -138,13 +179,13 @@ class N {
    * ```
    */
   async index(t) {
-    const e = /* @__PURE__ */ new Map(), a = async (r) => {
-      const i = await this.readdir(r, { withFileTypes: !0 });
-      for (const n of i) {
+    const e = /* @__PURE__ */ new Map(), i = async (r) => {
+      const a = await this.readdir(r, { withFileTypes: !0 });
+      for (const n of a) {
         const s = `${r === "/" ? "" : r}/${n.name}`;
         try {
           const c = await this.stat(s, t);
-          e.set(s, c), c.isDirectory && await a(s);
+          e.set(s, c), c.isDirectory && await i(s);
         } catch (c) {
           console.warn(`Skipping broken entry: ${s}`, c);
         }
@@ -157,14 +198,15 @@ class N {
       ctime: (/* @__PURE__ */ new Date(0)).toISOString(),
       isFile: !1,
       isDirectory: !0
-    }), await a("/"), e;
+    }), await i("/"), e;
   }
   async readFile(t, e = "utf-8") {
+    await this.ensureMounted();
     try {
-      const a = await this.getFileHandle(t, !1), r = await I(a);
+      const i = await this.getFileHandle(t, !1), r = await p(i);
       return e === "binary" ? r : S(r, e);
-    } catch (a) {
-      throw console.error(a), new d(t);
+    } catch (i) {
+      throw console.error(i), new d(t);
     }
   }
   /**
@@ -192,9 +234,10 @@ class N {
    * await fs.writeFile('/data/utf16.txt', 'Hello World', 'utf-16le');
    * ```
    */
-  async writeFile(t, e, a) {
+  async writeFile(t, e, i) {
+    await this.ensureMounted();
     const r = await this.getFileHandle(t, !0);
-    await g(r, e, a, { truncate: !0 });
+    await E(r, e, i, { truncate: !0 });
   }
   /**
    * Append data to a file
@@ -218,9 +261,10 @@ class N {
    * await fs.appendFile('/data/binary.dat', additionalData);
    * ```
    */
-  async appendFile(t, e, a) {
+  async appendFile(t, e, i) {
+    await this.ensureMounted();
     const r = await this.getFileHandle(t, !0);
-    await g(r, e, a, { append: !0 });
+    await E(r, e, i, { append: !0 });
   }
   /**
    * Create a directory
@@ -244,14 +288,14 @@ class N {
    * ```
    */
   async mkdir(t, e) {
-    if (!this.root)
+    if (await this.ensureMounted(), !this.root)
       throw new f();
-    const a = e?.recursive ?? !1, r = y(t);
-    let i = this.root;
+    const i = e?.recursive ?? !1, r = u(t);
+    let a = this.root;
     for (let n = 0; n < r.length; n++) {
       const s = r[n];
       try {
-        i = await i.getDirectoryHandle(s, { create: a || n === r.length - 1 });
+        a = await a.getDirectoryHandle(s, { create: i || n === r.length - 1 });
       } catch (c) {
         throw c.name === "NotFoundError" ? new o(
           `Parent directory does not exist: ${T(r.slice(0, n + 1))}`,
@@ -290,9 +334,18 @@ class N {
    * ```
    */
   async stat(t, e) {
-    const a = u(t), r = await this.getDirectoryHandle(m(t), !1), i = e?.includeHash ?? !1, n = e?.hashAlgorithm ?? "SHA-1";
+    if (await this.ensureMounted(), t === "/")
+      return {
+        kind: "directory",
+        size: 0,
+        mtime: (/* @__PURE__ */ new Date(0)).toISOString(),
+        ctime: (/* @__PURE__ */ new Date(0)).toISOString(),
+        isFile: !1,
+        isDirectory: !0
+      };
+    const i = m(t), r = await this.getDirectoryHandle(y(t), !1), a = e?.includeHash ?? !1, n = e?.hashAlgorithm ?? "SHA-1";
     try {
-      const c = await (await r.getFileHandle(a, { create: !1 })).getFile(), l = {
+      const c = await (await r.getFileHandle(i, { create: !1 })).getFile(), l = {
         kind: "file",
         size: c.size,
         mtime: new Date(c.lastModified).toISOString(),
@@ -300,9 +353,9 @@ class N {
         isFile: !0,
         isDirectory: !1
       };
-      if (i)
+      if (a)
         try {
-          const h = new Uint8Array(await c.arrayBuffer()), w = await H(h, n);
+          const h = new Uint8Array(await c.arrayBuffer()), w = await M(h, n);
           l.hash = w;
         } catch (h) {
           console.warn(`Failed to calculate hash for ${t}:`, h);
@@ -313,7 +366,7 @@ class N {
         throw new o("Failed to stat (file)", "STAT_FAILED");
     }
     try {
-      return await r.getDirectoryHandle(a, { create: !1 }), {
+      return await r.getDirectoryHandle(i, { create: !1 }), {
         kind: "directory",
         size: 0,
         mtime: (/* @__PURE__ */ new Date(0)).toISOString(),
@@ -326,24 +379,25 @@ class N {
     }
   }
   async readdir(t, e) {
-    const a = e?.withFileTypes ?? !1, r = await this.getDirectoryHandle(t, !1);
-    if (a) {
-      const i = [];
+    await this.ensureMounted();
+    const i = e?.withFileTypes ?? !1, r = await this.getDirectoryHandle(t, !1);
+    if (i) {
+      const a = [];
       for await (const [n, s] of r.entries()) {
         const c = s.kind === "file";
-        i.push({
+        a.push({
           name: n,
           kind: s.kind,
           isFile: c,
           isDirectory: !c
         });
       }
-      return i;
+      return a;
     } else {
-      const i = [];
+      const a = [];
       for await (const [n] of r.entries())
-        i.push(n);
-      return i;
+        a.push(n);
+      return a;
     }
   }
   /**
@@ -361,23 +415,25 @@ class N {
    * ```
    */
   async exists(t) {
-    const e = u(t);
-    let a = null;
+    if (await this.ensureMounted(), t === "/")
+      return !0;
+    const e = m(t);
+    let i = null;
     try {
-      a = await this.getDirectoryHandle(m(t), !1);
+      i = await this.getDirectoryHandle(y(t), !1);
     } catch (r) {
-      throw (r.name === "NotFoundError" || r.name === "TypeMismatchError") && (a = null), r;
+      throw (r.name === "NotFoundError" || r.name === "TypeMismatchError") && (i = null), r;
     }
-    if (!a || !e)
+    if (!i || !e)
       return !1;
     try {
-      return await a.getFileHandle(e, { create: !1 }), !0;
+      return await i.getFileHandle(e, { create: !1 }), !0;
     } catch (r) {
       if (r.name !== "NotFoundError" && r.name !== "TypeMismatchError")
         throw r;
     }
     try {
-      return await a.getDirectoryHandle(e, { create: !1 }), !0;
+      return await i.getDirectoryHandle(e, { create: !1 }), !0;
     } catch (r) {
       if (r.name !== "NotFoundError" && r.name !== "TypeMismatchError")
         throw r;
@@ -404,10 +460,11 @@ class N {
    * ```
    */
   async clear(t = "/") {
+    await this.ensureMounted();
     try {
       const e = await this.readdir(t, { withFileTypes: !0 });
-      for (const a of e) {
-        const r = `${t === "/" ? "" : t}/${a.name}`;
+      for (const i of e) {
+        const r = `${t === "/" ? "" : t}/${i.name}`;
         await this.remove(r, { recursive: !0 });
       }
     } catch (e) {
@@ -439,17 +496,21 @@ class N {
    * ```
    */
   async remove(t, e) {
-    const a = e?.recursive ?? !1, r = e?.force ?? !1, i = u(t);
-    if (!i)
-      throw new E("Invalid path", t);
-    const n = await this.getDirectoryHandle(m(t), !1);
+    await this.ensureMounted();
+    const i = e?.recursive ?? !1, r = e?.force ?? !1;
+    if (t === "/")
+      throw new o("Cannot remove root directory", "EROOT");
+    const a = m(t);
+    if (!a)
+      throw new g("Invalid path", t);
+    const n = await this.getDirectoryHandle(y(t), !1);
     try {
-      await n.removeEntry(i, { recursive: a });
+      await n.removeEntry(a, { recursive: i });
     } catch (s) {
       if (s.name === "NotFoundError") {
         if (!r)
           throw new o(`No such file or directory: ${t}`, "ENOENT");
-      } else throw s.name === "InvalidModificationError" ? new o(`Directory not empty: ${t}. Use recursive option to force removal.`, "ENOTEMPTY") : s.name === "TypeMismatchError" && !a ? new o(`Cannot remove directory without recursive option: ${t}`, "EISDIR") : new o(`Failed to remove path: ${t}`, "RM_FAILED");
+      } else throw s.name === "InvalidModificationError" ? new o(`Directory not empty: ${t}. Use recursive option to force removal.`, "ENOTEMPTY") : s.name === "TypeMismatchError" && !i ? new o(`Cannot remove directory without recursive option: ${t}`, "EISDIR") : new o(`Failed to remove path: ${t}`, "RM_FAILED");
     }
   }
   /**
@@ -471,8 +532,9 @@ class N {
    * ```
    */
   async realpath(t) {
+    await this.ensureMounted();
     try {
-      const e = $(t);
+      const e = H(t);
       if (!await this.exists(e))
         throw new d(e);
       return e;
@@ -497,12 +559,13 @@ class N {
    * ```
    */
   async rename(t, e) {
+    await this.ensureMounted();
     try {
       if (!await this.exists(t))
         throw new d(t);
       await this.copy(t, e, { recursive: !0 }), await this.remove(t, { recursive: !0 });
-    } catch (a) {
-      throw a instanceof o ? a : new o(`Failed to rename from ${t} to ${e}`, "RENAME_FAILED");
+    } catch (i) {
+      throw i instanceof o ? i : new o(`Failed to rename from ${t} to ${e}`, "RENAME_FAILED");
     }
   }
   /**
@@ -521,21 +584,22 @@ class N {
    * @example
    * ```typescript
    * // Copy a file
-   * await fs.cp('/source/file.txt', '/dest/file.txt');
+   * await fs.copy('/source/file.txt', '/dest/file.txt');
    * 
    * // Copy a directory and all its contents
-   * await fs.cp('/source/dir', '/dest/dir', { recursive: true });
+   * await fs.copy('/source/dir', '/dest/dir', { recursive: true });
    * 
    * // Copy without overwriting existing files
-   * await fs.cp('/source', '/dest', { recursive: true, force: false });
+   * await fs.copy('/source', '/dest', { recursive: true, force: false });
    * ```
    */
-  async copy(t, e, a) {
+  async copy(t, e, i) {
+    await this.ensureMounted();
     try {
-      const r = a?.recursive ?? !1, i = a?.force ?? !0;
+      const r = i?.recursive ?? !1, a = i?.force ?? !0;
       if (!await this.exists(t))
         throw new o(`Source does not exist: ${t}`, "ENOENT");
-      if (await this.exists(e) && !i)
+      if (await this.exists(e) && !a)
         throw new o(`Destination already exists: ${e}`, "EEXIST");
       if ((await this.stat(t)).isFile) {
         const l = await this.readFile(t, "binary");
@@ -547,7 +611,7 @@ class N {
         const l = await this.readdir(t, { withFileTypes: !0 });
         for (const h of l) {
           const w = `${t}/${h.name}`, D = `${e}/${h.name}`;
-          await this.copy(w, D, { recursive: !0, force: i });
+          await this.copy(w, D, { recursive: !0, force: a });
         }
       }
     } catch (r) {
@@ -558,8 +622,9 @@ class N {
    * Start watching a file or directory for changes
    */
   async watch(t) {
-    const e = F(t), a = await this.buildSnapshot(e);
-    this.watchers.set(e, a), this.watchTimer || (this.watchTimer = setInterval(() => {
+    await this.ensureMounted();
+    const e = F(t), i = await this.buildSnapshot(e);
+    this.watchers.set(e, i), this.watchTimer || (this.watchTimer = setInterval(() => {
       this.scanWatches();
     }, this.watchInterval));
   }
@@ -571,17 +636,17 @@ class N {
     this.watchers.delete(e), this.watchers.size === 0 && this.watchTimer && (clearInterval(this.watchTimer), this.watchTimer = null);
   }
   async buildSnapshot(t) {
-    const e = /* @__PURE__ */ new Map(), a = async (r) => {
-      const i = await this.stat(r);
-      if (e.set(r, i), i.isDirectory) {
+    const e = /* @__PURE__ */ new Map(), i = async (r) => {
+      const a = await this.stat(r);
+      if (e.set(r, a), a.isDirectory) {
         const n = await this.readdir(r, { withFileTypes: !0 });
         for (const s of n) {
           const c = `${r === "/" ? "" : r}/${s.name}`;
-          await a(c);
+          await i(c);
         }
       }
     };
-    return await a(t), e;
+    return await i(t), e;
   }
   async scanWatches() {
     if (!this.scanning) {
@@ -589,23 +654,23 @@ class N {
       try {
         await Promise.all(
           [...this.watchers.entries()].map(async ([t, e]) => {
-            let a;
+            let i;
             try {
-              a = await this.buildSnapshot(t);
+              i = await this.buildSnapshot(t);
             } catch {
-              a = /* @__PURE__ */ new Map();
+              i = /* @__PURE__ */ new Map();
             }
             const r = [];
-            for (const [i, n] of a) {
-              const s = e.get(i);
-              s ? (s.mtime !== n.mtime || s.size !== n.size) && r.push({ path: i, type: "change" }) : r.push({ path: i, type: "create" });
+            for (const [a, n] of i) {
+              const s = e.get(a);
+              s ? (s.mtime !== n.mtime || s.size !== n.size) && r.push({ path: a, type: "change" }) : r.push({ path: a, type: "create" });
             }
-            for (const i of e.keys())
-              a.has(i) || r.push({ path: i, type: "delete" });
+            for (const a of e.keys())
+              i.has(a) || r.push({ path: a, type: "delete" });
             if (r.length && this.watchCallback)
-              for (const i of r)
-                this.watchCallback(i);
-            this.watchers.set(t, a);
+              for (const a of r)
+                this.watchCallback(a);
+            this.watchers.set(t, i);
           })
         );
       } finally {
@@ -642,20 +707,21 @@ class N {
    * ```
    */
   async sync(t, e) {
+    await this.ensureMounted();
     try {
       (e?.cleanBefore ?? !1) && await this.clear("/");
-      for (const [r, i] of t) {
+      for (const [r, a] of t) {
         const n = F(r);
         let s;
-        i instanceof Blob ? s = await A(i) : s = i, await this.writeFile(n, s);
+        a instanceof Blob ? s = await P(a) : s = a, await this.writeFile(n, s);
       }
-    } catch (a) {
-      throw a instanceof o ? a : new o("Failed to sync file system", "SYNC_FAILED");
+    } catch (i) {
+      throw i instanceof o ? i : new o("Failed to sync file system", "SYNC_FAILED");
     }
   }
 }
-typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && p(new N());
+typeof self < "u" && self.constructor.name === "DedicatedWorkerGlobalScope" && v(new $());
 export {
-  N as OPFSWorker
+  $ as OPFSWorker
 };
 //# sourceMappingURL=raw.js.map