using Microsoft.AspNetCore.Routing;

namespace Prefab.Endpoints;

/// <summary>
/// Defines a contract for registering application endpoints with an endpoint route builder.
/// </summary>
/// <remarks>Implement this interface to configure and map endpoints, such as HTTP routes, to the application's
/// routing system. This is typically used during application startup to organize endpoint registration logic.</remarks>
public interface IEndpointRegistrar
{
    /// <summary>
    /// Configures application endpoints using the specified endpoint route builder.
    /// </summary>
    /// <param name="endpoints">The endpoint route builder used to map routes for the application. Cannot be null.</param>
    void MapEndpoints(IEndpointRouteBuilder endpoints);
}