alepha 0.15.2 → 0.15.4

package/dist/system/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":["nodeJoin"],"sources":["../../src/system/errors/FileError.ts","../../src/system/providers/FileSystemProvider.ts","../../src/system/providers/MemoryFileSystemProvider.ts","../../src/system/providers/MemoryShellProvider.ts","../../src/system/providers/ShellProvider.ts","../../src/system/index.browser.ts"],"sourcesContent":["export class FileError extends Error {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"FileError\";\n    this.cause = cause;\n  }\n}\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","// ---------------------------------------------------------------------------------------------------------------------\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\";\n\nexport * from \"./errors/FileError.ts\";\nexport * from \"./providers/FileSystemProvider.ts\";\nexport * from \"./providers/MemoryFileSystemProvider.ts\";\nexport * from \"./providers/MemoryShellProvider.ts\";\nexport * from \"./providers/ShellProvider.ts\";\n\nexport const AlephaSystem = $module({\n  name: \"alepha.system\",\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.browser.js","names":["nodeJoin"],"sources":["../../src/system/providers/FileSystemProvider.ts","../../src/system/providers/MemoryFileSystemProvider.ts","../../src/system/providers/MemoryShellProvider.ts","../../src/system/providers/ShellProvider.ts","../../src/system/services/FileDetector.ts","../../src/system/errors/FileError.ts","../../src/system/index.browser.ts"],"sourcesContent":["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","// ---------------------------------------------------------------------------------------------------------------------\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 { 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","export class FileError extends Error {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"FileError\";\n    this.cause = cause;\n  }\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 { ShellProvider } from \"./providers/ShellProvider.ts\";\nimport { FileDetector } from \"./services/FileDetector.ts\";\n\nexport * from \"./errors/FileError.ts\";\nexport * from \"./providers/FileSystemProvider.ts\";\nexport * from \"./providers/MemoryFileSystemProvider.ts\";\nexport * from \"./providers/MemoryShellProvider.ts\";\nexport * from \"./providers/ShellProvider.ts\";\nexport * from \"./services/FileDetector.ts\";\n\nexport const AlephaSystem = $module({\n  name: \"alepha.system\",\n  services: [\n    FileDetector,\n    FileSystemProvider,\n    MemoryFileSystemProvider,\n    ShellProvider,\n    MemoryShellProvider,\n  ],\n  register: (alepha) =>\n    alepha\n      .with({\n        optional: true,\n        provide: FileSystemProvider,\n        use: MemoryFileSystemProvider,\n      })\n      .with({\n        optional: true,\n        provide: ShellProvider,\n        use: MemoryShellProvider,\n      }),\n});\n"],"mappings":"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"}

package/dist/system/index.d.ts

@@ -186,8 +186,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/system/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/system/errors/FileError.ts","../../src/system/providers/FileSystemProvider.ts","../../src/system/providers/MemoryFileSystemProvider.ts","../../src/system/providers/ShellProvider.ts","../../src/system/providers/MemoryShellProvider.ts","../../src/system/services/FileDetector.ts","../../src/system/providers/NodeFileSystemProvider.ts","../../src/system/providers/NodeShellProvider.ts","../../src/system/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/system/errors/FileError.ts","../../src/system/providers/FileSystemProvider.ts","../../src/system/providers/MemoryFileSystemProvider.ts","../../src/system/providers/ShellProvider.ts","../../src/system/providers/MemoryShellProvider.ts","../../src/system/services/FileDetector.ts","../../src/system/providers/NodeFileSystemProvider.ts","../../src/system/providers/NodeShellProvider.ts","../../src/system/index.ts"],"mappings":"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"}

package/dist/system/index.js

@@ -1365,8 +1365,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.