elit 3.0.0 → 3.0.2

package/src/fs.ts

@@ -0,0 +1,727 @@
+/**
+ * File System module with unified API across runtimes
+ * Compatible with Node.js 'fs' module API
+ * - Node.js: uses 'fs' module
+ * - Bun: uses Bun.file() and native APIs
+ * - Deno: uses Deno.readFile(), etc.
+ */
+
+import { runtime, isNode, isBun, isDeno } from './runtime';
+
+/**
+ * Helper: Check if runtime is Bun or Deno (eliminates duplication in Deno API calls)
+ */
+const isBunOrDeno = isBun || isDeno;
+
+/**
+ * Helper: Parse options from string or object (eliminates duplication in options parsing)
+ */
+function parseOptions<T>(options: T | string | undefined, defaultValue: T): T {
+  return typeof options === 'string' ? { encoding: options } as T : options || defaultValue;
+}
+
+/**
+ * Helper: Decode content with optional encoding (eliminates duplication in read operations)
+ */
+function decodeContent(content: ArrayBuffer | Uint8Array, encoding?: string | null): string | Buffer {
+  if (encoding) {
+    return new TextDecoder(encoding).decode(content);
+  }
+  return Buffer.from(content instanceof ArrayBuffer ? new Uint8Array(content) : content);
+}
+
+/**
+ * Helper: Convert data to Uint8Array (eliminates duplication in write operations)
+ */
+function dataToUint8Array(data: string | Buffer | Uint8Array): Uint8Array {
+  if (typeof data === 'string') {
+    return new TextEncoder().encode(data);
+  }
+  if (data instanceof Buffer) {
+    return new Uint8Array(data);
+  }
+  return data;
+}
+
+/**
+ * Helper: Process directory entries (eliminates duplication in readdir operations)
+ */
+function processDenoEntries(iterator: any, withFileTypes?: boolean): any[] {
+  const entries: any[] = [];
+  for (const entry of iterator) {
+    if (withFileTypes) {
+      entries.push(createDirentFromDenoEntry(entry));
+    } else {
+      entries.push(entry.name);
+    }
+  }
+  return entries;
+}
+
+/**
+ * Helper: Process directory entries async (eliminates duplication in async readdir)
+ */
+async function processDenoEntriesAsync(iterator: any, withFileTypes?: boolean): Promise<any[]> {
+  const entries: any[] = [];
+  for await (const entry of iterator) {
+    if (withFileTypes) {
+      entries.push(createDirentFromDenoEntry(entry));
+    } else {
+      entries.push(entry.name);
+    }
+  }
+  return entries;
+}
+
+// Pre-load fs module for Node.js
+let fs: any, fsPromises: any;
+if (isNode) {
+  fs = require('fs');
+  fsPromises = require('fs/promises');
+}
+
+/**
+ * File encoding types
+ */
+export type BufferEncoding =
+  | 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2'
+  | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
+
+/**
+ * Read file options
+ */
+export interface ReadFileOptions {
+  encoding?: BufferEncoding | null;
+  flag?: string;
+  signal?: AbortSignal;
+}
+
+/**
+ * Write file options
+ */
+export interface WriteFileOptions {
+  encoding?: BufferEncoding | null;
+  mode?: number;
+  flag?: string;
+  signal?: AbortSignal;
+}
+
+/**
+ * Mkdir options
+ */
+export interface MkdirOptions {
+  recursive?: boolean;
+  mode?: number;
+}
+
+/**
+ * Readdir options
+ */
+export interface ReaddirOptions {
+  encoding?: BufferEncoding | null;
+  withFileTypes?: boolean;
+  recursive?: boolean;
+}
+
+/**
+ * File stats
+ */
+export interface Stats {
+  isFile(): boolean;
+  isDirectory(): boolean;
+  isBlockDevice(): boolean;
+  isCharacterDevice(): boolean;
+  isSymbolicLink(): boolean;
+  isFIFO(): boolean;
+  isSocket(): boolean;
+  dev: number;
+  ino: number;
+  mode: number;
+  nlink: number;
+  uid: number;
+  gid: number;
+  rdev: number;
+  size: number;
+  blksize: number;
+  blocks: number;
+  atimeMs: number;
+  mtimeMs: number;
+  ctimeMs: number;
+  birthtimeMs: number;
+  atime: Date;
+  mtime: Date;
+  ctime: Date;
+  birthtime: Date;
+}
+
+/**
+ * Directory entry
+ */
+export interface Dirent {
+  name: string;
+  isFile(): boolean;
+  isDirectory(): boolean;
+  isBlockDevice(): boolean;
+  isCharacterDevice(): boolean;
+  isSymbolicLink(): boolean;
+  isFIFO(): boolean;
+  isSocket(): boolean;
+}
+
+/**
+ * Read file (async)
+ */
+export async function readFile(path: string, options?: ReadFileOptions | BufferEncoding): Promise<string | Buffer> {
+  const opts = parseOptions<ReadFileOptions>(options, {});
+
+  if (isNode) {
+    return fsPromises.readFile(path, opts);
+  } else if (isBun) {
+    // @ts-ignore
+    const file = Bun.file(path);
+    const content = await file.arrayBuffer();
+    return decodeContent(content, opts.encoding);
+  } else if (isDeno) {
+    // @ts-ignore
+    const content = await Deno.readFile(path);
+    return decodeContent(content, opts.encoding);
+  }
+
+  throw new Error('Unsupported runtime');
+}
+
+/**
+ * Read file (sync)
+ */
+export function readFileSync(path: string, options?: ReadFileOptions | BufferEncoding): string | Buffer {
+  const opts = parseOptions<ReadFileOptions>(options, {});
+
+  if (isNode) {
+    return fs.readFileSync(path, opts);
+  } else if (isBun) {
+    // @ts-ignore
+    const file = Bun.file(path);
+    const content = file.arrayBuffer();
+    return decodeContent(content as ArrayBuffer, opts.encoding);
+  } else if (isDeno) {
+    // @ts-ignore
+    const content = Deno.readFileSync(path);
+    return decodeContent(content, opts.encoding);
+  }
+
+  throw new Error('Unsupported runtime');
+}
+
+/**
+ * Write file (async)
+ */
+export async function writeFile(path: string, data: string | Buffer | Uint8Array, options?: WriteFileOptions | BufferEncoding): Promise<void> {
+  const opts = parseOptions<WriteFileOptions>(options, {});
+
+  if (isNode) {
+    return fsPromises.writeFile(path, data, opts);
+  } else if (isBun) {
+    // @ts-ignore
+    await Bun.write(path, data);
+  } else if (isDeno) {
+    // @ts-ignore
+    await Deno.writeFile(path, dataToUint8Array(data));
+  }
+}
+
+/**
+ * Write file (sync)
+ */
+export function writeFileSync(path: string, data: string | Buffer | Uint8Array, options?: WriteFileOptions | BufferEncoding): void {
+  const opts = parseOptions<WriteFileOptions>(options, {});
+
+  if (isNode) {
+    fs.writeFileSync(path, data, opts);
+  } else if (isBun) {
+    // @ts-ignore
+    Bun.write(path, data);
+  } else if (isDeno) {
+    // @ts-ignore
+    Deno.writeFileSync(path, dataToUint8Array(data));
+  }
+}
+
+/**
+ * Append file (async)
+ */
+export async function appendFile(path: string, data: string | Buffer, options?: WriteFileOptions | BufferEncoding): Promise<void> {
+  const opts = parseOptions<WriteFileOptions>(options, {});
+
+  if (isNode) {
+    return fsPromises.appendFile(path, data, opts);
+  } else {
+    if (await exists(path)) {
+      const existing = await readFile(path);
+      const combined = Buffer.isBuffer(existing)
+        ? Buffer.concat([existing, Buffer.isBuffer(data) ? data : Buffer.from(data)])
+        : existing + (Buffer.isBuffer(data) ? data.toString() : data);
+      await writeFile(path, combined, opts);
+    } else {
+      await writeFile(path, data, opts);
+    }
+  }
+}
+
+/**
+ * Append file (sync)
+ */
+export function appendFileSync(path: string, data: string | Buffer, options?: WriteFileOptions | BufferEncoding): void {
+  const opts = parseOptions<WriteFileOptions>(options, {});
+
+  if (isNode) {
+    fs.appendFileSync(path, data, opts);
+  } else {
+    if (existsSync(path)) {
+      const existing = readFileSync(path);
+      const combined = Buffer.isBuffer(existing)
+        ? Buffer.concat([existing, Buffer.isBuffer(data) ? data : Buffer.from(data)])
+        : existing + (Buffer.isBuffer(data) ? data.toString() : data);
+      writeFileSync(path, combined, opts);
+    } else {
+      writeFileSync(path, data, opts);
+    }
+  }
+}
+
+/**
+ * Check if file/directory exists (async)
+ */
+export async function exists(path: string): Promise<boolean> {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if file/directory exists (sync)
+ */
+export function existsSync(path: string): boolean {
+  try {
+    statSync(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get file stats (async)
+ */
+export async function stat(path: string): Promise<Stats> {
+  if (isNode) {
+    return fsPromises.stat(path);
+  } else if (isBun) {
+    // @ts-ignore
+    const file = Bun.file(path);
+    const size = file.size;
+    const exists = await file.exists();
+
+    if (!exists) {
+      throw new Error(`ENOENT: no such file or directory, stat '${path}'`);
+    }
+
+    // Create a Stats-like object
+    return createStatsObject(path, size, false);
+  } else if (isDeno) {
+    // @ts-ignore
+    const info = await Deno.stat(path);
+    return createStatsFromDenoFileInfo(info);
+  }
+
+  throw new Error('Unsupported runtime');
+}
+
+/**
+ * Get file stats (sync)
+ */
+export function statSync(path: string): Stats {
+  if (isNode) {
+    return fs.statSync(path);
+  } else if (isBun) {
+    // @ts-ignore
+    const file = Bun.file(path);
+    const size = file.size;
+
+    // Bun doesn't have sync exists check, so we try to read
+    try {
+      file.arrayBuffer();
+    } catch {
+      throw new Error(`ENOENT: no such file or directory, stat '${path}'`);
+    }
+
+    return createStatsObject(path, size, false);
+  } else if (isDeno) {
+    // @ts-ignore
+    const info = Deno.statSync(path);
+    return createStatsFromDenoFileInfo(info);
+  }
+
+  throw new Error('Unsupported runtime');
+}
+
+/**
+ * Create directory (async)
+ */
+export async function mkdir(path: string, options?: MkdirOptions | number): Promise<void> {
+  const opts = typeof options === 'number' ? { mode: options } as MkdirOptions : options || {};
+
+  if (isNode) {
+    await fsPromises.mkdir(path, opts);
+  } else if (isBun) {
+    // @ts-ignore
+    await Deno.mkdir(path, { recursive: opts.recursive });
+  } else if (isDeno) {
+    // @ts-ignore
+    await Deno.mkdir(path, { recursive: opts.recursive });
+  }
+}
+
+/**
+ * Create directory (sync)
+ */
+export function mkdirSync(path: string, options?: MkdirOptions | number): void {
+  const opts = typeof options === 'number' ? { mode: options } as MkdirOptions : options || {};
+
+  if (isNode) {
+    fs.mkdirSync(path, opts);
+  } else if (isBun) {
+    // @ts-ignore
+    Deno.mkdirSync(path, { recursive: opts.recursive });
+  } else if (isDeno) {
+    // @ts-ignore
+    Deno.mkdirSync(path, { recursive: opts.recursive });
+  }
+}
+
+/**
+ * Read directory (async)
+ */
+export async function readdir(path: string, options?: ReaddirOptions | BufferEncoding): Promise<string[] | Dirent[]> {
+  const opts = parseOptions<ReaddirOptions>(options, {});
+
+  if (isNode) {
+    return fsPromises.readdir(path, opts);
+  } else if (isBunOrDeno) {
+    // @ts-ignore
+    return processDenoEntriesAsync(Deno.readDir(path), opts.withFileTypes);
+  }
+
+  throw new Error('Unsupported runtime');
+}
+
+/**
+ * Read directory (sync)
+ */
+export function readdirSync(path: string, options?: ReaddirOptions | BufferEncoding): string[] | Dirent[] {
+  const opts = parseOptions<ReaddirOptions>(options, {});
+
+  if (isNode) {
+    return fs.readdirSync(path, opts);
+  } else if (isBunOrDeno) {
+    // @ts-ignore
+    return processDenoEntries(Deno.readDirSync(path), opts.withFileTypes);
+  }
+
+  throw new Error('Unsupported runtime');
+}
+
+/**
+ * Remove file (async)
+ */
+export async function unlink(path: string): Promise<void> {
+  if (isNode) {
+    return fsPromises.unlink(path);
+  } else if (isBun) {
+    // @ts-ignore
+    await Deno.remove(path);
+  } else if (isDeno) {
+    // @ts-ignore
+    await Deno.remove(path);
+  }
+}
+
+/**
+ * Remove file (sync)
+ */
+export function unlinkSync(path: string): void {
+  if (isNode) {
+    fs.unlinkSync(path);
+  } else if (isBun) {
+    // @ts-ignore
+    Deno.removeSync(path);
+  } else if (isDeno) {
+    // @ts-ignore
+    Deno.removeSync(path);
+  }
+}
+
+/**
+ * Remove directory (async)
+ */
+export async function rmdir(path: string, options?: { recursive?: boolean }): Promise<void> {
+  if (isNode) {
+    return fsPromises.rmdir(path, options);
+  } else if (isBun) {
+    // @ts-ignore
+    await Deno.remove(path, { recursive: options?.recursive });
+  } else if (isDeno) {
+    // @ts-ignore
+    await Deno.remove(path, { recursive: options?.recursive });
+  }
+}
+
+/**
+ * Remove directory (sync)
+ */
+export function rmdirSync(path: string, options?: { recursive?: boolean }): void {
+  if (isNode) {
+    fs.rmdirSync(path, options);
+  } else if (isBun) {
+    // @ts-ignore
+    Deno.removeSync(path, { recursive: options?.recursive });
+  } else if (isDeno) {
+    // @ts-ignore
+    Deno.removeSync(path, { recursive: options?.recursive });
+  }
+}
+
+/**
+ * Rename/move file (async)
+ */
+export async function rename(oldPath: string, newPath: string): Promise<void> {
+  if (isNode) {
+    return fsPromises.rename(oldPath, newPath);
+  } else if (isBun) {
+    // @ts-ignore
+    await Deno.rename(oldPath, newPath);
+  } else if (isDeno) {
+    // @ts-ignore
+    await Deno.rename(oldPath, newPath);
+  }
+}
+
+/**
+ * Rename/move file (sync)
+ */
+export function renameSync(oldPath: string, newPath: string): void {
+  if (isNode) {
+    fs.renameSync(oldPath, newPath);
+  } else if (isBun) {
+    // @ts-ignore
+    Deno.renameSync(oldPath, newPath);
+  } else if (isDeno) {
+    // @ts-ignore
+    Deno.renameSync(oldPath, newPath);
+  }
+}
+
+/**
+ * Copy file (async)
+ */
+export async function copyFile(src: string, dest: string, flags?: number): Promise<void> {
+  if (isNode) {
+    return fsPromises.copyFile(src, dest, flags);
+  } else if (isBun) {
+    // @ts-ignore
+    await Deno.copyFile(src, dest);
+  } else if (isDeno) {
+    // @ts-ignore
+    await Deno.copyFile(src, dest);
+  }
+}
+
+/**
+ * Copy file (sync)
+ */
+export function copyFileSync(src: string, dest: string, flags?: number): void {
+  if (isNode) {
+    fs.copyFileSync(src, dest, flags);
+  } else if (isBun) {
+    // @ts-ignore
+    Deno.copyFileSync(src, dest);
+  } else if (isDeno) {
+    // @ts-ignore
+    Deno.copyFileSync(src, dest);
+  }
+}
+
+/**
+ * Resolve pathname to absolute path (async)
+ */
+export async function realpath(path: string, options?: { encoding?: BufferEncoding }): Promise<string> {
+  if (isNode) {
+    return fsPromises.realpath(path, options);
+  } else if (isBun) {
+    // Bun supports fs.promises.realpath
+    const fs = require('fs/promises');
+    return fs.realpath(path, options);
+  } else if (isDeno) {
+    // @ts-ignore
+    return await Deno.realPath(path);
+  }
+  return path;
+}
+
+/**
+ * Resolve pathname to absolute path (sync)
+ */
+export function realpathSync(path: string, options?: { encoding?: BufferEncoding }): string {
+  if (isNode) {
+    return fs.realpathSync(path, options);
+  } else if (isBun) {
+    // Bun supports fs.realpathSync
+    const fs = require('fs');
+    return fs.realpathSync(path, options);
+  } else if (isDeno) {
+    // @ts-ignore
+    return Deno.realPathSync(path);
+  }
+  return path;
+}
+
+/**
+ * Helper: Create Stats object
+ */
+function createStatsObject(_path: string, size: number, isDir: boolean): Stats {
+  const now = Date.now();
+  return {
+    isFile: () => !isDir,
+    isDirectory: () => isDir,
+    isBlockDevice: () => false,
+    isCharacterDevice: () => false,
+    isSymbolicLink: () => false,
+    isFIFO: () => false,
+    isSocket: () => false,
+    dev: 0,
+    ino: 0,
+    mode: isDir ? 16877 : 33188,
+    nlink: 1,
+    uid: 0,
+    gid: 0,
+    rdev: 0,
+    size,
+    blksize: 4096,
+    blocks: Math.ceil(size / 512),
+    atimeMs: now,
+    mtimeMs: now,
+    ctimeMs: now,
+    birthtimeMs: now,
+    atime: new Date(now),
+    mtime: new Date(now),
+    ctime: new Date(now),
+    birthtime: new Date(now),
+  };
+}
+
+/**
+ * Helper: Create Stats from Deno FileInfo
+ */
+function createStatsFromDenoFileInfo(info: any): Stats {
+  return {
+    isFile: () => info.isFile,
+    isDirectory: () => info.isDirectory,
+    isBlockDevice: () => false,
+    isCharacterDevice: () => false,
+    isSymbolicLink: () => info.isSymlink || false,
+    isFIFO: () => false,
+    isSocket: () => false,
+    dev: info.dev || 0,
+    ino: info.ino || 0,
+    mode: info.mode || 0,
+    nlink: info.nlink || 1,
+    uid: info.uid || 0,
+    gid: info.gid || 0,
+    rdev: 0,
+    size: info.size,
+    blksize: info.blksize || 4096,
+    blocks: info.blocks || Math.ceil(info.size / 512),
+    atimeMs: info.atime?.getTime() || Date.now(),
+    mtimeMs: info.mtime?.getTime() || Date.now(),
+    ctimeMs: info.birthtime?.getTime() || Date.now(),
+    birthtimeMs: info.birthtime?.getTime() || Date.now(),
+    atime: info.atime || new Date(),
+    mtime: info.mtime || new Date(),
+    ctime: info.birthtime || new Date(),
+    birthtime: info.birthtime || new Date(),
+  };
+}
+
+/**
+ * Helper: Create Dirent from Deno DirEntry
+ */
+function createDirentFromDenoEntry(entry: any): Dirent {
+  return {
+    name: entry.name,
+    isFile: () => entry.isFile,
+    isDirectory: () => entry.isDirectory,
+    isBlockDevice: () => false,
+    isCharacterDevice: () => false,
+    isSymbolicLink: () => entry.isSymlink || false,
+    isFIFO: () => false,
+    isSocket: () => false,
+  };
+}
+
+/**
+ * Get current runtime
+ */
+export function getRuntime(): 'node' | 'bun' | 'deno' {
+  return runtime;
+}
+
+/**
+ * Promises API (re-export for compatibility)
+ */
+export const promises = {
+  readFile,
+  writeFile,
+  appendFile,
+  stat,
+  mkdir,
+  readdir,
+  unlink,
+  rmdir,
+  rename,
+  copyFile,
+  realpath,
+};
+
+/**
+ * Default export
+ */
+export default {
+  readFile,
+  readFileSync,
+  writeFile,
+  writeFileSync,
+  appendFile,
+  appendFileSync,
+  exists,
+  existsSync,
+  stat,
+  statSync,
+  mkdir,
+  mkdirSync,
+  readdir,
+  readdirSync,
+  unlink,
+  unlinkSync,
+  rmdir,
+  rmdirSync,
+  rename,
+  renameSync,
+  copyFile,
+  copyFileSync,
+  realpath,
+  realpathSync,
+  promises,
+  getRuntime,
+};