shell-dsl 0.0.34 → 0.0.35

package/README.md

@@ -748,7 +748,7 @@ const fs = new FileSystem("/", {}, createWebUnderlyingFS(root));
 
 ## Version Control
 
-`VersionControlSystem` adds git-like version control to any `VirtualFS`. It tracks changes as diffs, supports branching, and stores metadata in a `.vcs` directory.
+`VersionControlSystem` adds git-like version control to any `VirtualFS`. It tracks revisions as lightweight tree manifests, stores file bytes in a content-addressed blob store under `.vcs`, and supports branching, checkout, and metadata-plus-patch diffs.
 
 Ignore and attribute rules are configured directly on the constructor:
 
@@ -780,7 +780,7 @@ Ignore patterns apply only to untracked paths:
 - Files already tracked by VCS remain tracked even if they later match an ignore rule
 - Full `checkout()` preserves ignored untracked files
 
-Attribute rules are applied in declaration order, with later matches winning. Supported properties:
+Attribute rules are applied in declaration order, with later matches winning. By default, VCS auto-detects text vs binary content from the file bytes and only generates unified text patches for text files up to 1 MiB. Supported properties:
 
 - `binary?: boolean`
 - `diff?: "text" | "binary" | "none"`
@@ -804,10 +804,17 @@ const changes = await vcs.status();
 for (const entry of changes) {
   console.log(entry.type, entry.path, entry.diff, entry.binary);
   // "add" | "modify" | "delete", "text" | "binary" | "none", boolean
+
+  if (entry.patch) {
+    console.log(entry.patch);
+  } else {
+    console.log(entry.patchSuppressedReason);
+    // "binary" | "none" | "too-large"
+  }
 }
 ```
 
-When `diff` is `"none"`, the entry still reports the path and change type, but omits `content` and `previousContent`.
+Each file entry includes `blobId` and `previousBlobId` when applicable. Text diffs are returned as unified patches in `patch`; binary files, `diff: "none"` paths, and oversized text files return metadata only with `patchSuppressedReason`.
 
 ### Checkout
 
@@ -850,11 +857,17 @@ for (const entry of diff) {
   console.log(entry.type, entry.path, entry.diff);
 }
 
+// Read stored file bytes lazily
+const readme = await vcs.readRevisionFile(2, "README.md", "utf8");
+const blob = await vcs.readBlob(diff[0]!.blobId!);
+
 // Current HEAD info
 const head = await vcs.head();
 // { branch: "main", revision: 2 }
 ```
 
+Blob objects are deduplicated by SHA-256, so replacing a large file stores a new blob only when the content changes instead of embedding the full file in every revision record.
+
 ### Separate VCS Storage
 
 By default, metadata lives in `{path}/.vcs`. You can store it on a different filesystem:

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.34",
+  "version": "0.0.35",
   "type": "commonjs"
 }

package/dist/cjs/src/fs/memfs-adapter.cjs

@@ -80,6 +80,17 @@ function createVirtualFS(memfs) {
       const buf = Buffer.from(content);
       return encoding ? buf.toString(encoding) : buf;
     },
+    readStream(path) {
+      if (import_special_files.isDevNullPath(path)) {
+        return emptyIterable();
+      }
+      return {
+        async* [Symbol.asyncIterator]() {
+          const content = await fs.readFile(path);
+          yield Buffer.from(content);
+        }
+      };
+    },
     async readdir(path) {
       const specialError = import_special_files.getSpecialPathError(path, "readdir");
       if (specialError)
@@ -96,7 +107,8 @@ function createVirtualFS(memfs) {
         isFile: () => stats.isFile(),
         isDirectory: () => stats.isDirectory(),
         size: Number(stats.size),
-        mtime: new Date(stats.mtime)
+        mtime: new Date(stats.mtime),
+        mtimeMs: Number(stats.mtimeMs ?? stats.mtime)
       };
     },
     async exists(path) {
@@ -122,6 +134,36 @@ function createVirtualFS(memfs) {
       }
       await fs.appendFile(path, data);
     },
+    async writeStream(path, opts) {
+      if (import_special_files.discardsSpecialFileWrites(path)) {
+        return createDiscardingWritable();
+      }
+      const chunks = [];
+      let closed = false;
+      return {
+        async write(chunk) {
+          if (closed) {
+            throw new Error("stream is closed");
+          }
+          chunks.push(Buffer.from(chunk));
+        },
+        async close() {
+          if (closed)
+            return;
+          closed = true;
+          const data = Buffer.concat(chunks.map((chunk) => Buffer.from(chunk)));
+          if (opts?.append) {
+            await fs.appendFile(path, data);
+          } else {
+            await fs.writeFile(path, data);
+          }
+        },
+        async abort(_reason) {
+          closed = true;
+          chunks.length = 0;
+        }
+      };
+    },
     async mkdir(path, opts) {
       const specialError = import_special_files.getSpecialPathError(path, "mkdir");
       if (specialError)
@@ -163,5 +205,17 @@ function createVirtualFS(memfs) {
     }
   };
 }
