fix: dotnet 10 openapi (#261)

Author: TuTiDore

Common/OpenAPI/OpenApiExtensions.cs

@@ -1,4 +1,5 @@
-using Microsoft.OpenApi;
+using Asp.Versioning.ApiExplorer;
+using Microsoft.OpenApi;
 
 namespace OpenShock.Common.OpenAPI;
 
@@ -16,16 +17,23 @@ public static IServiceCollection AddOpenApiExt<TProgram>(this WebApplicationBuil
         {
             options.AddPolicy("OpenAPI", policy => policy.Expire(TimeSpan.FromMinutes(10)));
         });
-        builder.Services.AddOpenApi(options =>
-        {
-            options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
-            options.AddDocumentTransformer(DocumentDefaults.GetDocumentTransformer(version: "1"));
-        });
-        builder.Services.AddOpenApi("v2", options =>
+
+        using (var tempProvider = builder.Services.BuildServiceProvider())
         {
-            options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
-            options.AddDocumentTransformer(DocumentDefaults.GetDocumentTransformer(version: "2"));
-        });
+            var apiVersionProvider = tempProvider.GetRequiredService<IApiVersionDescriptionProvider>();
+
+            // Configure OpenAPI for each API version
+            foreach (var description in apiVersionProvider.ApiVersionDescriptions)
+            {
+                builder.Services.AddOpenApi(description.GroupName, options =>
+                {
+                    options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
+                    options.AddDocumentTransformer(DocumentDefaults.GetDocumentTransformer(
+                        version: description.ApiVersion.ToString()));
+                });
+            }
+        }
+
         builder.Services.AddOpenApi("oauth", options =>
         {
             options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
@@ -38,7 +46,7 @@ public static IServiceCollection AddOpenApiExt<TProgram>(this WebApplicationBuil
             options.ShouldInclude = apiDescription => apiDescription.GroupName is "admin";
             options.AddDocumentTransformer(DocumentDefaults.GetDocumentTransformer(version: "1"));
         });
-        
+
         return builder.Services;
     }
 }

Common/OpenShockMiddlewareHelper.cs

@@ -84,9 +84,9 @@ public static async Task<IApplicationBuilder> UseCommonOpenShockMiddleware(this
 
         app.MapScalarApiReference("/scalar/viewer", options => 
                 options
-                    .WithOpenApiRoutePattern("/swagger/{documentName}/swagger.json")
-                    .AddDocument("1", "Version 1")
-                    .AddDocument("2", "Version 2")
+                    .WithOpenApiRoutePattern("/openapi/{documentName}.json")
+                    .AddDocument("v1", "Version 1")
+                    .AddDocument("v2", "Version 2")
                 );
 
         app.MapControllers();

Common/OpenShockServiceHelper.cs

@@ -143,11 +143,13 @@ public static IServiceCollection AddOpenShockServices(this IServiceCollection se
         {
             options.DefaultApiVersion = new ApiVersion(1, 0);
             options.AssumeDefaultVersionWhenUnspecified = true;
-        });
-
-        apiVersioningBuilder.AddApiExplorer(setup =>
+            options.ReportApiVersions = true;
+            options.ApiVersionReader = new UrlSegmentApiVersionReader();
+        })
+        .AddMvc() // mvc required for ApiExplorer
+        .AddApiExplorer(setup =>
         {
-            setup.GroupNameFormat = "VVV";
+            setup.GroupNameFormat = "'v'V";
             setup.SubstituteApiVersionInUrl = true;
             setup.DefaultApiVersion = new ApiVersion(1, 0);
             setup.AssumeDefaultVersionWhenUnspecified = true;