Class DefaultSpecScanner

src/core/SpecScanner.ts:32–231

 * and processes them using the provided SpecProcessor
 */
export class DefaultSpecScanner implements ISpecScanner {
  constructor(private readonly specProcessor: ISpecProcessor) {}

  /**
   * Scans a directory for OpenAPI specification files and yields processed results
   * @param folderPath - Path to the directory containing OpenAPI specs
   * @throws {SpecScanError} If the folder doesn't exist or isn't readable
   */
  async *scan(
    folderPath: string
  ): AsyncGenerator<SpecScanResult, void, unknown> {
    // Validate input
    if (!folderPath) {
      throw new Error("folderPath is required");
    }

    try {
      const files = await fs.readdir(folderPath);

      for (const file of files) {
        try {
          const result = await this.processFile(folderPath, file);
          if (result) {
            yield result;
          }
        } catch (error) {
          yield {
            filename: file,
            specId: file,
            spec: {} as OpenAPIV3.Document, // Empty spec for error cases
            error: error instanceof Error ? error : new Error(String(error)),
          };
        }
      }
    } catch (error) {
      throw new SpecScanError(
        `Failed to read directory: ${folderPath}`,
        folderPath,
        error instanceof Error ? error : new Error(String(error))
      );
    }
  }

  /**
   * Processes a single OpenAPI specification file
   * @param folderPath - Path to the directory containing the file
   * @param filename - Name of the file to process
   * @returns The processed spec result or null if the file type is invalid
   * @throws {SpecScanError} If there's an error processing the file
   */
  private async processFile(
    folderPath: string,
    filename: string
  ): Promise<SpecScanResult | null> {
    const fileType = this.getFileType(filename);
    if (fileType === "invalid") {
      return null;
    }