+function emptyIterable() {
+  return {
+    async* [Symbol.asyncIterator]() {}
+  };
+}
+function createDiscardingWritable() {
+  return {
+    async write(_chunk) {},
+    async close() {},
+    async abort(_reason) {}
+  };
+}
 
-//# debugId=F25975C12E3475B564756E2164756E21
+//# debugId=238F7B043514ECF264756E2164756E21

package/dist/cjs/src/fs/memfs-adapter.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/memfs-adapter.ts"],
   "sourcesContent": [
-    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\nimport * as pathModule from \"path\";\nimport { globVirtualFS } from \"../utils/glob.cjs\";\nimport {\n  discardsSpecialFileWrites,\n  existsSpecialFile,\n  getSpecialPathError,\n  readSpecialFile,\n  statSpecialFile,\n} from \"./special-files.cjs\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    readFile: (async (path: string, encoding?: BufferEncoding): Promise<Buffer | string> => {\n      const specialContent = readSpecialFile(path, encoding);\n      if (specialContent !== undefined) return specialContent;\n      const content = await fs.readFile(path);\n      const buf = Buffer.from(content);\n      return encoding ? buf.toString(encoding) : buf;\n    }) as VirtualFS[\"readFile\"],\n\n    async readdir(path: string): Promise<string[]> {\n      const specialError = getSpecialPathError(path, \"readdir\");\n      if (specialError) throw specialError;\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const specialStat = statSpecialFile(path);\n      if (specialStat) return specialStat;\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      const specialExists = existsSpecialFile(path);\n      if (specialExists !== undefined) return specialExists;\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      if (discardsSpecialFileWrites(path)) {\n        return;\n      }\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      if (discardsSpecialFileWrites(path)) {\n        return;\n      }\n      await fs.appendFile(path, data);\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      const specialError = getSpecialPathError(path, \"mkdir\");\n      if (specialError) throw specialError;\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      const specialError = getSpecialPathError(path, \"rm\");\n      if (specialError) throw specialError;\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return globVirtualFS(\n        {\n          readdir: (filePath: string) => this.readdir(filePath),\n          stat: (filePath: string) => this.stat(filePath),\n          resolve: (...paths: string[]) => this.resolve(...paths),\n        },\n        pattern,\n        { cwd }\n      );\n    },\n  };\n}\n"
+    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, VirtualFSWritable, FileStat } from \"../types.cjs\";\nimport * as pathModule from \"path\";\nimport { globVirtualFS } from \"../utils/glob.cjs\";\nimport {\n  discardsSpecialFileWrites,\n  existsSpecialFile,\n  getSpecialPathError,\n  isDevNullPath,\n  readSpecialFile,\n  statSpecialFile,\n} from \"./special-files.cjs\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    readFile: (async (path: string, encoding?: BufferEncoding): Promise<Buffer | string> => {\n      const specialContent = readSpecialFile(path, encoding);\n      if (specialContent !== undefined) return specialContent;\n      const content = await fs.readFile(path);\n      const buf = Buffer.from(content);\n      return encoding ? buf.toString(encoding) : buf;\n    }) as VirtualFS[\"readFile\"],\n\n    readStream(path: string): AsyncIterable<Uint8Array> {\n      if (isDevNullPath(path)) {\n        return emptyIterable();\n      }\n      return {\n        async *[Symbol.asyncIterator]() {\n          const content = await fs.readFile(path);\n          yield Buffer.from(content);\n        },\n      };\n    },\n\n    async readdir(path: string): Promise<string[]> {\n      const specialError = getSpecialPathError(path, \"readdir\");\n      if (specialError) throw specialError;\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const specialStat = statSpecialFile(path);\n      if (specialStat) return specialStat;\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n        mtimeMs: Number((stats as { mtimeMs?: number }).mtimeMs ?? stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      const specialExists = existsSpecialFile(path);\n      if (specialExists !== undefined) return specialExists;\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      if (discardsSpecialFileWrites(path)) {\n        return;\n      }\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      if (discardsSpecialFileWrites(path)) {\n        return;\n      }\n      await fs.appendFile(path, data);\n    },\n\n    async writeStream(path: string, opts?: { append?: boolean }): Promise<VirtualFSWritable> {\n      if (discardsSpecialFileWrites(path)) {\n        return createDiscardingWritable();\n      }\n\n      const chunks: Uint8Array[] = [];\n      let closed = false;\n\n      return {\n        async write(chunk: Uint8Array): Promise<void> {\n          if (closed) {\n            throw new Error(\"stream is closed\");\n          }\n          chunks.push(Buffer.from(chunk));\n        },\n        async close(): Promise<void> {\n          if (closed) return;\n          closed = true;\n          const data = Buffer.concat(chunks.map((chunk) => Buffer.from(chunk)));\n          if (opts?.append) {\n            await fs.appendFile(path, data);\n          } else {\n            await fs.writeFile(path, data);\n          }\n        },\n        async abort(_reason?: unknown): Promise<void> {\n          closed = true;\n          chunks.length = 0;\n        },\n      };\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      const specialError = getSpecialPathError(path, \"mkdir\");\n      if (specialError) throw specialError;\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      const specialError = getSpecialPathError(path, \"rm\");\n      if (specialError) throw specialError;\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return globVirtualFS(\n        {\n          readdir: (filePath: string) => this.readdir(filePath),\n          stat: (filePath: string) => this.stat(filePath),\n          resolve: (...paths: string[]) => this.resolve(...paths),\n        },\n        pattern,\n        { cwd }\n      );\n    },\n  };\n}\n\nfunction emptyIterable(): AsyncIterable<Uint8Array> {\n  return {\n    async *[Symbol.asyncIterator]() {},\n  };\n}\n\nfunction createDiscardingWritable(): VirtualFSWritable {\n  return {\n    async write(_chunk: Uint8Array): Promise<void> {},\n    async close(): Promise<void> {},\n    async abort(_reason?: unknown): Promise<void> {},\n  };\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "F25975C12E3475B564756E2164756E21",
+  "mappings": "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",
+  "debugId": "238F7B043514ECF264756E2164756E21",
   "names": []
 }

