maxapi-python 1.2.4__py3-none-any.whl → 1.2.5__py3-none-any.whl

{maxapi_python-1.2.4.dist-info → maxapi_python-1.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxapi-python
-Version: 1.2.4
+Version: 1.2.5
 Summary: Python wrapper для API мессенджера Max
 Project-URL: Homepage, https://github.com/MaxApiTeam/PyMax
 Project-URL: Repository, https://github.com/MaxApiTeam/PyMax
@@ -37,9 +37,6 @@ Description-Content-Type: text/markdown
     <strong>Python wrapper для API мессенджера Max</strong>
 </p>
 
-> [!IMPORTANT]
-> (29.12.2025) Снова неожиданное изменение апи, теперь `MaxClient` с `device_type` любым кроме `WEB` не работает, для вохда по номеру телефона используйте `SocketMaxClient`
-
 
 <p align="center">
     <img src="https://img.shields.io/badge/python-3.10+-3776AB.svg" alt="Python 3.11+">

{maxapi_python-1.2.4.dist-info → maxapi_python-1.2.5.dist-info}/RECORD

@@ -1,33 +1,33 @@
 pymax/__init__.py,sha256=6wUKKwsyxFpWG3b7kwptOvHd-w78C-ygw42iCDBYQvc,1915
-pymax/core.py,sha256=oJEgLVWHjtTPqDd8I7mdHgYxw-Z567FZx-su-iIhVK8,15904
+pymax/core.py,sha256=rJKUFlFjdCPywkOP5-lFUwIMnxNHk4oJLf1VYfEhqak,16137
 pymax/crud.py,sha256=YC92TyhA2mr1tJCcfd-tvh8umtXKgqJfgiLo7nXUl3Q,3076
 pymax/exceptions.py,sha256=nDUNx7bM-Yjugj-qfIllcrnwLg9JpZroYqfXapjYbMQ,3178
 pymax/files.py,sha256=nx7oZfIJ8ZvO-TuG5LzSmk8esbBtNrkKdFQgTQVbUA8,4063
 pymax/filters.py,sha256=gSHPJ1Vi37HKPxf0jRRv9Q3iGwhiQjw1MGrCaouqHzs,4325
 pymax/formatter.py,sha256=RJ_5VbY7Li8UM3xL1AvcXo8v1iYnY8GvDDkreaFqtnY,860
 pymax/formatting.py,sha256=XRtuXJGweuNZevJFdPxksDftIrfuMGEA-AOUc_v6IhQ,2484
-pymax/interfaces.py,sha256=ZFmgZ9sK5j3jG8z7DuVovBkXIvPrN4H4rI0UBb2g4BY,19543
+pymax/interfaces.py,sha256=GXHi4TjmXPb60KtLXe7CduQ8hSIVHXhA5Ak1OcvSS2w,19793
 pymax/models.py,sha256=PsPGbOkERxesZZltjNrmqhOfRcO44Is2ThbEToREcB8,201
 pymax/navigation.py,sha256=4ia6RGY2pXMArboNhHkbWlWX7LtcYK1VGVXorPX0Pb4,5747
-pymax/payloads.py,sha256=m0Fn0eEOo6hrdLB6ACh27ioT3SkYIMDMfLKaPbs2vdo,8147
+pymax/payloads.py,sha256=-hUgJYwCFfWFcWedAGYg1v82NliEfoTEteEEI7sgUEQ,8756
 pymax/protocols.py,sha256=PoNvri9jFH6WBXGwugrkU6lwtwJEw0DO2s13HOH8_KI,4025
 pymax/types.py,sha256=z1HXNl8CP_X3jTUlENlF9_vzZKdb7gF5PHG5d4rG3BY,37209
 pymax/utils.py,sha256=HK6E6UYyjtUoJ2KXWeDycyiXm_9j5shZme6VFA2ixeM,2960
 pymax/mixins/__init__.py,sha256=5sXJME34S1EssuDETaN4DLRH7vhMw_Q3Jmay9myAIZM,775
-pymax/mixins/auth.py,sha256=nA1fX2ERzk6_WBSrbtBhvwkA5aUXgUdgweytqhZSAJU,14708
+pymax/mixins/auth.py,sha256=f6IH_gvwB8hLvj7hNI21vgVhR1kju7ABRNjcRS656_o,22843
 pymax/mixins/channel.py,sha256=Qi5ujw5X7QYx4Lq1XnvlJ3BYjmTFmYDfu7_jRcx4Mx8,5335
 pymax/mixins/group.py,sha256=6bsWSx0ULZonDM_dJSC0EkqpZWd6tv9lmmKWj_gEaaw,15903
 pymax/mixins/handler.py,sha256=duL3Q5Bvv8tjUhOKaDr_k7w09BeCwjVdws2ga7v_zNE,12432
 pymax/mixins/message.py,sha256=MpUED92iWONkJRjb0f7lwPj9gYJhDuv0KKzbveOEaAk,33397
 pymax/mixins/scheduler.py,sha256=K4HB9IfksnXPujJnkipIS5um9nuzC8EjbtQn65RtbfI,963
 pymax/mixins/self.py,sha256=Wn9l3zDF5VzFzzisryOQknf3Ngl81Q98_9jqqbE9ZAw,9174
-pymax/mixins/socket.py,sha256=00uO4-8xer94i6Z6NDTUzzEQbs3NVMH1DB-KoPY6shU,10525
-pymax/mixins/telemetry.py,sha256=EAbGyk8EB6QxijaFQ16vUmFPe6l-gEraCxXnAfhA3kY,3594
+pymax/mixins/socket.py,sha256=0WCK9FDzkfgRpKeTfCB9GwuNkccww3RTI7P-W8_409c,10904
+pymax/mixins/telemetry.py,sha256=9gbzEXTp9W9BLJ1wJVXOaHU7Q4inL981b-xq93xJyrw,3913
 pymax/mixins/user.py,sha256=Xwb2fWM8RCq0SbVhlRyr1RBQGyjlaImtp0lT2PbgEqE,9420
-pymax/mixins/websocket.py,sha256=XZ7lE8rKiNd3MXQRlS7Waz8TuoVWms9ldjCOF12pNTw,4891
-pymax/static/constant.py,sha256=Gu1j4ibpaZL3tI6fUayS_jkyYOYNe9K-QlTUCOGviwQ,2260
-pymax/static/enum.py,sha256=Scyi1pAUaaQlec1YQsU_nvlfxTiQZ6p7gntOJhWfBk4,4773
-maxapi_python-1.2.4.dist-info/METADATA,sha256=hVzJYUCzdYWHmbcvAVlNYrEmvLRoWSVxwSbeNCL0Rqc,7069
-maxapi_python-1.2.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-maxapi_python-1.2.4.dist-info/licenses/LICENSE,sha256=hOR249ItqMdcly1A0amqEWRNRTq4Gv5NJtmQ3A5qK4E,1070
-maxapi_python-1.2.4.dist-info/RECORD,,
+pymax/mixins/websocket.py,sha256=CvrfMv0iNYpPtfwZXKm0V-ZOlSohtXZ7QH5fDET5Pec,5223
+pymax/static/constant.py,sha256=hZby1gZmzWTzDgwW_EX1NGgqwdQxwcjl7pOE0thfxT0,2304
+pymax/static/enum.py,sha256=YWNzDfPqSBBT8w9m3XesedjiTETn1juJn5UEOZ3zMe0,5477
+maxapi_python-1.2.5.dist-info/METADATA,sha256=BbvzqfDdavSaBRJSDJ0DqxV_f5Nrzs-2-V0LXMlV52o,6790
+maxapi_python-1.2.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+maxapi_python-1.2.5.dist-info/licenses/LICENSE,sha256=hOR249ItqMdcly1A0amqEWRNRTq4Gv5NJtmQ3A5qK4E,1070
+maxapi_python-1.2.5.dist-info/RECORD,,

pymax/core.py

@@ -252,7 +252,15 @@ class MaxClient(ApiMixin, WebSocketMixin, BaseClient):
         :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

pymax/interfaces.py

@@ -10,7 +10,7 @@ from typing import Any
 
 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 @@ class BaseTransport(ClientProtocol):
         self._seq += 1
 
         msg = BaseWebSocketMessage(
+            ver=11,
             cmd=cmd,
             seq=self._seq,
             opcode=opcode.value,
@@ -206,8 +207,11 @@ class BaseTransport(ClientProtocol):
                     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 @@ class BaseTransport(ClientProtocol):
                     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},

pymax/mixins/auth.py

@@ -7,9 +7,21 @@ from typing import Any
 import qrcode
 
 from pymax.exceptions import Error
-from pymax.payloads import RegisterPayload, RequestCodePayload, SendCodePayload
+from pymax.payloads import (
+    Capability,
+    CheckPasswordChallengePayload,
+    CreateTrackPayload,
+    RegisterPayload,
+    RequestCodePayload,
+    RequestEmailCodePayload,
+    SendCodePayload,
+    SendEmailCodePayload,
+    SetHintPayload,
+    SetPasswordPayload,
+    SetTwoFactorPayload,
+)
 from pymax.protocols import ClientProtocol
-from pymax.static.constant import PHONE_REGEX
+from pymax.static.constant import PHONE_REGEX, UNSET, _Unset
 from pymax.static.enum import AuthType, DeviceType, Opcode
 from pymax.utils import MixinsUtils
 
@@ -194,7 +206,13 @@ class AuthMixin(ClientProtocol):
 
             login_resp = await self._send_code(code, temp_token)
 
-        token = login_resp.get("tokenAttrs", {}).get("LOGIN", {}).get("token", "")
+        password_challenge = login_resp.get("passwordChallenge")
+        login_attrs = login_resp.get("tokenAttrs", {}).get("LOGIN", {})
+
+        if password_challenge and not login_attrs:
+            token = await self._two_factor_auth(password_challenge)
+        else:
+            token = login_attrs.get("token")
 
         if not token:
             self.logger.critical("Failed to login, token not received")
@@ -297,6 +315,7 @@ class AuthMixin(ClientProtocol):
                     self.logger.info("QR login successful")
 
                     data = await self._get_qr_login_data(track_id)
+
                     return data
 
                 else:
@@ -366,3 +385,210 @@ class AuthMixin(ClientProtocol):
             "IMPORTANT: Use this token ONLY with device_type='DESKTOP' and the special init user agent"
         )
         self.logger.warning("This token MUST NOT be used in web clients")
