umax

UMax is an unofficial TypeScript client for MAX, a messenger app, letting a developer build a bot or automated client that connects to MAX over WebSocket. The README states plainly that the package is not affiliated with MAX or VK, it is a third-party project built by reading how the service works rather than an official integration.

To use it, you first grab an authentication token from the MAX web app by opening its browser DevTools console and running a small helper script included in the project, then save that token in a local .env file. From there, a short piece of code creates a UMax client with the token, listens for events such as incoming messages, and calls connect to start the session.

Once connected, the client exposes account details like your profile name, description, and avatar, and lets you change them. It fires events for messages being sent, edited, or deleted, and supports sending, replying to, editing, deleting, marking as read, and reacting to messages, including ones with photos or files attached. It can also list and manage chats, including both one-on-one conversations and groups, view group members, and create new groups, as well as list contacts and add, remove, block, or unblock them.

The project requires Node.js version 24 or newer and is installed as an npm package. Full documentation for each feature area, covering setup, account handling, events, messages, chats, and contacts, is included in the repository's documentation folder.

Because the token has to be pulled manually from the browser rather than through an official login flow, using this client means relying on a value meant for the official web app rather than a supported developer credential. The README does not mention a license, so the terms under which the code itself can be reused are not stated.