last ...

ContextGenerator.ps1

@@ -8,7 +8,7 @@ $timestamp = Get-Date -Format 'yyyyMMdd_HHmmss'
 if ([string]::IsNullOrWhiteSpace($Path)) {
     # If no path is provided, use current path
     $searchPath = (Get-Location).Path
-    $outputFile = ".\xDashboard-$timestamp.txt"
+    $outputFile = ".\Documents\GeneratedContext\xDashboard-$timestamp.txt"
 }
 else {
     if (-not (Test-Path -LiteralPath $Path -PathType Container)) {
@@ -24,7 +24,7 @@ else {
     # Make folder name safe for file name
     $safeLastFolder = $lastFolder -replace '[\\/:*?"<>|]', '_'
 
-    $outputFile = ".\xDashboard-$safeLastFolder-$timestamp.txt"
+    $outputFile = ".\Documents\GeneratedContext\xDashboard-$safeLastFolder-$timestamp.txt"
 }
 
 Get-ChildItem -LiteralPath $searchPath -Recurse -File |

ContextGenerator.sh

@@ -33,7 +33,7 @@ else
 fi
 
 TIMESTAMP="$(date +%Y%m%d_%H%M%S)"
-OUTPUT_FILE="./${OUTPUT_PREFIX}-${TIMESTAMP}.txt"
+OUTPUT_FILE="./Documents/GeneratedContext/${OUTPUT_PREFIX}-${TIMESTAMP}.txt"
 
 find "$SEARCH_PATH" -type f \( \
     -name "Dockerfile" \

Documents/GeneratedContext/xDashboard-xAiService-20260807_230244.txt

@@ -0,0 +1,693 @@
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Configurations\XAIServiceConfiguration.cs
+
+namespace xAiService.Configurations
+{
+    public partial class XAIServiceConfiguration
+    {
+        public string Url { get; set; }
+        public string XPoweredValue { get; set; }
+        public int DefaultClientTimeout { get; set; } = 360;
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Constants\ConfigurationNodeNames.cs
+
+namespace xAiService.Constants
+{
+    public partial struct ConfigurationNodeNames
+    {
+        public const string AI_SERVICE_NODE = "AIServiceConfiguration";
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Constants\XAiApiConstants.cs
+
+namespace xAiService.Constants
+{
+    public struct XAiApiQueryParams
+    {
+        public const string Prompt = "prompt";
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Constants\XAiApiEndpoint.cs
+
+using xExceptions.Attributes;
+
+namespace xAiService.Constants
+{
+    public enum XAiApiEndpoint
+    {
+        [StringValue("AskAI")]
+        Ask,
+        [StringValue("AskAIStream")]
+        Stream,
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\DI\XDIHelperExtension.cs
+
+using System;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using xAiService.Configurations;
+using xAiService.Constants;
+using xAiService.Extensions;
+using xAiService.Interfaces;
+using xAiService.Services;
+using xCommons.Extensions;
+using xExceptions.Constants;
+
+namespace xAiService.DI
+{
+    public static partial class XDIHelperExtension
+    {
+        /// <summary>
+        /// Extract AI Service Configuration ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <returns></returns>
+        public static XAIServiceConfiguration GetXAIServiceConfiguration(this IConfiguration source)
+        {
+            //
+            XAIServiceConfiguration result = null;
+
+            //
+            var section = source.GetSection(ConfigurationNodeNames.AI_SERVICE_NODE);
+            if (!section.IsNull())
+            {
+                result = section.Get<XAIServiceConfiguration>();
+            }
+
+            //
+            return result;
+        }
+
+        /// <summary>
+        /// Add AI Service Configuration ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="configuration"></param>
+        public static void AddXAIServiceConfiguration(
+            this IServiceCollection source,
+            XAIServiceConfiguration configuration
+        )
+        {
+            source.AddSingleton<XAIServiceConfiguration>(configuration);
+        }
+
+        /// <summary>
+        /// Adding XAiService ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        /// <param name="lifeTime"></param>
+        public static void AddXAIService(
+            this IServiceCollection services,
+            IConfiguration configuration,
+            ServiceLifetime lifeTime = ServiceLifetime.Scoped
+        )
+        {
+            //
+            var config = configuration.GetXAIServiceConfiguration();
+            AddAIService(
+                services,
+                config,
+                lifeTime
+            );
+        }
+
+        /// <summary>
+        /// Adding XAiService ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        /// <param name="lifeTime"></param>
+        public static void AddXAIService(
+            this IServiceCollection services,
+            XAIServiceConfiguration configuration,
+            ServiceLifetime lifeTime = ServiceLifetime.Scoped
+        )
+        {
+            //
+            AddAIService(
+                services,
+                configuration,
+                lifeTime
+            );
+        }
+
+        //
+        #region Private ...
+        /// <summary>
+        /// a LogTag for Service ...
+        /// </summary>
+        private static string XLogTag = "XFileService";
+
+        /// <summary>
+        /// print a log in Console ...
+        /// </summary>
+        /// <param name="message"></param>
+        private static void Log(string message)
+        {
+            Console.WriteLine($"{XLogTag} => {message}");
+        }
+
+        /// <summary>
+        /// Adding Ai Service ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        /// <param name="lifeTime"></param>
+        private static void AddAIService(
+            this IServiceCollection services,
+            XAIServiceConfiguration configuration,
+            ServiceLifetime lifeTime = ServiceLifetime.Singleton
+        )
+        {
+            //
+            var exception = XException.InvalidArgs.ToException(); ;
+
+            //
+            // Services ...
+            var isServicesExists = !services.IsNull();
+            if (!isServicesExists)
+            {
+                //
+                Log("AddAIService failed, services not provided ...");
+                throw exception;
+            }
+
+            //
+            // Lifetime ...
+            var isLifetimeExists = !lifeTime.IsNull();
+            if (!isLifetimeExists)
+            {
+                //
+                Log("AddAIService failed, lifetime not provided ...");
+                throw exception;
+            }
+
+            //
+            // Check Dependencies Exists ...
+            var isDependenciesPassed = true;
+            if (!isDependenciesPassed)
+            {
+                //
+                Log("AddAIService failed due Dependencies Issues, not provided ...");
+                throw exception;
+            }
+
+            //
+            // Validate Configurations ...
+            var isConfigurationExists =
+                !configuration.IsNull() &&
+                configuration.IsValid();
+            if (!isConfigurationExists)
+            {
+                //
+                Log("AddAIService failed due InValid Service Configuration or not provided ...");
+                throw exception;
+            }
+
+            //
+            // Register Configurations ...
+            services.AddXAIServiceConfiguration(configuration);
+
+            //
+            // Register Services ...
+            services.Add(new ServiceDescriptor(typeof(IXAiService), typeof(XAiService), lifeTime));
+        }
+        #endregion
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Extensions\ConfigurationExtensions.cs
+
+using xAiService.Configurations;
+using xCommons.Extensions;
+
+namespace xAiService.Extensions
+{
+    public static class ModelExtensions
+    {
+        /// <summary>
+        /// Validate XAiServiceConfiguration ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <returns></returns>
+        public static bool IsValid(this XAIServiceConfiguration source)
+        {
+            //
+            bool result =
+                !source.IsNull() &&
+                !source.Url.IsNullOrEmpty() &&
+                source.Url.IsValidUrl();
+
+            //
+            return result;
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Extensions\PromptExtensions.cs
+
+using System.Collections.Generic;
+using System.Linq;
+using xAiService.Models.Dtos;
+using xCommons.Extensions;
+
+namespace xAiService.Extensions
+{
+    public static class PromptExtensions
+    {
+        /// <summary>
+        /// Get Template Params Filled Prompt ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="params"></param>
+        /// <returns></returns>
+        public static string GetMessage(
+            this XPromptDto source,
+            IDictionary<string, string> @params = null
+        )
+        {
+            //
+            var result = string.Empty;
+
+            //
+            if (!source.IsNullOrDefault() &&
+                !source.Prompt.IsNullOrEmpty()
+            )
+            {
+                result = source.Prompt;
+            }
+
+            //
+            // Check Params Conditions ...
+            if (!source.Params.IsNullOrDefault() &&
+                source.Params.HasChild() &&
+                !@params.IsNullOrDefault() &&
+                @params.HasChild()
+            )
+            {
+                //
+                // Select Params ...
+                var existsParams = source.Params
+                    .Where(p => @params.Any(pr => pr.Key == p.Name))
+                    .Distinct()
+                    .ToList();
+
+                //
+                // Replace Selected Params ...
+                existsParams
+                    .ForEach(pk =>
+                    {
+                        result = result.Replace(pk.Param, @params[pk.Name]);
+                    });
+            }
+
+            //
+            return result;
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Helpers\XPromptHelper.cs
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using xAiService.Models.Dtos;
+using xCommons.Extensions;
+
+namespace xAiService.Helpers
+{
+    public static class XPromptHelper
+    {
+        /// <summary>
+        /// Holds Initialized Prompts ...
+        /// </summary>
+        private static XPromptsDto prompts;
+
+        /// <summary>
+        /// Initialize Prompt Helper ...
+        /// </summary>
+        /// <param name="path"></param>
+        /// <exception cref="Exception"></exception>
+        /// <exception cref="InvalidDataException"></exception>
+        public static void Initialize(string path = "prompts.json")
+        {
+            //
+            // Create full Path and Check File Exists ...
+            var fullPath = Path.Combine(AppContext.BaseDirectory, path);
+            if (!File.Exists(fullPath))
+            {
+                throw new Exception($"Prompts Resources not found: {fullPath}");
+            }
+
+            //
+            // Read File as Json Text ...
+            var json = File.ReadAllText(fullPath);
+            var options = new JsonSerializerOptions
+            {
+                AllowTrailingCommas = true,
+                PropertyNameCaseInsensitive = true,
+                ReadCommentHandling = JsonCommentHandling.Skip,
+                Converters =
+                {
+                    new JsonStringEnumConverter(
+                        namingPolicy: null,
+                        allowIntegerValues: false
+                    )
+                }
+            };
+
+            //
+            // Serialized Root Object ...
+            var root = JsonSerializer.Deserialize<XPromptsDto>(json, options);
+            if (!root.IsNullOrDefault())
+            {
+                prompts = new XPromptsDto { Prompts = root.Prompts };
+            }
+        }
+
+        /// <summary>
+        /// Retrieve all Allowed Prompts as Enumerable ...
+        /// </summary>
+        /// <returns></returns>
+        public static IEnumerable<XPromptDto> GetPrompts()
+        {
+            return prompts!.Prompts.AsEnumerable();
+        }
+
+        /// <summary>
+        /// Get Specified Prompt ...
+        /// </summary>
+        /// <param name="name"></param>
+        /// <returns></returns>
+        /// <exception cref="Exception"></exception>
+        public static XPromptDto GetPrompt(string name)
+        {
+            //
+            return GetPrompts()
+                .FirstOrDefault(p => p.Name == name);
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Interfaces\IXAiService.cs
+
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.AI;
+using xAiService.Configurations;
+using xIdentityModels.Models;
+using xIdentityService.Interfaces;
+
+namespace xAiService.Interfaces
+{
+    public interface IXAiService : IXBaseIdentityHttpProvider
+    {
+        /// <summary>
+        /// XAiService Configurations ...
+        /// </summary>
+        /// <value></value>
+        XAIServiceConfiguration Configuration { get; }
+
+        //
+        #region Text Actions ...
+        /// <summary>
+        /// Generated Response ...
+        /// </summary>
+        /// <param name="prompt"></param>
+        /// <param name="userInfo"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public Task<ChatResponse> GetResponseAsync(
+            string prompt,
+            XUserClaimsInfoDto userInfo,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Generated Response ...
+        /// </summary>
+        /// <param name="prompt"></param>
+        /// <param name="userInfo"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public Task<string> GetTextResponseAsync(
+            string prompt,
+            XUserClaimsInfoDto userInfo,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Generate Text Response Stream ...
+        /// </summary>
+        /// <param name="prompt"></param>
+        /// <param name="userInfo"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<Stream> GetTextReponseStreamAsync(
+            string prompt,
+            XUserClaimsInfoDto userInfo,
+            CancellationToken cancellationToken = default
+        );
+        #endregion
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Interfaces\IXAiServiceControllerBase.cs
+
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+
+namespace xAiService.Interfaces
+{
+    public interface IXAiServiceControllerBase
+    {
+        Task<ActionResult<string>> Ask(
+            [FromQuery] string prompt,
+            CancellationToken cancellationToken = default
+        );
+        
+        Task<ActionResult> AskStream(
+            [FromQuery] string prompt,
+            CancellationToken cancellationToken = default
+        );        
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Models\Dtos\XPromptsDto.cs
+
+namespace xAiService.Models.Dtos
+{
+    /// <summary>
+    /// Described Prompts in app ...
+    /// </summary>
+    public class XPromptsDto
+    {
+        public XPromptDto[] Prompts { get; set; } = [];
+    }
+
+    /// <summary>
+    /// a Single Prompt Description ...
+    /// </summary>
+    public class XPromptDto
+    {
+        /// <summary>
+        /// Prompt Name ...
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Prompt Template Message ...
+        /// </summary>
+        public string Prompt { get; set; }
+
+        /// <summary>
+        /// Prompt Description ...
+        /// </summary>
+        public string Description { get; set; }
+
+        /// <summary>
+        /// Describe Prompt Params ...
+        /// </summary>
+        public virtual XPromptParamDto[] Params { get; set; } = null;
+    }
+
+    /// <summary>
+    /// Prompt Param used to Fill dynamic Datas to Specified Prompts ...
+    /// </summary>
+    public class XPromptParamDto
+    {
+        /// <summary>
+        /// Param Name ...
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Parma Identifier ...
+        /// </summary>
+        public string Param { get; set; }
+
+        /// <summary>
+        /// Param Description ...
+        /// </summary>
+        public string Description { get; set; }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xAiService\Services\XAiService.cs
+
+using System.Collections.Generic;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.Logging;
+using xAiService.Configurations;
+using xAiService.Constants;
+using xAiService.Interfaces;
+using xCommons.Providers;
+using xHttpService.Constants;
+using xIdentityModels.Models;
+using xIdentityService.Interfaces;
+using xIdentityService.Providers;
+
+namespace xAiService.Services
+{
+    public class XAiService : XBaseIdentityHttpProvider, IXAiService
+    {
+        /// <summary>
+        /// XAiService Configurations ...
+        /// </summary>
+        /// <value></value>
+        public XAIServiceConfiguration Configuration { get; }
+
+        public XAiService(
+            ILogger<XAiService> logger,
+            IXTokenProvider tokenProvider,
+            IXIdentityProvider identityProvider,
+            XAIServiceConfiguration configuration,
+            XValidationProvider validationProvider
+        ) : base(
+            configuration.Url,
+            logger,
+            configuration.XPoweredValue,
+            configuration.DefaultClientTimeout,
+            tokenProvider,
+            identityProvider,
+            validationProvider
+        )
+        { }
+
+        //
+        #region Text Actions ...
+        /// <summary>
+        /// Generated Response ...
+        /// </summary>
+        /// <param name="prompt"></param>
+        /// <param name="userInfo"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public Task<ChatResponse> GetResponseAsync(
+            string prompt,
+            XUserClaimsInfoDto userInfo,
+            CancellationToken cancellationToken = default
+        )
+        {
+            throw new System.NotImplementedException();
+        }
+
+        /// <summary>
+        /// Generated Response ...
+        /// </summary>
+        /// <param name="prompt"></param>
+        /// <param name="userInfo"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task<string> GetTextResponseAsync(
+            string prompt,
+            XUserClaimsInfoDto userInfo,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            // Validate Args ...
+            ValidationProvider.NotEmpty(prompt);
+
+            //
+            var client = GetRestClient(userInfo);
+            var request = GetRestRequet(
+                endpoint: XAiApiEndpoint.Ask,
+                addXPoweredValue: true,
+                queryStrings: new Dictionary<string, string>
+                {
+                    { XAiApiQueryParams.Prompt, prompt }
+                }
+            );
+
+            //
+            var response = await RunRestRequest<string>(
+                client,
+                request,
+                XHttpMethod.GET,
+                cancellationToken: cancellationToken
+            );
+
+            //
+            return response;
+        }
+
+        /// <summary>
+        /// Generate Text Response Stream ...
+        /// </summary>
+        /// <param name="prompt"></param>
+        /// <param name="userInfo"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task<Stream> GetTextReponseStreamAsync(
+            string prompt,
+            XUserClaimsInfoDto userInfo,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            // Validate Args ...
+            ValidationProvider
+                .GroupValidationBuilder()
+                .AddNotEmpty(prompt)
+                .AddNotNull(userInfo)
+                .AddNotZero(userInfo.ExpiresAt)
+                .AddNotEmpty(userInfo.AccessToken)
+                .AddNotEmpty(userInfo.RefreshToken)
+                .ValidateGroup();
+
+            //
+            var tokens = ToTokenResponse(userInfo);
+            var result = await StreamData(
+                tokens: tokens,
+                addXPoweredValue: true,
+                endpoint: XAiApiEndpoint.Stream,
+                cancellationToken: cancellationToken,
+                queryStrings: new Dictionary<string, string>
+                {
+                    { XAiApiQueryParams.Prompt, prompt }
+                }
+            );
+
+            //
+            return result;
+        }
+        #endregion
+    }
+}

Documents/GeneratedContext/xDashboard-xExceptions-20260807_230202.txt

@@ -0,0 +1,253 @@
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xExceptions\Attributes\StringValueAttribute.cs
+
+using System;
+
+namespace xExceptions.Attributes
+{
+    /// <summary>
+    /// an attribute which attached to enums to carry propper string
+    /// </summary>
+    public partial class StringValueAttribute : System.Attribute {
+        public string StringValue { get; set; }
+
+        public StringValueAttribute (string value) {
+            this.StringValue = value;
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xExceptions\Constants\XException.cs
+
+using xExceptions.Attributes;
+
+namespace xExceptions.Constants
+{
+    public enum XException {
+        //
+        #region Invalid Exceptions 1xx ...
+        [StringValue ("Invalid Data ...")]
+        InvalidData = 100,
+
+        //
+        [StringValue ("Invalid Date ...")]
+        InvalidDate = 101,
+
+        //
+        [StringValue ("Bad Request ...")]
+        BadRequest = 102,
+
+        //
+        [StringValue ("Invalid Args ...")]
+        InvalidArgs = 103,
+
+        //
+        [StringValue ("Invalid Message ...")]
+        InvalidMessage = 104,
+
+        //
+        [StringValue ("Invalid Token ...")]
+        InvalidToken = 105,
+
+        //
+        [StringValue ("Invalid Verification Code ...")]
+        InvalidVerificationCode = 106,
+
+        //
+        [StringValue ("Invalid Email Address ...")]
+        InvalidEmailAddress = 107,
+
+        //
+        [StringValue ("Invalid Mobile Number ...")]
+        InvalidMobileNumber = 108,
+
+        //
+        [StringValue ("Invalid Password ...")]
+        InvalidPassword = 109,
+
+        //
+        [StringValue ("Inavlid Url ...")]
+        InavlidUrl = 110,
+
+        //
+        [StringValue ("Invalid Device ...")]
+        InvalidDevice = 111,
+
+        //
+        [StringValue ("Invalid Profile Image ...")]
+        InvalidProfileImage = 112,
+
+        //
+        [StringValue ("Invalid File ...")]
+        InavlidFile = 113,
+
+        //
+        [StringValue ("Invalid Username ...")]
+        InvalidUserName = 114,
+        #endregion
+
+        //
+        #region Not (...) Exceptions 2xx ...
+        //
+        [StringValue ("Not Found ...")]
+        NotFound = 200,
+
+        //
+        [StringValue ("Not Allowed ...")]
+        NotAllowed = 201,
+
+        //
+        [StringValue ("Not Authorized ...")]
+        NotAuthorized = 202,
+
+        //
+        [StringValue ("Not Visible ...")]
+        NotVisible = 203,
+        #endregion
+
+        //
+        #region User/Registration/Account/Bann Exceptions 3xx ...
+        //
+        [StringValue ("Account Locked out Until:{0}")]
+        AccountLockedOut = 300,
+
+        //
+        [StringValue ("Login Failed ...")]
+        LoginFailed = 301,
+
+        //
+        [StringValue ("User Registered Before ...")]
+        UserRegisteredBefore = 302,
+
+        //
+        [StringValue ("User Disabled ...")]
+        UserDisabled = 303,
+        //
+        [StringValue ("Device Banned Until:{0}")]
+        DeviceBanned = 304,
+
+        //
+        [StringValue ("You can't Request Verification code Until:{0}")]
+        VerificationCodeResendNotAllowed = 305,
+
+        //
+        [StringValue ("Passwords Same ...")]
+        PasswordsSame = 306,
+
+        // 
+        [StringValue ("Mobiles Same ...")]
+        MobilesSame = 307,
+
+        // 
+        [StringValue ("Emails Same ...")]
+        EmailsSame = 308,
+
+        //
+        [StringValue ("Mobile In Used ...")]
+        MobileInUsed = 309,
+
+        //
+        [StringValue ("Email In Used ...")]
+        EmailInUsed = 310,
+
+        //
+        [StringValue ("Mobile Not Confirmed ...")]
+        MobileNotConfirmed = 311,
+
+        //
+        [StringValue ("Email Not Confirmed ...")]
+        EmailNotConfirmed = 312,
+
+        //
+        [StringValue ("Post Banned ...")]
+        PostBanned = 313,
+
+        //
+        [StringValue ("User Banned ...")]
+        UserBanned = 314,
+        #endregion
+
+        //
+        #region General Exceptions 4xx ...
+        //
+        [StringValue ("Unknown Error ...")]
+        Unknown = 400,
+
+        //
+        [StringValue ("Duplicate ...")]
+        Duplicate = 401,
+
+        //
+        [StringValue ("Action Failed ...")]
+        ActionFailed = 402,
+
+        //
+        [StringValue ("Expired Date ...")]
+        ExpiredDate = 403,
+
+        //
+        [StringValue ("Unavailable ...")]
+        Unavailable = 404,
+
+        //
+        [StringValue ("Max Allowed Tag Exceeded ...")]
+        MaxAllowedTagExceeded = 405,
+
+        //
+        [StringValue ("Timed out ...")]
+        Timeout = 406,
+        #endregion
+
+        //
+        #region File Exceptions 5xx ...
+        //
+        [StringValue ("Empty File ...")]
+        EmptyFile = 500,
+
+        //
+        [StringValue ("max File size exceeded ...")]
+        MaxFileSizeExceeded = 501,
+
+        //
+        [StringValue ("Unsupported File Type ...")]
+        UnsupportedFileType = 502,
+
+        //
+        [StringValue ("Max Allowed Media Exceeded ...")]
+        MaxAllowedMediaExceeded = 503,
+        #endregion
+
+        //
+        #region Configuration Exceptions 6xx ...
+        //
+        [StringValue ("Invalid Configuration ...")]
+        InvalidConfiguration = 600,
+
+        //
+        [StringValue ("Storage Service Initiallization Failed ...")]
+        StorageServiceInitialFailed = 601,
+
+        //
+        [StringValue ("Message Service Initialization Failed ...")]
+        MessageServiceInitialFailed = 602,
+        #endregion
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xExceptions\Models\XError.cs
+
+namespace xExceptions.Models {
+    public partial class XError {
+        /// <summary>
+        /// th ID of Error
+        /// </summary>
+        /// <value></value>
+        public int Id { get; set; }
+
+        /// <summary>
+        /// the String Value of Error
+        /// </summary>
+        /// <value></value>
+        public string Message { get; set; }
+    }
+}

Documents/GeneratedContext/xDashboard-xHttpService-20260807_230321.txt

@@ -0,0 +1,609 @@
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xHttpService\Configurations\XHttpServiceConfiguration.cs
+
+namespace xHttpService.Configurations {
+    public partial class XHttpServiceConfiguration {
+        /// <summary>
+        /// Determines Http Handler Check SSL or not ...
+        /// </summary>
+        /// <value></value>
+        public bool DisableSSLCheck { get; set; }
+        public int DefaultClientTimeout { get; set; } = 360;
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xHttpService\Constants\ConfigurationNodeNames.cs
+
+namespace xHttpService.Constants {
+    public partial struct ConfigurationNodeNames {
+        public const string HTTP_SERVICE_NODE_NAME = "HttpServiceConfiguration";
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xHttpService\Constants\XHttpMethod.cs
+
+using xExceptions.Attributes;
+
+namespace xHttpService.Constants {
+    public enum XHttpMethod {
+        [StringValue ("GET")]
+        GET,
+
+        [StringValue ("POST")]
+        POST,
+
+        [StringValue ("PUT")]
+        PUT,
+
+        [StringValue ("DELETE")]
+        DELETE
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xHttpService\DI\XDIHelperExtension.cs
+
+using System;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using xCommons.Extensions;
+using xHttpService.Configurations;
+using xHttpService.Constants;
+using xHttpService.Interfaces;
+using xHttpService.Providers;
+
+namespace xHttpService.DI {
+    public static partial class XDIHelperExtension {
+        /// <summary>
+        /// Retrieve XHttpService Configuration from AppSettings
+        /// </summary>
+        /// <param name="configuration"></param>
+        /// <returns></returns>
+        public static XHttpServiceConfiguration GetXHttpServiceConfiguration (this IConfiguration configuration) {
+            //
+            var xHttpSection = configuration.GetSection (ConfigurationNodeNames.HTTP_SERVICE_NODE_NAME);
+            return xHttpSection.Get<XHttpServiceConfiguration> ();
+        }
+
+        /// <summary>
+        /// Register XHttpService Configuration
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        public static void AddXHttpServiceConfiguration (
+            this IServiceCollection services,
+            IConfiguration configuration
+        ) {
+            //
+            var httpServiceConfiguration = configuration.GetXHttpServiceConfiguration ();
+            services.AddXHttpServiceConfiguration(httpServiceConfiguration);
+        }
+
+        /// <summary>
+        /// Register XHttpService Configuration
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        public static void AddXHttpServiceConfiguration (
+            this IServiceCollection services,
+            XHttpServiceConfiguration configuration
+        ) {
+            //
+            if (configuration.IsNull ()) {
+                Console.WriteLine($"xHttpService: there is no provided configurations, using default ...");
+                configuration = new XHttpServiceConfiguration ();
+            }
+
+            //
+            services.AddSingleton<XHttpServiceConfiguration> (configuration);
+        }
+
+        /// <summary>
+        /// Register XHttpService on DI ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        public static void AddXHttpService (
+            this IServiceCollection services,
+            IConfiguration configuration
+        ) {
+            //
+            // Register Service Configuration ...
+            if (services.GetRegisteredService<XHttpServiceConfiguration> ().IsNull ()) {
+                services.AddXHttpServiceConfiguration (configuration);
+            }
+
+            //
+            // Register Service ...
+            services.AddSingleton<IXHttpProvider, XHttpProvider> ();
+        }
+
+        /// <summary>
+        /// Register XHttpService on DI ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        public static void AddXHttpService (
+            this IServiceCollection services,
+            XHttpServiceConfiguration configuration
+        ) {
+            //
+            // Register Service Configuration ...
+            if (services.GetRegisteredService<XHttpServiceConfiguration> ().IsNull ()) {
+                services.AddXHttpServiceConfiguration (configuration);
+            }
+
+            //
+            // Register Service ...
+            services.AddSingleton<IXHttpProvider, XHttpProvider> ();
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xHttpService\Extensions\RestSharpExtensions.cs
+
+using System.ComponentModel.DataAnnotations;
+using AutoMapper.Mappers;
+using RestSharp;
+using xCommons.Constants;
+using xCommons.Extensions;
+using xModels.Dtos;
+
+namespace xHttpService.Extensions
+{
+    public static partial class RestSharpExtensions
+    {
+        /// <summary>
+        /// Attach an instance of XQuery to a RestRequest object
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="query"></param>
+        /// <returns></returns>
+        public static RestRequest AttachXQuery(
+            this RestRequest source,
+            XQuery query
+        )
+        {
+            //
+            if (query.IsNull())
+            {
+                return source;
+            }
+
+            //
+            // ContainsDetail ...
+            //
+            var containsDetailKey = System.Uri.EscapeDataString(nameof(query.ContainsDetail));
+            var containsDetailValue = query.ContainsDetail.AsHttpParamString();
+            source.AddQueryParameter(containsDetailKey, containsDetailValue);
+
+            //
+            // IsAscending ...
+            var isAscendingKey = System.Uri.EscapeDataString(nameof(query.IsAscending));
+            var isAscendingValue = query.IsAscending.AsHttpParamString();
+            source.AddQueryParameter(isAscendingKey, isAscendingValue);
+
+            //
+            // Filter ...
+            if (!query.Filter.IsNullOrEmpty())
+            {
+                //
+                var key = System.Uri.EscapeDataString(nameof(query.Filter));
+                var value = query.Filter.AsHttpParamString();
+                source.AddQueryParameter(key, value);
+            }
+
+            //
+            // SortBy ...
+            if (!query.SortBy.IsNullOrEmpty())
+            {
+                //
+                var key = System.Uri.EscapeDataString(nameof(query.SortBy));
+                var value = query.SortBy.AsHttpParamString();
+                source.AddQueryParameter(key, value);
+            }
+
+            //
+            // Page ...
+            if (query.Page > 0)
+            {
+                //
+                var key = System.Uri.EscapeDataString(nameof(query.Page));
+                var value = query.Page.AsHttpParamString();
+                source.AddQueryParameter(key, value);
+            }
+
+            //
+            // PageSize ...
+            if (query.PageSize > 0)
+            {
+                //
+                var key = System.Uri.EscapeDataString(nameof(query.PageSize));
+                var value = query.PageSize.AsHttpParamString();
+                source.AddQueryParameter(key, value);
+            }
+
+            //
+            return source;
+        }
+
+        /// <summary>
+        /// Add Dest User to Query Strings ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="destUser"></param>
+        /// <returns></returns>
+        public static RestRequest AttachDestUser(
+            this RestRequest source,
+            string destUser
+        )
+        {
+            //
+            if (destUser.IsNullOrEmpty())
+            {
+                return source;
+            }
+
+            //
+            var destUserKey = System.Uri.EscapeDataString(nameof(destUser));
+            var destUserValue = destUser.AsHttpParamString();
+            source.AddQueryParameter(destUserKey, destUserValue);
+
+            //
+            return source;
+        }
+
+        /// <summary>
+        /// Add XPoweredBy Header to specific RestRequest Headers ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="poweredByValue"></param>
+        /// <returns></returns>
+        public static RestRequest AddXPoweredBy(
+            this RestRequest source,
+            string poweredByValue
+        )
+        {
+            //
+            source.AddHeader(
+                XAuthorization.XPoweredBy,
+                poweredByValue
+            );
+
+            //
+            return source;
+        }
+
+        /// <summary>
+        /// Add XAccessToken Header to specific RestRequest Headers ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="poweredByValue"></param>
+        /// <returns></returns>
+        public static RestRequest AddXAccessToken(
+            this RestRequest source,
+            string token
+        )
+        {
+            //
+            token = $"{XAuthentication.BEARER} {token}";
+
+            //
+            source.AddHeader(
+                XAuthorization.Header,
+                token
+            );
+
+            //
+            return source;
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xHttpService\Interfaces\IXHttpProvider.cs
+
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Threading.Tasks;
+using RestSharp;
+using xHttpService.Constants;
+using xIdentityModels.Models;
+
+namespace xHttpService.Interfaces {
+    public partial interface IXHttpProvider {
+        HttpClient GetHttpClient ();
+        RestClient GetRestClient (
+            string baseUrl = null,
+            string poweredByValue = null,
+            XTokenResponse tokens = null
+        );
+        RestRequest GetRestRequet (
+            string endpoint,
+            IDictionary<string, string> @params = null,
+            IDictionary<string, string> headers = null,
+            IDictionary<string, string> queryStrings = null
+        );
+        Task<T> RunRestRequest<T> (
+            RestClient client,
+            RestRequest request,
+            XHttpMethod method
+        );
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xHttpService\Providers\XHttpProvider.cs
+
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging;
+using RestSharp;
+using RestSharp.Authenticators;
+using xCommons.Constants;
+using xCommons.Extensions;
+using xExceptions.Constants;
+using xHttpService.Configurations;
+using xHttpService.Constants;
+using xHttpService.Interfaces;
+using xIdentityModels.Models;
+using xModels.Base;
+
+namespace xHttpService.Providers {
+    public partial class XHttpProvider : XBaseClass, IXHttpProvider {
+
+        private readonly XHttpServiceConfiguration configuration;
+
+        public XHttpProvider (
+            ILoggerFactory loggerFactory,
+            XHttpServiceConfiguration configuration
+        ) : base (loggerFactory) {
+            this.configuration = configuration;
+        }
+
+        //
+        #region Actions ...
+        /// <summary>
+        /// Get an Instance of Http Client 
+        /// </summary>
+        /// <returns></returns>
+        public HttpClient GetHttpClient () {
+            //
+            HttpClient httpClient = null;
+            httpClient = new HttpClient ();
+
+            //
+            if (configuration.DisableSSLCheck) {
+                //
+                var httpHandler = new HttpClientHandler ();
+                httpHandler.ServerCertificateCustomValidationCallback = (sender, certificate, chain, sslPolicyErrors) => true;
+
+                //
+                httpClient = new HttpClient (httpHandler);
+            }
+
+            //
+            // Set Timeout ...
+            httpClient.Timeout = TimeSpan
+                .FromSeconds (configuration.DefaultClientTimeout);
+
+            //
+            return httpClient;
+        }
+
+        /// <summary>
+        /// Get an Instance of RestClient
+        /// </summary>
+        /// <param name="baseUrl"></param>
+        /// <param name="poweredByValue"></param>
+        /// <param name="tokens"></param>
+        /// <returns></returns>
+        public RestClient GetRestClient (
+            string baseUrl = null,
+            string poweredByValue = null,
+            XTokenResponse tokens = null
+        ) {
+            //
+            var client = new RestClient (baseUrl);
+
+            //
+            // Add XPowered By to Default Headers ...
+            if (!poweredByValue.IsNullOrEmpty ()) {
+                client.AddDefaultHeader (XAuthorization.XPoweredBy, poweredByValue);
+            }
+
+            //
+            // Set Authenticator ...
+            if (!tokens.IsNull () &&
+                !tokens.AccessToken.IsNullOrEmpty ()) {
+                client.Authenticator = new JwtAuthenticator (tokens.AccessToken);
+            }
+
+            //
+            // Refresh Token ...
+            if (!tokens.IsNull () &&
+                !tokens.RefreshToken.IsNullOrEmpty ()) {
+                client.AddDefaultHeader (XAuthorization.RefreshToken, tokens.RefreshToken);
+            }
+
+            //
+            // ExpiresAt ...
+            if (!tokens.IsNull () &&
+                tokens.ExpiresAt > 0) {
+                client.AddDefaultHeader (XAuthorization.ExpiresAt, tokens.ExpiresAt.AsHttpParamString ());
+            }
+
+            //
+            // Set Default Timeout ...
+            client.Timeout = configuration.DefaultClientTimeout;
+
+            //
+            // SSL Validation Handler ...
+            if (configuration.DisableSSLCheck) {
+                client.RemoteCertificateValidationCallback = (sender, cert, chain, sslPolicyErrors) => true;
+            }
+
+            //
+            return client;
+        }
+
+        /// <summary>
+        /// Get an Instance of RestRequest 
+        /// </summary>
+        /// <param name="endpoint"></param>
+        /// <param name="params"></param>
+        /// <param name="headers"></param>
+        /// <param name="queryStrings"></param>
+        /// <returns></returns>
+        public RestRequest GetRestRequet (
+            string endpoint,
+            IDictionary<string, string> @params = null,
+            IDictionary<string, string> headers = null,
+            IDictionary<string, string> queryStrings = null
+        ) {
+            //
+            var url = endpoint.ToString ();
+
+            //
+            // Add Route Payloads ...
+            if (!@params.IsNull () && @params.Count > 0) {
+                //
+                var enumerator = @params.GetEnumerator ();
+                while (enumerator.MoveNext ()) {
+                    //
+                    var item = enumerator.Current;
+
+                    //
+                    url = url.Replace (item.Key, item.Value.ToUrlEncoded ());
+                }
+            }
+
+            //
+            // Add Query Strings ...
+            if (!queryStrings.IsNull () && queryStrings.Count > 0) {
+                //
+                url = $"{url}?";
+                var enumerator = queryStrings.GetEnumerator ();
+                while (enumerator.MoveNext ()) {
+                    //
+                    var item = enumerator.Current;
+
+                    //
+                    url += $"{item.Key}={item.Value.ToUrlEncoded ()}&";
+                }
+
+                //
+                // remove lates & ...
+                if (url.EndsWith ("&")) {
+                    url = url.Substring (0, url.Length - 1);
+                }
+            }
+
+            //
+            // Create request ...
+            var request = new RestRequest (url, DataFormat.Json);
+
+            //
+            // Add Headers to request ...
+            if (!headers.IsNull () && headers.Count > 0) {
+                //
+                var enumerator = headers.GetEnumerator ();
+                while (enumerator.MoveNext ()) {
+                    //
+                    var item = enumerator.Current;
+                    request.AddHeader (item.Key, item.Value);
+                }
+            }
+
+            //
+            return request;
+        }
+
+        /// <summary>
+        /// Handle Call Specific Request and retrieve Response
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="method"></param>
+        /// <typeparam name="T"></typeparam>
+        /// <returns></returns>
+        public async Task<T> RunRestRequest<T> (
+            RestClient client,
+            RestRequest request,
+            XHttpMethod method
+        ) {
+            //
+            var response = await Task.Run (() => {
+                //
+                IRestResponse resp = null;
+
+                //
+                // Call Endpoint Service using Specified Method ...
+                switch (method) {
+                    //
+                    // Get ...
+                    case XHttpMethod.GET:
+                        resp = client.Get (request);
+                        break;
+
+                        //
+                        // Put ...
+                    case XHttpMethod.PUT:
+                        resp = client.Put (request);
+                        break;
+
+                        //
+                        // Post ...
+                    case XHttpMethod.POST:
+                        resp = client.Post (request);
+                        break;
+
+                        //
+                        // Delete ...
+                    case XHttpMethod.DELETE:
+                        resp = client.Delete (request);
+                        break;
+                }
+
+                //
+                if (!resp.IsSuccessful) {
+                    //
+                    // UnAuthorized ...
+                    if (resp.StatusCode == System.Net.HttpStatusCode.Unauthorized) {
+                        XException.NotAuthorized.Throw ();
+                    }
+
+                    //
+                    // NotFound ...
+                    if (resp.StatusCode == System.Net.HttpStatusCode.NotFound) {
+                        XException.NotFound.Throw ();
+                    }
+
+                    //
+                    // Timeout ...
+                    if (!resp.ErrorMessage.IsNullOrEmpty () &&
+                        resp.ErrorMessage.Contains ("timed out")) {
+                        XException.Timeout.Throw ();
+                    }
+
+                    //
+                    // ErrorMessage ...
+                    if (!resp.ErrorMessage.IsNullOrEmpty ()) {
+                        throw new Exception (resp.ErrorMessage);
+                    }
+
+                    //
+                    // Default Exception ...
+                    XException.BadRequest.Throw ();
+                }
+
+                //
+                var result = resp.Content.FromJSON<T> ();
+                return result;
+            });
+
+            //
+            return response;
+        }
+        #endregion
+    }
+}

Documents/GeneratedContext/xDashboard-xMessageService-20260807_230406.txt

@@ -0,0 +1,724 @@
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Constants\ConfigurationNodeNames.cs
+
+namespace xMessageService.Constants {
+    public partial struct ConfigurationNodeNames {
+        public const string MESSAGE_NODE_NAME = "MessageConfiguration";
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Constants\xMessageServiceConstants.cs
+
+namespace xMessageService.Constants {
+    public struct xMessageServiceConstants {
+        public const string DEFAULT_EMPTY_PROVIDER = "EMPTY";
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\DI\XDIHelperExtension.cs
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using xCommons.Extensions;
+using xMessageService.Constants;
+using xMessageService.Interfaces;
+using xMessageService.Models;
+using xMessageService.Providers;
+
+namespace xMessageService.DI {
+    public static partial class XDIHelperExtension {
+        /// <summary>
+        /// Retrieve XMessage Configuration from App Settings 
+        /// </summary>
+        /// <param name="config"></param>
+        /// <returns></returns>
+        public static XMessageConfiguration GetXMessageConfiguration (this IConfiguration config) {
+            //
+            var xMessageConfigSection = config.GetSection (ConfigurationNodeNames.MESSAGE_NODE_NAME);
+            var xMessageConfiguration = xMessageConfigSection.Get<XMessageConfiguration> ();
+
+            //
+            var defaultMailConfiguration = new Dictionary<string, XMailConfiguration> {
+                    ["EMPTY"] =
+                    new XMailConfiguration {
+                    Title = xMessageServiceConstants.DEFAULT_EMPTY_PROVIDER,
+                    Host = "",
+                    Port = 25,
+                    EnableSsl = false,
+                    Username = "",
+                    Password = ""
+                    }
+                };
+
+            //
+            var defaultSmsConfiguration = new Dictionary<string, XSmsConfiguration> {
+                    ["EMPTY"] =
+                    new XSmsConfiguration {
+                    ServiceUrl = "",
+                    Username = "",
+                    Password = "",
+                    LineNumber = "",
+                    UserApiKey = "",
+                    SecretKey = "",
+                    }
+                };
+
+            //
+            if (xMessageConfiguration.IsNull ()) {
+                //
+                xMessageConfiguration = new XMessageConfiguration {
+                    DefaultSMSProvider = xMessageServiceConstants.DEFAULT_EMPTY_PROVIDER,
+                    DefaultMailProvider = xMessageServiceConstants.DEFAULT_EMPTY_PROVIDER,
+                    MailConfigurations = defaultMailConfiguration,
+                    SmsConfigurations = defaultSmsConfiguration
+                };
+
+                //
+                // Warn Message is Default Configuration ...
+                Console.WriteLine ($"IMPORTANT: xMessageService Configuration is Default, so the Service can't works properly ...");
+            }
+
+            //
+            // Handle Default Mail Provider ...
+            if (xMessageConfiguration.DefaultMailProvider.IsNullOrEmpty ()) {
+                //
+                if (xMessageConfiguration.IsNull () ||
+                    //
+                    xMessageConfiguration.MailConfigurations.IsNull () ||
+                    xMessageConfiguration.MailConfigurations.Count == 0) {
+                    //
+                    Console.WriteLine ("There is no defined Mail Provider Configurations ...");
+                    xMessageConfiguration.DefaultMailProvider = xMessageServiceConstants.DEFAULT_EMPTY_PROVIDER;
+                }
+
+                //
+                if (xMessageConfiguration.DefaultMailProvider == xMessageServiceConstants.DEFAULT_EMPTY_PROVIDER) {
+                    xMessageConfiguration.MailConfigurations = defaultMailConfiguration;
+                } else {
+                    xMessageConfiguration.DefaultMailProvider = xMessageConfiguration.MailConfigurations.Keys.First ();
+                }
+            }
+
+            //
+            // Handle Default SMS Provider ...
+            if (xMessageConfiguration.DefaultSMSProvider.IsNullOrEmpty ()) {
+                //
+                if (xMessageConfiguration.IsNull () ||
+                    xMessageConfiguration.SmsConfigurations.IsNull () ||
+                    xMessageConfiguration.SmsConfigurations.Count == 0) {
+                    //
+                    Console.WriteLine ("There is no defined SMS Provider Configurations ...");
+                    xMessageConfiguration.DefaultSMSProvider = xMessageServiceConstants.DEFAULT_EMPTY_PROVIDER;
+                }
+
+                //
+                if (xMessageConfiguration.DefaultSMSProvider == xMessageServiceConstants.DEFAULT_EMPTY_PROVIDER) {
+                    xMessageConfiguration.SmsConfigurations = defaultSmsConfiguration;
+                } else {
+                    xMessageConfiguration.DefaultSMSProvider = xMessageConfiguration.SmsConfigurations.Keys.First ();
+                }
+            }
+
+            //
+            return xMessageConfiguration;
+        }
+
+        /// <summary>
+        /// Register XMessage Service 
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="config"></param>
+        public static void AddXMessageService (this IServiceCollection services, IConfiguration config) {
+            //
+            var xMessageConfiguration = config.GetXMessageConfiguration ();
+            services.AddSingleton<XMessageConfiguration> (xMessageConfiguration);
+
+            //
+            // Register SMS Service ...
+            var xSmsService = new XSmsService (
+                xMessageConfiguration.DefaultSMSProvider,
+                xMessageConfiguration.SmsConfigurations
+            );
+            services.AddSingleton<IXSmsService> (xSmsService);
+
+            //
+            // Register Mail Service ...
+            var xMailService = new XMailService (
+                xMessageConfiguration.DefaultMailProvider,
+                xMessageConfiguration.MailConfigurations
+            );
+            services.AddSingleton<IXMailService> (xMailService);
+
+            //
+            // Register MEssage Provider ...
+            services.AddSingleton<IXMessageProvider, XMessageProvider> ();
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Interfaces\IXMailService.cs
+
+using System.Threading.Tasks;
+using xMessageService.Models;
+
+namespace xMessageService.Interfaces {
+    public partial interface IXMailService {
+        Task SendMailAsync (
+            XMessage message,
+            string provider = null
+        );
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Interfaces\IXMessageProvider.cs
+
+using System;
+using System.Threading.Tasks;
+using xMessageService.Models;
+
+namespace xMessageService.Interfaces {
+    public partial interface IXMessageProvider {
+        bool IsReady (
+            bool? checkMailService = false,
+            bool? checkSmsService = false
+        );
+
+        Task SendMailAsync (
+            XMessage message,
+            string provider = null,
+            bool throwException = true,
+            Exception exception = null
+        );
+
+        Task SendSmsAsync (
+            XMessage message,
+            string provider = null,
+            bool throwException = true,
+            Exception exception = null
+        );
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Interfaces\IXSmsService.cs
+
+using System.Threading.Tasks;
+using xMessageService.Models;
+
+namespace xMessageService.Interfaces {
+    public partial interface IXSmsService {
+        Task SendSmsAsync (
+            XMessage message,
+            string provider = null
+        );
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Models\XMailConfiguration.cs
+
+namespace xMessageService.Models {
+    public partial class XMailConfiguration {
+        public string Title { get; set; }
+        public string Host { get; set; }
+        public int Port { get; set; }
+        public bool EnableSsl { get; set; }
+        public string Username { get; set; }
+        public string Password { get; set; }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Models\XMessage.cs
+
+using System.Collections.Generic;
+using xModels.Base;
+
+namespace xMessageService.Models {
+    public partial class XMessage : XBaseDto {
+        public HashSet<string> Recievers { get; set; } = new HashSet<string> ();
+        public string Message { get; set; }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Models\XMessageConfiguration.cs
+
+using System.Collections.Generic;
+
+namespace xMessageService.Models {
+    public partial class XMessageConfiguration {
+        public string DefaultSMSProvider { get; set; }
+        public string DefaultMailProvider { get; set; }
+        public IDictionary<string, XMailConfiguration> MailConfigurations { get; set; }
+        public IDictionary<string, XSmsConfiguration> SmsConfigurations { get; set; }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Models\XSmsConfiguration.cs
+
+namespace xMessageService.Models {
+    public partial class XSmsConfiguration {
+        public string ServiceUrl { get; set; }
+        public string Username { get; set; }
+        public string Password { get; set; }
+        public string LineNumber { get; set; }
+        public string UserApiKey { get; set; }
+        public string SecretKey { get; set; }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Providers\XMailService.cs
+
+using System;
+using System.Collections.Generic;
+using System.Net;
+using System.Net.Mail;
+using System.Threading.Tasks;
+using xCommons.Extensions;
+using xExceptions.Constants;
+using xMessageService.Interfaces;
+using xMessageService.Models;
+
+namespace xMessageService.Providers {
+    public partial class XMailService : IXMailService {
+        private SmtpClient smtpClient;
+        private readonly string defaultProvider;
+        private readonly IDictionary<string, XMailConfiguration> configurations;
+
+        public XMailService (
+            string defaultProvider,
+            IDictionary<string, XMailConfiguration> configurations
+        ) {
+            this.defaultProvider = defaultProvider;
+            this.configurations = configurations;
+
+            //
+            // Get instance of SMTP Client ...
+            PrepareSmtpClient ();
+        }
+
+        public Task SendMailAsync (
+            XMessage message,
+            string provider = null
+        ) {
+            //
+            // Run Send Mail Asynchronous ...
+            return Task.Run (() => {
+                SendMail (message, provider);
+            });
+        }
+
+        #region Private ...
+        /// <summary>
+        /// Validate and Retrieve Provider Configuration for Service
+        /// </summary>
+        /// <param name="provider"></param>
+        /// <returns></returns>
+        private XMailConfiguration GetConfiguration (string provider = null) {
+            //
+            if (provider.IsNullOrEmpty ()) {
+                provider = defaultProvider;
+            }
+
+            //
+            if (!configurations.Keys.Contains (provider)) {
+                XException.MessageServiceInitialFailed.Throw ();
+            }
+
+            //
+            return configurations[provider];
+        }
+
+        /// <summary>
+        /// Prepare SMTP Client by Using Specified/Default Provider
+        /// </summary>
+        /// <param name="provider"></param>
+        private void PrepareSmtpClient (string provider = null) {
+            //
+            var config = GetConfiguration (provider);
+            if (config.IsNull()) {
+                return;
+            }
+
+            //
+            smtpClient = new SmtpClient () {
+                Host = config.Host,
+                Port = config.Port,
+                EnableSsl = config.EnableSsl,
+                UseDefaultCredentials = false,
+                Credentials = new NetworkCredential (
+                config.Username,
+                config.Password)
+            };
+        }
+
+        /// <summary>
+        /// Prepare Mail Message With Specified/Default Provider
+        /// </summary>
+        /// <param name="message"></param>
+        /// <param name="provider"></param>
+        /// <returns></returns>
+        private MailMessage PrepareMailMessage (
+            XMessage message,
+            string provider = null
+        ) {
+            //
+            if (message == null ||
+                message.Message.IsNullOrEmpty () ||
+                message.Recievers.Count == 0) {
+                XException.InvalidMessage.Throw ();
+            }
+
+            //
+            var config = GetConfiguration (provider);
+            var mailMessage = new MailMessage () {
+                From = new MailAddress (config.Username),
+                Subject = config.Title,
+                Body = message.Message
+            };
+
+            //
+            foreach (var reciever in message.Recievers) {
+                mailMessage.To.Add (reciever);
+            }
+
+            //
+            return mailMessage;
+        }
+
+        /// <summary>
+        /// Send Mail Using Specified/Default Provider
+        /// </summary>
+        /// <param name="message"></param>
+        /// <param name="provider"></param>
+        private void SendMail (
+            XMessage message,
+            string provider = null
+        ) {
+            //
+            if (smtpClient.IsNull()) {
+                //
+                Console.WriteLine ($"SMTP Error: MessageServiceInitialFailed ...");
+                XException.MessageServiceInitialFailed.Throw ();
+            }
+
+            //
+            var mailMessage = PrepareMailMessage (message, provider);
+
+            //
+            try {
+                smtpClient.Send (mailMessage);
+            } catch (Exception ex) {
+                //
+                Console.WriteLine ($"SMTP Error: {ex.Message}");
+                XException.MessageServiceInitialFailed.Throw ();
+            }
+        }
+        #endregion        
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Providers\XMessageProvider.cs
+
+using System;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging;
+using xCommons.Extensions;
+using xExceptions.Constants;
+using xMessageService.Interfaces;
+using xMessageService.Models;
+
+namespace xMessageService.Providers {
+    public partial class XMessageProvider : IXMessageProvider {
+        private readonly XMessageConfiguration configuration;
+        private readonly ILogger<XMessageProvider> logger;
+        private readonly IXSmsService smsService;
+        private readonly IXMailService mailService;
+
+        public XMessageProvider (
+            XMessageConfiguration configuration,
+            ILogger<XMessageProvider> logger,
+            IXSmsService smsService,
+            IXMailService mailService
+        ) {
+            this.configuration = configuration;
+            this.logger = logger;
+            this.smsService = smsService;
+            this.mailService = mailService;
+        }
+
+        /// <summary>
+        /// Send a Mail Message
+        /// </summary>
+        /// <param name="message"></param>
+        /// <param name="provider"></param>
+        /// <param name="throwException"></param>
+        /// <param name="exception"></param>
+        /// <returns></returns>
+        public async Task SendMailAsync (
+            XMessage message,
+            string provider = null,
+            bool throwException = true,
+            Exception exception = null
+        ) {
+            //
+            if (exception.IsNull ()) {
+                exception = XException.ActionFailed.ToException ();
+            }
+
+            //
+            try {
+                await mailService.SendMailAsync (message, provider);
+            } catch (Exception ex) {
+                //
+                logger.LogError ($"Exeption: {ex.Message}");
+
+                //
+                if (throwException) {
+                    throw exception;
+                }
+            }
+        }
+
+        /// <summary>
+        /// Send SMS Message 
+        /// </summary>
+        /// <param name="message"></param>
+        /// <returns></returns>
+        public async Task SendSmsAsync (
+            XMessage message,
+            string provider = null,
+            bool throwException = true,
+            Exception exception = null
+        ) {
+            //
+            if (exception.IsNull ()) {
+                exception = XException.ActionFailed.ToException ();
+            }
+
+            //
+            try {
+                await smsService.SendSmsAsync (message, provider);
+            } catch {
+                if (throwException) {
+                    throw exception;
+                }
+            }
+        }
+
+        /// <summary>
+        /// Check Message Provider is Ready or not
+        /// </summary>
+        /// <param name="checkMailService"></param>
+        /// <param name="checkSmsService"></param>
+        /// <returns></returns>
+        public bool IsReady (
+            bool? checkMailService = false,
+            bool? checkSmsService = false
+        ) {
+            //
+            var result = true;
+
+            //
+            // Check Mail Service ...
+            if (checkMailService.HasValue &&
+                checkMailService.GetValueOrDefault ()) {
+                result = result && mailService != null;
+            }
+
+            //
+            // Check Sms Service ...
+            if (checkSmsService.HasValue &&
+                checkSmsService.GetValueOrDefault ()) {
+                result = result && smsService != null;
+            }
+
+            //
+            return result;
+        }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xMessageService\Providers\XSmsService.cs
+
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using PhoneNumbers;
+using RestSharp;
+using xCommons.Extensions;
+using xExceptions.Constants;
+using xMessageService.Interfaces;
+using xMessageService.Models;
+
+namespace xMessageService.Providers {
+    public partial class XSmsService : IXSmsService {
+        private string serviceUrl;
+        private readonly string defaultProvider;
+        private readonly IDictionary<string, XSmsConfiguration> configurations;
+
+        public XSmsService (
+            string defaultProvider,
+            IDictionary<string, XSmsConfiguration> configurations
+        ) {
+            this.defaultProvider = defaultProvider;
+            this.configurations = configurations;
+
+            //
+            PrepareServiceUrl ();
+        }
+
+        public Task SendSmsAsync (
+            XMessage message,
+            string provider = null
+        ) {
+            //
+            // Run Send SMS Asynchronous ...
+            return Task.Run (() => {
+                SendSMS (message, provider);
+            });
+        }
+
+        #region Private ...
+        /// <summary>
+        /// Prepare Service Url for Specified/Default Provider
+        /// </summary>
+        /// <param name="provider"></param>
+        private void PrepareServiceUrl (string provider = null) {
+            //
+            if (provider.IsNullOrEmpty ()) {
+                provider = defaultProvider;
+            }
+
+            //
+            var config = GetConfiguration (provider);
+            if (config.IsNull ()) {
+                return;
+            }
+
+            //
+            serviceUrl = config.ServiceUrl;
+            serviceUrl += "&username=" + config.Username + "&password=" + config.Password + "&";
+        }
+
+        /// <summary>
+        /// Prepare Service url for Integrating XMessage by 
+        /// using Specified/Default Provider Configurations
+        /// </summary>
+        /// <param name="message"></param>
+        /// <param name="provider"></param>
+        private void PrepareSmsMessage (
+            XMessage message,
+            string provider = null
+        ) {
+            //
+            if (message == null ||
+                message.Message.IsNullOrEmpty () ||
+                message.Recievers.Count == 0) {
+                XException.InvalidMessage.Throw ();
+            }
+
+            //
+            // Validating Mobile Numbers ...
+            var phoneNumberUtil = PhoneNumbers.PhoneNumberUtil.GetInstance ();
+            var recieversList = "";
+
+            //
+            PrepareServiceUrl (provider);
+
+            //
+            foreach (var reciever in message.Recievers) {
+                try {
+                    //
+                    var mPhoneNumber = phoneNumberUtil.Parse (reciever, null);
+                    if (phoneNumberUtil.IsValidNumber (mPhoneNumber)) {
+                        //
+                        // Format Phone Numbers to the '+989120000000' pattern ...
+                        var recieverPhone = phoneNumberUtil.Format (mPhoneNumber, PhoneNumberFormat.E164);
+                        if (recieversList.Length > 0) {
+                            recieversList += ",";
+                        }
+                        recieversList += reciever;
+                    }
+                } catch { }
+            }
+
+            //
+            var config = GetConfiguration ();
+
+            //
+            // Preparing All Content and Configurations for Sending Messages ...
+            serviceUrl += "to=" +
+                recieversList +
+                "&message=" +
+                message.Message +
+                "&from=" +
+                config.LineNumber +
+                "&flash=" +
+                false;
+        }
+
+        /// <summary>
+        /// Send a Message as SMS by Specified/Default Provider
+        /// </summary>
+        /// <param name="message"></param>
+        /// <param name="provider"></param>
+        private void SendSMS (
+            XMessage message,
+            string provider = null
+        ) {
+            //
+            if (serviceUrl.IsNullOrEmpty ()) {
+                //
+                Console.WriteLine ($"SMS Error: MessageServiceInitialFailed ...");
+                XException.MessageServiceInitialFailed.Throw ();
+            }
+
+            //
+            try {
+                //
+                // preparing Service Url based on message data ...
+                PrepareSmsMessage (message, provider);
+
+                //
+                // Implementing Service Calling Using RestSharp Library ...
+                // We Select RestSharp because it supports Sync/Async Calls ...
+                var client = new RestClient (serviceUrl);
+                var request = new RestRequest (Method.POST);
+
+                //
+                // Send Request ...
+                var response = client.Execute (request);
+            } catch (Exception ex) {
+                Console.WriteLine ($"SMS Error: {ex.Message}");
+                XException.MessageServiceInitialFailed.Throw ();
+            }
+        }
+
+        /// <summary>
+        /// Validate and Retrieve Provider Configuration for Service
+        /// </summary>
+        /// <param name="provider"></param>
+        /// <returns></returns>
+        private XSmsConfiguration GetConfiguration (string provider = null) {
+            //
+            if (
+                provider.IsNullOrEmpty () ||
+                provider.ToNormalString () == "empty"
+            ) {
+                //
+                provider = defaultProvider;
+                return null;
+            }
+
+            //
+            if (!configurations.Keys.Contains (provider)) {
+                XException.MessageServiceInitialFailed.Throw ();
+            }
+
+            //
+            return configurations[provider];
+        }
+        #endregion        
+    }
+}

Documents/GeneratedContext/xDashboard-xTermsAndConditionsService-20260807_230520.txt

@@ -0,0 +1,574 @@
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Configurations\XTermsAndConditionsServiceConfiguration.cs
+
+using System.Collections.Generic;
+using xDataService.Constants;
+using xStringService.Models.Dtos;
+
+namespace xTermsAndConditionsService.Configurations
+{
+    /// <summary>
+    /// Terms and Conditions Configuration ...
+    /// </summary>
+    public class XTermsAndConditionsServiceConfiguration
+    {
+        /// <summary>
+        /// Terms And Conditions Resource Title in XString Table ...
+        /// </summary>
+        public string ResourceTitle { get; set; } = "terms_and_conditions";
+
+        /// <summary>
+        /// Seeding Mode for Terms and Conditions ...
+        /// </summary>
+        public XDbSeedingMode SeedingMode { get; set; } = XDbSeedingMode.AddIfNotExists;
+
+        /// <summary>
+        /// Default Terms and Conditions for Add to Databse on App Startup ...
+        /// </summary>
+        public List<XStringDto> TermsAndConditions { get; set; } = null;        
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Constants\ConfigurationNodeNames.cs
+
+namespace xTermsAndConditionsService.Constants
+{
+    public partial struct ConfigurationNodeNames
+    {
+        public const string TERMS_AND_CONDITIONS_SERVICE_NODE = "TermsAndConditionsService";
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Constants\XTermsAndConditionsServiceConstants.cs
+
+namespace xTermsAndConditionsService.Constants
+{
+    public struct XTermsAndConditionsServiceConstants
+    {
+        //
+        // Service Extensions Log Tag ...
+        public const string XTermsAndConditionsServiceDILogTag = "XTermsAndConditionsService";
+
+        //
+        // Table Mapping Identifiers ...
+
+        //
+        // GraphQL Collection Mappings ...
+
+        //
+        // Hubs ...
+
+        //
+        // Custome Constants ...
+
+        //
+        // EF Repositories Helper Extensions ...        
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Controllers\XTermsAndConditionsControllerBase.cs
+
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.Extensions.Logging;
+using xCommons.Configurations;
+using xCommons.Providers;
+using xIdentityService.Interfaces;
+using xStringService.Controllers;
+using xTermsAndConditionsService.Interfaces;
+
+namespace xTermsAndConditionsService.Controllers
+{
+    /// <summary>
+    /// a Base Controller Implementation for Providing Base Actions of 
+    /// Terms and Conditions Provided Actions ...
+    /// </summary>
+    [AllowAnonymous]
+    public abstract class XTermsAndConditionsControllerBase : XBaseResourceProviderControllerBase<IXTermsAndConditionsProvider>, IXTermsAndConditionsController
+    {
+        protected XTermsAndConditionsControllerBase(
+            ILogger<XTermsAndConditionsControllerBase> logger,
+            XAppConfiguration appConfiguration,
+            IXIdentityProvider identityProvider,
+            XValidationProvider validationProvider,
+            IXTermsAndConditionsProvider provider
+        ) : base(
+            logger,
+            appConfiguration,
+            identityProvider,
+            validationProvider,
+            provider
+        )
+        { }
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\DI\XDIHelperExtension.cs
+
+using System;
+using System.Linq;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using xCommons.Configurations;
+using xCommons.Extensions;
+using xExceptions.Constants;
+using xPushService.DI;
+using xPushService.Helpers;
+using xStringService.Interfaces.Dtos;
+using xTermsAndConditionsService.Configurations;
+using xTermsAndConditionsService.Constants;
+using xTermsAndConditionsService.Hubs;
+using xTermsAndConditionsService.Interfaces;
+using xTermsAndConditionsService.Providers;
+
+namespace xTermsAndConditionsService.DI
+{
+    public static class XDIHelperExtension
+    {
+        /// <summary>
+        /// Retrieve xTermsAndConditionsService Configuration from AppSettings ...
+        /// </summary>
+        /// <param name="configuration"></param>
+        /// <returns></returns>
+        public static XTermsAndConditionsServiceConfiguration GetXTermsAndConditionsServiceConfiguration(
+            this IConfiguration configuration
+        )
+        {
+            //
+            var section = configuration.GetSection(ConfigurationNodeNames.TERMS_AND_CONDITIONS_SERVICE_NODE);
+            var result = section.Get<XTermsAndConditionsServiceConfiguration>();
+
+            //
+            return result;
+        }
+
+        /// <summary>
+        /// Extract xTermsAndConditionsService Configurations from AppSettings 
+        /// and Register it in DI ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        public static void AddXTermsAndConditionsConfiguration(
+            this IServiceCollection services,
+            IConfiguration configuration
+        )
+        {
+            //
+            var serviceConfiguration = configuration.GetXTermsAndConditionsServiceConfiguration();
+            services.AddXTermsAndConditionsConfiguration(serviceConfiguration);
+        }
+
+        /// <summary>
+        /// Register xTermsAndConditionsService Configurations in DI ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration"></param>
+        public static void AddXTermsAndConditionsConfiguration(
+            this IServiceCollection services,
+            XTermsAndConditionsServiceConfiguration configuration
+        )
+        {
+            //
+            if (configuration.IsNull())
+            {
+                Log($"there is no provided configurations, using default ...");
+                configuration = new XTermsAndConditionsServiceConfiguration();
+            }
+
+            //
+            services.AddSingleton(configuration);
+        }
+
+        /// <summary>
+        /// Register TermsConditions Provider ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration">provided AppSettings Configuration</param>
+        /// <param name="lifeTime"></param>
+        public static void AddXTermsConditionsService(
+            this IServiceCollection services,
+            IConfiguration configuration,
+            ServiceLifetime lifeTime = ServiceLifetime.Transient
+        )
+        {
+            //
+            AddTermsAndConditionsService(
+                services: services,
+                lifeTime: lifeTime,
+                configuration: configuration
+            );
+        }
+
+        /// <summary>
+        /// Register TermsConditions Provider ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="configuration">provided xTermsAndConditionsService Configuration</param>
+        /// <param name="lifeTime"></param>
+        public static void AddXTermsConditionsService(
+            this IServiceCollection services,
+            XTermsAndConditionsServiceConfiguration configuration,
+            ServiceLifetime lifeTime = ServiceLifetime.Transient
+        )
+        {
+            //
+            AddTermsAndConditionsService(
+                services: services,
+                lifeTime: lifeTime,
+                serviceConfiguration: configuration
+            );
+        }
+
+        public static void UseXTermsAndConditionsService(
+            this IApplicationBuilder app
+        )
+        {
+            //
+            // Create an Scope for Services Acess ...
+            using (var scope = app.ApplicationServices.CreateScope())
+            {
+                //
+                // Inject Requirements ...
+                var stringProvider = scope.ServiceProvider.GetService<IXStringServiceProvider>();
+                var serviceConfiguration = scope.ServiceProvider.GetService<XTermsAndConditionsServiceConfiguration>();
+
+                //
+                // Using XTerms Hub ...
+                var pushHelper = new XPushServiceHelper();
+                pushHelper.AddHub<XTermsHub>("terms");
+                app.UseXPushService(pushHelper);
+
+                //
+                // Validate Requirements Exists ...
+                var isValid =
+                    !stringProvider.IsNull() &&
+                    !serviceConfiguration.IsNull() &&
+                    !serviceConfiguration.TermsAndConditions.IsNull() &&
+                    serviceConfiguration.TermsAndConditions.HasChild() &&
+                    serviceConfiguration.SeedingMode != xDataService.Constants.XDbSeedingMode.None;
+                if (isValid)
+                {
+                    //
+                    // Prepare Default Terms ...
+                    serviceConfiguration
+                        .TermsAndConditions
+                        .ToList()
+                        .ForEach(t => t.ResourceTitle = serviceConfiguration.ResourceTitle);
+
+                    //
+                    // Loop through Terms and Conditions for Seeding ...
+                    foreach (var item in serviceConfiguration.TermsAndConditions)
+                    {
+                        //
+                        // Detect Exists Item ...
+                        var exists = stringProvider.FindOneAsync(
+                            predicate: x =>
+                                x.Language == item.Language &&
+                                x.ResourceTitle == item.ResourceTitle
+                        )
+                        .GetAwaiter()
+                        .GetResult();
+
+                        //
+                        var isExists = !exists.IsNullOrDefault();
+
+                        //
+                        switch (serviceConfiguration.SeedingMode)
+                        {
+                            //
+                            case xDataService.Constants.XDbSeedingMode.AddOrUpdate:
+                                //
+                                // Update Exists by new Provided ...
+                                exists.TranslatedValue = item.TranslatedValue;
+                                exists = stringProvider.UpdateAsync(
+                                    id: exists.Id,
+                                    item: exists,
+                                    saveChanges: true
+                                )
+                                .GetAwaiter()
+                                .GetResult();
+
+                                //
+                                Log($"Refresh Terms and Conditions of {exists.Language}");
+                                break;
+
+                            //
+                            case xDataService.Constants.XDbSeedingMode.AddIfNotExists:
+                                //
+                                if (!isExists)
+                                {
+                                    //
+                                    exists = stringProvider.AddAsync(
+                                        item: item,
+                                        saveChanges: true
+                                    )
+                                    .GetAwaiter()
+                                    .GetResult();
+
+                                    //
+                                    Log($"Add Terms and Conditions for {exists.Language}");
+                                }
+                                break;
+                        }
+                    }
+                }
+            }
+        }
+
+        //
+        #region Private ...
+        /// <summary>
+        /// a LogTag for Service ...
+        /// </summary>
+        private static string XLogTag = XTermsAndConditionsServiceConstants.XTermsAndConditionsServiceDILogTag;
+
+        /// <summary>
+        /// print a log in Console ...
+        /// </summary>
+        /// <param name="message"></param>
+        private static void Log(string message)
+        {
+            Console.WriteLine($"{XLogTag} => {message}");
+        }
+
+        /// <summary>
+        /// Add Terms and Conditions Provider Service ...
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="lifeTime"></param>
+        private static void AddTermsAndConditionsService(
+            IServiceCollection services,
+            IConfiguration configuration = null,
+            XTermsAndConditionsServiceConfiguration serviceConfiguration = null,
+            ServiceLifetime lifeTime = ServiceLifetime.Transient
+        )
+        {
+            //
+            var exception = XException.InvalidArgs.ToException(); ;
+
+            //
+            // Services ...
+            var isServicesExists = !services.IsNull();
+            if (!isServicesExists)
+            {
+                //
+                Log("AddTermsAndConditions failed, services not provided ...");
+                throw exception;
+            }
+
+            //
+            // Validate Configuration ...
+            var isConfigValid = !configuration.IsNull() || !serviceConfiguration.IsNull();
+            if (!isConfigValid)
+            {
+                //
+                Log("AddTermsAndConditions failed, configuration not provided ...");
+                throw exception;
+            }
+
+            //
+            // Lifetime ...
+            var isLifetimeExists = !lifeTime.IsNull();
+            if (!isLifetimeExists)
+            {
+                //
+                Log("AddTermsAndConditions failed, lifetime not provided ...");
+                throw exception;
+            }
+
+            //
+            // Check Dependencies Exists ...
+            var isDependenciesPassed = !services
+                .GetRegisteredService<XAppConfiguration>()
+                .IsNull() &&
+                !services.GetRegisteredService<IXStringServiceProvider>()
+                .IsNull();
+            if (!isDependenciesPassed)
+            {
+                //
+                Log("AddTermsAndConditions failed due Dependencies Issues, IXStringServiceProvider or XAppConfiguration not provided ...");
+                throw exception;
+            }
+
+            //
+            // Service Configuration Handler ...
+            if (serviceConfiguration.IsNull())
+            {
+                serviceConfiguration = configuration.GetXTermsAndConditionsServiceConfiguration();
+            }
+            services.AddXTermsAndConditionsConfiguration(serviceConfiguration);
+
+            //
+            // Register Resource Providers ...
+            services.Add(new ServiceDescriptor(typeof(IXTermsAndConditionsProvider), typeof(XTermsAndConditionsProvider), lifeTime));
+        }
+        #endregion
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Hubs\XTermsHub.cs
+
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.SignalR;
+using Microsoft.Extensions.Logging;
+using xCommons.Extensions;
+using xPushService.Base;
+using xPushService.Constants;
+using xStringService.Models.Dtos;
+
+namespace xTermsAndConditionsService.Hubs
+{
+    /// <summary>
+    /// a Hub for Notifing Terms and Conditions Events to Connected Clients ...
+    /// </summary>
+    public class XTermsHub : XBaseHub
+    {
+        public XTermsHub(
+            ILogger<XTermsHub> logger
+        ) : base(logger)
+        {
+        }
+
+        //
+        #region Hub Actions ...
+        /// <summary>
+        /// Add Specified Terms and Conditions ...
+        /// </summary>
+        /// <param name="entity"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task Add(
+            XStringDto entity,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            var connectionId = Context.ConnectionId;
+            if (!connectionId.IsNullOrEmpty())
+            {
+                //
+                await Clients
+                    .AllExcept(connectionId)
+                    .SendAsync(
+                        XBaseEntityHubAction.Add.GetStringValue(),
+                        entity.ToJSON(camelCase: true),
+                        connectionId,
+                        cancellationToken
+                    );
+            }
+        }
+
+        /// <summary>
+        /// Deleted Specified Terms and Conditions ...
+        /// </summary>
+        /// <param name="entity"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task Delete(
+            XStringDto entity,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            var connectionId = Context.ConnectionId;
+            if (!connectionId.IsNullOrEmpty())
+            {
+                //
+                await Clients
+                    .AllExcept(connectionId)
+                    .SendAsync(
+                        XBaseEntityHubAction.Delete.GetStringValue(),
+                        entity.ToJSON(camelCase: true),
+                        connectionId,
+                        cancellationToken
+                    );
+            }
+        }
+
+        /// <summary>
+        /// Notify an Entity Updated ...
+        /// </summary>
+        /// <param name="entity"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public async Task Update(
+            XStringDto entity,
+            CancellationToken cancellationToken = default
+        )
+        {
+            //
+            var connectionId = Context.ConnectionId;
+            if (!connectionId.IsNullOrEmpty())
+            {
+                //
+                await Clients
+                    .AllExcept(connectionId)
+                    .SendAsync(
+                        XBaseEntityHubAction.Update.GetStringValue(),
+                        entity.ToJSON(camelCase: true),
+                        connectionId,
+                        cancellationToken
+                    );
+            }
+        }
+        #endregion
+    }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Interfaces\IXTermsAndConditionsController.cs
+
+using xStringService.Interfaces;
+
+namespace xTermsAndConditionsService.Interfaces
+{
+    /// <summary>
+    /// an Interface for Describing Terms and Conditions Management Controller Actions ...
+    /// </summary>
+    public interface IXTermsAndConditionsController : IXBaseResourceProviderController
+    { }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Interfaces\IXTermsAndConditionsProvider.cs
+
+using xStringService.Interfaces;
+
+namespace xTermsAndConditionsService.Interfaces
+{
+    /// <summary>
+    /// an Interface for Describing Terms and Conditions Management Provided Actions ...
+    /// </summary>
+    public interface IXTermsAndConditionsProvider : IXResourceProvider
+    { }
+}
+
+### FILE: C:\Users\SaherElm\Documents\Projects\xSaherelmWorkspace\Modules\xTermsAndConditionsService\Providers\XTermsAndConditionsProvider.cs
+
+using xStringService.Interfaces.Dtos;
+using xStringService.Providers;
+using xTermsAndConditionsService.Configurations;
+using xTermsAndConditionsService.Interfaces;
+
+namespace xTermsAndConditionsService.Providers
+{
+    /// <summary>
+    /// an Implementation of Terms and Conditions Management Provided Actions ...
+    /// </summary>
+    public class XTermsAndConditionsProvider : XBaseResourceProvider, IXTermsAndConditionsProvider
+    {
+        public XTermsAndConditionsProvider(
+            IXStringServiceProvider provider,
+            XTermsAndConditionsServiceConfiguration configuration
+        ) : base(
+            resource: "NULL", 
+            provider
+        )
+        {
+            //
+            // Since we nee to Set Resource Title of Terms and Conditions 
+            // during instancing using Provided Configurations ...
+            // set this value here ...
+            resource = configuration.ResourceTitle;
+        }
+    }
+}