FrigaT/BotPages
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 25 Wiki Activity

Переработанная версия ядра
All checks were successful
CI / build-test (push) Successful in 42s
Details

Browse Source
This commit is contained in:
FrigaT
2025-12-05 12:57:05 +03:00
parent ee175a35a0
commit d817417a69
81 changed files with 2335 additions and 1453 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
BotPages.Core/Abstractions/Capabilities.cs Normal file
View File

@@ -0,0 +1,25 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Возможности мессенджера (inline кнопки, альбомы, форматирование и т.д.).
/// </summary>
public sealed class Capabilities
{
/// <summary>Поддержка inline-кнопок.</summary>
public bool SupportsInlineButtons { get; init; }
/// <summary>Поддержка reply-кнопок.</summary>
public bool SupportsReplyButtons { get; init; }
/// <summary>Поддержка альбомов (медиагрупп).</summary>
public bool SupportsAlbums { get; init; }
/// <summary>Поддержка форматирования Markdown.</summary>
public bool SupportsFormattingMarkdown { get; init; }
/// <summary>Поддержка форматирования HTML.</summary>
public bool SupportsFormattingHtml { get; init; }
/// <summary>Максимальная длина сообщения.</summary>
public int MaxMessageLength { get; init; } = 4096;
}

6
BotPages.Core/Abstractions/CompositeSessionKey.cs Normal file
View File

@@ -0,0 +1,6 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Ключ для идентификации пользовательской сессии.
/// </summary>
public readonly record struct CompositeSessionKey(string MessengerType, string ChatId, string? UserId);

22
BotPages.Core/Abstractions/FileDescriptor.cs Normal file
View File

@@ -0,0 +1,22 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Описание файла, полученного или отправляемого через мессенджер.
/// </summary>
public sealed class FileDescriptor
{
/// <summary>Идентификатор файла в мессенджере.</summary>
public required string Id { get; init; }
/// <summary>Имя файла.</summary>
public required string Name { get; init; }
/// <summary>Расширение файла.</summary>
public required string Extension { get; init; }
/// <summary>Размер файла в байтах.</summary>
public long Size { get; init; }
/// <summary>MIME-тип файла.</summary>
public string? Mime { get; init; }
/// <summary>Тип файла.</summary>
public FileKind Kind { get; init; } = FileKind.Document;
/// <summary>Функция получения потока файла.</summary>
public Func<CancellationToken, Task<Stream>> GetStreamAsync { get; init; } = _ => Task.FromResult<Stream>(Stream.Null);
}

20
BotPages.Core/Abstractions/FileKind.cs Normal file
View File

@@ -0,0 +1,20 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Тип файла.
/// </summary>
public enum FileKind
{
/// <summary> Фото </summary>
Photo,
/// <summary> Документ </summary>
Document,
/// <summary> Аудио </summary>
Audio,
/// <summary> Видео </summary>
Video,
/// <summary> Стикер </summary>
Sticker,
/// <summary> Остальное </summary>
Other,
}

12
BotPages.Core/Abstractions/IAlbumBuilder.cs Normal file
View File

@@ -0,0 +1,12 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Билдер отправки медиагруппы (альбома).
/// </summary>
public interface IAlbumBuilder
{
/// <summary>Добавить элемент в альбом.</summary>
IAlbumBuilder Add(FileDescriptor file, string? caption = null);
/// <summary>Отправить альбом.</summary>
Task SendAsync(CancellationToken ct = default);
}

42
BotPages.Core/Abstractions/IMessengerAdapter.cs Normal file
View File

@@ -0,0 +1,42 @@
using BotPages.Core.Messaging;
namespace BotPages.Core.Abstractions;
/// <summary>
/// Контракт адаптера мессенджера.
/// Определяет операции отправки сообщений, файлов и прогресса.
/// </summary>
public interface IMessengerAdapter
{
/// <summary>
/// Отправить текстовое сообщение в чат.
/// </summary>
Task SendTextAsync(PageContext ctx, string text, MessageFormat format,
IEnumerable<IEnumerable<InlineButton>>? inline,
IEnumerable<IEnumerable<ReplyButton>>? reply, CancellationToken ct);
/// <summary>
/// Отправить файл в чат.
/// </summary>
Task SendFileAsync(PageContext ctx, FileDescriptor file, string? caption, CancellationToken ct);
/// <summary>
/// Создать билдер альбома для отправки медиагруппы.
/// </summary>
IAlbumBuilder CreateAlbumBuilder(PageContext ctx);
/// <summary>
/// Начать отображение прогресса операции.
/// </summary>
Task<string?> StartProgressAsync(PageContext ctx, string title, CancellationToken ct);
/// <summary>
/// Обновить прогресс операции.
/// </summary>
Task UpdateProgressAsync(PageContext ctx, string messageId, string title, int percent, CancellationToken ct);
/// <summary>
/// Вызывается при выходе со страницы.
/// </summary>
Task OnLeaveAsync(PageContext ctx, CancellationToken ct);
}

25
BotPages.Core/Abstractions/IMessengerAdapterFactory.cs Normal file
View File

@@ -0,0 +1,25 @@
using BotPages.Core.Context;
namespace BotPages.Core.Abstractions;
/// <summary>
/// Фабрика адаптеров мессенджеров.
/// Используется для разрешения конкретного <see cref="IMessengerAdapter"/> по типу мессенджера.
/// </summary>
public interface IMessengerAdapterFactory
{
/// <summary>
/// Получить адаптер для указанного мессенджера.
/// </summary>
/// <param name="messengerType">
/// Тип мессенджера (например, "Telegram", "Slack", "VK").
/// Значение должно совпадать с <see cref="UpdateContext.User"/>.<see cref="UserContext.MessengerType"/>.
/// </param>
/// <returns>
/// Экземпляр <see cref="IMessengerAdapter"/>, зарегистрированный для данного типа мессенджера.
/// </returns>
/// <exception cref="InvalidOperationException">
/// Выбрасывается, если адаптер для указанного типа не зарегистрирован.
/// </exception>
IMessengerAdapter Resolve(string messengerType);
}

11
BotPages.Core/Abstractions/IPageMiddleware.cs Normal file
View File

@@ -0,0 +1,11 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Интерфейс middleware для обработки входящих обновлений.
/// </summary>
public interface IPageMiddleware
{
/// <summary>
/// Выполнить промежуточную логику, затем вызвать следующий обработчик.
/// </summary>
Task InvokeAsync(PageContext ctx, Func<Task> next, CancellationToken ct);
}

20
BotPages.Core/Abstractions/IStateStorage.cs Normal file
View File

@@ -0,0 +1,20 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Интерфейс универсального хранилища состояния.
/// Позволяет сохранять и восстанавливать данные между обновлениями.
/// </summary>
public interface IStateStorage
{
/// <summary>Получить состояние по ключу.</summary>
Task<T?> GetAsync<T>(CompositeSessionKey session, string key, CancellationToken ct);
/// <summary>Сохранить состояние по ключу.</summary>
Task SetAsync<T>(CompositeSessionKey session, string key, T state, CancellationToken ct);
/// <summary>Удалить состояние по ключу.</summary>
Task<bool> RemoveAsync(CompositeSessionKey session, string key, CancellationToken ct);
/// <summary>Удалить все состояния по ключу.</summary>
Task<bool> ClearAsync(CompositeSessionKey session, CancellationToken ct);
}

14
BotPages.Core/Abstractions/MessageFormat.cs Normal file
View File

@@ -0,0 +1,14 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Форматирование текста сообщения.
/// </summary>
public enum MessageFormat
{
/// <summary>Обычный текст без форматирования.</summary>
Plain,
/// <summary>Markdown форматирование.</summary>
Markdown,
/// <summary>HTML форматирование.</summary>
Html
}

45
BotPages.Core/Abstractions/MultiAdapterFactory.cs Normal file
View File

@@ -0,0 +1,45 @@
namespace BotPages.Core.Abstractions;
/// <summary>
/// Реализация <see cref="IMessengerAdapterFactory"/>, позволяющая регистрировать и разрешать несколько адаптеров мессенджеров.
/// </summary>
public sealed class MultiAdapterFactory : IMessengerAdapterFactory
{
private readonly Dictionary<string, IMessengerAdapter> _adapters = new(StringComparer.OrdinalIgnoreCase);
/// <summary>
/// Зарегистрировать адаптер для указанного типа мессенджера.
/// </summary>
/// <param name="messengerType">
/// Тип мессенджера (например, "Telegram", "Slack", "VK").
/// </param>
/// <param name="adapter">
/// Экземпляр адаптера, реализующий <see cref="IMessengerAdapter"/>.
/// </param>
/// <returns>
/// Текущий экземпляр <see cref="MultiAdapterFactory"/> для цепочки вызовов.
/// </returns>
public MultiAdapterFactory Register(string messengerType, IMessengerAdapter adapter)
{
_adapters[messengerType] = adapter;
return this;
}
/// <summary>
/// Получить адаптер для указанного мессенджера.
/// </summary>
/// <param name="messengerType">
/// Тип мессенджера (например, "Telegram", "Slack", "VK").
/// </param>
/// <returns>
/// Экземпляр <see cref="IMessengerAdapter"/>, зарегистрированный для данного типа мессенджера.
/// </returns>
/// <exception cref="InvalidOperationException">
/// Выбрасывается, если адаптер для указанного типа не зарегистрирован.
/// </exception>
public IMessengerAdapter Resolve(string messengerType)
=> _adapters.TryGetValue(messengerType, out var adapter)
? adapter
: throw new InvalidOperationException($"No adapter registered for {messengerType}");
}

25
BotPages.Core/BotPages.Core.csproj
View File

