pixelarraythirdparty 1.2.9__tar.gz → 1.3.0__tar.gz

{pixelarraythirdparty-1.2.9 → pixelarraythirdparty-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelarraythirdparty
-Version: 1.2.9
+Version: 1.3.0
 Summary: PixelArray 第三方微服务客户端
 Author-email: Lu qi <qi.lu@pixelarrayai.com>
 License-Expression: MIT

{pixelarraythirdparty-1.2.9 → pixelarraythirdparty-1.3.0}/pixelarraythirdparty/__init__.py

@@ -12,11 +12,13 @@ PixelArray 第三方微服务客户端
 - feedback: 客户反馈模块
 - project: 项目管理模块
 - support_chat: 在线客服（临时会话链接）
+- custom_events: 自定义事件上报（需在 Portal 配置事件定义）
 """
 
 from .support_chat.support_chat import SupportChatManagerAsync
+from .custom_events.custom_events import CustomEventsManagerAsync
 
-__version__ = "1.2.9"
+__version__ = "1.3.0"
 __author__ = "Lu qi"
 __email__ = "qi.lu@pixelarrayai.com"
 
@@ -29,5 +31,7 @@ __all__ = [
     "feedback",
     "project",
     "support_chat",
+    "custom_events",
     "SupportChatManagerAsync",
+    "CustomEventsManagerAsync",
 ]

pixelarraythirdparty-1.3.0/pixelarraythirdparty/custom_events/__init__.py

@@ -0,0 +1,3 @@
+from .custom_events import CustomEventsManagerAsync
+
+__all__ = ["CustomEventsManagerAsync"]

pixelarraythirdparty-1.3.0/pixelarraythirdparty/custom_events/custom_events.py

@@ -0,0 +1,52 @@
+from pixelarraythirdparty.client import AsyncClient
+from typing import Any, Dict, List, Optional, Tuple
+
+
+class CustomEventsManagerAsync(AsyncClient):
+    """自定义事件上报（需先在 Portal 配置事件定义与字段 schema）。"""
+
+    async def report_custom_event(
+        self,
+        project_id: int,
+        event_key: str,
+        payload: Dict[str, Any],
+        client_occurred_at: Optional[str] = None,
+    ) -> Tuple[Dict[str, Any], bool]:
+        """
+        description:
+            上报单条自定义事件日志（JSON 载荷须符合 Portal 中配置的 field_schema）
+        parameters:
+            project_id(int): 项目 ID
+            event_key(str): 事件键
+            payload(dict): JSON 对象，键与类型须与定义一致
+            client_occurred_at(str, optional): 客户端事件发生时间，ISO8601 字符串
+        return:
+            data(dict): 成功时为日志记录；失败时含 message 等
+            success(bool): 是否成功
+        """
+        data: Dict[str, Any] = {
+            "project_id": project_id,
+            "event_key": event_key,
+            "payload": payload,
+        }
+        if client_occurred_at is not None:
+            data["client_occurred_at"] = client_occurred_at
+        return await self._request("POST", "/api/custom-events/report", json=data)
+
+    async def report_custom_events_batch(
+        self,
+        project_id: int,
+        items: List[Dict[str, Any]],
+    ) -> Tuple[Dict[str, Any], bool]:
+        """
+        description:
+            批量上报自定义事件（同一 project_id；任一条校验失败则整批失败）
+        parameters:
+            project_id(int): 项目 ID
+            items(list): 每项为 dict，须含 event_key、payload；可选 client_occurred_at（字符串）
+        return:
+            data(dict): 成功时为日志列表；失败时含 message
+            success(bool): 是否成功
+        """
+        body = {"project_id": project_id, "items": items}
+        return await self._request("POST", "/api/custom-events/report/batch", json=body)

{pixelarraythirdparty-1.2.9 → pixelarraythirdparty-1.3.0}/pixelarraythirdparty.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelarraythirdparty
-Version: 1.2.9
+Version: 1.3.0
 Summary: PixelArray 第三方微服务客户端
 Author-email: Lu qi <qi.lu@pixelarrayai.com>
 License-Expression: MIT

{pixelarraythirdparty-1.2.9 → pixelarraythirdparty-1.3.0}/pixelarraythirdparty.egg-info/SOURCES.txt

@@ -10,6 +10,8 @@ pixelarraythirdparty.egg-info/requires.txt
 pixelarraythirdparty.egg-info/top_level.txt
 pixelarraythirdparty/cron/__init__.py
 pixelarraythirdparty/cron/cron.py
+pixelarraythirdparty/custom_events/__init__.py
+pixelarraythirdparty/custom_events/custom_events.py
 pixelarraythirdparty/feedback/__init__.py
 pixelarraythirdparty/feedback/feedback.py
 pixelarraythirdparty/order/__init__.py

{pixelarraythirdparty-1.2.9 → pixelarraythirdparty-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pixelarraythirdparty"
-version = "1.2.9"
+version = "1.3.0"
 authors = [
     {name = "Lu qi", email = "qi.lu@pixelarrayai.com"},
 ]