* Architectural rework

2026-03-06 23:19:24 +04:00
parent 74d778e6da
commit 866129f2ff
144 changed files with 413 additions and 368 deletions
@@ -0,0 +1,30 @@
+using Microsoft.Extensions.Configuration;
+using Telegram.Bot;
+using Telegram.Bot.Types;
+using Telegrator.Core;
+
+namespace Telegrator.Hosting
+{
+    /// <summary>
+    /// Implementation of <see cref="ITelegramBotInfo"/> that provides bot information.
+    /// Contains metadata about the Telegram bot including user details and service provider for wider filterring abilities
+    /// </summary>
+    /// <param name="client"></param>
+    /// <param name="services"></param>
+    /// <param name="configuration"></param>
+    public class HostedTelegramBotInfo(ITelegramBotClient client, IServiceProvider services, IConfigurationManager configuration) : ITelegramBotInfo
+    {
+        /// <inheritdoc/>
+        public User User { get; } = client.GetMe().Result;
+        
+        /// <summary>
+        /// Provides access to services of this Hosted telegram bot
+        /// </summary>
+        public IServiceProvider Services { get; } = services;
+
+        /// <summary>
+        /// Provides access to configuration of this Hosted telegram bot
+        /// </summary>
+        public IConfigurationManager Configuration { get; } = configuration;
+    }
+}
@@ -0,0 +1,13 @@
+using Microsoft.Extensions.Hosting;
+
+namespace Telegrator.Hosting
+{
+    /// <summary>
+    /// Interface for Telegram bot hosts.
+    /// Combines host application capabilities with reactive Telegram bot functionality.
+    /// </summary>
+    public interface ITelegramBotHost : IHost, ITelegratorBot
+    {
+
+    }
+}
@@ -0,0 +1,29 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using Telegrator.Core;
+
+namespace Telegrator.Hosting
+{
+    /// <summary>
+    /// Interface for building Telegram bot hosts with dependency injection support.
+    /// Combines host application building capabilities with handler collection functionality.
+    /// </summary>
+    public interface ITelegramBotHostBuilder : ICollectingProvider
+    {
+        /// <summary>
+        /// Gets the set of key/value configuration properties.
+        /// </summary>
+        IConfigurationManager Configuration { get; }
+
+        /// <summary>
+        /// Gets a collection of logging providers for the application to compose. This is useful for adding new logging providers.
+        /// </summary>
+        ILoggingBuilder Logging { get; }
+
+        /// <summary>
+        /// Gets a collection of services for the application to compose. This is useful for adding user provided or framework provided services.
+        /// </summary>
+        IServiceCollection Services { get; }
+    }
+}
@@ -0,0 +1,135 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+using Telegrator.Core;
+
+namespace Telegrator.Hosting
+{
+    /// <summary>
+    /// Represents a hosted telegram bot
+    /// </summary>
+    public class TelegramBotHost : ITelegramBotHost
+    {
+        private readonly IHost _innerHost;
+        private readonly IServiceProvider _serviceProvider;
+        private readonly IUpdateRouter _updateRouter;
+        private readonly ILogger<TelegramBotHost> _logger;
+
+        private bool _disposed;
+
+        /// <inheritdoc/>
+        public IServiceProvider Services => _serviceProvider;
+
+        /// <inheritdoc/>
+        public IUpdateRouter UpdateRouter => _updateRouter;
+
+        /// <summary>
+        /// This application's logger
+        /// </summary>
+        public ILogger<TelegramBotHost> Logger => _logger;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TelegramBotHost"/> class.
+        /// </summary>
+        /// <param name="hostApplicationBuilder">The proxied instance of host builder.</param>
+        /// <param name="handlers"></param>
+        public TelegramBotHost(HostApplicationBuilder hostApplicationBuilder, IHandlersCollection handlers)
+        {
+            // Registering this host in services for easy access
+            RegisterHostServices(hostApplicationBuilder.Services, handlers);
+
+            // Building proxy hoster
+            _innerHost = hostApplicationBuilder.Build();
+            _serviceProvider = _innerHost.Services;
+            _innerHost.UseTelegrator();
+
+            // Reruesting services for this host
+            _updateRouter = Services.GetRequiredService<IUpdateRouter>();
+            _logger = Services.GetRequiredService<ILogger<TelegramBotHost>>();
+
+            // Logging registering handlers in DEBUG purposes
+            _logger.LogHandlers(handlers);
+        }
+
+        /// <summary>
+        /// Creates new <see cref="TelegramBotHostBuilder"/> with default configuration, services and long-polling update receiving scheme
+        /// </summary>
+        /// <returns></returns>
+        public static TelegramBotHostBuilder CreateBuilder()
+        {
+            HostApplicationBuilder innerBuilder = new HostApplicationBuilder(settings: null);
+            TelegramBotHostBuilder builder = new TelegramBotHostBuilder(innerBuilder, null);
+            builder.Services.AddTelegramBotHostDefaults();
+            builder.Services.AddTelegramReceiver();
+            return builder;
+        }
+
+        /// <summary>
+        /// Creates new <see cref="TelegramBotHostBuilder"/> with default services and long-polling update receiving scheme
+        /// </summary>
+        /// <returns></returns>
+        public static TelegramBotHostBuilder CreateBuilder(TelegramBotHostBuilderSettings? settings)
+        {
+            HostApplicationBuilder innerBuilder = new HostApplicationBuilder(settings?.ToApplicationBuilderSettings());
+            TelegramBotHostBuilder builder = new TelegramBotHostBuilder(innerBuilder, settings);
+            builder.Services.AddTelegramBotHostDefaults();
+            builder.Services.AddTelegramReceiver();
+            return builder;
+        }
+
+        /// <summary>
+        /// Creates new EMPTY <see cref="TelegramBotHostBuilder"/> WITHOUT any services or update receiving schemes
+        /// </summary>
+        /// <returns></returns>
+        public static TelegramBotHostBuilder CreateEmptyBuilder()
+        {
+            HostApplicationBuilder innerBuilder = Host.CreateEmptyApplicationBuilder(null);
+            return new TelegramBotHostBuilder(innerBuilder, null);
+        }
+
+        /// <summary>
+        /// Creates new EMPTY <see cref="TelegramBotHostBuilder"/> WITHOUT any services or update receiving schemes
+        /// </summary>
+        /// <returns></returns>
+        public static TelegramBotHostBuilder CreateEmptyBuilder(TelegramBotHostBuilderSettings? settings)
+        {
+            HostApplicationBuilder innerBuilder = Host.CreateEmptyApplicationBuilder(null);
+            return new TelegramBotHostBuilder(innerBuilder, settings);
+        }
+
+        /// <inheritdoc/>
+        public async Task StartAsync(CancellationToken cancellationToken = default)
+        {
+            await _innerHost.StartAsync(cancellationToken);
+        }
+
+        /// <inheritdoc/>
+        public async Task StopAsync(CancellationToken cancellationToken = default)
+        {
+            await _innerHost.StopAsync(cancellationToken);
+        }
+
+        /// <summary>
+        /// Disposes the host.
+        /// </summary>
+        public void Dispose()
+        {
+            if (_disposed)
+                return;
+
+            _innerHost.Dispose();
+
+            GC.SuppressFinalize(this);
+            _disposed = true;
+        }
+
+        private void RegisterHostServices(IServiceCollection services, IHandlersCollection handlers)
+        {
+            //services.RemoveAll<IHost>();
+            //services.AddSingleton<IHost>(this);
+
+            services.AddSingleton<ITelegramBotHost>(this);
+            services.AddSingleton<ITelegratorBot>(this);
+        }
+    }
+}
@@ -0,0 +1,75 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+using Telegrator.Core;
+using Telegrator.Hosting.Providers;
+
+#pragma warning disable IDE0001
+namespace Telegrator.Hosting
+{
+    /// <summary>
+    /// Represents a hosted telegram bots and services builder that helps manage configuration, logging, lifetime, and more.
+    /// </summary>
+    public class TelegramBotHostBuilder : ITelegramBotHostBuilder
+    {
+        private readonly HostApplicationBuilder _innerBuilder;
+        private readonly TelegramBotHostBuilderSettings _settings;
+        private readonly IHandlersCollection _handlers;
+
+        /// <inheritdoc/>
+        public IHandlersCollection Handlers => _handlers;
+
+        /// <inheritdoc/>
+        public IServiceCollection Services => _innerBuilder.Services;
+
+        /// <inheritdoc/>
+        public IConfigurationManager Configuration => _innerBuilder.Configuration;
+
+        /// <inheritdoc/>
+        public ILoggingBuilder Logging => _innerBuilder.Logging;
+
+        /// <inheritdoc/>
+        public IHostEnvironment Environment => _innerBuilder.Environment;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TelegramBotHostBuilder"/> class.
+        /// </summary>
+        /// <param name="hostApplicationBuilder"></param>
+        /// <param name="settings"></param>
+        public TelegramBotHostBuilder(HostApplicationBuilder hostApplicationBuilder, TelegramBotHostBuilderSettings? settings = null)
+        {
+            _innerBuilder = hostApplicationBuilder ?? throw new ArgumentNullException(nameof(hostApplicationBuilder));
+            _settings = settings ?? new TelegramBotHostBuilderSettings();
+            _handlers = new HostHandlersCollection(Services, _settings);
+
+            _innerBuilder.AddTelegrator(_settings, _handlers);
+            _innerBuilder.Logging.ClearProviders();
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TelegramBotHostBuilder"/> class.
+        /// </summary>
+        /// <param name="hostApplicationBuilder"></param>
+        /// <param name="handlers"></param>
+        /// <param name="settings"></param>
+        public TelegramBotHostBuilder(HostApplicationBuilder hostApplicationBuilder, IHandlersCollection handlers, TelegramBotHostBuilderSettings? settings = null)
+        {
+            _innerBuilder = hostApplicationBuilder ?? throw new ArgumentNullException(nameof(hostApplicationBuilder));
+            _settings = settings ?? new TelegramBotHostBuilderSettings();
+            _handlers = handlers ?? throw new ArgumentNullException(nameof(handlers));
+
+            _innerBuilder.AddTelegrator(_settings, _handlers);
+            _innerBuilder.Logging.ClearProviders();
+        }
+
+        /// <summary>
+        /// Builds the host.
+        /// </summary>
+        /// <returns></returns>
+        public TelegramBotHost Build()
+        {
+            return new TelegramBotHost(_innerBuilder, _handlers);
+        }
+    }
+}
@@ -0,0 +1,45 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Options;
+
+namespace Telegrator.Hosting
+{
+    /// <summary>
+    /// Settings os hosted Telegram bot
+    /// </summary>
+    public class TelegramBotHostBuilderSettings() : TelegratorOptions
+    {
+        /// <summary>
+        /// Disables automatic configuration for all of required <see cref="IOptions{TOptions}"/> instances
+        /// </summary>
+        public bool DisableAutoConfigure { get; set; }
+
+        /// <inheritdoc cref="HostApplicationBuilderSettings.DisableDefaults"/>
+        public bool DisableDefaults { get; set; }
+
+        /// <inheritdoc cref="HostApplicationBuilderSettings.Args"/>
+        public string[]? Args { get; set; }
+
+        /// <inheritdoc cref="HostApplicationBuilderSettings.Configuration"/>
+        public ConfigurationManager? Configuration { get; set; }
+
+        /// <inheritdoc cref="HostApplicationBuilderSettings.EnvironmentName"/>
+        public string? EnvironmentName { get; set; }
+
+        /// <inheritdoc cref="HostApplicationBuilderSettings.ApplicationName"/>
+        public string? ApplicationName { get; set; }
+
+        /// <inheritdoc cref="HostApplicationBuilderSettings.ContentRootPath"/>
+        public string? ContentRootPath { get; set; }
+
+        internal HostApplicationBuilderSettings ToApplicationBuilderSettings() => new HostApplicationBuilderSettings()
+        {
+            DisableDefaults = DisableDefaults,
+            Args = Args,
+            Configuration = Configuration,
+            EnvironmentName = EnvironmentName,
+            ApplicationName = ApplicationName,
+            ContentRootPath = ContentRootPath
+        };
+    }
+}