alepha 0.15.2 → 0.15.4

package/dist/server/static/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["nodeJoin","fsRm","fsCp","fsMkdir","fsReadFile","fsWriteFile"],"sources":["../../../src/server/static/primitives/$serve.ts","../../../src/system/providers/FileSystemProvider.ts","../../../src/system/providers/MemoryFileSystemProvider.ts","../../../src/system/providers/MemoryShellProvider.ts","../../../src/system/services/FileDetector.ts","../../../src/system/providers/NodeFileSystemProvider.ts","../../../src/system/providers/NodeShellProvider.ts","../../../src/system/providers/ShellProvider.ts","../../../src/system/index.ts","../../../src/server/static/providers/ServerStaticProvider.ts","../../../src/server/static/index.ts"],"sourcesContent":["import { createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\n\n/**\n * Create a new static file handler.\n */\nexport const $serve = (options: ServePrimitiveOptions = {}): ServePrimitive => {\n  return createPrimitive(ServePrimitive, options);\n};\n\nexport interface ServePrimitiveOptions {\n  /**\n   * Prefix for the served path.\n   *\n   * @default \"/\"\n   */\n  path?: string;\n\n  /**\n   * Path to the directory to serve.\n   *\n   * @default process.cwd()\n   */\n  root?: string;\n\n  /**\n   * If true, primitive will be ignored.\n   *\n   * @default false\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether to keep dot files (e.g. `.gitignore`, `.env`) in the served directory.\n   *\n   * @default true\n   */\n  ignoreDotEnvFiles?: boolean;\n\n  /**\n   * Whether to use the index.html file when the path is a directory.\n   *\n   * @default true\n   */\n  indexFallback?: boolean;\n\n  /**\n   * Force all requests \"not found\" to be served with the index.html file.\n   * This is useful for single-page applications (SPAs) that use client-side only routing.\n   */\n  historyApiFallback?: boolean;\n\n  /**\n   * Optional name of the primitive.\n   * This is used for logging and debugging purposes.\n   *\n   * @default Key name.\n   */\n  name?: string;\n\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default {}\n   */\n  cacheControl?: Partial<CacheControlOptions> | false;\n}\n\nexport interface CacheControlOptions {\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default [.js, .css]\n   */\n  fileTypes: string[];\n\n  /**\n   * The maximum age of the cache in seconds.\n   *\n   * @default 60 * 60 * 24 * 2 // 2 days\n   */\n  maxAge: DurationLike;\n\n  /**\n   * Whether to use immutable cache control headers.\n   *\n   * @default true\n   */\n  immutable: boolean;\n}\n\nexport class ServePrimitive extends Primitive<ServePrimitiveOptions> {}\n\n$serve[KIND] = ServePrimitive;\n","import type { FileLike, StreamLike } from \"alepha\";\n\n/**\n * Options for creating a file from a URL\n */\nexport interface CreateFileFromUrlOptions {\n  /**\n   * The URL to load the file from (file://, http://, or https://)\n   */\n  url: string;\n  /**\n   * The MIME type of the file (optional, will be detected from filename if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (optional, will be extracted from URL if not provided)\n   */\n  name?: string;\n}\n\n/**\n * Options for creating a file from a path (URL with file:// scheme)\n */\nexport interface CreateFileFromPathOptions {\n  /**\n   * The path to the file on the local filesystem\n   */\n  path: string;\n  /**\n   * The MIME type of the file (optional, will be detected from filename if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (optional, will be extracted from URL if not provided)\n   */\n  name?: string;\n}\n\n/**\n * Options for creating a file from a Buffer\n */\nexport interface CreateFileFromBufferOptions {\n  /**\n   * The Buffer containing the file data\n   */\n  buffer: Buffer;\n  /**\n   * The MIME type of the file (optional, will be detected from name if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (required for proper content type detection)\n   */\n  name?: string;\n}\n\n/**\n * Options for creating a file from a stream\n */\nexport interface CreateFileFromStreamOptions {\n  /**\n   * The readable stream containing the file data\n   */\n  stream: StreamLike;\n  /**\n   * The MIME type of the file (optional, will be detected from name if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (required for proper content type detection)\n   */\n  name?: string;\n  /**\n   * The size of the file in bytes (optional)\n   */\n  size?: number;\n}\n\n/**\n * Options for creating a file from text content\n */\nexport interface CreateFileFromTextOptions {\n  /**\n   * The text content to create the file from\n   */\n  text: string;\n  /**\n   * The MIME type of the file (default: text/plain)\n   */\n  type?: string;\n  /**\n   * The name of the file (default: \"file.txt\")\n   */\n  name?: string;\n}\n\nexport interface CreateFileFromResponseOptions {\n  /**\n   * The Response object containing the file data\n   */\n  response: Response;\n  /**\n   * Override the name (optional, uses filename from Content-Disposition header if not provided)\n   */\n  name?: string;\n  /**\n   * Override the MIME type (optional, uses file.type if not provided)\n   */\n  type?: string;\n}\n\n/**\n * Options for creating a file from a Web File object\n */\nexport interface CreateFileFromWebFileOptions {\n  /**\n   * The Web File object\n   */\n  file: File;\n  /**\n   * Override the MIME type (optional, uses file.type if not provided)\n   */\n  type?: string;\n  /**\n   * Override the name (optional, uses file.name if not provided)\n   */\n  name?: string;\n  /**\n   * Override the size (optional, uses file.size if not provided)\n   */\n  size?: number;\n}\n\n/**\n * Options for creating a file from an ArrayBuffer\n */\nexport interface CreateFileFromArrayBufferOptions {\n  /**\n   * The ArrayBuffer containing the file data\n   */\n  arrayBuffer: ArrayBuffer;\n  /**\n   * The MIME type of the file (optional, will be detected from name if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (required for proper content type detection)\n   */\n  name?: string;\n}\n\n/**\n * Union type for all createFile options\n */\nexport type CreateFileOptions =\n  | CreateFileFromUrlOptions\n  | CreateFileFromPathOptions\n  | CreateFileFromBufferOptions\n  | CreateFileFromStreamOptions\n  | CreateFileFromTextOptions\n  | CreateFileFromWebFileOptions\n  | CreateFileFromResponseOptions\n  | CreateFileFromArrayBufferOptions;\n\n/**\n * Options for rm (remove) operation\n */\nexport interface RmOptions {\n  /**\n   * If true, removes directories and their contents recursively\n   */\n  recursive?: boolean;\n  /**\n   * If true, no error will be thrown if the path does not exist\n   */\n  force?: boolean;\n}\n\n/**\n * Options for cp (copy) operation\n */\nexport interface CpOptions {\n  /**\n   * If true, copy directories recursively\n   */\n  recursive?: boolean;\n  /**\n   * If true, overwrite existing destination\n   */\n  force?: boolean;\n}\n\n/**\n * Options for mkdir operation\n */\nexport interface MkdirOptions {\n  /**\n   * If true, creates parent directories as needed\n   */\n  recursive?: boolean;\n  /**\n   * File mode (permission and sticky bits)\n   */\n  mode?: number;\n}\n\n/**\n * Options for ls (list) operation\n */\nexport interface LsOptions {\n  /**\n   * If true, list contents of directories recursively\n   */\n  recursive?: boolean;\n  /**\n   * If true, include hidden files (starting with .)\n   */\n  hidden?: boolean;\n}\n\n/**\n * FileSystem interface providing utilities for working with files.\n */\nexport abstract class FileSystemProvider {\n  /**\n   * Joins multiple path segments into a single path.\n   *\n   * @param paths - The path segments to join\n   * @returns The joined path\n   */\n  abstract join(...paths: string[]): string;\n\n  /**\n   * Creates a FileLike object from various sources.\n   *\n   * @param options - Options for creating the file\n   * @returns A FileLike object\n   */\n  abstract createFile(options: CreateFileOptions): FileLike;\n\n  /**\n   * Removes a file or directory.\n   *\n   * @param path - The path to remove\n   * @param options - Remove options\n   */\n  abstract rm(path: string, options?: RmOptions): Promise<void>;\n\n  /**\n   * Copies a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   * @param options - Copy options\n   */\n  abstract cp(src: string, dest: string, options?: CpOptions): Promise<void>;\n\n  /**\n   * Moves/renames a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   */\n  abstract mv(src: string, dest: string): Promise<void>;\n\n  /**\n   * Creates a directory.\n   *\n   * @param path - The directory path to create\n   * @param options - Mkdir options\n   */\n  abstract mkdir(path: string, options?: MkdirOptions): Promise<void>;\n\n  /**\n   * Lists files in a directory.\n   *\n   * @param path - The directory path to list\n   * @param options - List options\n   * @returns Array of filenames\n   */\n  abstract ls(path: string, options?: LsOptions): Promise<string[]>;\n\n  /**\n   * Checks if a file or directory exists.\n   *\n   * @param path - The path to check\n   * @returns True if the path exists, false otherwise\n   */\n  abstract exists(path: string): Promise<boolean>;\n\n  /**\n   * Reads the content of a file.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a Buffer\n   */\n  abstract readFile(path: string): Promise<Buffer>;\n\n  /**\n   * Writes data to a file.\n   *\n   * @param path - The file path to write to\n   * @param data - The data to write (Buffer or string)\n   */\n  abstract writeFile(\n    path: string,\n    data: Uint8Array | Buffer | string | FileLike,\n  ): Promise<void>;\n\n  /**\n   * Reads the content of a file as a string.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a string\n   */\n  abstract readTextFile(path: string): Promise<string>;\n\n  /**\n   * Reads the content of a file as JSON.\n   *\n   * @param path - The file path to read\n   * @returns The parsed JSON content\n   */\n  abstract readJsonFile<T = unknown>(path: string): Promise<T>;\n}\n","import { join as nodeJoin } from \"node:path\";\nimport { $inject, type FileLike, Json } from \"alepha\";\nimport type {\n  CpOptions,\n  CreateFileOptions,\n  FileSystemProvider,\n  LsOptions,\n  MkdirOptions,\n  RmOptions,\n} from \"./FileSystemProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryFileSystemProviderOptions {\n  /**\n   * Error to throw on mkdir operations (for testing error handling)\n   */\n  mkdirError?: Error | null;\n  /**\n   * Error to throw on writeFile operations (for testing error handling)\n   */\n  writeFileError?: Error | null;\n  /**\n   * Error to throw on readFile operations (for testing error handling)\n   */\n  readFileError?: Error | null;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In-memory implementation of FileSystemProvider for testing.\n *\n * This provider stores all files and directories in memory, making it ideal for\n * unit tests that need to verify file operations without touching the real file system.\n *\n * @example\n * ```typescript\n * // In tests, substitute the real FileSystemProvider with MemoryFileSystemProvider\n * const alepha = Alepha.create().with({\n *   provide: FileSystemProvider,\n *   use: MemoryFileSystemProvider,\n * });\n *\n * // Run code that uses FileSystemProvider\n * const service = alepha.inject(MyService);\n * await service.saveFile(\"test.txt\", \"Hello World\");\n *\n * // Verify the file was written\n * const memoryFs = alepha.inject(MemoryFileSystemProvider);\n * expect(memoryFs.files.get(\"test.txt\")?.toString()).toBe(\"Hello World\");\n * ```\n */\nexport class MemoryFileSystemProvider implements FileSystemProvider {\n  protected json = $inject(Json);\n\n  /**\n   * In-memory storage for files (path -> content)\n   */\n  public files = new Map<string, Buffer>();\n\n  /**\n   * In-memory storage for directories\n   */\n  public directories = new Set<string>();\n\n  /**\n   * Track mkdir calls for test assertions\n   */\n  public mkdirCalls: Array<{ path: string; options?: MkdirOptions }> = [];\n\n  /**\n   * Track writeFile calls for test assertions\n   */\n  public writeFileCalls: Array<{ path: string; data: string }> = [];\n\n  /**\n   * Track readFile calls for test assertions\n   */\n  public readFileCalls: Array<string> = [];\n\n  /**\n   * Track rm calls for test assertions\n   */\n  public rmCalls: Array<{ path: string; options?: RmOptions }> = [];\n\n  /**\n   * Track join calls for test assertions\n   */\n  public joinCalls: Array<string[]> = [];\n\n  /**\n   * Error to throw on mkdir (for testing error handling)\n   */\n  public mkdirError: Error | null = null;\n\n  /**\n   * Error to throw on writeFile (for testing error handling)\n   */\n  public writeFileError: Error | null = null;\n\n  /**\n   * Error to throw on readFile (for testing error handling)\n   */\n  public readFileError: Error | null = null;\n\n  constructor(options: MemoryFileSystemProviderOptions = {}) {\n    this.mkdirError = options.mkdirError ?? null;\n    this.writeFileError = options.writeFileError ?? null;\n    this.readFileError = options.readFileError ?? null;\n  }\n\n  /**\n   * Join path segments using forward slashes.\n   * Uses Node's path.join for proper normalization (handles .. and .)\n   */\n  public join(...paths: string[]): string {\n    this.joinCalls.push(paths);\n    return nodeJoin(...paths);\n  }\n\n  /**\n   * Create a FileLike object from various sources.\n   */\n  public createFile(options: CreateFileOptions): FileLike {\n    if (\"path\" in options) {\n      const filePath = options.path;\n      const buffer = this.files.get(filePath);\n      if (buffer === undefined) {\n        throw new Error(\n          `ENOENT: no such file or directory, open '${filePath}'`,\n        );\n      }\n      return {\n        name: options.name ?? filePath.split(\"/\").pop() ?? \"file\",\n        type: options.type ?? \"application/octet-stream\",\n        size: buffer.byteLength,\n        lastModified: Date.now(),\n        stream: () => {\n          throw new Error(\"Stream not implemented in MemoryFileSystemProvider\");\n        },\n        arrayBuffer: async (): Promise<ArrayBuffer> =>\n          buffer.buffer.slice(\n            buffer.byteOffset,\n            buffer.byteOffset + buffer.byteLength,\n          ) as ArrayBuffer,\n        text: async () => buffer.toString(\"utf-8\"),\n      };\n    }\n\n    if (\"buffer\" in options) {\n      const buffer = options.buffer;\n      return {\n        name: options.name ?? \"file\",\n        type: options.type ?? \"application/octet-stream\",\n        size: buffer.byteLength,\n        lastModified: Date.now(),\n        stream: () => {\n          throw new Error(\"Stream not implemented in MemoryFileSystemProvider\");\n        },\n        arrayBuffer: async (): Promise<ArrayBuffer> =>\n          buffer.buffer.slice(\n            buffer.byteOffset,\n            buffer.byteOffset + buffer.byteLength,\n          ) as ArrayBuffer,\n        text: async () => buffer.toString(\"utf-8\"),\n      };\n    }\n\n    if (\"text\" in options) {\n      const buffer = Buffer.from(options.text, \"utf-8\");\n      return {\n        name: options.name ?? \"file.txt\",\n        type: options.type ?? \"text/plain\",\n        size: buffer.byteLength,\n        lastModified: Date.now(),\n        stream: () => {\n          throw new Error(\"Stream not implemented in MemoryFileSystemProvider\");\n        },\n        arrayBuffer: async (): Promise<ArrayBuffer> =>\n          buffer.buffer.slice(\n            buffer.byteOffset,\n            buffer.byteOffset + buffer.byteLength,\n          ) as ArrayBuffer,\n        text: async () => options.text,\n      };\n    }\n\n    throw new Error(\n      \"MemoryFileSystemProvider.createFile: unsupported options. Only buffer and text are supported.\",\n    );\n  }\n\n  /**\n   * Remove a file or directory from memory.\n   */\n  public async rm(path: string, options?: RmOptions): Promise<void> {\n    this.rmCalls.push({ path, options });\n\n    const exists = this.files.has(path) || this.directories.has(path);\n\n    if (!exists && !options?.force) {\n      throw new Error(`ENOENT: no such file or directory, rm '${path}'`);\n    }\n\n    if (this.directories.has(path)) {\n      if (options?.recursive) {\n        // Remove directory and all contents\n        this.directories.delete(path);\n        for (const filePath of this.files.keys()) {\n          if (filePath.startsWith(`${path}/`)) {\n            this.files.delete(filePath);\n          }\n        }\n        for (const dirPath of this.directories) {\n          if (dirPath.startsWith(`${path}/`)) {\n            this.directories.delete(dirPath);\n          }\n        }\n      } else {\n        throw new Error(\n          `EISDIR: illegal operation on a directory, rm '${path}'`,\n        );\n      }\n    } else {\n      this.files.delete(path);\n    }\n  }\n\n  /**\n   * Copy a file or directory in memory.\n   */\n  public async cp(\n    src: string,\n    dest: string,\n    options?: CpOptions,\n  ): Promise<void> {\n    if (this.directories.has(src)) {\n      if (!options?.recursive) {\n        throw new Error(\n          `Cannot copy directory without recursive option: ${src}`,\n        );\n      }\n      // Copy directory and contents\n      this.directories.add(dest);\n      for (const [filePath, content] of this.files) {\n        if (filePath.startsWith(`${src}/`)) {\n          const newPath = filePath.replace(src, dest);\n          this.files.set(newPath, Buffer.from(content));\n        }\n      }\n    } else if (this.files.has(src)) {\n      const content = this.files.get(src)!;\n      this.files.set(dest, Buffer.from(content));\n    } else {\n      throw new Error(`ENOENT: no such file or directory, cp '${src}'`);\n    }\n  }\n\n  /**\n   * Move/rename a file or directory in memory.\n   */\n  public async mv(src: string, dest: string): Promise<void> {\n    if (this.directories.has(src)) {\n      // Move directory and contents\n      this.directories.delete(src);\n      this.directories.add(dest);\n      for (const [filePath, content] of this.files) {\n        if (filePath.startsWith(`${src}/`)) {\n          const newPath = filePath.replace(src, dest);\n          this.files.delete(filePath);\n          this.files.set(newPath, content);\n        }\n      }\n    } else if (this.files.has(src)) {\n      const content = this.files.get(src)!;\n      this.files.delete(src);\n      this.files.set(dest, content);\n    } else {\n      throw new Error(`ENOENT: no such file or directory, mv '${src}'`);\n    }\n  }\n\n  /**\n   * Create a directory in memory.\n   */\n  public async mkdir(path: string, options?: MkdirOptions): Promise<void> {\n    this.mkdirCalls.push({ path, options });\n\n    if (this.mkdirError) {\n      throw this.mkdirError;\n    }\n\n    if (this.directories.has(path) && !options?.recursive) {\n      throw new Error(`EEXIST: file already exists, mkdir '${path}'`);\n    }\n\n    this.directories.add(path);\n\n    // If recursive, create parent directories\n    if (options?.recursive) {\n      const parts = path.split(\"/\").filter(Boolean);\n      let current = \"\";\n      for (const part of parts) {\n        current = current ? `${current}/${part}` : part;\n        this.directories.add(current);\n      }\n    }\n  }\n\n  /**\n   * List files in a directory.\n   */\n  public async ls(path: string, options?: LsOptions): Promise<string[]> {\n    const normalizedPath = path.replace(/\\/$/, \"\");\n    const entries = new Set<string>();\n\n    // Find files in the directory\n    for (const filePath of this.files.keys()) {\n      if (filePath.startsWith(`${normalizedPath}/`)) {\n        const relativePath = filePath.slice(normalizedPath.length + 1);\n        const parts = relativePath.split(\"/\");\n\n        if (options?.recursive) {\n          entries.add(relativePath);\n        } else {\n          entries.add(parts[0]);\n        }\n      }\n    }\n\n    // Find subdirectories\n    for (const dirPath of this.directories) {\n      if (\n        dirPath.startsWith(`${normalizedPath}/`) &&\n        dirPath !== normalizedPath\n      ) {\n        const relativePath = dirPath.slice(normalizedPath.length + 1);\n        const parts = relativePath.split(\"/\");\n\n        if (options?.recursive) {\n          entries.add(relativePath);\n        } else if (parts.length === 1) {\n          entries.add(parts[0]);\n        }\n      }\n    }\n\n    let result = Array.from(entries);\n\n    // Filter hidden files unless requested\n    if (!options?.hidden) {\n      result = result.filter((entry) => !entry.startsWith(\".\"));\n    }\n\n    return result.sort();\n  }\n\n  /**\n   * Check if a file or directory exists in memory.\n   */\n  public async exists(path: string): Promise<boolean> {\n    return this.files.has(path) || this.directories.has(path);\n  }\n\n  /**\n   * Read a file from memory.\n   */\n  public async readFile(path: string): Promise<Buffer> {\n    this.readFileCalls.push(path);\n\n    if (this.readFileError) {\n      throw this.readFileError;\n    }\n\n    const content = this.files.get(path);\n    if (!content) {\n      throw new Error(`ENOENT: no such file or directory, open '${path}'`);\n    }\n    return content;\n  }\n\n  /**\n   * Read a file from memory as text.\n   */\n  public async readTextFile(path: string): Promise<string> {\n    const buffer = await this.readFile(path);\n    return buffer.toString(\"utf-8\");\n  }\n\n  /**\n   * Read a file from memory as JSON.\n   */\n  public async readJsonFile<T = unknown>(path: string): Promise<T> {\n    const text = await this.readTextFile(path);\n    return this.json.parse(text) as T;\n  }\n\n  /**\n   * Write a file to memory.\n   */\n  public async writeFile(\n    path: string,\n    data: Uint8Array | Buffer | string | FileLike,\n  ): Promise<void> {\n    const dataStr =\n      typeof data === \"string\"\n        ? data\n        : data instanceof Buffer || data instanceof Uint8Array\n          ? data.toString(\"utf-8\")\n          : await data.text();\n\n    this.writeFileCalls.push({ path, data: dataStr });\n\n    if (this.writeFileError) {\n      throw this.writeFileError;\n    }\n\n    const buffer =\n      typeof data === \"string\"\n        ? Buffer.from(data, \"utf-8\")\n        : data instanceof Buffer\n          ? data\n          : data instanceof Uint8Array\n            ? Buffer.from(data)\n            : Buffer.from(await data.text(), \"utf-8\");\n\n    this.files.set(path, buffer);\n  }\n\n  /**\n   * Reset all in-memory state (useful between tests).\n   */\n  public reset(): void {\n    this.files.clear();\n    this.directories.clear();\n    this.mkdirCalls = [];\n    this.writeFileCalls = [];\n    this.readFileCalls = [];\n    this.rmCalls = [];\n    this.joinCalls = [];\n    this.mkdirError = null;\n    this.writeFileError = null;\n    this.readFileError = null;\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Test assertion helpers\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Check if a file was written during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasWritten(\"/project/tsconfig.json\")).toBe(true);\n   * ```\n   */\n  public wasWritten(path: string): boolean {\n    return this.writeFileCalls.some((call) => call.path === path);\n  }\n\n  /**\n   * Check if a file was written with content matching a pattern.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasWrittenMatching(\"/project/tsconfig.json\", /extends/)).toBe(true);\n   * ```\n   */\n  public wasWrittenMatching(path: string, pattern: RegExp): boolean {\n    const call = this.writeFileCalls.find((c) => c.path === path);\n    return call ? pattern.test(call.data) : false;\n  }\n\n  /**\n   * Check if a file was read during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasRead(\"/project/package.json\")).toBe(true);\n   * ```\n   */\n  public wasRead(path: string): boolean {\n    return this.readFileCalls.includes(path);\n  }\n\n  /**\n   * Check if a file was deleted during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasDeleted(\"/project/old-file.txt\")).toBe(true);\n   * ```\n   */\n  public wasDeleted(path: string): boolean {\n    return this.rmCalls.some((call) => call.path === path);\n  }\n\n  /**\n   * Get the content of a file as a string (convenience method for testing).\n   */\n  public getFileContent(path: string): string | undefined {\n    return this.files.get(path)?.toString(\"utf-8\");\n  }\n}\n","import type { ShellProvider, ShellRunOptions } from \"./ShellProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryShellCall {\n  command: string;\n  options: ShellRunOptions;\n}\n\nexport interface MemoryShellProviderOptions {\n  /**\n   * Simulated outputs for specific commands.\n   * Key is the command string, value is the stdout to return.\n   */\n  outputs?: Record<string, string>;\n\n  /**\n   * Commands that should throw an error.\n   * Key is the command string, value is the error message.\n   */\n  errors?: Record<string, string>;\n\n  /**\n   * Commands that are considered \"installed\" in the system PATH.\n   */\n  installedCommands?: string[];\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In-memory implementation of ShellProvider for testing.\n *\n * Records all commands that would be executed without actually running them.\n * Can be configured to return specific outputs or throw errors for testing.\n *\n * @example\n * ```typescript\n * // In tests, substitute the real ShellProvider with MemoryShellProvider\n * const alepha = Alepha.create().with({\n *   provide: ShellProvider,\n *   use: MemoryShellProvider,\n * });\n *\n * // Configure mock behavior\n * const shell = alepha.inject(MemoryShellProvider);\n * shell.configure({\n *   outputs: { \"echo hello\": \"hello\\n\" },\n *   errors: { \"failing-cmd\": \"Command failed\" },\n * });\n *\n * // Or use the fluent API\n * shell.outputs.set(\"another-cmd\", \"output\");\n * shell.errors.set(\"another-error\", \"Error message\");\n *\n * // Run code that uses ShellProvider\n * const service = alepha.inject(MyService);\n * await service.doSomething();\n *\n * // Verify commands were called\n * expect(shell.calls).toHaveLength(2);\n * expect(shell.calls[0].command).toBe(\"yarn install\");\n * ```\n */\nexport class MemoryShellProvider implements ShellProvider {\n  /**\n   * All recorded shell calls.\n   */\n  public calls: MemoryShellCall[] = [];\n\n  /**\n   * Simulated outputs for specific commands.\n   */\n  public outputs = new Map<string, string>();\n\n  /**\n   * Commands that should throw an error.\n   */\n  public errors = new Map<string, string>();\n\n  /**\n   * Commands considered installed in the system PATH.\n   */\n  public installedCommands = new Set<string>();\n\n  /**\n   * Configure the mock with predefined outputs, errors, and installed commands.\n   */\n  public configure(options: MemoryShellProviderOptions): this {\n    if (options.outputs) {\n      for (const [cmd, output] of Object.entries(options.outputs)) {\n        this.outputs.set(cmd, output);\n      }\n    }\n    if (options.errors) {\n      for (const [cmd, error] of Object.entries(options.errors)) {\n        this.errors.set(cmd, error);\n      }\n    }\n    if (options.installedCommands) {\n      for (const cmd of options.installedCommands) {\n        this.installedCommands.add(cmd);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * Record command and return simulated output.\n   */\n  public async run(\n    command: string,\n    options: ShellRunOptions = {},\n  ): Promise<string> {\n    this.calls.push({ command, options });\n\n    // Check for configured error\n    const errorMsg = this.errors.get(command);\n    if (errorMsg) {\n      throw new Error(errorMsg);\n    }\n\n    // Return configured output or empty string\n    return this.outputs.get(command) ?? \"\";\n  }\n\n  /**\n   * Check if a specific command was called.\n   */\n  public wasCalled(command: string): boolean {\n    return this.calls.some((call) => call.command === command);\n  }\n\n  /**\n   * Check if a command matching a pattern was called.\n   */\n  public wasCalledMatching(pattern: RegExp): boolean {\n    return this.calls.some((call) => pattern.test(call.command));\n  }\n\n  /**\n   * Get all calls matching a pattern.\n   */\n  public getCallsMatching(pattern: RegExp): MemoryShellCall[] {\n    return this.calls.filter((call) => pattern.test(call.command));\n  }\n\n  /**\n   * Check if a command is installed.\n   */\n  public async isInstalled(command: string): Promise<boolean> {\n    return this.installedCommands.has(command);\n  }\n\n  /**\n   * Reset all recorded state.\n   */\n  public reset(): void {\n    this.calls = [];\n    this.outputs.clear();\n    this.errors.clear();\n    this.installedCommands.clear();\n  }\n}\n","import { Readable } from \"node:stream\";\n\nexport interface FileTypeResult {\n  /**\n   * The detected MIME type\n   */\n  mimeType: string;\n  /**\n   * The detected file extension\n   */\n  extension: string;\n  /**\n   * Whether the file type was verified by magic bytes\n   */\n  verified: boolean;\n  /**\n   * The stream (potentially wrapped to allow re-reading)\n   */\n  stream: Readable;\n}\n\n/**\n * Service for detecting file types and getting content types.\n *\n * @example\n * ```typescript\n * const detector = alepha.inject(FileDetector);\n *\n * // Get content type from filename\n * const mimeType = detector.getContentType(\"image.png\"); // \"image/png\"\n *\n * // Detect file type by magic bytes\n * const stream = createReadStream('image.png');\n * const result = await detector.detectFileType(stream, 'image.png');\n * console.log(result.mimeType); // 'image/png'\n * console.log(result.verified); // true if magic bytes match\n * ```\n */\nexport class FileDetector {\n  /**\n   * Magic byte signatures for common file formats.\n   * Each signature is represented as an array of bytes or null (wildcard).\n   */\n  protected static readonly MAGIC_BYTES: Record<\n    string,\n    { signature: (number | null)[]; mimeType: string }[]\n  > = {\n    // Images\n    png: [\n      {\n        signature: [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a],\n        mimeType: \"image/png\",\n      },\n    ],\n    jpg: [\n      { signature: [0xff, 0xd8, 0xff, 0xe0], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe1], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe2], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe3], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe8], mimeType: \"image/jpeg\" },\n    ],\n    jpeg: [\n      { signature: [0xff, 0xd8, 0xff, 0xe0], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe1], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe2], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe3], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe8], mimeType: \"image/jpeg\" },\n    ],\n    gif: [\n      {\n        signature: [0x47, 0x49, 0x46, 0x38, 0x37, 0x61],\n        mimeType: \"image/gif\",\n      }, // GIF87a\n      {\n        signature: [0x47, 0x49, 0x46, 0x38, 0x39, 0x61],\n        mimeType: \"image/gif\",\n      }, // GIF89a\n    ],\n    webp: [\n      {\n        signature: [\n          0x52,\n          0x49,\n          0x46,\n          0x46,\n          null,\n          null,\n          null,\n          null,\n          0x57,\n          0x45,\n          0x42,\n          0x50,\n        ],\n        mimeType: \"image/webp\",\n      },\n    ],\n    bmp: [{ signature: [0x42, 0x4d], mimeType: \"image/bmp\" }],\n    ico: [{ signature: [0x00, 0x00, 0x01, 0x00], mimeType: \"image/x-icon\" }],\n    tiff: [\n      { signature: [0x49, 0x49, 0x2a, 0x00], mimeType: \"image/tiff\" }, // Little-endian\n      { signature: [0x4d, 0x4d, 0x00, 0x2a], mimeType: \"image/tiff\" }, // Big-endian\n    ],\n    tif: [\n      { signature: [0x49, 0x49, 0x2a, 0x00], mimeType: \"image/tiff\" },\n      { signature: [0x4d, 0x4d, 0x00, 0x2a], mimeType: \"image/tiff\" },\n    ],\n\n    // Documents\n    pdf: [\n      {\n        signature: [0x25, 0x50, 0x44, 0x46, 0x2d],\n        mimeType: \"application/pdf\",\n      },\n    ], // %PDF-\n    zip: [\n      { signature: [0x50, 0x4b, 0x03, 0x04], mimeType: \"application/zip\" },\n      { signature: [0x50, 0x4b, 0x05, 0x06], mimeType: \"application/zip\" },\n      { signature: [0x50, 0x4b, 0x07, 0x08], mimeType: \"application/zip\" },\n    ],\n\n    // Archives\n    rar: [\n      {\n        signature: [0x52, 0x61, 0x72, 0x21, 0x1a, 0x07],\n        mimeType: \"application/vnd.rar\",\n      },\n    ],\n    \"7z\": [\n      {\n        signature: [0x37, 0x7a, 0xbc, 0xaf, 0x27, 0x1c],\n        mimeType: \"application/x-7z-compressed\",\n      },\n    ],\n    tar: [\n      {\n        signature: [0x75, 0x73, 0x74, 0x61, 0x72],\n        mimeType: \"application/x-tar\",\n      },\n    ],\n    gz: [{ signature: [0x1f, 0x8b], mimeType: \"application/gzip\" }],\n    tgz: [{ signature: [0x1f, 0x8b], mimeType: \"application/gzip\" }],\n\n    // Audio\n    mp3: [\n      { signature: [0xff, 0xfb], mimeType: \"audio/mpeg\" },\n      { signature: [0xff, 0xf3], mimeType: \"audio/mpeg\" },\n      { signature: [0xff, 0xf2], mimeType: \"audio/mpeg\" },\n      { signature: [0x49, 0x44, 0x33], mimeType: \"audio/mpeg\" }, // ID3\n    ],\n    wav: [\n      {\n        signature: [\n          0x52,\n          0x49,\n          0x46,\n          0x46,\n          null,\n          null,\n          null,\n          null,\n          0x57,\n          0x41,\n          0x56,\n          0x45,\n        ],\n        mimeType: \"audio/wav\",\n      },\n    ],\n    ogg: [{ signature: [0x4f, 0x67, 0x67, 0x53], mimeType: \"audio/ogg\" }],\n    flac: [{ signature: [0x66, 0x4c, 0x61, 0x43], mimeType: \"audio/flac\" }], // fLaC\n\n    // Video\n    mp4: [\n      {\n        signature: [null, null, null, null, 0x66, 0x74, 0x79, 0x70],\n        mimeType: \"video/mp4\",\n      }, // ftyp\n      {\n        signature: [\n          null,\n          null,\n          null,\n          null,\n          0x66,\n          0x74,\n          0x79,\n          0x70,\n          0x69,\n          0x73,\n          0x6f,\n          0x6d,\n        ],\n        mimeType: \"video/mp4\",\n      }, // ftypisom\n      {\n        signature: [\n          null,\n          null,\n          null,\n          null,\n          0x66,\n          0x74,\n          0x79,\n          0x70,\n          0x6d,\n          0x70,\n          0x34,\n          0x32,\n        ],\n        mimeType: \"video/mp4\",\n      }, // ftypmp42\n    ],\n    webm: [{ signature: [0x1a, 0x45, 0xdf, 0xa3], mimeType: \"video/webm\" }],\n    avi: [\n      {\n        signature: [\n          0x52,\n          0x49,\n          0x46,\n          0x46,\n          null,\n          null,\n          null,\n          null,\n          0x41,\n          0x56,\n          0x49,\n          0x20,\n        ],\n        mimeType: \"video/x-msvideo\",\n      },\n    ],\n    mov: [\n      {\n        signature: [\n          null,\n          null,\n          null,\n          null,\n          0x66,\n          0x74,\n          0x79,\n          0x70,\n          0x71,\n          0x74,\n          0x20,\n          0x20,\n        ],\n        mimeType: \"video/quicktime\",\n      },\n    ],\n    mkv: [\n      { signature: [0x1a, 0x45, 0xdf, 0xa3], mimeType: \"video/x-matroska\" },\n    ],\n\n    // Office (DOCX, XLSX, PPTX are all ZIP-based)\n    docx: [\n      {\n        signature: [0x50, 0x4b, 0x03, 0x04],\n        mimeType:\n          \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n      },\n    ],\n    xlsx: [\n      {\n        signature: [0x50, 0x4b, 0x03, 0x04],\n        mimeType:\n          \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n      },\n    ],\n    pptx: [\n      {\n        signature: [0x50, 0x4b, 0x03, 0x04],\n        mimeType:\n          \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n      },\n    ],\n    doc: [\n      {\n        signature: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1],\n        mimeType: \"application/msword\",\n      },\n    ],\n    xls: [\n      {\n        signature: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1],\n        mimeType: \"application/vnd.ms-excel\",\n      },\n    ],\n    ppt: [\n      {\n        signature: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1],\n        mimeType: \"application/vnd.ms-powerpoint\",\n      },\n    ],\n  };\n\n  /**\n   * All possible format signatures for checking against actual file content\n   */\n  protected static readonly ALL_SIGNATURES = Object.entries(\n    FileDetector.MAGIC_BYTES,\n  ).flatMap(([ext, signatures]) => signatures.map((sig) => ({ ext, ...sig })));\n\n  /**\n   * MIME type map for file extensions.\n   *\n   * Can be used to get the content type of file based on its extension.\n   * Feel free to add more mime types in your project!\n   */\n  public static readonly mimeMap: Record<string, string> = {\n    // Documents\n    json: \"application/json\",\n    txt: \"text/plain\",\n    html: \"text/html\",\n    htm: \"text/html\",\n    xml: \"application/xml\",\n    csv: \"text/csv\",\n    pdf: \"application/pdf\",\n    md: \"text/markdown\",\n    markdown: \"text/markdown\",\n    rtf: \"application/rtf\",\n\n    // Styles and scripts\n    css: \"text/css\",\n    js: \"application/javascript\",\n    mjs: \"application/javascript\",\n    ts: \"application/typescript\",\n    jsx: \"text/jsx\",\n    tsx: \"text/tsx\",\n\n    // Archives\n    zip: \"application/zip\",\n    rar: \"application/vnd.rar\",\n    \"7z\": \"application/x-7z-compressed\",\n    tar: \"application/x-tar\",\n    gz: \"application/gzip\",\n    tgz: \"application/gzip\",\n\n    // Images\n    png: \"image/png\",\n    jpg: \"image/jpeg\",\n    jpeg: \"image/jpeg\",\n    gif: \"image/gif\",\n    webp: \"image/webp\",\n    svg: \"image/svg+xml\",\n    bmp: \"image/bmp\",\n    ico: \"image/x-icon\",\n    tiff: \"image/tiff\",\n    tif: \"image/tiff\",\n\n    // Audio\n    mp3: \"audio/mpeg\",\n    wav: \"audio/wav\",\n    ogg: \"audio/ogg\",\n    m4a: \"audio/mp4\",\n    aac: \"audio/aac\",\n    flac: \"audio/flac\",\n\n    // Video\n    mp4: \"video/mp4\",\n    webm: \"video/webm\",\n    avi: \"video/x-msvideo\",\n    mov: \"video/quicktime\",\n    wmv: \"video/x-ms-wmv\",\n    flv: \"video/x-flv\",\n    mkv: \"video/x-matroska\",\n\n    // Office\n    doc: \"application/msword\",\n    docx: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n    xls: \"application/vnd.ms-excel\",\n    xlsx: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n    ppt: \"application/vnd.ms-powerpoint\",\n    pptx: \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n\n    // Fonts\n    woff: \"font/woff\",\n    woff2: \"font/woff2\",\n    ttf: \"font/ttf\",\n    otf: \"font/otf\",\n    eot: \"application/vnd.ms-fontobject\",\n  };\n\n  /**\n   * Reverse MIME type map for looking up extensions from MIME types.\n   * Prefers shorter, more common extensions when multiple exist.\n   */\n  protected static readonly reverseMimeMap: Record<string, string> = (() => {\n    const reverse: Record<string, string> = {};\n    // Process in order so common extensions come first\n    for (const [ext, mimeType] of Object.entries(FileDetector.mimeMap)) {\n      // Only set if not already set (prefer first/shorter extension)\n      if (!reverse[mimeType]) {\n        reverse[mimeType] = ext;\n      }\n    }\n    return reverse;\n  })();\n\n  /**\n   * Returns the file extension for a given MIME type.\n   *\n   * @param mimeType - The MIME type to look up\n   * @returns The file extension (without dot), or \"bin\" if not found\n   *\n   * @example\n   * ```typescript\n   * const detector = alepha.inject(FileDetector);\n   * const ext = detector.getExtensionFromMimeType(\"image/png\"); // \"png\"\n   * const ext2 = detector.getExtensionFromMimeType(\"application/octet-stream\"); // \"bin\"\n   * ```\n   */\n  getExtensionFromMimeType(mimeType: string): string {\n    return FileDetector.reverseMimeMap[mimeType] || \"bin\";\n  }\n  /**\n   * Returns the content type of file based on its filename.\n   *\n   * @param filename - The filename to check\n   * @returns The MIME type\n   *\n   * @example\n   * ```typescript\n   * const detector = alepha.inject(FileDetector);\n   * const mimeType = detector.getContentType(\"image.png\"); // \"image/png\"\n   * ```\n   */\n  getContentType(filename: string): string {\n    const ext = filename.toLowerCase().split(\".\").pop() || \"\";\n    return FileDetector.mimeMap[ext] || \"application/octet-stream\";\n  }\n\n  /**\n   * Detects the file type by checking magic bytes against the stream content.\n   *\n   * @param stream - The readable stream to check\n   * @param filename - The filename (used to get the extension)\n   * @returns File type information including MIME type, extension, and verification status\n   *\n   * @example\n   * ```typescript\n   * const detector = alepha.inject(FileDetector);\n   * const stream = createReadStream('image.png');\n   * const result = await detector.detectFileType(stream, 'image.png');\n   * console.log(result.mimeType); // 'image/png'\n   * console.log(result.verified); // true if magic bytes match\n   * ```\n   */\n  async detectFileType(\n    stream: Readable,\n    filename: string,\n  ): Promise<FileTypeResult> {\n    // Get the expected MIME type from the filename extension\n    const expectedMimeType = this.getContentType(filename);\n\n    // Extract extension - only if filename contains a dot\n    const lastDotIndex = filename.lastIndexOf(\".\");\n    const ext =\n      lastDotIndex > 0\n        ? filename.substring(lastDotIndex + 1).toLowerCase()\n        : \"\";\n\n    // Read the first 16 bytes (enough for most magic byte checks)\n    const { buffer, stream: newStream } = await this.peekBytes(stream, 16);\n\n    // First, check if the extension's expected signature matches\n    const expectedSignatures = FileDetector.MAGIC_BYTES[ext];\n    if (expectedSignatures) {\n      for (const { signature, mimeType } of expectedSignatures) {\n        if (this.matchesSignature(buffer, signature)) {\n          return {\n            mimeType,\n            extension: ext,\n            verified: true,\n            stream: newStream,\n          };\n        }\n      }\n    }\n\n    // If the expected signature didn't match, try all other signatures\n    for (const {\n      ext: detectedExt,\n      signature,\n      mimeType,\n    } of FileDetector.ALL_SIGNATURES) {\n      if (detectedExt !== ext && this.matchesSignature(buffer, signature)) {\n        return {\n          mimeType,\n          extension: detectedExt,\n          verified: true,\n          stream: newStream,\n        };\n      }\n    }\n\n    // If no magic bytes matched, fall back to extension-based detection\n    // or return binary if extension is not recognized\n    return {\n      mimeType: expectedMimeType,\n      extension: ext,\n      verified: false,\n      stream: newStream,\n    };\n  }\n\n  /**\n   * Reads all bytes from a stream and returns the first N bytes along with a new stream containing all data.\n   * This approach reads the entire stream upfront to avoid complex async handling issues.\n   *\n   * @protected\n   */\n  protected async peekBytes(\n    stream: Readable,\n    numBytes: number,\n  ): Promise<{ buffer: Buffer; stream: Readable }> {\n    const chunks: Buffer[] = [];\n\n    // Read the entire stream\n    for await (const chunk of stream) {\n      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n    }\n\n    const allData = Buffer.concat(chunks);\n    const buffer = allData.subarray(0, numBytes);\n\n    // Create a new stream with all the data\n    const newStream = Readable.from(allData);\n\n    return { buffer, stream: newStream };\n  }\n\n  /**\n   * Checks if a buffer matches a magic byte signature.\n   *\n   * @protected\n   */\n  protected matchesSignature(\n    buffer: Buffer,\n    signature: (number | null)[],\n  ): boolean {\n    if (buffer.length < signature.length) {\n      return false;\n    }\n\n    for (let i = 0; i < signature.length; i++) {\n      if (signature[i] !== null && buffer[i] !== signature[i]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n","import { createReadStream } from \"node:fs\";\nimport {\n  access,\n  copyFile,\n  cp as fsCp,\n  mkdir as fsMkdir,\n  readFile as fsReadFile,\n  rm as fsRm,\n  writeFile as fsWriteFile,\n  readdir,\n  rename,\n  stat,\n} from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { PassThrough, Readable } from \"node:stream\";\nimport type { ReadableStream as NodeWebStream } from \"node:stream/web\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  $inject,\n  AlephaError,\n  type FileLike,\n  isFileLike,\n  Json,\n  type StreamLike,\n} from \"alepha\";\nimport { FileDetector } from \"../services/FileDetector.ts\";\nimport type {\n  CpOptions,\n  CreateFileOptions,\n  FileSystemProvider,\n  LsOptions,\n  MkdirOptions,\n  RmOptions,\n} from \"./FileSystemProvider.ts\";\n\n/**\n * Node.js implementation of FileSystem interface.\n *\n * @example\n * ```typescript\n * const fs = alepha.inject(NodeFileSystemProvider);\n *\n * // Create from URL\n * const file1 = fs.createFile({ url: \"file:///path/to/file.png\" });\n *\n * // Create from Buffer\n * const file2 = fs.createFile({ buffer: Buffer.from(\"hello\"), name: \"hello.txt\" });\n *\n * // Create from text\n * const file3 = fs.createFile({ text: \"Hello, world!\", name: \"greeting.txt\" });\n *\n * // File operations\n * await fs.mkdir(\"/tmp/mydir\", { recursive: true });\n * await fs.cp(\"/src/file.txt\", \"/dest/file.txt\");\n * await fs.mv(\"/old/path.txt\", \"/new/path.txt\");\n * const files = await fs.ls(\"/tmp\");\n * await fs.rm(\"/tmp/file.txt\");\n * ```\n */\nexport class NodeFileSystemProvider implements FileSystemProvider {\n  protected detector = $inject(FileDetector);\n  protected json = $inject(Json);\n\n  public join(...paths: string[]): string {\n    return join(...paths);\n  }\n\n  /**\n   * Creates a FileLike object from various sources.\n   *\n   * @param options - Options for creating the file\n   * @returns A FileLike object\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // From URL\n   * const file1 = fs.createFile({ url: \"https://example.com/image.png\" });\n   *\n   * // From Buffer\n   * const file2 = fs.createFile({\n   *   buffer: Buffer.from(\"hello\"),\n   *   name: \"hello.txt\",\n   *   type: \"text/plain\"\n   * });\n   *\n   * // From text\n   * const file3 = fs.createFile({ text: \"Hello!\", name: \"greeting.txt\" });\n   *\n   * // From stream with detection\n   * const stream = createReadStream(\"/path/to/file.png\");\n   * const file4 = fs.createFile({ stream, name: \"image.png\" });\n   * ```\n   */\n  createFile(options: CreateFileOptions): FileLike {\n    if (\"path\" in options) {\n      const path = options.path;\n      const filename = path.split(\"/\").pop() || \"file\";\n      return this.createFileFromUrl(`file://${path}`, {\n        type: options.type,\n        name: options.name || filename,\n      });\n    }\n\n    // Handle URL\n    if (\"url\" in options) {\n      return this.createFileFromUrl(options.url, {\n        type: options.type,\n        name: options.name,\n      });\n    }\n\n    if (\"response\" in options) {\n      if (!options.response.body) {\n        throw new AlephaError(\"Response has no body stream\");\n      }\n      const res = options.response;\n      // guess size from content-length header if available\n      const sizeHeader = res.headers.get(\"content-length\");\n      const size = sizeHeader ? parseInt(sizeHeader, 10) : undefined;\n      // guess name from content-disposition header if available\n      let name = options.name;\n      const contentDisposition = res.headers.get(\"content-disposition\");\n      if (contentDisposition && !name) {\n        const match = contentDisposition.match(/filename=\"?([^\"]+)\"?/);\n        if (match) {\n          name = match[1];\n        }\n      }\n      // guess type from content-type header if available\n      const type = options.type || res.headers.get(\"content-type\") || undefined;\n      return this.createFileFromStream(options.response.body, {\n        type,\n        name,\n        size,\n      });\n    }\n\n    // Handle Web File\n    if (\"file\" in options) {\n      return this.createFileFromWebFile(options.file, {\n        type: options.type,\n        name: options.name,\n        size: options.size,\n      });\n    }\n\n    // Handle Buffer\n    if (\"buffer\" in options) {\n      return this.createFileFromBuffer(options.buffer, {\n        type: options.type,\n        name: options.name,\n      });\n    }\n\n    // Handle ArrayBuffer\n    if (\"arrayBuffer\" in options) {\n      return this.createFileFromBuffer(Buffer.from(options.arrayBuffer), {\n        type: options.type,\n        name: options.name,\n      });\n    }\n\n    // Handle text\n    if (\"text\" in options) {\n      return this.createFileFromBuffer(Buffer.from(options.text, \"utf-8\"), {\n        type: options.type || \"text/plain\",\n        name: options.name || \"file.txt\",\n      });\n    }\n\n    // Handle stream\n    if (\"stream\" in options) {\n      return this.createFileFromStream(options.stream, {\n        type: options.type,\n        name: options.name,\n        size: options.size,\n      });\n    }\n\n    throw new AlephaError(\n      \"Invalid createFile options: no valid source provided\",\n    );\n  }\n\n  /**\n   * Removes a file or directory.\n   *\n   * @param path - The path to remove\n   * @param options - Remove options\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Remove a file\n   * await fs.rm(\"/tmp/file.txt\");\n   *\n   * // Remove a directory recursively\n   * await fs.rm(\"/tmp/mydir\", { recursive: true });\n   *\n   * // Remove with force (no error if doesn't exist)\n   * await fs.rm(\"/tmp/maybe-exists.txt\", { force: true });\n   * ```\n   */\n  async rm(path: string, options?: RmOptions): Promise<void> {\n    await fsRm(path, options);\n  }\n\n  /**\n   * Copies a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   * @param options - Copy options\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Copy a file\n   * await fs.cp(\"/src/file.txt\", \"/dest/file.txt\");\n   *\n   * // Copy a directory recursively\n   * await fs.cp(\"/src/dir\", \"/dest/dir\", { recursive: true });\n   *\n   * // Copy with force (overwrite existing)\n   * await fs.cp(\"/src/file.txt\", \"/dest/file.txt\", { force: true });\n   * ```\n   */\n  async cp(src: string, dest: string, options?: CpOptions): Promise<void> {\n    // Check if source is a directory\n    const srcStat = await stat(src);\n\n    if (srcStat.isDirectory()) {\n      if (!options?.recursive) {\n        throw new Error(\n          `Cannot copy directory without recursive option: ${src}`,\n        );\n      }\n      // Use Node.js cp function for recursive directory copy\n      await fsCp(src, dest, {\n        recursive: true,\n        force: options?.force ?? false,\n      });\n    } else {\n      // For files, use copyFile\n      await copyFile(src, dest);\n    }\n  }\n\n  /**\n   * Moves/renames a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Move/rename a file\n   * await fs.mv(\"/old/path.txt\", \"/new/path.txt\");\n   *\n   * // Move a directory\n   * await fs.mv(\"/old/dir\", \"/new/dir\");\n   * ```\n   */\n  async mv(src: string, dest: string): Promise<void> {\n    await rename(src, dest);\n  }\n\n  /**\n   * Creates a directory.\n   *\n   * @param path - The directory path to create\n   * @param options - Mkdir options\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Create a directory\n   * await fs.mkdir(\"/tmp/mydir\");\n   *\n   * // Create nested directories\n   * await fs.mkdir(\"/tmp/path/to/dir\", { recursive: true });\n   *\n   * // Create with specific permissions\n   * await fs.mkdir(\"/tmp/mydir\", { mode: 0o755 });\n   * ```\n   */\n  async mkdir(path: string, options?: MkdirOptions): Promise<void> {\n    await fsMkdir(path, options);\n  }\n\n  /**\n   * Lists files in a directory.\n   *\n   * @param path - The directory path to list\n   * @param options - List options\n   * @returns Array of filenames\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // List files in a directory\n   * const files = await fs.ls(\"/tmp\");\n   * console.log(files); // [\"file1.txt\", \"file2.txt\", \"subdir\"]\n   *\n   * // List with hidden files\n   * const allFiles = await fs.ls(\"/tmp\", { hidden: true });\n   *\n   * // List recursively\n   * const allFilesRecursive = await fs.ls(\"/tmp\", { recursive: true });\n   * ```\n   */\n  async ls(path: string, options?: LsOptions): Promise<string[]> {\n    const entries = await readdir(path);\n\n    // Filter out hidden files if not requested\n    const filteredEntries = options?.hidden\n      ? entries\n      : entries.filter((e) => !e.startsWith(\".\"));\n\n    // If recursive, get all nested files\n    if (options?.recursive) {\n      const allFiles: string[] = [];\n\n      for (const entry of filteredEntries) {\n        const fullPath = join(path, entry);\n        const entryStat = await stat(fullPath);\n\n        if (entryStat.isDirectory()) {\n          // Add directory entry\n          allFiles.push(entry);\n          // Recursively get files from subdirectory\n          const subFiles = await this.ls(fullPath, options);\n          allFiles.push(...subFiles.map((f) => join(entry, f)));\n        } else {\n          allFiles.push(entry);\n        }\n      }\n\n      return allFiles;\n    }\n\n    return filteredEntries;\n  }\n\n  /**\n   * Checks if a file or directory exists.\n   *\n   * @param path - The path to check\n   * @returns True if the path exists, false otherwise\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * if (await fs.exists(\"/tmp/file.txt\")) {\n   *   console.log(\"File exists\");\n   * }\n   * ```\n   */\n  async exists(path: string): Promise<boolean> {\n    try {\n      await access(path);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Reads the content of a file.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a Buffer\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * const buffer = await fs.readFile(\"/tmp/file.txt\");\n   * console.log(buffer.toString(\"utf-8\"));\n   * ```\n   */\n  async readFile(path: string): Promise<Buffer> {\n    return await fsReadFile(path);\n  }\n\n  /**\n   * Writes data to a file.\n   *\n   * @param path - The file path to write to\n   * @param data - The data to write (Buffer or string)\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Write string\n   * await fs.writeFile(\"/tmp/file.txt\", \"Hello, world!\");\n   *\n   * // Write Buffer\n   * await fs.writeFile(\"/tmp/file.bin\", Buffer.from([0x01, 0x02, 0x03]));\n   * ```\n   */\n  async writeFile(\n    path: string,\n    data: Uint8Array | Buffer | string | FileLike,\n  ): Promise<void> {\n    if (isFileLike(data)) {\n      await fsWriteFile(path, Readable.from(data.stream()));\n      return;\n    }\n    await fsWriteFile(path, data);\n  }\n\n  /**\n   * Reads the content of a file as a string.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a string\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   * const content = await fs.readTextFile(\"/tmp/file.txt\");\n   * ```\n   */\n  async readTextFile(path: string): Promise<string> {\n    const buffer = await this.readFile(path);\n    return buffer.toString(\"utf-8\");\n  }\n\n  /**\n   * Reads the content of a file as JSON.\n   *\n   * @param path - The file path to read\n   * @returns The parsed JSON content\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   * const config = await fs.readJsonFile<{ name: string }>(\"/tmp/config.json\");\n   * ```\n   */\n  async readJsonFile<T = unknown>(path: string): Promise<T> {\n    const text = await this.readTextFile(path);\n    return this.json.parse(text) as T;\n  }\n\n  /**\n   * Creates a FileLike object from a Web File.\n   *\n   * @protected\n   */\n  protected createFileFromWebFile(\n    source: File,\n    options: {\n      type?: string;\n      name?: string;\n      size?: number;\n    } = {},\n  ): FileLike {\n    const name = options.name ?? source.name;\n    return {\n      name,\n      type: options.type ?? (source.type || this.detector.getContentType(name)),\n      size: options.size ?? source.size ?? 0,\n      lastModified: source.lastModified || Date.now(),\n      stream: () => source.stream(),\n      arrayBuffer: async (): Promise<ArrayBuffer> => {\n        return await source.arrayBuffer();\n      },\n      text: async (): Promise<string> => {\n        return await source.text();\n      },\n    };\n  }\n\n  /**\n   * Creates a FileLike object from a Buffer.\n   *\n   * @protected\n   */\n  protected createFileFromBuffer(\n    source: Buffer,\n    options: {\n      type?: string;\n      name?: string;\n    } = {},\n  ): FileLike {\n    const name: string = options.name ?? \"file\";\n    return {\n      name,\n      type: options.type ?? this.detector.getContentType(options.name ?? name),\n      size: source.byteLength,\n      lastModified: Date.now(),\n      stream: (): Readable => Readable.from(source),\n      arrayBuffer: async (): Promise<ArrayBuffer> => {\n        return this.bufferToArrayBuffer(source);\n      },\n      text: async (): Promise<string> => {\n        return source.toString(\"utf-8\");\n      },\n    };\n  }\n\n  /**\n   * Creates a FileLike object from a stream.\n   *\n   * @protected\n   */\n  protected createFileFromStream(\n    source: StreamLike,\n    options: {\n      type?: string;\n      name?: string;\n      size?: number;\n    } = {},\n  ): FileLike & { _buffer: null | Buffer } {\n    let buffer: Buffer | null = null;\n\n    return {\n      name: options.name ?? \"file\",\n      type:\n        options.type ?? this.detector.getContentType(options.name ?? \"file\"),\n      size: options.size ?? 0,\n      lastModified: Date.now(),\n      stream: () => source,\n      _buffer: null as Buffer | null,\n      arrayBuffer: async () => {\n        buffer ??= await this.streamToBuffer(source);\n        return this.bufferToArrayBuffer(buffer);\n      },\n      text: async () => {\n        buffer ??= await this.streamToBuffer(source);\n        return buffer.toString(\"utf-8\");\n      },\n    };\n  }\n\n  /**\n   * Creates a FileLike object from a URL.\n   *\n   * @protected\n   */\n  protected createFileFromUrl(\n    url: string,\n    options: {\n      type?: string;\n      name?: string;\n    } = {},\n  ): FileLike {\n    const parsedUrl = new URL(url);\n    const filename =\n      options.name || parsedUrl.pathname.split(\"/\").pop() || \"file\";\n    let buffer: Buffer | null = null;\n\n    return {\n      name: filename,\n      type: options.type ?? this.detector.getContentType(filename),\n      size: 0, // Unknown size until loaded\n      lastModified: Date.now(),\n      stream: () => this.createStreamFromUrl(url),\n      arrayBuffer: async () => {\n        buffer ??= await this.loadFromUrl(url);\n        return this.bufferToArrayBuffer(buffer);\n      },\n      text: async () => {\n        buffer ??= await this.loadFromUrl(url);\n        return buffer.toString(\"utf-8\");\n      },\n      filepath: url,\n    };\n  }\n\n  /**\n   * Gets a streaming response from a URL.\n   *\n   * @protected\n   */\n  protected getStreamingResponse(url: string): Readable {\n    const stream = new PassThrough();\n\n    fetch(url)\n      .then((res) =>\n        Readable.fromWeb(res.body as unknown as NodeWebStream).pipe(stream),\n      )\n      .catch((err) => stream.destroy(err));\n\n    return stream;\n  }\n\n  /**\n   * Loads data from a URL.\n   *\n   * @protected\n   */\n  protected async loadFromUrl(url: string): Promise<Buffer> {\n    const parsedUrl = new URL(url);\n\n    if (parsedUrl.protocol === \"file:\") {\n      // Handle file:// URLs\n      const filePath = fileURLToPath(url);\n      return await fsReadFile(filePath);\n    } else if (\n      parsedUrl.protocol === \"http:\" ||\n      parsedUrl.protocol === \"https:\"\n    ) {\n      // Handle HTTP/HTTPS URLs\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new Error(\n          `Failed to fetch ${url}: ${response.status} ${response.statusText}`,\n        );\n      }\n      const arrayBuffer = await response.arrayBuffer();\n      return Buffer.from(arrayBuffer);\n    } else {\n      throw new Error(`Unsupported protocol: ${parsedUrl.protocol}`);\n    }\n  }\n\n  /**\n   * Creates a stream from a URL.\n   *\n   * @protected\n   */\n  protected createStreamFromUrl(url: string): Readable {\n    const parsedUrl = new URL(url);\n\n    if (parsedUrl.protocol === \"file:\") {\n      // For file:// URLs, create a stream that reads the file\n      return createReadStream(fileURLToPath(url));\n    } else if (\n      parsedUrl.protocol === \"http:\" ||\n      parsedUrl.protocol === \"https:\"\n    ) {\n      // For HTTP/HTTPS URLs, create a stream that fetches the content\n      return this.getStreamingResponse(url);\n    } else {\n      throw new AlephaError(`Unsupported protocol: ${parsedUrl.protocol}`);\n    }\n  }\n\n  /**\n   * Converts a stream-like object to a Buffer.\n   *\n   * @protected\n   */\n  protected async streamToBuffer(streamLike: StreamLike): Promise<Buffer> {\n    const stream =\n      streamLike instanceof Readable\n        ? streamLike\n        : Readable.fromWeb(streamLike as NodeWebStream);\n\n    return new Promise<Buffer>((resolve, reject) => {\n      const buffer: any[] = [];\n      stream.on(\"data\", (chunk) => buffer.push(Buffer.from(chunk)));\n      stream.on(\"end\", () => resolve(Buffer.concat(buffer)));\n      stream.on(\"error\", (err) =>\n        reject(new AlephaError(\"Error converting stream\", { cause: err })),\n      );\n    });\n  }\n\n  /**\n   * Converts a Node.js Buffer to an ArrayBuffer.\n   *\n   * @protected\n   */\n  protected bufferToArrayBuffer(buffer: Buffer): ArrayBuffer {\n    return buffer.buffer.slice(\n      buffer.byteOffset,\n      buffer.byteOffset + buffer.byteLength,\n    ) as ArrayBuffer;\n  }\n}\n","import { exec, spawn } from \"node:child_process\";\nimport { $inject, AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { FileSystemProvider } from \"./FileSystemProvider.ts\";\nimport type { ShellProvider, ShellRunOptions } from \"./ShellProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Node.js implementation of ShellProvider.\n *\n * Executes shell commands using Node.js child_process module.\n * Supports binary resolution from node_modules/.bin for local packages.\n */\nexport class NodeShellProvider implements ShellProvider {\n  protected readonly log = $logger();\n  protected readonly fs = $inject(FileSystemProvider);\n\n  /**\n   * Run a shell command or binary.\n   */\n  public async run(\n    command: string,\n    options: ShellRunOptions = {},\n  ): Promise<string> {\n    const { resolve = false, capture = false, root, env } = options;\n    const cwd = root ?? process.cwd();\n\n    this.log.debug(`Shell: ${command}`, { cwd, resolve, capture });\n\n    let executable: string;\n    let args: string[];\n\n    if (resolve) {\n      const [bin, ...rest] = command.split(\" \");\n      executable = await this.resolveExecutable(bin, cwd);\n      args = rest;\n    } else {\n      [executable, ...args] = command.split(\" \");\n    }\n\n    if (capture) {\n      return this.execCapture(command, { cwd, env });\n    }\n\n    return this.execInherit(executable, args, { cwd, env });\n  }\n\n  /**\n   * Execute command with inherited stdio (streams to terminal).\n   */\n  protected async execInherit(\n    executable: string,\n    args: string[],\n    options: { cwd: string; env?: Record<string, string> },\n  ): Promise<string> {\n    const proc = spawn(executable, args, {\n      stdio: \"inherit\",\n      cwd: options.cwd,\n      env: {\n        ...process.env,\n        ...options.env,\n      },\n    });\n\n    return new Promise<string>((resolve, reject) => {\n      proc.on(\"exit\", (code) => {\n        if (code === 0 || code === null) {\n          resolve(\"\");\n        } else {\n          reject(new AlephaError(`Command exited with code ${code}`));\n        }\n      });\n      proc.on(\"error\", reject);\n    });\n  }\n\n  /**\n   * Execute command and capture stdout.\n   */\n  protected execCapture(\n    command: string,\n    options: { cwd: string; env?: Record<string, string> },\n  ): Promise<string> {\n    return new Promise<string>((resolve, reject) => {\n      exec(\n        command,\n        {\n          cwd: options.cwd,\n          env: {\n            ...process.env,\n            LOG_FORMAT: \"pretty\",\n            ...options.env,\n          },\n        },\n        (err, stdout) => {\n          if (err) {\n            (err as any).stdout = stdout;\n            reject(err);\n          } else {\n            resolve(stdout);\n          }\n        },\n      );\n    });\n  }\n\n  /**\n   * Resolve executable path from node_modules/.bin.\n   *\n   * Search order:\n   * 1. Local: node_modules/.bin/\n   * 2. Pnpm nested: node_modules/alepha/node_modules/.bin/\n   * 3. Monorepo: Walk up to 3 parent directories\n   */\n  protected async resolveExecutable(\n    name: string,\n    root: string,\n  ): Promise<string> {\n    const suffix = process.platform === \"win32\" ? \".cmd\" : \"\";\n\n    // 1. Local node_modules\n    let execPath = await this.findExecutable(\n      root,\n      `node_modules/.bin/${name}${suffix}`,\n    );\n\n    // 2. Pnpm nested (alepha's own node_modules)\n    if (!execPath) {\n      execPath = await this.findExecutable(\n        root,\n        `node_modules/alepha/node_modules/.bin/${name}${suffix}`,\n      );\n    }\n\n    // 3. Monorepo: check parent directories (up to 3 levels)\n    if (!execPath) {\n      let parentDir = this.fs.join(root, \"..\");\n      for (let i = 0; i < 3; i++) {\n        execPath = await this.findExecutable(\n          parentDir,\n          `node_modules/.bin/${name}${suffix}`,\n        );\n        if (execPath) break;\n        parentDir = this.fs.join(parentDir, \"..\");\n      }\n    }\n\n    if (!execPath) {\n      throw new AlephaError(\n        `Could not find executable for '${name}'. Make sure the package is installed.`,\n      );\n    }\n\n    return execPath;\n  }\n\n  /**\n   * Check if executable exists at path.\n   */\n  protected async findExecutable(\n    root: string,\n    relativePath: string,\n  ): Promise<string | undefined> {\n    const fullPath = this.fs.join(root, relativePath);\n    if (await this.fs.exists(fullPath)) {\n      return fullPath;\n    }\n    return undefined;\n  }\n\n  /**\n   * Check if a command is installed and available in the system PATH.\n   */\n  public isInstalled(command: string): Promise<boolean> {\n    return new Promise((resolve) => {\n      const check =\n        process.platform === \"win32\"\n          ? `where ${command}`\n          : `command -v ${command}`;\n      exec(check, (error) => resolve(!error));\n    });\n  }\n}\n","// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ShellRunOptions {\n  /**\n   * Working directory for the command.\n   */\n  root?: string;\n\n  /**\n   * Additional environment variables.\n   */\n  env?: Record<string, string>;\n\n  /**\n   * Resolve the executable from node_modules/.bin.\n   * Supports local project, pnpm nested, and monorepo structures.\n   * @default false\n   */\n  resolve?: boolean;\n\n  /**\n   * Capture stdout instead of inheriting stdio.\n   * When true, returns stdout as string.\n   * When false, streams output to terminal.\n   * @default false\n   */\n  capture?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Abstract provider for executing shell commands and binaries.\n *\n * Implementations:\n * - `NodeShellProvider` - Real shell execution using Node.js child_process\n * - `MemoryShellProvider` - In-memory mock for testing\n *\n * @example\n * ```typescript\n * class MyService {\n *   protected readonly shell = $inject(ShellProvider);\n *\n *   async build() {\n *     // Run shell command directly\n *     await this.shell.run(\"yarn install\");\n *\n *     // Run local binary with resolution\n *     await this.shell.run(\"vite build\", { resolve: true });\n *\n *     // Capture output\n *     const output = await this.shell.run(\"echo hello\", { capture: true });\n *   }\n * }\n * ```\n */\nexport abstract class ShellProvider {\n  /**\n   * Run a shell command or binary.\n   *\n   * @param command - The command to run\n   * @param options - Execution options\n   * @returns stdout if capture is true, empty string otherwise\n   */\n  abstract run(command: string, options?: ShellRunOptions): Promise<string>;\n\n  /**\n   * Check if a command is installed and available in the system PATH.\n   *\n   * @param command - The command name to check\n   * @returns true if the command is available\n   */\n  abstract isInstalled(command: string): Promise<boolean>;\n}\n","import { $module } from \"alepha\";\nimport { FileSystemProvider } from \"./providers/FileSystemProvider.ts\";\nimport { MemoryFileSystemProvider } from \"./providers/MemoryFileSystemProvider.ts\";\nimport { MemoryShellProvider } from \"./providers/MemoryShellProvider.ts\";\nimport { NodeFileSystemProvider } from \"./providers/NodeFileSystemProvider.ts\";\nimport { NodeShellProvider } from \"./providers/NodeShellProvider.ts\";\nimport { ShellProvider } from \"./providers/ShellProvider.ts\";\nimport { FileDetector } from \"./services/FileDetector.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/FileError.ts\";\nexport * from \"./providers/FileSystemProvider.ts\";\nexport * from \"./providers/MemoryFileSystemProvider.ts\";\nexport * from \"./providers/MemoryShellProvider.ts\";\nexport * from \"./providers/NodeFileSystemProvider.ts\";\nexport * from \"./providers/NodeShellProvider.ts\";\nexport * from \"./providers/ShellProvider.ts\";\nexport * from \"./services/FileDetector.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | tooling | standard | stable |\n *\n * System-level abstractions for portable code across runtimes.\n *\n * **Features:**\n * - File system operations (read, write, exists, etc.)\n * - Shell command execution\n * - File type detection and MIME utilities\n * - Memory implementations for testing\n *\n * @module alepha.system\n */\nexport const AlephaSystem = $module({\n  name: \"alepha.system\",\n  primitives: [],\n  services: [\n    FileDetector,\n    FileSystemProvider,\n    MemoryFileSystemProvider,\n    NodeFileSystemProvider,\n    ShellProvider,\n    MemoryShellProvider,\n    NodeShellProvider,\n  ],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: FileSystemProvider,\n        use: NodeFileSystemProvider,\n      })\n      .with({\n        optional: true,\n        provide: ShellProvider,\n        use: alepha.isTest() ? MemoryShellProvider : NodeShellProvider,\n      }),\n});\n","import { createReadStream } from \"node:fs\";\nimport { access, readdir, stat } from \"node:fs/promises\";\nimport { basename, isAbsolute, join } from \"node:path\";\nimport type { Readable as NodeStream } from \"node:stream\";\nimport { $hook, $inject, Alepha } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { type ServerHandler, ServerRouterProvider } from \"alepha/server\";\nimport { FileDetector } from \"alepha/system\";\nimport { $serve, type ServePrimitiveOptions } from \"../primitives/$serve.ts\";\n\nexport class ServerStaticProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly routerProvider = $inject(ServerRouterProvider);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly fileDetector = $inject(FileDetector);\n  protected readonly log = $logger();\n  protected readonly directories: ServeDirectory[] = [];\n\n  protected readonly configure = $hook({\n    on: \"configure\",\n    handler: async () => {\n      await Promise.all(\n        this.alepha\n          .primitives($serve)\n          .map((it) => this.createStaticServer(it.options)),\n      );\n    },\n  });\n\n  public async createStaticServer(\n    options: ServePrimitiveOptions,\n  ): Promise<void> {\n    const prefix = options.path ?? \"/\";\n\n    let root = options.root ?? process.cwd();\n    if (!isAbsolute(root)) {\n      root = join(process.cwd(), root);\n    }\n\n    this.log.debug(\"Serve static files\", { prefix, root });\n\n    await stat(root);\n\n    // 1. get all files in the root directory (recursively)\n    const files = await this.getAllFiles(root, options.ignoreDotEnvFiles);\n\n    // 2. create a $route for each file (yes, this could be a lot of routes)\n    const routes = await Promise.all(\n      files.map(async (file) => {\n        const path = file.replace(root, \"\").replace(/\\\\/g, \"/\");\n        this.log.trace(`Mount ${join(prefix, path)} -> ${join(root, path)}`);\n        return {\n          path: join(prefix, encodeURI(path)),\n          handler: await this.createFileHandler(join(root, path), options),\n        };\n      }),\n    );\n\n    for (const route of routes) {\n      this.routerProvider.createRoute(route);\n\n      // if route is for index.html, also create a route without it\n      // e.g. /my/path/index.html -> /my/path/\n      if (\n        options.indexFallback !== false &&\n        route.path.endsWith(\"index.html\")\n      ) {\n        this.routerProvider.createRoute({\n          path: route.path.replace(/index\\.html$/, \"\"),\n          handler: route.handler,\n        });\n      }\n    }\n\n    // 3. store the directory info for reference\n    this.directories.push({\n      options,\n      files: files.map((file) => file.replace(root, \"\").replace(/\\\\/g, \"/\")),\n    });\n\n    // bonus! for SPAs, handle history API fallback\n    if (options.historyApiFallback) {\n      // meaning all unmatched routes should serve index.html\n      this.routerProvider.createRoute({\n        path: join(prefix, \"*\").replace(/\\\\/g, \"/\"),\n        handler: async (request) => {\n          const { reply } = request;\n\n          if (request.url.pathname.includes(\".\")) {\n            // If the request is for a file (e.g., /style.css), do not fall back\n            reply.headers[\"content-type\"] = \"text/plain\";\n            reply.body = \"Not Found\";\n            reply.status = 404;\n            return;\n          }\n\n          reply.headers[\"content-type\"] = \"text/html\";\n          reply.status = 200;\n\n          return new Promise<any>((resolve, reject) => {\n            const stream = createReadStream(join(root, \"index.html\"));\n            stream.on(\"open\", () => {\n              resolve(stream);\n            });\n            stream.on(\"error\", (err) => {\n              reject(err);\n            });\n          });\n        },\n      });\n    }\n  }\n\n  public async createFileHandler(\n    filepath: string,\n    options: ServePrimitiveOptions,\n  ): Promise<ServerHandler> {\n    const filename = basename(filepath);\n\n    const hasGzip = await access(`${filepath}.gz`)\n      .then(() => true)\n      .catch(() => false);\n\n    const hasBr = await access(`${filepath}.br`)\n      .then(() => true)\n      .catch(() => false);\n\n    const fileStat = await stat(filepath);\n    const lastModified = fileStat.mtime.toUTCString();\n    const etag = `\"${fileStat.size}-${fileStat.mtime.getTime()}\"`;\n    const contentType = this.fileDetector.getContentType(filename);\n    const cacheControl = this.getCacheControl(filename, options);\n\n    return async (request): Promise<NodeStream | undefined> => {\n      const { headers, reply } = request;\n      let path = filepath;\n\n      // 01/26 - when calling \"/directory\", redirect to \"/directory/\"\n      if (\n        options.path &&\n        options.path === request.url.pathname &&\n        !options.path.endsWith(\"/\")\n      ) {\n        reply.redirect(`${options.path}/`);\n        return;\n      }\n\n      const encoding = headers[\"accept-encoding\"];\n      if (encoding) {\n        if (hasBr && encoding.includes(\"br\")) {\n          reply.headers[\"content-encoding\"] = \"br\";\n          path += \".br\";\n        } else if (hasGzip && encoding.includes(\"gzip\")) {\n          reply.headers[\"content-encoding\"] = \"gzip\";\n          path += \".gz\";\n        }\n      }\n\n      reply.headers[\"content-type\"] = contentType;\n      reply.headers[\"accept-ranges\"] = \"bytes\";\n      reply.headers[\"last-modified\"] = lastModified;\n\n      if (cacheControl) {\n        reply.headers[\"cache-control\"] =\n          `public, max-age=${cacheControl.maxAge}`;\n        if (cacheControl.immutable) {\n          reply.headers[\"cache-control\"] += \", immutable\";\n        }\n      }\n\n      reply.headers.etag = etag;\n      if (\n        headers[\"if-none-match\"] === etag ||\n        headers[\"if-modified-since\"] === lastModified\n      ) {\n        reply.status = 304;\n        return;\n      }\n\n      return new Promise<any>((resolve, reject) => {\n        const stream = createReadStream(path);\n        stream.on(\"open\", () => {\n          resolve(stream);\n        });\n        stream.on(\"error\", (err) => {\n          reject(err);\n        });\n      });\n    };\n  }\n\n  protected getCacheFileTypes(): string[] {\n    return [\n      \".js\",\n      \".css\",\n      \".woff\",\n      \".woff2\",\n      \".ttf\",\n      \".eot\",\n      \".otf\",\n      \".jpg\",\n      \".jpeg\",\n      \".png\",\n      \".svg\",\n      \".gif\",\n    ];\n  }\n\n  protected getCacheControl(\n    filename: string,\n    options: ServePrimitiveOptions,\n  ): { maxAge: number; immutable: boolean } | undefined {\n    if (!options.cacheControl) {\n      return;\n    }\n\n    const fileTypes =\n      options.cacheControl.fileTypes ?? this.getCacheFileTypes();\n\n    for (const type of fileTypes) {\n      if (filename.endsWith(type)) {\n        return {\n          immutable: options.cacheControl.immutable ?? true,\n          maxAge: this.dateTimeProvider\n            .duration(options.cacheControl.maxAge ?? [30, \"days\"])\n            .as(\"seconds\"),\n        };\n      }\n    }\n  }\n\n  public async getAllFiles(\n    dir: string,\n    ignoreDotEnvFiles = true,\n  ): Promise<string[]> {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    const files = await Promise.all(\n      entries.map((dirent) => {\n        // skip .env & other dot files\n        if (ignoreDotEnvFiles && dirent.name.startsWith(\".\")) {\n          return [];\n        }\n\n        const fullPath = join(dir, dirent.name);\n        return dirent.isDirectory() ? this.getAllFiles(fullPath) : fullPath;\n      }),\n    );\n\n    return files.flat();\n  }\n}\n\nexport interface ServeDirectory {\n  options: ServePrimitiveOptions;\n  files: string[];\n}\n","import { $module } from \"alepha\";\nimport { AlephaServer } from \"alepha/server\";\nimport { $serve } from \"./primitives/$serve.ts\";\nimport { ServerStaticProvider } from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$serve.ts\";\nexport * from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | backend | standard | stable |\n *\n * Static file serving.\n *\n * **Features:**\n * - Serve static files from directory\n *\n * @module alepha.server.static\n */\nexport const AlephaServerStatic = $module({\n  name: \"alepha.server.static\",\n  primitives: [$serve],\n  services: [AlephaServer, ServerStaticProvider],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["nodeJoin","fsRm","fsCp","fsMkdir","fsReadFile","fsWriteFile"],"sources":["../../../src/server/static/primitives/$serve.ts","../../../src/system/providers/FileSystemProvider.ts","../../../src/system/providers/MemoryFileSystemProvider.ts","../../../src/system/providers/MemoryShellProvider.ts","../../../src/system/services/FileDetector.ts","../../../src/system/providers/NodeFileSystemProvider.ts","../../../src/system/providers/NodeShellProvider.ts","../../../src/system/providers/ShellProvider.ts","../../../src/system/index.ts","../../../src/server/static/providers/ServerStaticProvider.ts","../../../src/server/static/index.ts"],"sourcesContent":["import { createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\n\n/**\n * Create a new static file handler.\n */\nexport const $serve = (options: ServePrimitiveOptions = {}): ServePrimitive => {\n  return createPrimitive(ServePrimitive, options);\n};\n\nexport interface ServePrimitiveOptions {\n  /**\n   * Prefix for the served path.\n   *\n   * @default \"/\"\n   */\n  path?: string;\n\n  /**\n   * Path to the directory to serve.\n   *\n   * @default process.cwd()\n   */\n  root?: string;\n\n  /**\n   * If true, primitive will be ignored.\n   *\n   * @default false\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether to keep dot files (e.g. `.gitignore`, `.env`) in the served directory.\n   *\n   * @default true\n   */\n  ignoreDotEnvFiles?: boolean;\n\n  /**\n   * Whether to use the index.html file when the path is a directory.\n   *\n   * @default true\n   */\n  indexFallback?: boolean;\n\n  /**\n   * Force all requests \"not found\" to be served with the index.html file.\n   * This is useful for single-page applications (SPAs) that use client-side only routing.\n   */\n  historyApiFallback?: boolean;\n\n  /**\n   * Optional name of the primitive.\n   * This is used for logging and debugging purposes.\n   *\n   * @default Key name.\n   */\n  name?: string;\n\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default {}\n   */\n  cacheControl?: Partial<CacheControlOptions> | false;\n}\n\nexport interface CacheControlOptions {\n  /**\n   * Whether to use cache control headers.\n   *\n   * @default [.js, .css]\n   */\n  fileTypes: string[];\n\n  /**\n   * The maximum age of the cache in seconds.\n   *\n   * @default 60 * 60 * 24 * 2 // 2 days\n   */\n  maxAge: DurationLike;\n\n  /**\n   * Whether to use immutable cache control headers.\n   *\n   * @default true\n   */\n  immutable: boolean;\n}\n\nexport class ServePrimitive extends Primitive<ServePrimitiveOptions> {}\n\n$serve[KIND] = ServePrimitive;\n","import type { FileLike, StreamLike } from \"alepha\";\n\n/**\n * Options for creating a file from a URL\n */\nexport interface CreateFileFromUrlOptions {\n  /**\n   * The URL to load the file from (file://, http://, or https://)\n   */\n  url: string;\n  /**\n   * The MIME type of the file (optional, will be detected from filename if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (optional, will be extracted from URL if not provided)\n   */\n  name?: string;\n}\n\n/**\n * Options for creating a file from a path (URL with file:// scheme)\n */\nexport interface CreateFileFromPathOptions {\n  /**\n   * The path to the file on the local filesystem\n   */\n  path: string;\n  /**\n   * The MIME type of the file (optional, will be detected from filename if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (optional, will be extracted from URL if not provided)\n   */\n  name?: string;\n}\n\n/**\n * Options for creating a file from a Buffer\n */\nexport interface CreateFileFromBufferOptions {\n  /**\n   * The Buffer containing the file data\n   */\n  buffer: Buffer;\n  /**\n   * The MIME type of the file (optional, will be detected from name if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (required for proper content type detection)\n   */\n  name?: string;\n}\n\n/**\n * Options for creating a file from a stream\n */\nexport interface CreateFileFromStreamOptions {\n  /**\n   * The readable stream containing the file data\n   */\n  stream: StreamLike;\n  /**\n   * The MIME type of the file (optional, will be detected from name if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (required for proper content type detection)\n   */\n  name?: string;\n  /**\n   * The size of the file in bytes (optional)\n   */\n  size?: number;\n}\n\n/**\n * Options for creating a file from text content\n */\nexport interface CreateFileFromTextOptions {\n  /**\n   * The text content to create the file from\n   */\n  text: string;\n  /**\n   * The MIME type of the file (default: text/plain)\n   */\n  type?: string;\n  /**\n   * The name of the file (default: \"file.txt\")\n   */\n  name?: string;\n}\n\nexport interface CreateFileFromResponseOptions {\n  /**\n   * The Response object containing the file data\n   */\n  response: Response;\n  /**\n   * Override the name (optional, uses filename from Content-Disposition header if not provided)\n   */\n  name?: string;\n  /**\n   * Override the MIME type (optional, uses file.type if not provided)\n   */\n  type?: string;\n}\n\n/**\n * Options for creating a file from a Web File object\n */\nexport interface CreateFileFromWebFileOptions {\n  /**\n   * The Web File object\n   */\n  file: File;\n  /**\n   * Override the MIME type (optional, uses file.type if not provided)\n   */\n  type?: string;\n  /**\n   * Override the name (optional, uses file.name if not provided)\n   */\n  name?: string;\n  /**\n   * Override the size (optional, uses file.size if not provided)\n   */\n  size?: number;\n}\n\n/**\n * Options for creating a file from an ArrayBuffer\n */\nexport interface CreateFileFromArrayBufferOptions {\n  /**\n   * The ArrayBuffer containing the file data\n   */\n  arrayBuffer: ArrayBuffer;\n  /**\n   * The MIME type of the file (optional, will be detected from name if not provided)\n   */\n  type?: string;\n  /**\n   * The name of the file (required for proper content type detection)\n   */\n  name?: string;\n}\n\n/**\n * Union type for all createFile options\n */\nexport type CreateFileOptions =\n  | CreateFileFromUrlOptions\n  | CreateFileFromPathOptions\n  | CreateFileFromBufferOptions\n  | CreateFileFromStreamOptions\n  | CreateFileFromTextOptions\n  | CreateFileFromWebFileOptions\n  | CreateFileFromResponseOptions\n  | CreateFileFromArrayBufferOptions;\n\n/**\n * Options for rm (remove) operation\n */\nexport interface RmOptions {\n  /**\n   * If true, removes directories and their contents recursively\n   */\n  recursive?: boolean;\n  /**\n   * If true, no error will be thrown if the path does not exist\n   */\n  force?: boolean;\n}\n\n/**\n * Options for cp (copy) operation\n */\nexport interface CpOptions {\n  /**\n   * If true, copy directories recursively\n   */\n  recursive?: boolean;\n  /**\n   * If true, overwrite existing destination\n   */\n  force?: boolean;\n}\n\n/**\n * Options for mkdir operation\n */\nexport interface MkdirOptions {\n  /**\n   * If true, creates parent directories as needed\n   *\n   * @default true\n   */\n  recursive?: boolean;\n  /**\n   * If true, does not throw an error if the directory already exists\n   *\n   * @default true\n   */\n  force?: boolean;\n  /**\n   * File mode (permission and sticky bits)\n   */\n  mode?: number;\n}\n\n/**\n * Options for ls (list) operation\n */\nexport interface LsOptions {\n  /**\n   * If true, list contents of directories recursively\n   */\n  recursive?: boolean;\n  /**\n   * If true, include hidden files (starting with .)\n   */\n  hidden?: boolean;\n}\n\n/**\n * FileSystem interface providing utilities for working with files.\n */\nexport abstract class FileSystemProvider {\n  /**\n   * Joins multiple path segments into a single path.\n   *\n   * @param paths - The path segments to join\n   * @returns The joined path\n   */\n  abstract join(...paths: string[]): string;\n\n  /**\n   * Creates a FileLike object from various sources.\n   *\n   * @param options - Options for creating the file\n   * @returns A FileLike object\n   */\n  abstract createFile(options: CreateFileOptions): FileLike;\n\n  /**\n   * Removes a file or directory.\n   *\n   * @param path - The path to remove\n   * @param options - Remove options\n   */\n  abstract rm(path: string, options?: RmOptions): Promise<void>;\n\n  /**\n   * Copies a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   * @param options - Copy options\n   */\n  abstract cp(src: string, dest: string, options?: CpOptions): Promise<void>;\n\n  /**\n   * Moves/renames a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   */\n  abstract mv(src: string, dest: string): Promise<void>;\n\n  /**\n   * Creates a directory.\n   *\n   * @param path - The directory path to create\n   * @param options - Mkdir options\n   */\n  abstract mkdir(path: string, options?: MkdirOptions): Promise<void>;\n\n  /**\n   * Lists files in a directory.\n   *\n   * @param path - The directory path to list\n   * @param options - List options\n   * @returns Array of filenames\n   */\n  abstract ls(path: string, options?: LsOptions): Promise<string[]>;\n\n  /**\n   * Checks if a file or directory exists.\n   *\n   * @param path - The path to check\n   * @returns True if the path exists, false otherwise\n   */\n  abstract exists(path: string): Promise<boolean>;\n\n  /**\n   * Reads the content of a file.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a Buffer\n   */\n  abstract readFile(path: string): Promise<Buffer>;\n\n  /**\n   * Writes data to a file.\n   *\n   * @param path - The file path to write to\n   * @param data - The data to write (Buffer or string)\n   */\n  abstract writeFile(\n    path: string,\n    data: Uint8Array | Buffer | string | FileLike,\n  ): Promise<void>;\n\n  /**\n   * Reads the content of a file as a string.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a string\n   */\n  abstract readTextFile(path: string): Promise<string>;\n\n  /**\n   * Reads the content of a file as JSON.\n   *\n   * @param path - The file path to read\n   * @returns The parsed JSON content\n   */\n  abstract readJsonFile<T = unknown>(path: string): Promise<T>;\n}\n","import { join as nodeJoin } from \"node:path\";\nimport { $inject, type FileLike, Json } from \"alepha\";\nimport type {\n  CpOptions,\n  CreateFileOptions,\n  FileSystemProvider,\n  LsOptions,\n  MkdirOptions,\n  RmOptions,\n} from \"./FileSystemProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryFileSystemProviderOptions {\n  /**\n   * Error to throw on mkdir operations (for testing error handling)\n   */\n  mkdirError?: Error | null;\n  /**\n   * Error to throw on writeFile operations (for testing error handling)\n   */\n  writeFileError?: Error | null;\n  /**\n   * Error to throw on readFile operations (for testing error handling)\n   */\n  readFileError?: Error | null;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In-memory implementation of FileSystemProvider for testing.\n *\n * This provider stores all files and directories in memory, making it ideal for\n * unit tests that need to verify file operations without touching the real file system.\n *\n * @example\n * ```typescript\n * // In tests, substitute the real FileSystemProvider with MemoryFileSystemProvider\n * const alepha = Alepha.create().with({\n *   provide: FileSystemProvider,\n *   use: MemoryFileSystemProvider,\n * });\n *\n * // Run code that uses FileSystemProvider\n * const service = alepha.inject(MyService);\n * await service.saveFile(\"test.txt\", \"Hello World\");\n *\n * // Verify the file was written\n * const memoryFs = alepha.inject(MemoryFileSystemProvider);\n * expect(memoryFs.files.get(\"test.txt\")?.toString()).toBe(\"Hello World\");\n * ```\n */\nexport class MemoryFileSystemProvider implements FileSystemProvider {\n  protected json = $inject(Json);\n\n  /**\n   * In-memory storage for files (path -> content)\n   */\n  public files = new Map<string, Buffer>();\n\n  /**\n   * In-memory storage for directories\n   */\n  public directories = new Set<string>();\n\n  /**\n   * Track mkdir calls for test assertions\n   */\n  public mkdirCalls: Array<{ path: string; options?: MkdirOptions }> = [];\n\n  /**\n   * Track writeFile calls for test assertions\n   */\n  public writeFileCalls: Array<{ path: string; data: string }> = [];\n\n  /**\n   * Track readFile calls for test assertions\n   */\n  public readFileCalls: Array<string> = [];\n\n  /**\n   * Track rm calls for test assertions\n   */\n  public rmCalls: Array<{ path: string; options?: RmOptions }> = [];\n\n  /**\n   * Track join calls for test assertions\n   */\n  public joinCalls: Array<string[]> = [];\n\n  /**\n   * Error to throw on mkdir (for testing error handling)\n   */\n  public mkdirError: Error | null = null;\n\n  /**\n   * Error to throw on writeFile (for testing error handling)\n   */\n  public writeFileError: Error | null = null;\n\n  /**\n   * Error to throw on readFile (for testing error handling)\n   */\n  public readFileError: Error | null = null;\n\n  constructor(options: MemoryFileSystemProviderOptions = {}) {\n    this.mkdirError = options.mkdirError ?? null;\n    this.writeFileError = options.writeFileError ?? null;\n    this.readFileError = options.readFileError ?? null;\n  }\n\n  /**\n   * Join path segments using forward slashes.\n   * Uses Node's path.join for proper normalization (handles .. and .)\n   */\n  public join(...paths: string[]): string {\n    this.joinCalls.push(paths);\n    return nodeJoin(...paths);\n  }\n\n  /**\n   * Create a FileLike object from various sources.\n   */\n  public createFile(options: CreateFileOptions): FileLike {\n    if (\"path\" in options) {\n      const filePath = options.path;\n      const buffer = this.files.get(filePath);\n      if (buffer === undefined) {\n        throw new Error(\n          `ENOENT: no such file or directory, open '${filePath}'`,\n        );\n      }\n      return {\n        name: options.name ?? filePath.split(\"/\").pop() ?? \"file\",\n        type: options.type ?? \"application/octet-stream\",\n        size: buffer.byteLength,\n        lastModified: Date.now(),\n        stream: () => {\n          throw new Error(\"Stream not implemented in MemoryFileSystemProvider\");\n        },\n        arrayBuffer: async (): Promise<ArrayBuffer> =>\n          buffer.buffer.slice(\n            buffer.byteOffset,\n            buffer.byteOffset + buffer.byteLength,\n          ) as ArrayBuffer,\n        text: async () => buffer.toString(\"utf-8\"),\n      };\n    }\n\n    if (\"buffer\" in options) {\n      const buffer = options.buffer;\n      return {\n        name: options.name ?? \"file\",\n        type: options.type ?? \"application/octet-stream\",\n        size: buffer.byteLength,\n        lastModified: Date.now(),\n        stream: () => {\n          throw new Error(\"Stream not implemented in MemoryFileSystemProvider\");\n        },\n        arrayBuffer: async (): Promise<ArrayBuffer> =>\n          buffer.buffer.slice(\n            buffer.byteOffset,\n            buffer.byteOffset + buffer.byteLength,\n          ) as ArrayBuffer,\n        text: async () => buffer.toString(\"utf-8\"),\n      };\n    }\n\n    if (\"text\" in options) {\n      const buffer = Buffer.from(options.text, \"utf-8\");\n      return {\n        name: options.name ?? \"file.txt\",\n        type: options.type ?? \"text/plain\",\n        size: buffer.byteLength,\n        lastModified: Date.now(),\n        stream: () => {\n          throw new Error(\"Stream not implemented in MemoryFileSystemProvider\");\n        },\n        arrayBuffer: async (): Promise<ArrayBuffer> =>\n          buffer.buffer.slice(\n            buffer.byteOffset,\n            buffer.byteOffset + buffer.byteLength,\n          ) as ArrayBuffer,\n        text: async () => options.text,\n      };\n    }\n\n    throw new Error(\n      \"MemoryFileSystemProvider.createFile: unsupported options. Only buffer and text are supported.\",\n    );\n  }\n\n  /**\n   * Remove a file or directory from memory.\n   */\n  public async rm(path: string, options?: RmOptions): Promise<void> {\n    this.rmCalls.push({ path, options });\n\n    const exists = this.files.has(path) || this.directories.has(path);\n\n    if (!exists && !options?.force) {\n      throw new Error(`ENOENT: no such file or directory, rm '${path}'`);\n    }\n\n    if (this.directories.has(path)) {\n      if (options?.recursive) {\n        // Remove directory and all contents\n        this.directories.delete(path);\n        for (const filePath of this.files.keys()) {\n          if (filePath.startsWith(`${path}/`)) {\n            this.files.delete(filePath);\n          }\n        }\n        for (const dirPath of this.directories) {\n          if (dirPath.startsWith(`${path}/`)) {\n            this.directories.delete(dirPath);\n          }\n        }\n      } else {\n        throw new Error(\n          `EISDIR: illegal operation on a directory, rm '${path}'`,\n        );\n      }\n    } else {\n      this.files.delete(path);\n    }\n  }\n\n  /**\n   * Copy a file or directory in memory.\n   */\n  public async cp(\n    src: string,\n    dest: string,\n    options?: CpOptions,\n  ): Promise<void> {\n    if (this.directories.has(src)) {\n      if (!options?.recursive) {\n        throw new Error(\n          `Cannot copy directory without recursive option: ${src}`,\n        );\n      }\n      // Copy directory and contents\n      this.directories.add(dest);\n      for (const [filePath, content] of this.files) {\n        if (filePath.startsWith(`${src}/`)) {\n          const newPath = filePath.replace(src, dest);\n          this.files.set(newPath, Buffer.from(content));\n        }\n      }\n    } else if (this.files.has(src)) {\n      const content = this.files.get(src)!;\n      this.files.set(dest, Buffer.from(content));\n    } else {\n      throw new Error(`ENOENT: no such file or directory, cp '${src}'`);\n    }\n  }\n\n  /**\n   * Move/rename a file or directory in memory.\n   */\n  public async mv(src: string, dest: string): Promise<void> {\n    if (this.directories.has(src)) {\n      // Move directory and contents\n      this.directories.delete(src);\n      this.directories.add(dest);\n      for (const [filePath, content] of this.files) {\n        if (filePath.startsWith(`${src}/`)) {\n          const newPath = filePath.replace(src, dest);\n          this.files.delete(filePath);\n          this.files.set(newPath, content);\n        }\n      }\n    } else if (this.files.has(src)) {\n      const content = this.files.get(src)!;\n      this.files.delete(src);\n      this.files.set(dest, content);\n    } else {\n      throw new Error(`ENOENT: no such file or directory, mv '${src}'`);\n    }\n  }\n\n  /**\n   * Create a directory in memory.\n   */\n  public async mkdir(path: string, options?: MkdirOptions): Promise<void> {\n    this.mkdirCalls.push({ path, options });\n\n    if (this.mkdirError) {\n      throw this.mkdirError;\n    }\n\n    if (this.directories.has(path) && !options?.recursive) {\n      throw new Error(`EEXIST: file already exists, mkdir '${path}'`);\n    }\n\n    this.directories.add(path);\n\n    // If recursive, create parent directories\n    if (options?.recursive) {\n      const parts = path.split(\"/\").filter(Boolean);\n      let current = \"\";\n      for (const part of parts) {\n        current = current ? `${current}/${part}` : part;\n        this.directories.add(current);\n      }\n    }\n  }\n\n  /**\n   * List files in a directory.\n   */\n  public async ls(path: string, options?: LsOptions): Promise<string[]> {\n    const normalizedPath = path.replace(/\\/$/, \"\");\n    const entries = new Set<string>();\n\n    // Find files in the directory\n    for (const filePath of this.files.keys()) {\n      if (filePath.startsWith(`${normalizedPath}/`)) {\n        const relativePath = filePath.slice(normalizedPath.length + 1);\n        const parts = relativePath.split(\"/\");\n\n        if (options?.recursive) {\n          entries.add(relativePath);\n        } else {\n          entries.add(parts[0]);\n        }\n      }\n    }\n\n    // Find subdirectories\n    for (const dirPath of this.directories) {\n      if (\n        dirPath.startsWith(`${normalizedPath}/`) &&\n        dirPath !== normalizedPath\n      ) {\n        const relativePath = dirPath.slice(normalizedPath.length + 1);\n        const parts = relativePath.split(\"/\");\n\n        if (options?.recursive) {\n          entries.add(relativePath);\n        } else if (parts.length === 1) {\n          entries.add(parts[0]);\n        }\n      }\n    }\n\n    let result = Array.from(entries);\n\n    // Filter hidden files unless requested\n    if (!options?.hidden) {\n      result = result.filter((entry) => !entry.startsWith(\".\"));\n    }\n\n    return result.sort();\n  }\n\n  /**\n   * Check if a file or directory exists in memory.\n   */\n  public async exists(path: string): Promise<boolean> {\n    return this.files.has(path) || this.directories.has(path);\n  }\n\n  /**\n   * Read a file from memory.\n   */\n  public async readFile(path: string): Promise<Buffer> {\n    this.readFileCalls.push(path);\n\n    if (this.readFileError) {\n      throw this.readFileError;\n    }\n\n    const content = this.files.get(path);\n    if (!content) {\n      throw new Error(`ENOENT: no such file or directory, open '${path}'`);\n    }\n    return content;\n  }\n\n  /**\n   * Read a file from memory as text.\n   */\n  public async readTextFile(path: string): Promise<string> {\n    const buffer = await this.readFile(path);\n    return buffer.toString(\"utf-8\");\n  }\n\n  /**\n   * Read a file from memory as JSON.\n   */\n  public async readJsonFile<T = unknown>(path: string): Promise<T> {\n    const text = await this.readTextFile(path);\n    return this.json.parse(text) as T;\n  }\n\n  /**\n   * Write a file to memory.\n   */\n  public async writeFile(\n    path: string,\n    data: Uint8Array | Buffer | string | FileLike,\n  ): Promise<void> {\n    const dataStr =\n      typeof data === \"string\"\n        ? data\n        : data instanceof Buffer || data instanceof Uint8Array\n          ? data.toString(\"utf-8\")\n          : await data.text();\n\n    this.writeFileCalls.push({ path, data: dataStr });\n\n    if (this.writeFileError) {\n      throw this.writeFileError;\n    }\n\n    const buffer =\n      typeof data === \"string\"\n        ? Buffer.from(data, \"utf-8\")\n        : data instanceof Buffer\n          ? data\n          : data instanceof Uint8Array\n            ? Buffer.from(data)\n            : Buffer.from(await data.text(), \"utf-8\");\n\n    this.files.set(path, buffer);\n  }\n\n  /**\n   * Reset all in-memory state (useful between tests).\n   */\n  public reset(): void {\n    this.files.clear();\n    this.directories.clear();\n    this.mkdirCalls = [];\n    this.writeFileCalls = [];\n    this.readFileCalls = [];\n    this.rmCalls = [];\n    this.joinCalls = [];\n    this.mkdirError = null;\n    this.writeFileError = null;\n    this.readFileError = null;\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Test assertion helpers\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Check if a file was written during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasWritten(\"/project/tsconfig.json\")).toBe(true);\n   * ```\n   */\n  public wasWritten(path: string): boolean {\n    return this.writeFileCalls.some((call) => call.path === path);\n  }\n\n  /**\n   * Check if a file was written with content matching a pattern.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasWrittenMatching(\"/project/tsconfig.json\", /extends/)).toBe(true);\n   * ```\n   */\n  public wasWrittenMatching(path: string, pattern: RegExp): boolean {\n    const call = this.writeFileCalls.find((c) => c.path === path);\n    return call ? pattern.test(call.data) : false;\n  }\n\n  /**\n   * Check if a file was read during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasRead(\"/project/package.json\")).toBe(true);\n   * ```\n   */\n  public wasRead(path: string): boolean {\n    return this.readFileCalls.includes(path);\n  }\n\n  /**\n   * Check if a file was deleted during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(fs.wasDeleted(\"/project/old-file.txt\")).toBe(true);\n   * ```\n   */\n  public wasDeleted(path: string): boolean {\n    return this.rmCalls.some((call) => call.path === path);\n  }\n\n  /**\n   * Get the content of a file as a string (convenience method for testing).\n   */\n  public getFileContent(path: string): string | undefined {\n    return this.files.get(path)?.toString(\"utf-8\");\n  }\n}\n","import type { ShellProvider, ShellRunOptions } from \"./ShellProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryShellCall {\n  command: string;\n  options: ShellRunOptions;\n}\n\nexport interface MemoryShellProviderOptions {\n  /**\n   * Simulated outputs for specific commands.\n   * Key is the command string, value is the stdout to return.\n   */\n  outputs?: Record<string, string>;\n\n  /**\n   * Commands that should throw an error.\n   * Key is the command string, value is the error message.\n   */\n  errors?: Record<string, string>;\n\n  /**\n   * Commands that are considered \"installed\" in the system PATH.\n   */\n  installedCommands?: string[];\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In-memory implementation of ShellProvider for testing.\n *\n * Records all commands that would be executed without actually running them.\n * Can be configured to return specific outputs or throw errors for testing.\n *\n * @example\n * ```typescript\n * // In tests, substitute the real ShellProvider with MemoryShellProvider\n * const alepha = Alepha.create().with({\n *   provide: ShellProvider,\n *   use: MemoryShellProvider,\n * });\n *\n * // Configure mock behavior\n * const shell = alepha.inject(MemoryShellProvider);\n * shell.configure({\n *   outputs: { \"echo hello\": \"hello\\n\" },\n *   errors: { \"failing-cmd\": \"Command failed\" },\n * });\n *\n * // Or use the fluent API\n * shell.outputs.set(\"another-cmd\", \"output\");\n * shell.errors.set(\"another-error\", \"Error message\");\n *\n * // Run code that uses ShellProvider\n * const service = alepha.inject(MyService);\n * await service.doSomething();\n *\n * // Verify commands were called\n * expect(shell.calls).toHaveLength(2);\n * expect(shell.calls[0].command).toBe(\"yarn install\");\n * ```\n */\nexport class MemoryShellProvider implements ShellProvider {\n  /**\n   * All recorded shell calls.\n   */\n  public calls: MemoryShellCall[] = [];\n\n  /**\n   * Simulated outputs for specific commands.\n   */\n  public outputs = new Map<string, string>();\n\n  /**\n   * Commands that should throw an error.\n   */\n  public errors = new Map<string, string>();\n\n  /**\n   * Commands considered installed in the system PATH.\n   */\n  public installedCommands = new Set<string>();\n\n  /**\n   * Configure the mock with predefined outputs, errors, and installed commands.\n   */\n  public configure(options: MemoryShellProviderOptions): this {\n    if (options.outputs) {\n      for (const [cmd, output] of Object.entries(options.outputs)) {\n        this.outputs.set(cmd, output);\n      }\n    }\n    if (options.errors) {\n      for (const [cmd, error] of Object.entries(options.errors)) {\n        this.errors.set(cmd, error);\n      }\n    }\n    if (options.installedCommands) {\n      for (const cmd of options.installedCommands) {\n        this.installedCommands.add(cmd);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * Record command and return simulated output.\n   */\n  public async run(\n    command: string,\n    options: ShellRunOptions = {},\n  ): Promise<string> {\n    this.calls.push({ command, options });\n\n    // Check for configured error\n    const errorMsg = this.errors.get(command);\n    if (errorMsg) {\n      throw new Error(errorMsg);\n    }\n\n    // Return configured output or empty string\n    return this.outputs.get(command) ?? \"\";\n  }\n\n  /**\n   * Check if a specific command was called.\n   */\n  public wasCalled(command: string): boolean {\n    return this.calls.some((call) => call.command === command);\n  }\n\n  /**\n   * Check if a command matching a pattern was called.\n   */\n  public wasCalledMatching(pattern: RegExp): boolean {\n    return this.calls.some((call) => pattern.test(call.command));\n  }\n\n  /**\n   * Get all calls matching a pattern.\n   */\n  public getCallsMatching(pattern: RegExp): MemoryShellCall[] {\n    return this.calls.filter((call) => pattern.test(call.command));\n  }\n\n  /**\n   * Check if a command is installed.\n   */\n  public async isInstalled(command: string): Promise<boolean> {\n    return this.installedCommands.has(command);\n  }\n\n  /**\n   * Reset all recorded state.\n   */\n  public reset(): void {\n    this.calls = [];\n    this.outputs.clear();\n    this.errors.clear();\n    this.installedCommands.clear();\n  }\n}\n","import { Readable } from \"node:stream\";\n\nexport interface FileTypeResult {\n  /**\n   * The detected MIME type\n   */\n  mimeType: string;\n  /**\n   * The detected file extension\n   */\n  extension: string;\n  /**\n   * Whether the file type was verified by magic bytes\n   */\n  verified: boolean;\n  /**\n   * The stream (potentially wrapped to allow re-reading)\n   */\n  stream: Readable;\n}\n\n/**\n * Service for detecting file types and getting content types.\n *\n * @example\n * ```typescript\n * const detector = alepha.inject(FileDetector);\n *\n * // Get content type from filename\n * const mimeType = detector.getContentType(\"image.png\"); // \"image/png\"\n *\n * // Detect file type by magic bytes\n * const stream = createReadStream('image.png');\n * const result = await detector.detectFileType(stream, 'image.png');\n * console.log(result.mimeType); // 'image/png'\n * console.log(result.verified); // true if magic bytes match\n * ```\n */\nexport class FileDetector {\n  /**\n   * Magic byte signatures for common file formats.\n   * Each signature is represented as an array of bytes or null (wildcard).\n   */\n  protected static readonly MAGIC_BYTES: Record<\n    string,\n    { signature: (number | null)[]; mimeType: string }[]\n  > = {\n    // Images\n    png: [\n      {\n        signature: [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a],\n        mimeType: \"image/png\",\n      },\n    ],\n    jpg: [\n      { signature: [0xff, 0xd8, 0xff, 0xe0], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe1], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe2], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe3], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe8], mimeType: \"image/jpeg\" },\n    ],\n    jpeg: [\n      { signature: [0xff, 0xd8, 0xff, 0xe0], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe1], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe2], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe3], mimeType: \"image/jpeg\" },\n      { signature: [0xff, 0xd8, 0xff, 0xe8], mimeType: \"image/jpeg\" },\n    ],\n    gif: [\n      {\n        signature: [0x47, 0x49, 0x46, 0x38, 0x37, 0x61],\n        mimeType: \"image/gif\",\n      }, // GIF87a\n      {\n        signature: [0x47, 0x49, 0x46, 0x38, 0x39, 0x61],\n        mimeType: \"image/gif\",\n      }, // GIF89a\n    ],\n    webp: [\n      {\n        signature: [\n          0x52,\n          0x49,\n          0x46,\n          0x46,\n          null,\n          null,\n          null,\n          null,\n          0x57,\n          0x45,\n          0x42,\n          0x50,\n        ],\n        mimeType: \"image/webp\",\n      },\n    ],\n    bmp: [{ signature: [0x42, 0x4d], mimeType: \"image/bmp\" }],\n    ico: [{ signature: [0x00, 0x00, 0x01, 0x00], mimeType: \"image/x-icon\" }],\n    tiff: [\n      { signature: [0x49, 0x49, 0x2a, 0x00], mimeType: \"image/tiff\" }, // Little-endian\n      { signature: [0x4d, 0x4d, 0x00, 0x2a], mimeType: \"image/tiff\" }, // Big-endian\n    ],\n    tif: [\n      { signature: [0x49, 0x49, 0x2a, 0x00], mimeType: \"image/tiff\" },\n      { signature: [0x4d, 0x4d, 0x00, 0x2a], mimeType: \"image/tiff\" },\n    ],\n\n    // Documents\n    pdf: [\n      {\n        signature: [0x25, 0x50, 0x44, 0x46, 0x2d],\n        mimeType: \"application/pdf\",\n      },\n    ], // %PDF-\n    zip: [\n      { signature: [0x50, 0x4b, 0x03, 0x04], mimeType: \"application/zip\" },\n      { signature: [0x50, 0x4b, 0x05, 0x06], mimeType: \"application/zip\" },\n      { signature: [0x50, 0x4b, 0x07, 0x08], mimeType: \"application/zip\" },\n    ],\n\n    // Archives\n    rar: [\n      {\n        signature: [0x52, 0x61, 0x72, 0x21, 0x1a, 0x07],\n        mimeType: \"application/vnd.rar\",\n      },\n    ],\n    \"7z\": [\n      {\n        signature: [0x37, 0x7a, 0xbc, 0xaf, 0x27, 0x1c],\n        mimeType: \"application/x-7z-compressed\",\n      },\n    ],\n    tar: [\n      {\n        signature: [0x75, 0x73, 0x74, 0x61, 0x72],\n        mimeType: \"application/x-tar\",\n      },\n    ],\n    gz: [{ signature: [0x1f, 0x8b], mimeType: \"application/gzip\" }],\n    tgz: [{ signature: [0x1f, 0x8b], mimeType: \"application/gzip\" }],\n\n    // Audio\n    mp3: [\n      { signature: [0xff, 0xfb], mimeType: \"audio/mpeg\" },\n      { signature: [0xff, 0xf3], mimeType: \"audio/mpeg\" },\n      { signature: [0xff, 0xf2], mimeType: \"audio/mpeg\" },\n      { signature: [0x49, 0x44, 0x33], mimeType: \"audio/mpeg\" }, // ID3\n    ],\n    wav: [\n      {\n        signature: [\n          0x52,\n          0x49,\n          0x46,\n          0x46,\n          null,\n          null,\n          null,\n          null,\n          0x57,\n          0x41,\n          0x56,\n          0x45,\n        ],\n        mimeType: \"audio/wav\",\n      },\n    ],\n    ogg: [{ signature: [0x4f, 0x67, 0x67, 0x53], mimeType: \"audio/ogg\" }],\n    flac: [{ signature: [0x66, 0x4c, 0x61, 0x43], mimeType: \"audio/flac\" }], // fLaC\n\n    // Video\n    mp4: [\n      {\n        signature: [null, null, null, null, 0x66, 0x74, 0x79, 0x70],\n        mimeType: \"video/mp4\",\n      }, // ftyp\n      {\n        signature: [\n          null,\n          null,\n          null,\n          null,\n          0x66,\n          0x74,\n          0x79,\n          0x70,\n          0x69,\n          0x73,\n          0x6f,\n          0x6d,\n        ],\n        mimeType: \"video/mp4\",\n      }, // ftypisom\n      {\n        signature: [\n          null,\n          null,\n          null,\n          null,\n          0x66,\n          0x74,\n          0x79,\n          0x70,\n          0x6d,\n          0x70,\n          0x34,\n          0x32,\n        ],\n        mimeType: \"video/mp4\",\n      }, // ftypmp42\n    ],\n    webm: [{ signature: [0x1a, 0x45, 0xdf, 0xa3], mimeType: \"video/webm\" }],\n    avi: [\n      {\n        signature: [\n          0x52,\n          0x49,\n          0x46,\n          0x46,\n          null,\n          null,\n          null,\n          null,\n          0x41,\n          0x56,\n          0x49,\n          0x20,\n        ],\n        mimeType: \"video/x-msvideo\",\n      },\n    ],\n    mov: [\n      {\n        signature: [\n          null,\n          null,\n          null,\n          null,\n          0x66,\n          0x74,\n          0x79,\n          0x70,\n          0x71,\n          0x74,\n          0x20,\n          0x20,\n        ],\n        mimeType: \"video/quicktime\",\n      },\n    ],\n    mkv: [\n      { signature: [0x1a, 0x45, 0xdf, 0xa3], mimeType: \"video/x-matroska\" },\n    ],\n\n    // Office (DOCX, XLSX, PPTX are all ZIP-based)\n    docx: [\n      {\n        signature: [0x50, 0x4b, 0x03, 0x04],\n        mimeType:\n          \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n      },\n    ],\n    xlsx: [\n      {\n        signature: [0x50, 0x4b, 0x03, 0x04],\n        mimeType:\n          \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n      },\n    ],\n    pptx: [\n      {\n        signature: [0x50, 0x4b, 0x03, 0x04],\n        mimeType:\n          \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n      },\n    ],\n    doc: [\n      {\n        signature: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1],\n        mimeType: \"application/msword\",\n      },\n    ],\n    xls: [\n      {\n        signature: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1],\n        mimeType: \"application/vnd.ms-excel\",\n      },\n    ],\n    ppt: [\n      {\n        signature: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1],\n        mimeType: \"application/vnd.ms-powerpoint\",\n      },\n    ],\n  };\n\n  /**\n   * All possible format signatures for checking against actual file content\n   */\n  protected static readonly ALL_SIGNATURES = Object.entries(\n    FileDetector.MAGIC_BYTES,\n  ).flatMap(([ext, signatures]) => signatures.map((sig) => ({ ext, ...sig })));\n\n  /**\n   * MIME type map for file extensions.\n   *\n   * Can be used to get the content type of file based on its extension.\n   * Feel free to add more mime types in your project!\n   */\n  public static readonly mimeMap: Record<string, string> = {\n    // Documents\n    json: \"application/json\",\n    txt: \"text/plain\",\n    html: \"text/html\",\n    htm: \"text/html\",\n    xml: \"application/xml\",\n    csv: \"text/csv\",\n    pdf: \"application/pdf\",\n    md: \"text/markdown\",\n    markdown: \"text/markdown\",\n    rtf: \"application/rtf\",\n\n    // Styles and scripts\n    css: \"text/css\",\n    js: \"application/javascript\",\n    mjs: \"application/javascript\",\n    ts: \"application/typescript\",\n    jsx: \"text/jsx\",\n    tsx: \"text/tsx\",\n\n    // Archives\n    zip: \"application/zip\",\n    rar: \"application/vnd.rar\",\n    \"7z\": \"application/x-7z-compressed\",\n    tar: \"application/x-tar\",\n    gz: \"application/gzip\",\n    tgz: \"application/gzip\",\n\n    // Images\n    png: \"image/png\",\n    jpg: \"image/jpeg\",\n    jpeg: \"image/jpeg\",\n    gif: \"image/gif\",\n    webp: \"image/webp\",\n    svg: \"image/svg+xml\",\n    bmp: \"image/bmp\",\n    ico: \"image/x-icon\",\n    tiff: \"image/tiff\",\n    tif: \"image/tiff\",\n\n    // Audio\n    mp3: \"audio/mpeg\",\n    wav: \"audio/wav\",\n    ogg: \"audio/ogg\",\n    m4a: \"audio/mp4\",\n    aac: \"audio/aac\",\n    flac: \"audio/flac\",\n\n    // Video\n    mp4: \"video/mp4\",\n    webm: \"video/webm\",\n    avi: \"video/x-msvideo\",\n    mov: \"video/quicktime\",\n    wmv: \"video/x-ms-wmv\",\n    flv: \"video/x-flv\",\n    mkv: \"video/x-matroska\",\n\n    // Office\n    doc: \"application/msword\",\n    docx: \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n    xls: \"application/vnd.ms-excel\",\n    xlsx: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n    ppt: \"application/vnd.ms-powerpoint\",\n    pptx: \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n\n    // Fonts\n    woff: \"font/woff\",\n    woff2: \"font/woff2\",\n    ttf: \"font/ttf\",\n    otf: \"font/otf\",\n    eot: \"application/vnd.ms-fontobject\",\n  };\n\n  /**\n   * Reverse MIME type map for looking up extensions from MIME types.\n   * Prefers shorter, more common extensions when multiple exist.\n   */\n  protected static readonly reverseMimeMap: Record<string, string> = (() => {\n    const reverse: Record<string, string> = {};\n    // Process in order so common extensions come first\n    for (const [ext, mimeType] of Object.entries(FileDetector.mimeMap)) {\n      // Only set if not already set (prefer first/shorter extension)\n      if (!reverse[mimeType]) {\n        reverse[mimeType] = ext;\n      }\n    }\n    return reverse;\n  })();\n\n  /**\n   * Returns the file extension for a given MIME type.\n   *\n   * @param mimeType - The MIME type to look up\n   * @returns The file extension (without dot), or \"bin\" if not found\n   *\n   * @example\n   * ```typescript\n   * const detector = alepha.inject(FileDetector);\n   * const ext = detector.getExtensionFromMimeType(\"image/png\"); // \"png\"\n   * const ext2 = detector.getExtensionFromMimeType(\"application/octet-stream\"); // \"bin\"\n   * ```\n   */\n  getExtensionFromMimeType(mimeType: string): string {\n    return FileDetector.reverseMimeMap[mimeType] || \"bin\";\n  }\n  /**\n   * Returns the content type of file based on its filename.\n   *\n   * @param filename - The filename to check\n   * @returns The MIME type\n   *\n   * @example\n   * ```typescript\n   * const detector = alepha.inject(FileDetector);\n   * const mimeType = detector.getContentType(\"image.png\"); // \"image/png\"\n   * ```\n   */\n  getContentType(filename: string): string {\n    const ext = filename.toLowerCase().split(\".\").pop() || \"\";\n    return FileDetector.mimeMap[ext] || \"application/octet-stream\";\n  }\n\n  /**\n   * Detects the file type by checking magic bytes against the stream content.\n   *\n   * @param stream - The readable stream to check\n   * @param filename - The filename (used to get the extension)\n   * @returns File type information including MIME type, extension, and verification status\n   *\n   * @example\n   * ```typescript\n   * const detector = alepha.inject(FileDetector);\n   * const stream = createReadStream('image.png');\n   * const result = await detector.detectFileType(stream, 'image.png');\n   * console.log(result.mimeType); // 'image/png'\n   * console.log(result.verified); // true if magic bytes match\n   * ```\n   */\n  async detectFileType(\n    stream: Readable,\n    filename: string,\n  ): Promise<FileTypeResult> {\n    // Get the expected MIME type from the filename extension\n    const expectedMimeType = this.getContentType(filename);\n\n    // Extract extension - only if filename contains a dot\n    const lastDotIndex = filename.lastIndexOf(\".\");\n    const ext =\n      lastDotIndex > 0\n        ? filename.substring(lastDotIndex + 1).toLowerCase()\n        : \"\";\n\n    // Read the first 16 bytes (enough for most magic byte checks)\n    const { buffer, stream: newStream } = await this.peekBytes(stream, 16);\n\n    // First, check if the extension's expected signature matches\n    const expectedSignatures = FileDetector.MAGIC_BYTES[ext];\n    if (expectedSignatures) {\n      for (const { signature, mimeType } of expectedSignatures) {\n        if (this.matchesSignature(buffer, signature)) {\n          return {\n            mimeType,\n            extension: ext,\n            verified: true,\n            stream: newStream,\n          };\n        }\n      }\n    }\n\n    // If the expected signature didn't match, try all other signatures\n    for (const {\n      ext: detectedExt,\n      signature,\n      mimeType,\n    } of FileDetector.ALL_SIGNATURES) {\n      if (detectedExt !== ext && this.matchesSignature(buffer, signature)) {\n        return {\n          mimeType,\n          extension: detectedExt,\n          verified: true,\n          stream: newStream,\n        };\n      }\n    }\n\n    // If no magic bytes matched, fall back to extension-based detection\n    // or return binary if extension is not recognized\n    return {\n      mimeType: expectedMimeType,\n      extension: ext,\n      verified: false,\n      stream: newStream,\n    };\n  }\n\n  /**\n   * Reads all bytes from a stream and returns the first N bytes along with a new stream containing all data.\n   * This approach reads the entire stream upfront to avoid complex async handling issues.\n   *\n   * @protected\n   */\n  protected async peekBytes(\n    stream: Readable,\n    numBytes: number,\n  ): Promise<{ buffer: Buffer; stream: Readable }> {\n    const chunks: Buffer[] = [];\n\n    // Read the entire stream\n    for await (const chunk of stream) {\n      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n    }\n\n    const allData = Buffer.concat(chunks);\n    const buffer = allData.subarray(0, numBytes);\n\n    // Create a new stream with all the data\n    const newStream = Readable.from(allData);\n\n    return { buffer, stream: newStream };\n  }\n\n  /**\n   * Checks if a buffer matches a magic byte signature.\n   *\n   * @protected\n   */\n  protected matchesSignature(\n    buffer: Buffer,\n    signature: (number | null)[],\n  ): boolean {\n    if (buffer.length < signature.length) {\n      return false;\n    }\n\n    for (let i = 0; i < signature.length; i++) {\n      if (signature[i] !== null && buffer[i] !== signature[i]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n","import { createReadStream } from \"node:fs\";\nimport {\n  access,\n  copyFile,\n  cp as fsCp,\n  mkdir as fsMkdir,\n  readFile as fsReadFile,\n  rm as fsRm,\n  writeFile as fsWriteFile,\n  readdir,\n  rename,\n  stat,\n} from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { PassThrough, Readable } from \"node:stream\";\nimport type { ReadableStream as NodeWebStream } from \"node:stream/web\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  $inject,\n  AlephaError,\n  type FileLike,\n  isFileLike,\n  Json,\n  type StreamLike,\n} from \"alepha\";\nimport { FileDetector } from \"../services/FileDetector.ts\";\nimport type {\n  CpOptions,\n  CreateFileOptions,\n  FileSystemProvider,\n  LsOptions,\n  MkdirOptions,\n  RmOptions,\n} from \"./FileSystemProvider.ts\";\n\n/**\n * Node.js implementation of FileSystem interface.\n *\n * @example\n * ```typescript\n * const fs = alepha.inject(NodeFileSystemProvider);\n *\n * // Create from URL\n * const file1 = fs.createFile({ url: \"file:///path/to/file.png\" });\n *\n * // Create from Buffer\n * const file2 = fs.createFile({ buffer: Buffer.from(\"hello\"), name: \"hello.txt\" });\n *\n * // Create from text\n * const file3 = fs.createFile({ text: \"Hello, world!\", name: \"greeting.txt\" });\n *\n * // File operations\n * await fs.mkdir(\"/tmp/mydir\", { recursive: true });\n * await fs.cp(\"/src/file.txt\", \"/dest/file.txt\");\n * await fs.mv(\"/old/path.txt\", \"/new/path.txt\");\n * const files = await fs.ls(\"/tmp\");\n * await fs.rm(\"/tmp/file.txt\");\n * ```\n */\nexport class NodeFileSystemProvider implements FileSystemProvider {\n  protected detector = $inject(FileDetector);\n  protected json = $inject(Json);\n\n  public join(...paths: string[]): string {\n    return join(...paths);\n  }\n\n  /**\n   * Creates a FileLike object from various sources.\n   *\n   * @param options - Options for creating the file\n   * @returns A FileLike object\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // From URL\n   * const file1 = fs.createFile({ url: \"https://example.com/image.png\" });\n   *\n   * // From Buffer\n   * const file2 = fs.createFile({\n   *   buffer: Buffer.from(\"hello\"),\n   *   name: \"hello.txt\",\n   *   type: \"text/plain\"\n   * });\n   *\n   * // From text\n   * const file3 = fs.createFile({ text: \"Hello!\", name: \"greeting.txt\" });\n   *\n   * // From stream with detection\n   * const stream = createReadStream(\"/path/to/file.png\");\n   * const file4 = fs.createFile({ stream, name: \"image.png\" });\n   * ```\n   */\n  createFile(options: CreateFileOptions): FileLike {\n    if (\"path\" in options) {\n      const path = options.path;\n      const filename = path.split(\"/\").pop() || \"file\";\n      return this.createFileFromUrl(`file://${path}`, {\n        type: options.type,\n        name: options.name || filename,\n      });\n    }\n\n    // Handle URL\n    if (\"url\" in options) {\n      return this.createFileFromUrl(options.url, {\n        type: options.type,\n        name: options.name,\n      });\n    }\n\n    if (\"response\" in options) {\n      if (!options.response.body) {\n        throw new AlephaError(\"Response has no body stream\");\n      }\n      const res = options.response;\n      // guess size from content-length header if available\n      const sizeHeader = res.headers.get(\"content-length\");\n      const size = sizeHeader ? parseInt(sizeHeader, 10) : undefined;\n      // guess name from content-disposition header if available\n      let name = options.name;\n      const contentDisposition = res.headers.get(\"content-disposition\");\n      if (contentDisposition && !name) {\n        const match = contentDisposition.match(/filename=\"?([^\"]+)\"?/);\n        if (match) {\n          name = match[1];\n        }\n      }\n      // guess type from content-type header if available\n      const type = options.type || res.headers.get(\"content-type\") || undefined;\n      return this.createFileFromStream(options.response.body, {\n        type,\n        name,\n        size,\n      });\n    }\n\n    // Handle Web File\n    if (\"file\" in options) {\n      return this.createFileFromWebFile(options.file, {\n        type: options.type,\n        name: options.name,\n        size: options.size,\n      });\n    }\n\n    // Handle Buffer\n    if (\"buffer\" in options) {\n      return this.createFileFromBuffer(options.buffer, {\n        type: options.type,\n        name: options.name,\n      });\n    }\n\n    // Handle ArrayBuffer\n    if (\"arrayBuffer\" in options) {\n      return this.createFileFromBuffer(Buffer.from(options.arrayBuffer), {\n        type: options.type,\n        name: options.name,\n      });\n    }\n\n    // Handle text\n    if (\"text\" in options) {\n      return this.createFileFromBuffer(Buffer.from(options.text, \"utf-8\"), {\n        type: options.type || \"text/plain\",\n        name: options.name || \"file.txt\",\n      });\n    }\n\n    // Handle stream\n    if (\"stream\" in options) {\n      return this.createFileFromStream(options.stream, {\n        type: options.type,\n        name: options.name,\n        size: options.size,\n      });\n    }\n\n    throw new AlephaError(\n      \"Invalid createFile options: no valid source provided\",\n    );\n  }\n\n  /**\n   * Removes a file or directory.\n   *\n   * @param path - The path to remove\n   * @param options - Remove options\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Remove a file\n   * await fs.rm(\"/tmp/file.txt\");\n   *\n   * // Remove a directory recursively\n   * await fs.rm(\"/tmp/mydir\", { recursive: true });\n   *\n   * // Remove with force (no error if doesn't exist)\n   * await fs.rm(\"/tmp/maybe-exists.txt\", { force: true });\n   * ```\n   */\n  async rm(path: string, options?: RmOptions): Promise<void> {\n    await fsRm(path, options);\n  }\n\n  /**\n   * Copies a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   * @param options - Copy options\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Copy a file\n   * await fs.cp(\"/src/file.txt\", \"/dest/file.txt\");\n   *\n   * // Copy a directory recursively\n   * await fs.cp(\"/src/dir\", \"/dest/dir\", { recursive: true });\n   *\n   * // Copy with force (overwrite existing)\n   * await fs.cp(\"/src/file.txt\", \"/dest/file.txt\", { force: true });\n   * ```\n   */\n  async cp(src: string, dest: string, options?: CpOptions): Promise<void> {\n    // Check if source is a directory\n    const srcStat = await stat(src);\n\n    if (srcStat.isDirectory()) {\n      if (!options?.recursive) {\n        throw new Error(\n          `Cannot copy directory without recursive option: ${src}`,\n        );\n      }\n      // Use Node.js cp function for recursive directory copy\n      await fsCp(src, dest, {\n        recursive: true,\n        force: options?.force ?? false,\n      });\n    } else {\n      // For files, use copyFile\n      await copyFile(src, dest);\n    }\n  }\n\n  /**\n   * Moves/renames a file or directory.\n   *\n   * @param src - Source path\n   * @param dest - Destination path\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Move/rename a file\n   * await fs.mv(\"/old/path.txt\", \"/new/path.txt\");\n   *\n   * // Move a directory\n   * await fs.mv(\"/old/dir\", \"/new/dir\");\n   * ```\n   */\n  async mv(src: string, dest: string): Promise<void> {\n    await rename(src, dest);\n  }\n\n  /**\n   * Creates a directory.\n   *\n   * @param path - The directory path to create\n   * @param options - Mkdir options\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Create a directory\n   * await fs.mkdir(\"/tmp/mydir\");\n   *\n   * // Create nested directories\n   * await fs.mkdir(\"/tmp/path/to/dir\", { recursive: true });\n   *\n   * // Create with specific permissions\n   * await fs.mkdir(\"/tmp/mydir\", { mode: 0o755 });\n   * ```\n   */\n  async mkdir(path: string, options: MkdirOptions = {}): Promise<void> {\n    const p = fsMkdir(path, {\n      recursive: options.recursive ?? true,\n      mode: options.mode,\n    });\n\n    if (options.force === false) {\n      await p;\n    } else {\n      await p.catch(() => {});\n    }\n  }\n\n  /**\n   * Lists files in a directory.\n   *\n   * @param path - The directory path to list\n   * @param options - List options\n   * @returns Array of filenames\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // List files in a directory\n   * const files = await fs.ls(\"/tmp\");\n   * console.log(files); // [\"file1.txt\", \"file2.txt\", \"subdir\"]\n   *\n   * // List with hidden files\n   * const allFiles = await fs.ls(\"/tmp\", { hidden: true });\n   *\n   * // List recursively\n   * const allFilesRecursive = await fs.ls(\"/tmp\", { recursive: true });\n   * ```\n   */\n  async ls(path: string, options?: LsOptions): Promise<string[]> {\n    const entries = await readdir(path);\n\n    // Filter out hidden files if not requested\n    const filteredEntries = options?.hidden\n      ? entries\n      : entries.filter((e) => !e.startsWith(\".\"));\n\n    // If recursive, get all nested files\n    if (options?.recursive) {\n      const allFiles: string[] = [];\n\n      for (const entry of filteredEntries) {\n        const fullPath = join(path, entry);\n        const entryStat = await stat(fullPath);\n\n        if (entryStat.isDirectory()) {\n          // Add directory entry\n          allFiles.push(entry);\n          // Recursively get files from subdirectory\n          const subFiles = await this.ls(fullPath, options);\n          allFiles.push(...subFiles.map((f) => join(entry, f)));\n        } else {\n          allFiles.push(entry);\n        }\n      }\n\n      return allFiles;\n    }\n\n    return filteredEntries;\n  }\n\n  /**\n   * Checks if a file or directory exists.\n   *\n   * @param path - The path to check\n   * @returns True if the path exists, false otherwise\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * if (await fs.exists(\"/tmp/file.txt\")) {\n   *   console.log(\"File exists\");\n   * }\n   * ```\n   */\n  async exists(path: string): Promise<boolean> {\n    try {\n      await access(path);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Reads the content of a file.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a Buffer\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * const buffer = await fs.readFile(\"/tmp/file.txt\");\n   * console.log(buffer.toString(\"utf-8\"));\n   * ```\n   */\n  async readFile(path: string): Promise<Buffer> {\n    return await fsReadFile(path);\n  }\n\n  /**\n   * Writes data to a file.\n   *\n   * @param path - The file path to write to\n   * @param data - The data to write (Buffer or string)\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   *\n   * // Write string\n   * await fs.writeFile(\"/tmp/file.txt\", \"Hello, world!\");\n   *\n   * // Write Buffer\n   * await fs.writeFile(\"/tmp/file.bin\", Buffer.from([0x01, 0x02, 0x03]));\n   * ```\n   */\n  async writeFile(\n    path: string,\n    data: Uint8Array | Buffer | string | FileLike,\n  ): Promise<void> {\n    if (isFileLike(data)) {\n      await fsWriteFile(path, Readable.from(data.stream()));\n      return;\n    }\n    await fsWriteFile(path, data);\n  }\n\n  /**\n   * Reads the content of a file as a string.\n   *\n   * @param path - The file path to read\n   * @returns The file content as a string\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   * const content = await fs.readTextFile(\"/tmp/file.txt\");\n   * ```\n   */\n  async readTextFile(path: string): Promise<string> {\n    const buffer = await this.readFile(path);\n    return buffer.toString(\"utf-8\");\n  }\n\n  /**\n   * Reads the content of a file as JSON.\n   *\n   * @param path - The file path to read\n   * @returns The parsed JSON content\n   *\n   * @example\n   * ```typescript\n   * const fs = alepha.inject(NodeFileSystemProvider);\n   * const config = await fs.readJsonFile<{ name: string }>(\"/tmp/config.json\");\n   * ```\n   */\n  async readJsonFile<T = unknown>(path: string): Promise<T> {\n    const text = await this.readTextFile(path);\n    return this.json.parse(text) as T;\n  }\n\n  /**\n   * Creates a FileLike object from a Web File.\n   *\n   * @protected\n   */\n  protected createFileFromWebFile(\n    source: File,\n    options: {\n      type?: string;\n      name?: string;\n      size?: number;\n    } = {},\n  ): FileLike {\n    const name = options.name ?? source.name;\n    return {\n      name,\n      type: options.type ?? (source.type || this.detector.getContentType(name)),\n      size: options.size ?? source.size ?? 0,\n      lastModified: source.lastModified || Date.now(),\n      stream: () => source.stream(),\n      arrayBuffer: async (): Promise<ArrayBuffer> => {\n        return await source.arrayBuffer();\n      },\n      text: async (): Promise<string> => {\n        return await source.text();\n      },\n    };\n  }\n\n  /**\n   * Creates a FileLike object from a Buffer.\n   *\n   * @protected\n   */\n  protected createFileFromBuffer(\n    source: Buffer,\n    options: {\n      type?: string;\n      name?: string;\n    } = {},\n  ): FileLike {\n    const name: string = options.name ?? \"file\";\n    return {\n      name,\n      type: options.type ?? this.detector.getContentType(options.name ?? name),\n      size: source.byteLength,\n      lastModified: Date.now(),\n      stream: (): Readable => Readable.from(source),\n      arrayBuffer: async (): Promise<ArrayBuffer> => {\n        return this.bufferToArrayBuffer(source);\n      },\n      text: async (): Promise<string> => {\n        return source.toString(\"utf-8\");\n      },\n    };\n  }\n\n  /**\n   * Creates a FileLike object from a stream.\n   *\n   * @protected\n   */\n  protected createFileFromStream(\n    source: StreamLike,\n    options: {\n      type?: string;\n      name?: string;\n      size?: number;\n    } = {},\n  ): FileLike & { _buffer: null | Buffer } {\n    let buffer: Buffer | null = null;\n\n    return {\n      name: options.name ?? \"file\",\n      type:\n        options.type ?? this.detector.getContentType(options.name ?? \"file\"),\n      size: options.size ?? 0,\n      lastModified: Date.now(),\n      stream: () => source,\n      _buffer: null as Buffer | null,\n      arrayBuffer: async () => {\n        buffer ??= await this.streamToBuffer(source);\n        return this.bufferToArrayBuffer(buffer);\n      },\n      text: async () => {\n        buffer ??= await this.streamToBuffer(source);\n        return buffer.toString(\"utf-8\");\n      },\n    };\n  }\n\n  /**\n   * Creates a FileLike object from a URL.\n   *\n   * @protected\n   */\n  protected createFileFromUrl(\n    url: string,\n    options: {\n      type?: string;\n      name?: string;\n    } = {},\n  ): FileLike {\n    const parsedUrl = new URL(url);\n    const filename =\n      options.name || parsedUrl.pathname.split(\"/\").pop() || \"file\";\n    let buffer: Buffer | null = null;\n\n    return {\n      name: filename,\n      type: options.type ?? this.detector.getContentType(filename),\n      size: 0, // Unknown size until loaded\n      lastModified: Date.now(),\n      stream: () => this.createStreamFromUrl(url),\n      arrayBuffer: async () => {\n        buffer ??= await this.loadFromUrl(url);\n        return this.bufferToArrayBuffer(buffer);\n      },\n      text: async () => {\n        buffer ??= await this.loadFromUrl(url);\n        return buffer.toString(\"utf-8\");\n      },\n      filepath: url,\n    };\n  }\n\n  /**\n   * Gets a streaming response from a URL.\n   *\n   * @protected\n   */\n  protected getStreamingResponse(url: string): Readable {\n    const stream = new PassThrough();\n\n    fetch(url)\n      .then((res) =>\n        Readable.fromWeb(res.body as unknown as NodeWebStream).pipe(stream),\n      )\n      .catch((err) => stream.destroy(err));\n\n    return stream;\n  }\n\n  /**\n   * Loads data from a URL.\n   *\n   * @protected\n   */\n  protected async loadFromUrl(url: string): Promise<Buffer> {\n    const parsedUrl = new URL(url);\n\n    if (parsedUrl.protocol === \"file:\") {\n      // Handle file:// URLs\n      const filePath = fileURLToPath(url);\n      return await fsReadFile(filePath);\n    } else if (\n      parsedUrl.protocol === \"http:\" ||\n      parsedUrl.protocol === \"https:\"\n    ) {\n      // Handle HTTP/HTTPS URLs\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new Error(\n          `Failed to fetch ${url}: ${response.status} ${response.statusText}`,\n        );\n      }\n      const arrayBuffer = await response.arrayBuffer();\n      return Buffer.from(arrayBuffer);\n    } else {\n      throw new Error(`Unsupported protocol: ${parsedUrl.protocol}`);\n    }\n  }\n\n  /**\n   * Creates a stream from a URL.\n   *\n   * @protected\n   */\n  protected createStreamFromUrl(url: string): Readable {\n    const parsedUrl = new URL(url);\n\n    if (parsedUrl.protocol === \"file:\") {\n      // For file:// URLs, create a stream that reads the file\n      return createReadStream(fileURLToPath(url));\n    } else if (\n      parsedUrl.protocol === \"http:\" ||\n      parsedUrl.protocol === \"https:\"\n    ) {\n      // For HTTP/HTTPS URLs, create a stream that fetches the content\n      return this.getStreamingResponse(url);\n    } else {\n      throw new AlephaError(`Unsupported protocol: ${parsedUrl.protocol}`);\n    }\n  }\n\n  /**\n   * Converts a stream-like object to a Buffer.\n   *\n   * @protected\n   */\n  protected async streamToBuffer(streamLike: StreamLike): Promise<Buffer> {\n    const stream =\n      streamLike instanceof Readable\n        ? streamLike\n        : Readable.fromWeb(streamLike as NodeWebStream);\n\n    return new Promise<Buffer>((resolve, reject) => {\n      const buffer: any[] = [];\n      stream.on(\"data\", (chunk) => buffer.push(Buffer.from(chunk)));\n      stream.on(\"end\", () => resolve(Buffer.concat(buffer)));\n      stream.on(\"error\", (err) =>\n        reject(new AlephaError(\"Error converting stream\", { cause: err })),\n      );\n    });\n  }\n\n  /**\n   * Converts a Node.js Buffer to an ArrayBuffer.\n   *\n   * @protected\n   */\n  protected bufferToArrayBuffer(buffer: Buffer): ArrayBuffer {\n    return buffer.buffer.slice(\n      buffer.byteOffset,\n      buffer.byteOffset + buffer.byteLength,\n    ) as ArrayBuffer;\n  }\n}\n","import { exec, spawn } from \"node:child_process\";\nimport { $inject, AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { FileSystemProvider } from \"./FileSystemProvider.ts\";\nimport type { ShellProvider, ShellRunOptions } from \"./ShellProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Node.js implementation of ShellProvider.\n *\n * Executes shell commands using Node.js child_process module.\n * Supports binary resolution from node_modules/.bin for local packages.\n */\nexport class NodeShellProvider implements ShellProvider {\n  protected readonly log = $logger();\n  protected readonly fs = $inject(FileSystemProvider);\n\n  /**\n   * Run a shell command or binary.\n   */\n  public async run(\n    command: string,\n    options: ShellRunOptions = {},\n  ): Promise<string> {\n    const { resolve = false, capture = false, root, env } = options;\n    const cwd = root ?? process.cwd();\n\n    this.log.debug(`Shell: ${command}`, { cwd, resolve, capture });\n\n    let executable: string;\n    let args: string[];\n\n    if (resolve) {\n      const [bin, ...rest] = command.split(\" \");\n      executable = await this.resolveExecutable(bin, cwd);\n      args = rest;\n    } else {\n      [executable, ...args] = command.split(\" \");\n    }\n\n    if (capture) {\n      return this.execCapture(command, { cwd, env });\n    }\n\n    return this.execInherit(executable, args, { cwd, env });\n  }\n\n  /**\n   * Execute command with inherited stdio (streams to terminal).\n   */\n  protected async execInherit(\n    executable: string,\n    args: string[],\n    options: { cwd: string; env?: Record<string, string> },\n  ): Promise<string> {\n    const proc = spawn(executable, args, {\n      stdio: \"inherit\",\n      cwd: options.cwd,\n      env: {\n        ...process.env,\n        ...options.env,\n      },\n    });\n\n    return new Promise<string>((resolve, reject) => {\n      proc.on(\"exit\", (code) => {\n        if (code === 0 || code === null) {\n          resolve(\"\");\n        } else {\n          reject(new AlephaError(`Command exited with code ${code}`));\n        }\n      });\n      proc.on(\"error\", reject);\n    });\n  }\n\n  /**\n   * Execute command and capture stdout.\n   */\n  protected execCapture(\n    command: string,\n    options: { cwd: string; env?: Record<string, string> },\n  ): Promise<string> {\n    return new Promise<string>((resolve, reject) => {\n      exec(\n        command,\n        {\n          cwd: options.cwd,\n          env: {\n            ...process.env,\n            LOG_FORMAT: \"pretty\",\n            ...options.env,\n          },\n        },\n        (err, stdout) => {\n          if (err) {\n            (err as any).stdout = stdout;\n            reject(err);\n          } else {\n            resolve(stdout);\n          }\n        },\n      );\n    });\n  }\n\n  /**\n   * Resolve executable path from node_modules/.bin.\n   *\n   * Search order:\n   * 1. Local: node_modules/.bin/\n   * 2. Pnpm nested: node_modules/alepha/node_modules/.bin/\n   * 3. Monorepo: Walk up to 3 parent directories\n   */\n  protected async resolveExecutable(\n    name: string,\n    root: string,\n  ): Promise<string> {\n    const suffix = process.platform === \"win32\" ? \".cmd\" : \"\";\n\n    // 1. Local node_modules\n    let execPath = await this.findExecutable(\n      root,\n      `node_modules/.bin/${name}${suffix}`,\n    );\n\n    // 2. Pnpm nested (alepha's own node_modules)\n    if (!execPath) {\n      execPath = await this.findExecutable(\n        root,\n        `node_modules/alepha/node_modules/.bin/${name}${suffix}`,\n      );\n    }\n\n    // 3. Monorepo: check parent directories (up to 3 levels)\n    if (!execPath) {\n      let parentDir = this.fs.join(root, \"..\");\n      for (let i = 0; i < 3; i++) {\n        execPath = await this.findExecutable(\n          parentDir,\n          `node_modules/.bin/${name}${suffix}`,\n        );\n        if (execPath) break;\n        parentDir = this.fs.join(parentDir, \"..\");\n      }\n    }\n\n    if (!execPath) {\n      throw new AlephaError(\n        `Could not find executable for '${name}'. Make sure the package is installed.`,\n      );\n    }\n\n    return execPath;\n  }\n\n  /**\n   * Check if executable exists at path.\n   */\n  protected async findExecutable(\n    root: string,\n    relativePath: string,\n  ): Promise<string | undefined> {\n    const fullPath = this.fs.join(root, relativePath);\n    if (await this.fs.exists(fullPath)) {\n      return fullPath;\n    }\n    return undefined;\n  }\n\n  /**\n   * Check if a command is installed and available in the system PATH.\n   */\n  public isInstalled(command: string): Promise<boolean> {\n    return new Promise((resolve) => {\n      const check =\n        process.platform === \"win32\"\n          ? `where ${command}`\n          : `command -v ${command}`;\n      exec(check, (error) => resolve(!error));\n    });\n  }\n}\n","// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ShellRunOptions {\n  /**\n   * Working directory for the command.\n   */\n  root?: string;\n\n  /**\n   * Additional environment variables.\n   */\n  env?: Record<string, string>;\n\n  /**\n   * Resolve the executable from node_modules/.bin.\n   * Supports local project, pnpm nested, and monorepo structures.\n   * @default false\n   */\n  resolve?: boolean;\n\n  /**\n   * Capture stdout instead of inheriting stdio.\n   * When true, returns stdout as string.\n   * When false, streams output to terminal.\n   * @default false\n   */\n  capture?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Abstract provider for executing shell commands and binaries.\n *\n * Implementations:\n * - `NodeShellProvider` - Real shell execution using Node.js child_process\n * - `MemoryShellProvider` - In-memory mock for testing\n *\n * @example\n * ```typescript\n * class MyService {\n *   protected readonly shell = $inject(ShellProvider);\n *\n *   async build() {\n *     // Run shell command directly\n *     await this.shell.run(\"yarn install\");\n *\n *     // Run local binary with resolution\n *     await this.shell.run(\"vite build\", { resolve: true });\n *\n *     // Capture output\n *     const output = await this.shell.run(\"echo hello\", { capture: true });\n *   }\n * }\n * ```\n */\nexport abstract class ShellProvider {\n  /**\n   * Run a shell command or binary.\n   *\n   * @param command - The command to run\n   * @param options - Execution options\n   * @returns stdout if capture is true, empty string otherwise\n   */\n  abstract run(command: string, options?: ShellRunOptions): Promise<string>;\n\n  /**\n   * Check if a command is installed and available in the system PATH.\n   *\n   * @param command - The command name to check\n   * @returns true if the command is available\n   */\n  abstract isInstalled(command: string): Promise<boolean>;\n}\n","import { $module } from \"alepha\";\nimport { FileSystemProvider } from \"./providers/FileSystemProvider.ts\";\nimport { MemoryFileSystemProvider } from \"./providers/MemoryFileSystemProvider.ts\";\nimport { MemoryShellProvider } from \"./providers/MemoryShellProvider.ts\";\nimport { NodeFileSystemProvider } from \"./providers/NodeFileSystemProvider.ts\";\nimport { NodeShellProvider } from \"./providers/NodeShellProvider.ts\";\nimport { ShellProvider } from \"./providers/ShellProvider.ts\";\nimport { FileDetector } from \"./services/FileDetector.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/FileError.ts\";\nexport * from \"./providers/FileSystemProvider.ts\";\nexport * from \"./providers/MemoryFileSystemProvider.ts\";\nexport * from \"./providers/MemoryShellProvider.ts\";\nexport * from \"./providers/NodeFileSystemProvider.ts\";\nexport * from \"./providers/NodeShellProvider.ts\";\nexport * from \"./providers/ShellProvider.ts\";\nexport * from \"./services/FileDetector.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | tooling | standard | stable |\n *\n * System-level abstractions for portable code across runtimes.\n *\n * **Features:**\n * - File system operations (read, write, exists, etc.)\n * - Shell command execution\n * - File type detection and MIME utilities\n * - Memory implementations for testing\n *\n * @module alepha.system\n */\nexport const AlephaSystem = $module({\n  name: \"alepha.system\",\n  primitives: [],\n  services: [\n    FileDetector,\n    FileSystemProvider,\n    MemoryFileSystemProvider,\n    NodeFileSystemProvider,\n    ShellProvider,\n    MemoryShellProvider,\n    NodeShellProvider,\n  ],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: FileSystemProvider,\n        use: NodeFileSystemProvider,\n      })\n      .with({\n        optional: true,\n        provide: ShellProvider,\n        use: alepha.isTest() ? MemoryShellProvider : NodeShellProvider,\n      }),\n});\n","import { createReadStream } from \"node:fs\";\nimport { access, readdir, stat } from \"node:fs/promises\";\nimport { basename, isAbsolute, join } from \"node:path\";\nimport type { Readable as NodeStream } from \"node:stream\";\nimport { $hook, $inject, Alepha } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { type ServerHandler, ServerRouterProvider } from \"alepha/server\";\nimport { FileDetector } from \"alepha/system\";\nimport { $serve, type ServePrimitiveOptions } from \"../primitives/$serve.ts\";\n\nexport class ServerStaticProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly routerProvider = $inject(ServerRouterProvider);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly fileDetector = $inject(FileDetector);\n  protected readonly log = $logger();\n  protected readonly directories: ServeDirectory[] = [];\n\n  protected readonly configure = $hook({\n    on: \"configure\",\n    handler: async () => {\n      await Promise.all(\n        this.alepha\n          .primitives($serve)\n          .map((it) => this.createStaticServer(it.options)),\n      );\n    },\n  });\n\n  public async createStaticServer(\n    options: ServePrimitiveOptions,\n  ): Promise<void> {\n    const prefix = options.path ?? \"/\";\n\n    let root = options.root ?? process.cwd();\n    if (!isAbsolute(root)) {\n      root = join(process.cwd(), root);\n    }\n\n    this.log.debug(\"Serve static files\", { prefix, root });\n\n    await stat(root);\n\n    // 1. get all files in the root directory (recursively)\n    const files = await this.getAllFiles(root, options.ignoreDotEnvFiles);\n\n    // 2. create a $route for each file (yes, this could be a lot of routes)\n    const routes = await Promise.all(\n      files.map(async (file) => {\n        const path = file.replace(root, \"\").replace(/\\\\/g, \"/\");\n        this.log.trace(`Mount ${join(prefix, path)} -> ${join(root, path)}`);\n        return {\n          path: join(prefix, encodeURI(path)),\n          handler: await this.createFileHandler(join(root, path), options),\n        };\n      }),\n    );\n\n    for (const route of routes) {\n      this.routerProvider.createRoute(route);\n\n      // if route is for index.html, also create a route without it\n      // e.g. /my/path/index.html -> /my/path/\n      if (\n        options.indexFallback !== false &&\n        route.path.endsWith(\"index.html\")\n      ) {\n        this.routerProvider.createRoute({\n          path: route.path.replace(/index\\.html$/, \"\"),\n          handler: route.handler,\n        });\n      }\n    }\n\n    // 3. store the directory info for reference\n    this.directories.push({\n      options,\n      files: files.map((file) => file.replace(root, \"\").replace(/\\\\/g, \"/\")),\n    });\n\n    // bonus! for SPAs, handle history API fallback\n    if (options.historyApiFallback) {\n      // meaning all unmatched routes should serve index.html\n      this.routerProvider.createRoute({\n        path: join(prefix, \"*\").replace(/\\\\/g, \"/\"),\n        handler: async (request) => {\n          const { reply } = request;\n\n          if (request.url.pathname.includes(\".\")) {\n            // If the request is for a file (e.g., /style.css), do not fall back\n            reply.headers[\"content-type\"] = \"text/plain\";\n            reply.body = \"Not Found\";\n            reply.status = 404;\n            return;\n          }\n\n          reply.headers[\"content-type\"] = \"text/html\";\n          reply.status = 200;\n\n          return new Promise<any>((resolve, reject) => {\n            const stream = createReadStream(join(root, \"index.html\"));\n            stream.on(\"open\", () => {\n              resolve(stream);\n            });\n            stream.on(\"error\", (err) => {\n              reject(err);\n            });\n          });\n        },\n      });\n    }\n  }\n\n  public async createFileHandler(\n    filepath: string,\n    options: ServePrimitiveOptions,\n  ): Promise<ServerHandler> {\n    const filename = basename(filepath);\n\n    const hasGzip = await access(`${filepath}.gz`)\n      .then(() => true)\n      .catch(() => false);\n\n    const hasBr = await access(`${filepath}.br`)\n      .then(() => true)\n      .catch(() => false);\n\n    const fileStat = await stat(filepath);\n    const lastModified = fileStat.mtime.toUTCString();\n    const etag = `\"${fileStat.size}-${fileStat.mtime.getTime()}\"`;\n    const contentType = this.fileDetector.getContentType(filename);\n    const cacheControl = this.getCacheControl(filename, options);\n\n    return async (request): Promise<NodeStream | undefined> => {\n      const { headers, reply } = request;\n      let path = filepath;\n\n      // 01/26 - when calling \"/directory\", redirect to \"/directory/\"\n      if (\n        options.path &&\n        options.path === request.url.pathname &&\n        !options.path.endsWith(\"/\")\n      ) {\n        reply.redirect(`${options.path}/`);\n        return;\n      }\n\n      const encoding = headers[\"accept-encoding\"];\n      if (encoding) {\n        if (hasBr && encoding.includes(\"br\")) {\n          reply.headers[\"content-encoding\"] = \"br\";\n          path += \".br\";\n        } else if (hasGzip && encoding.includes(\"gzip\")) {\n          reply.headers[\"content-encoding\"] = \"gzip\";\n          path += \".gz\";\n        }\n      }\n\n      reply.headers[\"content-type\"] = contentType;\n      reply.headers[\"accept-ranges\"] = \"bytes\";\n      reply.headers[\"last-modified\"] = lastModified;\n\n      if (cacheControl) {\n        reply.headers[\"cache-control\"] =\n          `public, max-age=${cacheControl.maxAge}`;\n        if (cacheControl.immutable) {\n          reply.headers[\"cache-control\"] += \", immutable\";\n        }\n      }\n\n      reply.headers.etag = etag;\n      if (\n        headers[\"if-none-match\"] === etag ||\n        headers[\"if-modified-since\"] === lastModified\n      ) {\n        reply.status = 304;\n        return;\n      }\n\n      return new Promise<any>((resolve, reject) => {\n        const stream = createReadStream(path);\n        stream.on(\"open\", () => {\n          resolve(stream);\n        });\n        stream.on(\"error\", (err) => {\n          reject(err);\n        });\n      });\n    };\n  }\n\n  protected getCacheFileTypes(): string[] {\n    return [\n      \".js\",\n      \".css\",\n      \".woff\",\n      \".woff2\",\n      \".ttf\",\n      \".eot\",\n      \".otf\",\n      \".jpg\",\n      \".jpeg\",\n      \".png\",\n      \".svg\",\n      \".gif\",\n    ];\n  }\n\n  protected getCacheControl(\n    filename: string,\n    options: ServePrimitiveOptions,\n  ): { maxAge: number; immutable: boolean } | undefined {\n    if (!options.cacheControl) {\n      return;\n    }\n\n    const fileTypes =\n      options.cacheControl.fileTypes ?? this.getCacheFileTypes();\n\n    for (const type of fileTypes) {\n      if (filename.endsWith(type)) {\n        return {\n          immutable: options.cacheControl.immutable ?? true,\n          maxAge: this.dateTimeProvider\n            .duration(options.cacheControl.maxAge ?? [30, \"days\"])\n            .as(\"seconds\"),\n        };\n      }\n    }\n  }\n\n  public async getAllFiles(\n    dir: string,\n    ignoreDotEnvFiles = true,\n  ): Promise<string[]> {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    const files = await Promise.all(\n      entries.map((dirent) => {\n        // skip .env & other dot files\n        if (ignoreDotEnvFiles && dirent.name.startsWith(\".\")) {\n          return [];\n        }\n\n        const fullPath = join(dir, dirent.name);\n        return dirent.isDirectory() ? this.getAllFiles(fullPath) : fullPath;\n      }),\n    );\n\n    return files.flat();\n  }\n}\n\nexport interface ServeDirectory {\n  options: ServePrimitiveOptions;\n  files: string[];\n}\n","import { $module } from \"alepha\";\nimport { AlephaServer } from \"alepha/server\";\nimport { $serve } from \"./primitives/$serve.ts\";\nimport { ServerStaticProvider } from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$serve.ts\";\nexport * from \"./providers/ServerStaticProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | backend | standard | stable |\n *\n * Static file serving.\n *\n * **Features:**\n * - Serve static files from directory\n *\n * @module alepha.server.static\n */\nexport const AlephaServerStatic = $module({\n  name: \"alepha.server.static\",\n  primitives: [$serve],\n  services: [AlephaServer, ServerStaticProvider],\n});\n"],"mappings":"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"}

