pixelarraythirdparty 1.3.5__tar.gz → 1.3.7__tar.gz

{pixelarraythirdparty-1.3.5 → pixelarraythirdparty-1.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelarraythirdparty
-Version: 1.3.5
+Version: 1.3.7
 Summary: PixelArray 第三方微服务客户端
 Author-email: Lu qi <qi.lu@pixelarrayai.com>
 License-Expression: MIT
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Requires-Python: >=3.8

{pixelarraythirdparty-1.3.5 → pixelarraythirdparty-1.3.7}/pixelarraythirdparty/__init__.py

@@ -16,11 +16,15 @@ PixelArray 第三方微服务客户端
 - project_dashboard: 项目看板（按 scope 查询 DNU/DAU/留存）
 """
 
-from .support_chat.support_chat import SupportChatManagerAsync
+from .feedback.feedback import FeedbackManagerAsync
+from .support_chat.support_chat import (
+    SupportChatManagerAsync,
+    build_staff_portal_session_url,
+)
 from .custom_events.custom_events import CustomEventsManagerAsync
 from .project_dashboard.project_dashboard import ProjectDashboardManagerAsync
 
-__version__ = "1.3.5"
+__version__ = "1.3.7"
 __author__ = "Lu qi"
 __email__ = "qi.lu@pixelarrayai.com"
 
@@ -35,7 +39,9 @@ __all__ = [
     "support_chat",
     "custom_events",
     "project_dashboard",
+    "FeedbackManagerAsync",
     "SupportChatManagerAsync",
+    "build_staff_portal_session_url",
     "CustomEventsManagerAsync",
     "ProjectDashboardManagerAsync",
 ]

{pixelarraythirdparty-1.3.5 → pixelarraythirdparty-1.3.7}/pixelarraythirdparty/order/order.py

@@ -8,6 +8,7 @@ class OrderManagerAsync(AsyncClient):
         body: str = None,
         remark: str = None,
         payment_channel: str = "WECHAT",
+        amount_yuan: float = None,
     ):
         """
         description:
@@ -17,6 +18,7 @@ class OrderManagerAsync(AsyncClient):
             body(str): 商品描述
             remark(str): 订单备注
             payment_channel(str): 支付渠道，可选值："WECHAT"（微信支付）、"ALIPAY"（支付宝支付）
+            amount_yuan(float, optional): 订单金额（元），可变金额产品必填
         return:
             data(dict): 订单信息
                 - id(int): 订单ID
@@ -38,6 +40,8 @@ class OrderManagerAsync(AsyncClient):
             "remark": remark,
             "payment_channel": payment_channel,
         }
+        if amount_yuan is not None:
+            data["amount_yuan"] = amount_yuan
         data, success = await self._request("POST", "/api/orders/create", json=data)
         if not success:
             return data, False
@@ -49,6 +53,7 @@ class OrderManagerAsync(AsyncClient):
         body: str = None,
         remark: str = None,
         payment_channel: str = "WECHAT",
+        amount_yuan: float = None,
     ):
         """
         description:
@@ -59,6 +64,7 @@ class OrderManagerAsync(AsyncClient):
             body(str): 商品描述
             remark(str): 订单备注
             payment_channel(str): 支付渠道，可选值："WECHAT"、"ALIPAY"、"PAYPAL"
+            amount_yuan(float, optional): 订单金额（元），可变金额产品必填
         return:
             data(dict): 返回数据
                 - order(dict): 订单信息（字段同 create_order 返回）
@@ -71,6 +77,8 @@ class OrderManagerAsync(AsyncClient):
             "remark": remark,
             "payment_channel": payment_channel,
         }
+        if amount_yuan is not None:
+            data["amount_yuan"] = amount_yuan
         data, success = await self._request("POST", "/api/orders/create_v2", json=data)
         if not success:
             return data, False

{pixelarraythirdparty-1.3.5 → pixelarraythirdparty-1.3.7}/pixelarraythirdparty/project/project.py

@@ -69,7 +69,7 @@ class ProjectManagerAsync(AsyncClient):
             project_id(int): 项目ID
             name(str): 新项目名称
         return:
-            data(dict): 更新后的项目信息（含 id、name、bound_domains、created_at）
+            data(dict): 更新后的项目信息（含 id、name、created_at）
             success(bool): 操作是否成功
         """
         data = {"name": name}

pixelarraythirdparty-1.3.7/pixelarraythirdparty/support_chat/support_chat.py