+
+    async def _check_password(self, password: str, track_id: str) -> dict[str, Any] | None:
+        payload = CheckPasswordChallengePayload(
+            track_id=track_id,
+            password=password,
+        ).model_dump(by_alias=True)
+
+        data = await self._send_and_wait(opcode=Opcode.AUTH_LOGIN_CHECK_PASSWORD, payload=payload)
+
+        token_attrs = data.get("payload", {}).get("tokenAttrs", {})
+        if data.get("payload", {}).get("error"):
+            return None
+        return token_attrs
+
+    async def _two_factor_auth(self, password_challenge: dict[str, Any]) -> None:
+        self.logger.info("Starting two-factor authentication flow")
+
+        track_id = password_challenge.get("trackId")
+        if not track_id:
+            self.logger.critical("Password challenge missing track ID")
+            raise ValueError("Password challenge missing track ID")
+
+        hint = password_challenge.get("hint", "No hint provided")
+
+        while True:
+            password = await asyncio.to_thread(
+                lambda: input(f"Введите пароль (Подсказка: {hint}): ").strip()
+            )
+            if not password:
+                self.logger.warning("Password is empty, please try again")
+                continue
+
+            token_attrs = await self._check_password(password, track_id)
+            if not token_attrs:
+                self.logger.error("Incorrect password, please try again")
+                continue
+
+            login_attrs = token_attrs.get("LOGIN", {})
+            if login_attrs:
+                token = login_attrs.get("token")
+                if not token:
+                    self.logger.critical("Login response did not contain tokenAttrs.LOGIN.token")
+                    raise ValueError("Login response did not contain tokenAttrs.LOGIN.token")
+                return token
+
+    async def _set_password(self, password: str, track_id: str) -> bool:
+        payload = SetPasswordPayload(
+            track_id=track_id,
+            password=password,
+        ).model_dump(by_alias=True)
+
+        data = await self._send_and_wait(opcode=Opcode.AUTH_VALIDATE_PASSWORD, payload=payload)
+        payload = data.get("payload", {})
+        return not payload
+
+    async def _set_hint(self, hint: str, track_id: str) -> bool:
+        payload = SetHintPayload(
+            track_id=track_id,
+            hint=hint,
+        ).model_dump(by_alias=True)
+
+        data = await self._send_and_wait(opcode=Opcode.AUTH_VALIDATE_HINT, payload=payload)
+        payload = data.get("payload", {})
+        return not payload
+
+    async def _set_email(self, email: str, track_id: str) -> bool:
+        payload = RequestEmailCodePayload(
+            track_id=track_id,
+            email=email,
+        )
+
+        data = await self._send_and_wait(
+            opcode=Opcode.AUTH_VERIFY_EMAIL,
+            payload=payload.model_dump(by_alias=True),
+        )
+
+        if data.get("payload", {}).get("error"):
+            MixinsUtils.handle_error(data)
+
+        while True:
+            verify_code = await asyncio.to_thread(
+                lambda: input(f"Введите код подтверждения, отправленный на {email}: ").strip()
+            )
+            if not verify_code:
+                self.logger.warning("Verification code is empty, please try again")
+                continue
+
+            payload = SendEmailCodePayload(
+                track_id=track_id,
+                verify_code=verify_code,
+            )
+
+            data = await self._send_and_wait(
+                opcode=Opcode.AUTH_CHECK_EMAIL,
+                payload=payload.model_dump(by_alias=True),
+            )
+
+            if data.get("payload", {}).get("error"):
+                self.logger.error("Incorrect verification code, please try again")
+                continue
+
+            return True
+
+    async def set_password(
+        self,
+        password: str,
+        email: str | None = None,
+        hint: str | None | _Unset = UNSET,
+    ):
+        """
+        Устанавливает пароль для аккаунта
+
+        .. warning::
+            Метод не будет работать, если на аккаунте уже установлен пароль.
+
+        :param password: Новый пароль для аккаунта.
+        :type password: str
+        :param email: Адрес электронной почты для восстановления пароля.
+        :type email: str
+        :param hint: Подсказка для пароля. По умолчанию None.
+        :type hint: str | None
+        :return: None
+        :rtype: None
+        """
+        self.logger.info("Setting account password")
+
+        payload = CreateTrackPayload().model_dump(by_alias=True)
+
+        data = await self._send_and_wait(
+            opcode=Opcode.AUTH_CREATE_TRACK,
+            payload=payload,
+        )
+        print(data)
+        if data.get("payload", {}).get("error"):
+            MixinsUtils.handle_error(data)
+
+        track_id = data.get("payload", {}).get("trackId")
+        if not track_id:
+            self.logger.critical("Failed to create password track: track ID missing")
+            raise ValueError("Failed to create password track")
+
+        while True:
+            if not password:
+                password = await asyncio.to_thread(lambda: input("Введите пароль: ").strip())
+                if not password:
+                    self.logger.warning("Password is empty, please try again")
+                    continue
+
+            success = await self._set_password(password, track_id)
+            if success:
+                self.logger.info("Password set successfully")
+                break
+            else:
+                self.logger.error("Failed to set password, please try again")
+
+        while True:
+            if hint is UNSET:
+                hint = await asyncio.to_thread(
+                    lambda: input("Введите подсказку для пароля (пустая - пропустить): ").strip()
+                )
+                if not hint:
+                    break
+
+            if hint is None:
+                break
+
+            success = await self._set_hint(hint, track_id)
+            if success:
+                self.logger.info("Password hint set successfully")
+                break
+            else:
+                self.logger.error("Failed to set password hint, please try again")
+
+        while True:
+            if not email:
+                email = await asyncio.to_thread(
+                    lambda: input("Введите email для восстановления пароля: ").strip()
+                )
+                if not email:
+                    self.logger.warning("Email is empty, please try again")
+                    continue
+
+            success = await self._set_email(email, track_id)
+            if success:
+                self.logger.info("Recovery email set successfully")
+                break
+
+        payload = SetTwoFactorPayload(
+            expected_capabilities=[
+                Capability.DEFAULT,
+                Capability.SECOND_FACTOR_HAS_HINT,
+                Capability.SECOND_FACTOR_HAS_EMAIL,
+            ],
+            track_id=track_id,
+            password=password,
+            hint=hint if isinstance(hint, (str, type(None))) else None,
+        )
+
+        data = await self._send_and_wait(
+            opcode=Opcode.AUTH_SET_2FA,
+            payload=payload.model_dump(by_alias=True),
+        )
+        payload = data.get("payload", {})
+        if payload and payload.get("error"):
+            MixinsUtils.handle_error(data)
+
+        return True