@@ -1,9 +1,22 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
<PackageId>BotPages.Core</PackageId>
<Version>1.0.0</Version>
<Authors>FrigaT</Authors>
<Company>FrigaT</Company>
<Product>BotPages</Product>
<Description>Платформонезависимое ядро для создания диалоговых ботов с системой страниц. Часть проекта BotPages.</Description>
<Copyright>Copyright © 2025 FrigaT</Copyright>
<RepositoryUrl>https://git.frigat.duckdns.org/FrigaT/BotPages</RepositoryUrl>
<RepositoryType>git</RepositoryType>
<PackageProjectUrl>https://git.frigat.duckdns.org/FrigaT/BotPages</PackageProjectUrl>
<PackageReadmeFile>README.md</PackageReadmeFile>
<PackageLicenseExpression>MIT</PackageLicenseExpression>
</PropertyGroup>
</Project>
</Project>

176
BotPages.Core/BotPagesApp.cs Normal file
View File

@@ -0,0 +1,176 @@
namespace BotPages.Core;
using BotPages.Core.Abstractions;
using BotPages.Core.Context;
using BotPages.Core.Logging;
using BotPages.Core.Routing;
/// <summary>
/// Основное приложение BotPages.
/// Управляет маршрутизацией, командами, middleware и страницами.
/// </summary>
public sealed class BotPagesApp
{
private readonly IMessengerAdapterFactory _adapterFactory;
private readonly List<IPageMiddleware> _middlewares = new();
private readonly RoutesRegistry _routes = new();
private readonly CommandsRegistry _commands = new();
private readonly IStateStorage _state;
private readonly ILogger _logger;
private readonly NavigationService _navigation;
/// <summary>
/// Создать приложение BotPages.
/// </summary>
public BotPagesApp(IMessengerAdapterFactory adapterFactory, IStateStorage state, ILogger logger)
{
_adapterFactory = adapterFactory;
_state = state;
_logger = logger;
_navigation = new NavigationService(_routes);
}
/// <summary>
/// Установить страницу по умолчанию.
/// </summary>
public BotPagesApp AddDefaultPage<TPage>() where TPage : Page
{
_navigation.AddDefaultPage<TPage>();
return this;
}
/// <summary>
/// Добавить middleware.
/// </summary>
public BotPagesApp AddMiddleware<TMiddleware>(TMiddleware instance) where TMiddleware : IPageMiddleware
{
_middlewares.Add(instance);
return this;
}
/// <summary>
/// Зарегистрировать команду, ведущую на страницу.
/// </summary>
public BotPagesApp MapCommand<TPage>(string commandTemplate) where TPage : Page
{
_commands.Map<TPage>(commandTemplate);
return this;
}
/// <summary>
/// Зарегистрировать команду с кастомным обработчиком.
/// </summary>
public BotPagesApp MapCommand(string template, Func<PageContext, CancellationToken, Task> handler)
{
_commands.Map(template, handler);
return this;
}
/// <summary>
/// Зарегистрировать маршрут для страницы.
/// </summary>
public BotPagesApp MapRoute<TPage>(string template) where TPage : Page
{
_routes.Map<TPage>(template);
return this;
}
/// <summary>
/// Обработать входящее обновление.
/// </summary>
public async Task HandleUpdateAsync(UpdateContext update, CancellationToken ct)
{
var ctx = await CreatePageContextAsync(update, ct);
// Команды выше событий страниц
if (update.Kind == UpdateKind.Text && update.Text is not null && update.Text.StartsWith("/"))
{
if (_commands.TryDispatch(ctx, update.Text, ct, out var dispatched) && dispatched is not null)
{
_logger.Log(LogLevel.Info, $"Command '{update.Text}' dispatched.");
await dispatched;
return;
}
}
// Конвейер middleware
var pipeline = BuildPipeline(ctx, async () =>
{
await DispatchToPageAsync(ctx, update, ct);
});
await pipeline();
}
private Func<Task> BuildPipeline(PageContext ctx, Func<Task> terminal)
{
Func<Task> next = terminal;
foreach (var mw in _middlewares.AsEnumerable().Reverse())
{
var prev = next;
next = () => mw.InvokeAsync(ctx, prev, _currentCt);
}
return next;
}
// Технические поля для конвейера
private CancellationToken _currentCt;
/// <summary>
/// Создать контекст страницы для текущего обновления.
/// </summary>
private async Task<PageContext> CreatePageContextAsync(UpdateContext update, CancellationToken ct)
{
_currentCt = ct;
var sessionKey = new CompositeSessionKey(update.MessengerType, update.Chat.Id, update.User.Id);
var ctx = new PageContext
{
Update = update,
SessionKey = sessionKey,
StateStorage = _state,
Navigation = _navigation,
Adapter = _adapterFactory.Resolve(update.MessengerType),
};
return await Task.FromResult(ctx);
}
/// <summary>
/// Отправить обновление на текущую страницу.
/// </summary>
private async Task DispatchToPageAsync(PageContext ctx, UpdateContext update, CancellationToken ct)
{
var page = ResolveCurrentPage(ctx);
if (page is null)
{
await ctx.Navigation.GoToHome(ctx, ct);
return;
}
try
{
await page.OnUpdate(ctx, update, ct);
if (update.Kind.HasFlag(UpdateKind.Text) && update.Text is not null) await page.OnText(ctx, update.Text, ct);
if (update.Kind.HasFlag(UpdateKind.Button) && update.Text is not null) await page.OnButton(ctx, update.Text, ct);
if (update.Kind.HasFlag(UpdateKind.File) && update.Files.Count > 0) await page.OnFile(ctx, update.Files, ct);
}
catch (Exception ex)
{
_logger.Log(LogLevel.Critical, "Unhandled page error.", ex);
await page.OnError(ctx, ex, ct);
}
}
/// <summary>
/// Определить текущую страницу.
/// </summary>
private Page? ResolveCurrentPage(PageContext ctx)
=> _navigation.ResolveCurrentPage(ctx);
}

37
BotPages.Core/Context/ChatContext.cs
View File

@@ -1,18 +1,21 @@
namespace BotPages.Core
{
/// <summary>
/// Описывает чат/конверсацию для универсального контекста.
/// </summary>
public sealed class ChatContext
{
/// <summary>
/// Уникальный идентификатор чата/диалога.
/// </summary>
public long Id { get; init; }
using BotPages.Core.Abstractions;
/// <summary>
/// Человеко-читаемое имя чата (если доступно).
/// </summary>
public string? Title { get; init; }
}
}
namespace BotPages.Core;
/// <summary>
/// Данные чата.
/// </summary>
public sealed class ChatContext
{
/// <summary>Идентификатор чата.</summary>
public required string Id { get; init; }
/// <summary>Название чата (опционально).</summary>
public string? Title { get; init; }
/// <summary>Идентификатор треда (опционально).</summary>
public string? ThreadId { get; init; }
/// <summary>Возможности мессенджера.</summary>
public Capabilities Capabilities { get; init; } = new();
}

13
BotPages.Core/Context/FileDescriptor.cs
View File

@@ -1,13 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Универсальный дескриптор файла для операций загрузки/отправки.
/// </summary>
public sealed record FileDescriptor(
string Id,
string Name,
string MimeType,
int Size,
Stream? Content = null
);
}

88
BotPages.Core/Context/PageContext.cs Normal file
View File

@@ -0,0 +1,88 @@
using BotPages.Core.Abstractions;
using BotPages.Core.Context;
using BotPages.Core.Messaging;
namespace BotPages.Core;
/// <summary>
/// Контекст страницы, объединяющий пользователя, чат, состояние и адаптер.
/// </summary>
public sealed class PageContext
{
/// <summary>Ключ сессии.</summary>
public required CompositeSessionKey SessionKey { get; init; }
/// <summary>Данные обновления.</summary>
public required UpdateContext Update { get; init; }
/// <summary>Хранилище состояния.</summary>
public required IStateStorage StateStorage { get; init; }
/// <summary>Сервис навигации.</summary>
public required NavigationService Navigation { get; init; }
/// <summary>Адаптер мессенджера.</summary>
public required IMessengerAdapter Adapter { get; init; }
/// <summary>
/// Отправить текстовое сообщение.
/// </summary>
public Task SendTextAsync(string text, MessageFormat format = MessageFormat.Plain,
IEnumerable<IEnumerable<InlineButton>>? inline = null,
IEnumerable<IEnumerable<ReplyButton>>? reply = null,
CancellationToken ct = default)
=> Adapter.SendTextAsync(this, text, format, inline, reply, ct);
/// <summary>
/// Отправить файл.
/// </summary>
public Task SendFileAsync(FileDescriptor file, string? caption = null, CancellationToken ct = default)
=> Adapter.SendFileAsync(this, file, caption, ct);
/// <summary>
/// Получить билдер альбомов.
/// </summary>
public IAlbumBuilder Albums => Adapter.CreateAlbumBuilder(this);
/// <summary>
/// Начать прогресс операции.
/// </summary>
public async Task<string?> StartProgressAsync(string title, CancellationToken ct)
{
var messageId = await Adapter.StartProgressAsync(this, title, ct);
if (messageId != null)
{
_progressMessageId = messageId;
_progressTitle = title;
}
return messageId;
}
/// <summary>
/// Обновить прогресс операции.
/// </summary>
public Task UpdateProgressAsync(int percent, CancellationToken ct)
{
if (_progressMessageId != null)
{
return Adapter.UpdateProgressAsync(this, _progressMessageId, _progressTitle ?? "", percent, ct);
}
else
{
return Task.CompletedTask;
}
}
/// <summary>
/// Обновить прогресс операции.
/// </summary>
public Task UpdateProgressAsync(string messageId, int percent, CancellationToken ct)
{
return Adapter.UpdateProgressAsync(this, messageId, _progressTitle ?? "", percent, ct);
}
private string? _progressMessageId = null;
private string? _progressTitle = null;
}

