Skip to main content

Function: mergeOpenApiSpecs()

mergeOpenApiSpecs(args): OpenApiSpec

Defined in: mergeOpenApiSpecs.ts:111

Merges every .yaml/.yml OpenAPI spec file in specsDir into a single OpenAPI document: paths are combined, components are combined (first-file-wins on name collisions), the first non-empty servers array found is kept, and cross-file $refs are rewritten to local refs.

Files are read in sorted filename order, so merge order — and therefore which file wins a naming collision — is deterministic.

Parameters

ParameterType
argsMergeOpenApiSpecsArgs

Returns

OpenApiSpec