Merge pull request #35 from MaxApiTeam/dev/1.2.5

Dev/1.2.5

Author: ink-developer

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "maxapi-python"
-version = "1.2.4"
+version = "1.2.5"
 description = "Python wrapper для API мессенджера Max"
 readme = "README.md"
 requires-python = ">=3.10"

redocs/source/release_notes.rst

@@ -1,143 +1,61 @@
-Release Notes v1.2.4
+Release Notes v1.2.5
 ====================
 
 Новые функции
 -------------
 
-**Поддержка различных типов файлов в классах File и Photo**
-    Классы ``Photo``, ``File`` и ``Video`` теперь поддерживают работу с байтами, что позволяет загружать файлы из памяти напрямую.
+**Двухфакторная аутентификация (2FA)**
+    Добавлена полная поддержка двухфакторной аутентификации с использованием пароля, email-кода и подсказок для восстановления пароля. Теперь возможен вход в аккаунт когда включена 2FA с проверкой пароля.
 
-**Автоматическая отправка уведомлений о прочтении сообщений**
-    Клиент теперь автоматически отправляет сервису уведомления о получении сообщений для улучшения синхронизации.
+**Управление паролем аккаунта**
+    Новый метод ``set_password()`` позволяет устанавливать, изменять и управлять паролем аккаунта с поддержкой подсказок и email для восстановления.
 
-**Параметр session_name для управления сессией**
-    Параметр ``session_name`` позволяет указать пользовательское имя файла для сохранения сессии.
+**Исправления в обработке сокетов**
+    Улучшена обработка последовательности сообщений (sequence numbers) для корректной работы с 8-битными числами.
 
-**Получение текущей версии веб-приложения**
-    Новый метод ``get_current_web_version()`` в утилитах для получения текущей версии веб-приложения Max.
-
-**Улучшенная генерация User-Agent**
-    Теперь используется библиотека ``ua-generator`` для более реалистичной генерации User-Agent строк и параметров устройства.
+**Улучшения протокола WebSocket**
+    Добавлена поддержка версии протокола (ver=11) в сообщениях WebSocket.
 
 Новые методы
 ------------
 
-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`` во всех подклассах.
+MaxClient.set_password(password: str, email: str | None = None, hint: str | None = UNSET)
+    Устанавливает пароль для аккаунта с возможностью добавления подсказки и email для восстановления.
 
-Photo
-    Добавлен параметр ``name`` для явного указания имени файла при работе с байтами.
-    Улучшена валидация расширений файлов.
+Новые типы и перечисления
+--------------------------
 
-File
-    Добавлена поддержка работы с байтами через параметр ``raw``.
-    Улучшена обработка имен файлов.
+Capability
+    Перечисление для описания возможностей аккаунта в контексте двухфакторной аутентификации.
 
-Video
-    Добавлена поддержка работы с байтами через параметр ``raw``.
-    Улучшена работа с видеофайлами.
+Payload классы
+    ``CheckPasswordChallengePayload`` — для проверки пароля при 2FA
+    ``CreateTrackPayload`` — для создания отслеживающего ID
+    ``SetPasswordPayload`` — для установки пароля
+    ``SetHintPayload`` — для установки подсказки пароля
+    ``RequestEmailCodePayload`` — для запроса кода по email
+    ``SendEmailCodePayload`` — для отправки email кода
+    ``SetTwoFactorPayload`` — для установки параметров 2FA
 
 Исправления и улучшения
 ------------------------
 
