Skip to content

[codex] Add OpenAPI 3.2 support#286

Open
closedLoop wants to merge 1 commit intoAPIDevTools:mainfrom
closedLoop:codex/openapi-3-2-support
Open

[codex] Add OpenAPI 3.2 support#286
closedLoop wants to merge 1 commit intoAPIDevTools:mainfrom
closedLoop:codex/openapi-3-2-support

Conversation

@closedLoop
Copy link
Copy Markdown

Summary

  • accept openapi: 3.2.0 in the parser version gate
  • extend the bundled OpenAPI 3.1 schema at runtime with a targeted 3.2 compatibility layer for key additions such as query, additionalOperations, itemSchema, mediaTypes, response summary, richer tag metadata, querystring parameters, and OAuth 2.0 metadata/device authorization fields
  • add parse and schema-validation coverage for OpenAPI 3.2 documents

Why

swagger-parser currently rejects OpenAPI 3.2.0 before validation even starts. In addition, @apidevtools/openapi-schemas has not yet published a native v3.2 schema, so this change layers the main 3.2 additions onto the existing 3.1 schema in-process so consumers can start validating representative 3.2 documents now.

Validation

  • npx mocha test/specs/invalid/invalid.spec.js test/specs/validate-schema/validate-schema.spec.js
  • npx eslint lib test
  • npm test

@closedLoop closedLoop marked this pull request as ready for review April 22, 2026 00:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant