cleanup

Directory.Packages.props

@@ -9,6 +9,9 @@
     <PackageVersion Include="Akka.Hosting.TestKit" Version="1.5.20" />
     <PackageVersion Include="Akka.Streams" Version="1.5.20" />
     <PackageVersion Include="Akka.Streams.TestKit" Version="1.5.20" />
+    <PackageVersion Include="FluentEmail.Mailgun" Version="3.0.2" />
+    <PackageVersion Include="FluentEmail.Razor" Version="3.0.2" />
+    <PackageVersion Include="Microsoft.AspNetCore.Identity.UI" Version="8.0.4" />
     <PackageVersion Include="Microsoft.AspNetCore.SignalR.Client" Version="8.0.4" />
   </ItemGroup>
   <!-- ASP.NET Package Versions -->

README.md

@@ -5,4 +5,14 @@ A collaborative browser-based drawing program written in .NET.
 Please see [REQUIREMENTS](docs/requirements.md) for more information.
 
 ## UI 
-![DrawTogether.NET UI](/docs/images/paintarea-ui.png)
+![DrawTogether.NET UI](/docs/images/paintarea-ui.png)
+
+## MailGun Configuration
+
+NugetUpdates uses [MailGun](https://mailgun.com/) to send outbound emails (via `FluentEmail.Mailgun`) - and the following two secrets need to be configured in order for that sending to work:
+
+```shell
+cd ./src/NuGetUpdates.Web/
+dotnet user-secrets set "EmailSettings:MailgunDomain" "<mailgun-domain>"
+dotnet user-secrets set "EmailSettings:MailgunApiKey" "<mailgun-api-key>"
+```

src/DrawTogether.Email/DrawTogether.Email.csproj

@@ -6,4 +6,10 @@
         <Nullable>enable</Nullable>
     </PropertyGroup>
 
+    <ItemGroup>
+      <PackageReference Include="FluentEmail.Mailgun" />
+      <PackageReference Include="FluentEmail.Razor" />
+      <PackageReference Include="Microsoft.AspNetCore.Identity.UI" />
+    </ItemGroup>
+
 </Project>

src/DrawTogether.Email/EmailSettings.cs

@@ -0,0 +1,12 @@
+namespace DrawTogether.Email;
+
+public class EmailSettings
+{
+    public required string MailgunDomain { get; set; }
+
+    public required string MailgunApiKey { get; set; }
+
+    public required string FromAddress { get; set; }
+
+    public required string FromName { get; set; }
+}

src/DrawTogether.Email/MailGunEmailSender.cs

@@ -0,0 +1,36 @@
+using FluentEmail.Core.Interfaces;
+using Microsoft.AspNetCore.Identity.UI.Services;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
+
+namespace DrawTogether.Email;
+
+/// <summary>
+/// Wraps FluentEmail to send emails using MailGun within the context of ASP.NET Core Identity.
+/// </summary>
+public sealed class MailGunEmailSender : IEmailSender
+{
+    private readonly ILogger<MailGunEmailSender> _logger;
+    private readonly ISender _mailgunSender;
+    private readonly EmailSettings _emailSettings;
+
+    public MailGunEmailSender(ISender mailgunSender, IOptions<EmailSettings> emailSettings, ILogger<MailGunEmailSender> logger)
+    {
+        _logger = logger;
+        _mailgunSender = mailgunSender;
+        _emailSettings = emailSettings.Value;
+    }
+
+    public Task SendEmailAsync(string email, string subject, string htmlMessage)
+    {
+        _logger.LogDebug("Sending email to {Email} with subject {Subject}", email, subject);
+
+        var mailMessage = FluentEmail.Core.Email
+            .From(_emailSettings.FromAddress, _emailSettings.FromName)
+            .To(email)
+            .Subject(subject)
+            .Body(htmlMessage, true);
+
+        return _mailgunSender.SendAsync(mailMessage);
+    }
+}

src/DrawTogether.Email/ServiceCollectionExtensions.cs

@@ -0,0 +1,29 @@
+using Microsoft.AspNetCore.Identity.UI.Services;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace DrawTogether.Email;
+
+public static class ServiceCollectionExtensions
+{
+    public static IServiceCollection AddEmailServices(this IServiceCollection services, IConfiguration configuration)
+    {
+        // check to see if the EmaiLSettings section is configured in the appsettings.json file
+        if (!configuration.GetSection("EmailSettings").Exists())
+        {
+            // bail out early if email is not configured
+            return services;
+        }
+
+        services.Configure<EmailSettings>(configuration.GetSection("EmailSettings"));
+
+        services.AddFluentEmail(configuration["EmailSettings:FromAddress"], configuration["EmailSettings:FromName"])
+            .AddRazorRenderer()
+            .AddMailGunSender(configuration["EmailSettings:MailgunDomain"],
+                configuration["EmailSettings:MailgunApiKey"]);
+
+        services.AddTransient<IEmailSender, MailGunEmailSender>();
+
+        return services;
+    }
+}

src/DrawTogether.UI/DrawTogether/DrawTogether.csproj

@@ -25,4 +25,8 @@
       </Content>
     </ItemGroup>
 
+    <ItemGroup>
+      <ProjectReference Include="..\..\DrawTogether.Email\DrawTogether.Email.csproj" />
+    </ItemGroup>
+
 </Project>

src/DrawTogether.UI/DrawTogether/Program.cs

@@ -4,6 +4,7 @@
 using DrawTogether.Components;
 using DrawTogether.Components.Account;
 using DrawTogether.Data;
+using DrawTogether.Email;
 
 var builder = WebApplication.CreateBuilder(args);
 
@@ -15,6 +16,7 @@
 builder.Services.AddScoped<IdentityUserAccessor>();
 builder.Services.AddScoped<IdentityRedirectManager>();
 builder.Services.AddScoped<AuthenticationStateProvider, IdentityRevalidatingAuthenticationStateProvider>();
+builder.Services.AddEmailServices(builder.Configuration); // add email services
 
 builder.Services.AddAuthentication(options =>
     {