Add ComponentFrameworkEndpointMetadata and ConfigureFrameworkEndpoints to identify and configure Blazor infrastructure endpoints

src/Components/Endpoints/src/Builder/ComponentFrameworkEndpointMetadata.cs

@@ -0,0 +1,13 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Microsoft.AspNetCore.Components.Endpoints;
+
+/// <summary>
+/// Metadata that identifies infrastructure endpoints for Blazor framework functionality.
+/// This marker is used to distinguish framework endpoints (like opaque redirection, 
+/// disconnect, and JavaScript initializers) from regular component endpoints.
+/// </summary>
+public sealed class ComponentFrameworkEndpointMetadata
+{
+}

src/Components/Endpoints/src/Builder/OpaqueRedirection.cs

@@ -59,6 +59,7 @@ public static EndpointBuilder GetBlazorOpaqueRedirectionEndpoint()
         };
 
         routeEndpointBuidler.Metadata.Add(new HttpMethodMetadata([HttpMethods.Get]));
+        routeEndpointBuidler.Metadata.Add(new ComponentFrameworkEndpointMetadata());
 
         return routeEndpointBuidler;
     }

src/Components/Endpoints/src/PublicAPI.Unshipped.txt

@@ -1,4 +1,6 @@
 #nullable enable
+Microsoft.AspNetCore.Components.Endpoints.ComponentFrameworkEndpointMetadata
+Microsoft.AspNetCore.Components.Endpoints.ComponentFrameworkEndpointMetadata.ComponentFrameworkEndpointMetadata() -> void
 Microsoft.AspNetCore.Components.ResourcePreloader
 Microsoft.AspNetCore.Components.ResourcePreloader.ResourcePreloader() -> void
 Microsoft.Extensions.DependencyInjection.RazorComponentsRazorComponentBuilderExtensions

src/Components/Endpoints/test/Builder/ComponentFrameworkEndpointMetadataTest.cs

@@ -0,0 +1,41 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Microsoft.AspNetCore.Components.Endpoints;
+using Xunit;
+
+namespace Microsoft.AspNetCore.Components.Tests.Builder;
+
+public class ComponentFrameworkEndpointMetadataTest
+{
+    [Fact]
+    public void ComponentFrameworkEndpointMetadata_CanBeCreated()
+    {
+        // Arrange & Act
+        var metadata = new ComponentFrameworkEndpointMetadata();
+
+        // Assert
+        Assert.NotNull(metadata);
+    }
+
+    [Fact]
+    public void ComponentFrameworkEndpointMetadata_IsSealed()
+    {
+        // Arrange & Act
+        var type = typeof(ComponentFrameworkEndpointMetadata);
+
+        // Assert
+        Assert.True(type.IsSealed);
+    }
+
+    [Fact]
+    public void ComponentFrameworkEndpointMetadata_HasNoPublicProperties()
+    {
+        // Arrange & Act
+        var type = typeof(ComponentFrameworkEndpointMetadata);
+        var properties = type.GetProperties();
+
+        // Assert
+        Assert.Empty(properties);
+    }
+}

src/Components/Endpoints/test/Builder/OpaqueRedirectionTest.cs

@@ -0,0 +1,48 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Microsoft.AspNetCore.Components.Endpoints;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Routing;
+using Xunit;
+
+namespace Microsoft.AspNetCore.Components.Tests.Builder;
+
+public class OpaqueRedirectionTest
+{
+    [Fact]  
+    public void GetBlazorOpaqueRedirectionEndpoint_ContainsComponentFrameworkEndpointMetadata()
+    {
+        // Arrange & Act
+        var endpointBuilder = OpaqueRedirection.GetBlazorOpaqueRedirectionEndpoint();
+        var endpoint = endpointBuilder.Build();
+
+        // Assert
+        var metadata = endpoint.Metadata.GetMetadata<ComponentFrameworkEndpointMetadata>();
+        Assert.NotNull(metadata);
+    }
+
+    [Fact]
+    public void GetBlazorOpaqueRedirectionEndpoint_HasCorrectDisplayName()
+    {
+        // Arrange & Act
+        var endpointBuilder = OpaqueRedirection.GetBlazorOpaqueRedirectionEndpoint();
+        var endpoint = endpointBuilder.Build();
+
+        // Assert
+        Assert.Equal("Blazor Opaque Redirection", endpoint.DisplayName);
+    }
+
+    [Fact]
+    public void GetBlazorOpaqueRedirectionEndpoint_HasHttpGetMethod()
+    {
+        // Arrange & Act
+        var endpointBuilder = OpaqueRedirection.GetBlazorOpaqueRedirectionEndpoint();
+        var endpoint = endpointBuilder.Build();
+
+        // Assert
+        var httpMethodMetadata = endpoint.Metadata.GetMetadata<HttpMethodMetadata>();
+        Assert.NotNull(httpMethodMetadata);
+        Assert.Contains(HttpMethods.Get, httpMethodMetadata.HttpMethods);
+    }
+}