-- Добавлена валидация ``device_type`` для MaxClient (поддерживает только WEB) и SocketMaxClient (поддерживает ANDROID, IOS, DESKTOP)
-- Улучшена обработка ошибок WebSocket при отключении
-- Добавлена опция ``ua-generator`` для более реалистичной генерации параметров устройства
-- Обновлена версия приложения до 25.12.14
-- Улучшена обработка уведомлений о доставке сообщений
-- Исправлены проблемы с завершением async задач при закрытии клиента
-
-Зависимости
------------
-
-Добавлены новые зависимости:
-    - ``ua-generator>=2.0.19`` — для генерации реалистичных User-Agent строк и параметров устройства
+- Исправлена обработка последовательности сообщений в socket-клиенте (seq % 256)
+- Исправлена обработка последовательности сообщений в websocket-клиенте
+- Добавлена проверка подключения перед отправкой уведомлений о прочтении
+- Улучшена обработка двухфакторной аутентификации при логине
+- Исправлена инициализация seq на 255 вместо 0 в core.py
+- Добавлена обработка ``SocketNotConnectedError`` в telemetry
+- Исправлена обработка ошибок при отправке в socket/websocket
 
 Версия
 ------
 
-**1.2.4** - выпущена 30 декабря 2025 г.
+**1.2.5** - выпущена 31 декабря 2025 г.
 
 ---
 
-Release Notes v1.2.3
-====================
-
-Новые функции
--------------
-
-**Загрузка фотографий профиля**
-    Профиль теперь может быть обновлен с загрузкой новой фотографии через метод ``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]
-    Список контактов текущего пользователя.
+Предыдущие версии доступны в :doc:`release_notes_archive`.

redocs/source/release_notes_archive.rst

@@ -0,0 +1,141 @@
+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]
+    Список контактов текущего пользователя.

src/pymax/core.py

@@ -252,7 +252,15 @@ async def login_with_code(self, temp_token: str, code: str, start: bool = False)
         :rtype: None
         """
         resp = await self._send_code(code, temp_token)
-        token = resp.get("tokenAttrs", {}).get("LOGIN", {}).get("token")
+
+        login_attrs = resp.get("tokenAttrs", {}).get("LOGIN", {})
+        password_challenge = resp.get("passwordChallenge")
+
+        if password_challenge and not login_attrs:
+            token = await self._two_factor_auth(password_challenge)
+        else:
+            token = login_attrs.get("token")
+
         if not token:
             raise ValueError("Login response did not contain tokenAttrs.LOGIN.token")
         self._token = token

src/pymax/interfaces.py

@@ -10,7 +10,7 @@
 
 from typing_extensions import Self
 
-from pymax.exceptions import WebSocketNotConnectedError
+from pymax.exceptions import SocketNotConnectedError, WebSocketNotConnectedError
 from pymax.filters import BaseFilter
 from pymax.formatter import ColoredFormatter
 from pymax.payloads import BaseWebSocketMessage, SyncPayload, UserAgentPayload
@@ -188,6 +188,7 @@ def _make_message(
         self._seq += 1
 
         msg = BaseWebSocketMessage(
+            ver=11,
             cmd=cmd,
             seq=self._seq,
             opcode=opcode.value,
@@ -206,8 +207,11 @@ async def _send_interactive_ping(self) -> None:
                     cmd=0,
                 )
                 self.logger.debug("Interactive ping sent successfully")
+            except SocketNotConnectedError:
+                self.logger.debug("Socket disconnected, exiting ping loop")
+                break
             except Exception:
-                self.logger.warning("Interactive ping failed", exc_info=True)
+                self.logger.warning("Interactive ping failed")
             await asyncio.sleep(DEFAULT_PING_INTERVAL)
 
     async def _handshake(self, user_agent: UserAgentPayload) -> dict[str, Any]:
@@ -283,6 +287,8 @@ async def _handle_file_upload(self, data: dict[str, Any]) -> None:
                     self.logger.debug("Fulfilled file upload waiter for %s=%s", key, id_)
 
     async def _send_notification_response(self, chat_id: int, message_id: str) -> None:
+        if self._socket is not None and self.is_connected:
+            return
         await self._send_and_wait(
             opcode=Opcode.NOTIF_MESSAGE,
             payload={"chatId": chat_id, "messageId": message_id},