93
BotPages.Core/Context/UpdateContext.cs
View File

@@ -1,48 +1,59 @@
namespace BotPages.Core
namespace BotPages.Core.Context;
using BotPages.Core.Abstractions;
/// <summary>
/// Тип входящего обновления.
/// </summary>
[Flags]
public enum UpdateKind
{
/// <summary>Неизвестное сообщение.</summary>
None = 0,
/// <summary>Текстовое сообщение.</summary>
Text = 1 << 0,
/// <summary>Файлы (один или несколько).</summary>
File = 1 << 1,
/// <summary>Нажатие кнопки.</summary>
Button = 1 << 2,
}
/// <summary>
/// Контекст входящего обновления от мессенджера.
/// Содержит нормализованные данные для страниц.
/// </summary>
public sealed class UpdateContext
{
/// <summary>Тип мессенджера.</summary>
public required string MessengerType { get; init; }
/// <summary>
/// Универсальный контекст обновления, независимый от транспорта.
/// Данные пользователя, от которого пришло обновление.
/// </summary>
public sealed class UpdateContext
{
/// <summary>
/// Клиент транспорта для отправки сообщений/файлов.
/// </summary>
public required IChatClient Client { get; init; }
public required UserContext User { get; init; }
/// <summary>
/// Контекст чата.
/// </summary>
public required ChatContext Chat { get; init; }
/// <summary>
/// Данные чата, в котором произошло обновление.
/// </summary>
public required ChatContext Chat { get; init; }
/// <summary>
/// Контекст пользователя.
/// </summary>
public required UserContext User { get; init; }
/// <summary>
/// Тип обновления (текст, файлы, кнопка).
/// </summary>
public required UpdateKind Kind { get; init; }
/// <summary>
/// Текст сообщения или полезная нагрузка колбэка, если доступна.
/// </summary>
public string? Text { get; init; }
/// <summary>
/// Текст сообщения, если Kind = Text.
/// Payload кнопки, если Kind = Button.
/// </summary>
public string? Text { get; init; }
/// <summary>
/// Список полученных файлов (если транспорт поддерживает).
/// </summary>
public IReadOnlyList<FileDescriptor>? IncomingFiles { get; init; }
/// <summary>
/// Сырой объект обновления транспорта (например, Telegram.Update).
/// </summary>
public object? RawUpdate { get; init; }
/// <summary>
/// Сервис навигации страниц.
/// </summary>
public required INavigationService Nav { get; init; }
/// <summary>
/// Хранилище состояния пользователя.
/// </summary>
public required IStateStore State { get; init; }
}
}
/// <summary>
/// Список файлов, если Kind = File.
/// Может содержать один или несколько файлов.
/// </summary>
public List<FileDescriptor> Files { get; init; } = new();
}

30
BotPages.Core/Context/UserContext.cs
View File