pymax/mixins/socket.py

@@ -84,7 +84,7 @@ class SocketMixin(BaseTransport):
     ) -> bytes:
         ver_b = ver.to_bytes(1, "big")
         cmd_b = cmd.to_bytes(2, "big")
-        seq_b = seq.to_bytes(1, "big")
+        seq_b = (seq % 256).to_bytes(1, "big")
         opcode_b = opcode.to_bytes(2, "big")
         payload_bytes: bytes | None = msgpack.packb(payload)
         if payload_bytes is None:
@@ -219,7 +219,7 @@ Socket connections may be unstable, SSL issues are possible.
                 for data_item in datas:
                     seq = data_item.get("seq")
 
-                    if self._handle_pending(seq, data_item):
+                    if self._handle_pending(seq % 256 if seq is not None else None, data_item):
                         continue
 
                     if self._incoming is not None:
@@ -249,7 +249,13 @@ Socket connections may be unstable, SSL issues are possible.
         msg = self._make_message(opcode, payload, cmd)
         loop = asyncio.get_running_loop()
         fut: asyncio.Future[dict[str, Any]] = loop.create_future()
-        self._pending[msg["seq"]] = fut
+        seq_key = msg["seq"] % 256
+
+        old_fut = self._pending.get(seq_key)
+        if old_fut and not old_fut.done():
+            old_fut.cancel()
+
+        self._pending[seq_key] = fut
         try:
             self.logger.debug(
                 "Sending frame opcode=%s cmd=%s seq=%s",
@@ -282,12 +288,15 @@ Socket connections may be unstable, SSL issues are possible.
                 self.logger.exception("Reconnect failed")
                 raise exc from conn_err
             raise SocketNotConnectedError from conn_err
+        except asyncio.TimeoutError:
+            self.logger.exception("Send and wait failed (opcode=%s, seq=%s)", opcode, msg["seq"])
+            raise SocketSendError from None
         except Exception as exc:
             self.logger.exception("Send and wait failed (opcode=%s, seq=%s)", opcode, msg["seq"])
             raise SocketSendError from exc
 
         finally:
-            self._pending.pop(msg["seq"], None)
+            self._pending.pop(msg["seq"] % 256, None)
 
     @override
     async def _get_chat(self, chat_id: int) -> Chat | None:

pymax/mixins/telemetry.py

@@ -2,7 +2,7 @@ import asyncio
 import random
 import time
 
-from pymax.exceptions import Error
+from pymax.exceptions import Error, SocketNotConnectedError
 from pymax.navigation import Navigation
 from pymax.payloads import (
     NavigationEventParams,
@@ -103,7 +103,13 @@ class TelemetryMixin(ClientProtocol):
 
         try:
             while self.is_connected:
-                await self._send_random_navigation()
+                try:
+                    await self._send_random_navigation()
+                except SocketNotConnectedError:
+                    self.logger.debug("Socket disconnected, exiting telemetry task")
+                    break
+                except Exception:
+                    self.logger.warning("Failed to send random navigation")
                 await asyncio.sleep(self._get_random_sleep_time())
 
         except asyncio.CancelledError:

pymax/mixins/websocket.py

@@ -111,7 +111,13 @@ class WebSocketMixin(BaseTransport):
         msg = self._make_message(opcode, payload, cmd)
         loop = asyncio.get_running_loop()
         fut: asyncio.Future[dict[str, Any]] = loop.create_future()
-        self._pending[msg["seq"]] = fut
+        seq_key = msg["seq"]
+
+        old_fut = self._pending.get(seq_key)
+        if old_fut and not old_fut.done():
+            old_fut.cancel()
+
+        self._pending[seq_key] = fut
 
         try:
             self.logger.debug(
@@ -128,11 +134,14 @@ class WebSocketMixin(BaseTransport):
                 data.get("opcode"),
             )
             return data
+        except asyncio.TimeoutError:
+            self.logger.exception("Send and wait failed (opcode=%s, seq=%s)", opcode, msg["seq"])
+            raise RuntimeError("Send and wait failed")
         except Exception:
             self.logger.exception("Send and wait failed (opcode=%s, seq=%s)", opcode, msg["seq"])
             raise RuntimeError("Send and wait failed")
         finally:
-            self._pending.pop(msg["seq"], None)
+            self._pending.pop(seq_key, None)
 
     @override
     async def _get_chat(self, chat_id: int) -> Chat | None:

pymax/payloads.py

@@ -15,7 +15,7 @@ from pymax.static.constant import (
     DEFAULT_TIMEZONE,
     DEFAULT_USER_AGENT,
 )
-from pymax.static.enum import AttachType, AuthType, ContactAction, ReadAction
+from pymax.static.enum import AttachType, AuthType, Capability, ContactAction, ReadAction
 
 
 def to_camel(string: str) -> str:
@@ -365,3 +365,39 @@ class ReadMessagesPayload(CamelModel):
     chat_id: int
     message_id: str
     mark: int
+
+
+class CheckPasswordChallengePayload(CamelModel):
+    track_id: str
+    password: str
+
+
+class CreateTrackPayload(CamelModel):
+    type: int = 0
+
+
+class SetPasswordPayload(CamelModel):
+    track_id: str
+    password: str
+
+
+class SetHintPayload(CamelModel):
+    track_id: str
+    hint: str
+
+
+class SetTwoFactorPayload(CamelModel):
+    expected_capabilities: list[Capability]
+    track_id: str
+    password: str
+    hint: str | None = None
+
+
+class RequestEmailCodePayload(CamelModel):
+    track_id: str
+    email: str
+
+
+class SendEmailCodePayload(CamelModel):
+    track_id: str
+    verify_code: str

pymax/static/constant.py

@@ -87,3 +87,10 @@ DEFAULT_CHAT_MEMBERS_LIMIT: Final[int] = 50
 DEFAULT_MARKER_VALUE: Final[int] = 0
 DEFAULT_PING_INTERVAL: Final[float] = 30.0
 RECV_LOOP_BACKOFF_DELAY: Final[float] = 0.5
+
+
+class _Unset:
+    pass
+
+
+UNSET = _Unset()

pymax/static/enum.py

@@ -2,28 +2,28 @@ from enum import Enum
 
 
 class Opcode(int, Enum):
-    PING = 1
+    PING = 1  # ✅
     DEBUG = 2
     RECONNECT = 3
-    LOG = 5
-    SESSION_INIT = 6
-    PROFILE = 16
-    AUTH_REQUEST = 17
-    AUTH = 18
-    LOGIN = 19
-    LOGOUT = 20
+    LOG = 5  # ✅
+    SESSION_INIT = 6  # ✅
+    PROFILE = 16  # ✅
+    AUTH_REQUEST = 17  # ✅
+    AUTH = 18  # ✅
+    LOGIN = 19  # ✅
+    LOGOUT = 20  # ✅
     SYNC = 21
     CONFIG = 22
-    AUTH_CONFIRM = 23
+    AUTH_CONFIRM = 23  # ✅
     PRESET_AVATARS = 25
     ASSETS_GET = 26
     ASSETS_UPDATE = 27
     ASSETS_GET_BY_IDS = 28
     ASSETS_ADD = 29
     SEARCH_FEEDBACK = 31
-    CONTACT_INFO = 32
+    CONTACT_INFO = 32  # ✅
     CONTACT_ADD = 33
-    CONTACT_UPDATE = 34
+    CONTACT_UPDATE = 34  # ✅
     CONTACT_PRESENCE = 35
     CONTACT_LIST = 36
     CONTACT_SEARCH = 37
@@ -32,26 +32,26 @@ class Opcode(int, Enum):
     CONTACT_SORT = 40
     CONTACT_VERIFY = 42
     REMOVE_CONTACT_PHOTO = 43
-    CONTACT_INFO_BY_PHONE = 46
-    CHAT_INFO = 48
-    CHAT_HISTORY = 49
-    CHAT_MARK = 50
+    CONTACT_INFO_BY_PHONE = 46  # ✅
+    CHAT_INFO = 48  # ✅
+    CHAT_HISTORY = 49  # ✅
+    CHAT_MARK = 50  # ✅
     CHAT_MEDIA = 51
     CHAT_DELETE = 52
-    CHATS_LIST = 53
+    CHATS_LIST = 53  # ✅
     CHAT_CLEAR = 54
-    CHAT_UPDATE = 55
+    CHAT_UPDATE = 55  # ✅
     CHAT_CHECK_LINK = 56
-    CHAT_JOIN = 57
-    CHAT_LEAVE = 58
-    CHAT_MEMBERS = 59
+    CHAT_JOIN = 57  # ✅
+    CHAT_LEAVE = 58  # ✅
+    CHAT_MEMBERS = 59  # ✅
     PUBLIC_SEARCH = 60
     CHAT_CLOSE = 61
     CHAT_CREATE = 63
-    MSG_SEND = 64
+    MSG_SEND = 64  # ✅
     MSG_TYPING = 65
-    MSG_DELETE = 66
-    MSG_EDIT = 67
+    MSG_DELETE = 66  # ✅
+    MSG_EDIT = 67  # ✅
     CHAT_SEARCH = 68
     MSG_SHARE_PREVIEW = 70
     MSG_GET = 71
@@ -60,31 +60,31 @@ class Opcode(int, Enum):
     MSG_GET_STAT = 74
     CHAT_SUBSCRIBE = 75
     VIDEO_CHAT_START = 76
-    CHAT_MEMBERS_UPDATE = 77
+    CHAT_MEMBERS_UPDATE = 77  # ✅
     VIDEO_CHAT_HISTORY = 79
-    PHOTO_UPLOAD = 80
+    PHOTO_UPLOAD = 80  # ✅
     STICKER_UPLOAD = 81
-    VIDEO_UPLOAD = 82
-    VIDEO_PLAY = 83
+    VIDEO_UPLOAD = 82  # ✅
+    VIDEO_PLAY = 83  # ✅
     CHAT_PIN_SET_VISIBILITY = 86
-    FILE_UPLOAD = 87
-    FILE_DOWNLOAD = 88
-    LINK_INFO = 89
+    FILE_UPLOAD = 87  # ✅
+    FILE_DOWNLOAD = 88  # ✅
+    LINK_INFO = 89  # ✅
     MSG_DELETE_RANGE = 92
-    SESSIONS_INFO = 96
-    SESSIONS_CLOSE = 97
+    SESSIONS_INFO = 96  # ✅
+    SESSIONS_CLOSE = 97  # ✅
     PHONE_BIND_REQUEST = 98
     PHONE_BIND_CONFIRM = 99
     CONFIRM_PRESENT = 101
     GET_INBOUND_CALLS = 103
     EXTERNAL_CALLBACK = 105
-    AUTH_VALIDATE_PASSWORD = 107
-    AUTH_VALIDATE_HINT = 108
-    AUTH_VERIFY_EMAIL = 109
-    AUTH_CHECK_EMAIL = 110
-    AUTH_SET_2FA = 111
-    AUTH_CREATE_TRACK = 112
-    AUTH_LOGIN_CHECK_PASSWORD = 115
+    AUTH_VALIDATE_PASSWORD = 107  # ✅
+    AUTH_VALIDATE_HINT = 108  # ✅
+    AUTH_VERIFY_EMAIL = 109  # ✅
+    AUTH_CHECK_EMAIL = 110  # ✅
+    AUTH_SET_2FA = 111  # ✅
+    AUTH_CREATE_TRACK = 112  # ✅
+    AUTH_LOGIN_CHECK_PASSWORD = 115  # ✅
     CHAT_COMPLAIN = 117
     MSG_SEND_CALLBACK = 118
     SUSPEND_BOT = 119
@@ -92,14 +92,14 @@ class Opcode(int, Enum):
     LOCATION_SEND = 125
     LOCATION_REQUEST = 126
     GET_LAST_MENTIONS = 127
-    NOTIF_MESSAGE = 128
+    NOTIF_MESSAGE = 128  # ✅
     NOTIF_TYPING = 129
     NOTIF_MARK = 130
     NOTIF_CONTACT = 131
     NOTIF_PRESENCE = 132
     NOTIF_CONFIG = 134
-    NOTIF_CHAT = 135
-    NOTIF_ATTACH = 136
+    NOTIF_CHAT = 135  # ✅
+    NOTIF_ATTACH = 136  # ✅
     NOTIF_CALL_START = 137
     NOTIF_CONTACT_SORT = 139
     NOTIF_MSG_DELETE_RANGE = 140
@@ -113,16 +113,16 @@ class Opcode(int, Enum):
     NOTIF_DRAFT = 152
     NOTIF_DRAFT_DISCARD = 153
     NOTIF_MSG_DELAYED = 154
-    NOTIF_MSG_REACTIONS_CHANGED = 155
+    NOTIF_MSG_REACTIONS_CHANGED = 155  # ✅
     NOTIF_MSG_YOU_REACTED = 156
     CALLS_TOKEN = 158
     NOTIF_PROFILE = 159
     WEB_APP_INIT_DATA = 160
     DRAFT_SAVE = 176
     DRAFT_DISCARD = 177
-    MSG_REACTION = 178
-    MSG_CANCEL_REACTION = 179
-    MSG_GET_REACTIONS = 180
+    MSG_REACTION = 178  # ✅
+    MSG_CANCEL_REACTION = 179  # ✅
+    MSG_GET_REACTIONS = 180  # ✅
     MSG_GET_DETAILED_REACTIONS = 181
     STICKER_CREATE = 193
     STICKER_SUGGEST = 194
@@ -134,16 +134,16 @@ class Opcode(int, Enum):
     ASSETS_REMOVE = 259
     ASSETS_MOVE = 260
     ASSETS_LIST_MODIFY = 261
-    FOLDERS_GET = 272
+    FOLDERS_GET = 272  # ✅
     FOLDERS_GET_BY_ID = 273
-    FOLDERS_UPDATE = 274
+    FOLDERS_UPDATE = 274  # ✅
     FOLDERS_REORDER = 275
-    FOLDERS_DELETE = 276
+    FOLDERS_DELETE = 276  # ✅
     NOTIF_FOLDERS = 277
 
-    GET_QR = 288
-    GET_QR_STATUS = 289
-    LOGIN_BY_QR = 291
+    GET_QR = 288  # ✅
+    GET_QR_STATUS = 289  # ✅
+    LOGIN_BY_QR = 291  # ✅
 
 
 class ChatType(str, Enum):
@@ -221,3 +221,11 @@ class ContactAction(str, Enum):
 class ReadAction(str, Enum):
     READ_MESSAGE = "READ_MESSAGE"
     READ_REACTION = "READ_REACTION"
+
+
+class Capability(int, Enum):
+    DEFAULT = 0  # В душе не чаю что это такое но при первой установке 2фа там 0 3 4 так что пусть будет дефолт
+    ESIA_VERIFIED_FLAG = 1
+    SECOND_FACTOR_PASSWORD_ENABLED = 2
+    SECOND_FACTOR_HAS_EMAIL = 3
+    SECOND_FACTOR_HAS_HINT = 4