maxapi-python 2.4.1__py3-none-any.whl → 2.5.0__py3-none-any.whl

pymax/types/domain/attachments/keyboards/inline.py

@@ -1,10 +1,78 @@
-from typing import Any, Literal
+from typing import Annotated, Literal, TypeAlias
 
 from pydantic import Field
 
 from pymax.types.domain.attachments import AttachmentType
 from pymax.types.domain.base import CamelModel
 
+from .enums import ButtonType
+
+
+class BaseButton(CamelModel):
+    text: str
+
+
+class CallbackButton(BaseButton):
+    type: Literal[ButtonType.CALLBACK] = ButtonType.CALLBACK
+    text: str
+    payload: str
+    intent: str
+
+
+class LinkButton(BaseButton):
+    type: Literal[ButtonType.LINK] = ButtonType.LINK
+    url: str
+
+
+class ChatButton(BaseButton):
+    type: Literal[ButtonType.CHAT] = ButtonType.CHAT
+    payload: str
+
+
+class GeoLocationButton(BaseButton):
+    type: Literal[ButtonType.REQUEST_GEO_LOCATION] = ButtonType.REQUEST_GEO_LOCATION
+    quick: bool | None = None
+
+
+class RequestContactButton(BaseButton):
+    type: Literal[ButtonType.REQUEST_CONTACT] = ButtonType.REQUEST_CONTACT
+
+
+class OpenAppButton(BaseButton):
+    type: Literal[ButtonType.OPEN_APP] = ButtonType.OPEN_APP
+    contact_id: int | None = None
+    payload: str | None = None
+    web_app: str | None = None
+
+
+class MessageButton(BaseButton):
+    type: Literal[ButtonType.MESSAGE] = ButtonType.MESSAGE
+
+
+class ClipboardButton(BaseButton):
+    type: Literal[ButtonType.CLIPBOARD] = ButtonType.CLIPBOARD
+    payload: str
+
+
+Button: TypeAlias = Annotated[
+    CallbackButton
+    | ChatButton
+    | LinkButton
+    | RequestContactButton
+    | GeoLocationButton
+    | OpenAppButton
+    | MessageButton
+    | ClipboardButton,
+    Field(discriminator="type"),
+]
+ButtonRow: TypeAlias = list[Button]
+
+
+class InlineKeyboard(CamelModel):
+    """Inline-клавиатура со списком строк кнопок в ``buttons``."""
+
+    buttons: list[ButtonRow]
+
 
 class InlineKeyboardAttachment(CamelModel):
     """Вложение inline-клавиатуры.
@@ -12,8 +80,11 @@ class InlineKeyboardAttachment(CamelModel):
     :ivar type: Тип вложения.
     :vartype type: Literal[AttachmentType.INLINE_KEYBOARD]
     :ivar keyboard: Данные inline-клавиатуры.
-    :vartype keyboard: dict[str, Any]
+    :vartype keyboard: InlineKeyboard
+    :ivar callback_id: ID клавиатуры для ``client.send_callback()``.
+    :vartype callback_id: str
     """
 
     type: Literal[AttachmentType.INLINE_KEYBOARD] = Field(alias="_type")
-    keyboard: dict[str, Any]
+    keyboard: InlineKeyboard
+    callback_id: str

pymax/types/domain/callback.py

@@ -0,0 +1,19 @@
+from .base import CamelModel
+from .chat import Chat
+from .message import Message
+
+
+class CallbackResponse(CamelModel):
+    """Результат нажатия inline-кнопки бота.
+
+    ``success`` показывает результат операции. Необязательные ``message`` и
+    ``chat`` содержат дополнительные данные ответа Max и поддерживают методы
+    действий, если ответ получен через клиент.
+    """
+
+    success: bool
+    unread: int
+    mark: int
+    message: Message | None = None
+    chat: Chat | None = None
+    chat_access_token: str | None = None

pymax/types/domain/comment.py

@@ -0,0 +1,24 @@
+from .base import CamelModel
+
+
+class CommentsInfo(CamelModel):
+    """Счетчики комментариев поста.
+
+    :ivar total_count: Общее количество комментариев.
+    :vartype total_count: int
+    """
+
+    total_count: int = 0
+
+
+class CommentsInfoUpdate(CamelModel):
+    """Обновление счетчиков комментариев поста.
+
+    :ivar post_id: ID поста.
+    :vartype post_id: int
+    :ivar comments_info: Счетчики комментариев поста, если Max их прислал.
+    :vartype comments_info: CommentsInfo | None
+    """
+
+    post_id: int
+    comments_info: CommentsInfo | None

