refactor: antifactory types internal with public extension for regist…

…ration

samples/HtmxBlazorSSR/Program.cs

@@ -32,7 +32,7 @@
 
 app.UseStaticFiles();
 app.UseAntiforgery();
-app.UseMiddleware<HtmxAntiforgeryMiddleware>();
+app.UseHtmxorAntiforgery();
 
 app.MapGet("/contacts/count", async (ContactsRepository repo) =>
 {

src/Htmxor/Antiforgery/HtmxAntiforgeryMiddleware.cs

@@ -7,7 +7,7 @@ namespace Htmxor.Antiforgery;
 /// <summary>
 /// This will add a HX-XSRF-TOKEN to each response, no matter if it was initiated by HTMX or not.
 /// </summary>
-public sealed class HtmxAntiforgeryMiddleware(IAntiforgery antiforgery, HtmxConfig htmxConfig, RequestDelegate next)
+internal sealed class HtmxAntiforgeryMiddleware(IAntiforgery antiforgery, HtmxConfig htmxConfig, RequestDelegate next)
 {
     private static readonly CookieOptions cookieOptions = new CookieOptions
     {

src/Htmxor/Antiforgery/HtmxAntiforgeryOptions.cs

@@ -3,11 +3,23 @@
 
 namespace Htmxor.Antiforgery;
 
-public class HtmxAntiforgeryOptions(IOptions<AntiforgeryOptions> antiforgeryOptions)
+/// <summary>
+/// Represents the options for Htmxor's antiforgery support.
+/// </summary>
+internal class HtmxAntiforgeryOptions(IOptions<AntiforgeryOptions> antiforgeryOptions)
 {
+    /// <summary>
+    /// Gets the name of the form field used for antiforgery token.
+    /// </summary>
     public string FormFieldName { get; } = antiforgeryOptions.Value.FormFieldName;
 
+    /// <summary>
+    /// Gets the name of the header used for antiforgery token.
+    /// </summary>
     public string? HeaderName { get; } = antiforgeryOptions.Value.HeaderName;
 
+    /// <summary>
+    /// Gets the name of the cookie used for antiforgery token.
+    /// </summary>
     public string CookieName { get; } = "HX-XSRF-TOKEN";
-}
+}

src/Htmxor/WebApplicationBuilderExtensions.cs

@@ -2,6 +2,7 @@
 using Htmxor.Configuration;
 using Htmxor.Http;
 using Microsoft.AspNetCore.Antiforgery;
+using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Http;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
@@ -10,16 +11,17 @@
 namespace Htmxor;
 
 /// <summary>
-/// This class has extension methods for <see cref="IHostApplicationBuilder"/> that enable configuration of Htmx in the application.
+/// This class has extension methods for <see cref="IHostApplicationBuilder"/> and <see cref="IApplicationBuilder"/> 
+/// that enable configuration of Htmx in the application.
 /// </summary>
-public static class WebApplicationBuilderExtensions
+public static class HtmxorApplicationBuilderExtensions
 {
     /// <summary>
     /// Add and configure Htmx.
     /// </summary>
     /// <param name="builder"></param>
     /// <param name="configBuilder"></param>
-    public static void AddHtmx(this IHostApplicationBuilder builder, Action<HtmxConfig>? configBuilder = null)
+    public static IHostApplicationBuilder AddHtmx(this IHostApplicationBuilder builder, Action<HtmxConfig>? configBuilder = null)
     {
         builder.Services.AddSingleton<HtmxConfig>(x =>
         {
@@ -32,5 +34,18 @@ public static void AddHtmx(this IHostApplicationBuilder builder, Action<HtmxConf
         });
 
         builder.Services.AddScoped(srv => srv.GetRequiredService<IHttpContextAccessor>().HttpContext!.GetHtmxContext());
+
+        return builder;
+    }
+
+    /// <summary>
+    /// Enable Htmx to use antiforgery tokens to secure requests.
+    /// </summary>
+    /// <param name="builder"></param>
+    /// <returns></returns>
+    public static IApplicationBuilder UseHtmxorAntiforgery(this IApplicationBuilder builder)
+    {
+        builder.UseMiddleware<HtmxAntiforgeryMiddleware>();
+        return builder;
     }
 }