All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Updated
express
dependency - Updated
swagger-ui-express
dependency - Updated
ramda
dependency
- Removed official support for Node 12 & 14
- 💥 Important: Version
3.0.0
is not to be used as this patch introduces more breaking changes. It is the "true" version 3, as both breaking changes should have been released simultaneously. - 🔥 Removed default
DEFAULT_API_KEY_HEADER
, this will be provided by the package user. - 💥 Removed
authOptions
and changedauth
inISwaggerOptions
to be more flexible. Allows multiplesecurityDefinitions
and a custom root-levelsecurity
. - ✨ Allows passing
security
at the operation/route level to specify the authentication to use with individual routes.
- Replaced
shouldOmitPrefix
withprefixToOmit
. Now an optional string is provided instead of a boolean. - This string will be replaced from the start of generated URL path for the given route.
- Fixed issue where routes and generating swagger would use different swagger definitions
- Fixed issue where responses were duplicated in multiple paths in OpenAPI
- Added tests for swagger generation
- Added an option to provide initial swagger definition
- Added response status codes 402, 403, and 500 to OpenAPI
- Filtered out responses without a schema
- Added support for
externalDocs
in OpenAPI
- Added support for requiring headers and query parameters in OpenAPI
- Added support for validating headers
- Added
apiKey
as an auth option - Added
authOptions
to config to set the header name for the API key
- Added
schemes
option to config to set the schemes in the docs
- Added
shouldOmitPrefixInDocs
option to config to omit the path prefix in the docs
- Dropped support for Node 10!
- Updated devDependencies to latest versions