package/dist/server/swagger/index.d.ts

@@ -333,8 +333,16 @@ interface CpOptions {
 interface MkdirOptions {
   /**
    * If true, creates parent directories as needed
+   *
+   * @default true
    */
   recursive?: boolean;
+  /**
+   * If true, does not throw an error if the directory already exists
+   *
+   * @default true
+   */
+  force?: boolean;
   /**
    * File mode (permission and sticky bits)
    */

package/dist/server/swagger/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/server/swagger/primitives/$swagger.ts","../../../src/system/providers/FileSystemProvider.ts","../../../src/server/swagger/providers/ServerSwaggerProvider.ts","../../../src/server/swagger/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/server/swagger/primitives/$swagger.ts","../../../src/system/providers/FileSystemProvider.ts","../../../src/server/swagger/providers/ServerSwaggerProvider.ts","../../../src/server/swagger/index.ts"],"mappings":"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"}

package/dist/server/swagger/index.js

@@ -1400,8 +1400,13 @@ var NodeFileSystemProvider = class {
 	* await fs.mkdir("/tmp/mydir", { mode: 0o755 });
 	* ```
 	*/
-	async mkdir(path, options) {
-		await mkdir(path, options);
+	async mkdir(path, options = {}) {
+		const p = mkdir(path, {
+			recursive: options.recursive ?? true,
+			mode: options.mode
+		});
+		if (options.force === false) await p;
+		else await p.catch(() => {});
 	}
 	/**
 	* Lists files in a directory.