package/dist/cjs/src/fs/real-fs.cjs

@@ -67,10 +67,21 @@ __export(exports_real_fs, {
 });
 module.exports = __toCommonJS(exports_real_fs);
 var path = __toESM(require("path"));
+var nodeStreamFs = __toESM(require("node:fs"));
 var nodeFs = __toESM(require("node:fs/promises"));
 var import_glob = require("../utils/glob.cjs");
 var import_special_files = require("./special-files.cjs");
-var defaultFS = { promises: nodeFs };
+var defaultFS = {
+  promises: nodeFs,
+  streams: {
+    createReadStream(realPath) {
+      return createNodeReadIterable(realPath);
+    },
+    createWriteStream(realPath, opts) {
+      return createNodeWritable(realPath, opts);
+    }
+  }
+};
 var nodePathOps = {
   separator: path.sep,
   resolve: (...paths) => path.resolve(...paths),
@@ -178,6 +189,18 @@ class FileSystem {
     const buf = Buffer.from(content);
     return encoding ? buf.toString(encoding) : buf;
   }
+  readStream(filePath) {
+    if (import_special_files.isDevNullPath(filePath)) {
+      return emptyIterable();
+    }
+    this.checkPermission(filePath, "read");
+    const realPath = this.resolveSafePath(filePath);
+    const nativeStream = this.underlyingFs.streams?.createReadStream?.(realPath);
+    if (nativeStream) {
+      return normalizeChunks(nativeStream);
+    }
+    return bufferToIterable(this.readFile(filePath));
+  }
   async readdir(dirPath) {
     const specialError = import_special_files.getSpecialPathError(dirPath, "readdir");
     if (specialError) {
@@ -200,7 +223,8 @@ class FileSystem {
       isFile: () => stats.isFile(),
       isDirectory: () => stats.isDirectory(),
       size: stats.size,
-      mtime: stats.mtime
+      mtime: stats.mtime,
+      mtimeMs: stats.mtimeMs ?? stats.mtime.getTime()
     };
   }
   async exists(filePath) {
@@ -233,6 +257,24 @@ class FileSystem {
     const realPath = this.resolveSafePath(filePath);
     await this.underlyingFs.promises.appendFile(realPath, data);
   }
+  async writeStream(filePath, opts) {
+    if (import_special_files.discardsSpecialFileWrites(filePath)) {
+      return createDiscardingWritable();
+    }
+    this.checkPermission(filePath, "write");
+    const realPath = this.resolveSafePath(filePath);
+    const nativeWriter = this.underlyingFs.streams?.createWriteStream?.(realPath, opts);
+    if (nativeWriter) {
+      return nativeWriter;
+    }
+    return createBufferedWritable(async (buffer) => {
+      if (opts?.append) {
+        await this.underlyingFs.promises.appendFile(realPath, buffer);
+      } else {
+        await this.underlyingFs.promises.writeFile(realPath, buffer);
+      }
+    });
+  }
   async mkdir(dirPath, opts) {
     const specialError = import_special_files.getSpecialPathError(dirPath, "mkdir");
     if (specialError) {
@@ -266,5 +308,94 @@ class FileSystem {
     return import_glob.globVirtualFS(this, pattern, { cwd });
   }
 }
+function emptyIterable() {
+  return {
+    async* [Symbol.asyncIterator]() {}
+  };
+}
+function bufferToIterable(bufferPromise) {
+  return {
+    async* [Symbol.asyncIterator]() {
+      const buffer = await bufferPromise;
+      yield buffer;
+    }
+  };
+}
+async function* normalizeChunks(source) {
+  for await (const chunk of source) {
+    yield chunk instanceof Uint8Array ? chunk : new Uint8Array(chunk);
+  }
+}
+function createDiscardingWritable() {
+  return {
+    async write(_chunk) {},
+    async close() {},
+    async abort(_reason) {}
+  };
+}
+function createBufferedWritable(onClose) {
+  const chunks = [];
+  let closed = false;
+  return {
+    async write(chunk) {
+      if (closed) {
+        throw new Error("stream is closed");
+      }
+      chunks.push(Buffer.from(chunk));
+    },
+    async close() {
+      if (closed)
+        return;
+      closed = true;
+      await onClose(Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))));
+    },
+    async abort(_reason) {
+      closed = true;
+      chunks.length = 0;
+    }
+  };
+}
+async function* createNodeReadIterable(realPath) {
+  const stream = nodeStreamFs.createReadStream(realPath);
+  for await (const chunk of stream) {
+    yield Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+  }
+}
+function createNodeWritable(realPath, opts) {
+  const stream = nodeStreamFs.createWriteStream(realPath, {
+    flags: opts?.append ? "a" : "w"
+  });
+  const ready = new Promise((resolve2, reject) => {
+    stream.once("open", () => resolve2());
+    stream.once("error", reject);
+  });
+  return {
+    async write(chunk) {
+      await ready;
+      await new Promise((resolve2, reject) => {
+        stream.write(chunk, (error) => {
+          if (error)
+            reject(error);
+          else
+            resolve2();
+        });
+      });
+    },
+    async close() {
+      await ready;
+      await new Promise((resolve2, reject) => {
+        stream.end((error) => {
+          if (error)
+            reject(error);
+          else
+            resolve2();
+        });
+      });
+    },
+    async abort(reason) {
+      stream.destroy(reason instanceof Error ? reason : undefined);
+    }
+  };
+}
 
-//# debugId=58FDFA4CFF76BA5364756E2164756E21
+//# debugId=39354A6D64DEDEC164756E2164756E21

package/dist/cjs/src/fs/real-fs.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/real-fs.ts"],
   "sourcesContent": [
-    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\nimport { globVirtualFS } from \"../utils/glob.cjs\";\nimport {\n  discardsSpecialFileWrites,\n  existsSpecialFile,\n  getSpecialPathError,\n  readSpecialFile,\n  statSpecialFile,\n} from \"./special-files.cjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\nexport interface PathOps {\n  readonly separator: string;\n  resolve(...paths: string[]): string;\n  normalize(path: string): string;\n  join(...paths: string[]): string;\n  relative(from: string, to: string): string;\n  isAbsolute(path: string): boolean;\n  dirname(path: string): string;\n  basename(path: string): string;\n}\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  pathOps?: PathOps;\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = { promises: nodeFs };\nconst nodePathOps: PathOps = {\n  separator: path.sep,\n  resolve: (...paths) => path.resolve(...paths),\n  normalize: (filePath) => path.normalize(filePath),\n  join: (...paths) => path.join(...paths),\n  relative: (from, to) => path.relative(from, to),\n  isAbsolute: (filePath) => path.isAbsolute(filePath),\n  dirname: (filePath) => path.dirname(filePath),\n  basename: (filePath) => path.basename(filePath),\n};\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  private readonly pathOps: PathOps;\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    const underlyingFs = fs ?? defaultFS;\n    this.pathOps = underlyingFs.pathOps ?? nodePathOps;\n    this.mountBase = mountPath ? this.pathOps.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = underlyingFs;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return this.pathOps.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = this.pathOps.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = this.pathOps.join(this.mountBase, relativePath);\n    const resolved = this.pathOps.resolve(realPath);\n\n    // Double-check containment (defense in depth), including root mounts.\n    const relativeFromMount = this.pathOps.relative(this.mountBase, resolved);\n    const escapesMount =\n      relativeFromMount === \"..\" ||\n      relativeFromMount.startsWith(`..${this.pathOps.separator}`) ||\n      this.pathOps.isAbsolute(relativeFromMount);\n    if (escapesMount) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer>;\n  async readFile(filePath: string, encoding: BufferEncoding): Promise<string>;\n  async readFile(filePath: string, encoding?: BufferEncoding): Promise<Buffer | string> {\n    const specialContent = readSpecialFile(filePath, encoding);\n    if (specialContent !== undefined) {\n      return specialContent;\n    }\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    const buf = Buffer.from(content);\n    return encoding ? buf.toString(encoding) : buf;\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    const specialError = getSpecialPathError(dirPath, \"readdir\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    const specialStat = statSpecialFile(filePath);\n    if (specialStat) {\n      return specialStat;\n    }\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    const specialExists = existsSpecialFile(filePath);\n    if (specialExists !== undefined) {\n      return specialExists;\n    }\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    if (discardsSpecialFileWrites(filePath)) {\n      return;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    if (discardsSpecialFileWrites(filePath)) {\n      return;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    const specialError = getSpecialPathError(dirPath, \"mkdir\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    const specialError = getSpecialPathError(filePath, \"rm\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return this.pathOps.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return this.pathOps.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return this.pathOps.basename(filePath);\n  }\n\n  // Glob expansion\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n    return globVirtualFS(this, pattern, { cwd });\n  }\n}\n"
+    "import * as path from \"path\";\nimport * as nodeStreamFs from \"node:fs\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, VirtualFSWritable, FileStat } from \"../types.cjs\";\nimport { globVirtualFS } from \"../utils/glob.cjs\";\nimport {\n  discardsSpecialFileWrites,\n  existsSpecialFile,\n  getSpecialPathError,\n  isDevNullPath,\n  readSpecialFile,\n  statSpecialFile,\n} from \"./special-files.cjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\nexport interface PathOps {\n  readonly separator: string;\n  resolve(...paths: string[]): string;\n  normalize(path: string): string;\n  join(...paths: string[]): string;\n  relative(from: string, to: string): string;\n  isAbsolute(path: string): boolean;\n  dirname(path: string): string;\n  basename(path: string): string;\n}\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  pathOps?: PathOps;\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n      mtimeMs?: number;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n  streams?: {\n    createReadStream?(path: string): AsyncIterable<Uint8Array>;\n    createWriteStream?(\n      path: string,\n      opts?: { append?: boolean },\n    ): Promise<VirtualFSWritable> | VirtualFSWritable;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = {\n  promises: nodeFs,\n  streams: {\n    createReadStream(realPath: string): AsyncIterable<Uint8Array> {\n      return createNodeReadIterable(realPath);\n    },\n    createWriteStream(realPath: string, opts?: { append?: boolean }): VirtualFSWritable {\n      return createNodeWritable(realPath, opts);\n    },\n  },\n};\nconst nodePathOps: PathOps = {\n  separator: path.sep,\n  resolve: (...paths) => path.resolve(...paths),\n  normalize: (filePath) => path.normalize(filePath),\n  join: (...paths) => path.join(...paths),\n  relative: (from, to) => path.relative(from, to),\n  isAbsolute: (filePath) => path.isAbsolute(filePath),\n  dirname: (filePath) => path.dirname(filePath),\n  basename: (filePath) => path.basename(filePath),\n};\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  private readonly pathOps: PathOps;\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    const underlyingFs = fs ?? defaultFS;\n    this.pathOps = underlyingFs.pathOps ?? nodePathOps;\n    this.mountBase = mountPath ? this.pathOps.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = underlyingFs;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return this.pathOps.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = this.pathOps.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = this.pathOps.join(this.mountBase, relativePath);\n    const resolved = this.pathOps.resolve(realPath);\n\n    // Double-check containment (defense in depth), including root mounts.\n    const relativeFromMount = this.pathOps.relative(this.mountBase, resolved);\n    const escapesMount =\n      relativeFromMount === \"..\" ||\n      relativeFromMount.startsWith(`..${this.pathOps.separator}`) ||\n      this.pathOps.isAbsolute(relativeFromMount);\n    if (escapesMount) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer>;\n  async readFile(filePath: string, encoding: BufferEncoding): Promise<string>;\n  async readFile(filePath: string, encoding?: BufferEncoding): Promise<Buffer | string> {\n    const specialContent = readSpecialFile(filePath, encoding);\n    if (specialContent !== undefined) {\n      return specialContent;\n    }\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    const buf = Buffer.from(content);\n    return encoding ? buf.toString(encoding) : buf;\n  }\n\n  readStream(filePath: string): AsyncIterable<Uint8Array> {\n    if (isDevNullPath(filePath)) {\n      return emptyIterable();\n    }\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const nativeStream = this.underlyingFs.streams?.createReadStream?.(realPath);\n    if (nativeStream) {\n      return normalizeChunks(nativeStream);\n    }\n    return bufferToIterable(this.readFile(filePath) as Promise<Buffer>);\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    const specialError = getSpecialPathError(dirPath, \"readdir\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    const specialStat = statSpecialFile(filePath);\n    if (specialStat) {\n      return specialStat;\n    }\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n      mtimeMs: stats.mtimeMs ?? stats.mtime.getTime(),\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    const specialExists = existsSpecialFile(filePath);\n    if (specialExists !== undefined) {\n      return specialExists;\n    }\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    if (discardsSpecialFileWrites(filePath)) {\n      return;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    if (discardsSpecialFileWrites(filePath)) {\n      return;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async writeStream(filePath: string, opts?: { append?: boolean }): Promise<VirtualFSWritable> {\n    if (discardsSpecialFileWrites(filePath)) {\n      return createDiscardingWritable();\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    const nativeWriter = this.underlyingFs.streams?.createWriteStream?.(realPath, opts);\n    if (nativeWriter) {\n      return nativeWriter;\n    }\n    return createBufferedWritable(async (buffer) => {\n      if (opts?.append) {\n        await this.underlyingFs.promises.appendFile(realPath, buffer);\n      } else {\n        await this.underlyingFs.promises.writeFile(realPath, buffer);\n      }\n    });\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    const specialError = getSpecialPathError(dirPath, \"mkdir\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    const specialError = getSpecialPathError(filePath, \"rm\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return this.pathOps.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return this.pathOps.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return this.pathOps.basename(filePath);\n  }\n\n  // Glob expansion\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n    return globVirtualFS(this, pattern, { cwd });\n  }\n}\n\nfunction emptyIterable(): AsyncIterable<Uint8Array> {\n  return {\n    async *[Symbol.asyncIterator]() {},\n  };\n}\n\nfunction bufferToIterable(bufferPromise: Promise<Buffer>): AsyncIterable<Uint8Array> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      const buffer = await bufferPromise;\n      yield buffer;\n    },\n  };\n}\n\nasync function* normalizeChunks(source: AsyncIterable<Uint8Array>): AsyncIterable<Uint8Array> {\n  for await (const chunk of source) {\n    yield chunk instanceof Uint8Array ? chunk : new Uint8Array(chunk);\n  }\n}\n\nfunction createDiscardingWritable(): VirtualFSWritable {\n  return {\n    async write(_chunk: Uint8Array): Promise<void> {},\n    async close(): Promise<void> {},\n    async abort(_reason?: unknown): Promise<void> {},\n  };\n}\n\nfunction createBufferedWritable(\n  onClose: (buffer: Buffer) => Promise<void>,\n): VirtualFSWritable {\n  const chunks: Uint8Array[] = [];\n  let closed = false;\n\n  return {\n    async write(chunk: Uint8Array): Promise<void> {\n      if (closed) {\n        throw new Error(\"stream is closed\");\n      }\n      chunks.push(Buffer.from(chunk));\n    },\n    async close(): Promise<void> {\n      if (closed) return;\n      closed = true;\n      await onClose(Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))));\n    },\n    async abort(_reason?: unknown): Promise<void> {\n      closed = true;\n      chunks.length = 0;\n    },\n  };\n}\n\nasync function* createNodeReadIterable(realPath: string): AsyncIterable<Uint8Array> {\n  const stream = nodeStreamFs.createReadStream(realPath);\n  for await (const chunk of stream) {\n    yield Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n  }\n}\n\nfunction createNodeWritable(\n  realPath: string,\n  opts?: { append?: boolean },\n): VirtualFSWritable {\n  const stream = nodeStreamFs.createWriteStream(realPath, {\n    flags: opts?.append ? \"a\" : \"w\",\n  });\n  const ready = new Promise<void>((resolve, reject) => {\n    stream.once(\"open\", () => resolve());\n    stream.once(\"error\", reject);\n  });\n\n  return {\n    async write(chunk: Uint8Array): Promise<void> {\n      await ready;\n      await new Promise<void>((resolve, reject) => {\n        stream.write(chunk, (error) => {\n          if (error) reject(error);\n          else resolve();\n        });\n      });\n    },\n    async close(): Promise<void> {\n      await ready;\n      await new Promise<void>((resolve, reject) => {\n        stream.end((error?: Error | null) => {\n          if (error) reject(error);\n          else resolve();\n        });\n      });\n    },\n    async abort(reason?: unknown): Promise<void> {\n      stream.destroy(reason instanceof Error ? reason : undefined);\n    },\n  };\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "58FDFA4CFF76BA5364756E2164756E21",
+  "mappings": "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",
+  "debugId": "39354A6D64DEDEC164756E2164756E21",
   "names": []
 }

package/dist/cjs/src/fs/special-files.cjs

@@ -69,7 +69,8 @@ function statSpecialFile(path) {
     isFile: () => true,
     isDirectory: () => false,
     size: 0,
-    mtime: new Date(0)
+    mtime: new Date(0),
+    mtimeMs: 0
   };
 }
 function existsSpecialFile(path) {
@@ -95,4 +96,4 @@ function getSpecialPathError(path, operation) {
   }
 }
 
