Enigmatry.Entry.Email 9.1.1-preview.4

Email Client Library

A library that provides email functionality, supporting templating, attachments, and multiple email service providers.

Intended Usage

Use this library to send emails from your application with support for HTML templates, attachments, and queue-based processing.

Installation

Add the package to your project:

dotnet add package Enigmatry.Entry.Email

Usage Example

using System.Threading.Tasks;
using Enigmatry.Entry.Email;

public class UserService
{
    private readonly IEmailClient _emailClient;
    
    public UserService(IEmailClient emailClient)
    {
        _emailClient = emailClient;
    }
    
    public async Task SendWelcomeEmailAsync(string email, string username)
    {
        // Create an email message with recipient, subject and body
        var emailMessage = new EmailMessage(
            to: email,
            subject: "Welcome to Our Service",
            body: $"<h1>Welcome, {username}!</h1><p>Thank you for registering with our service.</p>"
        );
        
        // Send the email
        await _emailClient.SendAsync(emailMessage);
    }
    
    public async Task SendInvoiceEmailAsync(string email, string invoiceNumber)
    {
        // Create email message
        var emailMessage = new EmailMessage(
            to: email,
            subject: $"Invoice #{invoiceNumber}",
            body: $"<p>Please find your invoice #{invoiceNumber} attached to this email.</p>"
        );
        
        // Read the PDF file
        byte[] pdfData = await File.ReadAllBytesAsync($"invoices/Invoice-{invoiceNumber}.pdf");
        
        // Add attachment
        emailMessage.Attachments.Add(
            new EmailMessageAttachment(
                fileName: $"Invoice-{invoiceNumber}.pdf",
                data: pdfData,
                contentType: "application/pdf"
            )
        );
        
        // Send the email
        await _emailClient.SendAsync(emailMessage);
    }
}

Configuration Example

{
  "App": {
    "Smtp": {
      "Server": "smtp.example.com",
      "Port": 587,
      "Username": "username",
      "Password": "password",
      "From": "noreply@example.com",
      "UsePickupDirectory": false,
      "PickupDirectoryLocation": "C:\\Temp\\EmailPickup",
      "CatchAllAddress": "debug@example.com"
    }
  }
}

Dependency Injection Example

using Enigmatry.Entry.Email;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

public class Startup
{
    public void ConfigureServices(IServiceCollection services, IConfiguration configuration)
    {
        // Register email services
        services.AddEntryEmailClient(configuration);
    }
}