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

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();
}
}