ISL.NetFramework.Sms.Driver 2.1.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
• optional provider bridge auto-registration when provider package is present (ex: ISL.NetFramework.TwoFactor.Azure)

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:Sms:Driver

Provider-specific section (when Azure provider package is installed):

• Framework:TwoFactor:AzureCommunication

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
 }
 }
 }
}