Architecture

Verse Bot Framework построен на универсальном контексте (UniversalContext) и адаптерах для Telegram и VK. Одна команда пишется один раз и работает на обеих платформах.

UniversalContext

UniversalContext – это интерфейс, скрывающий различия между Telegram API и VK API. Команды получают объект контекста, через который они могут:

• отвечать пользователю (reply, replySafe)
• получать информацию о сообщении (text, userId, chatType)
• проверять права (isAdmin)
• работать с БД (db)
• отправлять клавиатуры и фото

Адаптеры

• @verse/tg-core — создаёт бота на GrammY, преобразует входящие обновления в UniversalContext, регистрирует команды.
• @verse/vk-core — собственный клиент VK API (Long Poll), создаёт контекст и подписывается на события.

Фабрики универсальных ботов

Функции createUniversalTelegramBot и createUniversalVKBot скрывают весь шаблонный код: middleware аутентификации, логирование, регистрацию команд. Достаточно передать список обработчиков команд и кнопок.

const tgBot = createUniversalTelegramBot({
  token: '...',
  commands: { start: startCommand },
  buttons: [{ command: 'start', label: 'Начать' }],
});
tgBot.start();

Жизненный цикл сообщения

• Входящее обновление от Telegram / VK.
• Адаптер создаёт UniversalContext.
• Middleware проверяет существование пользователя в БД (создаёт запись при /start).
• Логирует команду в command_logs.
• Вызывает соответствующий обработчик команды.
• Обработчик использует методы контекста для ответа.

Таким образом, команды не зависят от платформы.