pymax/types/domain/message.py

@@ -50,6 +50,11 @@ SendAttachments: TypeAlias = Sequence[SendAttachment] | None
 Link: TypeAlias = Annotated["ReplyLink | ForwardLink", Field(discriminator="type")]
 
 
+class MessageLink(CamelModel):
+    message: Message
+    chat_id: int
+
+
 class ReactionCounter(CamelModel):
     """Счетчик одной реакции на сообщение.
 
@@ -98,7 +103,7 @@ class DelayedAttributes(CamelModel):
     notify_opponents: bool
 
 
-class ReplyLink(CamelModel):
+class ReplyLink(MessageLink):
     """Источник сообщения, отправленного как reply.
 
     :ivar message: Сообщение, на которое ответили.
@@ -112,7 +117,7 @@ class ReplyLink(CamelModel):
     chat_id: int
 
 
-class ForwardLink(CamelModel):
+class ForwardLink(MessageLink):
     """Источник пересланного сообщения.
 
     Помимо исходного сообщения содержит доступные в payload-е имя, ссылку,
@@ -134,24 +139,6 @@ class ForwardLink(CamelModel):
     chat_icon_url: str | None = None
 
 
-"""
-            "link": {
-        "type": "FORWARD",
-        "message": {
-          "id": "116641336752745888",
-          "time": 1779805553478,
-          "type": "CHANNEL",
-          "text": "Добро пожаловать на наше шоу!",
-          "attaches": []
-        },
-        "chatId": -75183661482741,
-        "chatName": "Max Bounty Test",
-        "chatLink": "https://max.ru/join/htlT5aTtlpAgcno_hc93lLM44Dxe45HvOEBqx22lKms",
-        "chatAccessType": "PRIVATE"
-      }
-"""
-
-
 class Message(CamelModel):
     """Сообщение Max с методами для действий над ним.
 
@@ -181,6 +168,8 @@ class Message(CamelModel):
     :vartype id: int
     :ivar chat_id: ID чата, если он есть в данных сообщения.
     :vartype chat_id: int | None
+    :ivar post_id: ID поста канала, если сообщение является комментарием.
+    :vartype post_id: int | None
     :ivar sender: ID отправителя.
     :vartype sender: int | None
     :ivar text: Текст сообщения.
@@ -222,6 +211,7 @@ class Message(CamelModel):
 
     id: int
     chat_id: int | None = None
+    post_id: int | None = None
     sender: int | None = None
     text: str = ""
     time: int
@@ -261,7 +251,7 @@ class Message(CamelModel):
         notify: bool = True,
         send_at: DateTimeUnion | None = None,
     ) -> Message:
-        """Отправляет ответ на это сообщение в тот же чат.
+        """Отправляет ответ в тот же чат или ветку комментариев.
 
         :param text: Текст сообщения.
         :type text: str | None
@@ -276,9 +266,29 @@ class Message(CamelModel):
         :rtype: Message
         :raises RuntimeError: Если сообщение не привязано к сервису или не
             содержит ``chat_id``.
+        :raises ValueError: Если для комментария задана отложенная отправка.
         """
         actions, chat_id = self._bound()
 
+        if self.post_id is not None:
+            if send_at:
+                raise ValueError("Scheduled comments are not supported")
+
+            message = await actions.send_comment(
+                chat_id=chat_id,
+                post_id=self.post_id,
+                text=text,
+                reply_to=self.id,
+                attachments=attachments,
+                notify=notify,
+            )
+            if message.chat_id is None:
+                message.chat_id = chat_id
+            if message.post_id is None:
+                message.post_id = self.post_id
+
+            return message
+
         return await actions.send_message(
             chat_id=chat_id,
             text=text,
@@ -297,7 +307,7 @@ class Message(CamelModel):
         notify: bool = True,
         send_at: DateTimeUnion | None = None,
     ) -> Message:
-        """Отправляет сообщение в тот же чат.
+        """Отправляет сообщение в тот же чат или ветку комментариев.
 
         :param text: Текст сообщения.
         :type text: str | None
@@ -314,9 +324,29 @@ class Message(CamelModel):
         :rtype: Message
         :raises RuntimeError: Если сообщение не привязано к сервису или не
             содержит ``chat_id``.
+        :raises ValueError: Если для комментария задана отложенная отправка.
         """
         actions, chat_id = self._bound()
 
