maxapi-python 1.1.12__tar.gz → 1.1.14__tar.gz

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/.github/ISSUE_TEMPLATE/bug_report.md

@@ -11,9 +11,9 @@ assignees: ''
 Что пошло не так?
 
 **Шаги для воспроизведения**
-1. 
-2. 
-3. 
+1.
+2.
+3.
 
 **Ожидаемый результат**
 Что должно было произойти

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/.github/workflows/publish.yml

@@ -51,4 +51,4 @@ jobs:
         env:
           TOKEN: ${{ secrets.PYPI_API_TOKEN }}
         run: |
-          uv publish -t $TOKEN
+          uv publish -t $TOKEN

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/.gitignore

@@ -118,4 +118,4 @@ tests/
 
 
 # Bad dev's requirements
-requirements.txt
+requirements.txt

maxapi_python-1.1.14/.pre-commit-config.yaml

@@ -0,0 +1,41 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-case-conflict
+      - id: check-docstring-first
+      - id: check-executables-have-shebangs
+      - id: check-shebang-scripts-are-executable
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: fix-byte-order-marker
+      - id: mixed-line-ending
+      - id: name-tests-test
+      - id: trailing-whitespace
+  - repo: https://github.com/psf/black
+    rev: 25.9.0
+    hooks:
+      - id: black
+  - repo: https://github.com/csachs/pyproject-flake8
+    rev: v7.0.0
+    hooks:
+      - id: pyproject-flake8
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.18.2
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - "aiohttp"
+          - "sqlalchemy"
+          - "sqlmodel"
+          - "types-aiofiles"
+          - "types-requests"
+        exclude: "^examples/"
+  - repo: https://github.com/pycqa/isort
+    rev: 7.0.0
+    hooks:
+      - id: isort
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.6
+    hooks:
+      - id: bandit

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 noxzion
+Copyright (c) 2025 ink-developer
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: maxapi-python
-Version: 1.1.12
+Version: 1.1.14
 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 <mail@gmail.com>
+Project-URL: Homepage, https://github.com/ink-developer/PyMax
+Project-URL: Repository, https://github.com/ink-developer/PyMax
+Project-URL: Issues, https://github.com/ink-developer/PyMax/issues
+Author-email: ink <mail@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
 Keywords: api,max,messenger,websocket,wrapper
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
 
 ---
 > ⚠️ **Дисклеймер**
-> 
+>
 > *   Это **неофициальная** библиотека для работы с внутренним API Max.
 > *   Использование может **нарушать условия предоставления услуг** сервиса.
 > *   **Вы используете её исключительно на свой страх и риск.**
@@ -94,7 +94,7 @@ async def handle_message(message: Message) -> None:
 @client.on_start
 async def handle_start() -> None:
     print("Клиент запущен")
-    
+
     # Получение истории сообщений
     history = await client.fetch_history(chat_id=0)
     if history:
@@ -105,38 +105,38 @@ async def handle_start() -> None:
 
 async def main() -> None:
     await client.start()
-    
+
     # Работа с чатами
     for chat in client.chats:
         print(f"Чат: {chat.title}")
-        
+
         # Отправка сообщения
         message = await client.send_message(
-            "Привет от PyMax!", 
-            chat.id, 
+            "Привет от PyMax!",
+            chat.id,
             notify=True
         )
-        
+
         # Редактирование сообщения
         await asyncio.sleep(2)
         await client.edit_message(
-            chat.id, 
-            message.id, 
+            chat.id,
+            message.id,
             "Привет от PyMax! (отредактировано)"
         )
-        
+
         # Удаление сообщения
         await asyncio.sleep(2)
         await client.delete_message(chat.id, [message.id], for_me=False)
-    
+
     # Работа с диалогами
     for dialog in client.dialogs:
         print(f"Диалог: {dialog.last_message.text}")
-    
+
     # Работа с каналами
     for channel in client.channels:
         print(f"Канал: {channel.title}")
-    
+
     await client.close()
 
 if __name__ == "__main__":
@@ -145,7 +145,7 @@ if __name__ == "__main__":
 
 ## Документация
 
