v5.9.0

New features and enhancements

This release enables the use of derived relationships in query strings for all query string parameters; what used to work only for include, now also works for filter[], sort[], and page.

The sample for using obfuscated IDs has been updated to include atomic operations, and it uses the new [HideResourceIdTypeInOpenApi] to show IDs as string in OpenAPI.

The controller source generator has been updated to use the newer incremental API, improving IDE responsiveness in large solutions.

OpenAPI preview 5 includes the following fixes and enhancements:

• Custom action methods in JSON:API controllers now show up in OpenAPI.
• Fixed a crash that could occur with specific relationship naming patterns.
• An exception is thrown at startup if you forgot to update our OpenAPI NuGet package.

Breaking changes

• The new source generator requires a recent version of the .NET SDK to build your project.

Merged PRs

• Allow derived inclusion chains in filter/sort/page query strings by @bkoelman in #1756
• Improved ID obfuscation by @bkoelman in #1775
• Fixed crash where the OpenAPI atomic:operations discriminator key isn't unique per schema ID by @bkoelman in #1776
• Fixes and optimizations in ToString() calls by @bkoelman in #1780
• Add OpenAPI support for custom JSON:API action methods by @bkoelman in #1787
• Switch to incremental source generator API by @bkoelman in #1814
• Throw at startup when different OpenAPI version is loaded by @bkoelman in #1819

Full Changelog: v5.8.1...v5.9.0