-//# debugId=674232080F989C1164756E2164756E21
+//# debugId=C4DAB79D54BC633764756E2164756E21

package/dist/cjs/src/fs/special-files.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/special-files.ts"],
   "sourcesContent": [
-    "import type { FileStat } from \"../types.cjs\";\n\nexport const DEV_NULL_PATH = \"/dev/null\";\n\nfunction normalizeSpecialPath(path: string): string {\n  return path.replace(/\\\\/g, \"/\");\n}\n\nexport function isDevNullPath(path: string): boolean {\n  return normalizeSpecialPath(path) === DEV_NULL_PATH;\n}\n\nexport function readSpecialFile(\n  path: string,\n  encoding?: BufferEncoding\n): Buffer | string | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return encoding ? \"\" : Buffer.alloc(0);\n}\n\nexport function statSpecialFile(path: string): FileStat | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return {\n    isFile: () => true,\n    isDirectory: () => false,\n    size: 0,\n    mtime: new Date(0),\n  };\n}\n\nexport function existsSpecialFile(path: string): boolean | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return true;\n}\n\nexport function discardsSpecialFileWrites(path: string): boolean {\n  return isDevNullPath(path);\n}\n\nexport function getSpecialPathError(\n  path: string,\n  operation: \"mkdir\" | \"readdir\" | \"rm\"\n): Error | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  switch (operation) {\n    case \"mkdir\":\n      return new Error(`EEXIST: file already exists, mkdir '${DEV_NULL_PATH}'`);\n    case \"readdir\":\n      return new Error(`ENOTDIR: not a directory, scandir '${DEV_NULL_PATH}'`);\n    case \"rm\":\n      return new Error(`EPERM: operation not permitted, rm '${DEV_NULL_PATH}'`);\n  }\n}\n"
+    "import type { FileStat } from \"../types.cjs\";\n\nexport const DEV_NULL_PATH = \"/dev/null\";\n\nfunction normalizeSpecialPath(path: string): string {\n  return path.replace(/\\\\/g, \"/\");\n}\n\nexport function isDevNullPath(path: string): boolean {\n  return normalizeSpecialPath(path) === DEV_NULL_PATH;\n}\n\nexport function readSpecialFile(\n  path: string,\n  encoding?: BufferEncoding\n): Buffer | string | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return encoding ? \"\" : Buffer.alloc(0);\n}\n\nexport function statSpecialFile(path: string): FileStat | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return {\n    isFile: () => true,\n    isDirectory: () => false,\n    size: 0,\n    mtime: new Date(0),\n    mtimeMs: 0,\n  };\n}\n\nexport function existsSpecialFile(path: string): boolean | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return true;\n}\n\nexport function discardsSpecialFileWrites(path: string): boolean {\n  return isDevNullPath(path);\n}\n\nexport function getSpecialPathError(\n  path: string,\n  operation: \"mkdir\" | \"readdir\" | \"rm\"\n): Error | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  switch (operation) {\n    case \"mkdir\":\n      return new Error(`EEXIST: file already exists, mkdir '${DEV_NULL_PATH}'`);\n    case \"readdir\":\n      return new Error(`ENOTDIR: not a directory, scandir '${DEV_NULL_PATH}'`);\n    case \"rm\":\n      return new Error(`EPERM: operation not permitted, rm '${DEV_NULL_PATH}'`);\n  }\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEO,IAAM,gBAAgB;AAE7B,SAAS,oBAAoB,CAAC,MAAsB;AAAA,EAClD,OAAO,KAAK,QAAQ,OAAO,GAAG;AAAA;AAGzB,SAAS,aAAa,CAAC,MAAuB;AAAA,EACnD,OAAO,qBAAqB,IAAI,MAAM;AAAA;AAGjC,SAAS,eAAe,CAC7B,MACA,UAC6B;AAAA,EAC7B,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO,WAAW,KAAK,OAAO,MAAM,CAAC;AAAA;AAGhC,SAAS,eAAe,CAAC,MAAoC;AAAA,EAClE,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,aAAa,MAAM;AAAA,IACnB,MAAM;AAAA,IACN,OAAO,IAAI,KAAK,CAAC;AAAA,EACnB;AAAA;AAGK,SAAS,iBAAiB,CAAC,MAAmC;AAAA,EACnE,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAGF,SAAS,yBAAyB,CAAC,MAAuB;AAAA,EAC/D,OAAO,cAAc,IAAI;AAAA;AAGpB,SAAS,mBAAmB,CACjC,MACA,WACmB;AAAA,EACnB,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,QAAQ;AAAA,SACD;AAAA,MACH,OAAO,IAAI,MAAM,uCAAuC,gBAAgB;AAAA,SACrE;AAAA,MACH,OAAO,IAAI,MAAM,sCAAsC,gBAAgB;AAAA,SACpE;AAAA,MACH,OAAO,IAAI,MAAM,uCAAuC,gBAAgB;AAAA;AAAA;",
-  "debugId": "674232080F989C1164756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEO,IAAM,gBAAgB;AAE7B,SAAS,oBAAoB,CAAC,MAAsB;AAAA,EAClD,OAAO,KAAK,QAAQ,OAAO,GAAG;AAAA;AAGzB,SAAS,aAAa,CAAC,MAAuB;AAAA,EACnD,OAAO,qBAAqB,IAAI,MAAM;AAAA;AAGjC,SAAS,eAAe,CAC7B,MACA,UAC6B;AAAA,EAC7B,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO,WAAW,KAAK,OAAO,MAAM,CAAC;AAAA;AAGhC,SAAS,eAAe,CAAC,MAAoC;AAAA,EAClE,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,aAAa,MAAM;AAAA,IACnB,MAAM;AAAA,IACN,OAAO,IAAI,KAAK,CAAC;AAAA,IACjB,SAAS;AAAA,EACX;AAAA;AAGK,SAAS,iBAAiB,CAAC,MAAmC;AAAA,EACnE,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAGF,SAAS,yBAAyB,CAAC,MAAuB;AAAA,EAC/D,OAAO,cAAc,IAAI;AAAA;AAGpB,SAAS,mBAAmB,CACjC,MACA,WACmB;AAAA,EACnB,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,QAAQ;AAAA,SACD;AAAA,MACH,OAAO,IAAI,MAAM,uCAAuC,gBAAgB;AAAA,SACrE;AAAA,MACH,OAAO,IAAI,MAAM,sCAAsC,gBAAgB;AAAA,SACpE;AAAA,MACH,OAAO,IAAI,MAAM,uCAAuC,gBAAgB;AAAA;AAAA;",
+  "debugId": "C4DAB79D54BC633764756E2164756E21",
   "names": []
 }

