EllipticBit.Services.Email.SmtpClient 1.1.7

EllipticBit Services - SMTP Email

EllipticBit.Services.Email.SmtpClient is an SMTP email provider for the EllipticBit email abstractions. It delivers messages through any standard SMTP server using a unified IEmailService API, making it easy to swap email providers without changing application code.

This package is part of the EllipticBit Services collection of cross-platform service libraries for .NET.

Features

• Send plain text, HTML and templated email through any SMTP server.
• Attachment and multiple-recipient support.
• Unified IEmailService abstraction shared with other email providers.

Installation

Install the package from NuGet:

dotnet add package EllipticBit.Services.Email.SmtpClient

Or add a PackageReference to your project file:

<PackageReference Include="EllipticBit.Services.Email.SmtpClient" Version="x.y.z" />

Usage

Register the SMTP email services with the dependency injection container:

using EllipticBit.Services.Email;
using Microsoft.Extensions.DependencyInjection;

services.AddSendGridEmailService()
	.Configure(options =>
	{
		options.Host = "smtp.example.com";
		options.Port = 587;
		options.Username = "user";
		options.Password = "secret";
	});

Then inject IEmailService to send messages:

using EllipticBit.Services.Email;

public class NotificationService
{
	private readonly IEmailService _email;

	public NotificationService(IEmailService email)
	{
		_email = email;
	}

	public Task SendReceiptAsync(string address)
		=> _email.Send(
			new EmailAddress(address),
			subject: "Your receipt",
			text: "Thank you for your purchase.");
}

Related Packages

• EllipticBit.Services.Email.Abstractions - the email abstractions implemented by this package.
• EllipticBit.Services.Email.SendGrid - a SendGrid email provider for the same abstractions.

Contributing

Contributions are welcome! To contribute:

1. Fork the repository and create a feature branch.
2. Make your changes, following the existing code style and conventions.
3. Add or update tests where appropriate.
4. Open a merge/pull request with a clear description of the change.

AI / LLM-assisted contributions

If any part of your contribution was generated with the assistance of a Large Language Model (LLM) or other AI tool, you must include the prompt(s) used to generate it in the PROMPTS.txt file as part of the same pull request.

License

This project is licensed under the Boost Software License 1.0 (BSL-1.0).