Добавлен класс ContactPresencePayload и метод get_contact_presence для получения информации о присутствии контактов в сети

Author: ink-developer

src/pymax/mixins/user.py

@@ -4,12 +4,13 @@
 from pymax.payloads import (
     AddContactByPhonePayload,
     ContactActionPayload,
+    ContactPresencePayload,
     FetchContactsPayload,
     SearchByPhonePayload,
 )
 from pymax.protocols import ClientProtocol
 from pymax.static.enum import ContactAction, Opcode
-from pymax.types import Contact, Session, User
+from pymax.types import Contact, Presence, Session, User
 from pymax.utils import MixinsUtils
 
 
@@ -246,3 +247,23 @@ def get_chat_id(self, first_user_id: int, second_user_id: int) -> int:
         :rtype: int
         """
         return first_user_id ^ second_user_id
+
+    async def get_contact_presence(self, contact_ids: list[int]) -> list[Presence]:
+        """
+        Получение информации о присутствии контактов в сети.
+
+        :param contact_ids: Список идентификаторов контактов.
+        :type contact_ids: list[int]
+        """
+        payload = ContactPresencePayload(contact_ids=contact_ids).model_dump(by_alias=True)
+
+        data = await self._send_and_wait(opcode=Opcode.CONTACT_PRESENCE, payload=payload)
+        if data.get("payload", {}).get("error"):
+            MixinsUtils.handle_error(data)
+
+        presence = data["payload"].get("presence", {})
+
+        return [
+            Presence(user_id=int(contact_id), last_seen=info.get("seen"))
+            for contact_id, info in presence.items()
+        ]

src/pymax/payloads.py

@@ -405,3 +405,7 @@ class SendEmailCodePayload(CamelModel):
 class AddContactByPhonePayload(CamelModel):
     phone: str
     first_name: str
+
+
+class ContactPresencePayload(CamelModel):
+    contact_ids: list[int]

src/pymax/static/enum.py

@@ -30,7 +30,7 @@ class Opcode(int, Enum):
     CONTACT_MUTUAL = 38
     CONTACT_PHOTOS = 39
     CONTACT_SORT = 40
-    CONTACT_ADD_BY_PHONE = 41
+    CONTACT_ADD_BY_PHONE = 41  # ✅
     CONTACT_VERIFY = 42
     REMOVE_CONTACT_PHOTO = 43
     CONTACT_INFO_BY_PHONE = 46  # ✅

src/pymax/types.py

@@ -1218,3 +1218,24 @@ def __repr__(self) -> str:
     @override
     def __str__(self) -> str:
         return f"ReadState: unread={self.unread}, mark={self.mark}"
+
+
+class Presence:
+    def __init__(self, user_id: int, last_seen: int) -> None:
+        self.user_id = user_id
+        self.last_seen = last_seen
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> Self:
+        return cls(
+            user_id=data["userId"],
+            last_seen=data["lastSeen"],
+        )
+
+    @override
+    def __repr__(self) -> str:
+        return f"Presence(user_id={self.user_id!r}, last_seen={self.last_seen!r})"
+
+    @override
+    def __str__(self) -> str:
+        return f"Presence: user {self.user_id} last seen at {self.last_seen}"