Headless.Emails.Abstractions 0.4.15

dotnet add package Headless.Emails.Abstractions --version 0.4.15
                    
NuGet\Install-Package Headless.Emails.Abstractions -Version 0.4.15
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Headless.Emails.Abstractions" Version="0.4.15" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Headless.Emails.Abstractions" Version="0.4.15" />
                    
Directory.Packages.props
<PackageReference Include="Headless.Emails.Abstractions" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Headless.Emails.Abstractions --version 0.4.15
                    
#r "nuget: Headless.Emails.Abstractions, 0.4.15"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Headless.Emails.Abstractions@0.4.15
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Headless.Emails.Abstractions&version=0.4.15
                    
Install as a Cake Addin
#tool nuget:?package=Headless.Emails.Abstractions&version=0.4.15
                    
Install as a Cake Tool

Headless.Emails.Abstractions

Defines the unified interface for sending emails across different providers (AWS SES, SMTP/MailKit, development).

Problem Solved

Provides a provider-agnostic email sending API, enabling seamless switching between email providers without changing application code.

Key Features

  • IEmailSender - Core interface for sending emails
  • SendSingleEmailRequest - Request model with recipients, subject, body, attachments
  • SendSingleEmailResponse - Response with success status and message ID

Installation

dotnet add package Headless.Emails.Abstractions

Usage

public sealed class NotificationService(IEmailSender emailSender)
{
    public async Task SendWelcomeEmailAsync(string to, string name, CancellationToken ct)
    {
        var response = await emailSender.SendAsync(new SendSingleEmailRequest
        {
            To = [to],
            Subject = "Welcome!",
            HtmlBody = $"<h1>Hello {name}!</h1>",
            TextBody = $"Hello {name}!"
        }, ct).ConfigureAwait(false);

        if (!response.IsSuccess)
            _logger.LogError("Failed to send email: {Error}", response.Error);
    }
}

Configuration

No configuration required. This is an abstractions-only package.

Dependencies

None.

Side Effects

None.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Headless.Emails.Abstractions:

Package Downloads
Headless.Emails.Core

Package Description

Headless.Emails.Dev

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.4.15 154 5/18/2026
0.4.14 146 5/18/2026