MailServiceRegistration.cs

using System;
using System.Collections.Generic;
using System.Net.Security;
using Coravel.Mailer.Mail;
using Coravel.Mailer.Mail.Interfaces;
using Coravel.Mailer.Mail.Mailers;
using Coravel.Mailer.Mail.Renderers;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

namespace Coravel
{
    /// <summary>
    /// IServiceCollection extensions for registering Coravel's Mailer.
    /// </summary>
    public static class MailServiceRegistration
    {
        /// <summary>
        /// Register Coravel's mailer using the IConfiguration to provide all configuration details.
        /// </summary>
        /// <param name="services"></param>
        /// <param name="config"></param>
        public static IServiceCollection AddMailer(this IServiceCollection services, IConfiguration config)
        {
            string mailerType = config.GetValue<string>("Coravel:Mail:Driver", "FileLog");

            var strategies = new Dictionary<string, Action>(StringComparer.OrdinalIgnoreCase);
            strategies.Add("SMTP", () => AddSmtpMailer(services, config));
            strategies.Add("FILELOG", () => AddFileLogMailer(services, config));
            strategies[mailerType].Invoke();
            return services;
        }

        public static WebApplicationBuilder AddMailer(this WebApplicationBuilder builder)
        {
            builder.Services.AddMailer(builder.Configuration);
            return builder;
        }

        /// <summary>
        /// Register Coravel's mailer using the File Log Mailer - which sends mail to a file.
        /// Useful for testing.
        /// </summary>
        /// <param name="services"></param>
        /// <param name="config"></param>
        public static IServiceCollection AddFileLogMailer(this IServiceCollection services, IConfiguration config)
        {
            var globalFrom = GetGlobalFromRecipient(config);
            RazorRenderer renderer = RazorRendererFactory.MakeInstance(config);
            var mailer = new FileLogMailer(renderer, globalFrom);
            services.AddSingleton<IMailer>(mailer);
            return services;
        }

        public static WebApplicationBuilder AddFileLogMailer(this WebApplicationBuilder builder)
        {
            builder.Services.AddFileLogMailer(builder.Configuration);
            return builder;
        }

        /// <summary>
        /// Register Coravel's mailer using the Smtp Mailer.
        /// </summary>
        /// <param name="services"></param>
        /// <param name="config"></param>
        /// <param name="certCallback"></param>
        public static IServiceCollection AddSmtpMailer(this IServiceCollection services, IConfiguration config, RemoteCertificateValidationCallback certCallback)
        {
            var globalFrom = GetGlobalFromRecipient(config);
            RazorRenderer renderer = RazorRendererFactory.MakeInstance(config);
            IMailer mailer = new SmtpMailer(
                renderer,
                config.GetValue<string>("Coravel:Mail:Host", ""),
                config.GetValue<int>("Coravel:Mail:Port", 0),
                config.GetValue<string>("Coravel:Mail:Username", null),
                config.GetValue<string>("Coravel:Mail:Password", null),
                globalFrom,
                certCallback
            );
            services.AddSingleton<IMailer>(mailer);
            return services;
        }

        public static WebApplicationBuilder AddSmtpMailer(this WebApplicationBuilder builder, RemoteCertificateValidationCallback certCallback)
        {
            builder.Services.AddSmtpMailer(builder.Configuration, certCallback);
            return builder;
        }

        /// <summary>
        /// Register Coravel's mailer using the Smtp Mailer.
        /// </summary>
        /// <param name="services"></param>
        /// <param name="config"></param>
        public static IServiceCollection AddSmtpMailer(this IServiceCollection services, IConfiguration config)
        {
            AddSmtpMailer(services, config, null);
            return services;
        }

        public static WebApplicationBuilder AddSmtpMailer(this WebApplicationBuilder builder)
        {
            builder.Services.AddSmtpMailer(builder.Configuration);
            return builder;
        }

        /// <summary>
        /// Register Coravel's mailer using the Custom Mailer.
        /// </summary>
        /// <param name="services"></param>
        /// <param name="config"></param>
        /// <param name="sendMailAsync"></param>
        public static IServiceCollection AddCustomMailer(this IServiceCollection services, IConfiguration config, CustomMailer.SendAsyncFunc sendMailAsync)
        {
            var globalFrom = GetGlobalFromRecipient(config);
            RazorRenderer renderer = RazorRendererFactory.MakeInstance(config);
            var mailer = new CustomMailer(renderer, sendMailAsync, globalFrom);
            services.AddSingleton<IMailer>(mailer);
            return services;
        }

        public static WebApplicationBuilder AddCustomMailer(this WebApplicationBuilder builder, CustomMailer.SendAsyncFunc sendMailAsync)
        {
            builder.Services.AddCustomMailer(builder.Configuration, sendMailAsync);
            return builder;
        }

        /// <summary>
        /// Register Coravel's mailer a Custom Mailer that implements `ICanSendMail`.
        /// </summary>
        /// <param name="services"></param>
        /// <param name="config"></param>
        public static IServiceCollection AddCustomMailer<T>(this IServiceCollection services, IConfiguration config) where T : ICanSendMail
        {
            var globalFrom = GetGlobalFromRecipient(config);
            RazorRenderer renderer = RazorRendererFactory.MakeInstance(config);
            services.AddSingleton<IMailer>(p =>
                new CanSendMailWrapper<T>(renderer, p.GetRequiredService<IServiceScopeFactory>(), globalFrom)
            );
            return services;
        }

        public static WebApplicationBuilder AddCustomMailer<T>(this WebApplicationBuilder builder) where T : ICanSendMail
        {
            builder.Services.AddCustomMailer<T>(builder.Configuration);
            return builder;
        }

        private static MailRecipient GetGlobalFromRecipient(IConfiguration config)
        {
            string globalFromAddress = config.GetValue<string>("Coravel:Mail:From:Address", null);
            string globalFromName = config.GetValue<string>("Coravel:Mail:From:Name", null);

            if (globalFromAddress != null)
            {
                return new MailRecipient(globalFromAddress, globalFromName);
            }
            else
            {
                return null;
            }
        }
    }
}