@@ -1,18 +1,16 @@
namespace BotPages.Core
{
/// <summary>
/// Описывает пользователя для универсального контекста.
/// </summary>
public sealed class UserContext
{
/// <summary>
/// Уникальный идентификатор пользователя в транспортном слое.
/// </summary>
public long Id { get; init; }
namespace BotPages.Core;
/// <summary>
/// Отображаемое имя пользователя (если доступно).
/// </summary>
public string? DisplayName { get; init; }
}
/// <summary>
/// Данные пользователя.
/// </summary>
public sealed class UserContext
{
/// <summary>Идентификатор пользователя.</summary>
public required string Id { get; init; }
/// <summary>
/// Отображаемое имя пользователя (если доступно).
/// </summary>
public string? DisplayName { get; init; }
}

30
BotPages.Core/Logging/ConsoleLogger.cs Normal file
View File

@@ -0,0 +1,30 @@
namespace BotPages.Core.Logging;
/// <summary>
/// Вывод лога в консоль.
/// </summary>
public sealed class ConsoleLogger : ILogger
{
/// <inheritdoc/>
public void Log(LogLevel level, string message, Exception? ex = null)
{
var prefix = level switch
{
LogLevel.Info => "[INFO] ",
LogLevel.Warn => "[WARN] ",
LogLevel.Critical => "[CRIT] ",
_ => "[LOG] "
};
string text = $"{DateTime.UtcNow:O} {prefix}{message}{(ex is null ? "" : $" :: {ex.Message}")}";
if (level == LogLevel.Critical)
{
Console.Error.WriteLine(text);
}
else
{
Console.WriteLine(text);
}
}
}

15
BotPages.Core/Logging/ILogger.cs Normal file
View File

@@ -0,0 +1,15 @@
namespace BotPages.Core.Logging;
/// <summary>
/// Интерфейс логгера для BotPages.
/// </summary>
public interface ILogger
{
/// <summary>
/// Записать сообщение в лог.
/// </summary>
/// <param name="level">Уровень логирования.</param>
/// <param name="message">Текст сообщения.</param>
/// <param name="ex">Исключение, если есть.</param>
void Log(LogLevel level, string message, Exception? ex = null);
}

14
BotPages.Core/Logging/LogLevel.cs Normal file
View File

@@ -0,0 +1,14 @@
namespace BotPages.Core.Logging;
/// <summary>
/// Уровни логирования для BotPages.
/// </summary>
public enum LogLevel
{
/// <summary>Информационные сообщения.</summary>
Info,
/// <summary>Предупреждения (например, деградация возможностей).</summary>
Warn,
/// <summary>Критические ошибки, делающие невозможным продолжение работы.</summary>
Critical
}

12
BotPages.Core/Logging/WithoutLogger.cs Normal file
View File

@@ -0,0 +1,12 @@
namespace BotPages.Core.Logging;
/// <summary>
/// Отключение логирования
/// </summary>
public sealed class WithoutLogger : ILogger
{
/// <inheritdoc/>
public void Log(LogLevel level, string message, Exception? ex = null)
{
}
}

98
BotPages.Core/Messaging/ButtonAttribute.cs Normal file
View File

@@ -0,0 +1,98 @@
using System.Reflection;
namespace BotPages.Core.Messaging;
/// <summary>
/// Описание для кнопки.
/// </summary>
[AttributeUsage(AttributeTargets.Field)]
public class ButtonAttribute : Attribute
{
///<inheritdoc/>
public ButtonAttribute(string label)
{
Label = label;
}
/// <summary>
/// Описание кнопки.
/// </summary>
public string Label { get; }
/// <summary>
/// Значение кнопки. Используется в InlineButton.
/// </summary>
public string? Value { get; }
}
public static class ButtonExtensions
{
private static readonly Dictionary<Type, Dictionary<string, object>> _cacheName = new();
/// <summary>
/// Получить подпись кнопки.
/// </summary>
/// <typeparam name="T">Enum тип.</typeparam>
/// <param name="value">Значение enum.</param>
/// <returns></returns>
public static string GetButtonLabel<T>(this T value)
where T : Enum
{
var fieldName = value.ToString();
var type = value.GetType();
var field = type.GetField(fieldName, BindingFlags.Public | BindingFlags.Static);
return field?.GetCustomAttribute<ButtonAttribute>()?.Label ?? fieldName;
}
/// <summary>
/// Получить значение кнопки.
/// </summary>
/// <typeparam name="T">Enum тип.</typeparam>
/// <param name="value">Значение enum.</param>
/// <returns></returns>
public static string GetButtonValue<T>(this T value)
where T : Enum
{
var fieldName = value.ToString();
var type = value.GetType();
var field = type.GetField(fieldName, BindingFlags.Public | BindingFlags.Static);
return field?.GetCustomAttribute<ButtonAttribute>()?.Value ?? fieldName;
}
/// <summary>
/// Получить значение enum из подписи кнопки.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="value"></param>
/// <returns></returns>
public static T? FromButtonLabel<T>(string? value) where T : struct, Enum
{
if (value == null) return null;
var type = typeof(T);
if (!_cacheName.TryGetValue(type, out var map))
{
map = new Dictionary<string, object>();
var fields = type.GetFields(BindingFlags.Public | BindingFlags.Static);
foreach (var field in fields)
{
var fieldValue = field.GetValue(null)!;
var fieldName = field.Name;
var attr = field.GetCustomAttribute<ButtonAttribute>();
if (attr != null)
{
fieldName = attr.Label;
}
map[fieldName] = fieldValue;
}
}
return map.TryGetValue(value, out var result) ? (T)result : null;
}
}

37
BotPages.Core/Messaging/InlineButton.cs Normal file
View File

@@ -0,0 +1,37 @@
namespace BotPages.Core.Messaging;
/// <summary>
/// Кнопки под сообщением
/// </summary>
public class InlineButton
{
/// <summary>
/// Подпись на кнопке
/// </summary>
public string Label { get; private set; }
/// <summary>
/// Значение кнопки
/// </summary>
public string Value { get; private set; }
/// <inheritdoc/>
public InlineButton(string label, string value)
{
this.Label = label;
this.Value = value;
}
/// <inheritdoc/>
public InlineButton(Enum value)
{
this.Label = value.GetButtonLabel();
this.Value = value.GetButtonValue();
}
/// <summary>
/// Преобразование enum к кнопке.
/// </summary>
/// <param name="en"></param>
public static implicit operator InlineButton(Enum en) => new InlineButton(en);
}

153
BotPages.Core/Messaging/MessageBuilder.cs Normal file
View File

@@ -0,0 +1,153 @@
using BotPages.Core.Abstractions;
namespace BotPages.Core.Messaging;
/// <summary>
/// Fluent‑билдер для отправки сообщений (текст, кнопки, файлы, альбомы, прогресс).
/// </summary>
public sealed class MessageBuilder
{
private readonly PageContext _ctx;
private string? _text = null;
private MessageFormat _format = MessageFormat.Plain;
private readonly List<List<InlineButton>> _inline = new();
private readonly List<List<ReplyButton>> _reply = new();
private readonly List<(FileDescriptor file, string? caption)> _files = new();
private readonly List<(FileDescriptor file, string? caption)> _album = new();
private string? _progressTitle = null;
private int? _progressPercent = null;
private string? _progressMessageId = null;
/// <summary>Создать билдер сообщений.</summary>
public MessageBuilder(PageContext ctx) => _ctx = ctx;
/// <summary>Текст сообщения.</summary>
public MessageBuilder Text(string text, MessageFormat format = MessageFormat.Plain)
{
_text = text;
_format = format;
return this;
}
/// <summary>Добавить inline‑кнопку.</summary>
public MessageBuilder Inline(string label, string value)
{
_inline.Add(new() { new(label, value) });
return this;
}
/// <summary>Добавить inline‑кнопку.</summary>
public MessageBuilder Inline(InlineButton button)
{
_inline.Add(new() { button });
return this;
}
/// <summary>Добавить inline‑кнопку.</summary>
public MessageBuilder Inline(params InlineButton[] buttons)
{
_inline.Add(buttons.ToList());
return this;
}
/// <summary>Добавить строку inline‑кнопок.</summary>
public MessageBuilder Inline(IEnumerable<InlineButton> row)
{
_inline.Add(row.ToList());
return this;
}
/// <summary>Добавить строку inline‑кнопок.</summary>
public MessageBuilder Inline(IEnumerable<IEnumerable<InlineButton>> row)
{
_inline.AddRange(row.Select(t => t.ToList()).ToList());
return this;
}
/// <summary>Добавить reply‑кнопку.</summary>
public MessageBuilder Reply(params ReplyButton[] label)
{
_reply.Add(label.ToList());
return this;
}
/// <summary>Добавить строку reply‑кнопок.</summary>
public MessageBuilder Reply(IEnumerable<ReplyButton> row)
{
_reply.Add(row.ToList());
return this;
}
/// <summary>Добавить строку reply‑кнопок.</summary>
public MessageBuilder Reply(IEnumerable<IEnumerable<ReplyButton>> row)
{
_reply.AddRange(row.Select(t => t.ToList()).ToList());
return this;
}
/// <summary>Добавить файл для отправки.</summary>
public MessageBuilder File(FileDescriptor file, string? caption = null)
{
_files.Add((file, caption));
return this;
}
/// <summary>Добавить файл в альбом.</summary>
public MessageBuilder Album(FileDescriptor file, string? caption = null)
{
_album.Add((file, caption));
return this;
}
/// <summary>Установить прогресс операции.</summary>
public MessageBuilder Progress(string title, int percent = 0)
{
_progressTitle = title;
_progressPercent = percent;
return this;
}
/// <summary>Отправить собранное сообщение.</summary>
public async Task SendAsync(CancellationToken ct = default)
{
// Текст
if (!string.IsNullOrWhiteSpace(_text))
{
await _ctx.SendTextAsync(_text, _format, _inline, _reply, ct);
}
// Файлы
foreach (var (file, caption) in _files)
await _ctx.SendFileAsync(file, caption, ct);
// Альбом
if (_album.Count > 0)
{
var builder = _ctx.Albums;
foreach (var (file, caption) in _album)
builder.Add(file, caption);
await builder.SendAsync(ct);
}
// Прогресс
if (_progressTitle is not null)
{
if (_progressMessageId is null)
_progressMessageId = await _ctx.StartProgressAsync(_progressTitle, ct);
if (_progressPercent > 0 && !string.IsNullOrEmpty(_progressMessageId))
await _ctx.UpdateProgressAsync(_progressMessageId, _progressPercent.Value, ct);
}
_text = null;
_files.Clear();
_album.Clear();
if (_progressPercent >= 100)
{
_progressTitle = null;
_progressMessageId = null;
_progressPercent = null;
}
}
}

36
BotPages.Core/Messaging/ReplyButton.cs Normal file
View File

@@ -0,0 +1,36 @@
namespace BotPages.Core.Messaging;
/// <summary>
/// Кнопки снизу чата
/// </summary>
public class ReplyButton
{
/// <summary>
/// Подпись на кнопке
/// </summary>
public string Label { get; private set; }
/// <inheritdoc/>
public ReplyButton(string label)
{
this.Label = label;
}
/// <inheritdoc/>
public ReplyButton(Enum value)
{
this.Label = value.GetButtonLabel();
}
/// <summary>
/// Преобразование строки к кнопке.
/// </summary>
/// <param name="str"></param>
public static implicit operator ReplyButton(string str) => new ReplyButton(str);
/// <summary>
/// Преобразование enum к кнопке.
/// </summary>
/// <param name="en"></param>
public static implicit operator ReplyButton(Enum en) => new ReplyButton(en);
}

34
BotPages.Core/Middleware/ErrorHandlingMiddleware.cs Normal file
View File

@@ -0,0 +1,34 @@
using BotPages.Core.Abstractions;
using BotPages.Core.Logging;
namespace BotPages.Core.Middleware;
/// <summary>
/// Middleware для глобальной ловли ошибок.
/// </summary>
public sealed class ErrorHandlingMiddleware : IPageMiddleware
{
private readonly ILogger _logger;
/// <inheritdoc/>
public ErrorHandlingMiddleware(ILogger logger)
{
_logger = logger;
}
/// <inheritdoc/>
public async Task InvokeAsync(PageContext ctx, Func<Task> next, CancellationToken ct)
{
try
{
await next();
}
catch (Exception ex)
{
_logger.Log(LogLevel.Critical, "Unhandled exception in middleware pipeline.", ex);
// Теперь можно напрямую использовать PageContext для ответа
await ctx.SendTextAsync("Произошла ошибка при обработке запроса. Попробуйте ещё раз.", ct: ct);
}
}
}

32
BotPages.Core/Middleware/LoggingMiddleware.cs Normal file
View File

@@ -0,0 +1,32 @@
using BotPages.Core.Abstractions;
using BotPages.Core.Logging;
namespace BotPages.Core.Middleware;
/// <summary>
/// Middleware для логирования всех входящих апдейтов.
/// </summary>
public sealed class LoggingMiddleware : IPageMiddleware
{
private readonly ILogger _logger;
/// <inheritdoc/>
public LoggingMiddleware(ILogger logger) => _logger = logger;
/// <inheritdoc/>
public async Task InvokeAsync(PageContext ctx, Func<Task> next, CancellationToken ct)
{
// Логируем базовую информацию
_logger.Log(LogLevel.Info, $"Update from {ctx.Update.MessengerType} | Chat: {ctx.Update.Chat.Id} | User: {ctx.Update.User.Id}");
// Логируем текст, кнопки, файлы
if (ctx.Update.Text is not null)
_logger.Log(LogLevel.Info, $"Text: {ctx.Update.Text}");
if (ctx.Update.Files.Count > 0)
_logger.Log(LogLevel.Info, $"Files: {ctx.Update.Files.Count}");
// Передаём управление дальше по конвейеру
await next();
}
}

38
BotPages.Core/Navigation/INavigationService.cs
View File

@@ -1,38 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Сервис навигации по страницам.
/// </summary>
public interface INavigationService
{
/// <summary>
/// Выполняет push новой страницы и вызывает её Enter.
/// </summary>
Task PushAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct);
/// <summary>
/// Выполняет replace текущей страницы и вызывает Enter новой.
/// </summary>
Task ReplaceAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct);
/// <summary>
/// Возвращается назад по стеку и вызывает Enter предыдущей.
/// </summary>
Task PopAsync(UpdateContext ctx, CancellationToken ct);
/// <summary>
/// Применяет декларативный результат страницы (навигация, текст, файлы).
/// </summary>
Task ApplyResultAsync(UpdateContext ctx, PageResult result, CancellationToken ct);
/// <summary>
/// Возвращает текущую запись стека.
/// </summary>
Task<NavEntry?> CurrentAsync(UpdateContext ctx, CancellationToken ct);
/// <summary>
/// Возвращает весь стек навигации.
/// </summary>
Task<IReadOnlyList<NavEntry>> StackAsync(UpdateContext ctx, CancellationToken ct);
}
}

18
BotPages.Core/Navigation/IStateStore.cs
View File

@@ -1,18 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Простое in-memory хранилище состояния пользователя.
/// </summary>
public interface IStateStore
{
/// <summary>
/// Получает состояние пользователя.
/// </summary>
Task<UserState> GetAsync(string transportId, long userId, CancellationToken ct);
/// <summary>
/// Сохраняет состояние пользователя.
/// </summary>
Task SaveAsync(UserState state, CancellationToken ct);
}
}

37
BotPages.Core/Navigation/InMemoryStateStore.cs
View File

@@ -1,37 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// In-memory реализация хранилища состояния для прототипирования.
/// </summary>
public sealed class InMemoryStateStore : IStateStore
{
private readonly Dictionary<(string chatClientId, long userId), UserState> _store = new();
/// <summary>
/// Получает состояние пользователя, создавая новое при отсутствии.
/// </summary>
public Task<UserState> GetAsync(string chatClientId, long userId, CancellationToken ct)
{
if (!_store.TryGetValue((chatClientId, userId), out var st))
{
st = new UserState
{
UserId = userId,
ChatClientId = chatClientId,
};
_store[(chatClientId, userId)] = st;
}
return Task.FromResult(st);
}
/// <summary>
/// Сохраняет состояние пользователя.
/// </summary>
public Task SaveAsync(UserState state, CancellationToken ct)
{
_store[(state.ChatClientId, state.UserId)] = state;
return Task.CompletedTask;
}
}
}

