UMax

Неофициальный TypeScript-клиент для мессенджера MAX.

Подключение по WebSocket, события входящих сообщений, чаты, контакты и профиль.

Пакет неофициальный и не связан с MAX / VK.

Требования

• Node.js ≥ 24

Установка

npm install @ounezz/umax

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

1. Возьми токен из web.max.ru (DevTools → Console) — скрипт в console_code/get_token.js. Токен действует, пока с аккаунта не выйдут или в него снова не войдут.
2. Положи его в .env:

TOKEN=сюда_токен

3. Запусти:

import "dotenv/config";
import { UMax } from "@ounezz/umax";

const umax = new UMax(process.env.TOKEN);

umax.on("message_send", async ({ sender_id, message }) => {
  if (sender_id === umax.account?.id) return;
  await message.reply(`принял: ${message.text}`);
});

await umax.connect();
console.log(`connected as ${umax.account?.first_name}`);

dotenv ставится отдельно: npm install dotenv.

Возможности

• Account — профиль, смена имени / описания / аватара
• Events — connected / disconnected / reconnecting / error, message_send, message_edit, message_delete, message_react, message_unreact, message_read, typing
• Messages — send / reply / forward / edit / delete / read / react / fetch истории, фото / видео / файлы
• Chats — список, лички и группы, участники, создание группы
• Contacts — список, add / remove / block / unblock

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

Полное описание API — в папке documentation/:

1. Установка → Запуск бота
2. Account
3. Events
4. Messages
5. Chats
6. Contacts