@componentor/fs 1.1.7

package/dist/opfs-worker-proxy.d.ts

@@ -0,0 +1,224 @@
+/**
+ * File system constants matching Node.js fs.constants
+ */
+interface FSConstants {
+    F_OK: number;
+    R_OK: number;
+    W_OK: number;
+    X_OK: number;
+    COPYFILE_EXCL: number;
+    COPYFILE_FICLONE: number;
+    COPYFILE_FICLONE_FORCE: number;
+    O_RDONLY: number;
+    O_WRONLY: number;
+    O_RDWR: number;
+    O_CREAT: number;
+    O_EXCL: number;
+    O_TRUNC: number;
+    O_APPEND: number;
+    S_IFMT: number;
+    S_IFREG: number;
+    S_IFDIR: number;
+    S_IFLNK: number;
+}
+/**
+ * Options for readFile operation
+ */
+interface ReadFileOptions {
+    /** Text encoding (e.g., 'utf-8'). If not provided, returns Uint8Array */
+    encoding?: string;
+}
+/**
+ * Options for writeFile operation
+ */
+interface WriteFileOptions {
+    /** Text encoding for string data */
+    encoding?: string;
+}
+/**
+ * Entry for batch file write operation
+ */
+interface BatchWriteEntry {
+    /** File path to write */
+    path: string;
+    /** Data to write (string or binary) */
+    data: string | Uint8Array;
+}
+/**
+ * Result entry for batch file read operation
+ */
+interface BatchReadResult {
+    /** File path */
+    path: string;
+    /** File data (null if file doesn't exist or error occurred) */
+    data: Uint8Array | null;
+    /** Error if read failed */
+    error?: Error;
+}
+/**
+ * Options for readdir operation
+ */
+interface ReaddirOptions {
+    /** Return Dirent objects instead of strings */
+    withFileTypes?: boolean;
+}
+/**
+ * Directory entry (Dirent-like object)
+ */
+interface Dirent {
+    name: string;
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isSymbolicLink(): boolean;
+}
+/**
+ * File statistics
+ */
+interface Stats {
+    type: 'file' | 'dir' | 'symlink';
+    size: number;
+    mode: number;
+    ctime: Date;
+    ctimeMs: number;
+    mtime: Date;
+    mtimeMs: number;
+    target?: string;
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isSymbolicLink(): boolean;
+}
+/**
+ * Options for rm operation
+ */
+interface RmOptions {
+    /** Remove directories and their contents recursively */
+    recursive?: boolean;
+    /** Ignore if path doesn't exist */
+    force?: boolean;
+}
+/**
+ * Options for cp operation
+ */
+interface CpOptions {
+    /** Copy directories recursively */
+    recursive?: boolean;
+    /** Overwrite existing files */
+    force?: boolean;
+    /** Throw if destination exists */
+    errorOnExist?: boolean;
+}
+/**
+ * Symlink definition for batch operations
+ */
+interface SymlinkDefinition {
+    target: string;
+    path: string;
+}
+/**
+ * Disk usage result
+ */
+interface DiskUsage {
+    path: string;
+    size: number;
+}
+/**
+ * Filesystem statistics (similar to Node.js fs.statfs)
+ */
+interface StatFs {
+    /** Filesystem type (always 0 for OPFS) */
+    type: number;
+    /** Optimal transfer block size (simulated as 4096) */
+    bsize: number;
+    /** Total blocks in filesystem */
+    blocks: number;
+    /** Free blocks in filesystem */
+    bfree: number;
+    /** Available blocks for unprivileged users */
+    bavail: number;
+    /** Total file nodes (0 - not available in browser) */
+    files: number;
+    /** Free file nodes (0 - not available in browser) */
+    ffree: number;
+    /** Bytes used by origin (from Storage API) */
+    usage: number;
+    /** Total bytes available to origin (from Storage API) */
+    quota: number;
+}
+
+interface OPFSWorkerOptions {
+    /** URL to the worker script (default: auto-detect) */
+    workerUrl?: string | URL;
+    /** Worker initialization options */
+    workerOptions?: WorkerOptions;
+}
+/**
+ * OPFS Worker Proxy - runs OPFS operations in a Web Worker
+ *
+ * Benefits:
+ * - Non-blocking main thread
+ * - Uses sync access handles (faster) in the worker
+ * - Compatible with libraries that reuse buffers (e.g., isomorphic-git)
+ */
+declare class OPFSWorker {
+    private worker;
+    private pendingRequests;
+    private nextId;
+    private readyPromise;
+    private readyResolve;
+    /** File system constants */
+    readonly constants: FSConstants;
+    constructor(options?: OPFSWorkerOptions);
+    private initWorker;
+    /**
+     * Wait for the worker to be ready
+     */
+    ready(): Promise<void>;
+    /**
+     * Terminate the worker
+     */
+    terminate(): void;
+    private call;
+    readFile(path: string, options?: ReadFileOptions): Promise<string | Uint8Array>;
+    writeFile(path: string, data: string | Uint8Array, options?: WriteFileOptions): Promise<void>;
+    readFileBatch(paths: string[]): Promise<BatchReadResult[]>;
+    writeFileBatch(entries: BatchWriteEntry[]): Promise<void>;
+    appendFile(path: string, data: string | Uint8Array, options?: WriteFileOptions): Promise<void>;
+    copyFile(src: string, dest: string, mode?: number): Promise<void>;
+    unlink(path: string): Promise<void>;
+    truncate(path: string, len?: number): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    rmdir(path: string): Promise<void>;
+    readdir(path: string, options?: ReaddirOptions): Promise<string[] | Dirent[]>;
+    cp(src: string, dest: string, options?: CpOptions): Promise<void>;
+    rm(path: string, options?: RmOptions): Promise<void>;
+    stat(path: string): Promise<Stats>;
+    lstat(path: string): Promise<Stats>;
+    private deserializeStats;
+    exists(path: string): Promise<boolean>;
+    access(path: string, mode?: number): Promise<void>;
+    statfs(path?: string): Promise<StatFs>;
+    du(path: string): Promise<DiskUsage>;
+    symlink(target: string, path: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    symlinkBatch(links: SymlinkDefinition[]): Promise<void>;
+    realpath(path: string): Promise<string>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    mkdtemp(prefix: string): Promise<string>;
+    chmod(path: string, mode: number): Promise<void>;
+    chown(path: string, uid: number, gid: number): Promise<void>;
+    utimes(path: string, atime: Date | number, mtime: Date | number): Promise<void>;
+    lutimes(path: string, atime: Date | number, mtime: Date | number): Promise<void>;
+    /**
+     * Reset internal caches to free memory
+     * Useful for long-running benchmarks or after bulk operations
+     */
+    resetCache(): Promise<void>;
+    /**
+     * Force full garbage collection by reinitializing the OPFS instance in the worker
+     * This completely releases all handles and caches, preventing memory leaks in long-running operations
+     * More aggressive than resetCache() - use when resetCache() isn't sufficient
+     */
+    gc(): Promise<void>;
+}
+
+export { OPFSWorker, type OPFSWorkerOptions };

package/dist/opfs-worker-proxy.js

@@ -0,0 +1,274 @@
+// src/constants.ts
+var constants = {
+  // File access modes
+  F_OK: 0,
+  R_OK: 4,
+  W_OK: 2,
+  X_OK: 1,
+  // Copy file flags
+  COPYFILE_EXCL: 1,
+  COPYFILE_FICLONE: 2,
+  COPYFILE_FICLONE_FORCE: 4,
+  // File open flags
+  O_RDONLY: 0,
+  O_WRONLY: 1,
+  O_RDWR: 2,
+  O_CREAT: 64,
+  O_EXCL: 128,
+  O_TRUNC: 512,
+  O_APPEND: 1024,
+  // File type masks
+  S_IFMT: 61440,
+  S_IFREG: 32768,
+  S_IFDIR: 16384,
+  S_IFLNK: 40960
+};
+
+// src/errors.ts
+var FSError = class extends Error {
+  code;
+  syscall;
+  path;
+  original;
+  constructor(message, code, options) {
+    super(message);
+    this.name = "FSError";
+    this.code = code;
+    this.syscall = options?.syscall;
+    this.path = options?.path;
+    this.original = options?.original;
+  }
+};
+
+// src/opfs-worker-proxy.ts
+var OPFSWorker = class {
+  worker = null;
+  pendingRequests = /* @__PURE__ */ new Map();
+  nextId = 1;
+  readyPromise;
+  readyResolve;
+  /** File system constants */
+  constants = constants;
+  constructor(options = {}) {
+    this.readyPromise = new Promise((resolve) => {
+      this.readyResolve = resolve;
+    });
+    this.initWorker(options);
+  }
+  initWorker(options) {
+    const { workerUrl, workerOptions = { type: "module" } } = options;
+    if (workerUrl) {
+      this.worker = new Worker(workerUrl, workerOptions);
+    } else {
+      throw new Error(
+        'OPFSWorker requires a workerUrl option pointing to the worker script. Example: new OPFSWorker({ workerUrl: new URL("./opfs-worker.js", import.meta.url) })'
+      );
+    }
+    this.worker.onmessage = (event) => {
+      const { id, type, result, error } = event.data;
+      if (type === "ready") {
+        this.readyResolve();
+        return;
+      }
+      if (id !== void 0) {
+        const pending = this.pendingRequests.get(id);
+        if (pending) {
+          this.pendingRequests.delete(id);
+          if (error) {
+            const fsError = new FSError(error.message, error.code || "UNKNOWN");
+            pending.reject(fsError);
+          } else {
+            pending.resolve(result);
+          }
+        }
+      }
+    };
+    this.worker.onerror = (event) => {
+      console.error("[OPFSWorker] Worker error:", event);
+    };
+  }
+  /**
+   * Wait for the worker to be ready
+   */
+  async ready() {
+    return this.readyPromise;
+  }
+  /**
+   * Terminate the worker
+   */
+  terminate() {
+    if (this.worker) {
+      this.worker.terminate();
+      this.worker = null;
+      for (const [, pending] of this.pendingRequests) {
+        pending.reject(new Error("Worker terminated"));
+      }
+      this.pendingRequests.clear();
+    }
+  }
+  call(method, args, transfer) {
+    return new Promise((resolve, reject) => {
+      if (!this.worker) {
+        reject(new Error("Worker not initialized or terminated"));
+        return;
+      }
+      const id = this.nextId++;
+      this.pendingRequests.set(id, {
+        resolve,
+        reject
+      });
+      const message = { id, method, args };
+      if (transfer && transfer.length > 0) {
+        this.worker.postMessage(message, transfer);
+      } else {
+        this.worker.postMessage(message);
+      }
+    });
+  }
+  // File operations
+  async readFile(path, options) {
+    const result = await this.call("readFile", [path, options]);
+    return result;
+  }
+  async writeFile(path, data, options) {
+    await this.call("writeFile", [path, data, options]);
+  }
+  async readFileBatch(paths) {
+    return this.call("readFileBatch", [paths]);
+  }
+  async writeFileBatch(entries) {
+    await this.call("writeFileBatch", [entries]);
+  }
+  async appendFile(path, data, options) {
+    await this.call("appendFile", [path, data, options]);
+  }
+  async copyFile(src, dest, mode) {
+    await this.call("copyFile", [src, dest, mode]);
+  }
+  async unlink(path) {
+    await this.call("unlink", [path]);
+  }
+  async truncate(path, len) {
+    await this.call("truncate", [path, len]);
+  }
+  // Directory operations
+  async mkdir(path) {
+    await this.call("mkdir", [path]);
+  }
+  async rmdir(path) {
+    await this.call("rmdir", [path]);
+  }
+  async readdir(path, options) {
+    const result = await this.call("readdir", [path, options]);
+    if (options?.withFileTypes && Array.isArray(result)) {
+      return result.map((item) => {
+        if (typeof item === "object" && "name" in item) {
+          const entry = item;
+          return {
+            name: entry.name,
+            isFile: () => entry._isFile ?? false,
+            isDirectory: () => entry._isDir ?? false,
+            isSymbolicLink: () => entry._isSymlink ?? false
+          };
+        }
+        return item;
+      });
+    }
+    return result;
+  }
+  async cp(src, dest, options) {
+    await this.call("cp", [src, dest, options]);
+  }
+  async rm(path, options) {
+    await this.call("rm", [path, options]);
+  }
+  // Stat operations
+  async stat(path) {
+    const result = await this.call("stat", [path]);
+    return this.deserializeStats(result);
+  }
+  async lstat(path) {
+    const result = await this.call("lstat", [path]);
+    return this.deserializeStats(result);
+  }
+  deserializeStats(data) {
+    const ctime = new Date(data.ctime);
+    const mtime = new Date(data.mtime);
+    return {
+      type: data.type,
+      size: data.size,
+      mode: data.mode,
+      ctime,
+      ctimeMs: data.ctimeMs,
+      mtime,
+      mtimeMs: data.mtimeMs,
+      target: data.target,
+      isFile: () => data.type === "file",
+      isDirectory: () => data.type === "dir",
+      isSymbolicLink: () => data.type === "symlink"
+    };
+  }
+  async exists(path) {
+    return this.call("exists", [path]);
+  }
+  async access(path, mode) {
+    await this.call("access", [path, mode]);
+  }
+  async statfs(path) {
+    return this.call("statfs", [path]);
+  }
+  async du(path) {
+    return this.call("du", [path]);
+  }
+  // Symlink operations
+  async symlink(target, path) {
+    await this.call("symlink", [target, path]);
+  }
+  async readlink(path) {
+    return this.call("readlink", [path]);
+  }
+  async symlinkBatch(links) {
+    await this.call("symlinkBatch", [links]);
+  }
+  async realpath(path) {
+    return this.call("realpath", [path]);
+  }
+  // Other operations
+  async rename(oldPath, newPath) {
+    await this.call("rename", [oldPath, newPath]);
+  }
+  async mkdtemp(prefix) {
+    return this.call("mkdtemp", [prefix]);
+  }
+  async chmod(path, mode) {
+    await this.call("chmod", [path, mode]);
+  }
+  async chown(path, uid, gid) {
+    await this.call("chown", [path, uid, gid]);
+  }
+  async utimes(path, atime, mtime) {
+    await this.call("utimes", [path, atime, mtime]);
+  }
+  async lutimes(path, atime, mtime) {
+    await this.call("lutimes", [path, atime, mtime]);
+  }
+  /**
+   * Reset internal caches to free memory
+   * Useful for long-running benchmarks or after bulk operations
+   */
+  async resetCache() {
+    await this.call("resetCache", []);
+  }
+  /**
+   * Force full garbage collection by reinitializing the OPFS instance in the worker
+   * This completely releases all handles and caches, preventing memory leaks in long-running operations
+   * More aggressive than resetCache() - use when resetCache() isn't sufficient
+   */
+  async gc() {
+    await this.call("gc", []);
+  }
+};
+
+export { OPFSWorker };
+//# sourceMappingURL=opfs-worker-proxy.js.map
+//# sourceMappingURL=opfs-worker-proxy.js.map

package/dist/opfs-worker-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/errors.ts","../src/opfs-worker-proxy.ts"],"names":[],"mappings":"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","file":"opfs-worker-proxy.js","sourcesContent":["import type { FSConstants } from './types.js'\n\n/**\n * File system constants matching Node.js fs.constants\n */\nexport const constants: FSConstants = {\n  // File access modes\n  F_OK: 0,\n  R_OK: 4,\n  W_OK: 2,\n  X_OK: 1,\n\n  // Copy file flags\n  COPYFILE_EXCL: 1,\n  COPYFILE_FICLONE: 2,\n  COPYFILE_FICLONE_FORCE: 4,\n\n  // File open flags\n  O_RDONLY: 0,\n  O_WRONLY: 1,\n  O_RDWR: 2,\n  O_CREAT: 64,\n  O_EXCL: 128,\n  O_TRUNC: 512,\n  O_APPEND: 1024,\n\n  // File type masks\n  S_IFMT: 61440,\n  S_IFREG: 32768,\n  S_IFDIR: 16384,\n  S_IFLNK: 40960\n}\n\n/**\n * Convert numeric flags to string representation\n */\nexport function flagsToString(flags: number | string): string {\n  if (typeof flags === 'string') return flags\n\n  const map: Record<number, string> = {\n    [constants.O_RDONLY]: 'r',\n    [constants.O_WRONLY]: 'w',\n    [constants.O_RDWR]: 'r+',\n    [constants.O_CREAT | constants.O_WRONLY]: 'w',\n    [constants.O_CREAT | constants.O_WRONLY | constants.O_TRUNC]: 'w',\n    [constants.O_CREAT | constants.O_RDWR]: 'w+',\n    [constants.O_APPEND | constants.O_WRONLY]: 'a',\n    [constants.O_APPEND | constants.O_RDWR]: 'a+'\n  }\n\n  return map[flags] || 'r'\n}\n","/**\n * Custom error class for filesystem errors\n */\nexport class FSError extends Error {\n  code: string\n  syscall?: string\n  path?: string\n  original?: Error\n\n  constructor(message: string, code: string, options?: { syscall?: string; path?: string; original?: Error }) {\n    super(message)\n    this.name = 'FSError'\n    this.code = code\n    this.syscall = options?.syscall\n    this.path = options?.path\n    this.original = options?.original\n  }\n}\n\n/**\n * Create ENOENT (No such file or directory) error\n */\nexport function createENOENT(path: string): FSError {\n  return new FSError(`ENOENT: No such file or directory, '${path}'`, 'ENOENT', { path })\n}\n\n/**\n * Create EEXIST (File exists) error\n */\nexport function createEEXIST(path: string, operation?: string): FSError {\n  const message = operation\n    ? `EEXIST: file already exists, ${operation} '${path}'`\n    : `EEXIST: File exists, '${path}'`\n  return new FSError(message, 'EEXIST', { path })\n}\n\n/**\n * Create EACCES (Permission denied) error\n */\nexport function createEACCES(path: string, syscall?: string): FSError {\n  return new FSError(`EACCES: permission denied, access '${path}'`, 'EACCES', { syscall, path })\n}\n\n/**\n * Create EISDIR (Is a directory) error\n */\nexport function createEISDIR(path: string, operation = 'operation'): FSError {\n  return new FSError(`EISDIR: illegal operation on a directory, ${operation} '${path}'`, 'EISDIR', { path })\n}\n\n/**\n * Create ELOOP (Too many symbolic links) error\n */\nexport function createELOOP(path: string): FSError {\n  return new FSError(`ELOOP: Too many symbolic links, '${path}'`, 'ELOOP', { path })\n}\n\n/**\n * Create EINVAL (Invalid argument) error\n */\nexport function createEINVAL(path: string): FSError {\n  return new FSError(`EINVAL: Invalid argument, '${path}'`, 'EINVAL', { path })\n}\n\n/**\n * Create ECORRUPTED (Data corruption detected) error\n */\nexport function createECORRUPTED(path: string): FSError {\n  return new FSError(`ECORRUPTED: Pack file integrity check failed, '${path}'`, 'ECORRUPTED', { path })\n}\n\n/**\n * Wrap an error with a standard code if it doesn't have one\n */\nexport function wrapError(err: unknown): FSError {\n  if (err instanceof FSError) return err\n\n  const error = err as Error\n  if (typeof (error as FSError).code === 'string') {\n    const fsErr = new FSError(error.message, (error as FSError).code)\n    fsErr.original = error\n    return fsErr\n  }\n\n  const wrapped = new FSError(error.message || 'Unknown error', 'UNKNOWN')\n  wrapped.original = error\n  return wrapped\n}\n","/**\n * OPFS Worker Proxy\n * Main thread class that communicates with an OPFS worker\n *\n * This allows non-blocking OPFS operations on the main thread\n * while the actual work happens in a dedicated Web Worker\n */\n\nimport type {\n  ReadFileOptions,\n  WriteFileOptions,\n  BatchWriteEntry,\n  BatchReadResult,\n  ReaddirOptions,\n  Dirent,\n  Stats,\n  StatFs,\n  RmOptions,\n  CpOptions,\n  DiskUsage,\n  SymlinkDefinition\n} from './types.js'\nimport { constants } from './constants.js'\nimport { FSError } from './errors.js'\n\ninterface PendingRequest {\n  resolve: (value: unknown) => void\n  reject: (error: Error) => void\n}\n\ninterface WorkerResponse {\n  id?: number\n  type?: string\n  result?: unknown\n  error?: { message: string; code?: string }\n}\n\nexport interface OPFSWorkerOptions {\n  /** URL to the worker script (default: auto-detect) */\n  workerUrl?: string | URL\n  /** Worker initialization options */\n  workerOptions?: WorkerOptions\n}\n\n/**\n * OPFS Worker Proxy - runs OPFS operations in a Web Worker\n *\n * Benefits:\n * - Non-blocking main thread\n * - Uses sync access handles (faster) in the worker\n * - Compatible with libraries that reuse buffers (e.g., isomorphic-git)\n */\nexport class OPFSWorker {\n  private worker: Worker | null = null\n  private pendingRequests = new Map<number, PendingRequest>()\n  private nextId = 1\n  private readyPromise: Promise<void>\n  private readyResolve!: () => void\n\n  /** File system constants */\n  public readonly constants = constants\n\n  constructor(options: OPFSWorkerOptions = {}) {\n    this.readyPromise = new Promise((resolve) => {\n      this.readyResolve = resolve\n    })\n\n    this.initWorker(options)\n  }\n\n  private initWorker(options: OPFSWorkerOptions): void {\n    const { workerUrl, workerOptions = { type: 'module' } } = options\n\n    if (workerUrl) {\n      this.worker = new Worker(workerUrl, workerOptions)\n    } else {\n      // Try to create worker from the bundled script\n      // Users should provide workerUrl in production\n      throw new Error(\n        'OPFSWorker requires a workerUrl option pointing to the worker script. ' +\n        'Example: new OPFSWorker({ workerUrl: new URL(\"./opfs-worker.js\", import.meta.url) })'\n      )\n    }\n\n    this.worker.onmessage = (event: MessageEvent<WorkerResponse>) => {\n      const { id, type, result, error } = event.data\n\n      // Handle ready signal\n      if (type === 'ready') {\n        this.readyResolve()\n        return\n      }\n\n      // Handle response to a request\n      if (id !== undefined) {\n        const pending = this.pendingRequests.get(id)\n        if (pending) {\n          this.pendingRequests.delete(id)\n          if (error) {\n            const fsError = new FSError(error.message, error.code || 'UNKNOWN')\n            pending.reject(fsError)\n          } else {\n            pending.resolve(result)\n          }\n        }\n      }\n    }\n\n    this.worker.onerror = (event) => {\n      console.error('[OPFSWorker] Worker error:', event)\n    }\n  }\n\n  /**\n   * Wait for the worker to be ready\n   */\n  async ready(): Promise<void> {\n    return this.readyPromise\n  }\n\n  /**\n   * Terminate the worker\n   */\n  terminate(): void {\n    if (this.worker) {\n      this.worker.terminate()\n      this.worker = null\n\n      // Reject all pending requests\n      for (const [, pending] of this.pendingRequests) {\n        pending.reject(new Error('Worker terminated'))\n      }\n      this.pendingRequests.clear()\n    }\n  }\n\n  private call<T>(method: string, args: unknown[], transfer?: Transferable[]): Promise<T> {\n    return new Promise((resolve, reject) => {\n      if (!this.worker) {\n        reject(new Error('Worker not initialized or terminated'))\n        return\n      }\n\n      const id = this.nextId++\n      this.pendingRequests.set(id, {\n        resolve: resolve as (value: unknown) => void,\n        reject\n      })\n\n      const message = { id, method, args }\n      if (transfer && transfer.length > 0) {\n        this.worker.postMessage(message, transfer)\n      } else {\n        this.worker.postMessage(message)\n      }\n    })\n  }\n\n  // File operations\n\n  async readFile(path: string, options?: ReadFileOptions): Promise<string | Uint8Array> {\n    const result = await this.call<string | Uint8Array>('readFile', [path, options])\n    return result\n  }\n\n  async writeFile(path: string, data: string | Uint8Array, options?: WriteFileOptions): Promise<void> {\n    // Note: We don't use Transferables here because the caller may reuse the buffer\n    // (e.g., isomorphic-git reuses buffers). Structured cloning copies the data.\n    await this.call<void>('writeFile', [path, data, options])\n  }\n\n  async readFileBatch(paths: string[]): Promise<BatchReadResult[]> {\n    return this.call<BatchReadResult[]>('readFileBatch', [paths])\n  }\n\n  async writeFileBatch(entries: BatchWriteEntry[]): Promise<void> {\n    // Note: We don't use Transferables here because the caller may reuse the buffers\n    await this.call<void>('writeFileBatch', [entries])\n  }\n\n  async appendFile(path: string, data: string | Uint8Array, options?: WriteFileOptions): Promise<void> {\n    // Note: We don't use Transferables here because the caller may reuse the buffer\n    await this.call<void>('appendFile', [path, data, options])\n  }\n\n  async copyFile(src: string, dest: string, mode?: number): Promise<void> {\n    await this.call<void>('copyFile', [src, dest, mode])\n  }\n\n  async unlink(path: string): Promise<void> {\n    await this.call<void>('unlink', [path])\n  }\n\n  async truncate(path: string, len?: number): Promise<void> {\n    await this.call<void>('truncate', [path, len])\n  }\n\n  // Directory operations\n\n  async mkdir(path: string): Promise<void> {\n    await this.call<void>('mkdir', [path])\n  }\n\n  async rmdir(path: string): Promise<void> {\n    await this.call<void>('rmdir', [path])\n  }\n\n  async readdir(path: string, options?: ReaddirOptions): Promise<string[] | Dirent[]> {\n    const result = await this.call<string[] | { name: string }[]>('readdir', [path, options])\n\n    // Reconstruct Dirent objects with methods\n    if (options?.withFileTypes && Array.isArray(result)) {\n      return result.map((item) => {\n        if (typeof item === 'object' && 'name' in item) {\n          const entry = item as { name: string; _isFile?: boolean; _isDir?: boolean; _isSymlink?: boolean }\n          return {\n            name: entry.name,\n            isFile: () => entry._isFile ?? false,\n            isDirectory: () => entry._isDir ?? false,\n            isSymbolicLink: () => entry._isSymlink ?? false\n          }\n        }\n        return item as unknown as Dirent\n      })\n    }\n\n    return result as string[]\n  }\n\n  async cp(src: string, dest: string, options?: CpOptions): Promise<void> {\n    await this.call<void>('cp', [src, dest, options])\n  }\n\n  async rm(path: string, options?: RmOptions): Promise<void> {\n    await this.call<void>('rm', [path, options])\n  }\n\n  // Stat operations\n\n  async stat(path: string): Promise<Stats> {\n    const result = await this.call<{\n      type: string\n      size: number\n      mode: number\n      ctime: string\n      ctimeMs: number\n      mtime: string\n      mtimeMs: number\n      target?: string\n    }>('stat', [path])\n\n    return this.deserializeStats(result)\n  }\n\n  async lstat(path: string): Promise<Stats> {\n    const result = await this.call<{\n      type: string\n      size: number\n      mode: number\n      ctime: string\n      ctimeMs: number\n      mtime: string\n      mtimeMs: number\n      target?: string\n    }>('lstat', [path])\n\n    return this.deserializeStats(result)\n  }\n\n  private deserializeStats(data: {\n    type: string\n    size: number\n    mode: number\n    ctime: string\n    ctimeMs: number\n    mtime: string\n    mtimeMs: number\n    target?: string\n  }): Stats {\n    const ctime = new Date(data.ctime)\n    const mtime = new Date(data.mtime)\n\n    return {\n      type: data.type as 'file' | 'dir' | 'symlink',\n      size: data.size,\n      mode: data.mode,\n      ctime,\n      ctimeMs: data.ctimeMs,\n      mtime,\n      mtimeMs: data.mtimeMs,\n      target: data.target,\n      isFile: () => data.type === 'file',\n      isDirectory: () => data.type === 'dir',\n      isSymbolicLink: () => data.type === 'symlink'\n    }\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.call<boolean>('exists', [path])\n  }\n\n  async access(path: string, mode?: number): Promise<void> {\n    await this.call<void>('access', [path, mode])\n  }\n\n  async statfs(path?: string): Promise<StatFs> {\n    return this.call<StatFs>('statfs', [path])\n  }\n\n  async du(path: string): Promise<DiskUsage> {\n    return this.call<DiskUsage>('du', [path])\n  }\n\n  // Symlink operations\n\n  async symlink(target: string, path: string): Promise<void> {\n    await this.call<void>('symlink', [target, path])\n  }\n\n  async readlink(path: string): Promise<string> {\n    return this.call<string>('readlink', [path])\n  }\n\n  async symlinkBatch(links: SymlinkDefinition[]): Promise<void> {\n    await this.call<void>('symlinkBatch', [links])\n  }\n\n  async realpath(path: string): Promise<string> {\n    return this.call<string>('realpath', [path])\n  }\n\n  // Other operations\n\n  async rename(oldPath: string, newPath: string): Promise<void> {\n    await this.call<void>('rename', [oldPath, newPath])\n  }\n\n  async mkdtemp(prefix: string): Promise<string> {\n    return this.call<string>('mkdtemp', [prefix])\n  }\n\n  async chmod(path: string, mode: number): Promise<void> {\n    await this.call<void>('chmod', [path, mode])\n  }\n\n  async chown(path: string, uid: number, gid: number): Promise<void> {\n    await this.call<void>('chown', [path, uid, gid])\n  }\n\n  async utimes(path: string, atime: Date | number, mtime: Date | number): Promise<void> {\n    await this.call<void>('utimes', [path, atime, mtime])\n  }\n\n  async lutimes(path: string, atime: Date | number, mtime: Date | number): Promise<void> {\n    await this.call<void>('lutimes', [path, atime, mtime])\n  }\n\n  /**\n   * Reset internal caches to free memory\n   * Useful for long-running benchmarks or after bulk operations\n   */\n  async resetCache(): Promise<void> {\n    await this.call<void>('resetCache', [])\n  }\n\n  /**\n   * Force full garbage collection by reinitializing the OPFS instance in the worker\n   * This completely releases all handles and caches, preventing memory leaks in long-running operations\n   * More aggressive than resetCache() - use when resetCache() isn't sufficient\n   */\n  async gc(): Promise<void> {\n    await this.call<void>('gc', [])\n  }\n}\n"]}