7
BotPages.Core/Navigation/NavEntry.cs
View File

@@ -1,7 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Запись навигационного стека: страница и её аргументы.
/// </summary>
public sealed record NavEntry(string PageId, object? Args = null);
}

213
BotPages.Core/Navigation/NavigationService.cs
View File

@@ -1,108 +1,115 @@
namespace BotPages.Core
using BotPages.Core.Abstractions;
using BotPages.Core.Routing;
using System.Collections.Concurrent;
namespace BotPages.Core;
/// <summary>
/// Сервис навигации между страницами.
/// Позволяет выполнять переходы, замену страниц и передачу аргументов.
/// </summary>
public sealed class NavigationService
{
private readonly RoutesRegistry _routes;
private readonly Dictionary<Type, Page> _singletonPages = new();
private readonly ConcurrentDictionary<CompositeSessionKey, Page> _sessionPages = new();
private Type? _defaultPage;
/// <summary>
/// Реализация сервиса навигации страниц.
/// Создать сервис навигации.
/// </summary>
public sealed class NavigationService : INavigationService
internal NavigationService(RoutesRegistry routes)
{
private readonly IPageRegistry _pages;
private readonly IStateStore _store;
/// <summary>
/// Создаёт сервис навигации.
/// </summary>
public NavigationService(IPageRegistry pages, IStateStore store)
{
_pages = pages;
_store = store;
}
/// <summary>
/// Выполняет push новой страницы и вызывает её Enter.
/// </summary>
public async Task PushAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct)
{
var state = await _store.GetAsync(ctx.Client.Id, ctx.User.Id, ct);
state.Stack.Add(new NavEntry(pageId, args));
await _store.SaveAsync(state, ct);
var pr = await _pages.Get(pageId).EnterAsync(ctx, ct);
await ApplyResultAsync(ctx, pr, ct);
}
/// <summary>
/// Выполняет replace текущей страницы и вызывает Enter новой.
/// </summary>
public async Task ReplaceAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct)
{
var state = await _store.GetAsync(ctx.Client.Id, ctx.User.Id, ct);
if (state.Stack.Count > 0) state.Stack[^1] = new NavEntry(pageId, args);
else state.Stack.Add(new NavEntry(pageId, args));
await _store.SaveAsync(state, ct);
var pr = await _pages.Get(pageId).EnterAsync(ctx, ct);
await ApplyResultAsync(ctx, pr, ct);
}
/// <summary>
/// Возвращается назад по стеку и вызывает Enter предыдущей.
/// </summary>
public async Task PopAsync(UpdateContext ctx, CancellationToken ct)
{
var state = await _store.GetAsync(ctx.Client.Id, ctx.User.Id, ct);
if (state.Stack.Count == 0) return;
var currentId = state.Stack[^1].PageId;
await _pages.Get(currentId).ExitAsync(ctx, ct);
state.Stack.RemoveAt(state.Stack.Count - 1);
await _store.SaveAsync(state, ct);
var next = state.Stack.Count > 0 ? state.Stack[^1].PageId : null;
if (next is not null)
{
var pr = await _pages.Get(next).EnterAsync(ctx, ct);
await ApplyResultAsync(ctx, pr, ct);
}
}
/// <summary>
/// Применяет декларативный результат страницы (навигация, текст, файлы).
/// </summary>
public async Task ApplyResultAsync(UpdateContext ctx, PageResult result, CancellationToken ct)
{
if (result.NavigateTo is not null)
{
if (result.NavigateTo.Replace)
await ReplaceAsync(result.NavigateTo.PageId, result.NavigateTo.Args, ctx, ct);
else
await PushAsync(result.NavigateTo.PageId, result.NavigateTo.Args, ctx, ct);
return; // навигация сама вызовет Enter новой страницы и применит её результат
}
if (result.Message is not null)
await ctx.Client.SendTextAsync(ctx.Chat.Id, result.Message, result.Actions, ct);
if (result.Files is not null)
await ctx.Client.SendFilesAsync(ctx.Chat.Id, result.Files, ct);
}
/// <summary>
/// Возвращает текущую запись стека.
/// </summary>
public async Task<NavEntry?> CurrentAsync(UpdateContext ctx, CancellationToken ct)
{
var state = await _store.GetAsync(ctx.Client.Id, ctx.User.Id, ct);
return state.Stack.Count == 0 ? null : state.Stack[^1];
}
/// <summary>
/// Возвращает весь стек навигации.
/// </summary>
public async Task<IReadOnlyList<NavEntry>> StackAsync(UpdateContext ctx, CancellationToken ct)
{
var state = await _store.GetAsync(ctx.Client.Id, ctx.User.Id, ct);
return state.Stack.AsReadOnly();
}
_routes = routes;
}
}
internal void AddDefaultPage<TPage>() where TPage : Page
{
_defaultPage = typeof(TPage);
}
/// <summary>
/// Перейти по маршруту без аргументов.
/// </summary>
public Task GoToHome(PageContext ctx, CancellationToken ct)
{
return NavigateAsync(_defaultPage!, ctx, null, ct);
}
/// <summary>
/// Перейти по маршруту без аргументов.
/// </summary>
public Task GoToAsync(string route, PageContext ctx, CancellationToken ct)
{
var pageType = _routes.Resolve(route);
return NavigateAsync(pageType!, ctx, null, ct);
}
/// <summary>
/// Перейти по маршруту с аргументами.
/// </summary>
public Task GoToAsync<TArgs>(string route, TArgs args, PageContext ctx, CancellationToken ct)
{
var pageType = _routes.Resolve(route);
return NavigateAsync(pageType!, ctx, args!, ct);
}
/// <summary>
/// Перейти на страницу без аргументов.
/// </summary>
public Task GoToAsync<TPage>(PageContext ctx, CancellationToken ct) where TPage : Page
=> NavigateAsync(typeof(TPage), ctx, null, ct);
/// <summary>
/// Перейти на страницу с аргументами.
/// </summary>
public Task GoToAsync<TPage, TArgs>(PageContext ctx, TArgs args, CancellationToken ct) where TPage : StatefullPage<TArgs>
=> NavigateAsync(typeof(TPage), ctx, args!, ct);
/// <summary>
/// Заменить текущую страницу.
/// </summary>
public Task ReplaceWithAsync<TPage>(PageContext ctx, CancellationToken ct) where TPage : Page
=> NavigateAsync(typeof(TPage), ctx, null, ct, replace: true);
internal async Task NavigateAsync(Type pageType, PageContext ctx, object? args, CancellationToken ct, bool replace = false)
{
Page? page;
if (typeof(SingletonPage).IsAssignableFrom(pageType))
{
// Singleton: один объект на всё приложение
if (!_singletonPages.TryGetValue(pageType, out page))
{
page = (Page)Activator.CreateInstance(pageType)!;
_singletonPages[pageType] = page;
}
}
else
{
// Stateful: новый объект на пользователя
page = (Page)Activator.CreateInstance(pageType)!;
}
if (_sessionPages.TryGetValue(ctx.SessionKey, out var currentPage))
{
if (currentPage.GetType() != pageType || replace)
{
await currentPage.OnLeave(ctx, ct);
}
}
_sessionPages[ctx.SessionKey] = page;
if (args is null)
await page.OnEnter(ctx, ct);
else
await (page as dynamic).OnEnter(ctx, (dynamic)args, ct);
}
/// <summary>
/// Восстановить текущую страницу из StateStorage.
/// </summary>
public Page? ResolveCurrentPage(PageContext ctx)
=> _sessionPages.TryGetValue(ctx.SessionKey, out var page) ? page : null;
}

28
BotPages.Core/Navigation/UserState.cs
View File

@@ -1,28 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Состояние пользователя: навигационный стек и общий словарь данных.
/// </summary>
public sealed class UserState
{
/// <summary>
/// Идентификатор пользователя.
/// </summary>
public required long UserId { get; init; }
/// <summary>
/// Идентификатор клиента чата.
/// </summary>
public required string ChatClientId { get; init; }
/// <summary>
/// Навигационный стек страниц.
/// </summary>
public List<NavEntry> Stack { get; } = new();
/// <summary>
/// Общая сумка данных, доступная на всех страницах.
/// </summary>
public Dictionary<string, object?> Bag { get; } = new();
}
}

20
BotPages.Core/Pages/ActionAttribute.cs
View File

@@ -1,20 +0,0 @@
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations.Schema;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace BotPages.Core
{
public class ActionAttribute : Attribute
{
public ActionAttribute(string label)
{
Label = label;
}
public string Label { get; }
}
}

48
BotPages.Core/Pages/ActionExtensions.cs
View File

@@ -1,48 +0,0 @@
using System.Reflection;
namespace BotPages.Core
{
public static class ActionExtensions
{
private static readonly Dictionary<Type, Dictionary<string, object>> _cache = new();
public static string GetActionLabel<T>(this T value)
where T : Enum
{
var fieldName = value.ToString();
var field = typeof(T).GetField(fieldName, BindingFlags.Public | BindingFlags.Static);
return field?.GetCustomAttribute<ActionAttribute>()?.Label ?? fieldName;
}
public static T? FromActionLabel<T>(string? value) where T : struct, Enum
{
if (value == null) return null;
var type = typeof(T);
if (!_cache.TryGetValue(type, out var map))
{
map = new Dictionary<string, object>();
var fields = type.GetFields(BindingFlags.Public | BindingFlags.Static);
foreach (var field in fields)
{
var fieldValue = field.GetValue(null)!;
var fieldName = field.Name;
var attr = field.GetCustomAttribute<ActionAttribute>();
if (attr != null)
{
fieldName = attr.Label;
}
map[fieldName] = fieldValue;
}
}
return map.TryGetValue(value, out var result) ? (T)result : null;
}
}
}

