Refactor EasyStackOptions for flexible DB configuration

Refactored `EasyStackOptions` to replace the `AddPostgres` property with a more flexible `ConfigureDatabase` delegate, enabling custom database service and health check setup. Added the `WithPostgres<TDbContext>()` helper method for simplified PostgreSQL configuration.

Updated `HostApplicationBuilderExtensions` to use the new `ConfigureDatabase` property, removing hardcoded PostgreSQL setup logic. Improved error handling for authorization to ensure database configuration is provided.

Enhanced code readability, maintainability, and extensibility by centralizing database configuration logic in `EasyStackOptions`.

Author: bvdcode

Sources/EasyExtensions.AspNetCore.Stack/Builders/EasyStackOptions.cs

@@ -1,9 +1,49 @@
-namespace EasyExtensions.AspNetCore.Stack.Builders
+using System;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using EasyExtensions.EntityFrameworkCore.Database;
+using EasyExtensions.EntityFrameworkCore.HealthChecks;
+using EasyExtensions.EntityFrameworkCore.Npgsql.Extensions;
+
+namespace EasyExtensions.AspNetCore.Stack.Builders
 {
+    /// <summary>
+    /// Provides configuration options for customizing EasyStack application features such as authorization and database
+    /// setup.
+    /// </summary>
+    /// <remarks>Use this class to specify application-level options when integrating EasyStack into an
+    /// ASP.NET Core application. The properties allow you to enable or disable authorization and to configure database
+    /// services and health checks during startup. This class is typically configured during application initialization
+    /// to tailor EasyStack's behavior to your application's requirements.</remarks>
     public class EasyStackOptions
     {
-        public bool AddPostgres { get; set; }
-
+        /// <summary>
+        /// Gets or sets a value indicating whether authorization should be added to the request.
+        /// </summary>
         public bool AddAuthorization { get; set; }
+
+        /// <summary>
+        /// Gets or sets the delegate used to configure database services and health checks during application startup.
+        /// </summary>
+        /// <remarks>Use this property to provide custom logic for registering database-related services
+        /// and health checks with the application's dependency injection container. The delegate receives the service
+        /// collection, health checks builder, and configuration, allowing for flexible setup of database connectivity
+        /// and monitoring.</remarks>
+        public Action<IServiceCollection, IHealthChecksBuilder, IConfiguration>? ConfigureDatabase { get; set; }
+
+
+        public EasyStackOptions WithPostgres<TDbContext>() where TDbContext : AuditedDbContext
+        {
+            ConfigureDatabase = (services, hc, cfg) =>
+            {
+                services.AddPostgresDbContext<TDbContext>(db =>
+                {
+                    db.UseLazyLoadingProxies = false;
+                });
+
+                hc.AddCheck<DatabaseHealthCheck<TDbContext>>("Database");
+            };
+            return this;
+        }
     }
 }

Sources/EasyExtensions.AspNetCore.Stack/Extensions/HostApplicationBuilderExtensions.cs

@@ -7,9 +7,6 @@
 using EasyExtensions.AspNetCore.Extensions;
 using Microsoft.Extensions.DependencyInjection;
 using EasyExtensions.AspNetCore.Stack.Builders;
-using EasyExtensions.EntityFrameworkCore.Database;
-using EasyExtensions.EntityFrameworkCore.HealthChecks;
-using EasyExtensions.EntityFrameworkCore.Npgsql.Extensions;
 using EasyExtensions.AspNetCore.Authorization.Extensions;
 
 namespace EasyExtensions.AspNetCore.Stack.Extensions
@@ -51,9 +48,9 @@ public static class HostApplicationBuilderExtensions
         /// <param name="setupStack">An optional delegate to configure EasyStack options. If null, default options are used.</param>
         /// <returns>The same <see cref="IHostApplicationBuilder"/> instance so that additional configuration calls can be
         /// chained.</returns>
-        public static IHostApplicationBuilder AddEasyStack<TDbContext>(
+        public static IHostApplicationBuilder AddEasyStack(
             this IHostApplicationBuilder builder,
-            Action<EasyStackOptions>? setupStack) where TDbContext : AuditedDbContext
+            Action<EasyStackOptions>? setupStack)
         {
             // create temp logger to log during startup
             using var loggerFactory = LoggerFactory.Create(loggingBuilder =>
@@ -140,16 +137,15 @@ public static IHostApplicationBuilder AddEasyStack<TDbContext>(
             }
 
             // Add Postgres if asked
-            if (options.AddPostgres)
+            if (options.ConfigureDatabase != null)
             {
-                builder.Services.AddPostgresDbContext<TDbContext>(x => x.UseLazyLoadingProxies = false);
-                healthChecksBuilder.AddCheck<DatabaseHealthCheck<TDbContext>>("Database");
+                options.ConfigureDatabase.Invoke(builder.Services, healthChecksBuilder, builder.Configuration);
                 logger.LogInformation("Added Postgres DbContext and Database health check");
             }
 
             if (options.AddAuthorization)
             {
-                if (!options.AddPostgres)
+                if (options.ConfigureDatabase == null)
                 {
                     throw new Exception("Authorization requires Postgres. Set AddPostgres to true in EasyStackOptions.");
                 }