Add AddCommunicator via IServiceCollection with IConfiguration as parameter

Author: Ruben Bisharyan

Readme.md

@@ -31,9 +31,11 @@ Install this NuGet library directly from the IDE package installer or by followi
 
 ## 1.3. Setup
 
-To incorporate PandaTech.Communicator into your project, you have a primary method to setup in your `Program.cs`:
+To incorporate PandaTech.Communicator into your project, you have 2 primary methods to setup in your `Program.cs`:
 
-`builder.AddCommunicator();`
+The first method directly using `WebApplicationBuilder` from which `IConfiguration` is directly used. But for the second method builder is not accessible, so we pass `IConfiguration` into it as parameter.   
+- `builder.AddCommunicator();`
+- `services.AddCommunicator(configuration);`
 
 Configuration options can be specified either in `appsettings.json` or directly in `Program.cs`, with the latter taking precedence.
 
@@ -65,6 +67,7 @@ For each channel can be setup same provider, but it's recommended to have differ
 
 In case of using SSL by setting UseSsl = true use port number 456, otherwise use 587 for non SSL connection. 
 
+#### 1.3.1.1. Using `WebApplicationBuilder`
 ```csharp
 builder.AddCommunicator(options =>
 {
@@ -129,6 +132,72 @@ builder.AddCommunicator(options =>
 
 ```
 
+#### 1.3.1.2. Useing `IServiceCollection`
+
+```csharp
+services.AddCommunicator(configuration, options =>
+{
+    options.SmsFake = false;
+    options.SmsConfigurations = new Dictionary<string, SmsConfiguration>
+    {
+        {
+            "GeneralSender", new SmsConfiguration
+            {
+                Provider = "Dexatel",
+                From = "sender_name",
+                Properties = new Dictionary<string, string>
+                {
+                    { "X-Dexatel-Key", "key" }
+                },
+                TimeoutMs = 10000
+            }
+        },
+        {
+            "TransactionalSender", new SmsConfiguration
+            {
+                Provider = "Twilio",
+                From = "sender_number",
+                Properties = new Dictionary<string, string>
+                {
+                    { "SID", "key" },
+                    { "AUTH_TOKEN", "token" }
+                },
+                TimeoutMs = 10000
+            }
+        }
+    };
+    options.EmailFake = false;
+    options.EmailConfigurations = new Dictionary<string, EmailConfiguration>
+    {
+        {
+            "GeneralSender", new EmailConfiguration
+            {
+                SmtpServer = "smtp.test.com",
+                SmtpPort = 465, // 587
+                SmtpUsername = "test",
+                SmtpPassword = "test123",
+                SenderEmail = "[email protected]",
+                UseSsl = true, // false
+                TimeoutMs = 10000
+            }
+        },
+        {
+            "TransactionalSender", new EmailConfiguration
+            {
+                SmtpServer = "smtp.gmail.com",
+                SmtpPort = 465, // 587
+                SmtpUsername = "vazgen",
+                SmtpPassword = "vazgen123",
+                SenderEmail = "[email protected]",
+                UseSsl = true, // false
+                TimeoutMs = 10000
+            }
+        }
+    };
+});
+
+```
+
 ### 1.3.2. Appsettings.json Example
 
 ```json

src/Communicator/Communicator.csproj

@@ -8,7 +8,7 @@
         <PackageReadmeFile>Readme.md</PackageReadmeFile>
         <Authors>Pandatech</Authors>
         <Copyright>MIT</Copyright>
-        <Version>1.0.0</Version>
+        <Version>1.0.1</Version>
         <PackageId>Pandatech.Communicator</PackageId>
         <Title>SMS and Email Communication helper</Title>
         <PackageTags>Pandatech, library, Sms, Email, Messages</PackageTags>

src/Communicator/Extensions/ServiceCollectionExtensions.cs

@@ -0,0 +1,110 @@
+using Communicator.Enums;
+using Communicator.Helpers;
+using Communicator.Options;
+using Communicator.Services.Implementations;
+using Communicator.Services.Interfaces;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Communicator.Extensions;
+
+public static class ServiceCollectionExtensions
+{
+    public static IServiceCollection AddCommunicator(this IServiceCollection services,
+        IConfiguration configuration,
+        Action<CommunicatorOptions>? setupAction = null)
+    {
+        var setupActionOptions = GetCommunicatorSetupOptions(setupAction);
+
+        var configurationOptions = GetCommunicatorConfigurationOptions(configuration);
+
+        CommunicatorOptions options;
+
+        if (setupAction is not null)
+        {
+            options = setupActionOptions!;
+        }
+        else if (configurationOptions is not null)
+        {
+            options = configurationOptions;
+        }
+        else
+        {
+            throw new Exception("No any Configuration Option setup.");
+        }
+
+        RegisterSmsHttpClientsFromConfig(services, options);
+
+        RegisterServices(services, options);
+
+        return services;
+    }
+    
+    private static CommunicatorOptions? GetCommunicatorConfigurationOptions(IConfiguration configuration)
+    {
+        var configurationOptions = CommunicatorConfigurator.ReadConfigurationOptions(configuration);
+
+        if (configurationOptions is null)
+        {
+            return null;
+        }
+
+        configurationOptions.Validate();
+
+        return configurationOptions;
+    }
+
+    private static CommunicatorOptions? GetCommunicatorSetupOptions(Action<CommunicatorOptions>? setupAction = null)
+    {
+        var setupOptions = new CommunicatorOptions();
+
+        if (setupAction is null)
+        {
+            return null;
+        }
+
+        setupAction.Invoke(setupOptions);
+        setupOptions.Validate();
+
+        return setupOptions;
+    }
+
+    private static void RegisterSmsHttpClientsFromConfig(IServiceCollection services,
+        CommunicatorOptions communicatorOptions)
+    {
+        if (communicatorOptions.SmsFake) return;
+
+        foreach (var (key, configValue) in communicatorOptions.SmsConfigurations!)
+        {
+            services.AddHttpClient(key, client =>
+            {
+                client.BaseAddress = new Uri(SmsProviderIntegrations.BaseUrls[configValue.Provider]);
+                client.Timeout = TimeSpan.FromMilliseconds(configValue.TimeoutMs);
+            });
+        }
+    }
+
+    private static void RegisterServices(IServiceCollection services,
+        CommunicatorOptions communicatorOptions)
+    {
+        if (communicatorOptions.EmailFake)
+        {
+            services.AddScoped<IEmailService, FakeEmailService>();
+        }
+        else
+        {
+            services.AddScoped<IEmailService, EmailService>();
+        }
+
+        if (communicatorOptions.SmsFake)
+        {
+            services.AddScoped<ISmsService, FakeSmsService>();
+        }
+        else
+        {
+            services.AddScoped<ISmsService, SmsService>();
+        }
+
+        services.AddSingleton(communicatorOptions);
+    }
+}