pixelarraythirdparty 1.3.2__tar.gz → 1.3.4__tar.gz

{pixelarraythirdparty-1.3.2 → pixelarraythirdparty-1.3.4}/PKG-INFO

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

{pixelarraythirdparty-1.3.2 → pixelarraythirdparty-1.3.4}/pixelarraythirdparty/__init__.py

@@ -12,7 +12,7 @@ PixelArray 第三方微服务客户端
 - feedback: 客户反馈模块
 - project: 项目管理模块
 - support_chat: 在线客服（临时会话链接）
-- custom_events: 自定义事件（新建定义与上报）
+- custom_events: 自定义事件（新建定义、上报与报表查询）
 - project_dashboard: 项目看板（按 scope 查询 DNU/DAU/留存）
 """
 
@@ -20,7 +20,7 @@ from .support_chat.support_chat import SupportChatManagerAsync
 from .custom_events.custom_events import CustomEventsManagerAsync
 from .project_dashboard.project_dashboard import ProjectDashboardManagerAsync
 
-__version__ = "1.3.2"
+__version__ = "1.3.4"
 __author__ = "Lu qi"
 __email__ = "qi.lu@pixelarrayai.com"
 

{pixelarraythirdparty-1.3.2 → pixelarraythirdparty-1.3.4}/pixelarraythirdparty/custom_events/custom_events.py

@@ -5,6 +5,23 @@ from typing import Any, Dict, List, Optional, Tuple
 class CustomEventsManagerAsync(AsyncClient):
     """自定义事件：新建定义与上报（上报前须存在对应事件定义与字段 schema）。"""
 
+    def _dashboard_params(
+        self,
+        project_name: str,
+        *,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        top_events_limit: Optional[int] = None,
+    ) -> Dict[str, Any]:
+        p: Dict[str, Any] = {"project_name": project_name}
+        if start_date is not None:
+            p["start_date"] = start_date
+        if end_date is not None:
+            p["end_date"] = end_date
+        if top_events_limit is not None:
+            p["top_events_limit"] = top_events_limit
+        return p
+
     async def create_custom_event_definition(
         self,
         project_name: str,
@@ -90,3 +107,82 @@ class CustomEventsManagerAsync(AsyncClient):
         """
         body = {"project_name": project_name, "items": items}
         return await self._request("POST", "/api/custom-events/report/batch", json=body)
+
+    async def get_custom_events_dashboard_summary(
+        self,
+        project_name: str,
+        *,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> Tuple[Dict[str, Any], bool]:
+        """GET /api/custom-events/dashboard/summary：KPI 摘要（需 API Key 或 JWT）。"""
+        params = self._dashboard_params(
+            project_name, start_date=start_date, end_date=end_date
+        )
+        return await self._request(
+            "GET", "/api/custom-events/dashboard/summary", params=params
+        )
+
+    async def get_custom_events_dashboard_daily(
+        self,
+        project_name: str,
+        *,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> Tuple[Dict[str, Any], bool]:
+        """GET /api/custom-events/dashboard/daily：按日事件量（UTC）。"""
+        params = self._dashboard_params(
+            project_name, start_date=start_date, end_date=end_date
+        )
+        return await self._request(
+            "GET", "/api/custom-events/dashboard/daily", params=params
+        )
+
+    async def get_custom_events_dashboard_top_events(
+        self,
+        project_name: str,
+        *,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        top_events_limit: Optional[int] = None,
+    ) -> Tuple[Dict[str, Any], bool]:
+        """GET /api/custom-events/dashboard/top-events：事件量 TOP N。"""
+        params = self._dashboard_params(
+            project_name,
+            start_date=start_date,
+            end_date=end_date,
+            top_events_limit=top_events_limit,
+        )
+        return await self._request(
+            "GET", "/api/custom-events/dashboard/top-events", params=params
+        )
+
+    async def get_custom_events_dashboard_by_category(
+        self,
+        project_name: str,
+        *,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> Tuple[Dict[str, Any], bool]:
+        """GET /api/custom-events/dashboard/by-category：按分类分布。"""
+        params = self._dashboard_params(
+            project_name, start_date=start_date, end_date=end_date
+        )
+        return await self._request(
+            "GET", "/api/custom-events/dashboard/by-category", params=params
+        )
+
+    async def get_custom_events_dashboard_by_hour(
+        self,
+        project_name: str,
+        *,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> Tuple[Dict[str, Any], bool]:
+        """GET /api/custom-events/dashboard/by-hour：按 UTC 小时分布。"""
+        params = self._dashboard_params(
+            project_name, start_date=start_date, end_date=end_date
+        )
+        return await self._request(
+            "GET", "/api/custom-events/dashboard/by-hour", params=params
+        )

{pixelarraythirdparty-1.3.2 → pixelarraythirdparty-1.3.4}/pixelarraythirdparty/project/project.py

@@ -61,6 +61,25 @@ class ProjectManagerAsync(AsyncClient):
             return data, False
         return data, True
 
+    async def rename_project(self, project_id: int, name: str):
+        """
+        description:
+            重命名项目；同步更新 external_users 中与旧项目名一致的 project_name。
+        parameters:
+            project_id(int): 项目ID
+            name(str): 新项目名称
+        return:
+            data(dict): 更新后的项目信息（含 id、name、bound_domains、created_at）
+            success(bool): 操作是否成功
+        """
+        data = {"name": name}
+        data, success = await self._request(
+            "PATCH", f"/api/projects/{project_id}/name", json=data
+        )
+        if not success:
+            return data, False
+        return data, True
+
     async def delete_project(self, project_id: int):
         """
         description:

{pixelarraythirdparty-1.3.2 → pixelarraythirdparty-1.3.4}/pixelarraythirdparty/project_dashboard/project_dashboard.py

@@ -24,6 +24,7 @@ class ProjectDashboardManagerAsync(AsyncClient):
         scope: str,
         start_date: Optional[str] = None,
         end_date: Optional[str] = None,
+        retention_days: Optional[str] = None,
     ) -> Tuple[Dict[str, Any], bool]:
         """
         description:
@@ -33,6 +34,7 @@ class ProjectDashboardManagerAsync(AsyncClient):
             scope(str): DNU | DAU | RETENTION | 留存
             start_date(str, optional): 开始日期 YYYY-MM-DD；不传则服务端默认 T-7
             end_date(str, optional): 结束日期 YYYY-MM-DD；不传则服务端默认 T-0
+            retention_days(str, optional): 仅 scope 为留存时有效；逗号分隔天数，如 2,7,14,20；不传则服务端默认
         return:
             data(dict): 成功时为 DauData / DnuData / RetentionData 结构（见接口文档）
             success(bool): 是否成功
@@ -48,4 +50,6 @@ class ProjectDashboardManagerAsync(AsyncClient):
             params["start_date"] = start_date
         if end_date:
             params["end_date"] = end_date
+        if retention_days:
+            params["retention_days"] = retention_days
         return await self._request("GET", path, params=params)

{pixelarraythirdparty-1.3.2 → pixelarraythirdparty-1.3.4}/pixelarraythirdparty.egg-info/PKG-INFO

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

{pixelarraythirdparty-1.3.2 → pixelarraythirdparty-1.3.4}/pyproject.toml

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