@@ -0,0 +1,157 @@
+from typing import List, Optional
+
+from pixelarraythirdparty.client import AsyncClient
+
+
+def build_staff_portal_session_url(portal_base_url: str, session_id: int) -> str:
+    """
+    拼接带会话 ID 的 Portal 客服管理页 URL，便于运营在浏览器中打开指定会话。
+    portal_base_url 为 Portal 站点根地址（与工单 ticket_url 所用域名一致，不含末尾斜杠亦可）。
+    """
+    base = (portal_base_url or "").strip().rstrip("/")
+    return f"{base}/support-chat-management?session_id={session_id}"
+
+
+class SupportChatManagerAsync(AsyncClient):
+    async def create_support_chat_link(
+        self,
+        expires_in_hours: int = 24,
+    ):
+        """
+        description:
+            创建在线客服临时会话链接。其它服务调用此接口后，将返回的 chat_url 下发给用户，
+            用户打开链接即可与客服对话（无需登录）。链接有时效。
+        parameters:
+            expires_in_hours(int, optional): 链接有效小时数，默认 24，范围 1～720
+        return:
+            data(dict): 成功时包含
+                - chat_url(str): 客服聊天页完整 URL
+                - token(str): 会话 token
+                - session_id(int): 会话 ID
+                - expires_at(str): 过期时间
+            success(bool): 操作是否成功
+        """
+        payload = {"expires_in_hours": expires_in_hours}
+        data, success = await self._request(
+            "POST", "/api/support-chat/create-link", json=payload
+        )
+        if not success:
+            return data, False
+        return data, True
+
+    async def list_support_chat_sessions(
+        self,
+        page: int = 1,
+        page_size: int = 20,
+    ):
+        """
+        客服端：分页查询会话列表（需 API Key）。返回每条含 unread_from_customer 等字段。
+        """
+        params = {"page": page, "page_size": page_size}
+        data, success = await self._request(
+            "GET", "/api/support-chat/sessions", params=params
+        )
+        if not success:
+            return data, False
+        return data, True
+
+    async def get_support_chat_messages(
+        self,
+        session_id: int,
+        since_id: Optional[int] = None,
+    ):
+        """
+        客服端：拉取指定会话消息（轮询；需 API Key）。媒体消息含 media_url。
+        """
+        params: dict = {"session_id": session_id}
+        if since_id is not None:
+            params["since_id"] = since_id
+        data, success = await self._request(
+            "GET", "/api/support-chat/messages", params=params
+        )
+        if not success:
+            return data, False
+        return data, True
+
+    async def send_support_message(
+        self,
+        session_id: int,
+        content: str = "",
+        content_type: str = "text",
+        oss_path: Optional[str] = None,
+        mime_type: Optional[str] = None,
+    ):
+        """
+        客服端：发送回复（文本或图片/视频，与 Portal 约定一致；需 API Key）。
+        """
+        payload = {
+            "session_id": session_id,
+            "content": content,
+            "content_type": content_type,
+        }
+        if oss_path is not None:
+            payload["oss_path"] = oss_path
+        if mime_type is not None:
+            payload["mime_type"] = mime_type
+        data, success = await self._request(
+            "POST", "/api/support-chat/send-message", json=payload
+        )
+        if not success:
+            return data, False
+        return data, True
+
+    async def mark_support_session_read(self, session_id: int):
+        """客服端：将用户发来且未读的消息标记为已读。"""
+        payload = {"session_id": session_id}
+        data, success = await self._request(
+            "POST", "/api/support-chat/mark-read", json=payload
+        )
+        if not success:
+            return data, False
+        return data, True
+
+    async def get_support_upload_presigned_url(
+        self,
+        session_id: int,
+        file_name: str,
+        file_type: str,
+        file_size: Optional[int] = None,
+        mime_type: Optional[str] = None,
+    ):
+        """客服端：获取 OSS 直传预签名（image | video）。"""
+        payload = {
+            "session_id": session_id,
+            "file_name": file_name,
+            "file_type": file_type,
+        }
+        if file_size is not None:
+            payload["file_size"] = file_size
+        if mime_type is not None:
+            payload["mime_type"] = mime_type
+        data, success = await self._request(
+            "POST", "/api/support-chat/upload/presigned-url", json=payload
+        )
+        if not success:
+            return data, False
+        return data, True
+
+    async def delete_support_chat_session(self, session_id: int):
+        """客服端：删除单个会话及消息与对应临时 token。"""
+        data, success = await self._request(
+            "DELETE", f"/api/support-chat/sessions/{session_id}"
+        )
+        if not success:
+            return data, False
+        return data, True
+
+    async def batch_delete_support_chat_sessions(self, session_ids: List[int]):
+        """客服端：批量删除会话。"""
+        if not session_ids:
+            return {"message": "请提供要删除的会话 ID 列表"}, False
+        payload = {"session_ids": session_ids}
+        data, success = await self._request(
+            "POST", "/api/support-chat/sessions/batch-delete", json=payload
+        )
+        if not success:
+            return data, False
+        return data, True

{pixelarraythirdparty-1.3.5 → pixelarraythirdparty-1.3.7}/pixelarraythirdparty.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelarraythirdparty
-Version: 1.3.5
+Version: 1.3.7
 Summary: PixelArray 第三方微服务客户端
 Author-email: Lu qi <qi.lu@pixelarrayai.com>
 License-Expression: MIT
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Requires-Python: >=3.8

{pixelarraythirdparty-1.3.5 → pixelarraythirdparty-1.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pixelarraythirdparty"
-version = "1.3.5"
+version = "1.3.7"
 authors = [
     {name = "Lu qi", email = "qi.lu@pixelarrayai.com"},
 ]
@@ -23,6 +23,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Utilities",
 ]

pixelarraythirdparty-1.3.5/pixelarraythirdparty/support_chat/support_chat.py

@@ -1,29 +0,0 @@
-from pixelarraythirdparty.client import AsyncClient
-
-
-class SupportChatManagerAsync(AsyncClient):
-    async def create_support_chat_link(
-        self,
-        expires_in_hours: int = 24,
-    ):
-        """
-        description:
-            创建在线客服临时会话链接。其它服务调用此接口后，将返回的 chat_url 下发给用户，
-            用户打开链接即可与客服对话（无需登录）。链接有时效。
-        parameters:
-            expires_in_hours(int, optional): 链接有效小时数，默认 24，范围 1～720
-        return:
-            data(dict): 成功时包含
-                - chat_url(str): 客服聊天页完整 URL
-                - token(str): 会话 token
-                - session_id(int): 会话 ID
-                - expires_at(str): 过期时间
-            success(bool): 操作是否成功
-        """
-        payload = {"expires_in_hours": expires_in_hours}
-        data, success = await self._request(
-            "POST", "/api/support-chat/create-link", json=payload
-        )
-        if not success:
-            return data, False
-        return data, True