ISL.NetFramework.Sms.Driver 1.0.0

ISL.NetFramework.Sms.Driver

ISL.NetFramework.Sms.Driver is a single-package SMS driver for ISL services.

It provides:

• one-step dependency registration with AddIslSmsDriver(configuration)
• one injectable service: ISmsDriver
• SMS challenge issue/verify APIs
• background queue support for fire-and-forget SMS challenge dispatch

Installation

Add NuGet package:

ISL.NetFramework.Sms.Driver

Registration

services.AddIslSmsDriver(configuration);

Usage

public sealed class OtpService
{
    private readonly ISmsDriver _smsDriver;

    public OtpService(ISmsDriver smsDriver)
    {
        _smsDriver = smsDriver;
    }

    public Task SendLoginCodeAsync(string phoneNumber, CancellationToken cancellationToken)
    {
        return _smsDriver.SendAsync(
            new SmsDriverSendRequest(
                Destination: phoneNumber,
                Purpose: "signin",
                MessageTemplate: "Your verification code is {{code}}."),
            cancellationToken);
    }
}

Configuration

Uses existing configuration sections:

• Framework:TwoFactor
• Framework:TwoFactor:AzureCommunication
• Framework:Sms:Driver

Driver-specific options:

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

Example appsettings.Production.json:

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