src/Components/Server/src/Builder/ComponentEndpointRouteBuilderExtensions.cs

@@ -1,6 +1,7 @@
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
+using Microsoft.AspNetCore.Components.Endpoints;
 using Microsoft.AspNetCore.Components.Server;
 using Microsoft.AspNetCore.Http.Connections;
 using Microsoft.AspNetCore.Routing;
@@ -78,12 +79,14 @@ public static ComponentEndpointConventionBuilder MapBlazorHub(
         var disconnectEndpoint = endpoints.Map(
             (path.EndsWith('/') ? path : path + "/") + "disconnect/",
             endpoints.CreateApplicationBuilder().UseMiddleware<CircuitDisconnectMiddleware>().Build())
-            .WithDisplayName("Blazor disconnect");
+            .WithDisplayName("Blazor disconnect")
+            .WithMetadata(new ComponentFrameworkEndpointMetadata());
 
         var jsInitializersEndpoint = endpoints.Map(
             (path.EndsWith('/') ? path : path + "/") + "initializers/",
             endpoints.CreateApplicationBuilder().UseMiddleware<CircuitJavaScriptInitializationMiddleware>().Build())
-            .WithDisplayName("Blazor initializers");
+            .WithDisplayName("Blazor initializers")
+            .WithMetadata(new ComponentFrameworkEndpointMetadata());
 
         return new ComponentEndpointConventionBuilder(hubEndpoint, disconnectEndpoint, jsInitializersEndpoint);
     }

src/Components/Server/test/ComponentEndpointRouteBuilderExtensionsTest.cs

@@ -3,6 +3,7 @@
 
 using System.Diagnostics;
 using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Components.Endpoints;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore.Http;
 using Microsoft.Extensions.Configuration;
@@ -122,6 +123,37 @@
         Assert.Equal(new[] { "first-in", "last-in" }, populatedMetadata);
     }
 
+    [Fact]
+    public void MapBlazorHub_AddsComponentFrameworkEndpointMetadata()
+    {
+        // Arrange
+        var applicationBuilder = CreateAppBuilder();
+        var frameworkEndpoints = new List<string>();
+
+        // Act
+        var app = applicationBuilder
+            .UseRouting()
+            .UseEndpoints(endpoints =>
+            {
+                endpoints
+                    .MapBlazorHub()
+                    .Finally(builder =>
+                    {
+                        if (builder.Metadata.GetMetadata<ComponentFrameworkEndpointMetadata>() is not null)
+                        {
+                            frameworkEndpoints.Add(builder.DisplayName);
+                        }
+                    });
+            }).Build();
+
+        // Trigger endpoint construction
+        app.Invoke(new DefaultHttpContext());
+
+        // Assert
+        Assert.Contains("Blazor disconnect", frameworkEndpoints);
+        Assert.Contains("Blazor initializers", frameworkEndpoints);
+    }
+
     private IApplicationBuilder CreateAppBuilder()
     {
         var environment = new Mock<IWebHostEnvironment>();

src/Components/WebAssembly/Server/src/WebAssemblyEndpointProvider.cs

@@ -3,6 +3,7 @@
 
 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Components;
+using Microsoft.AspNetCore.Components.Endpoints;
 using Microsoft.AspNetCore.Components.Endpoints.Infrastructure;
 using Microsoft.AspNetCore.Components.Web;
 using Microsoft.AspNetCore.Http;
@@ -41,7 +42,8 @@ public override IEnumerable<RouteEndpointBuilder> GetEndpointBuilders(IComponent
                 context.SetEndpoint(null);
 
                 return app(context);
-            });
+            })
+            .WithMetadata(new ComponentFrameworkEndpointMetadata());
 
             return endpointRouteBuilder.GetEndpoints();
         }
@@ -75,6 +77,22 @@ internal IEnumerable<RouteEndpointBuilder> GetEndpoints()
                         builder.Metadata.Add(metadata);
                     }
 
+                    // Add framework endpoint metadata if not already present
+                    var hasFrameworkMetadata = false;
+                    for (var i = 0; i < builder.Metadata.Count; i++)
+                    {
+                        if (builder.Metadata[i] is ComponentFrameworkEndpointMetadata)
+                        {
+                            hasFrameworkMetadata = true;
+                            break;
+                        }
+                    }
+
+                    if (!hasFrameworkMetadata)
+                    {
+                        builder.Metadata.Add(new ComponentFrameworkEndpointMetadata());
+                    }
+
                     yield return builder;
                 }
             }