PyPlayerokAPI 1.0.1__tar.gz → 1.0.2__tar.gz

{pyplayerokapi-1.0.1 → pyplayerokapi-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPlayerokAPI
-Version: 1.0.1
+Version: 1.0.2
 Summary: Неофициальная асинхронная Python-библиотека для взаимодействия с торговой площадкой Playerok через GraphQL API и систему потоковых событий.
 Home-page: https://github.com/kekch127/PyPlayerokAPI
 Author: kekch127
@@ -72,16 +72,16 @@ GraphQL • Streaming • Proxy • Production-ready transport
 ---
 # 📚 Содержание
 
-- [[#Особенности]]
-- [[#Требования]]
-- [[#Установка]]
-- [[#Аутентификация]]
-- [[#Структура библиотеки]]
-- [[#Примеры использования]]
-	- [[#Предисловие]]
-	- [[#Общие варианты использования]]
-	- [[#Готовые варианты использования]]
-- [[#Дополнительная информация]]
+- [Особенности](#Особенности)
+- [Требования](#Требования)
+- [Установка](#Установка)
+- [Аутентификация](#Аутентификация)
+- [Структура библиотеки](#Структура-библиотеки)
+- [Примеры использования](#Примеры-использования)
+	- [Предисловие](#Предисловие)
+	- [Общие варианты использования](#Общие-варианты-использования)
+	- [Готовые варианты использования](#Готовые-варианты-использования)
+- [Дополнительная информация](#Дополнительная-информация)
 
 ---
 # Особенности
@@ -106,7 +106,7 @@ GraphQL • Streaming • Proxy • Production-ready transport
 
 ### Через PyPI
 ```bash
-pip install pyplayerokapi
+pip install PyPlayerokAPI
 ```
 
 ### С помощью pip

pyplayerokapi-1.0.2/PyPlayerokAPI/__init__.py

@@ -0,0 +1,15 @@
+# -*- coding=utf-8 -*-
+
+"""
+___init__.py
+PyPLayerokAPI - Playerok API client library for Python
+
+Copyright 2026 kekch127
+"""
+
+from .account import *
+from .models import *
+from .stream import *
+from .types import *
+from .graphql import *
+from .transport import *

pyplayerokapi-1.0.2/PyPlayerokAPI/account/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding=utf-8 -*-
+
+from .bank import BankMixin
+from .chat import ChatMixin
+from .deals import DealsMixin
+from .games import GameMixin
+from .items import ItemsMixin
+from .profile import ProfileMixin
+from .transactions import TransactionsMixin
+
+
+class AccountClient(
+    BankMixin,
+    ChatMixin,
+    DealsMixin,
+    GameMixin,
+    ItemsMixin,
+    TransactionsMixin,
+    ProfileMixin,
+):
+    pass
+
+
+# Обратная совместимость
+Client = AccountClient
+
+__all__ = [
+    "AccountClient",
+    "Client",
+]

pyplayerokapi-1.0.2/PyPlayerokAPI/account/bank.py

@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import annotations
+
+from typing import List
+
+from .profile import ProfileMixin
+from ..graphql import (
+    build_query_payload,
+    build_persisted_query_payload
+)
+from ..models.etc import SBPBankMember
+from ..models.user import UserBankCardList
+from ..types.enums import SortDirections
+
+
+class BankMixin(ProfileMixin):
+    """
+    Миксин действий с картами и банками
+    """
+    
+    def get_sbp_bank_members(self) -> List[SBPBankMember]:
+        """
+        Получает всех членов банка СБП
+
+        Returns:
+            List (SBPBankMember): Список моделей провайдера транзакции
+        """
+        
+        payload = build_persisted_query_payload(
+            operation_name = "SbpBankMembers",
+            hash_key = "SbpBankMembers"
+        )
+        
+        response = self.transport.request(
+            method = "get",
+            payload = payload
+        )
+
+        result = response.json().get("data", {}).get("sbpBankMembers")
+
+        return [SBPBankMember.model_validate(m) for m in result]
+    
+    
+    def get_verified_cards(
+        self, 
+        count: int = 24, 
+        after_cursor: str | None = None,
+        direction: SortDirections = SortDirections.ASC
+    ) -> UserBankCardList:
+        """
+        Получает верифицированные карты аккаунта
+
+        Args:
+            count (int, optional): Кол-во банковских карт, которые нужно получить (не более 24 за один запрос). Defaults to 24.
+            after_cursor (str | None, optional): Курсор, с которого будет идти парсинг (если нет - ищет с самого начала страницы). Defaults to None.
+            direction (SortDirections, optional): Тип сортировки банковских карт. Defaults to SortDirections.ASC.
+
+        Returns:
+            UserBankCardList: Страница банковских карт пользователя
+        """
+        
+        payload = build_persisted_query_payload(
+            operation_name = "verifiedCards",
+            hash_key = "verifiedCards",
+            variables = {
+                "pagination": {
+                    "first": count, 
+                    "after": after_cursor
+                }, 
+                "sort": {
+                    "direction": direction.name
+                }, 
+                "field": "createdAt"
+            }
+        )
+        
+        response = self.transport.request(
+            method = "get",
+            payload = payload
+        )
+
+        result = response.json().get("data", {}).get("verifiedCards")
+
+        return UserBankCardList.model_validate(result)
+    
+    
+    def delete_card(
+        self,
+        card_id: str
+    ) -> bool:
+        """
+        Удаляет карту из сохранённых в аккаунте
+
+        Args:
+            card_id (str): ID банковской карты
+
+        Returns:
+            bool: `True`, если карта удалилась, иначе `False`
+        """
+        
+        payload = build_query_payload(
+            operation_name = "deleteCard",
+            query_key = "deleteCard",
+            variables = {
+                "input": {
+                    "cardId": card_id
+                }
+            }
+        )
+        
+        response = self.transport.request(
+            method = "post",
+            payload = payload
+        )
+
+        result = response.json().get("data", {}).get("deleteCard")
+
+        return result

pyplayerokapi-1.0.2/PyPlayerokAPI/account/base.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import annotations
+
+from typing import Optional
+
+from ..transport import Transport
+
+
+class AccountBase:
+    """
+    Базовый класс аккаунта.
+
+    Отвечает только за:
+    - хранение токена
+    - инициализацию transport
+    - базовые настройки клиента
+
+    Не является Singleton.
+    """
+
+    def __init__(
+        self,
+        token: str,
+        user_agent: str = "",
+        proxy: Optional[str] = None,
+        requests_timeout: int = 15,
+        request_max_retries: int = 5,
+    ) -> None:
+
+        if not token:
+            raise ValueError("Token не может быть пустым")
+
+        self.token = token
+        self.user_agent = user_agent or (
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+            "AppleWebKit/537.36 (KHTML, like Gecko) "
+            "Chrome/144.0.0.0 Safari/537.36"
+        )
+
+        self.transport = Transport(
+            token = self.token,
+            user_agent = self.user_agent,
+            proxy = proxy,
+            requests_timeout = requests_timeout,
+            request_max_retries = request_max_retries,
+        )

pyplayerokapi-1.0.2/PyPlayerokAPI/account/chat.py

@@ -0,0 +1,269 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import annotations
+
+import json
+from typing import Optional
+
+from .profile import ProfileMixin
+from ..graphql import (
+    build_query_payload,
+    build_persisted_query_payload
+)
+
+from ..models.chat import ChatList, Chat, ChatMessageList, ChatMessage
+from ..types.enums import ChatTypes, ChatStatuses
+from ..types.exceptions import MissingAttributeError
+
+
+class ChatMixin(ProfileMixin):
+    """
+    Миксин чатов
+    """
+    
+    def get_chats(
+        self,
+        count: int = 24,
+        type: Optional[ChatTypes] = None,
+        status: Optional[ChatStatuses] = None,
+        after_cursor: Optional[str] = None
+    ) -> ChatList:
+        """
+        Получает все чаты аккаунта
+
+        Args:
+            count (int, optional): Кол-во чатов, которые нужно получить (не более 24 за один запрос). Defaults to 24.
+            type (Optional[ChatTypes], optional): Тип чатов, которые нужно получать (Все, если не указано). Defaults to None.
+            status (Optional[ChatStatuses], optional): Статус чатов, которые нужно получать (Любые, если не указано). Defaults to None.
+            after_cursor (Optional[str], optional): Курсор, с которого будет идти парсинг (если нет - ищет с самого начала страницы). Defaults to None.
+
+        Returns:
+            ChatList: Страница чатов
+        """
+        
+        payload = build_persisted_query_payload(
+            operation_name = "userChats",
+            hash_key = "userChats",
+            variables = {
+                "pagination": {
+                    "first": count,
+                    "after": after_cursor
+                },
+                "filter": {
+                    "userId": self.account_data.id,
+                    "type": type.name if type else None,
+                    "status": status.name if status else None
+                },
+                "hasSupportAccess": False
+            }
+        )
+        
+        response = self.transport.request(
+            method = "get",
+            payload = payload
+        )
+        
+        result = response.json().get("data", {}).get("chats")
+        
+        return ChatList.model_validate(result)
+
+
+    def get_chat(
+        self,
+        chat_id: str
+    ) -> Chat:
+        """
+        Получить чат
+
+        Args:
+            chat_id (str): ID чата
+
+        Returns:
+            Chat: Модель чата
+        """
+        
+        payload = build_persisted_query_payload(
+            operation_name = "chat",
+            hash_key = "chat",
+            variables = {
+                "id": chat_id,
+                "hasSupportAccess": False
+            }
+        )
+
+        response = self.transport.request(
+            method = "get",
+            payload = payload
+        )
+
+        result = response.json().get("data", {}).get("chat")
+
+        return Chat.model_validate(result)
+    
+    
+    def get_chat_by_username(
+        self,
+        username: str
+    ) -> Optional[Chat]:
+        """
+        Получить чат по username собеседнка
+
+        Args:
+            username (str): username собеседнка
+
+        Returns:
+            Optional[Chat]: Модель чата
+        """
+        
+        next_cursor = None
+        while True:
+            chats = self.get_chats(after_cursor = next_cursor)
+            for chat in chats.chats:
+                if any(user for user in chat.users if user.username.lower() == username.lower()): # type: ignore
+                    return chat
+                
+            if not chats.page_info.has_next_page:
+                break
+            
+            next_cursor = chats.page_info.end_cursor
+    
+    
+    def get_chat_messages(
+        self,
+        chat_id: str,
+        count: int = 24,
+        after_cursor: Optional[str] = None
+    ) -> ChatMessageList:
+        """
+        Получает сообщения чата
+
+        Args:
+            chat_id (str): ID чата
+            count (int, optional): Кол-во сообщений, которые нужно получить (не более 24 за один запрос). Defaults to 24.
+            after_cursor (Optional[str], optional): Курсор, с которого будет идти парсинг (если нет - ищет с самого начала страницы). Defaults to None.
+
+        Returns:
+            ChatMessageList: Страница сообщений
+        """
+        
+        payload = build_persisted_query_payload(
+            operation_name = "chatMessages",
+            hash_key = "chatMessages",
+            variables = {
+                "pagination": {
+                    "first": count,
+                    "after": after_cursor
+                },
+                "filter": {
+                    "chatId": chat_id
+                },
+                "hasSupportAccess": False,
+                "showForbiddenImage": True
+            }
+        )
+
+        response = self.transport.request(
+            method = "get",
+            payload = payload
+        )
+
+        result = response.json().get("data", {}).get("chatMessages")
+
+        return ChatMessageList.model_validate(result)
+    
+    
+    def mark_chat_as_read(
+        self,
+        chat_id: str
+    ) -> Chat:
+        """
+        Помечает чат как прочитанный (все сообщения)
+
+        Args:
+            chat_id (str): ID Чата
+
+        Returns:
+            Chat: Модель чата
+        """
+        
+        payload = build_query_payload(
+            operation_name = "markChatAsRead",
+            query_key = "markChatAsRead",
+            variables = {
+                "input": {
+                    "chatId": chat_id
+                }
+            }
+        )
+        
+        response = self.transport.request(
+            method = "post",
+            payload = payload
+        )
+
+        result = response.json().get("data", {}).get("markChatAsRead")
+
+        return Chat.model_validate(result)
+    
+    
+    def send_message(
+        self,
+        chat_id: str,
+        text: Optional[str] = None,
+        photo_file_path: Optional[str] = None,
+        mark_chat_as_read: bool = False
+    ) -> ChatMessage:
+        """
+        Отправляет сообщение в чат.
+        Можно отправить текстовое сообщение `text` или фотографию `photo_file_path`.
+
+        Args:
+            chat_id (str): ID чата
+            text (Optional[str], optional): Текст сообщения. Defaults to None.
+            photo_file_path (Optional[str], optional): Путь к файлу фотографии. Defaults to None.
+            mark_chat_as_read (bool, optional): Пометить чат, как прочитанный перед отправкой. Defaults to False.
+
+        Returns:
+            ChatMessage: Модель отправленного сообщения
+        """
+        
+        if not any([text, photo_file_path]):
+            raise MissingAttributeError("Не был указан обязательный параметр: text/photo_file_path")
+        
+        if mark_chat_as_read:
+            self.mark_chat_as_read(chat_id)
+        
+        pre_payload = build_query_payload(
+            operation_name = "createChatMessage",
+            query_key = "createChatMessage",
+            variables = {
+                "input": {
+                    "chatId": chat_id
+                }
+            }
+        )
+        
+        variables = pre_payload["variables"]
+        
+        if photo_file_path:
+            variables["file"] = None # type: ignore
+        
+        if text:
+            variables["input"]["text"] = text
+        
+        files = {"1": open(photo_file_path, "rb")} if photo_file_path else None
+        map = {"1": ["variables.file"]} if photo_file_path else None
+        
+        payload = pre_payload if not files else {
+            "operations": json.dumps(pre_payload), 
+            "map": json.dumps(map)
+        }
+        
+        response = self.transport.request(
+            method = "post",
+            payload = payload
+        )
+
+        result = response.json().get("data", {}).get("createChatMessage")
+
+        return ChatMessage.model_validate(result)

pyplayerokapi-1.0.2/PyPlayerokAPI/account/deals.py

@@ -0,0 +1,135 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import annotations
+
+from typing import Optional, List
+
+from .profile import ProfileMixin
+from ..graphql import (
+    build_query_payload,
+    build_persisted_query_payload,
+)
+from ..models.item import ItemDealList, ItemDeal
+from ..types.enums import ItemDealStatuses, ItemDealDirections
+
+
+class DealsMixin(ProfileMixin):
+    """
+    Миксин сделок аккаунта.
+    """
+    
+    def get_deals(
+        self,
+        count: int = 24,
+        statuses: Optional[List[ItemDealStatuses]] = None,
+        direction: Optional[ItemDealDirections] = None,
+        after_cursor: Optional[str] = None
+    ) -> ItemDealList:
+        """
+        Получает сделки аккаунта
+
+        Args:
+            count (int, optional): Кол-во сделок, которые нужно получить (не более 24 за один запрос). Defaults to 24.
+            statuses (Optional[List[ItemDealStatuses]], optional): Статусы сделок, которые нужно получать. Defaults to None.
+            direction (Optional[ItemDealDirections], optional): Направление сделок. Defaults to None.
+            after_cursor (str, optional): Курсор, с которого будет идти парсинг (если нет - ищет с самого начала страницы). Defaults to None.
+
+        Returns:
+            ItemDealList: Страница сделок
+        """
+        payload = build_persisted_query_payload(
+            operation_name = "deals",
+            hash_key = "deals",
+            variables = {
+                "pagination": {
+                    "first": count, 
+                    "after": after_cursor
+                },
+                "filter": {
+                    "userId": self.account_data.id,
+                    "direction": direction.name if direction else None,
+                    "status": [status.name for status in statuses] if statuses else None
+                },
+                "showForbiddenImage": True
+            }
+        )
+        
+        response = self.transport.request(
+            method = "get",
+            payload = payload
+        )
+        
+        result = response.json().get("data", {}).get("deals")
+        
+        return ItemDealList.model_validate(result)
+    
+    
+    def get_deal(
+        self,
+        deal_id: str
+    ) -> ItemDeal:
+        """
+        Получает сделку
+
+        Args:
+            deal_id (str): ID сделки
+
+        Returns:
+            ItemDeal: Модель сделки
+        """
+        payload = build_persisted_query_payload(
+            operation_name = "deal",
+            hash_key = "deal",
+            variables = {
+                "id": deal_id,
+                "hasSupportAccess": False,
+                "showForbiddenImage": True
+            }
+        )
+        
+        response = self.transport.request(
+            method = "get",
+            payload = payload
+        )
+        
+        result = response.json().get("data", {}).get("deal")
+        
+        return ItemDeal.model_validate(result)
+    
+    
+    def update_deal(
+        self,
+        deal_id: str,
+        new_status: ItemDealStatuses
+    ) -> ItemDeal:
+        """
+        Обновляет статус сделки
+        (используется, чтобы подтвердить, оформить возврат и т.д)
+
+        Args:
+            deal_id (str): ID сделки
+            new_status (ItemDealStatuses): Новый статус сделки
+
+        Returns:
+            ItemDeal: Модель сделки
+        """
+        payload = build_query_payload(
+            operation_name = "updateDeal",
+            query_key = "updateDeal",
+            variables = {
+                "input": {
+                    "id": deal_id,
+                    "status": new_status.name
+                }
+            }
+        )
+        
+        response = self.transport.request(
+            method = "post",
+            payload = payload
+        )
+        
+        result = response.json().get("data", {}).get("updateDeal")
+        
+        return ItemDeal.model_validate(result)
+