@ecopages/file-system 0.2.0-alpha.5 → 0.2.0-alpha.7

package/CHANGELOG.md

@@ -6,6 +6,6 @@ All notable changes to `@ecopages/file-system` are documented here.
 
 ## [UNRELEASED] — TBD
 
-### Refactoring
+### Bug Fixes
 
-- `package.json` updated to add `fs` as an explicit peer dependency, reflecting the package's role in the runtime-agnostic file abstraction layer used by the Node adapter.
+- Switched Node-side globbing from `fast-glob` to native `node:fs/promises.glob()` so bundled ESM runtime paths avoid CommonJS interop failures.

package/README.md

@@ -1,18 +1,17 @@
 # @ecopages/file-system
 
-Runtime-agnostic file system utilities for Ecopages with optimized Bun and Node.js adapters.
+Runtime-agnostic file system utilities for Ecopages that automatically select the optimal adapter (Bun or Node.js) based on the execution environment.
 
 ## Features
 
-- **Runtime Detection**: Automatically selects optimal adapter based on runtime
-- **Bun Optimized**: Uses `Bun.Glob`, `Bun.hash`, `Bun.file` for maximum performance
-- **Node.js Fallback**: Uses `fast-glob` and `crypto` for full compatibility
-- **Type Safe**: Full TypeScript support with consistent interface
+- **Runtime Detection**: Automatically uses `Bun.Glob`, `Bun.hash`, `Bun.file` for maximum performance on Bun, and falls back to `fast-glob` and `crypto` on Node.js.
+- **Unified Interface**: Write file system code once; let the runtime handle the optimization.
+- **Type Safe**: Full TypeScript support with a consistent API.
 
 ## Installation
 
 ```bash
-bun add @ecopages/file-system
+bunx jsr add @ecopages/file-system
 ```
 
 ## Usage
@@ -41,11 +40,11 @@ if (fileSystem.exists('file.txt')) {
 ## API
 
 | Method                      | Description                       |
-| --------------------------- | --------------------------------- |
+| :-------------------------- | :-------------------------------- |
 | `glob(patterns, options)`   | Find files matching glob patterns |
 | `readFile(path)`            | Read file as string (async)       |
 | `readFileSync(path)`        | Read file as string (sync)        |
-| `readFileAsBuffer(path)`    | Read file as Buffer               |
+| `readFileAsBuffer(path)`    | Read file as `Buffer`             |
 | `write(path, content)`      | Write content to file             |
 | `writeAsync(path, content)` | Write content to file (async)     |
 | `exists(path)`              | Check if path exists              |
@@ -59,18 +58,3 @@ if (fileSystem.exists('file.txt')) {
 | `gzipDir(path, extensions)` | Gzip files in directory           |
 | `isDirectory(path)`         | Check if path is directory        |
 | `verifyFileExists(path)`    | Throw if file doesn't exist       |
-
-## Performance
-
-Benchmark results (Apple M4):
-
-| Operation        | BunFileSystem | NodeFileSystem |
-| ---------------- | ------------- | -------------- |
-| glob (100 files) | 64.85 µs      | 71.06 µs       |
-| hash (1MB file)  | **87 µs**     | **393 µs**     |
-
-Bun adapter is **4.5x faster** for file hashing.
-
-## License
-
-MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/file-system",
-  "version": "0.2.0-alpha.5",
+  "version": "0.2.0-alpha.7",
   "description": "Runtime-agnostic file system utilities for Ecopages with Bun and Node adapters",
   "keywords": [
     "ecopages",

package/src/adapters/node.js

@@ -2,12 +2,22 @@ import crypto from "node:crypto";
 import {
   access as accessAsync,
   cp as cpAsync,
+  glob as globAsync,
   readFile as readFileAsync,
   writeFile as writeFileAsync
 } from "node:fs/promises";
 import { dirname } from "node:path";
-import fg from "fast-glob";
 import { BaseFileSystem } from "../utils/common.js";
+async function collectGlobMatches(pattern, options) {
+  const matches = [];
+  for await (const entry of globAsync(pattern, {
+    cwd: options.cwd ?? process.cwd(),
+    exclude: options.ignore
+  })) {
+    matches.push(entry);
+  }
+  return matches;
+}
 class NodeFileSystem extends BaseFileSystem {
   async existsAsync(filePath) {
     try {
@@ -39,11 +49,8 @@ class NodeFileSystem extends BaseFileSystem {
     await cpAsync(source, destination);
   }
   async glob(patterns, options = {}) {
-    return fg(patterns, {
-      cwd: options.cwd ?? process.cwd(),
-      ignore: options.ignore,
-      ...options
-    });
+    const files = await Promise.all(patterns.map((pattern) => collectGlobMatches(pattern, options)));
+    return Array.from(new Set(files.flat()));
   }
   hash(path) {
     try {

package/src/adapters/node.ts

@@ -7,14 +7,27 @@ import crypto from 'node:crypto';
 import {
 	access as accessAsync,
 	cp as cpAsync,
+	glob as globAsync,
 	readFile as readFileAsync,
 	writeFile as writeFileAsync,
 } from 'node:fs/promises';
 import { dirname } from 'node:path';
-import fg from 'fast-glob';
 import type { FileSystem, GlobOptions } from '../types.ts';
 import { BaseFileSystem } from '../utils/common.ts';
 
+async function collectGlobMatches(pattern: string, options: GlobOptions): Promise<string[]> {
+	const matches: string[] = [];
+
+	for await (const entry of globAsync(pattern, {
+		cwd: options.cwd ?? process.cwd(),
+		exclude: options.ignore,
+	})) {
+		matches.push(entry);
+	}
+
+	return matches;
+}
+
 /**
  * Node.js implementation of the FileSystem interface.
  */
@@ -53,11 +66,8 @@ export class NodeFileSystem extends BaseFileSystem implements FileSystem {
 	}
 
 	async glob(patterns: string[], options: GlobOptions = {}): Promise<string[]> {
-		return fg(patterns, {
-			cwd: options.cwd ?? process.cwd(),
-			ignore: options.ignore,
-			...options,
-		});
+		const files = await Promise.all(patterns.map((pattern) => collectGlobMatches(pattern, options)));
+		return Array.from(new Set(files.flat()));
 	}
 
 	hash(path: string): string {

package/src/index.d.ts

@@ -4,7 +4,7 @@
  *
  * Automatically selects the optimal adapter based on runtime:
  * - **Bun**: Uses `Bun.Glob`, `Bun.hash`, `Bun.file` for maximum performance
- * - **Node.js**: Uses `fast-glob` and `crypto` for compatibility
+ * - **Node.js**: Uses native `node:fs/promises.glob()` and `crypto`
  *
  * @example
  * ```typescript

package/src/index.ts

@@ -4,7 +4,7 @@
  *
  * Automatically selects the optimal adapter based on runtime:
  * - **Bun**: Uses `Bun.Glob`, `Bun.hash`, `Bun.file` for maximum performance
- * - **Node.js**: Uses `fast-glob` and `crypto` for compatibility
+ * - **Node.js**: Uses native `node:fs/promises.glob()` and `crypto`
  *
  * @example
  * ```typescript