VaporOpenAPI

This fixes things for Vapor version 4.86.0 but since these are breaking changes it also requires at least Vapor 4.86.0 now.

What's Changed

• Add support for marking routes as deprecated by @TimAEllis in https://github.com/mattpolzin/VaporOpenAPI/pull/18

Thanks to @TimAEllis for adding support for two more OpenAPI properties of query parameters: required and deprecated.

This PR removes the need for always creating or specifying a JSON encoder by instead supporting a default based on Vapor's default.

Thanks to @tetraoxygen for this improvement!

Thanks to @tetraoxygen for adding support for async/await and for adding a lot of code documentation!

Thanks for @JaapWijnen for a fix that applies to the OpenAPI documentation generation for any status code that might have an empty response body associated with it.

Responses with the status code 204 (No Content) were not being turned into OpenAPI responses properly.

This is not really worth of a new release; it does force the VaporTypedResponse update from 0.7.0 to 0.7.1 which is where the new encodeEmptyResponse() method comes from.

Note that OpenAPIKit v2 introduces some breaking changes.

⚠️ Breaking Changes ⚠️
OpenAPIKit v1.0 comes with some breaking changes, although now OpenAPIKit will be stable for the duration of the v1 major version.

report an unspecified description as nil instead of an empty string.

• Add ability to specify the type of a path parameter.
• Remove need to use a new RoutesBuilder replacement, which means you just use app.get/post/etc. to add routes to your app. This should also work with route groups.

⚠️ Breaking Changes ⚠️
Application.openAPI has been removed -- it was a RoutesBuilder replacement that is no longer needed. Anywhere you would have written app.openAPI.get(...) you can now write app.get(...).

This feature comes with the addition of a new type of routes builder. If you want to add descriptions to path parameters, the route must be built with app.openAPI.get/post/etc. instead of app.get/post/etc. or app.routes.get/post/etc..

⚠️ Breaking Change ⚠️
New version of VaporTypedRoutes adds a new requirement to RouteContext (although it is perfectly acceptable to just set the new static property to nil).

Fixes a small breaking change made in Vapor 4.5.0

⚠️ Breaking Changes ⚠️
OpenAPIKit has breaking changes across this version bump.