feat: support email notification

fixes #1

Author: WeihanLi

OpenReservation.Notification/NotificationRequest.cs

@@ -6,9 +6,12 @@ public sealed class NotificationRequest
 {
     public string? MsgId { get; set; }
     public string? Signature { get; set; }
+    
     [Required]
     public required string Text { get; set; }
 
+    public string? Subject { get; set; }
+
     public string? TimeFormat { get; set; } = "yyyy-MM-dd HH:mm:ss";
     public string? To { get; set; }
 

OpenReservation.Notification/NotificationType.cs

@@ -4,4 +4,5 @@ public enum NotificationType
 {
     DingBot = 0,
     WeChatCorpApp = 1,
+    Email = 2,
 }

OpenReservation.Notification/OpenReservation.Notification.csproj

@@ -10,6 +10,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="8.0.0" />
+    <PackageReference Include="SendGrid" Version="9.29.1" />
     <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
     <PackageReference Include="WeihanLi.Common" Version="1.0.61" />
     <PackageReference Include="WeihanLi.Web.Extensions" Version="1.7.0" />

OpenReservation.Notification/Program.cs

@@ -1,4 +1,5 @@
 using OpenReservation.Notification;
+using SendGrid;
 using WeihanLi.Web.Authentication;
 
 var builder = WebApplication.CreateSlimBuilder(args);
@@ -9,10 +10,13 @@
 builder.Services.AddSwaggerGen();
 
 builder.Services.AddMemoryCache();
+
 builder.Services.AddHttpClient<DingBotNotification>();
 builder.Services.AddKeyedSingleton<INotification, DingBotNotification>(NotificationType.DingBot);
 builder.Services.AddHttpClient<WeChatCorpAppNotification>();
 builder.Services.AddKeyedSingleton<INotification, WeChatCorpAppNotification>(NotificationType.WeChatCorpApp);
+builder.Services.AddSingleton<ISendGridClient>(new SendGridClient(builder.Configuration.GetRequiredAppSetting("SendGridApiKey")));
+builder.Services.AddKeyedSingleton<INotification, SendGridEmailNotification>(NotificationType.Email);
 
 builder.Services.AddAuthentication()
     .AddApiKey(options => options.ApiKey = builder.Configuration.GetRequiredAppSetting("AuthApiKey"));

OpenReservation.Notification/SendGridEmailNotification.cs

@@ -0,0 +1,47 @@
+using SendGrid;
+using WeihanLi.Common;
+
+namespace OpenReservation.Notification;
+
+public sealed class SendGridEmailNotification
+    (IConfiguration configuration, ISendGridClient client, ILogger<SendGridEmailNotification> logger) 
+    : INotification
+{
+    private readonly ILogger<SendGridEmailNotification> _logger = logger;
+    private readonly SendGridEmailConfiguration _emailConfiguration = Guard.NotNull(configuration.GetRequiredSection("SendGrid")
+        .Get<SendGridEmailConfiguration>());
+    
+    public async Task SendAsync(NotificationRequest request)
+    {
+        var msg = SendGrid.Helpers.Mail.MailHelper.CreateSingleEmail(
+            new SendGrid.Helpers.Mail.EmailAddress(_emailConfiguration.SourceEmail, _emailConfiguration.SourceName),
+            new SendGrid.Helpers.Mail.EmailAddress(request.To),
+            request.Subject ?? "Email Notification",
+            null,
+            request.Text
+        );
+
+        var response = await client.SendEmailAsync(msg);
+
+        if (response.StatusCode is System.Net.HttpStatusCode.OK 
+            or System.Net.HttpStatusCode.Created 
+            or System.Net.HttpStatusCode.Accepted
+            )
+        {
+            _logger.LogInformation("Email Sent for {To}, message: {Message} successfully sent",
+                request.To, request.Text);
+        }
+        else
+        {
+            var errorMessage = await response.Body.ReadAsStringAsync();
+            _logger.LogError("Send email response with code {StatusCode} and body {ErrorMessage}, subject: {Subject}",
+                response.StatusCode, errorMessage, request.Subject);
+        }
+    }
+}
+
+public sealed class SendGridEmailConfiguration
+{
+    public string SourceEmail { get; set; } = "[email protected]";
+    public string SourceName { get; set; } = "Notification Service";
+}

OpenReservation.Notification/appsettings.json

@@ -8,11 +8,16 @@
   "AllowedHosts": "*",
   "AppSettings": {
     "AuthApiKey": "",
-    "DingBotWebhookUrl": ""
+    "DingBotWebhookUrl": "",
+    "SendGridApiKey": ""
   },
   "WeChatCorpApp": {
     "CorpId": "ww3508de6cad12eebd",
     "AppId": "1000003",
     "AppSecret": ""
+  },
+  "SendGrid": {
+    "SourceEmail": "[email protected]",
+    "SourceName": "Notification Service"
   }
 }