Function patchOpenApiSpec

packages/shared/src/openApi/shared/utils/patch.ts:4–200

({
  patchOptions,
  spec: _spec,
}: {
  patchOptions: Patch | undefined;
  spec: unknown;
})

import type { OpenApi } from '../../../openApi/types';

export async function patchOpenApiSpec({
  patchOptions,
  spec: _spec,
}: {
  patchOptions: Patch | undefined;
  spec: unknown;
}) {
  if (!patchOptions) {
    return;
  }

  const spec = _spec as OpenApi.V2_0_X | OpenApi.V3_0_X | OpenApi.V3_1_X;

  if (typeof patchOptions === 'function') {
    await patchOptions(spec);
    return;
  }

  if (patchOptions.input) {
    await patchOptions.input(spec);
  }

  if ('swagger' in spec) {
    if (patchOptions.version && spec.swagger) {
      spec.swagger = (
        typeof patchOptions.version === 'string'
          ? patchOptions.version
          : patchOptions.version(spec.swagger)
      ) as typeof spec.swagger;
    }

    if (patchOptions.meta && spec.info) {
      patchOptions.meta(spec.info);
    }

    if (patchOptions.schemas && spec.definitions) {
      if (typeof patchOptions.schemas === 'function') {
        for (const [key, schema] of Object.entries(spec.definitions)) {
          if (schema && typeof schema === 'object') {
            await patchOptions.schemas(key, schema);
          }
        }
      } else {
        for (const key in patchOptions.schemas) {
          const schema = spec.definitions[key];
          if (!schema || typeof schema !== 'object') continue;

          const patchFn = patchOptions.schemas[key]!;
          await patchFn(schema);
        }
      }
    }

    if (patchOptions.operations && spec.paths) {
      if (typeof patchOptions.operations === 'function') {
        // Bulk callback: iterate all operations
        for (const [path, pathItem] of Object.entries(spec.paths)) {
          if (!pathItem || typeof pathItem !== 'object') continue;