Add new schema filter to exclude nullable fields from required

Author: ivan-luxoft

src/Bss.Platform.Api.Documentation/DependencyInjection.cs

@@ -32,6 +32,7 @@ public static IServiceCollection AddPlatformApiDocumentation(
                    {
                        x.SwaggerDoc("api", new OpenApiInfo { Title = title });
                        x.SchemaFilter<XEnumNamesSchemaFilter>();
+                       x.SchemaFilter<ExcludeNullableFromRequiredSchemaFilter>();
 
                        x.AddSecurityDefinition(
                            AuthorizationScheme,

src/Bss.Platform.Api.Documentation/SchemaFilters/ExcludeNullableFromRequiredSchemaFilter.cs

@@ -0,0 +1,34 @@
+using Microsoft.OpenApi.Models;
+
+using Swashbuckle.AspNetCore.SwaggerGen;
+
+namespace Bss.Platform.Api.Documentation.SchemaFilters;
+
+/// <summary>
+///     Exclude nullable property from required.
+///     Needed for supporting correct front-end code generation by GenGen https://github.com/Luxoft/gengen
+///     Additional to https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/2036
+/// </summary>
+public class ExcludeNullableFromRequiredSchemaFilter : ISchemaFilter
+{
+    public void Apply(OpenApiSchema schema, SchemaFilterContext context)
+    {
+        if (schema.Required.Count == 0)
+        {
+            return;
+        }
+
+        var nullableProperties = context.Type.GetProperties()
+            .Where(x => !x.IsNonNullableReferenceType())
+            .Select(x => x.Name);
+
+        var requiredNullableProperty = schema.Required
+            .Intersect(nullableProperties, StringComparer.OrdinalIgnoreCase)
+            .ToArray();
+
+        foreach (var property in requiredNullableProperty)
+        {
+            schema.Required.Remove(property);
+        }
+    }
+}

src/__SolutionItems/CommonAssemblyInfo.cs

@@ -4,9 +4,9 @@
 [assembly: AssemblyCompany("Luxoft")]
 [assembly: AssemblyCopyright("Copyright © Luxoft 2024")]
 
-[assembly: AssemblyVersion("1.5.7.0")]
-[assembly: AssemblyFileVersion("1.5.7.0")]
-[assembly: AssemblyInformationalVersion("1.5.7.0")]
+[assembly: AssemblyVersion("1.5.8.0")]
+[assembly: AssemblyFileVersion("1.5.8.0")]
+[assembly: AssemblyInformationalVersion("1.5.8.0")]
 
 #if DEBUG
 [assembly: AssemblyConfiguration("Debug")]