KmsDev.MaxBot 1.1.0

MaxBot C#

Быстрый старт

Подключение пакета

dotnet add package KmsDev.MaxBot

Подключение MaxBotSystem

using KmsDev.MaxBot;

serviceCollections.AddMaxBotSystem();

Если в системе пралируется 1 бот, то можно использовать AddSingletonClient

//бот будет доступен по интерфейсу IMaxBotClient
serviceCollections.AddMaxBotSystem(sc =>
{
    sc.AddSingletonClient(БОТ_ТОКЕН);
});

Ручное создание MaxBotClient

//получить client builder
var maxBotClientBuilder = serviceProvider.GetRequiredService<IMaxBotClientBuilder>();

//создание бота:
//на основе БОТ_ТОКЕН создается `botHash` с использованием `HMACSHA256`
//(опционально - рекомендуется вторым параметром добавить `botHashSecretKey`)
var maxBot = maxBotClientBuilder.Build(БОТ_ТОКЕН);

Использование api

Бот разделен на секции в соотвествии с api документацией

реализовано:

• Api.Bots
• Api.Subscriptions
• Api.Upload
• Api.Messages

в разработке:

• Api.Chats

пример использования api:

using KmsDev.MaxBot.Requests;
using KmsDev.MaxBot.Models;

var response = await maxBot.Api.Messages.SendMessageAsync(new SendMessageRequest
{
    Target = (SendMessageRequest.TargetType.User, {USER_ID}),
    Text = "тест сообщение",
}.WithInlineKeyboardAttachment
(
    [
        new ApiOutputInlineKeyboardCallbackButton
        {
            Text = "тест кнопка",
            Payload = "test_button"
        }
    ]
));

Route Handler

В отдельном проекте KmsDev.MaxBot.Handlers

LongPolling + Manager

В отдельном проекте KmsDev.MaxBot.LongPollingManager

Системная информация

Подключен пакет Microsoft.Extensions.Http.Resilience

• для всех ботов и api запросов используется один RateLimiter pipeline для ограничения в 30rps к серверу
• для LongPolling запроса добавлен RateLimiter с 2rps индивидуально для каждого бота (ограничение со стороны Api начиная с 15.05.2026)
• для каждого api запроса индивидуально добавлен Retry и Timeout pipeline (можно задавать свои лимиты при вызове api)
• для некоторых запросов (например SendMessage с 'attachment.not.ready') используется свой уникальный pipeline, детально в MaxBotRequestsConfigurer

Подключен пакет OneOf

• для поддержки Union types
• в планах перейти на C#14 unions

Подключен пакет Metalama.Framework

• для Source Generation в ядре
• для DI чтобы пользователя каждый раз не заставлять в конструкторе добавлять системные контракты, Metalama будет сама генерировать нужный
• в планах добавить Source Generation для json converters и тд...