StarterMailing 1.0.0

StarterMailing

A lightweight email notification service built on top of Mailtrap SMTP. Designed for quick integration into any ASP.NET Core / .NET application via dependency injection.

Features

• Async email sending via SMTP
• HTML and plain-text email support
• CC and BCC recipients
• Easy DI registration with a single extension method
• Configurable via appsettings.json or code

Installation

dotnet add package StarterMailing

Configuration

Add a MailtrapSettings section to your appsettings.json:

{
  "MailtrapSettings": {
    "Host": "sandbox.smtp.mailtrap.io",
    "Port": 2525,
    "Username": "your-mailtrap-username",
    "Password": "your-mailtrap-password",
    "FromEmail": "noreply@yourapp.com",
    "FromName": "Your App Name",
    "EnableSsl": true
  }
}

Registration

Register the service in Program.cs (or Startup.cs):

// Option 1: Bind from IConfiguration section
builder.Services.AddMailtrapEmailService(
    builder.Configuration.GetSection("MailtrapSettings"));

// Option 2: Configure via delegate
builder.Services.AddMailtrapEmailService(options =>
{
    options.Host = "sandbox.smtp.mailtrap.io";
    options.Port = 2525;
    options.Username = "your-username";
    options.Password = "your-password";
    options.FromEmail = "noreply@yourapp.com";
    options.FromName = "Your App";
});

Usage

Inject INotificationService<EmailNotificationDto> into your service or controller:

using NotificationService.Dtos;
using NotificationService.interfaces;

public class OrderService
{
    private readonly INotificationService<EmailNotificationDto> _emailService;

    public OrderService(INotificationService<EmailNotificationDto> emailService)
    {
        _emailService = emailService;
    }

    public async Task SendOrderConfirmation(string customerEmail)
    {
        var email = new EmailNotificationDto
        {
            To = customerEmail,
            Subject = "Order Confirmed!",
            Body = "<h1>Thank you for your order!</h1>",
            IsHtml = true
        };

        await _emailService.SendNotificationAsync(email);
    }
}

License

This project is licensed under the MIT License.