umbot

umbot — это первая в своём роде TypeScript-библиотека для разработки чат-ботов и голосовых навыков с единой бизнес-логикой под все ведущие российские платформы: Яндекс.Алиса, Маруся, Сбер SmartApp, а также Telegram, VK, MAX и Viber.

В отличие от большинства решений, требующих отдельной реализации под каждую платформу, umbot абстрагирует различия в форматах запросов и ответов, предоставляя разработчику единый, предсказуемый интерфейс. Это позволяет писать логику один раз — и запускать её везде.

---

💡 Почему umbot?

Больше не нужно писать три версии одного навыка.
Больше не нужно разбираться в JSON-форматах Алисы, Сбера и Маруси.
Ваша логика — одна. Платформы — любые.

Ключевые преимущества:

• ✅ Алиса + Маруся + Сбер SmartApp + ... — одновременно, без костылей
• ⚡ Гарантированное время обработки ≤1 сек (оставляет минимум 2 сек на вашу логику)
• 🔒 Безопасная обработка регулярных выражений с защитой от ReDoS
• 💾 Встроенное состояние, кэширование медиа, кнопки, карточки — «из коробки»
• 🛠 TypeScript, CLI, автодополнение, 80%+ покрытие тестами

umbot — пишешь один раз, запускаешь везде.

🎯 Для кого umbot?

• Команды, поддерживающие навыки на Алисе, Сбере и Марусе одновременно
• Корпорации с внутренними мессенджерами
• Разработчики, уставшие от дублирования кода

---

🧩 Поддерживаемые платформы

Платформа	Идентификатор	Статус
Яндекс.Алиса	alisa	✅ Полная поддержка
Маруся	marusia	✅ Полная поддержка
Сбер SmartApp	smart_app	✅ Полная поддержка
Telegram	telegram	✅ Полная поддержка
VK	vk	✅ Полная поддержка
Max	max_app	✅ Полная поддержка
Viber	viber	✅ Полная поддержка
Ваша платформа	user_application	✅ Базовая поддержка

💡 Нужна своя платформа?
Просто укажите user_application в appType и реализуйте обработку входящих/исходящих сообщений под ваш формат.
Это позволяет интегрировать umbot в любую внутреннюю систему или корпоративный мессенджер.

---

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

Установите библиотеку:

npm install umbot
Copy

Создайте проект за одну команду:

npx umbot create echo
Copy

Поправьте файлы нужным вам образом. Например:

// index.ts
import { Bot } from 'umbot';
import { EchoController } from './EchoController';

const bot = new Bot()
    .setAppConfig({ json: './data', isLocalStorage: true })
    .initBotController(new EchoController())
    .start('localhost', 3000);
Copy

// EchoController.ts
import { BotController, WELCOME_INTENT_NAME } from 'umbot';

export class EchoController extends BotController {
    public action(intentName: string): void {
        if (intentName === WELCOME_INTENT_NAME) {
            this.text = 'Привет! Я повторяю за вами.';
        } else {
            this.text = `Вы сказали: ${this.userCommand}`;
        }
    }
}
Copy

👉 Подробное руководство по запуску

📚 Документация

Подробная документация доступна в следующих разделах:

• Быстрый старт - Подробное описание, для быстрого старта проекта
• API Reference - Подробное описание всех классов, методов и интерфейсов
• Поддерживаемые платформы - Руководство по интеграции с различными платформами
• Конфигурация и безопасность
• Кастомизация HTTP-клиента
• Производительность и гарантии
• Тестирование
• Развертывание
• FAQ

Полезные ссылки

• 📚 Официальная документация
• 📢 Telegram канал
• 💬 Telegram группа
• 📦 npm package
• Создание навыка "Я никогда не"
• Примеры проектов
• Список изменений

🛠 Инструменты разработчика

• CLI команды

📝 Лицензия

MIT License. См. LICENSE для деталей.

🤝 Поддержка

Если у вас есть вопросы или предложения:

• 📧 Email: maximco36895@yandex.ru
• 🐛 Issues на GitHub