Archive

Архив предыдущих версий.

v1.2.4 (30 декабря 2025)

Новые функции

Поддержка различных типов файлов в классах File и Photo

Классы Photo, File и Video теперь поддерживают работу с байтами, что позволяет загружать файлы из памяти напрямую.

Автоматическая отправка уведомлений о прочтении сообщений

Клиент теперь автоматически отправляет сервису уведомления о получении сообщений для улучшения синхронизации.

Параметр session_name для управления сессией

Параметр session_name позволяет указать пользовательское имя файла для сохранения сессии.

Получение текущей версии веб-приложения

Новый метод get_current_web_version() в утилитах для получения текущей версии веб-приложения Max.

Улучшенная генерация User-Agent

Теперь используется библиотека ua-generator для более реалистичной генерации User-Agent строк и параметров устройства.

Новые методы

read_message(chat_id: int, message_id: int) -> ReadState

Отмечает сообщение как прочитанное. Возвращает объект ReadState с информацией о состоянии.

pymax.utils.MixinsUtils.get_current_web_version() -> str | None

Получает текущую версию веб-приложения Max из источника. Возвращает версию в формате "XX.XX.XX" или None.

Измененные методы

MaxClient.start()

Улучшена логика работы цикла переподключения с использованием asyncio.Event для более чистого завершения. Исправлена обработка состояния при отключении и переподключении.

MaxClient.close()

Упрощена логика закрытия клиента. Теперь использует asyncio.Event для сигнала остановки.

Новые параметры

MaxClient.__init__(session_name: str = "session.db")

Позволяет указать пользовательское имя файла базы данных сессии.

Измененные типы

BaseFile

Теперь поддерживает работу с байтами через параметр raw во всех подклассах.

Photo

Добавлен параметр name для явного указания имени файла при работе с байтами. Улучшена валидация расширений файлов.

File

Добавлена поддержка работы с байтами через параметр raw. Улучшена обработка имен файлов.

Video

Добавлена поддержка работы с байтами через параметр raw. Улучшена работа с видеофайлами.

Исправления и улучшения

  • Добавлена валидация device_type для MaxClient (поддерживает только WEB) и SocketMaxClient (поддерживает ANDROID, IOS, DESKTOP)

  • Улучшена обработка ошибок WebSocket при отключении

  • Добавлена опция ua-generator для более реалистичной генерации параметров устройства

  • Обновлена версия приложения до 25.12.14

  • Улучшена обработка уведомлений о доставке сообщений

  • Исправлены проблемы с завершением async задач при закрытии клиента

Зависимости

Добавлены новые зависимости:
  • ua-generator>=2.0.19 — для генерации реалистичных User-Agent строк и параметров устройства

v1.2.3 (24 декабря 2025)

Новые функции

Загрузка фотографий профиля

Профиль теперь может быть обновлен с загрузкой новой фотографии через метод change_profile().

Разрешение групп по ссылке

Группы теперь могут быть разрешены (получены) прямо по их ссылке через метод resolve_group_by_link().

Поддержка контактов в сообщениях

Сообщения теперь поддерживают вложения типа контакта с информацией о контакте (ContactAttach).

Список контактов клиента

Клиент теперь ведет список всех контактов пользователя через свойство client.contacts.

Новые методы

MaxClient.resolve_group_by_link(link: str) -> Chat | None

Разрешает группу по ссылке. Возвращает объект чата группы или None, если не найдено.

MaxClient.change_profile(first_name, last_name, description, photo)

Изменяет информацию профиля текущего пользователя, включая загрузку новой фотографии.

Новые типы

ContactAttach

Представляет контакт в сообщении. Содержит информацию о контакте (ID, имя, фамилия, фото).

Измененные типы

Message

Теперь поддерживает вложения типа ContactAttach в список attaches.

Names

Улучшен для работы с различными форматами имен пользователя.

StickerAttach

Улучшено представление стикеров в сообщениях.

Photo

Улучшено для работы с фотографиями профиля.

AttachType

Добавлено значение CONTACT для контактов.

Новые параметры

MaxClient.contacts: list[User]

Список контактов текущего пользователя.