Init

Prefab/Endpoints/Extensions.cs

@@ -0,0 +1,29 @@
+using Microsoft.AspNetCore.Builder;
+
+namespace Prefab.Endpoints;
+
+/// <summary>
+/// Provides extension methods for configuring endpoint names with module-based naming conventions in ASP.NET Core
+/// routing.
+/// </summary>
+/// <remarks>These methods help standardize endpoint naming by prefixing endpoint names with a module name
+/// inferred from a specified type. This can improve discoverability and organization of endpoints, especially in
+/// modular applications. The extensions are intended for use with ASP.NET Core's routing infrastructure and are
+/// typically called when configuring endpoints in minimal APIs or similar scenarios.</remarks>
+public static class Extensions
+{
+    /// <summary>
+    /// Applies an endpoint name that combines the module name inferred from <typeparamref name="T"/> with the type name.
+    /// </summary>
+    /// <typeparam name="T">A type that belongs to the module the endpoint lives in, typically the endpoint class itself.</typeparam>
+    public static RouteHandlerBuilder WithModuleName<T>(this RouteHandlerBuilder builder)
+        => builder.WithModuleName<T>(typeof(T).Name);
+
+    /// <summary>
+    /// Applies an endpoint name that combines the module name inferred from <typeparamref name="T"/> with the provided endpoint name.
+    /// </summary>
+    /// <typeparam name="T">A type that belongs to the module the endpoint lives in, typically the endpoint class itself.</typeparam>
+    /// <param name="endpointName">The base endpoint name that will be prefixed with the module name.</param>
+    public static RouteHandlerBuilder WithModuleName<T>(this RouteHandlerBuilder builder, string endpointName)
+        => builder.WithName(EndpointName.For<T>(endpointName));
+}