pixelarraythirdparty 1.3.7__tar.gz → 1.3.9__tar.gz

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

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

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

@@ -6,13 +6,11 @@ PixelArray 第三方微服务客户端
 这个库包含了常用的开发工具和服务集成：
 - order: 订单管理模块和支付模块
 - product: 产品管理模块
-- cron: 定时任务管理模块
 - user: 用户管理模块
 - unified_login: 统一登录模块
 - feedback: 客户反馈模块
 - project: 项目管理模块
 - support_chat: 在线客服（临时会话链接）
-- custom_events: 自定义事件（新建定义、上报与报表查询）
 - project_dashboard: 项目看板（按 scope 查询 DNU/DAU/留存）
 """
 
@@ -21,27 +19,23 @@ 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.7"
+__version__ = "1.3.9"
 __author__ = "Lu qi"
 __email__ = "qi.lu@pixelarrayai.com"
 
 # 导出主要模块
 __all__ = [
     "product",
-    "cron",
     "user",
     "order",
     "feedback",
     "project",
     "support_chat",
-    "custom_events",
     "project_dashboard",
     "FeedbackManagerAsync",
     "SupportChatManagerAsync",
     "build_staff_portal_session_url",
-    "CustomEventsManagerAsync",
     "ProjectDashboardManagerAsync",
 ]

{pixelarraythirdparty-1.3.7 → pixelarraythirdparty-1.3.9}/pixelarraythirdparty/client.py

@@ -10,7 +10,7 @@ class AsyncClient:
         parameters:
             api_key(str): API密钥，用于身份验证
         """
-        self.base_url = "https://thirdparty.pixelarrayai.com"
+        self.base_url = "https://thirdparty.arraypixelai.com"
         self.api_key = api_key
         self.headers = {
             "Content-Type": "application/json",

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

@@ -1,3 +1,34 @@
+"""
+订单与支付客户端。
+
+商户业务回调（callback_url）
+--------------------------------
+创建订单时传入 ``callback_url``（http/https）后，支付成功或退款成功时，
+本服务会向该地址 **POST** ``Content-Type: application/json``，Body 结构如下。
+
+公共字段（两种事件均包含）::
+
+    event (str): "order.paid" 或 "order.refunded"
+    out_trade_no (str): 商户订单号
+    payment_status (str): "PAID" 或 "REFUNDED"
+    payment_channel (str): "WECHAT" | "ALIPAY"
+    product_id (str|None): 产品 ID
+    amount (float|None): 订单金额（元）
+    total_fee (int|None): 订单金额（分）
+    transaction_id (str|None): 渠道交易号
+    timestamp (str): 回调发送时刻，ISO 8601 UTC
+
+支付成功（event="order.paid"）额外字段::
+
+    paid_at (str|None): 支付时间
+
+退款成功（event="order.refunded"）额外字段::
+
+    refunded_at (str|None): 退款时间
+
+幂等：同一状态重复通知不会重复回调。失败时服务端最多重试 2 次（间隔 1 秒）。
+业务方接口应返回 HTTP 2xx 表示接收成功。
+"""
 from pixelarraythirdparty.client import AsyncClient
 
 
@@ -9,6 +40,7 @@ class OrderManagerAsync(AsyncClient):
         remark: str = None,
         payment_channel: str = "WECHAT",
         amount_yuan: float = None,
+        callback_url: str = None,
     ):
         """
         description:
@@ -19,6 +51,9 @@ class OrderManagerAsync(AsyncClient):
             remark(str): 订单备注
             payment_channel(str): 支付渠道，可选值："WECHAT"（微信支付）、"ALIPAY"（支付宝支付）
             amount_yuan(float, optional): 订单金额（元），可变金额产品必填
+            callback_url(str, optional): 支付/退款结果业务回调地址（http/https）。
+                支付/退款成功后服务端 POST JSON 至该地址，Body 字段见本模块顶部
+                「商户业务回调（callback_url）」说明。
         return:
             data(dict): 订单信息
                 - id(int): 订单ID
@@ -30,6 +65,7 @@ class OrderManagerAsync(AsyncClient):
                 - total_fee(int): 订单金额（分），用于支付接口
                 - body(str): 商品描述
                 - remark(str): 订单备注
+                - callback_url(str, optional): 商户业务回调地址
                 - created_at(str): 订单创建时间
                 - updated_at(str): 订单更新时间
             success(bool): 操作是否成功
@@ -42,6 +78,8 @@ class OrderManagerAsync(AsyncClient):
         }
         if amount_yuan is not None:
             data["amount_yuan"] = amount_yuan
+        if callback_url is not None:
+            data["callback_url"] = callback_url
         data, success = await self._request("POST", "/api/orders/create", json=data)
         if not success:
             return data, False
@@ -54,6 +92,7 @@ class OrderManagerAsync(AsyncClient):
         remark: str = None,
         payment_channel: str = "WECHAT",
         amount_yuan: float = None,
+        callback_url: str = None,
     ):
         """
         description:
