Method processFile

src/core/SpecScanner.ts:82–120

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

(
    folderPath: string,
    filename: string
  )

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

    const filePath = path.join(folderPath, filename);

    try {
      const content = await fs.readFile(filePath, "utf-8");
      const specObject = await this.parseSpec(content, fileType);

      // Validate basic spec structure
      if (!this.isValidSpecObject(specObject)) {
        throw new SpecScanError(
          "Invalid OpenAPI specification format",
          filename
        );
      }

      const specId = this.extractSpecId(specObject, filename);
      const processedSpec = await this.specProcessor.process(specObject);

      return {
        filename,
        spec: processedSpec,
        specId,
      };
    } catch (error) {
      throw new SpecScanError(
        `Failed to process spec file: ${filename}`,
        filename,
        error instanceof Error ? error : new Error(String(error))
      );
    }
  }

  /**
   * Determines the file type based on the file extension