Decode.Email.Smtp 3.0.0

Decode.Email.Smtp

SMTP email service provider implementation with console dev logger mode for the Decode ecosystem.

🚀 Features

• SMTP Provider: Standard SMTP client supporting SSL/TLS, custom credentials, attachments, and Reply-To addresses.
• Console Dev Logger Mode: Set UseConsoleLogger = true in development to simulate email sending via ILogger without needing a live SMTP server.
• Template Engine Integration: Full support for HTML template rendering (#TAG# or {{TAG}}).
• Options Validation: Native configuration validation on application startup (ValidateOnStart), applied by both registration overloads — bound to IConfiguration or configured in code.

📦 Installation

Add the package to your API or Infrastructure project:

dotnet add package Decode.Email.Smtp

🛠️ Setup

1. Configure Services in Program.cs

// 1. Register SMTP Email Provider bound to configuration section
builder.Services.AddDecodeSmtpEmail(builder.Configuration.GetSection("SmtpEmailOptions"));

// 2. (Optional) Register Embedded Email Templates from your Application Assembly
builder.Services.AddDecodeEmailEmbeddedTemplates(typeof(Program).Assembly, "MyApp.Domain.EmailTemplates");

2. Add Configuration in appsettings.json

{
  "SmtpEmailOptions": {
    "Host": "smtp.mailtrap.io",
    "Port": 2525,
    "Username": "your_username",
    "Password": "your_password",
    "EnableSsl": true,
    "DefaultFromEmail": "noreply@mydomain.com",
    "DefaultFromName": "My Application",
    "UseConsoleLogger": false
  }
}

3. Development / Staging Configuration (appsettings.Development.json)

To simulate email sending without connecting to a real SMTP server:

{
  "SmtpEmailOptions": {
    "Host": "localhost",
    "UseConsoleLogger": true
  }
}

📖 Usage Example

using Decode.Email.Abstractions.Interfaces;
using Decode.Email.Abstractions.Models;

public class PasswordRecoveryHandler(IEmailService emailService)
{
    public async Task HandleAsync(string userEmail, string recoveryCode)
    {
        // Sending an HTML template with dynamic replacements
        await emailService.SendTemplateAsync(
            to: new EmailAddress(userEmail),
            subject: "Password Recovery Code",
            templateName: "PasswordRecovery",
            model: new
            {
                CODE = recoveryCode,
                EXPIRATION = "15 minutes"
            }
        );
    }
}

📄 License

This project is licensed under the MIT License.