GeneratedEndpoints 10.0.2

GeneratedEndpoints - Attribute-driven, source-generated Minimal API endpoints for feature-based development

GeneratedEndpoints is a .NET source generator that automatically wires up Minimal API endpoints from attribute-annotated methods. This simplifies integration of HTTP handlers within Clean Architecture (CA) or Vertical Slice Architecture (VSA) by keeping endpoint definitions inside their features while generating the boilerplate mapping code.

Setup

Add the package to any ASP.NET Core project that hosts Minimal APIs:

dotnet add package GeneratedEndpoints

The source generator emits two extension methods:

using Microsoft.AspNetCore.Generated.Routing;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddEndpointHandlers();

var app = builder.Build();

app.MapEndpointHandlers();

app.Run();

• The AddEndpointHandlers method registers each endpoint class with injected services as a Scoped service.
• The MapEndpointHandlers method calls the generated Map method for each endpoint.

A simple endpoint

An endpoint is wired using a class with a method marked by one of the [Map*] attributes. The source generator produces the handler delegate and automatically calls the appropriate map method on the route builder.

using Microsoft.AspNetCore.Generated.Attributes;
using Microsoft.AspNetCore.Http.HttpResults;

namespace Contoso.Example.Endpoints;

internal static class TimeEndpoints
{
    [MapGet("/time")]
    public static Ok<string> GetCurrentTime() => TypedResults.Ok(DateTimeOffset.UtcNow.ToString("O"));
}

Expanding the endpoint

You can add additional metadata to endpoints using attributes.

using Microsoft.AspNetCore.Generated.Attributes;
using Microsoft.AspNetCore.Http.HttpResults;

namespace Contoso.Example.Endpoints;

[Tags("Users", "Lookup")]
internal static class UserEndpoints
{
    [Summary("Gets a user by ID.")]
    [RequireAuthorization("Users.Read")]
    [MapGet("/users/{id:int}")]
    public static Results<Ok<UserDto>, NotFound> GetUser(int id)
    {
        if (id <= 0)
            return TypedResults.NotFound();

        return TypedResults.Ok(new UserDto(id, $"User {id}"));
    }
}

internal sealed record UserDto(int Id, string DisplayName);

• [Tags] on the class assigns OpenAPI tags to every endpoint inside the type.
• [Summary] annotates the endpoint with OpenAI summary metadata.
• [RequireAuthorization] enforces authorization policies on the endpoint.

Static vs instantiable classes

To avoid clutering your endpoint method with service dependencies, you can specify them using a class constructor. This also allows you to reuse the same service declaration across multiple endpoints. The source generator will generate the appropriate service injection code for each endpoint method.

using Microsoft.AspNetCore.Generated.Attributes;
using Microsoft.AspNetCore.Http.HttpResults;

namespace Contoso.Example.Endpoints;

internal static class HealthEndpoints
{
    [MapGet("/health")]
    public static Ok<string> Check(IHostEnvironment env) => TypedResults.Ok("Healthy, {env.EnvironmentName}");
}

internal sealed class EnvironmentEndpoints(IHostEnvironment env)
{
    [MapGet("/env")]
    public Ok<string> GetEnvironmentName() => TypedResults.Ok(env.EnvironmentName);
}

Advanced configuration

Endpoint classes may include an optional Configure method to apply conventions after the handler is mapped. The source generator will look for the following signature:

using Microsoft.AspNetCore.Generated.Attributes;
using Microsoft.AspNetCore.Http.HttpResults;

namespace Contoso.Example.Endpoints;

internal static class HealthEndpoints
{
    [MapGet("/health")]
    public static Ok<string> Check() => TypedResults.Ok("Healthy");

    public static void Configure<TBuilder>(TBuilder builder)
        where TBuilder : IEndpointConventionBuilder
    {
        builder.WithRequestTimeout(TimeSpan.FromSeconds(5));
    }
}

Inside Configure you can continue to chain configurations that are not already exposed as attributes by the source generator. The Configure method is applied to all endpoints within the class.

Attribute Reference