20
BotPages.Core/Pages/ActionPlacement.cs
View File

@@ -1,20 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Тип размещения кнопки.
/// </summary>
public enum ActionPlacement
{
/// <summary>
/// Inline‑кнопка (под сообщением).
/// </summary>
Inline,
/// <summary>
/// Reply‑кнопка (заменяет системную клавиатуру).
/// </summary>
Reply
}
}

28
BotPages.Core/Pages/IPage.cs
View File

@@ -1,28 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Контракт страницы: экран диалога с жизненным циклом.
/// </summary>
public interface IPage
{
/// <summary>
/// Статический идентификатор страницы.
/// </summary>
string Id { get; }
/// <summary>
/// Вызывается при входе на страницу (рендер, приветствие).
/// </summary>
Task<PageResult> EnterAsync(UpdateContext ctx, CancellationToken ct);
/// <summary>
/// Обработка входящего события/сообщения на странице.
/// </summary>
Task<PageResult> HandleAsync(UpdateContext ctx, CancellationToken ct);
/// <summary>
/// Вызывается при выходе со страницы (очистка, финализация).
/// </summary>
Task ExitAsync(UpdateContext ctx, CancellationToken ct);
}
}

26
BotPages.Core/Pages/IPageRegistry.cs
View File

@@ -1,26 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Реестр страниц с доступом по идентификатору.
/// </summary>
public interface IPageRegistry
{
IPage DefaultPage { get; }
/// <summary>
/// Возвращает страницу по идентификатору.
/// </summary>
IPage Get(string id);
/// <summary>
/// Пытается получить страницу по идентификатору.
/// </summary>
bool TryGet(string id, out IPage? page);
/// <summary>
/// Возвращает все зарегистрированные страницы.
/// </summary>
IEnumerable<IPage> All();
IPage GetOrDefault(string id);
}
}

54
BotPages.Core/Pages/Page.cs
View File

@@ -1,32 +1,28 @@
namespace BotPages.Core
using BotPages.Core.Abstractions;
using BotPages.Core.Context;
namespace BotPages.Core;
/// <summary>
/// Базовый класс страницы.
/// </summary>
public abstract class Page
{
/// <summary>
/// Базовая реализация страницы без обязательных переопределений.
/// </summary>
public abstract class Page : IPage
{
/// <summary>
/// Идентификатор страницы.
/// </summary>
public virtual string Id => GetType().Name;
/// <summary>
/// Виртуальный метод входа; по умолчанию ничего не делает.
/// </summary>
public virtual Task<PageResult> EnterAsync(UpdateContext ctx, CancellationToken ct) =>
Task.FromResult(new PageResult());
/// <summary>
/// Абстрактная обработка событий; обязателен к реализации.
/// </summary>
public abstract Task<PageResult> HandleAsync(UpdateContext ctx, CancellationToken ct);
/// <summary>
/// Виртуальный метод выхода; по умолчанию ничего не делает.
/// </summary>
public virtual Task ExitAsync(UpdateContext ctx, CancellationToken ct) =>
Task.CompletedTask;
}
/// <summary>Вход на страницу.</summary>
public virtual Task OnEnter(PageContext ctx, CancellationToken ct) => Task.CompletedTask;
/// <summary>Общий обработчик обновлений.</summary>
public virtual Task OnUpdate(PageContext ctx, UpdateContext update, CancellationToken ct) => Task.CompletedTask;
/// <summary>Обработка текста.</summary>
public virtual Task OnText(PageContext ctx, string text, CancellationToken ct) => Task.CompletedTask;
/// <summary>Обработка файлов.</summary>
public virtual Task OnFile(PageContext ctx, List<FileDescriptor> files, CancellationToken ct) => Task.CompletedTask;
/// <summary>Обработка кнопки.</summary>
public virtual Task OnButton(PageContext ctx, string payload, CancellationToken ct) => Task.CompletedTask;
/// <summary>Выход со страницы.</summary>
public virtual Task OnLeave(PageContext ctx, CancellationToken ct) => Task.CompletedTask;
/// <summary>Таймаут бездействия.</summary>
public virtual Task OnTimeout(PageContext ctx, TimeSpan timeout, CancellationToken ct) => Task.CompletedTask;
/// <summary>Обработка ошибок.</summary>
public virtual Task OnError(PageContext ctx, Exception ex, CancellationToken ct) => Task.CompletedTask;
}

40
BotPages.Core/Pages/PageAction.cs
View File

@@ -1,40 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Универсальное действие (кнопка), которое может быть отображено в разных клиентах.
/// </summary>
public sealed class PageAction
{
/// <summary>
/// Текст кнопки, отображаемый пользователю.
/// </summary>
public string Label { get; init; } = "";
/// <summary>
/// Значение (payload), которое будет передано в <see cref="UpdateContext.Text"/> при нажатии.
/// </summary>
public string Value { get; init; } = "";
/// <summary>
/// Тип кнопки: inline или reply.
/// </summary>
public ActionPlacement Placement { get; init; } = ActionPlacement.Reply;
/// <summary>
/// Номер ряда для макета (0 — первая строка).
/// </summary>
public int Row { get; init; } = 0;
public PageAction()
{
}
public PageAction(Enum en)
{
Label = en.GetActionLabel();
Value = en.ToString();
}
}
}

39
BotPages.Core/Pages/PageMessage.cs
View File

@@ -1,39 +0,0 @@
/// <summary>
/// Параметры сообщения.
/// </summary>
public sealed class PageMessage
{
/// <summary>
/// Текст сообщения.
/// </summary>
public required string Text { get; init; }
/// <summary>
/// Формат сообщения (Plain/Markdown/Html).
/// </summary>
public MessageFormat Format { get; init; } = MessageFormat.Plain;
/// <summary>
/// Отправить сообщение без уведомления (тихий режим).
/// </summary>
public bool IsSilent { get; init; } = false;
public static implicit operator PageMessage(string text)
=> new PageMessage { Text = text, Format = MessageFormat.Plain };
}
/// <summary>
/// Тип форматирования сообщения.
/// </summary>
public enum MessageFormat
{
/// <summary>Обычный текст без форматирования.</summary>
Plain,
/// <summary>Markdown.</summary>
Markdown,
/// <summary>HTML.</summary>
Html,
}

21
BotPages.Core/Pages/PageNavigate.cs
View File

@@ -1,21 +0,0 @@
/// <summary>
/// Параметры навигации на другую страницу.
/// </summary>
public sealed class PageNavigate
{
/// <summary>
/// Идентификатор страницы, на которую нужно перейти.
/// </summary>
public required string PageId { get; init; }
/// <summary>
/// Дополнительные аргументы для навигации.
/// </summary>
public object? Args { get; init; }
/// <summary>
/// Заменить текущую навигацию на новую.
/// </summary>
public bool Replace { get; init; }
}

84
BotPages.Core/Pages/PageRegistry.cs
View File

@@ -1,84 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Базовая реализация реестра страниц на словаре.
/// </summary>
public sealed class PageRegistry : IPageRegistry
{
private readonly Dictionary<string, IPage> _pages = new(StringComparer.Ordinal);
private readonly IPage _defaultPage;
/// <summary>
/// Создаёт реестр из набора страниц.
/// </summary>
public PageRegistry(IEnumerable<IPage> pages) : this(pages, pages.First())
{
}
/// <summary>
/// Создаёт реестр из набора страниц.
/// </summary>
public PageRegistry(IEnumerable<IPage> pages, IPage defaultPage)
{
foreach (var p in pages) _pages[p.Id] = p;
_defaultPage = defaultPage;
}
/// <summary>
/// Возвращает страницу по идентификатору.
/// </summary>
public IPage Get(string id) => _pages[id];
/// <summary>
/// Возвращает страницу по идентификатору. Если страницы нет, возвращает дефолтную.
/// </summary>
public IPage GetOrDefault(string id)
=> _pages.TryGetValue(id, out var page) ? page : _defaultPage;
/// <summary>
/// Возвращает дефолтную страницу.
/// </summary>
public IPage DefaultPage => _defaultPage;
/// <summary>
/// Пытается получить страницу по идентификатору.
/// </summary>
public bool TryGet(string id, out IPage? page) => _pages.TryGetValue(id, out page);
/// <summary>
/// Возвращает все зарегистрированные страницы.
/// </summary>
public IEnumerable<IPage> All() => _pages.Values;
/// <summary>
/// Создаёт реестр страниц из всех сборок приложения.
/// </summary>
public static PageRegistry CreateFromApplication(string? defaultPageId = null)
{
// Берём все загруженные сборки в текущем AppDomain
var assemblies = AppDomain.CurrentDomain.GetAssemblies();
// Находим все классы, реализующие IPage
var pages = assemblies
.SelectMany(a => a.GetTypes())
.Where(t => typeof(IPage).IsAssignableFrom(t) && !t.IsAbstract && t.GetConstructor(Type.EmptyTypes) != null)
.Select(t => (IPage)Activator.CreateInstance(t)!)
.ToList();
if (pages.Count == 0)
throw new InvalidOperationException($"В приложении не найдено ни одной страницы ({nameof(IPage)}).");
// Определяем страницу по умолчанию
var defaultPage = defaultPageId != null
? pages.FirstOrDefault(p => p.Id == defaultPageId)
: pages.First();
if (defaultPage == null)
throw new InvalidOperationException($"Не найдена страница с Id={defaultPageId}.");
return new PageRegistry(pages, defaultPage);
}
}
}

