Skip to content

Releases

1.0.0

Choose a tag to compare

@hlib-zinchenko hlib-zinchenko released this 18 Nov 07:50

First stable release of Hlibz.MinimalApi.Endpoints: one class per minimal API endpoint, listed at compile time by a source generator and mapped into its group with its documented success and error responses. Targets .NET 10 and 11.

Same code as 1.0.0-preview.7. No changes since that preview. The preview releases describe how the API got here.

Packages

Full changelog: v1.0.0-preview.7...v1.0.0

1.0.0-preview.7

1.0.0-preview.7 Pre-release
Pre-release

Choose a tag to compare

@hlib-zinchenko hlib-zinchenko released this 14 Nov 16:27

Seventh preview: built with runtime async on .NET 11.

Changes

  • Runtime async on .NET 11. The net11.0 build compiles its async methods with runtime async (runtime-async=on), the way the .NET 11 libraries themselves are compiled: no compiler state machine, cheaper suspension inside ASP.NET Core's own async chains, and clearer async stack traces. The net10.0 build is unchanged. It covers the FluentValidation endpoint filter, which runs on every validated request.

No API changes.

Packages

Full changelog: v1.0.0-preview.6...v1.0.0-preview.7

1.0.0-preview.6

1.0.0-preview.6 Pre-release
Pre-release

Choose a tag to compare

@hlib-zinchenko hlib-zinchenko released this 13 Nov 19:46

Sixth preview: the app-wide gates are documented too.

Fixes

  • 401/403 under a fallback policy. The documented 401 and 403 responses came only from an endpoint's own authorization metadata. An app whose AuthorizationOptions.FallbackPolicy requires a signed-in user documented neither, although its endpoints answer with them (and Hlibz.OpenApi.AspNetCore marks them as secured). They are now documented on every endpoint the fallback policy covers.
  • 429 under a global limiter. Likewise, a RateLimiterOptions.GlobalLimiter now documents a 429 on every endpoint.

AllowAnonymous() and DisableRateLimiting() still remove them.

No API changes.

Packages

Full changelog: v1.0.0-preview.5...v1.0.0-preview.6

1.0.0-preview.5

1.0.0-preview.5 Pre-release
Pre-release

Choose a tag to compare

@hlib-zinchenko hlib-zinchenko released this 13 Nov 17:15

Fifth preview, with a fix from adopting 1.0.0-preview.4 in a real API.

Changes

  • Map may call an existing one-route extension. HMAE007 now accepts one call on the group parameter (the group as its first argument) that returns a RouteHandlerBuilder, not only MapGet, MapPost and the like. An endpoint class can wrap an extension such as Hlibz.Results.AspNetCore's MapErrorCodes(), so its route stays in the group and its OpenAPI document:

    internal sealed class GetErrorCodesEndpoint : IEndpoint<ErrorCodesEndpointGroup>
    {
        public RouteHandlerBuilder Map(IEndpointRouteBuilder group) => group.MapErrorCodes(string.Empty);
    }

    The analyzer trusts such a helper to map one route; one that maps several and returns the last one's builder isn't caught. MapGroup, a void helper, or the group passed in another position still fail the build.

Packages

Full changelog: v1.0.0-preview.4...v1.0.0-preview.5

1.0.0-preview.4

1.0.0-preview.4 Pre-release
Pre-release

Choose a tag to compare

@hlib-zinchenko hlib-zinchenko released this 13 Nov 13:41
d531b3f

Breaking changes

  • .NET 10 and 11 only. net8.0 is dropped (.NET 8 reached end of support on 10 Nov 2026). Both packages now ship net10.0 and net11.0 builds.

Changes

  • The release workflow builds once at the tag's version and packs those binaries, so the published packages are the ones the tests ran on.
  • CI now builds and runs an app that gets the packages only indirectly (a library referencing only Hlibz.MinimalApi.Endpoints.FluentValidation, and a web app referencing that library), proving the packed source generator reaches it. The buildTransitive target stays as a guard: the .NET 10 and 11 SDKs already hand the generator to indirect consumers.
  • READMEs: Related packages and Versioning sections.

No API changes since 1.0.0-preview.3.

Packages

Full changelog: v1.0.0-preview.3...v1.0.0-preview.4

1.0.0-preview.3

1.0.0-preview.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Nov 08:39

1.0.0-preview.2

1.0.0-preview.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 12 Nov 13:48

v1.0.0-preview.1

v1.0.0-preview.1 Pre-release
Pre-release

Choose a tag to compare

@hlib-zinchenko hlib-zinchenko released this 11 Nov 19:50

First preview of the Hlibz.MinimalApi.Endpoints packages.

Packages

Package
Hlibz.MinimalApi.Endpoints One class per minimal API endpoint, grouped by IEndpointGroup, mapped with MapEndpoints
Hlibz.MinimalApi.Endpoints.FluentValidation Validates each endpoint's request types with their registered FluentValidation validators
dotnet add package Hlibz.MinimalApi.Endpoints --prerelease

Highlights

  • Endpoints declare Method, Route and a Handler delegate. The group supplies the route prefix, tags and authorization, and IEndpoint<TGroup, TResponse> documents the success response.
  • A source generator included in the package lists every endpoint at compile time, so discovery uses no reflection and is safe under trimming and Native AOT.
  • An endpoint that can't be mapped fails the build with HMAE001–HMAE006 instead of failing at startup. See Build errors.
  • Targets .NET 8, 9, 10 and 11.

Limitations

Handlers are still bound through ASP.NET Core's RequestDelegateFactory, like a MapMethods call with a delegate, so MapEndpoints is marked RequiresUnreferencedCode/RequiresDynamicCode.