coronabytes / dotnet-email

.NET Transactional E-Mail Abstraction Layer

dotnet add package Core.Email
dotnet add package Core.Email.Provider.SES

.NET Transactional E-Mail Abstraction Layer

• common providers
  • smtp via mailkit
  • aws ses
  • mailjet
  • sendgrid
  • postmark
• TODO
  • bounce handlers

Usage

appsettings.json

{
  "Email": {
    "Default": "Postmark",
    "SMTP": {
      "Host": "smtp.***.com",
      "Port": 587,
      "Username": "***",
      "Password": "***",
      "Tls": true
    },
    "SES": {
      "AccessKey": "***",
      "SecretAccessKey": "***",
      "Region": "eu-central-1"
    },
    "Postmark": {
      "ServerToken": "***",
      "MessageStream": "outbound"
    },
    "Mailjet": {
      "ApiKey": "***",
      "ApiSecret": "***"
    },
    "SendGrid": {
      "ApiKey": "***"
    }
  }
}

• use .NET 8 keyed services to have multiple configurations of the same provider
• appsettings is matched with "Email:{key}"

serviceCollection.AddCoreEmail();
serviceCollection.AddSmtpProvider("SMTP");
serviceCollection.AddPostmarkProvider("Postmark");
serviceCollection.AddSendGridProvider("SendGrid");
serviceCollection.AddMailjetProvider("Mailjet");
serviceCollection.AddSimpleEmailServiceProvider("SES");

var email = serviceProvider.GetRequiredService<ICoreEmail>();

await email.SendAsync(new CoreEmailMessage
{
  To = ["[e-mail]"],
  From = "[e-mail]",
  Subject = "Transactional Mail Subject",
  TextBody = "Transactional Mail Body",
  Attachments = [new CoreEmailAttachment
  {
    Name = "File.txt",
    ContentType = "text/plain",
    Content = "Hello World!"u8.ToArray()
  }]
});