Method scan

src/core/SpecScanner.ts:40–73

* 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

(
    folderPath: string
  )

   * @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