v9.0.0
What's Changed - Added support for OpenAPI 3.2 (#385)
- feat: add
OpenApiGeneratorV32for OpenAPI 3.2.0 documents - feat: support 3.2 media-type fields —
itemSchema,itemEncoding, andprefixEncoding(for streams liketext/event-stream,application/jsonl,application/json-seq) - feat: support the
queryHTTP method on routes - feat: support optional
summaryon responses - feat: support
mediaTypesas a reusable component type viaregisterComponent - feat: allow
$refentries directly inZodContentObject - chore: bump
openapi3-tsto^4.6.0
OpenApiGeneratorV32 reuses the same JSON Schema dialect as 3.1 (2020-12), so schema output is unchanged from OpenApiGeneratorV31. Use it when you need 3.2 document-structure fields.
Breaking changes (TypeScript only)
These are interface-only changes; runtime behavior for existing OpenApiGeneratorV3 / OpenApiGeneratorV31 usage is unchanged.
ResponseConfig.descriptionis now optional (required by OpenAPI 3.0/3.1, optional in 3.2). Code that assumesdescriptionis always present may need a guard or non-null assertion.ZodMediaTypeObject.schemais now optional, to supportitemSchema-only media types.
No other exported API removals or signature changes.
New Contributors
- @bookernath made their first contribution in #388
Full Changelog: v8.5.0...v9.0.0