Indiko.Blocks.Messaging.EMail 2.7.8

Indiko.Blocks.Messaging.EMail

Email messaging implementation using MailKit/SMTP for sending transactional and marketing emails.

Overview

This package provides email sending capabilities using SMTP with support for HTML emails, attachments, CC/BCC, and template processing.

Features

• SMTP Support: Send via any SMTP server
• HTML & Plain Text: Support for both formats
• Attachments: File attachments support
• CC/BCC: Carbon copy and blind carbon copy
• Template Processing: Built-in template engine
• SSL/TLS: Secure connections
• Async/Await: Full asynchronous support

Installation

dotnet add package Indiko.Blocks.Messaging.EMail

Configuration

appsettings.json

{
  "EMailMessagingOptions": {
    "Enabled": true,
    "SmtpHost": "smtp.gmail.com",
    "SmtpPort": 587,
    "Username": "your-email@gmail.com",
    "Password": "your-app-password",
    "FromEmail": "noreply@example.com",
    "FromName": "My Application",
    "EnableSsl": true,
    "Timeout": 30000
  }
}

Quick Start

Send Simple Email

public class EmailService
{
    private readonly IEMailMessageSender _emailSender;

    public EmailService(IEMailMessageSender emailSender)
    {
        _emailSender = emailSender;
    }

    public async Task SendWelcomeEmailAsync(string to, string name)
    {
        var message = new EMailMessage
        {
            To = new[] { to },
            Subject = "Welcome!",
            Body = $"<h1>Welcome {name}!</h1><p>Thank you for signing up.</p>",
            IsHtml = true
        };

        var result = await _emailSender.SendAsync(message);
        
        if (!result.Success)
        {
            throw new Exception($"Failed to send email: {result.ErrorMessage}");
        }
    }
}

Send with Template

public async Task SendOrderConfirmationAsync(Order order)
{
    var template = await File.ReadAllTextAsync("Templates/OrderConfirmation.html");
    
    var placeholders = new Dictionary<string, string>
    {
        { "CustomerName", order.CustomerName },
        { "OrderNumber", order.OrderNumber },
        { "OrderDate", order.OrderDate.ToString("D") },
        { "TotalAmount", order.TotalAmount.ToString("C") }
    };
    
    var body = _templateEngine.ProcessTemplate(template, placeholders);
    
    var message = new EMailMessage
    {
        To = new[] { order.CustomerEmail },
        Subject = $"Order Confirmation #{order.OrderNumber}",
        Body = body,
        IsHtml = true
    };

    await _emailSender.SendAsync(message);
}

Send with Attachments

public async Task SendInvoiceAsync(string to, string invoicePath)
{
    var message = new EMailMessage
    {
        To = new[] { to },
        Subject = "Your Invoice",
        Body = "<p>Please find your invoice attached.</p>",
        IsHtml = true,
        Attachments = new List<EmailAttachment>
        {
            new EmailAttachment
            {
                FileName = "invoice.pdf",
                FilePath = invoicePath,
                ContentType = "application/pdf"
            }
        }
    };

    await _emailSender.SendAsync(message);
}

Send with CC/BCC

public async Task SendReportAsync()
{
    var message = new EMailMessage
    {
        To = new[] { "manager@example.com" },
        Cc = new[] { "supervisor@example.com" },
        Bcc = new[] { "archive@example.com" },
        Subject = "Daily Report",
        Body = GenerateReport(),
        IsHtml = true
    };

    await _emailSender.SendAsync(message);
}

SMTP Providers

Gmail

{
  "EMailMessagingOptions": {
    "SmtpHost": "smtp.gmail.com",
    "SmtpPort": 587,
    "Username": "your-email@gmail.com",
    "Password": "your-app-password",
    "EnableSsl": true
  }
}

Note: Use App Passwords for Gmail.

SendGrid

{
  "EMailMessagingOptions": {
    "SmtpHost": "smtp.sendgrid.net",
    "SmtpPort": 587,
    "Username": "apikey",
    "Password": "your-sendgrid-api-key",
    "EnableSsl": true
  }
}

Mailgun

{
  "EMailMessagingOptions": {
    "SmtpHost": "smtp.mailgun.org",
    "SmtpPort": 587,
    "Username": "postmaster@yourdomain.mailgun.org",
    "Password": "your-mailgun-password",
    "EnableSsl": true
  }
}

AWS SES

{
  "EMailMessagingOptions": {
    "SmtpHost": "email-smtp.us-east-1.amazonaws.com",
    "SmtpPort": 587,
    "Username": "your-ses-smtp-username",
    "Password": "your-ses-smtp-password",
    "EnableSsl": true
  }
}

Best Practices

1. Use App Passwords: Don't use main account passwords
2. Rate Limiting: Implement rate limiting for bulk emails
3. Error Handling: Always check send results
4. Logging: Log all email operations
5. Testing: Use services like Mailtrap for testing
6. Unsubscribe: Include unsubscribe links
7. SPF/DKIM: Configure SPF and DKIM records

Target Framework

• .NET 10

Dependencies

• Indiko.Blocks.Messaging.Abstractions
• MailKit (4.0+)

Related Packages

• Indiko.Blocks.Messaging.Abstractions
• Indiko.Blocks.Messaging.PushNotification