28
BotPages.Core/Pages/PageResult.cs
View File

@@ -1,28 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Результат обработки страницы: текст, файлы, кнопки или навигация.
/// </summary>
public sealed class PageResult
{
/// <summary>
/// Параметры перехода страницы, на которую нужно перейти.
/// </summary>
public PageNavigate? NavigateTo { get; init; }
/// <summary>
/// Текст сообщения (опционально).
/// </summary>
public PageMessage? Message { get; init; }
/// <summary>
/// Файлы для отправки (опционально).
/// </summary>
public IReadOnlyList<FileDescriptor>? Files { get; init; }
/// <summary>
/// Кнопки (inline или reply), которые должны быть отображены пользователю.
/// </summary>
public IReadOnlyList<PageAction>? Actions { get; init; }
}
}

98
BotPages.Core/Pages/PageResultBuilder.cs
View File

@@ -1,98 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Билдер для удобного создания <see cref="PageResult"/>.
/// Мутабельный, но итоговый объект иммутабелен.
/// </summary>
public sealed class PageResultBuilder
{
private PageNavigate? _navigateTo;
private PageMessage? _message;
private List<FileDescriptor>? _files;
private List<PageAction>? _actions;
/// <summary>
/// Устанавливает текст сообщения.
/// </summary>
public PageResultBuilder WithText(string text, MessageFormat format)
=> WithText(new PageMessage()
{
Text = text,
Format = format,
});
/// <summary>
/// Устанавливает текст сообщения.
/// </summary>
public PageResultBuilder WithText(string text)
=> WithText(new PageMessage()
{
Text = text,
Format = MessageFormat.Plain,
});
/// <summary>
/// Устанавливает текст сообщения.
/// </summary>
public PageResultBuilder WithText(PageMessage message)
{
_message = message;
return this;
}
/// <summary>
/// Добавляет клавиатуру (набор кнопок).
/// </summary>
public PageResultBuilder WithKeyboard(IEnumerable<PageAction> actions)
{
_actions = actions?.ToList();
return this;
}
/// <summary>
/// Добавляет файлы.
/// </summary>
public PageResultBuilder WithFiles(IEnumerable<FileDescriptor> files)
{
_files = files?.ToList();
return this;
}
/// <summary>
/// Устанавливает навигацию на другую страницу.
/// </summary>
public PageResultBuilder WithNavigate(string pageId, object? args = null, bool replace = true)
=> WithNavigate(new PageNavigate()
{
PageId = pageId,
Args = args,
Replace = replace,
});
/// <summary>
/// Устанавливает навигацию на другую страницу.
/// </summary>
public PageResultBuilder WithNavigate(PageNavigate navigate)
{
_navigateTo = navigate;
return this;
}
/// <summary>
/// Собирает итоговый иммутабельный <see cref="PageResult"/>.
/// </summary>
public PageResult Build() => new PageResult
{
Message = _message,
Actions = _actions,
Files = _files,
NavigateTo = _navigateTo,
};
/// <summary>
/// Создаёт новый пустой билдер.
/// </summary>
public static PageResultBuilder Empty() => new PageResultBuilder();
}
}

16
BotPages.Core/Pages/PageStateAttribute.cs Normal file
View File

@@ -0,0 +1,16 @@
namespace BotPages.Core;
/// <summary>
/// Атрибут для свойств страницы, которые должны сохраняться в StateStorage.
/// </summary>
[AttributeUsage(AttributeTargets.Property)]
public sealed class StatefullAttribute : Attribute
{
/// <summary>
/// Ключ из Storage
/// </summary>
public string Key { get; }
///<inheritdoc/>
public StatefullAttribute(string key) => Key = key;
}

7
BotPages.Core/Pages/SingletonPage.cs Normal file
View File

@@ -0,0 +1,7 @@
namespace BotPages.Core;
/// <summary>
/// Базовый класс страницы без состояния.
/// Создается один экземпляр на все приложение.
/// </summary>
public abstract class SingletonPage : Page { }

54
BotPages.Core/Pages/StatefullPage.cs Normal file
View File

@@ -0,0 +1,54 @@
using System.Reflection;
namespace BotPages.Core;
/// <summary>
/// Базовый класс страницы с состоянием и аргументами.
/// </summary>
public abstract class StatefullPage<TArgs> : StatefullPage
{
/// <summary>Вход на страницу с аргументами.</summary>
public virtual Task OnEnter(PageContext ctx, TArgs args, CancellationToken ct)
=> base.OnEnter(ctx, ct);
}
/// <summary>
/// Базовый класс страницы с состоянием.
/// Создается для каждого пользователя.
/// </summary>
public abstract class StatefullPage : Page
{
/// <summary>
/// Загружает значения свойств из StateStorage.
/// </summary>
internal async Task LoadState(PageContext ctx, CancellationToken ct)
{
foreach (var prop in GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance))
{
var attr = prop.GetCustomAttribute<StatefullAttribute>();
if (attr is null) continue;
var value = await ctx.StateStorage.GetAsync<object>(ctx.SessionKey, attr.Key, ct);
if (value is not null)
{
prop.SetValue(this, value);
}
}
}
/// <summary>
/// Сохраняет значения свойств в StateStorage.
/// </summary>
internal async Task SaveState(PageContext ctx, CancellationToken ct)
{
foreach (var prop in GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance))
{
var attr = prop.GetCustomAttribute<StatefullAttribute>();
if (attr is null) continue;
var value = prop.GetValue(this);
await ctx.StateStorage.SetAsync(ctx.SessionKey, attr.Key, value, ct);
}
}
}

24
BotPages.Core/Pipeline/ErrorHandlingMiddleware.cs
View File

@@ -1,24 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Middleware обработки ошибок для надёжности.
/// </summary>
public sealed class ErrorHandlingMiddleware : IUpdateMiddleware
{
/// <summary>
/// Перехватывает исключения и отправляет сообщение об ошибке пользователю.
/// </summary>
public async Task InvokeAsync(UpdateContext ctx, Func<Task> next, CancellationToken ct)
{
try
{
await next();
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex}");
await ctx.Client.SendTextAsync(ctx.Chat.Id, "Произошла ошибка. Попробуйте ещё раз. /start", null, ct);
}
}
}
}

13
BotPages.Core/Pipeline/IRouter.cs
View File

@@ -1,13 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Маршрутизатор обновлений на страницы.
/// </summary>
public interface IRouter
{
/// <summary>
/// Определяет текущую страницу и вызывает её обработчик.
/// </summary>
Task RouteAsync(UpdateContext ctx, CancellationToken ct);
}
}

13
BotPages.Core/Pipeline/IUpdateMiddleware.cs
View File

@@ -1,13 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Middleware обработки входящих обновлений.
/// </summary>
public interface IUpdateMiddleware
{
/// <summary>
/// Вызывает промежуточную логику, затем следующий обработчик или роутер.
/// </summary>
Task InvokeAsync(UpdateContext ctx, Func<Task> next, CancellationToken ct);
}
}

17
BotPages.Core/Pipeline/LoggingMiddleware.cs
View File

@@ -1,17 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Middleware логирования входящих обновлений.
/// </summary>
public sealed class LoggingMiddleware : IUpdateMiddleware
{
/// <summary>
/// Логирует базовую информацию об обновлении и вызывает следующий этап.
/// </summary>
public async Task InvokeAsync(UpdateContext ctx, Func<Task> next, CancellationToken ct)
{
Console.WriteLine($"[{DateTime.UtcNow:O}] Update: chat={ctx.Chat.Id}, user={ctx.User.Id}, text={ctx.Text}");
await next();
}
}
}

34
BotPages.Core/Pipeline/Pipeline.cs
View File

@@ -1,34 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Конвейер выполнения middleware и роутера.
/// </summary>
public sealed class Pipeline
{
private readonly IReadOnlyList<IUpdateMiddleware> _middlewares;
private readonly IRouter _router;
/// <summary>
/// Создаёт конвейер обработки обновлений.
/// </summary>
public Pipeline(IEnumerable<IUpdateMiddleware> middlewares, IRouter router)
{
_middlewares = middlewares.ToList();
_router = router;
}
/// <summary>
/// Запускает выполнение конвейера для заданного контекста.
/// </summary>
public Task ExecuteAsync(UpdateContext ctx, CancellationToken ct)
{
var index = 0;
Task Next() => (index < _middlewares.Count)
? _middlewares[index++].InvokeAsync(ctx, Next, ct)
: _router.RouteAsync(ctx, ct);
return Next();
}
}
}

45
BotPages.Core/Pipeline/Router.cs
View File

@@ -1,45 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Простой роутер: команды верхнего уровня и делегирование текущей странице.
/// </summary>
public sealed class Router : IRouter
{
private readonly IPageRegistry _pages;
/// <summary>
/// Создаёт роутер страниц.
/// </summary>
public Router(IPageRegistry pages) => _pages = pages;
/// <summary>
/// Определяет текущую страницу и вызывает её обработчик.
/// </summary>
public async Task RouteAsync(UpdateContext ctx, CancellationToken ct)
{
var text = ctx.Text ?? string.Empty;
if (text.StartsWith("/start", StringComparison.Ordinal))
{
await ctx.Nav.ReplaceAsync(_pages.DefaultPage.Id, null, ctx, ct);
return;
}
var current = (await ctx.Nav.CurrentAsync(ctx, ct))?.PageId;
if (current is not null)
{
var pr = await _pages.Get(current).HandleAsync(ctx, ct);
await ctx.Nav.ApplyResultAsync(ctx, pr, ct);
return;
}
else
{
await ctx.Nav.ReplaceAsync(_pages.DefaultPage.Id, null, ctx, ct);
return;
}
//TODO: Вынести в "дефолтный /start page"
await ctx.Client.SendTextAsync(ctx.Chat.Id, "Не понимаю. Нажмите /start.", null, ct);
}
}
}

