opfs-worker 1.0.1 → 1.1.0

package/dist/raw.js

@@ -1,6 +1,6 @@
-import { expose as v } from "comlink";
-import { m as h, d as p, O as o, n as u, s as w, P as S, i as d, o as b, y as C, F as f, p as g, j as x, e as F, f as m, q as A, v as I, r as H, g as $, u as O } from "./helpers-CTCvNFs1.js";
-class T {
+import { expose as H, transfer as D } from "comlink";
+import { O as o, i as y, e as C, n as u, s as m, P as b, E as g, p as A, H as $, F, q as E, j as O, f as v, g as p, t as T, x as N, r as S, h as P, w as _, B as k, z as x, y as I, A as L, d, v as z } from "./helpers-DS5dyURe.js";
+class M {
   /** Root directory handle for the file system */
   root;
   /** Map of watched paths and options */
@@ -17,6 +17,20 @@ class T {
     hashAlgorithm: null,
     broadcastChannel: "opfs-worker"
   };
+  /** Map of open file descriptors to their metadata */
+  openFiles = /* @__PURE__ */ new Map();
+  /** Next available file descriptor number */
+  nextFd = 1;
+  /**
+   * Get file info by descriptor with validation
+   * @private
+   */
+  _getFileDescriptor(t) {
+    const e = this.openFiles.get(t);
+    if (!e)
+      throw new o(`Invalid file descriptor: ${t}`, "EBADF");
+    return e;
+  }
   /**
    * Notify about internal changes to the file system
    * 
@@ -30,12 +44,12 @@ class T {
     if (!this.options.broadcastChannel)
       return;
     const e = t.path;
-    if (![...this.watchers.values()].some((r) => h(e, r.pattern) && r.include.some((s) => s && h(e, s)) && !r.exclude.some((s) => s && h(e, s))))
+    if (![...this.watchers.values()].some((r) => y(e, r.pattern) && r.include.some((s) => s && y(e, s)) && !r.exclude.some((s) => s && y(e, s))))
       return;
-    let i;
+    let a;
     if (this.options.hashAlgorithm)
       try {
-        i = (await this.stat(e)).hash;
+        a = (await this.stat(e)).hash;
       } catch {
       }
     try {
@@ -44,7 +58,7 @@ class T {
         namespace: this.options.namespace,
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         ...t,
-        ...i && { hash: i }
+        ...a && { hash: a }
       };
       this.broadcastChannel.postMessage(r);
     } catch (r) {
@@ -62,7 +76,7 @@ class T {
    * @throws {OPFSError} If OPFS is not supported in the current browser
    */
   constructor(t) {
-    p(), t && this.setOptions(t);
+    C(), t && this.setOptions(t);
   }
   /**
    * Initialize the file system within a given directory
@@ -87,12 +101,12 @@ class T {
    */
   async mount() {
     const t = this.options.root;
-    return this.mountingPromise && await this.mountingPromise, this.mountingPromise = new Promise(async (e, a) => {
+    return this.mountingPromise && await this.mountingPromise, this.mountingPromise = new Promise(async (e, i) => {
       try {
-        const i = await navigator.storage.getDirectory();
-        this.root = t === "/" ? i : await this.getDirectoryHandle(t, !0, i), e(!0);
-      } catch (i) {
-        a(new o("Failed to initialize OPFS", "INIT_FAILED", t, i));
+        const a = await navigator.storage.getDirectory();
+        this.root = t === "/" ? a : await this.getDirectoryHandle(t, !0, a), e(!0);
+      } catch (a) {
+        i(new o("Failed to initialize OPFS", "INIT_FAILED", t, a));
       } finally {
         this.mountingPromise = null;
       }
@@ -129,10 +143,10 @@ class T {
    * const docsDir2 = await fs.getDirectoryHandle(['users', 'john', 'documents'], true);
    * ```
    */
-  async getDirectoryHandle(t, e = !1, a = this.root) {
-    const i = Array.isArray(t) ? t : w(t);
-    let r = a;
-    for (const s of i)
+  async getDirectoryHandle(t, e = !1, i = this.root) {
+    const a = Array.isArray(t) ? t : m(t);
+    let r = i;
+    for (const s of a)
       r = await r.getDirectoryHandle(s, { create: e });
     return r;
   }
@@ -155,12 +169,12 @@ class T {
    * const fileHandle2 = await fs.getFileHandle(['config', 'settings.json'], true);
    * ```
    */
-  async getFileHandle(t, e = !1, a = this.root) {
-    const i = w(t);
-    if (i.length === 0)
-      throw new S("Path must not be empty", Array.isArray(t) ? t.join("/") : t);
-    const r = i.pop();
-    return (await this.getDirectoryHandle(i, e, a)).getFileHandle(r, { create: e });
+  async getFileHandle(t, e = !1, i = this.root) {
+    const a = m(t);
+    if (a.length === 0)
+      throw new b("Path must not be empty", Array.isArray(t) ? t.join("/") : t);
+    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
@@ -182,10 +196,10 @@ class T {
    * ```
    */
   async index() {
-    const t = /* @__PURE__ */ new Map(), e = async (a) => {
-      const i = await this.readDir(a);
-      for (const r of i) {
-        const s = `${a === "/" ? "" : a}/${r.name}`;
+    const t = /* @__PURE__ */ new Map(), e = async (i) => {
+      const a = await this.readDir(i);
+      for (const r of a) {
+        const s = `${i === "/" ? "" : i}/${r.name}`;
         try {
           const n = await this.stat(s);
           t.set(s, n), n.isDirectory && await e(s);
@@ -204,12 +218,12 @@ class T {
     }), await e("/"), t;
   }
   async readFile(t, e) {
-    await this.mount(), e || (e = d(t) ? "binary" : "utf-8");
+    await this.mount(), e || (e = g(t) ? "binary" : "utf-8");
     try {
-      const a = await this.getFileHandle(t, !1, this.root), i = await b(a, t);
-      return e === "binary" ? i : C(i, e);
-    } catch (a) {
-      throw new f(t, a);
+      const i = await this.getFileHandle(t, !1, this.root), a = await A(i, t);
+      return e === "binary" ? a : $(a, e);
+    } catch (i) {
+      throw new F(t, i);
     }
   }
   /**
@@ -237,10 +251,10 @@ class T {
    * await fs.writeFile('/data/utf16.txt', 'Hello World', 'utf-16le');
    * ```
    */
-  async writeFile(t, e, a) {
+  async writeFile(t, e, i) {
     await this.mount();
-    const i = await this.exists(t), r = await this.getFileHandle(t, !0);
-    a || (a = typeof e != "string" || d(t) ? "binary" : "utf-8"), await g(r, e, a, t), i ? await this.notifyChange({ path: t, type: "changed", isDirectory: !1 }) : await this.notifyChange({ path: t, type: "added", isDirectory: !1 });
+    const a = await this.exists(t), r = await this.getFileHandle(t, !0);
+    i || (i = typeof e != "string" || g(t) ? "binary" : "utf-8"), await E(r, e, i, t), a ? await this.notifyChange({ path: t, type: "changed", isDirectory: !1 }) : await this.notifyChange({ path: t, type: "added", isDirectory: !1 });
   }
   /**
    * Append data to a file
@@ -264,10 +278,10 @@ class T {
    * await fs.appendFile('/data/binary.dat', additionalData);
    * ```
    */
-  async appendFile(t, e, a) {
+  async appendFile(t, e, i) {
     await this.mount();
-    const i = await this.getFileHandle(t, !0);
-    a || (a = typeof e != "string" || d(t) ? "binary" : "utf-8"), await g(i, e, a, t, { append: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
+    const a = await this.getFileHandle(t, !0);
+    i || (i = typeof e != "string" || g(t) ? "binary" : "utf-8"), await E(a, e, i, t, { append: !0 }), await this.notifyChange({ path: t, type: "changed", isDirectory: !1 });
   }
   /**
    * Create a directory
@@ -292,15 +306,15 @@ class T {
    */
   async mkdir(t, e) {
     await this.mount();
-    const a = e?.recursive ?? !1, i = w(t);
+    const i = e?.recursive ?? !1, a = m(t);
     let r = this.root;
-    for (let s = 0; s < i.length; s++) {
-      const n = i[s];
+    for (let s = 0; s < a.length; s++) {
+      const n = a[s];
       try {
-        r = await r.getDirectoryHandle(n, { create: a || s === i.length - 1 });
+        r = await r.getDirectoryHandle(n, { create: i || s === a.length - 1 });
       } catch (c) {
         throw c.name === "NotFoundError" ? new o(
-          `Parent directory does not exist: ${x(i.slice(0, s + 1))}`,
+          `Parent directory does not exist: ${O(a.slice(0, s + 1))}`,
           "ENOENT",
           void 0,
           c
@@ -341,9 +355,9 @@ class T {
         isFile: !1,
         isDirectory: !0
       };
-    const e = F(t), a = await this.getDirectoryHandle(m(t), !1), i = this.options.hashAlgorithm !== null;
+    const e = v(t), i = await this.getDirectoryHandle(p(t), !1), a = this.options.hashAlgorithm !== null;
     try {
-      const s = await (await a.getFileHandle(e, { create: !1 })).getFile(), n = {
+      const s = await (await i.getFileHandle(e, { create: !1 })).getFile(), n = {
         kind: "file",
         size: s.size,
         mtime: new Date(s.lastModified).toISOString(),
@@ -351,9 +365,9 @@ class T {
         isFile: !0,
         isDirectory: !1
       };
-      if (i && this.options.hashAlgorithm)
+      if (a && this.options.hashAlgorithm)
         try {
-          const c = await A(s, this.options.hashAlgorithm, this.options.maxFileSize);
+          const c = await T(s, this.options.hashAlgorithm, this.options.maxFileSize);
           n.hash = c;
         } catch (c) {
           console.warn(`Failed to calculate hash for ${t}:`, c);
@@ -364,7 +378,7 @@ class T {
         throw new o("Failed to stat (file)", "STAT_FAILED", void 0, r);
     }
     try {
-      return await a.getDirectoryHandle(e, { create: !1 }), {
+      return await i.getDirectoryHandle(e, { create: !1 }), {
         kind: "directory",
         size: 0,
         mtime: (/* @__PURE__ */ new Date(0)).toISOString(),
@@ -396,17 +410,17 @@ class T {
    */
   async readDir(t) {
     await this.mount();
-    const e = await this.getDirectoryHandle(t, !1), a = [];
-    for await (const [i, r] of e.entries()) {
+    const e = await this.getDirectoryHandle(t, !1), i = [];
+    for await (const [a, r] of e.entries()) {
       const s = r.kind === "file";
-      a.push({
-        name: i,
+      i.push({
+        name: a,
         kind: r.kind,
         isFile: s,
         isDirectory: !s
       });
     }
-    return a;
+    return i;
   }
   /**
    * Check if a file or directory exists
@@ -425,23 +439,23 @@ class T {
   async exists(t) {
     if (await this.mount(), t === "/")
       return !0;
-    const e = F(t);
-    let a = null;
+    const e = v(t);
+    let i = null;
     try {
-      a = await this.getDirectoryHandle(m(t), !1);
-    } catch (i) {
-      if (a = null, i.name !== "NotFoundError" && i.name !== "TypeMismatchError")
-        throw i;
+      i = await this.getDirectoryHandle(p(t), !1);
+    } catch (a) {
+      if (i = null, a.name !== "NotFoundError" && a.name !== "TypeMismatchError")
+        throw a;
     }
-    if (!a || !e)
+    if (!i || !e)
       return !1;
     try {
-      return await a.getFileHandle(e, { create: !1 }), !0;
-    } catch (i) {
-      if (i.name !== "NotFoundError" && i.name !== "TypeMismatchError")
-        throw i;
+      return await i.getFileHandle(e, { create: !1 }), !0;
+    } catch (a) {
+      if (a.name !== "NotFoundError" && a.name !== "TypeMismatchError")
+        throw a;
       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;
@@ -472,9 +486,9 @@ class T {
     await this.mount();
     try {
       const e = await this.readDir(t);
-      for (const a of e) {
-        const i = `${t === "/" ? "" : t}/${a.name}`;
-        await this.remove(i, { recursive: !0 });
+      for (const i of e) {
+        const a = `${t === "/" ? "" : t}/${i.name}`;
+        await this.remove(a, { recursive: !0 });
       }
       await this.notifyChange({ path: t, type: "changed", isDirectory: !0 });
     } catch (e) {
@@ -508,8 +522,8 @@ class T {
   async remove(t, e) {
     if (await this.mount(), t === "/")
       throw new o("Cannot remove root directory", "EROOT");
-    const { recursive: a = !1, force: i = !1 } = e || {}, r = await this.getDirectoryHandle(m(t), !1);
-    await I(r, t, { recursive: a, force: i }), await this.notifyChange({ path: t, type: "removed", isDirectory: !1 });
+    const { recursive: i = !1, force: a = !1 } = e || {}, r = await this.getDirectoryHandle(p(t), !1);
+    await N(r, t, { recursive: i, force: a }), await this.notifyChange({ path: t, type: "removed", isDirectory: !1 });
   }
   /**
    * Resolve a path to an absolute path
@@ -532,9 +546,9 @@ class T {
   async realpath(t) {
     await this.mount();
     try {
-      const e = H(t);
+      const e = S(t);
       if (!await this.exists(e))
-        throw new f(e);
+        throw new F(e);
       return e;
     } catch (e) {
       throw e instanceof o ? e : new o(`Failed to resolve path: ${t}`, "REALPATH_FAILED", void 0, e);
@@ -562,17 +576,17 @@ class T {
    * await fs.rename('/old/path/file.txt', '/new/path/renamed.txt', { overwrite: true });
    * ```
    */
-  async rename(t, e, a) {
+  async rename(t, e, i) {
     await this.mount();
     try {
-      const i = a?.overwrite ?? !1;
+      const a = i?.overwrite ?? !1;
       if (!await this.exists(t))
-        throw new f(t);
-      if (await this.exists(e) && !i)
+        throw new F(t);
+      if (await this.exists(e) && !a)
         throw new o(`Destination already exists: ${e}`, "EEXIST", void 0);
-      await this.copy(t, e, { recursive: !0, overwrite: i }), await this.remove(t, { recursive: !0 }), await this.notifyChange({ path: t, type: "removed", isDirectory: !1 }), await this.notifyChange({ path: e, type: "added", isDirectory: !1 });
-    } catch (i) {
-      throw i instanceof o ? i : new o(`Failed to rename from ${t} to ${e}`, "RENAME_FAILED", void 0, i);
+      await this.copy(t, e, { recursive: !0, overwrite: a }), await this.remove(t, { recursive: !0 }), await this.notifyChange({ path: t, type: "removed", isDirectory: !1 }), await this.notifyChange({ path: e, type: "added", isDirectory: !1 });
+    } catch (a) {
+      throw a instanceof o ? a : new o(`Failed to rename from ${t} to ${e}`, "RENAME_FAILED", void 0, a);
     }
   }
   /**
@@ -600,10 +614,10 @@ class T {
    * await fs.copy('/source', '/dest', { recursive: true, overwrite: false });
    * ```
    */
-  async copy(t, e, a) {
+  async copy(t, e, i) {
     await this.mount();
     try {
-      const i = a?.recursive ?? !1, r = a?.overwrite ?? !0;
+      const a = i?.recursive ?? !1, r = i?.overwrite ?? !0;
       if (!await this.exists(t))
         throw new o(`Source does not exist: ${t}`, "ENOENT", void 0);
       if (await this.exists(e) && !r)
@@ -612,17 +626,17 @@ class T {
         const l = await this.readFile(t, "binary");
         await this.writeFile(e, l);
       } else {
-        if (!i)
+        if (!a)
           throw new o(`Cannot copy directory without recursive option: ${t}`, "EISDIR", void 0);
         await this.mkdir(e, { recursive: !0 });
         const l = await this.readDir(t);
-        for (const y of l) {
-          const D = `${t}/${y.name}`, E = `${e}/${y.name}`;
-          await this.copy(D, E, { recursive: !0, overwrite: r });
+        for (const h of l) {
+          const f = `${t}/${h.name}`, w = `${e}/${h.name}`;
+          await this.copy(f, w, { recursive: !0, overwrite: r });
         }
       }
-    } catch (i) {
-      throw i instanceof o ? i : new o(`Failed to copy from ${t} to ${e}`, "CP_FAILED", void 0, i);
+    } catch (a) {
+      throw a instanceof o ? a : new o(`Failed to copy from ${t} to ${e}`, "CP_FAILED", void 0, a);
     }
   }
   /**
@@ -653,12 +667,12 @@ class T {
   async watch(t, e) {
     if (!this.options.broadcastChannel)
       throw new o("This instance is not configured to send events. Please specify options.broadcastChannel to enable watching.", "ENOENT");
-    const a = {
-      pattern: $(t, e?.recursive ?? !0),
+    const i = {
+      pattern: P(t, e?.recursive ?? !0),
       include: Array.isArray(e?.include) ? e.include : [e?.include ?? "**"],
       exclude: Array.isArray(e?.exclude) ? e.exclude : [e?.exclude ?? ""]
     };
-    this.watchers.set(t, a);
+    this.watchers.set(t, i);
   }
   /**
    * Stop watching a previously watched path
@@ -666,6 +680,222 @@ class T {
   unwatch(t) {
     this.watchers.delete(t);
   }
+  /**
+   * Open a file and return a file descriptor
+   * 
+   * @param path - The path to the file to open
+   * @param options - Options for opening the file
+   * @param options.create - Whether to create the file if it doesn't exist (default: false)
+   * @param options.exclusive - If true and create is true, fails if file already exists (default: false)
+   *                            Note: This is best-effort in OPFS, not fully atomic due to browser limitations
+   * @param options.truncate - Whether to truncate the file to zero length (default: false)
+   * @returns Promise that resolves to a file descriptor number
+   * @throws {OPFSError} If opening the file fails
+   * 
+   * @example
+   * ```typescript
+   * // Open existing file for reading
+   * const fd = await fs.open('/data/config.json');
+   * 
+   * // Create new file for writing
+   * const fd = await fs.open('/data/new.txt', { create: true });
+   * 
+   * // Create file exclusively (fails if exists)
+   * const fd = await fs.open('/data/unique.txt', { create: true, exclusive: true });
+   * 
+   * // Open and truncate file
+   * const fd = await fs.open('/data/log.txt', { create: true, truncate: true });
+   * ```
+   */
+  async open(t, e) {
+    await this.mount();
+    const { create: i = !1, exclusive: a = !1, truncate: r = !1 } = e || {}, s = u(S(t));
+    try {
+      return i && a ? await _(s, "exclusive", async () => {
+        if (await this.exists(s))
+          throw new o(`File already exists: ${s}`, "EEXIST", s);
+        return this._openFile(s, i, r);
+      }) : await this._openFile(s, i, r);
+    } catch (n) {
+      throw n instanceof o ? n : new o(`Failed to open file: ${s}`, "OPEN_FAILED", s, n);
+    }
+  }
+  /**
+   * Internal method to open a file (without locking)
+   * @private
+   */
+  async _openFile(t, e, i) {
+    const a = await this.getFileHandle(t, e);
+    try {
+      await a.getFile();
+    } catch (n) {
+      throw n.name === "TypeMismatchError" ? new o(`Is a directory: ${t}`, "EISDIR", t) : n;
+    }
+    const r = await k(a, t);
+    i && (r.truncate(0), r.flush());
+    const s = this.nextFd++;
+    return this.openFiles.set(s, {
+      path: t,
+      fileHandle: a,
+      syncHandle: r,
+      position: 0
+    }), s;
+  }
+  /**
+   * Close a file descriptor
+   * 
+   * @param fd - The file descriptor to close
+   * @returns Promise that resolves when the file descriptor is closed
+   * @throws {OPFSError} If the file descriptor is invalid or closing fails
+   * 
+   * @example
+   * ```typescript
+   * const fd = await fs.open('/data/file.txt');
+   * // ... use the file descriptor ...
+   * await fs.close(fd);
+   * ```
+   */
+  async close(t) {
+    const e = this._getFileDescriptor(t);
+    x(t, e.syncHandle, e.path), this.openFiles.delete(t);
+  }
+  /**
+   * Read data from a file descriptor
+   * 
+   * @param fd - The file descriptor to read from
+   * @param buffer - The buffer to read data into
+   * @param offset - The offset in the buffer to start writing at
+   * @param length - The number of bytes to read
+   * @param position - The position in the file to read from (null for current position)
+   * @returns Promise that resolves to the number of bytes read and the modified buffer
+   * @throws {OPFSError} If the file descriptor is invalid or reading fails
+   * 
+   * @note This method uses Comlink.transfer() to efficiently pass the buffer as a Transferable Object,
+   *       ensuring zero-copy performance across Web Worker boundaries.
+   * 
+   * @example
+   * ```typescript
+   * const fd = await fs.open('/data/file.txt');
+   * const buffer = new Uint8Array(1024);
+   * const { bytesRead, buffer: modifiedBuffer } = await fs.read(fd, buffer, 0, 1024, null);
+   * console.log(`Read ${bytesRead} bytes`);
+   * // Use modifiedBuffer which contains the actual data
+   * await fs.close(fd);
+   * ```
+   */
+  async read(t, e, i, a, r) {
+    const s = this._getFileDescriptor(t);
+    I(e.length, i, a, r);
+    try {
+      const n = r ?? s.position, c = s.syncHandle.getSize(), { isEOF: l, actualLength: h } = L(n, a, c);
+      if (l)
+        return D({ bytesRead: 0, buffer: e }, [e.buffer]);
+      const f = e.subarray(i, i + h), w = s.syncHandle.read(f, { at: n });
+      return r === null && (s.position = n + w), D({ bytesRead: w, buffer: e }, [e.buffer]);
+    } catch (n) {
+      throw d("read", t, s.path, n);
+    }
+  }
+  /**
+   * Write data to a file descriptor
+   * 
+   * @param fd - The file descriptor to write to
+   * @param buffer - The buffer containing data to write
+   * @param offset - The offset in the buffer to start reading from (default: 0)
+   * @param length - The number of bytes to write (default: entire buffer)
+   * @param position - The position in the file to write to (null/undefined for current position)
+   * @returns Promise that resolves to the number of bytes written
+   * @throws {OPFSError} If the file descriptor is invalid or writing fails
+   * 
+   * @example
+   * ```typescript
+   * const fd = await fs.open('/data/file.txt', { create: true });
+   * const data = new TextEncoder().encode('Hello, World!');
+   * const bytesWritten = await fs.write(fd, data, 0, data.length, null);
+   * console.log(`Wrote ${bytesWritten} bytes`);
+   * await fs.close(fd);
+   * ```
+   */
+  async write(t, e, i = 0, a, r) {
+    const s = this._getFileDescriptor(t), n = a ?? e.length - i;
+    I(e.length, i, n, r);
+    try {
+      const c = r ?? s.position, l = e.subarray(i, i + n), h = s.syncHandle.write(l, { at: c });
+      return (r == null || r === s.position) && (s.position = c + h), await this.notifyChange({ path: s.path, type: "changed", isDirectory: !1 }), h;
+    } catch (c) {
+      throw d("write", t, s.path, c);
+    }
+  }
+  /**
+   * Get file status information by file descriptor
+   * 
+   * @param fd - The file descriptor
+   * @returns Promise that resolves to FileStat object
+   * @throws {OPFSError} If the file descriptor is invalid
+   * 
+   * @example
+   * ```typescript
+   * const fd = await fs.open('/data/file.txt');
+   * const stats = await fs.fstat(fd);
+   * console.log(`File size: ${stats.size} bytes`);
+   * console.log(`Last modified: ${stats.mtime}`);
+   * 
+   * // If hashing is enabled, hash will be included
+   * if (stats.hash) {
+   *   console.log(`Hash: ${stats.hash}`);
+   * }
+   * ```
+   */
+  async fstat(t) {
+    const e = this._getFileDescriptor(t);
+    return this.stat(e.path);
+  }
+  /**
+   * Truncate file to specified size
+   * 
+   * @param fd - The file descriptor
+   * @param size - The new size of the file (default: 0)
+   * @returns Promise that resolves when truncation is complete
+   * @throws {OPFSError} If the file descriptor is invalid or truncation fails
+   * 
+   * @example
+   * ```typescript
+   * const fd = await fs.open('/data/file.txt', { create: true });
+   * await fs.truncate(fd, 100); // Truncate to 100 bytes
+   * ```
+   */
+  async ftruncate(t, e = 0) {
+    const i = this._getFileDescriptor(t);
+    if (e < 0 || !Number.isInteger(e))
+      throw new o("Invalid size", "EINVAL");
+    try {
+      i.syncHandle.truncate(e), i.syncHandle.flush(), i.position > e && (i.position = e), await this.notifyChange({ path: i.path, type: "changed", isDirectory: !1 });
+    } catch (a) {
+      throw d("truncate", t, i.path, a);
+    }
+  }
+  /**
+   * Synchronize file data to storage (fsync equivalent)
+   * 
+   * @param fd - The file descriptor
+   * @returns Promise that resolves when synchronization is complete
+   * @throws {OPFSError} If the file descriptor is invalid or sync fails
+   * 
+   * @example
+   * ```typescript
+   * const fd = await fs.open('/data/file.txt', { create: true });
+   * await fs.write(fd, data);
+   * await fs.fsync(fd); // Ensure data is written to storage
+   * ```
+   */
+  async fsync(t) {
+    const e = this._getFileDescriptor(t);
+    try {
+      e.syncHandle.flush();
+    } catch (i) {
+      throw d("sync", t, e.path, i);
+    }
+  }
   /**
    * Dispose of resources and clean up the file system instance
    * 
@@ -674,6 +904,9 @@ class T {
    */
   dispose() {
     this.broadcastChannel && (this.broadcastChannel.close(), this.broadcastChannel = null), this.watchers.clear();
+    for (const [t, e] of this.openFiles)
+      x(t, e.syncHandle, e.path);
+    this.openFiles.clear(), this.nextFd = 1;
   }
   /**
    * Synchronize the file system with external data
@@ -707,18 +940,18 @@ class T {
     await this.mount();
     try {
       (e?.cleanBefore ?? !1) && await this.clear("/");
-      for (const [i, r] of t) {
-        const s = u(i);
+      for (const [a, r] of t) {
+        const s = u(a);
         let n;
-        r instanceof Blob ? n = await O(r) : n = r, await this.writeFile(s, n);
+        r instanceof Blob ? n = await z(r) : n = r, await this.writeFile(s, n);
       }
-    } catch (a) {
-      throw a instanceof o ? a : new o("Failed to sync file system", "SYNC_FAILED", void 0, a);
+    } catch (i) {
+      throw i instanceof o ? i : new o("Failed to sync file system", "SYNC_FAILED", void 0, i);
     }
   }
 }
-typeof globalThis < "u" && globalThis.constructor.name === "DedicatedWorkerGlobalScope" && v(new T());
+typeof globalThis < "u" && globalThis.constructor.name === "DedicatedWorkerGlobalScope" && H(new M());
 export {
-  T as OPFSWorker
+  M as OPFSWorker
 };
 //# sourceMappingURL=raw.js.map