maxapi-python 0.1.1__tar.gz → 0.1.2__tar.gz

maxapi_python-0.1.2/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: ['https://www.donationalerts.com/r/pymax']

{maxapi_python-0.1.1 → maxapi_python-0.1.2}/.gitignore

@@ -114,3 +114,4 @@ cache/
 
 # Keep lockfiles and important configs tracked? If you want to track specific lockfiles,
 # remove them from this .gitignore (for example: remove poetry.lock or uv.lock).
+tests/

{maxapi_python-0.1.1 → maxapi_python-0.1.2}/PKG-INFO

@@ -1,17 +1,21 @@
 Metadata-Version: 2.4
 Name: maxapi-python
-Version: 0.1.1
+Version: 0.1.2
 Summary: Python wrapper для API мессенджера Max
 Project-URL: Homepage, https://github.com/noxzion/PyMax
 Project-URL: Repository, https://github.com/noxzion/PyMax
 Project-URL: Issues, https://github.com/noxzion/PyMax/issues
-Author-email: noxzion <negroid2281488ilikrilex@gmail.com>
+Author-email: noxzion <mail@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
 Keywords: api,max,messenger,websocket,wrapper
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: aiohttp>=3.12.15
+Requires-Dist: lz4>=4.4.4
+Requires-Dist: msgpack>=1.1.1
 Requires-Dist: sqlmodel>=0.0.24
 Requires-Dist: websockets>=11.0
 Description-Content-Type: text/markdown
@@ -31,6 +35,14 @@ Description-Content-Type: text/markdown
     <img src="https://img.shields.io/badge/packaging-uv-D7FF64.svg" alt="Packaging">
 </p>
 
+---
+> ⚠️ **Дисклеймер**
+> 
+> *   Это **неофициальная** библиотека для работы с внутренним API Max.
+> *   Использование может **нарушать условия предоставления услуг** сервиса.
+> *   **Вы используете её исключительно на свой страх и риск.**
+> *   **Разработчики и контрибьюторы не несут никакой ответственности** за любые последствия использования этого пакета, включая, но не ограничиваясь: блокировку аккаунтов, утерю данных, юридические риски и любые другие проблемы.
+> *   API может быть изменен в любой момент без предупреждения.
 ---
 
 ## Описание
@@ -74,7 +86,7 @@ phone = "+1234567890"
 client = MaxClient(phone=phone, work_dir="cache")
 
 # Обработчик входящих сообщений
-@client.on_message
+@client.on_message()
 async def handle_message(message: Message) -> None:
     print(f"{message.sender}: {message.text}")
 
@@ -133,12 +145,16 @@ if __name__ == "__main__":
 
 ## Документация
 
