Groups and conventions

Create groups

Every endpoint group implements CreateGroup and explicitly chooses its route and group-level metadata:

[ValiantEndpointGroup(Order = 10)]
internal sealed class OrdersEndpointGroup : IEndpointGroup
{
    public static RouteGroupBuilder CreateGroup(IEndpointRouteBuilder builder) =>
        builder
            .MapGroup("/api/orders")
            .WithTags("Orders")
            .RequireAuthorization();
}

Global conventions

builder.Services.AddValiantEndpoints(options =>
{
    options.ConfigureEndpointGroup = (group, registration) =>
    {
        group.AddEndpointFilter<ExceptionHandlingFilter>();
        group.WithOpenApi();
    };

    options.ConfigureEndpoint = (endpoint, registration) =>
        endpoint.WithName(registration.EndpointType.Name);
});

The generated sequence is:

1. Create the group through its required CreateGroup implementation.
2. Associate its EndpointGroupRegistration.
3. Run ConfigureEndpointGroup.
4. Map each included endpoint and apply Valiant binding and parsing conventions.
5. Run ConfigureEndpoint with that endpoint's EndpointRegistration.

Both hooks are actions over the builders returned by IEndpointGroup.CreateGroup(...) and IEndpoint.Map(...). The group hook cannot replace the returned builder. Put route prefixes and nested MapGroup(...) calls in the group's CreateGroup implementation.

EndpointGroupRegistration exposes the group type and generated order. EndpointRegistration exposes the endpoint type, containing group, generated order, and query-binding snapshot, so global conventions can branch without repeating reflection-based discovery.

See the runnable configuration sample for two grouped routes where a group hook adds a shared response header and an endpoint hook adds a second header only to the selected endpoint.

Migrating the earlier preview hooks

The earlier preview exposed three callbacks. Consolidate them as follows:

• Move both ConfigureAllEndpointGroupsBeforeMapping and ConfigureAllEndpointGroupsAfterMapping conventions into ConfigureEndpointGroup.
• Replace ConfigureAllEndpointsAfterMapping with ConfigureEndpoint.
• Replace callback Type parameters with registration.GroupType or registration.EndpointType.
• Move any callback that returned group.MapGroup(...) into IEndpointGroup.CreateGroup(...).

Ordering

Set Order on endpoint and group marker attributes when one generated mapping must precede another:

[ValiantEndpoint<OrdersEndpointGroup>(Order = -100)]
internal sealed class SearchOrdersEndpoint : IEndpoint { /* ... */ }

Types with the same order are sorted by type name, keeping generated output deterministic.

Standalone endpoints

[ValiantEndpoint] without a group maps directly on the supplied root route builder. The same ConfigureEndpoint hook and MapEndpointWhen registration policy apply; its registration has Group == null.