NPv.Mail.Abstractions 2.2.0

NPv.Mail.Abstractions

A lightweight set of abstractions for email sending and templating in .NET applications.

📌 Breaking changes

v2.0.0

• Target framework updated to net10.0 (dropped net9.0 support).

This is a personal library that focuses on the latest .NET runtime to keep maintenance simple and enjoyable.

✨ Features

• IMailSender — abstraction for sending emails with either application-level default SMTP settings or per-call SMTP settings.
• MailAttachment — DTO for file attachments.
• MailRequest — DTO for email data, including optional file attachments.
• SmtpSettings — POCO for SMTP configuration, compatible with IConfiguration binding and explicit per-message configuration.
• EmailContent — DTO representing the rendered email content (subject and HTML body).
• IEmailTemplateModel — interface for providing localization data for email templates.
• IEmailTemplateRenderer — abstraction for rendering HTML email templates with localization and dynamic data.

📦 Installation

Add a reference to the NuGet package:

dotnet add package NPv.Mail.Abstractions

Or with the Package Manager Console:

Install-Package NPv.Mail.Abstractions

⚙️ Usage

Configure default SMTP settings

SmtpSettings is designed to be bound from configuration and reused by an IMailSender implementation as the default SMTP server.

builder.Services.Configure<SmtpSettings>(
    builder.Configuration.GetSection("Smtp")
);

// Register your implementations
builder.Services.AddTransient<IMailSender, MailKitMailSender>();
builder.Services.AddTransient<IEmailTemplateRenderer, ScribanEmailTemplateRenderer>();

Send an email with default SMTP settings

Use this overload when the sender implementation should use SMTP settings configured at application startup.

var message = new MailRequest
{
    To = "recipient@example.com",
    Subject = "Welcome!",
    HtmlBody = "<p>Hello world!</p>",
    Attachments =
    [
        new MailAttachment
        {
            FileName = "hello.txt",
            Content = Encoding.UTF8.GetBytes("Hello world!"),
            ContentType = "text/plain"
        }
    ]
};

await mailSender.SendAsync(message, CancellationToken.None);

Send an email with explicit SMTP settings

Use this overload when the SMTP server must be selected dynamically, for example for tenant-specific mailboxes, customer-specific sender accounts, or one-off delivery settings.

var smtpSettings = new SmtpSettings
{
    ServerName = "smtp.customer.example.com",
    ServerPort = 587,
    UserName = "customer-sender@example.com",
    Password = "smtp-password",
    FromAddress = "customer-sender@example.com",
    FromName = "Customer Sender"
};

var message = new MailRequest
{
    To = "recipient@example.com",
    Subject = "Welcome!",
    HtmlBody = "<p>Hello from a custom SMTP server.</p>"
};

await mailSender.SendAsync(smtpSettings, message, CancellationToken.None);

🧩 IMailSender contract

public interface IMailSender
{
    Task SendAsync(SmtpSettings smtpSettings, MailRequest message, CancellationToken cancellationToken);
    Task SendAsync(MailRequest message, CancellationToken cancellationToken);
}

• SendAsync(MailRequest message, CancellationToken cancellationToken) sends through the implementation's default SMTP configuration.
• SendAsync(SmtpSettings smtpSettings, MailRequest message, CancellationToken cancellationToken) sends through the SMTP configuration provided for this specific call.

📝 Render a template

var content = emailTemplateRenderer.Render(new ConfirmEmailTemplateModel(confirmUrl, "en"));

Console.WriteLine(content.Subject);
Console.WriteLine(content.HtmlBody);

Configuration

"Smtp": {
  "ServerName": "smtp.example.com",
  "ServerPort": 587,
  "UserName": "user@example.com",
  "Password": "yourpassword",
  "FromAddress": "noreply@example.com",
  "FromName": "Example Sender"
}

🚀 Author's Note

This library grew out of my long-standing personal interest in structuring and publishing open source packages. Over time, I’ve revisited and refined earlier internal utilities and ideas, giving them a more consistent shape and preparing them for wider reuse. Along the way, I’ve also taken the opportunity to explore how open source distribution and licensing work in the .NET ecosystem.

It’s a small step toward something I’ve always wanted to try — sharing practical, minimal tools that reflect years of learning, experimentation, and refinement.

Hopefully, someone finds it useful.

Nikolai 😛

⚖️ License

MIT — you are free to use this in commercial and open-source software.