-WIP
+[WIP](https://noxzion.github.io/)
 
 ## Лицензия
 
 Этот проект распространяется под лицензией MIT. См. файл [LICENSE](LICENSE) для получения информации.
 
+## Новости
+
+[Telegram](https://t.me/pymax_news)
+
 ## Авторы
 
 - **[noxzion](https://github.com/noxzion)** — оригинальный автор проекта

{maxapi_python-0.1.1 → maxapi_python-0.1.2}/README.md

@@ -13,6 +13,14 @@
     <img src="https://img.shields.io/badge/packaging-uv-D7FF64.svg" alt="Packaging">
 </p>
 
+---
+> ⚠️ **Дисклеймер**
+> 
+> *   Это **неофициальная** библиотека для работы с внутренним API Max.
+> *   Использование может **нарушать условия предоставления услуг** сервиса.
+> *   **Вы используете её исключительно на свой страх и риск.**
+> *   **Разработчики и контрибьюторы не несут никакой ответственности** за любые последствия использования этого пакета, включая, но не ограничиваясь: блокировку аккаунтов, утерю данных, юридические риски и любые другие проблемы.
+> *   API может быть изменен в любой момент без предупреждения.
 ---
 
 ## Описание
@@ -56,7 +64,7 @@ phone = "+1234567890"
 client = MaxClient(phone=phone, work_dir="cache")
 
 # Обработчик входящих сообщений
-@client.on_message
+@client.on_message()
 async def handle_message(message: Message) -> None:
     print(f"{message.sender}: {message.text}")
 
@@ -115,12 +123,16 @@ if __name__ == "__main__":
 
 ## Документация
 
-WIP
+[WIP](https://noxzion.github.io/)
 
 ## Лицензия
 
 Этот проект распространяется под лицензией MIT. См. файл [LICENSE](LICENSE) для получения информации.
 
+## Новости
+
+[Telegram](https://t.me/pymax_news)
+
 ## Авторы
 
 - **[noxzion](https://github.com/noxzion)** — оригинальный автор проекта

{maxapi_python-0.1.1 → maxapi_python-0.1.2}/examples/example.py

@@ -1,6 +1,8 @@
 import asyncio
 
 from pymax import MaxClient, Message
+from pymax.files import Photo
+from pymax.filters import Filter
 
 phone = "+1234567890"
 
@@ -33,7 +35,7 @@ async def main() -> None:
     await client.close()
 
 
-@client.on_message
+@client.on_message(filter=Filter(text=["Привет"]))
 async def handle_message(message: Message) -> None:
     print(str(message.sender) + ": " + message.text)
 
@@ -41,14 +43,25 @@ async def handle_message(message: Message) -> None:
 @client.on_start
 async def handle_start() -> None:
     print("Client started successfully!")
-    history = await client.fetch_history(chat_id=0)
-    if history:
-        for message in history:
-            user_id = message.sender
-            user = await client.get_user(user_id)
-
-            if user:
-                print(f"{user.names[0].name}: {message.text}")
+    # history = await client.fetch_history(chat_id=0)
+    # if history:
+    #     for message in history:
+    #         user_id = message.sender
+    #         user = await client.get_user(user_id)
+
+    #         if user:
+    #             print(f"{user.names[0].name}: {message.text}")
+
+    # print(client.me.names[0].first_name)
+    # user = await client.get_user(client.me.id)
+
+    # print(user.names[0].first_name)
+    photo1 = Photo(path="tests/test.jpeg")
+    photo2 = Photo(path="tests/test.jpg")
+
+    await client.send_message(
+        "Hello with photo!", chat_id=0, photos=[photo1, photo2], notify=True
+    )
 
 
 if __name__ == "__main__":

{maxapi_python-0.1.1 → maxapi_python-0.1.2}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "maxapi-python"
-version = "0.1.1"
+version = "0.1.2"
 description = "Python wrapper для API мессенджера Max"
 readme = "README.md"
 requires-python = ">=3.10"
 authors = [
-    { name = "noxzion", email = "negroid2281488ilikrilex@gmail.com" }
+    { name = "noxzion", email = "mail@gmail.com" }
 ]
 license = "MIT"
 keywords = ["max", "messenger", "api", "wrapper", "websocket"]
@@ -17,6 +17,10 @@ classifiers = [
 dependencies = [
     "sqlmodel>=0.0.24",
     "websockets>=11.0",
+    "msgpack>=1.1.1",
+    "lz4>=4.4.4",
+    "aiohttp>=3.12.15",
+    "aiofiles>=24.1.0",
 ]
 
 [project.urls]
@@ -28,8 +32,8 @@ Issues = "https://github.com/noxzion/PyMax/issues"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.hatch.build.targets.wheel]
-packages = ["pymax"]
+[tool.setuptools.packages.find]
+where = ["src"]
 
 [tool.setuptools.package-dir]
 "" = "src"
@@ -41,3 +45,6 @@ dev = [
     "mkdocstrings[python]>=0.30.0",
     "pydocstring>=0.2.1",
 ]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pymax"]

maxapi_python-0.1.2/scripts/build.py

@@ -0,0 +1,47 @@
+import argparse
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def build_package(clean: bool = False):
+    script_dir = Path(__file__).resolve().parent
+
+    project_root = script_dir.parent.resolve()
+
+    dist_path = project_root / "dist"
+
+    if clean and dist_path.exists() and dist_path.is_dir():
+        shutil.rmtree(dist_path)
+
+    try:
+        subprocess.run([sys.executable, "-m", "build"], check=True)
+
+    except subprocess.CalledProcessError as e:
+        print(f"Build failed: {e}")
+
+        sys.exit()
+
+    if dist_path.exists() and dist_path.is_dir():
+        print("Build successful. Files in dist:")
+
+        for f in dist_path.iterdir():
+            print("  ", f.name)
+
+    else:
+        print("Build failed.")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Build the pymax Python package")
+    parser.add_argument(
+        "-c", "--clean", action="store_true", help="Clean previous builds before building."
+    )
+
+    args = parser.parse_args()
+    build_package(clean=args.clean)
+
+
+if __name__ == "__main__":
+    main()

maxapi_python-0.1.2/src/pymax/core.py

@@ -0,0 +1,156 @@
+import asyncio
+import json
+import logging
+import re
+import time
+from collections.abc import Awaitable, Callable
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+import websockets
+
+from .crud import Database
+from .exceptions import InvalidPhoneError, WebSocketNotConnectedError
+from .mixins import ApiMixin, WebSocketMixin
+from .payloads import (
+    BaseWebSocketMessage,
+    SyncPayload,
+)
+from .static import ChatType, Constants, Opcode
+from .types import Channel, Chat, Dialog, Me, Message, User, override
+
+if TYPE_CHECKING:
+    from .filters import Filter
+
+logger = logging.getLogger(__name__)
+
+
+class MaxClient(ApiMixin, WebSocketMixin):
+    """
+    Основной клиент для работы с WebSocket API сервиса Max.
+
+
+    Args:
+        phone (str): Номер телефона для авторизации.
+        uri (str, optional): URI WebSocket сервера. По умолчанию Constants.WEBSOCKET_URI.value.
+        work_dir (str, optional): Рабочая директория для хранения базы данных. По умолчанию ".".
+        logger (logging.Logger | None): Пользовательский логгер. Если не передан — используется
+            логгер модуля с именем f"{__name__}.MaxClient".
+
+    Raises:
+        InvalidPhoneError: Если формат номера телефона неверный.
+    """
+
+    def __init__(
+        self,
+        phone: str,
+        uri: str = Constants.WEBSOCKET_URI.value,
+        headers: dict[str, Any] | None = Constants.DEFAULT_USER_AGENT.value,
+        token: str | None = None,
+        work_dir: str = ".",
+        logger: logging.Logger | None = None,
+    ) -> None:
+        self.uri: str = uri
+        self.is_connected: bool = False
+        self.phone: str = phone
+        self.chats: list[Chat] = []
+        self.dialogs: list[Dialog] = []
+        self.channels: list[Channel] = []
+        self.me: Me | None = None
+        self._users: dict[int, User] = {}
+        if not self._check_phone():
+            raise InvalidPhoneError(self.phone)
+        self._work_dir: str = work_dir
+        self._database_path: Path = Path(work_dir) / "session.db"
+        self._database_path.parent.mkdir(parents=True, exist_ok=True)
+        self._database_path.touch(exist_ok=True)
+        self._database = Database(self._work_dir)
+        self._ws: websockets.ClientConnection | None = None
+        self._seq: int = 0
+        self._pending: dict[int, asyncio.Future[dict[str, Any]]] = {}
+        self._recv_task: asyncio.Task[Any] | None = None
+        self._incoming: asyncio.Queue[dict[str, Any]] | None = None
+        self._device_id = self._database.get_device_id()
+        self._token = self._database.get_auth_token() or token
+        self.user_agent = headers
+        self._on_message_handlers: list[
+            tuple[Callable[[Message], Any], Filter | None]
+        ] = []
+        self._on_start_handler: Callable[[], Any | Awaitable[Any]] | None = None
+        self._background_tasks: set[asyncio.Task[Any]] = set()
+        self.logger = logger or logging.getLogger(f"{__name__}.MaxClient")
+        self._setup_logger()
+
+        self.logger.debug(
+            "Initialized MaxClient uri=%s work_dir=%s", self.uri, self._work_dir
+        )
+
+    def _setup_logger(self) -> None:
+        self.logger.setLevel(logging.INFO)
+
+        if not logger.handlers:
+            handler = logging.StreamHandler()
+            formatter = logging.Formatter(
+                "%(asctime)s [%(levelname)s] %(name)s: %(message)s"
+            )
+            handler.setFormatter(formatter)
+            logger.addHandler(handler)
+
+    async def close(self) -> None:
+        try:
+            self.logger.info("Closing client")
+            if self._recv_task:
+                self._recv_task.cancel()
+                try:
+                    await self._recv_task
+                except asyncio.CancelledError:
+                    self.logger.debug("recv_task cancelled")
+            if self._ws:
+                await self._ws.close()
+            self.is_connected = False
+            self.logger.info("Client closed")
+        except Exception:
+            self.logger.exception("Error closing client")
+
+    async def start(self) -> None:
+        """
+        Запускает клиент, подключается к WebSocket, авторизует
+        пользователя (если нужно) и запускает фоновый цикл.
+        """
+        try:
+            self.logger.info("Client starting")
+            await self._connect(self.user_agent)
+
+            if self._token and self._database.get_auth_token() is None:
+                self._database.update_auth_token(self._device_id, self._token)
+
+            if self._token is None:
+                await self._login()
+            else:
+                await self._sync()
+
+            if self._on_start_handler:
+                self.logger.debug("Calling on_start handler")
+                result = self._on_start_handler()
+                if asyncio.iscoroutine(result):
+                    await result
+
+            if self._ws:
+                ping_task = asyncio.create_task(self._send_interactive_ping())
+                self._background_tasks.add(ping_task)
+                ping_task.add_done_callback(
+                    lambda t: self._background_tasks.discard(t)
+                    or self._log_task_exception(t)
+                )
+
+                try:
+                    await self._ws.wait_closed()
+                except asyncio.CancelledError:
+                    self.logger.debug("wait_closed cancelled")
+        except Exception:
+            self.logger.exception("Client start failed")
+
+
+class SocketMaxClient:
+    pass  # нокс займись
+    # нет не займусь 

maxapi_python-0.1.2/src/pymax/files.py

@@ -0,0 +1,85 @@
+import mimetypes
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import ClassVar, override
+
+from aiofiles import open as aio_open
+from aiohttp import ClientSession
+
+
+class BaseFile(ABC):
+    def __init__(self, url: str | None = None, path: str | None = None) -> None:
+        self.url = url
+        self.path = path
+
+        if self.url is None and self.path is None:
+            raise ValueError("Either url or path must be provided.")
+
+        if self.url and self.path:
+            raise ValueError("Only one of url or path must be provided.")
+
+    @abstractmethod
+    async def read(self) -> bytes:
+        if self.url:
+            async with ClientSession() as session, session.get(self.url) as response:
+                response.raise_for_status()
+                return await response.read()
+        elif self.path:
+            async with aio_open(self.path, "rb") as f:
+                return await f.read()
+        else:
+            raise ValueError("Either url or path must be provided.")
+
+
+class Photo(BaseFile):
+    ALLOWED_EXTENSIONS: ClassVar[set[str]] = {
+        ".jpg",
+        ".jpeg",
+        ".png",
+        ".gif",
+        ".webp",
+        ".bmp",
+    }  # FIXME: костыль ✅
+
+    def __init__(self, url: str | None = None, path: str | None = None) -> None:
+        super().__init__(url, path)
+
+    def validate_photo(self) -> tuple[str, str] | None:
+        if self.path:
+            extension = Path(self.path).suffix.lower()
+            if extension not in self.ALLOWED_EXTENSIONS:
+                raise ValueError(
+                    f"Invalid photo extension: {extension}. Allowed: {self.ALLOWED_EXTENSIONS}"
+                )
+
+            return (extension[1:], ("image/" + extension[1:]).lower())
+        elif self.url:
+            extension = Path(self.url).suffix.lower()
+            if extension in self.ALLOWED_EXTENSIONS:
+                raise ValueError(
+                    f"Invalid photo extension in URL: {extension}. Allowed: {self.ALLOWED_EXTENSIONS}"
+                )
+
+            mime_type = mimetypes.guess_type(self.url)[0]
+
+            if not mime_type or not mime_type.startswith("image/"):
+                raise ValueError(f"URL does not appear to be an image: {self.url}")
+
+            return (extension[1:], mime_type)
+        return None
+
+    @override
+    async def read(self) -> bytes:
+        return await super().read()
+
+
+class Video(BaseFile):
+    @override
+    async def read(self) -> bytes:
+        return await super().read()
+
+
+class File(BaseFile):
+    @override
+    async def read(self) -> bytes:
+        return await super().read()

maxapi_python-0.1.2/src/pymax/filters.py

@@ -0,0 +1,38 @@
+from .static import MessageStatus, MessageType
+from .types import Message
+
+
+class Filter:
+    def __init__(
+        self,
+        user_id: int | None = None,
+        text: list[str] | None = None,
+        status: MessageStatus | str | None = None,
+        type: MessageType | str | None = None,
+        text_contains: str | None = None,
+        reaction_info: bool | None = None,
+    ) -> None:
+        self.user_id = user_id
+        self.text = text
+        self.status = status
+        self.type = type
+        self.reaction_info = reaction_info
+        self.text_contains = text_contains
+
+    def match(self, message: Message) -> bool:
+        if self.user_id is not None and message.sender != self.user_id:
+            return False
+        if self.text is not None and any(
+            text not in message.text for text in self.text
+        ):
+            return False
+        if self.text_contains is not None and self.text_contains not in message.text:
+            return False
+        if self.status is not None and message.status != self.status:
+            return False
+        if self.type is not None and message.type != self.type:
+            return False
+        if self.reaction_info is not None and message.reactionInfo is None:  # noqa: SIM103
+            return False
+
+        return True

maxapi_python-0.1.2/src/pymax/interfaces.py

@@ -0,0 +1,67 @@
+import asyncio
+import logging
+from abc import ABC, abstractmethod
+from collections.abc import Awaitable, Callable
+from logging import Logger
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+import websockets
+
+from .filters import Filter
+from .static import Constants
+from .types import Channel, Chat, Dialog, Me, Message, User
+
+if TYPE_CHECKING:
+    from uuid import UUID
+
+    from .crud import Database
+
+
+class ClientProtocol(ABC):
+    def __init__(self, logger: Logger) -> None:
+        super().__init__()
+        self.logger = logger
+        self._users: dict[int, User] = {}
+        self.chats: list[Chat] = []
+        self.phone: str = ""
+        self._database: Database
+        self._device_id: UUID
+        self._on_message_handlers: list[
+            tuple[Callable[[Message], Any], Filter | None]
+        ] = []
+        self.uri: str
+        self.is_connected: bool = False
+        self.phone: str
+        self.chats: list[Chat] = []
+        self.dialogs: list[Dialog] = []
+        self.channels: list[Channel] = []
+        self.me: Me | None = None
+        self._users: dict[int, User] = {}
+        self._work_dir: str
+        self._database_path: Path
+        self._ws: websockets.ClientConnection | None = None
+        self._seq: int = 0
+        self._pending: dict[int, asyncio.Future[dict[str, Any]]] = {}
+        self._recv_task: asyncio.Task[Any] | None = None
+        self._incoming: asyncio.Queue[dict[str, Any]] | None = None
+        self.user_agent = Constants.DEFAULT_USER_AGENT.value
+        self._on_message_handlers: list[
+            tuple[Callable[[Message], Any], Filter | None]
+        ] = []
+        self._on_start_handler: Callable[[], Any | Awaitable[Any]] | None = None
+        self._background_tasks: set[asyncio.Task[Any]] = set()
+
+    @abstractmethod
+    async def _send_and_wait(
+        self,
+        opcode: int,
+        payload: dict[str, Any],
+        cmd: int = 0,
+        timeout: float = Constants.DEFAULT_TIMEOUT.value,
+    ) -> dict[str, Any]:
+        pass
+
+    @abstractmethod
+    async def _get_chat(self, chat_id: int) -> Chat | None:
+        pass

maxapi_python-0.1.2/src/pymax/mixins/__init__.py

@@ -0,0 +1,18 @@
+from .auth import AuthMixin
+from .channel import ChannelMixin
+from .handler import HandlerMixin
+from .message import MessageMixin
+from .self import SelfMixin
+from .user import UserMixin
+from .websocket import WebSocketMixin
+
+
+class ApiMixin(
+    AuthMixin,
+    HandlerMixin,
+    UserMixin,
+    ChannelMixin,
+    SelfMixin,
+    MessageMixin,
+):
+    pass