@@ -63,8 +102,10 @@ class OrderManagerAsync(AsyncClient):
             product_id(str): 产品ID
             body(str): 商品描述
             remark(str): 订单备注
-            payment_channel(str): 支付渠道，可选值："WECHAT"、"ALIPAY"、"PAYPAL"
+            payment_channel(str): 支付渠道，可选值："WECHAT"、"ALIPAY"
             amount_yuan(float, optional): 订单金额（元），可变金额产品必填
+            callback_url(str, optional): 支付/退款结果业务回调地址（http/https）。
+                回调 POST Body 结构见本模块顶部「商户业务回调（callback_url）」说明。
         return:
             data(dict): 返回数据
                 - order(dict): 订单信息（字段同 create_order 返回）
@@ -79,6 +120,8 @@ class OrderManagerAsync(AsyncClient):
         }
         if amount_yuan is not None:
             data["amount_yuan"] = amount_yuan
+        if callback_url is not None:
+            data["callback_url"] = callback_url
         data, success = await self._request("POST", "/api/orders/create_v2", json=data)
         if not success:
             return data, False

pixelarraythirdparty-1.3.9/pixelarraythirdparty/unified_login/__init__.py

@@ -0,0 +1,11 @@
+from .unified_login import (
+    OAuth2Login,
+    WechatLogin,
+    DouyinLogin,
+)
+
+__all__ = [
+    "OAuth2Login",
+    "WechatLogin",
+    "DouyinLogin",
+]

pixelarraythirdparty-1.3.9/pixelarraythirdparty/unified_login/unified_login.py