package/dist/cjs/src/fs/web-fs.cjs

@@ -125,7 +125,8 @@ function createWebUnderlyingFS(root) {
             isFile: () => true,
             isDirectory: () => false,
             size: file.size,
-            mtime: new Date(file.lastModified ?? 0)
+            mtime: new Date(file.lastModified ?? 0),
+            mtimeMs: file.lastModified ?? 0
           };
         } catch (error) {
           if (!isNotFoundOrTypeMismatch(error))
@@ -194,6 +195,57 @@ function createWebUnderlyingFS(root) {
           throw error;
         }
       }
+    },
+    streams: {
+      createReadStream(path) {
+        return {
+          async* [Symbol.asyncIterator]() {
+            const { parentSegments, name } = splitParent(path);
+            const parent = await walkDirectory(root, parentSegments, false);
+            const fileHandle = await parent.getFileHandle(name, { create: false });
+            const file = await fileHandle.getFile();
+            for await (const chunk of streamToAsyncIterable(file.stream())) {
+              yield chunk;
+            }
+          }
+        };
+      },
+      async createWriteStream(path, opts) {
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        const fileHandle = await parent.getFileHandle(name, { create: true });
+        const existingFile = opts?.append ? await fileHandle.getFile() : null;
+        const writable = await fileHandle.createWritable({ keepExistingData: !!opts?.append });
+        let position = opts?.append ? existingFile?.size ?? 0 : 0;
+        let closed = false;
+        return {
+          async write(chunk) {
+            if (closed) {
+              throw new Error("stream is closed");
+            }
+            const bytes = new Uint8Array(chunk.byteLength);
+            bytes.set(chunk, 0);
+            await writable.write({
+              type: "write",
+              position,
+              data: bytes
+            });
+            position += bytes.byteLength;
+          },
+          async close() {
+            if (closed)
+              return;
+            closed = true;
+            await writable.close();
+          },
+          async abort(_reason) {
+            if (closed)
+              return;
+            closed = true;
+            await writable.abort?.();
+          }
+        };
+      }
     }
   };
 }
@@ -208,7 +260,8 @@ function createDirectoryStat() {
     isFile: () => false,
     isDirectory: () => true,
     size: 0,
-    mtime: DIRECTORY_MTIME
+    mtime: DIRECTORY_MTIME,
+    mtimeMs: DIRECTORY_MTIME.getTime()
   };
 }
 function normalizeWebPath(path) {
@@ -268,6 +321,22 @@ async function entryExists(dir, name) {
     return false;
   }
 }
+async function* streamToAsyncIterable(stream) {
+  const reader = stream.getReader();
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        return;
+      }
+      if (value) {
+        yield value;
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
 function isNotFoundOrTypeMismatch(error) {
   return isNotFoundError(error) || isTypeMismatchError(error);
 }
@@ -292,4 +361,4 @@ function toWritableData(data) {
   return out.buffer;
 }
 
-//# debugId=63C0A71C805BC57D64756E2164756E21
+//# debugId=87CE1021E696ED8364756E2164756E21