25
BotPages.Core/Pipeline/ThrottleMiddleware.cs
View File

@@ -1,25 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Middleware троттлинга для ограничений нагрузки.
/// </summary>
public sealed class ThrottleMiddleware : IUpdateMiddleware
{
private readonly TimeSpan _delay;
/// <summary>
/// Создаёт middleware троттлинга.
/// </summary>
public ThrottleMiddleware(TimeSpan delay) => _delay = delay;
/// <summary>
/// Добавляет искусственную задержку перед продолжением обработки.
/// </summary>
public async Task InvokeAsync(UpdateContext ctx, Func<Task> next, CancellationToken ct)
{
await Task.Delay(_delay, ct);
await next();
}
}
}

59
BotPages.Core/Routing/CommandsRegistry.cs Normal file
View File

@@ -0,0 +1,59 @@
namespace BotPages.Core.Routing;
using System.Text.RegularExpressions;
/// <summary>
/// Реестр команд, доступных из любого места.
/// </summary>
internal sealed class CommandsRegistry
{
private readonly List<(Regex pattern, Func<PageContext, CancellationToken, Task> handler)> _commands = new();
/// <summary>
/// Зарегистрировать команду, ведущую на страницу.
/// </summary>
public CommandsRegistry Map<TPage>(string commandTemplate) where TPage : Page
{
var pattern = ToRegex(commandTemplate);
_commands.Add((pattern, (ctx, ct) => ctx.Navigation.GoToAsync<TPage>(ctx, ct)));
return this;
}
/// <summary>
/// Зарегистрировать команду с кастомным обработчиком.
/// </summary>
public CommandsRegistry Map(string commandTemplate, Func<PageContext, CancellationToken, Task> handler)
{
var pattern = ToRegex(commandTemplate);
_commands.Add((pattern, handler));
return this;
}
/// <summary>
/// Попробовать выполнить команду.
/// </summary>
public bool TryDispatch(PageContext ctx, string command, CancellationToken ct, out Task? task)
{
foreach (var (pattern, handler) in _commands)
{
if (pattern.IsMatch(command))
{
task = handler(ctx, ct);
return true;
}
}
task = null;
return false;
}
private static Regex ToRegex(string template)
{
// Простейшее преобразование шаблона: "/open {page} {id?}" -> Regex
var escaped = Regex.Escape(template)
.Replace("\\{", "{").Replace("\\}", "}");
var pattern = "^" + escaped
.Replace("{page}", "(?<page>\\S+)")
.Replace("{id?}", "(?<id>\\S+)?") + "$";
return new Regex(pattern, RegexOptions.Compiled | RegexOptions.IgnoreCase);
}
}

18
BotPages.Core/Routing/RouteAttribute.cs Normal file
View File

@@ -0,0 +1,18 @@
namespace BotPages.Core.Routing;
/// <summary>
/// Атрибут для декларативного указания маршрута страницы.
/// </summary>
[AttributeUsage(AttributeTargets.Class, AllowMultiple = true)]
public sealed class RouteAttribute : Attribute
{
/// <summary>
/// Шаблон маршрута.
/// </summary>
public string Template { get; }
/// <summary>
/// Создать атрибут маршрута.
/// </summary>
public RouteAttribute(string template) => Template = template;
}

29
BotPages.Core/Routing/RoutesRegistry.cs Normal file
View File

@@ -0,0 +1,29 @@
namespace BotPages.Core.Routing;
/// <summary>
/// Реестр маршрутов страниц.
/// </summary>
internal sealed class RoutesRegistry
{
private readonly Dictionary<string, Type> _routes = new(StringComparer.OrdinalIgnoreCase);
/// <summary>
/// Зарегистрировать маршрут для страницы.
/// </summary>
public void Map<TPage>(string template) where TPage : Page
{
if (_routes.ContainsKey(template))
throw new InvalidOperationException($"Route '{template}' is already mapped.");
_routes[template] = typeof(TPage);
}
/// <summary>
/// Найти страницу по маршруту.
/// </summary>
public Type? Resolve(string template) => _routes.TryGetValue(template, out var t) ? t : null;
/// <summary>
/// Получить снимок всех маршрутов.
/// </summary>
public IReadOnlyDictionary<string, Type> Snapshot() => _routes;
}

32
BotPages.Core/Storage/InMemoryStateStorage.cs Normal file
View File

@@ -0,0 +1,32 @@
using BotPages.Core.Abstractions;
using System.Collections.Concurrent;
namespace BotPages.Core.Storage;
/// <summary>
/// Памятное хранилище состояния.
/// </summary>
public sealed class InMemoryStateStorage : IStateStorage
{
private readonly ConcurrentDictionary<CompositeSessionKey, ConcurrentDictionary<string, object?>> _store = new();
/// <inheritdoc />
public Task<T?> GetAsync<T>(CompositeSessionKey session, string key, CancellationToken ct)
=> Task.FromResult(_store.TryGetValue(session, out var dict) ?
dict.TryGetValue(key, out var obj) ? (T?)obj : default
: default);
/// <inheritdoc />
public Task SetAsync<T>(CompositeSessionKey session, string key, T state, CancellationToken ct)
{
_store[session][key] = state!;
return Task.CompletedTask;
}
/// <inheritdoc />
public Task<bool> RemoveAsync(CompositeSessionKey session, string key, CancellationToken ct)
=> Task.FromResult(_store.TryGetValue(session, out var dict) ? dict.TryRemove(key, out _) : true);
public Task<bool> ClearAsync(CompositeSessionKey session, CancellationToken ct)
=> Task.FromResult(_store.TryRemove(session, out _));
}

43
BotPages.Core/Transport/DefaultFileService.cs
View File

@@ -1,43 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Транспорт-независимая реализация отправки пачек через клиент.
/// </summary>
public sealed class DefaultFileService : IFileService
{
/// <summary>
/// Заглушка загрузки файла (реализуется в адаптере транспорта).
/// </summary>
public Task<FileDescriptor> DownloadAsync(string fileId, CancellationToken ct)
{
throw new System.NotImplementedException("DownloadAsync должен быть реализован конкретным транспортным адаптером.");
}
/// <summary>
/// Загружает несколько файлов по идентификаторам.
/// </summary>
public async Task<IReadOnlyList<FileDescriptor>> DownloadManyAsync(IEnumerable<string> fileIds, CancellationToken ct)
{
var res = new List<FileDescriptor>();
foreach (var id in fileIds)
res.Add(await DownloadAsync(id, ct));
return res;
}
/// <summary>
/// Отправляет один файл через клиент.
/// </summary>
public Task SendAsync(IChatClient client, long chatId, FileDescriptor file, CancellationToken ct)
{
return client.SendFilesAsync(chatId, new[] { file }, ct);
}
/// <summary>
/// Отправляет несколько файлов через клиент.
/// </summary>
public Task SendManyAsync(IChatClient client, long chatId, IEnumerable<FileDescriptor> files, CancellationToken ct)
{
return client.SendFilesAsync(chatId, files, ct);
}
}
}

32
BotPages.Core/Transport/IChatClient.cs
View File

@@ -1,32 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Универсальный клиент для отправки сообщений и файлов в чат.
/// Адаптеры реализуют этот интерфейс.
/// </summary>
public interface IChatClient
{
/// <summary>
/// Идентификатор клиента.
/// </summary>
string Id { get; init; }
/// <summary>
/// Отправляет текстовое сообщение.
/// Может сопровождаться клавиатурой (inline или reply).
/// </summary>
/// <param name="chatId">Идентификатор чата.</param>
/// <param name="message">Сообщение.</param>
/// <param name="actions">Кнопки для отображения (опционально).</param>
/// <param name="ct">Токен отмены.</param>
Task SendTextAsync(long chatId, PageMessage message, IEnumerable<PageAction>? actions, CancellationToken ct);
/// <summary>
/// Отправляет файлы в чат.
/// </summary>
/// <param name="chatId">Идентификатор чата.</param>
/// <param name="files">Файлы для отправки.</param>
/// <param name="ct">Токен отмены.</param>
Task SendFilesAsync(long chatId, IEnumerable<FileDescriptor> files, CancellationToken ct);
}
}

28
BotPages.Core/Transport/IFileService.cs
View File

@@ -1,28 +0,0 @@
namespace BotPages.Core
{
/// <summary>
/// Сервис работы с файлами: загрузка и отправка пакетами.
/// </summary>
public interface IFileService
{
/// <summary>
/// Загружает файл по идентификатору транспорта.
/// </summary>
Task<FileDescriptor> DownloadAsync(string fileId, CancellationToken ct);
/// <summary>
/// Загружает несколько файлов по их идентификаторам.
/// </summary>
Task<IReadOnlyList<FileDescriptor>> DownloadManyAsync(IEnumerable<string> fileIds, CancellationToken ct);
/// <summary>
/// Отправляет один файл в чат.
/// </summary>
Task SendAsync(IChatClient client, long chatId, FileDescriptor file, CancellationToken ct);
/// <summary>
/// Отправляет несколько файлов в чат.
/// </summary>
Task SendManyAsync(IChatClient client, long chatId, IEnumerable<FileDescriptor> files, CancellationToken ct);
}
}