@@ -0,0 +1,377 @@
+import asyncio
+import urllib.parse
+import webbrowser
+from typing import Any, Dict, Optional, Tuple
+
+from pixelarraythirdparty.client import AsyncClient
+
+
+def _normalized_project_name(project_name: Optional[str]) -> Optional[str]:
+    if project_name is None:
+        return None
+    s = str(project_name).strip()
+    return s or None
+
+
+def _auth_url_json(project_name: Optional[str]) -> Optional[Dict[str, Any]]:
+    s = _normalized_project_name(project_name)
+    if s is None:
+        return None
+    return {"project_name": s}
+
+
+class OAuth2Login(AsyncClient):
+    """
+    统一的 OAuth2 登录客户端基类
+
+    支持所有基于 OAuth2 的第三方登录（Google、微信、GitHub、GitLab、抖音、TikTok等）
+    通过配置不同的端点来支持不同的提供商
+
+    使用示例:
+    ```
+    # 服务端使用场景（推荐）
+    oauth2_login = OAuth2Login(
+        api_key="your_api_key",
+        provider="google" # 支持的提供商：google, wechat, github, gitlab, douyin
+    )
+    # 1. 获取授权URL
+    auth_data, success = await oauth2_login.get_auth_url()
+    if success:
+        auth_url = auth_data.get("auth_url")
+        state = auth_data.get("state")
+        # 将auth_url返回给前端，让用户点击授权
+        # 2. 等待登录结果（在服务端轮询）
+        user_info, success = await oauth2_login.wait_for_login(state, timeout=180)
+        print(user_info, success)
+    ```
+    """
+
+    # 提供商端点映射
+    PROVIDER_ENDPOINTS = {
+        "wechat": {
+            "auth_url": "/api/unified-login/wechat/auth-url",
+            "wait_login": "/api/unified-login/wechat/wait-login",
+        },
+        "wechat-official": {
+            "auth_url": "/api/unified-login/wechat-official/auth-url",
+            "wait_login": "/api/unified-login/wechat-official/wait-login",
+        },
+        "douyin": {
+            "auth_url": "/api/unified-login/douyin/auth-url",
+            "wait_login": "/api/unified-login/douyin/wait-login",
+        },
+    }
+
+    def __init__(
+        self,
+        api_key: str,
+        provider: str,
+        login_type: Optional[str] = None,
+        project_name: Optional[str] = None,
+    ):
+        """
+        description:
+            初始化OAuth2登录客户端
+        parameters:
+            api_key(str): API密钥
+            provider(str): 提供商名称，可选值：wechat, douyin
+            login_type(str, optional): 登录类型，仅对微信有效，可选值：desktop（PC端扫码）, mobile（手机端）
+            project_name(str, optional): 绑定项目名；不传或空字符串则匿名登录
+        """
+        super().__init__(api_key)
+        self.provider = provider.lower()
+        self.login_type = login_type
+        self._project_name = project_name
+
+        # 验证提供商是否支持
+        if self.provider not in self.PROVIDER_ENDPOINTS:
+            raise ValueError(
+                f"不支持的提供商: {provider}。"
+                f"支持的提供商: {', '.join(self.PROVIDER_ENDPOINTS.keys())}"
+            )
+
+        # 微信特殊处理：根据login_type选择不同的端点
+        if self.provider == "wechat":
+            if login_type == "mobile":
+                self.provider = "wechat-official"
+
+    def _get_endpoint(self, endpoint_type: str) -> str:
+        """
+        description:
+            获取指定类型的端点URL
+        parameters:
+            endpoint_type(str): 端点类型，可选值：auth_url, wait_login, refresh_token
+        return:
+            endpoint(str): 端点URL
+        """
+        endpoints = self.PROVIDER_ENDPOINTS.get(self.provider, {})
+        endpoint = endpoints.get(endpoint_type)
+        if not endpoint:
+            raise ValueError(f"提供商 {self.provider} 不支持 {endpoint_type} 端点")
+        return endpoint
+
+    async def get_auth_url(self) -> Tuple[Optional[Dict[str, str]], bool]:
+        """
+        description:
+            获取OAuth授权URL（公共方法，供服务端调用）
+
+            服务端应该调用此方法获取授权URL，然后将URL返回给前端让用户点击授权。
+            获取到state后，使用wait_for_login方法等待登录结果。
+        return:
+            auth_data(dict, optional): 授权数据字典，包含auth_url和state
+            success(bool): 是否成功
+        """
+        endpoint = self._get_endpoint("auth_url")
+        payload = _auth_url_json(self._project_name)
+        if payload:
+            data, success = await self._request("POST", endpoint, json=payload)
+        else:
+            data, success = await self._request("POST", endpoint)
+        if not success:
+            return data, False
+        auth_url = data.get("auth_url")
+        if not auth_url:
+            return None, False
+        return data, True
+
+    async def wait_for_login(self, state: str, timeout: int = 180) -> Tuple[Dict, bool]:
+        """
+        description:
+            等待登录结果，轮询检查登录状态（公共方法，供服务端调用）
+
+            服务端在用户点击授权后，调用此方法轮询等待登录结果。
+            此方法会持续轮询直到登录成功或超时。
+        parameters:
+            state(str): 登录状态标识，从get_auth_url返回的auth_data中获取
+            timeout(int, optional): 超时时间（秒），默认为180
+        return:
+            user_info(dict): 用户信息字典
+            success(bool): 是否成功
+        """
+        interval = 2
+        total_checks = max(1, timeout // interval) if timeout > 0 else 1
+        endpoint = self._get_endpoint("wait_login")
+
+        for _ in range(total_checks):
+            status, response = await self._request_raw(
+                "POST",
+                endpoint,
+                json={"state": state},
+            )
+
+            if status == 200 and response.get("success") is True:
+                return response.get("data", {}), True
+
+            if status in (400, 408):
+                break
+
+            await asyncio.sleep(interval)
+
+        return {"message": "登录超时或未完成授权"}, False
+
+
+class WechatLogin(AsyncClient):
+    """
+    微信 OAuth2 登录客户端
+
+    支持两种登录方式：
+    - desktop: PC端扫码登录（使用微信开放平台）
+    - mobile: 微信公众号OAuth登录（手机端微信内打开）
+
+    使用示例:
+    ```
+    # 服务端使用场景（推荐）
+    wechat = WechatLogin(api_key="your_api_key")
+    # PC端扫码登录
+    auth_data, success = await wechat.get_auth_url(login_type="desktop")
+    if success:
+        auth_url = auth_data.get("auth_url")
+        state = auth_data.get("state")
+        # 将auth_url返回给前端，让用户扫码授权
+        # 等待登录结果
+        user_info, success = await wechat.wait_for_login(state, timeout=180, login_type="desktop")
+        print(user_info, success)
+
+    # 微信公众号登录（手机端）
+    auth_data, success = await wechat.get_auth_url(login_type="mobile")
+    if success:
+        auth_url = auth_data.get("auth_url")
+        state = auth_data.get("state")
+        # 将auth_url返回给前端，让用户在微信内打开授权
+        # 等待登录结果
+        user_info, success = await wechat.wait_for_login(state, timeout=180, login_type="mobile")
+        print(user_info, success)
+    ```
+    """
+
+    def __init__(self, api_key: str):
+        super().__init__(api_key)
+
+    async def get_auth_url(
+        self, login_type: str = "desktop", project_name: Optional[str] = None
+    ) -> Tuple[Optional[Dict[str, str]], bool]:
+        """
+        description:
+            获取微信授权URL（公共方法，供服务端调用）
+
+            服务端应该调用此方法获取授权URL，然后将URL返回给前端让用户点击授权。
+            获取到state后，使用wait_for_login方法等待登录结果。
+        parameters:
+            login_type(str, optional): 登录类型，desktop表示PC端扫码登录，mobile表示微信公众号登录，默认为desktop
+            project_name(str, optional): 绑定项目名；不传或空字符串则匿名登录
+        return:
+            auth_data(dict, optional): 授权数据字典，包含auth_url和state
+            success(bool): 是否成功
+        """
+        if login_type == "mobile":
+            # 微信公众号OAuth登录（手机端）
+            endpoint = "/api/unified-login/wechat-official/auth-url"
+        else:
+            # PC端扫码登录
+            endpoint = "/api/unified-login/wechat/auth-url"
+
+        payload = _auth_url_json(project_name)
+        if payload:
+            data, success = await self._request("POST", endpoint, json=payload)
+        else:
+            data, success = await self._request("POST", endpoint)
+        if not success:
+            return data, False
+        auth_url = data.get("auth_url")
+        if not auth_url:
+            return None, False
+        return data, True
+
+    async def wait_for_login(
+        self, state: str, timeout: int = 180, login_type: str = "desktop"
+    ) -> Tuple[Dict, bool]:
+        """
+        description:
+            等待微信登录结果，轮询检查登录状态（公共方法，供服务端调用）
+
+            服务端在用户点击授权后，调用此方法轮询等待登录结果。
+            此方法会持续轮询直到登录成功或超时。
+        parameters:
+            state(str): 登录状态标识，从get_auth_url返回的auth_data中获取
+            timeout(int, optional): 超时时间（秒），默认为180
+            login_type(str, optional): 登录类型，desktop表示PC端扫码登录，mobile表示微信公众号登录，默认为desktop
+        return:
+            user_info(dict): 用户信息字典
+            success(bool): 是否成功
+        """
+        interval = 2
+        total_checks = max(1, timeout // interval) if timeout > 0 else 1
+
+        # 根据登录类型选择不同的等待接口
+        if login_type == "mobile":
+            endpoint = "/api/unified-login/wechat-official/wait-login"
+        else:
+            endpoint = "/api/unified-login/wechat/wait-login"
+
+        for _ in range(total_checks):
+            status, response = await self._request_raw(
+                "POST",
+                endpoint,
+                json={"state": state},
+            )
+
+            if status == 200 and response.get("success") is True:
+                return response.get("data", {}), True
+
+            if status in (400, 408):
+                break
+
+            await asyncio.sleep(interval)
+
+        return {"message": "登录超时或未完成授权"}, False
+
+
+class DouyinLogin(AsyncClient):
+    """
+    抖音 OAuth2 登录客户端
+
+    使用示例:
+    ```
+    # 服务端使用场景（推荐）
+    douyin = DouyinLogin(api_key="your_api_key")
+    # 1. 获取授权URL
+    auth_data, success = await douyin.get_auth_url()
+    if success:
+        auth_url = auth_data.get("auth_url")
+        state = auth_data.get("state")
+        # 将auth_url返回给前端，让用户点击授权
+        # 2. 等待登录结果（在服务端轮询）
+        user_info, success = await douyin.wait_for_login(state, timeout=180)
+        print(user_info, success)
+    ```
+    """
+
+    def __init__(self, api_key: str):
+        super().__init__(api_key)
+
+    async def get_auth_url(
+        self, project_name: Optional[str] = None
+    ) -> Tuple[Optional[Dict[str, str]], bool]:
+        """
+        description:
+            获取抖音OAuth授权URL（公共方法，供服务端调用）
+
+            服务端应该调用此方法获取授权URL，然后将URL返回给前端让用户点击授权。
+            获取到state后，使用wait_for_login方法等待登录结果。
+        parameters:
+            project_name(str, optional): 绑定项目名；不传或空字符串则匿名登录
+        return:
+            auth_data(dict, optional): 授权数据字典，包含auth_url和state
+            success(bool): 是否成功
+        """
+        payload = _auth_url_json(project_name)
+        if payload:
+            data, success = await self._request(
+                "POST", "/api/unified-login/douyin/auth-url", json=payload
+            )
+        else:
+            data, success = await self._request(
+                "POST", "/api/unified-login/douyin/auth-url"
+            )
+        if not success:
+            return data, False
+        auth_url = data.get("auth_url")
+        if not auth_url:
+            return None, False
+        return data, True
+
+    async def wait_for_login(self, state: str, timeout: int = 180) -> Tuple[Dict, bool]:
+        """
+        description:
+            等待抖音登录结果，轮询检查登录状态（公共方法，供服务端调用）
+
+            服务端在用户点击授权后，调用此方法轮询等待登录结果。
+            此方法会持续轮询直到登录成功或超时。
+        parameters:
+            state(str): 登录状态标识，从get_auth_url返回的auth_data中获取
+            timeout(int, optional): 超时时间（秒），默认为180
+        return:
+            user_info(dict): 用户信息字典
+            success(bool): 是否成功
+        """
+        interval = 2
+        total_checks = max(1, timeout // interval) if timeout > 0 else 1
+
+        for _ in range(total_checks):
+            status, response = await self._request_raw(
+                "POST",
+                "/api/unified-login/douyin/wait-login",
+                json={"state": state},
+            )
+
+            if status == 200 and response.get("success") is True:
+                return response.get("data", {}), True
+
+            if status in (400, 408):
+                break
+
+            await asyncio.sleep(interval)
+
+        return {"message": "登录超时或未完成授权"}, False
+
+

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

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

{pixelarraythirdparty-1.3.7 → pixelarraythirdparty-1.3.9}/pixelarraythirdparty.egg-info/SOURCES.txt

@@ -8,10 +8,6 @@ pixelarraythirdparty.egg-info/SOURCES.txt
 pixelarraythirdparty.egg-info/dependency_links.txt
 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.3.7 → pixelarraythirdparty-1.3.9}/pyproject.toml

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

pixelarraythirdparty-1.3.7/pixelarraythirdparty/cron/cron.py

@@ -1,80 +0,0 @@
-from pixelarraythirdparty.client import AsyncClient
-
-
-class CronManagerAsync(AsyncClient):
-    async def list_cron_task(self):
-        """
-        description:
-            获取所有配置的定时任务列表，包括任务详情、执行时间、状态等。
-        return:
-            data(dict): 定时任务列表信息
-                - tasks(list): 定时任务列表
-                    - id(str): 任务ID
-                    - name(str): 任务名称
-                    - description(str): 任务描述
-                    - schedule(str): 执行时间
-                    - enabled(bool): 是否启用
-                    - task_name(str): 任务函数名
-                    - module_name(str): 模块名
-                    - function_name(str): 函数名
-                    - file_path(str): 文件路径
-                    - parameters(list): 参数列表
-                    - task_config(dict): 任务配置
-                    - registration_info(dict): 注册信息
-                - count(int): 任务数量
-                - timestamp(str): 获取时间
-            success(bool): 操作是否成功
-        """
-        data, success = await self._request("GET", "/api/cron/tasks/scheduled")
-        if not success:
-            return data, False
-        return data, True
-
-    async def get_cron_tasks_detail(self, task_name: str):
-        """
-        description:
-            根据任务名称获取指定任务的详细信息。
-        parameters:
-            task_name(str): 任务名称
-        return:
-            data(dict): 任务详细信息
-                - task_name(str): 任务名称
-                - module_name(str): 模块名
-                - function_name(str): 函数名
-                - file_path(str): 文件路径
-                - description(str): 任务描述
-                - parameters(list): 参数列表
-                - task_config(dict): 任务配置
-                - registration_info(dict): 注册信息
-                - timestamp(str): 获取时间
-            success(bool): 操作是否成功
-        """
-        data, success = await self._request("GET", f"/api/cron/tasks/{task_name}")
-        if not success:
-            return data, False
-        return data, True
-
-    async def trigger_cron_task(self, task_name: str, args: list, kwargs: dict):
-        """
-        description:
-            手动触发指定任务的执行，支持传递参数。
-        parameters:
-            task_name(str): 任务名称
-            args(list): 任务参数列表
-            kwargs(dict): 任务关键字参数
-        return:
-            data(dict): 任务触发信息
-                - task_id(str): 任务ID
-                - task_name(str): 任务名称
-                - status(str): 任务状态，初始为"PENDING"
-                - message(str): 触发消息
-            success(bool): 操作是否成功
-        """
-        data, success = await self._request(
-            "POST",
-            f"/api/cron/tasks/{task_name}/trigger",
-            json={"args": args, "kwargs": kwargs},
-        )
-        if not success:
-            return data, False
-        return data, True

pixelarraythirdparty-1.3.7/pixelarraythirdparty/custom_events/__init__.py

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