Max API Node.js SDK

Небольшой WebSocket‑клиент на TypeScript, повторяющий публичный интерфейс Python‑библиотеки pymax. Позволяет подключиться к неофициальному API мессенджера Max, обрабатывать входящие сообщения и запрашивать историю/файлы в нативных Node.js проектах.

Установка

npm install maxapi-node

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

import { MaxClient } from "maxapi-node";

const client = new MaxClient({
  phone: "+79990000000",
  workDir: "./sessions/user1",
});

client.onStart(async () => {
  console.log("MAX готов, синхронизация завершена");
});

client.onMessage(async (message) => {
  console.log(
    `[${message.chatId}] ${message.senderId}: ${message.text ?? "<без текста>"}`
  );
});

await client.start();

При первом запуске библиотека запросит код подтверждения из SMS и сохранит постоянный токен/устройство в workDir/session.json, после чего будет переподключаться автоматически.

API

• MaxClient(options) — основной класс.
• onMessage / onMessageEdit / onMessageDelete — обработчики входящих событий.
• onStart — вызывается после успешного SYNC.
• fetchHistory({ chatId, from, forward, backward }) — получение истории.
• getVideoById(chatId, messageId, videoId) и getFileById(chatId, messageId, fileId) — ссылки на вложения.
• close() — завершение работы и остановка фоновых задач.

Публикация в npm

1. Соберите пакет: npm run build.
2. Авторизуйтесь: npm login.
3. Обновите версию в package.json.
4. Выложите артефакты: npm publish --access public.

После публикации пакет можно установить в любом проекте командой npm install maxapi-node.