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

Generate VitePress API Documentation from OpenAPI Specification.

import type { OpenAPIV3 } from '@scalar/openapi-types'
import type { OpenAPIDocument } from '../../types'

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

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

    for (const verb of Object.keys(pathValue) as OpenAPIV3.HttpMethods[]) {
      const operation = pathValue[verb]

      if (!operation.operationId) {
        operation.operationId = `${verb}${path.replace(/\//g, '-')}`
      }
    }
  }

  return spec
}