-[WIP](https://noxzion.github.io/)
+[WIP](https://ink-developer.github.io/)
 
 ## Лицензия
 
@@ -157,7 +157,7 @@ if __name__ == "__main__":
 
 ## Авторы
 
-- **[noxzion](https://github.com/noxzion)** — Оригинальный автор проекта
+- **[ink-developer](https://github.com/ink-developer)** — Оригинальный автор проекта
 - **[ink](https://github.com/ink-developer)** — Главный разработчик, исследование API и его документация
 
 ## Контрибьюторы

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/README.md

@@ -15,7 +15,7 @@
 
 ---
 > ⚠️ **Дисклеймер**
-> 
+>
 > *   Это **неофициальная** библиотека для работы с внутренним API Max.
 > *   Использование может **нарушать условия предоставления услуг** сервиса.
 > *   **Вы используете её исключительно на свой страх и риск.**
@@ -72,7 +72,7 @@ async def handle_message(message: Message) -> None:
 @client.on_start
 async def handle_start() -> None:
     print("Клиент запущен")
-    
+
     # Получение истории сообщений
     history = await client.fetch_history(chat_id=0)
     if history:
@@ -83,38 +83,38 @@ async def handle_start() -> None:
 
 async def main() -> None:
     await client.start()
-    
+
     # Работа с чатами
     for chat in client.chats:
         print(f"Чат: {chat.title}")
-        
+
         # Отправка сообщения
         message = await client.send_message(
-            "Привет от PyMax!", 
-            chat.id, 
+            "Привет от PyMax!",
+            chat.id,
             notify=True
         )
-        
+
         # Редактирование сообщения
         await asyncio.sleep(2)
         await client.edit_message(
-            chat.id, 
-            message.id, 
+            chat.id,
+            message.id,
             "Привет от PyMax! (отредактировано)"
         )
-        
+
         # Удаление сообщения
         await asyncio.sleep(2)
         await client.delete_message(chat.id, [message.id], for_me=False)
-    
+
     # Работа с диалогами
     for dialog in client.dialogs:
         print(f"Диалог: {dialog.last_message.text}")
-    
+
     # Работа с каналами
     for channel in client.channels:
         print(f"Канал: {channel.title}")
-    
+
     await client.close()
 
 if __name__ == "__main__":
@@ -123,7 +123,7 @@ if __name__ == "__main__":
 
 ## Документация
 
-[WIP](https://noxzion.github.io/)
+[WIP](https://ink-developer.github.io/)
 
 ## Лицензия
 
@@ -135,7 +135,7 @@ if __name__ == "__main__":
 
 ## Авторы
 
-- **[noxzion](https://github.com/noxzion)** — Оригинальный автор проекта
+- **[ink-developer](https://github.com/ink-developer)** — Оригинальный автор проекта
 - **[ink](https://github.com/ink-developer)** — Главный разработчик, исследование API и его документация
 
 ## Контрибьюторы

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/assets/icon.svg

@@ -11,4 +11,3 @@
         <path d="M33.3539 21.0919L33.1508 29.8751L33.0395 34.6974L29.1625 31.8253L24.0121 28.0089L21.5912 26.216L23.4604 24.4816L30.7885 30.0001L30.9223 17.5587L33.4916 15.1779L33.3539 21.0919Z" fill="#2F9872"/>
     </g>
 </svg>
-    

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/assets/logo.svg

@@ -11,4 +11,3 @@
     <path d="M33.3539 21.0919L33.1508 29.8751L33.0395 34.6974L29.1625 31.8253L24.0121 28.0089L21.5912 26.216L23.4604 24.4816L30.7885 30.0001L30.9223 17.5587L33.4916 15.1779L33.3539 21.0919Z" fill="#2F9872"/>
     </g>
     </svg>
-    

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/docs/assets/icon.svg

@@ -11,4 +11,3 @@
         <path d="M33.3539 21.0919L33.1508 29.8751L33.0395 34.6974L29.1625 31.8253L24.0121 28.0089L21.5912 26.216L23.4604 24.4816L30.7885 30.0001L30.9223 17.5587L33.4916 15.1779L33.3539 21.0919Z" fill="#2F9872"/>
     </g>
 </svg>
-    

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/docs/client.md

@@ -19,7 +19,7 @@
 client = MaxClient(
     phone: str,
     uri: str = Constants.WEBSOCKET_URI.value,
-    headers: dict[str, Any] | None = Constants.DEFAULT_USER_AGENT.value,
+    headers: dict[str, Any] | None = Constants.DEFAULT_USER_AGENT_PAYLOAD.value,
     token: str | None = None,
     send_fake_telemetry: bool = True,
     host: str = Constants.HOST.value,
@@ -35,7 +35,7 @@ client = MaxClient(
 |----------|-----|----------|---------------|
 | `phone` | `str` | Номер телефона для авторизации | - |
 | `uri` | `str` | URI WebSocket сервера | `Constants.WEBSOCKET_URI.value` |
-| `headers` | `dict[str, Any] \| None` | Заголовки для соединения | `Constants.DEFAULT_USER_AGENT.value` |
+| `headers` | `dict[str, Any] \| None` | Заголовки для соединения | `Constants.DEFAULT_USER_AGENT_PAYLOAD.value` |
 | `token` | `str \| None` | Токен авторизации | `None` |
 | `send_fake_telemetry` | `bool` | Отправка телеметрии | `True` |
 | `host` | `str` | Хост API сервера | `Constants.HOST.value` |

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/docs/examples.md

@@ -8,14 +8,14 @@ from pymax import MaxClient
 
 async def main():
     client = MaxClient(phone="+79001234567")
-    
+
     @client.on_message
     async def echo_handler(message):
         await client.send_message(
             chat_id=message.chat_id,
             text=f"Эхо: {message.text}"
         )
-    
+
     await client.start()
 
 asyncio.run(main())
@@ -29,7 +29,7 @@ from pymax import MaxClient
 
 async def main():
     client = MaxClient(phone="+79001234567")
-    
+
     # Словарь ключевых слов и ответов
     auto_replies = {
         'привет': 'Привет! Как дела?',
@@ -37,11 +37,11 @@ async def main():
         'спасибо': 'Пожалуйста!',
         'время': 'Время ответить на ваш вопрос!',
     }
-    
+
     @client.on_message
     async def auto_reply_handler(message):
         text = message.text.lower()
-        
+
         for keyword, reply in auto_replies.items():
             if keyword in text:
                 await client.send_message(
@@ -49,7 +49,7 @@ async def main():
                     text=reply
                 )
                 break
-    
+
     await client.start()
 
 asyncio.run(main())
@@ -63,14 +63,14 @@ from pymax import MaxClient
 
 async def main():
     client = MaxClient(phone="+79001234567")
-    
+
     # Запрещенные слова
     forbidden_words = ['спам', 'реклама', 'взлом']
-    
+
     @client.on_message
     async def moderation_handler(message):
         text = message.text.lower()
-        
+
         for word in forbidden_words:
             if word in text:
                 # Удаляем сообщение
@@ -78,14 +78,14 @@ async def main():
                     chat_id=message.chat_id,
                     message_id=message.id
                 )
-                
+
                 # Предупреждаем пользователя
                 await client.send_message(
                     chat_id=message.chat_id,
                     text=f"@{message.author.username}, использование запрещенных слов недопустимо!"
                 )
                 break
-    
+
     await client.start()
 
 asyncio.run(main())

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/docs/index.md

@@ -39,6 +39,6 @@ uv add -U maxapi-python
 
 ## Ссылки
 
-- [GitHub](https://github.com/noxzion/PyMax)
+- [GitHub](https://github.com/ink-developer/PyMax)
 - [PyPI](https://pypi.org/project/pymax/)
-- [Issues](https://github.com/noxzion/PyMax/issues)
+- [Issues](https://github.com/ink-developer/PyMax/issues)

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/examples/example.py

@@ -1,16 +1,13 @@
 import asyncio
-import logging
 
-from pymax import MaxClient, Message, SocketMaxClient
-from pymax.files import Photo
+from pymax import MaxClient, Message
 from pymax.filters import Filter
-from pymax.static import AttachType
+from pymax.static.enum import AttachType
 
 phone = "+1234567890"
 
 
 client = MaxClient(phone=phone, work_dir="cache")
-# client = SocketMaxClient(phone=phone, work_dir="cache")
 
 
 @client.on_message(filter=Filter(chat_id=0))
@@ -18,9 +15,26 @@ async def handle_message(message: Message) -> None:
     print(str(message.sender) + ": " + message.text)
 
 
+@client.on_message_edit()
+async def handle_edited_message(message: Message) -> None:
+    print(f"Edited message in chat {message.chat_id}: {message.text}")
+
+
+@client.on_message_delete()
+async def handle_deleted_message(message: Message) -> None:
+    print(f"Deleted message in chat {message.chat_id}: {message.id}")
+
+
 @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:
+            if message.attaches:
+                for attach in message.attaches:
+                    if attach.type == AttachType.STICKER:
+                        print(attach.lottie_url)
     # chat = await client.rework_invite_link(chat_id=0)
     # print(chat.link)
     # text = """
@@ -78,12 +92,12 @@ async def handle_start() -> None:
     # print(client.me.names[0].first_name)
     # user = await client.get_user(client.me.id)
 
-    photo1 = Photo(path="tests/test.jpeg")
-    photo2 = Photo(path="tests/test.jpg")
+    # 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
-    )
+    # await client.send_message(
+    #     "Hello with photo!", chat_id=0, photos=[photo1, photo2], notify=True
+    # )
 
 
 if __name__ == "__main__":

maxapi_python-1.1.14/examples/telegram_bridge.py

@@ -0,0 +1,202 @@
+import asyncio
+import os
+from io import BytesIO
+
+import aiohttp
+from aiogram import Bot, Dispatcher, types
+from dotenv import load_dotenv
+
+from pymax import Chat, MaxClient, Message, User
+from pymax.types import FileAttach, PhotoAttach, VideoAttach
+
+"""
+Зависимости:
+
+pip install maxapi-python==1.1.13 aiogram==3.22.0 python-dotenv
+
+"""
+
+
+"""
+В .env нужно указать:
+
+PHONE = "+7123456789"  # Твой номер для Max
+BOT_TOKEN = "23456789:AAH0cJ3SNzZ2zzD0uF8HOqmxtKpwsKwggM"  # Твой токен Telegram-бота
+
+"""
+
+chats = {  # В формате айди чата в Max: айди чата в Telegram
+    -68690734055662: -1003177746657,
+}
+
+
+# Создаём зеркальный массив для отправки из Telegram в Max
+chats_telegram = {value: key for key, value in chats.items()}
+
+
+# Загружаем .env
+load_dotenv(override=True)
+
+
+# Настройки из .env
+PHONE = os.getenv("PHONE")  # Номер телефона Max
+telegram_bot_TOKEN = os.getenv("BOT_TOKEN")  # Токен TG-бота
+
+
+client = MaxClient(phone=PHONE, work_dir="cache")
+
+
+# Инициализация TG-бота
+telegram_bot = Bot(token=telegram_bot_TOKEN)
+dp = Dispatcher()
+
+
+# Обработчик входящих сообщений MAX
+@client.on_message()
+async def handle_message(message: Message) -> None:
+    tg_id = chats[message.chat_id]
+
+    sender = await client.get_user(user_id=message.sender)
+
+    if message.attaches:
+        for attach in message.attaches:
+            # Проверка на видео
+            if isinstance(attach, VideoAttach):
+                async with aiohttp.ClientSession() as session:
+                    try:
+                        # Получаем видео по айди
+                        video = await client.get_video_by_id(
+                            chat_id=message.chat_id,
+                            message_id=message.id,
+                            video_id=attach.video_id,
+                        )
+
+                        # Загружаем видео по URL
+                        async with session.get(video.url) as response:
+                            response.raise_for_status()  # Проверка на ошибки HTTP
+                            video_bytes = BytesIO(await response.read())
+                            video_bytes.name = response.headers.get("X-File-Name")
+
+                        # Отправляем видео через телеграм бота
+                        await telegram_bot.send_video(
+                            chat_id=tg_id,
+                            caption=f"{sender.names[0].name}: {message.text}",
+                            video=types.BufferedInputFile(
+                                video_bytes.getvalue(), filename=video_bytes.name
+                            ),
+                        )
+
+                        # Очищаем память
+                        video_bytes.close()
+
+                    except aiohttp.ClientError as e:
+                        print(f"Ошибка при загрузке видео: {e}")
+                    except Exception as e:
+                        print(f"Ошибка при отправке видео: {e}")
+
+            # Проверка на изображение
+            elif isinstance(attach, PhotoAttach):
+                async with aiohttp.ClientSession() as session:
+                    try:
+                        # Загружаем изображение по URL
+                        async with session.get(attach.base_url) as response:
+                            response.raise_for_status()  # Проверка на ошибки HTTP
+                            photo_bytes = BytesIO(await response.read())
+                            photo_bytes.name = response.headers.get("X-File-Name")
+
+                        # Отправляем фото через телеграм бота
+                        await telegram_bot.send_photo(
+                            chat_id=tg_id,
+                            caption=f"{sender.names[0].name}: {message.text}",
+                            photo=types.BufferedInputFile(
+                                photo_bytes.getvalue(), filename=photo_bytes.name
+                            ),
+                        )
+
+                        # Очищаем память
+                        photo_bytes.close()
+
+                    except aiohttp.ClientError as e:
+                        print(f"Ошибка при загрузке изображения: {e}")
+                    except Exception as e:
+                        print(f"Ошибка при отправке фото: {e}")
+
+            # Проверка на файл
+            elif isinstance(attach, FileAttach):
+                async with aiohttp.ClientSession() as session:
+                    try:
+                        # Получаем файл по айди
+                        file = await client.get_file_by_id(
+                            chat_id=message.chat_id,
+                            message_id=message.id,
+                            file_id=attach.file_id,
+                        )
+
+                        # Загружаем файл по URL
+                        async with session.get(file.url) as response:
+                            response.raise_for_status()  # Проверка на ошибки HTTP
+                            file_bytes = BytesIO(await response.read())
+                            file_bytes.name = response.headers.get("X-File-Name")
+
+                        # Отправляем файл через телеграм бота
+                        await telegram_bot.send_document(
+                            chat_id=tg_id,
+                            caption=f"{sender.names[0].name}: {message.text}",
+                            document=types.BufferedInputFile(
+                                file_bytes.getvalue(), filename=file_bytes.name
+                            ),
+                        )
+
+                        # Очищаем память
+                        file_bytes.close()
+
+                    except aiohttp.ClientError as e:
+                        print(f"Ошибка при загрузке файла: {e}")
+                    except Exception as e:
+                        print(f"Ошибка при отправке файла: {e}")
+    else:
+        await telegram_bot.send_message(
+            chat_id=tg_id, text=f"{sender.names[0].name}: {message.text}"
+        )
+
+
+# Обработчик запуска клиента, функция выводит все сообщения из чата "Избранное"
+@client.on_start
+async def handle_start() -> None:
+    print("Клиент запущен")
+
+    # Получение истории сообщений
+    history = await client.fetch_history(chat_id=0)
+    if history:
+        for message in history:
+            user = await client.get_user(message.sender)
+            if user:
+                print(f"{user.names[0].name}: {message.text}")
+
+
+# Обработчик сообщений Telegram
+@dp.message()
+async def handle_message(message: types.Message, bot: Bot) -> None:
+    max_id = chats_telegram[message.chat.id]
+    await client.send_message(chat_id=max_id, text=message.text, notify=True)
+
+
+# Раннер ботов
+async def main() -> None:
+    # TG-бот в фоне
+    telegram_bot_task = asyncio.create_task(dp.start_polling(telegram_bot))
+
+    try:
+        while True:  # Не спрашивайте 😃
+            await client.start()
+
+    finally:
+        await client.close()
+        telegram_bot_task.cancel()
+
+
+if __name__ == "__main__":
+    try:
+        asyncio.run(main())
+    except KeyboardInterrupt:
+        print("Программа остановлена пользователем.")

{maxapi_python-1.1.12 → maxapi_python-1.1.14}/mkdocs.yml

@@ -150,6 +150,6 @@ markdown_extensions:
 extra:
   social:
     - icon: fontawesome/brands/github
-      link: https://github.com/noxzion/PyMax
+      link: https://github.com/ink-developer/PyMax
     - icon: fontawesome/brands/python
       link: https://pypi.org/project/maxapi-python