ISL.NetFramework.Email.Driver 1.0.0

ISL.NetFramework.Email.Driver

ISL.NetFramework.Email.Driver is a single-package email module for ISL services.

It provides:

• one-step dependency registration via AddIslEmailDriver(configuration)
• one injectable service: IEmailDriver
• direct send and background-queued send APIs
• templated email rendering and dispatch persistence through the existing ISL email pipeline

Installation

Add NuGet package:

ISL.NetFramework.Email.Driver

Registration

services.AddIslEmailDriver(configuration);

Usage

public sealed class NotificationService
{
    private readonly IEmailDriver _emailDriver;

    public NotificationService(IEmailDriver emailDriver)
    {
        _emailDriver = emailDriver;
    }

    public Task SendWelcomeAsync(string email, CancellationToken cancellationToken)
    {
        return _emailDriver.QueueTemplatedAsync(
            new EmailDriverTemplatedSendRequest(
                TemplateName: "welcome",
                Language: "en-US",
                DataPairs: new Dictionary<string, string>
                {
                    ["FirstName"] = "Ada"
                },
                ToRecipients: [email]),
            cancellationToken).AsTask();
    }
}

Configuration

Uses existing configuration sections:

• Framework:Email
• Framework:Email:AzureCommunication
• Framework:Email:Driver

Driver-specific options:

• Framework:Email:Driver:QueueMode (InMemory or Database, default: InMemory)
• Framework:Email:Driver:QueueCapacity (default: 10000)
• Framework:Email:Driver:MaxRetryAttempts (default: 3)
• Framework:Email:Driver:InitialRetryDelayMilliseconds (default: 250)
• Framework:Email:Driver:MaxRetryDelayMilliseconds (default: 5000)
• Framework:Email:Driver:UseJitter (default: true)
• Framework:Email:Driver:DatabasePollingIntervalMilliseconds (default: 1000, used in Database mode)
• Framework:Email:Driver:DatabaseBatchSize (default: 50, used in Database mode)
• Framework:Email:Driver:ProcessingLockTimeoutSeconds (default: 300, used in Database mode)
• Framework:Email:Driver:AutoCreateDatabaseQueueTable (default: false)

Example appsettings.Production.json:

{
  "Framework": {
    "Email": {
      "Driver": {
        "QueueMode": "Database",
        "QueueCapacity": 50000,
        "MaxRetryAttempts": 5,
        "InitialRetryDelayMilliseconds": 500,
        "MaxRetryDelayMilliseconds": 15000,
        "UseJitter": true,
        "DatabasePollingIntervalMilliseconds": 500,
        "DatabaseBatchSize": 100,
        "ProcessingLockTimeoutSeconds": 300,
        "AutoCreateDatabaseQueueTable": false
      }
    }
  }
}