vitepress-openapi/src/lib/parser/generateMissingSummary.ts

Generate VitePress API Documentation from OpenAPI Specification.

import type { OpenAPIDocument, OperationObject } from '../../types'
import { httpVerbs } from '../../index'

export function generateMissingSummary(spec: OpenAPIDocument): OpenAPIDocument {
  spec.paths = spec.paths || {}

  for (const path of Object.keys(spec.paths)) {
    const pathValue = spec.paths[path] as Record<string, OperationObject>

    for (const verb of httpVerbs) {
      const operation = pathValue[verb] as OperationObject

      if (!operation) {
        continue
      }

      if (!operation.summary) {
        operation.summary = `${verb.toUpperCase()} ${path}`
      }
    }
  }

  return spec
}