+        if self.post_id is not None:
+            if send_at:
+                raise ValueError("Scheduled comments are not supported")
+
+            message = await actions.send_comment(
+                chat_id=chat_id,
+                post_id=self.post_id,
+                text=text,
+                reply_to=reply_to,
+                attachments=attachments,
+                notify=notify,
+            )
+            if message.chat_id is None:
+                message.chat_id = chat_id
+            if message.post_id is None:
+                message.post_id = self.post_id
+
+            return message
+
         return await actions.send_message(
             chat_id=chat_id,
             text=text,
@@ -388,6 +418,21 @@ class Message(CamelModel):
         """
         actions, chat_id = self._bound()
 
+        if self.post_id is not None:
+            message = await actions.edit_comment(
+                chat_id=chat_id,
+                post_id=self.post_id,
+                message_id=self.id,
+                text=text,
+                attachments=attachments,
+            )
+            if message.chat_id is None:
+                message.chat_id = chat_id
+            if message.post_id is None:
+                message.post_id = self.post_id
+
+            return message
+
         return await actions.edit_message(
             chat_id=chat_id,
             message_id=self.id,
@@ -407,6 +452,14 @@ class Message(CamelModel):
         """
         actions, chat_id = self._bound()
 
+        if self.post_id is not None:
+            return await actions.delete_comment(
+                chat_id=chat_id,
+                post_id=self.post_id,
+                message_ids=[self.id],
+                for_me=for_me,
+            )
+
         return await actions.delete_message(
             chat_id=chat_id,
             message_ids=[self.id],
@@ -440,6 +493,14 @@ class Message(CamelModel):
         """
         actions, chat_id = self._bound()
 
+        if self.post_id is not None:
+            return await actions.add_comment_reaction(
+                chat_id=chat_id,
+                post_id=self.post_id,
+                message_id=self.id,
+                reaction=reaction,
+            )
+
         return await actions.add_reaction(
             chat_id=chat_id,
             message_id=self.id,
@@ -456,6 +517,13 @@ class Message(CamelModel):
         """
         actions, chat_id = self._bound()
 
+        if self.post_id is not None:
+            return await actions.remove_comment_reaction(
+                chat_id=chat_id,
+                post_id=self.post_id,
+                message_id=self.id,
+            )
+
         return await actions.remove_reaction(
             chat_id=chat_id,
             message_id=self.id,
@@ -507,6 +575,7 @@ class Message(CamelModel):
         return {
             **message,
             "chatId": value.get("chatId"),
+            "postId": value.get("postId"),
             "prevMessageId": value.get("prevMessageId"),
             "ttl": value.get("ttl"),
             "unread": value.get("unread"),

pymax/types/domain/story.py

@@ -0,0 +1,126 @@
+from typing import Annotated, Literal, TypeAlias
+
+from pydantic import Field
+
+from .attachments.enums import AttachmentType
+from .base import CamelModel
+
+
+class StoryCoordinates(CamelModel):
+    """Положение слоя сторис в долях ширины и высоты кадра."""
+
+    x: float
+    y: float
+    w: float
+    h: float
+    rotation: float = 0
+
+
+class StoryClickableLink(CamelModel):
+    """Ссылка слоя сторис и результат ее проверки сервером."""
+
+    url: str
+    check_result: int | None = None
+
+
+class StoryLayer(CamelModel):
+    """Слой сторис со ссылкой и координатами."""
+
+    type: int = 0
+    coordinates: StoryCoordinates
+    clickable_link: StoryClickableLink
+
+
+class StoryPhotoMedia(CamelModel):
+    """Фото сторис, полученное от Max, без обязательного токена загрузки."""
+
+    base_url: str
+    height: int
+    width: int
+    photo_id: int
+    preview_data: bytes | None = None
+    type: Literal[AttachmentType.PHOTO] = Field(alias="_type")
+
+
+class StoryVideoMedia(CamelModel):
+    """Видео сторис, полученное от Max.
+
+    В отличие от ``VideoAttachment``, не требует токен загрузки и
+    ``video_type``, которые используются при публикации.
+    """
+
+    height: int
+    width: int
+    video_id: int
+    duration: int | None = None
+    preview_data: bytes | None = None
+    type: Literal[AttachmentType.VIDEO] = Field(alias="_type")
+    thumbnail: str
+
+
+StoryMedia: TypeAlias = Annotated[
+    StoryPhotoMedia | StoryVideoMedia,
+    Field(discriminator="type"),
+]
+
+
+class Story(CamelModel):
+    """Сторис, возвращенная после публикации или при чтении.
+
+    :ivar id: ID сторис.
+    :ivar cid: Идентификатор публикации, сформированный клиентом.
+    :ivar media: Фото или видео сторис.
+    :ivar layers: Слои поверх кадра.
+    :ivar settings: Настройки сторис в формате Max.
+    :ivar expiration: Время жизни сторис в миллисекундах.
+    """
+
+    id: int
+    cid: int | None = None
+    media: StoryMedia
+    layers: list[StoryLayer] = Field(default_factory=list)
+    settings: int
+    expiration: int
+
+
+class StoryOwner(CamelModel):
+    """Владелец сторис.
+
+    :ivar owner_id: ID владельца, а не отдельной сторис.
+    :ivar type: Числовой тип владельца из Max. ``0`` — пользователь.
+    """
+
+    owner_id: int
+    type: int = 0
+
+
+class StoryPreview(CamelModel):
+    """Сводная информация о сторис владельца в ленте и обновлениях.
+
+    ID отдельных сторис в превью нет. Для их получения передайте
+    ``owner.owner_id`` и ``owner.type`` в ``client.get_stories()``.
+
+    :ivar owner: Владелец сторис.
+    :ivar total_count: Общее количество сторис владельца.
+    :ivar read_count: Количество просмотренных сторис владельца.
+    """
+
+    owner: StoryOwner
+    total_count: int = 0
+    read_count: int = 0
+    last_story_expiration_time: int = 0
+    settings: int = 0
+    update_time: int = 0
+
+
+class StoryDetailedStats(CamelModel):
+    """Запись подробной статистики просмотра или реакции на сторис.
+
+    Типизировано только ``user_id``. Дополнительные поля доступны в
+    ``model_extra`` с исходными именами ответа Max, без преобразования
+    camelCase. Поле ``reaction``, если оно пришло, остается словарем.
+
+    :ivar user_id: ID пользователя.
+    """
+
+    user_id: int

pymax/types/events/reaction.py

@@ -1,3 +1,7 @@
+from typing import Any
+
+from pydantic import model_validator
+
 from pymax.types.domain.base import CamelModel
 from pymax.types.domain.message import ReactionCounter
 
@@ -6,16 +10,36 @@ class ReactionUpdateEvent(CamelModel):
     """Событие обновления реакций сообщения.
 
     :ivar message_id: ID сообщения.
-    :vartype message_id: str
+    :vartype message_id: int
     :ivar chat_id: ID чата.
     :vartype chat_id: int
-    :ivar counters: Счетчики реакций по типам.
-    :vartype counters: list[ReactionCounter]
+    :ivar counters: Счетчики реакций по типам, если Max их прислал.
+    :vartype counters: list[ReactionCounter] | None
     :ivar total_count: Общее количество реакций.
     :vartype total_count: int
+    :ivar your_reaction: Реакция текущего пользователя, если она есть.
+    :vartype your_reaction: str | None
     """
 
-    message_id: str
+    message_id: int
     chat_id: int
     counters: list[ReactionCounter] | None = None
     total_count: int = 0
+    your_reaction: str | None = None
+
+    @model_validator(mode="before")
+    @classmethod
+    def _unwrap_reaction_info(cls, value: Any) -> Any:
+        if not isinstance(value, dict):
+            return value
+
+        reaction_info = value.get("reactionInfo")
+        if not isinstance(reaction_info, dict):
+            return value
+
+        data = value.copy()
+        for field in ("counters", "totalCount", "yourReaction"):
+            if field in reaction_info:
+                data[field] = reaction_info[field]
+
+        return data

pymax/versions/catalog.py

@@ -21,7 +21,7 @@ class VersionCatalog:
         remote: Загружать ли удаленные версии при :meth:`load`.
     """
 
-    RECOMMENDED_APP_VERSION: str = "26.25.0"
+    RECOMMENDED_APP_VERSION: str = "26.37.1"
     DEFAULT_REMOTE_URL: str = "https://hashes.pymax.org/versions.json"
 
     def __init__(self, remote: bool = False) -> None: