@huyooo/ui 0.13.1 → 0.13.4

package/dist/types/api/billing.generated.d.ts

@@ -87,6 +87,18 @@ export type Api = {
                 return: any;
             };
         };
+        updateSort: {
+            /** 批量更新产品排序 */
+            post: {
+                body: {
+                    items: {
+                        id: string;
+                        displayOrder: number;
+                    }[];
+                };
+                return: any;
+            };
+        };
         listActive: {
             /** 获取定价页面可用产品列表（公开） */
             post: {
@@ -241,6 +253,15 @@ export type Api = {
                 return: any;
             };
         };
+        userDetail: {
+            /** 管理员查询指定用户的订阅、免费体验、配额、积分和最近消费记录 */
+            post: {
+                body: {
+                    userId: string;
+                };
+                return: any;
+            };
+        };
         find: {
             /** 分页查询订阅列表（管理端） */
             post: {
@@ -251,11 +272,32 @@ export type Api = {
                         userId?: string;
                         productId?: string;
                         status?: string;
+                        cancelAtPeriodEnd?: boolean;
                     };
                 };
                 return: any;
             };
         };
+        history: {
+            /** 查询单个订阅的权益变化历史（管理端） */
+            post: {
+                body: {
+                    subscriptionId: string;
+                };
+                return: any;
+            };
+        };
+        trend: {
+            /** 获取订阅各状态的历史趋势数据 */
+            post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                    granularity: "day" | "week" | "month";
+                };
+                return: any;
+            };
+        };
         count: {
             /** 供其他服务查询用户订阅数量 */
             post: {
@@ -276,6 +318,15 @@ export type Api = {
                 return: any;
             };
         };
+        notify: {
+            alipay: {
+                /** 支付宝订阅支付回调通知 */
+                post: {
+                    body: Record<string, unknown>;
+                    return: any;
+                };
+            };
+        };
     };
     quotas: {
         create: {
@@ -332,11 +383,14 @@ export type Api = {
             };
         };
         check: {
-            /** 检查用户配额是否足够 */
+            /** 供其他服务检查配额是否足够，不写入使用量 */
             post: {
                 body: {
+                    appId: string;
+                    userId: string;
                     featureKey: string;
-                    amount?: number;
+                    quantity?: number;
+                    used?: number;
                 };
                 return: any;
             };
@@ -347,13 +401,12 @@ export type Api = {
                 return: any;
             };
         };
-    };
-    usageRecords: {
-        record: {
-            /** 记录用户功能使用量 */
+        reserve: {
+            /** 供其他服务检查并预占配额 */
             post: {
                 body: {
-                    userId?: string;
+                    appId: string;
+                    userId: string;
                     featureKey: string;
                     quantity?: number;
                     metadata?: Record<string, unknown>;
@@ -361,40 +414,109 @@ export type Api = {
                 return: any;
             };
         };
-        recordWithQuotaCheck: {
-            /** 记录使用量并检查配额 */
+        commit: {
+            /** 供其他服务确认已预占配额 */
+            post: {
+                body: {
+                    usageRecordId: string;
+                };
+                return: any;
+            };
+        };
+        release: {
+            /** 供其他服务释放已预占配额 */
+            post: {
+                body: {
+                    usageRecordId: string;
+                };
+                return: any;
+            };
+        };
+    };
+    trials: {
+        current: {
+            /** 获取当前用户免费体验状态 */
+            post: {
+                return: any;
+            };
+        };
+        start: {
+            /** 领取当前应用的免费体验权益 */
+            post: {
+                body: {
+                    priceId?: string;
+                };
+                return: any;
+            };
+        };
+    };
+    newUserDefaults: {
+        find: {
+            /** 查询注册后默认授予的免费权益配置 */
+            post: {
+                return: any;
+            };
+        };
+        update: {
+            /** 更新注册后默认授予的免费权益配置 */
+            post: {
+                body: {
+                    autoGrantFreePriceOnSignup: boolean;
+                    defaultFreePriceId?: string;
+                };
+                return: any;
+            };
+        };
+        grantMissingFreeEntitlements: {
+            /** 给当前应用下没有活跃订阅/体验的用户补发默认免费价格方案 */
+            post: {
+                body: {
+                    dryRun?: boolean;
+                    userIds?: string[];
+                };
+                return: any;
+            };
+        };
+    };
+    usageRecords: {
+        checkQuota: {
+            /** 检查配额是否足够，不写入使用量 */
             post: {
                 body: {
                     userId?: string;
                     featureKey: string;
                     quantity?: number;
-                    metadata?: Record<string, unknown>;
+                    used?: number;
                 };
                 return: any;
             };
         };
-        checkQuota: {
-            /** 预检查配额是否足够（不记录使用量） */
+        reserveQuota: {
+            /** 检查配额并写入 reserved 使用量记录 */
             post: {
                 body: {
                     userId?: string;
                     featureKey: string;
                     quantity?: number;
+                    metadata?: Record<string, unknown>;
                 };
                 return: any;
             };
         };
-        batchRecord: {
-            /** 批量记录使用量 */
+        commitQuota: {
+            /** 将 reserved 使用量记录确认成 committed */
             post: {
                 body: {
-                    records: {
-                        userId: string;
-                        featureKey: string;
-                        quantity?: number;
-                        metadata?: Record<string, unknown>;
-                        timestamp?: string;
-                    }[];
+                    usageRecordId: string;
+                };
+                return: any;
+            };
+        };
+        releaseQuota: {
+            /** 将 reserved 使用量记录释放成 released */
+            post: {
+                body: {
+                    usageRecordId: string;
                 };
                 return: any;
             };
@@ -408,6 +530,7 @@ export type Api = {
                     where: {
                         userId?: string;
                         featureKey?: string;
+                        status?: string;
                         startTime?: string;
                         endTime?: string;
                     };
@@ -422,6 +545,7 @@ export type Api = {
                     current?: number;
                     pageSize?: number;
                     featureKey?: string;
+                    status?: string;
                     startTime?: string;
                     endTime?: string;
                 };
@@ -441,22 +565,10 @@ export type Api = {
                 return: any;
             };
         };
-        getTrendChart: {
-            /** 获取使用量趋势图表数据 */
-            post: {
-                body: {
-                    featureKey?: string;
-                    startTime: string;
-                    endTime: string;
-                    granularity: "hour" | "day" | "week" | "month";
-                };
-                return: any;
-            };
-        };
     };
     invoices: {
         find: {
-            /** 分页查询发票列表（管理端） */
+            /** 分页查询订阅账单列表（管理端） */
             post: {
                 body: {
                     current: number;
@@ -473,7 +585,7 @@ export type Api = {
             };
         };
         findOne: {
-            /** 根据 ID 查询发票详情 */
+            /** 根据 ID 查询订阅账单详情 */
             post: {
                 body: {
                     id: string;
@@ -482,7 +594,7 @@ export type Api = {
             };
         };
         my: {
-            /** 查询当前用户的发票列表 */
+            /** 查询当前用户的订阅账单列表 */
             post: {
                 body: {
                     current?: number;
@@ -492,8 +604,18 @@ export type Api = {
                 return: any;
             };
         };
+        cancel: {
+            /** 取消当前用户自己的待支付订阅账单 */
+            post: {
+                body: {
+                    id: string;
+                    reason?: string;
+                };
+                return: any;
+            };
+        };
         pay: {
-            /** 支付我的账单 */
+            /** 为当前用户的待支付账单生成支付链接 */
             post: {
                 body: {
                     id: string;
@@ -501,8 +623,17 @@ export type Api = {
                 return: any;
             };
         };
+        verifyPayment: {
+            /** 查询支付宝订单状态，如果已支付则完成订阅入账 */
+            post: {
+                body: {
+                    orderId: string;
+                };
+                return: any;
+            };
+        };
         void: {
-            /** 作废发票 */
+            /** 管理端作废待支付订阅账单 */
             post: {
                 body: {
                     id: string;
@@ -512,7 +643,7 @@ export type Api = {
             };
         };
         statistics: {
-            /** 获取发票统计数据 */
+            /** 获取订阅账单统计数据 */
             post: {
                 body: {
                     startTime?: string;
@@ -532,6 +663,22 @@ export type Api = {
                 return: any;
             };
         };
+        revenueByProduct: {
+            /** 获取按产品分布的收入数据 */
+            post: {
+                body: {
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        statusOptions: {
+            /** 获取订阅账单状态下拉选项与展示文案 */
+            post: {
+                return: any;
+            };
+        };
         stats: {
             /** 供其他服务查询发票统计数据 */
             post: {
@@ -582,6 +729,19 @@ export type Api = {
                 return: any;
             };
         };
+        consume: {
+            /** 按调用方计算好的积分数消费积分 */
+            post: {
+                body: {
+                    userId: string;
+                    amount: number;
+                    requestId?: string;
+                    description?: string;
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
         consumeByPrice: {
             /** 根据计价配置消费积分 */
             post: {
@@ -1155,913 +1315,2362 @@ export type Api = {
             };
         };
     };
-    webhooks: {
-        events: {
-            /** 获取所有可用的 Webhook 事件类型 */
-            get: {
-                return: any;
-            };
-            ':id': {
-                /** 获取指定分类的 Webhook 事件 */
-                get: {
-                    params: {
-                        category: string;
-                    };
-                    return: any;
+    consumption: {
+        trend: {
+            /** 聚合服务消费的趋势数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    limit?: number;
                 };
+                return: any;
             };
         };
-        categories: {
-            /** 获取所有 Webhook 事件分类 */
-            get: {
+        overview: {
+            /** 聚合服务消费的概览数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                };
                 return: any;
             };
         };
     };
-    notify: {
-        alipay: {
-            /** 支付宝订阅支付回调通知 */
+    pointsRecharge: {
+        packages: {
+            /** 获取可用的充值套餐列表 */
             post: {
-                body: Record<string, unknown>;
                 return: any;
             };
         };
-    };
-};
-/** API 客户端类型（提供完整的 IDE 智能提示） */
-export interface ApiClient {
-    health: {
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-    };
-    'api-spec': {
-        /** 获取 API 规范，用于类型同步 */
-        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-    };
-    products: {
-        create: {
-            /** 创建新产品 */
-            post: (body: {
-                name: string;
-                description?: string;
-                features: {
-                    key: string;
-                    name: string;
-                    description?: string;
-                    type: "boolean";
-                    value?: boolean;
-                    highlight?: boolean;
-                }[];
-                metadata?: Record<string, unknown>;
-                displayOrder?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        createOrder: {
+            /** 创建积分充值订单 */
+            post: {
+                body: {
+                    packageId: string;
+                    payType: "alipay" | "weixinpay";
+                };
+                return: any;
+            };
         };
-        delete: {
-            /** 删除产品 */
-            post: (body: {
-                id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        createQRCodeOrder: {
+            /** 创建支付宝扫码支付订单（当面付） */
+            post: {
+                body: {
+                    packageId: string;
+                };
+                return: any;
+            };
         };
-        update: {
-            /** 更新产品信息 */
-            post: (body: {
-                id: string;
-                name?: string;
-                description?: string;
-                features?: {
-                    key: string;
-                    name: string;
-                    description?: string;
-                    type: "boolean";
-                    value?: boolean;
-                    highlight?: boolean;
-                }[];
-                status?: "active" | "archived";
-                metadata?: Record<string, unknown>;
-                displayOrder?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        orders: {
+            /** 查询用户的充值订单记录 */
+            post: {
+                body: {
+                    status?: string;
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
         };
         find: {
-            /** 分页查询产品列表 */
-            post: (body: {
-                current: number;
-                pageSize: number;
-                where: {
-                    name?: string;
+            /** 管理端分页查询全部积分充值订单 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        userId?: string;
+                        status?: string;
+                        startTime?: string;
+                        endTime?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        detail: {
+            /** 管理端查询单个积分充值订单详情及操作时间线 */
+            post: {
+                body: {
+                    orderId: string;
+                };
+                return: any;
+            };
+        };
+        adminStatistics: {
+            /** 管理端积分充值订单统计 */
+            post: {
+                body: {
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        statistics: {
+            /** 获取用户积分充值订单统计 */
+            post: {
+                body: {
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        statusOptions: {
+            /** 获取积分充值订单状态下拉选项与展示文案 */
+            post: {
+                return: any;
+            };
+        };
+        verifyPayment: {
+            /** 查询支付宝订单状态，如果已支付则完成充值 */
+            post: {
+                body: {
+                    orderId: string;
+                };
+                return: any;
+            };
+        };
+        notify: {
+            alipay: {
+                /** 支付宝积分充值回调通知 */
+                post: {
+                    body: Record<string, unknown>;
+                    return: any;
+                };
+            };
+        };
+    };
+    rechargePackage: {
+        list: {
+            /** 获取充值套餐列表（管理端） */
+            post: {
+                body: {
+                    includeDisabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        create: {
+            /** 创建新的充值套餐 */
+            post: {
+                body: {
+                    name: string;
+                    price: number;
+                    points: number;
+                    bonus: number;
+                    description?: string;
+                    sort?: number;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新充值套餐信息 */
+            post: {
+                body: {
+                    id: string;
+                    name?: string;
+                    price?: number;
+                    points?: number;
+                    bonus?: number;
+                    description?: string;
+                    sort?: number;
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除充值套餐 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        updateSort: {
+            /** 批量更新套餐排序 */
+            post: {
+                body: {
+                    items: {
+                        id: string;
+                        sort: number;
+                    }[];
+                };
+                return: any;
+            };
+        };
+    };
+    refund: {
+        apply: {
+            /** 对已支付订单申请退款 */
+            post: {
+                body: {
+                    orderId: string;
+                    reason?: string;
+                    refundAmount?: number;
+                };
+                return: any;
+            };
+        };
+        applySubscription: {
+            /** 对已支付订阅账单申请退款 */
+            post: {
+                body: {
+                    invoiceId: string;
+                    reason?: string;
+                    refundAmount?: number;
+                    subscriptionAction?: "cancel_immediate" | "none";
+                };
+                return: any;
+            };
+        };
+        approve: {
+            /** 审批退款申请（通过或拒绝） */
+            post: {
+                body: {
+                    refundNo: string;
+                    action: "approve" | "reject";
+                    remark?: string;
+                };
+                return: any;
+            };
+        };
+        execute: {
+            /** 执行已审批的退款（调用支付宝/微信退款接口） */
+            post: {
+                body: {
+                    refundNo: string;
+                };
+                return: any;
+            };
+        };
+        manual: {
+            /** 管理员手动标记退款完成（用于线上接口故障或特殊情况） */
+            post: {
+                body: {
+                    refundNo: string;
+                    manualRefundNo?: string;
+                    remark: string;
+                };
+                return: any;
+            };
+        };
+        list: {
+            /** 查询退款记录列表 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                    status?: string;
+                    sourceType?: "points_recharge" | "subscription_invoice";
+                    userId?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        detail: {
+            /** 查询单个退款单详情 */
+            post: {
+                body: {
+                    refundNo: string;
+                };
+                return: any;
+            };
+        };
+        stats: {
+            /** 获取退款统计数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        syncStatus: {
+            /** 手动同步单个退款单的支付宝退款状态 */
+            post: {
+                body: {
+                    refundNo: string;
+                };
+                return: any;
+            };
+        };
+        statusOptions: {
+            /** 获取退款单状态下拉选项与展示文案 */
+            post: {
+                return: any;
+            };
+        };
+    };
+    serviceDefinition: {
+        list: {
+            /** 获取应用的所有服务定义 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        create: {
+            /** 创建新的服务定义 */
+            post: {
+                body: {
+                    serviceType: string;
+                    name: string;
+                    description?: string;
+                    billingUnit: string;
+                    billingMode?: "event" | "continuous";
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新服务定义 */
+            post: {
+                body: {
+                    id: string;
+                    name?: string;
+                    description?: string;
+                    billingUnit?: string;
+                    billingMode?: "event" | "continuous";
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除服务定义 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
+    pricingRule: {
+        get: {
+            /** 获取服务的定价规则 */
+            post: {
+                body: {
+                    serviceType: string;
+                };
+                return: any;
+            };
+        };
+        save: {
+            /** 创建或更新定价规则 */
+            post: {
+                body: {
+                    serviceType: string;
+                    tiers?: {
+                        minUsage: number;
+                        maxUsage: number | null;
+                        pricePerUnit: number;
+                    }[];
+                    flatPrice?: number | null;
+                    freeQuota?: number;
+                    profitMargin?: number;
+                    enabled?: boolean;
+                };
+                return: any;
+            };
+        };
+    };
+    usage: {
+        report: {
+            /** 上报服务用量，自动计费扣费 */
+            post: {
+                body: {
+                    serviceType: string;
+                    metadata: Record<string, unknown>;
+                    requestId?: string;
+                };
+                return: any;
+            };
+        };
+        preview: {
+            /** 按当前定价规则预估本次用量费用，不写入记录、不扣积分 */
+            post: {
+                body: {
+                    serviceType: string;
+                    metadata: Record<string, unknown>;
+                    freeQuotaOverride?: number;
+                };
+                return: any;
+            };
+        };
+        stats: {
+            /** 获取用量统计数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    serviceType?: string;
+                    groupBy?: "day" | "service" | "user";
+                };
+                return: any;
+            };
+        };
+        records: {
+            /** 获取用量记录列表 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                    serviceType?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+    };
+    export: {
+        recharge: {
+            /** 导出充值订单记录为 CSV 格式 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    status?: string;
+                };
+                return: any;
+            };
+        };
+        refund: {
+            /** 导出退款记录为 CSV 格式 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    status?: string;
+                };
+                return: any;
+            };
+        };
+        pointsHistory: {
+            /** 导出积分变动记录为 CSV 格式 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    type?: string;
+                    userId?: string;
+                };
+                return: any;
+            };
+        };
+    };
+    financeReport: {
+        overview: {
+            /** 获取收入概览数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        trend: {
+            /** 获取收入趋势数据（按日/周/月） */
+            post: {
+                body: {
+                    period: "day" | "week" | "month";
+                    days?: number;
+                };
+                return: any;
+            };
+        };
+        packageRank: {
+            /** 获取套餐销售排行数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+        userRank: {
+            /** 获取用户充值排行数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+    };
+    reconciliation: {
+        generate: {
+            /** 生成指定日期的对账报告 */
+            post: {
+                body: {
+                    date: string;
+                };
+                return: any;
+            };
+        };
+        list: {
+            /** 查询对账报告列表 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                    status?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        detail: {
+            /** 查询对账报告详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        processAnomaly: {
+            /** 处理对账异常订单 */
+            post: {
+                body: {
+                    reportId: string;
+                    orderId: string;
+                    action: "confirm_paid" | "mark_cancelled" | "ignore";
+                    remark?: string;
+                };
+                return: any;
+            };
+        };
+        batchGenerate: {
+            /** 批量生成指定日期范围的对账报告 */
+            post: {
+                body: {
+                    startDate: string;
+                    endDate: string;
+                };
+                return: any;
+            };
+        };
+    };
+    invoice: {
+        apply: {
+            /** 申请开具发票 */
+            post: {
+                body: {
+                    invoiceType: "personal" | "company" | "vat_special";
+                    title: string;
+                    taxNumber?: string;
+                    companyAddress?: string;
+                    companyPhone?: string;
+                    bankName?: string;
+                    bankAccount?: string;
+                    email: string;
+                    receiverName?: string;
+                    receiverPhone?: string;
+                    receiverAddress?: string;
+                    orderIds?: string[];
+                    remark?: string;
+                };
+                return: any;
+            };
+        };
+        list: {
+            /** 查询发票申请列表 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                    status?: string;
+                    userId?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        detail: {
+            /** 查询发票详情 */
+            post: {
+                body: {
+                    invoiceNo: string;
+                };
+                return: any;
+            };
+        };
+        review: {
+            /** 审核发票申请（通过/拒绝） */
+            post: {
+                body: {
+                    invoiceNo: string;
+                    action: "approve" | "reject";
+                    remark?: string;
+                };
+                return: any;
+            };
+        };
+        issue: {
+            /** 标记发票已开具 */
+            post: {
+                body: {
+                    invoiceNo: string;
+                    invoiceCode?: string;
+                    invoiceNumber?: string;
+                    invoiceUrl?: string;
+                };
+                return: any;
+            };
+        };
+        stats: {
+            /** 获取发票统计数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        cancel: {
+            /** 取消发票申请（仅待审核状态可取消） */
+            post: {
+                body: {
+                    invoiceNo: string;
+                };
+                return: any;
+            };
+        };
+    };
+    agreement: {
+        create: {
+            /** 创建支付宝签约代扣授权 */
+            post: {
+                body: {
+                    periodType: "DAY" | "MONTH" | "YEAR";
+                    period: number;
+                    singleAmount: number;
+                    totalAmount?: number;
+                };
+                return: any;
+            };
+        };
+        query: {
+            /** 查询签约状态 */
+            post: {
+                body: {
+                    externalAgreementNo?: string;
+                };
+                return: any;
+            };
+        };
+        my: {
+            /** 获取当前用户的签约信息 */
+            post: {
+                return: any;
+            };
+        };
+        unsign: {
+            /** 解除签约授权 */
+            post: {
+                return: any;
+            };
+        };
+        history: {
+            /** 查询签约历史记录 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        deductLogs: {
+            /** 查询代扣扣款记录 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        signNotify: {
+            /** 支付宝签约异步通知回调 */
+            post: {
+                return: any;
+            };
+        };
+    };
+    internal: {
+        events: {
+            trigger: {
+                /** 供 auth-server 等内部服务发布业务事件 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId: string;
+                        event: string;
+                        eventData?: Record<string, unknown>;
+                    };
+                    return: any;
+                };
+            };
+        };
+        usage: {
+            preview: {
+                /** 供内部服务预估通用计费用量，不写入记录、不扣积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId: string;
+                        serviceType: string;
+                        amount: number;
+                        freeQuotaOverride?: number;
+                    };
+                    return: any;
+                };
+            };
+            previewBatch: {
+                /** 供内部服务批量预估通用计费用量，不写入记录、不扣积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        items: {
+                            key: string;
+                            userId: string;
+                            serviceType: string;
+                            amount: number;
+                            freeQuotaOverride?: number;
+                        }[];
+                    };
+                    return: any;
+                };
+            };
+            report: {
+                /** 供内部服务上报通用计费用量并扣积分 */
+                post: {
+                    body: {
+                        appId: string;
+                        userId: string;
+                        serviceType: string;
+                        amount: number;
+                        metadata?: Record<string, unknown>;
+                        requestId?: string;
+                        usageKind?: "event" | "continuous_settlement";
+                        periodStart?: string;
+                        periodEnd?: string;
+                        freeQuotaOverride?: number;
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
+    webhooks: {
+        events: {
+            /** 获取所有可用的 Webhook 事件类型 */
+            get: {
+                return: any;
+            };
+            ':id': {
+                /** 获取指定分类的 Webhook 事件 */
+                get: {
+                    params: {
+                        category: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        categories: {
+            /** 获取所有 Webhook 事件分类 */
+            get: {
+                return: any;
+            };
+        };
+    };
+};
+/** API 客户端类型（提供完整的 IDE 智能提示） */
+export interface ApiClient {
+    health: {
+        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+    };
+    'api-spec': {
+        /** 获取 API 规范，用于类型同步 */
+        get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+    };
+    products: {
+        create: {
+            /** 创建新产品 */
+            post: (body: {
+                name: string;
+                description?: string;
+                features: {
+                    key: string;
+                    name: string;
+                    description?: string;
+                    type: "boolean";
+                    value?: boolean;
+                    highlight?: boolean;
+                }[];
+                metadata?: Record<string, unknown>;
+                displayOrder?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除产品 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新产品信息 */
+            post: (body: {
+                id: string;
+                name?: string;
+                description?: string;
+                features?: {
+                    key: string;
+                    name: string;
+                    description?: string;
+                    type: "boolean";
+                    value?: boolean;
+                    highlight?: boolean;
+                }[];
+                status?: "active" | "archived";
+                metadata?: Record<string, unknown>;
+                displayOrder?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询产品列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    name?: string;
                     status?: "" | "active" | "archived";
                 };
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
         findOne: {
-            /** 根据 ID 查询产品详情 */
+            /** 根据 ID 查询产品详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        updateSort: {
+            /** 批量更新产品排序 */
+            post: (body: {
+                items: {
+                    id: string;
+                    displayOrder: number;
+                }[];
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        listActive: {
+            /** 获取定价页面可用产品列表（公开） */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    prices: {
+        create: {
+            /** 创建新价格方案 */
+            post: (body: {
+                productId: string;
+                nickname?: string;
+                type: "free" | "one_time" | "recurring";
+                currency: string;
+                unitAmount: number;
+                trialPeriodDays?: number;
+                allowRepeatTrial?: boolean;
+                interval?: "day" | "week" | "month" | "year";
+                intervalCount?: number;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除价格方案 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新价格方案信息 */
+            post: (body: {
+                id: string;
+                nickname?: string;
+                active?: boolean;
+                metadata?: Record<string, unknown>;
+                trialPeriodDays?: number;
+                allowRepeatTrial?: boolean;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询价格方案列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    productId?: string;
+                    type?: "" | "free" | "one_time" | "recurring";
+                    active?: boolean;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询价格方案详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        listByProduct: {
+            /** 获取指定产品的所有可用价格方案 */
+            post: (body: {
+                productId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        listFreeActive: {
+            /** 获取当前应用可领取的免费体验价格方案 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    subscriptions: {
+        create: {
+            /** 创建新订阅并发起支付 */
+            post: (body: {
+                priceId: string;
+                couponCode?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        cancel: {
+            /** 取消订阅 */
+            post: (body: {
+                subscriptionId: string;
+                cancelAtPeriodEnd?: boolean;
+                reason?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        resume: {
+            /** 恢复已取消的订阅 */
+            post: (body: {
+                subscriptionId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        change: {
+            /** 升级或降级订阅 */
+            post: (body: {
+                subscriptionId: string;
+                newPriceId: string;
+                proration?: boolean;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        my: {
+            /** 查询当前用户的订阅列表 */
+            post: (body: {
+                current?: number;
+                pageSize?: number;
+                status?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        current: {
+            /** 获取当前活跃订阅 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        summary: {
+            /** 获取当前用户订阅、配额、积分和待支付账单摘要 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        userDetail: {
+            /** 管理员查询指定用户的订阅、免费体验、配额、积分和最近消费记录 */
+            post: (body: {
+                userId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询订阅列表（管理端） */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    userId?: string;
+                    productId?: string;
+                    status?: string;
+                    cancelAtPeriodEnd?: boolean;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        history: {
+            /** 查询单个订阅的权益变化历史（管理端） */
+            post: (body: {
+                subscriptionId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        trend: {
+            /** 获取订阅各状态的历史趋势数据 */
+            post: (body: {
+                startTime: string;
+                endTime: string;
+                granularity: "day" | "week" | "month";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        count: {
+            /** 供其他服务查询用户订阅数量 */
+            post: (body: {
+                userId: string;
+                appId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        countBatch: {
+            /** 供其他服务批量查询用户订阅数量 */
+            post: (body: {
+                userIds: string[];
+                appId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        notify: {
+            alipay: {
+                /** 支付宝订阅支付回调通知 */
+                post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+    };
+    quotas: {
+        create: {
+            /** 创建配额定义 */
+            post: (body: {
+                priceId: string;
+                featureKey: string;
+                name: string;
+                description?: string;
+                limit: number;
+                period: "day" | "week" | "month" | "year" | "lifetime";
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除配额定义 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新配额定义 */
+            post: (body: {
+                id: string;
+                name?: string;
+                description?: string;
+                limit?: number;
+                period?: "day" | "week" | "month" | "year" | "lifetime";
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询配额列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    productId?: string;
+                    priceId?: string;
+                    featureKey?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        check: {
+            /** 供其他服务检查配额是否足够，不写入使用量 */
+            post: (body: {
+                appId: string;
+                userId: string;
+                featureKey: string;
+                quantity?: number;
+                used?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        my: {
+            /** 获取当前用户的配额使用情况 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        reserve: {
+            /** 供其他服务检查并预占配额 */
+            post: (body: {
+                appId: string;
+                userId: string;
+                featureKey: string;
+                quantity?: number;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        commit: {
+            /** 供其他服务确认已预占配额 */
+            post: (body: {
+                usageRecordId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        release: {
+            /** 供其他服务释放已预占配额 */
+            post: (body: {
+                usageRecordId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    trials: {
+        current: {
+            /** 获取当前用户免费体验状态 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        start: {
+            /** 领取当前应用的免费体验权益 */
+            post: (body: {
+                priceId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    newUserDefaults: {
+        find: {
+            /** 查询注册后默认授予的免费权益配置 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新注册后默认授予的免费权益配置 */
+            post: (body: {
+                autoGrantFreePriceOnSignup: boolean;
+                defaultFreePriceId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        grantMissingFreeEntitlements: {
+            /** 给当前应用下没有活跃订阅/体验的用户补发默认免费价格方案 */
+            post: (body: {
+                dryRun?: boolean;
+                userIds?: string[];
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    usageRecords: {
+        checkQuota: {
+            /** 检查配额是否足够，不写入使用量 */
+            post: (body: {
+                userId?: string;
+                featureKey: string;
+                quantity?: number;
+                used?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        reserveQuota: {
+            /** 检查配额并写入 reserved 使用量记录 */
+            post: (body: {
+                userId?: string;
+                featureKey: string;
+                quantity?: number;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        commitQuota: {
+            /** 将 reserved 使用量记录确认成 committed */
+            post: (body: {
+                usageRecordId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        releaseQuota: {
+            /** 将 reserved 使用量记录释放成 released */
+            post: (body: {
+                usageRecordId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询使用记录（管理端） */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    userId?: string;
+                    featureKey?: string;
+                    status?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        my: {
+            /** 查询当前用户的使用记录 */
+            post: (body: {
+                current?: number;
+                pageSize?: number;
+                featureKey?: string;
+                status?: string;
+                startTime?: string;
+                endTime?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statistics: {
+            /** 获取使用量统计数据 */
+            post: (body: {
+                userId?: string;
+                featureKey?: string;
+                startTime: string;
+                endTime: string;
+                granularity: "hour" | "day" | "week" | "month";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    invoices: {
+        find: {
+            /** 分页查询订阅账单列表（管理端） */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    userId?: string;
+                    subscriptionId?: string;
+                    status?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询订阅账单详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        my: {
+            /** 查询当前用户的订阅账单列表 */
+            post: (body: {
+                current?: number;
+                pageSize?: number;
+                status?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        cancel: {
+            /** 取消当前用户自己的待支付订阅账单 */
+            post: (body: {
+                id: string;
+                reason?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        pay: {
+            /** 为当前用户的待支付账单生成支付链接 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        verifyPayment: {
+            /** 查询支付宝订单状态，如果已支付则完成订阅入账 */
+            post: (body: {
+                orderId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        void: {
+            /** 管理端作废待支付订阅账单 */
+            post: (body: {
+                id: string;
+                reason?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statistics: {
+            /** 获取订阅账单统计数据 */
+            post: (body: {
+                startTime?: string;
+                endTime?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        revenueReport: {
+            /** 获取收入报表数据 */
+            post: (body: {
+                startTime: string;
+                endTime: string;
+                granularity: "day" | "week" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        revenueByProduct: {
+            /** 获取按产品分布的收入数据 */
+            post: (body: {
+                startTime?: string;
+                endTime?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statusOptions: {
+            /** 获取订阅账单状态下拉选项与展示文案 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        stats: {
+            /** 供其他服务查询发票统计数据 */
+            post: (body: {
+                appId: string;
+                userIds: string[];
+                status?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statsByUser: {
+            /** 供其他服务按用户分组查询发票统计 */
+            post: (body: {
+                appId: string;
+                userIds: string[];
+                status?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    points: {
+        account: {
+            /** 查询用户积分账户余额 */
+            post: (body: {
+                userId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        earn: {
+            /** 发放积分（充值、奖励等） */
+            post: (body: {
+                userId: string;
+                amount: number;
+                subType: "recharge" | "referral" | "signup" | "subscription" | "activity" | "bonus";
+                requestId?: string;
+                description: string;
+                orderId?: string;
+                referrerId?: string;
+                ruleId?: string;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        consume: {
+            /** 按调用方计算好的积分数消费积分 */
+            post: (body: {
+                userId: string;
+                amount: number;
+                requestId?: string;
+                description?: string;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        consumeByPrice: {
+            /** 根据计价配置消费积分 */
+            post: (body: {
+                userId: string;
+                priceCode: string;
+                quantity?: number;
+                requestId?: string;
+                description?: string;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        checkBalance: {
+            /** 检查积分是否足够（不扣费） */
+            post: (body: {
+                userId: string;
+                priceCode: string;
+                quantity?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        reversal: {
+            /** 冲正/退还已消费的积分 */
+            post: (body: {
+                userId: string;
+                originalTransactionId: string;
+                requestId?: string;
+                reason: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        clawback: {
+            /** 追回/扣回已发放的积分 */
+            post: (body: {
+                userId: string;
+                originalTransactionId: string;
+                requestId?: string;
+                reason: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        adjust: {
+            /** 人工调整积分（加/减） */
+            post: (body: {
+                userId: string;
+                amount: number;
+                requestId?: string;
+                reason: string;
+                relatedOrderId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        batchAdjust: {
+            /** 批量调整多用户积分 */
+            post: (body: {
+                userIds: string[];
+                amount: number;
+                requestId?: string;
+                reason: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statistics: {
+            /** 获取用户积分统计数据 */
+            post: (body: {
+                userId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        leaderboard: {
+            /** 获取积分排行榜 */
+            post: (body: {
+                limit?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    pointsHistory: {
+        find: {
+            /** 分页查询积分变动历史 */
+            post: (body: {
+                userId?: string;
+                type?: "earn" | "spend" | "reversal" | "clawback" | "adjust";
+                subType?: string;
+                page?: number;
+                pageSize?: number;
+                startDate?: string;
+                endDate?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询积分历史详情 */
             post: (body: {
                 id: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        listActive: {
-            /** 获取定价页面可用产品列表（公开） */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        statistics: {
+            /** 获取积分统计数据 */
+            post: (body: {
+                userId?: string;
+                period?: "day" | "week" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getTrendChart: {
+            /** 获取积分变动趋势图表数据 */
+            post: (body: {
+                userId?: string;
+                startTime: string;
+                endTime: string;
+                granularity: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getTypeDistributionChart: {
+            /** 获取积分类型分布图表数据 */
+            post: (body: {
+                userId?: string;
+                startTime?: string;
+                endTime?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getRankingChart: {
+            /** 获取用户积分排行榜 */
+            post: (body: {
+                type?: "earn" | "spend" | "reversal" | "clawback" | "adjust";
+                startTime?: string;
+                endTime?: string;
+                limit?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
     };
-    prices: {
-        create: {
-            /** 创建新价格方案 */
+    pointsTrigger: {
+        trigger: {
+            /** 根据规则 ID 触发积分发放 */
             post: (body: {
-                productId: string;
-                nickname?: string;
-                type: "free" | "one_time" | "recurring";
-                currency: string;
-                unitAmount: number;
-                trialPeriodDays?: number;
-                allowRepeatTrial?: boolean;
-                interval?: "day" | "week" | "month" | "year";
-                intervalCount?: number;
-                metadata?: Record<string, unknown>;
+                ruleId: string;
+                eventData?: Record<string, unknown>;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        delete: {
-            /** 删除价格方案 */
+        triggerByEvent: {
+            /** 根据事件自动匹配并触发积分规则 */
             post: (body: {
-                id: string;
+                event: string;
+                eventData?: Record<string, unknown>;
+                userId?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        update: {
-            /** 更新价格方案信息 */
+        batchTrigger: {
+            /** 批量触发多个积分规则 */
             post: (body: {
-                id: string;
-                nickname?: string;
-                active?: boolean;
-                metadata?: Record<string, unknown>;
-                trialPeriodDays?: number;
-                allowRepeatTrial?: boolean;
+                triggers: {
+                    ruleId: string;
+                    eventData?: Record<string, unknown>;
+                }[];
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
+    };
+    pointsTriggerHistory: {
         find: {
-            /** 分页查询价格方案列表 */
+            /** 分页查询积分触发历史记录 */
             post: (body: {
-                current: number;
-                pageSize: number;
-                where: {
-                    productId?: string;
-                    type?: "" | "free" | "one_time" | "recurring";
-                    active?: boolean;
+                current?: number;
+                pageSize?: number;
+                where?: {
+                    userId?: string;
+                    ruleId?: string;
+                    ruleCode?: string;
+                    event?: string;
+                    status?: "pending" | "success" | "completed" | "failed" | "cooldown" | "constraintFailed";
+                    rewardTarget?: "self" | "referrer";
+                    startDate?: string;
+                    endDate?: string;
                 };
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
         findOne: {
-            /** 根据 ID 查询价格方案详情 */
+            /** 根据 ID 查询积分触发历史详情 */
             post: (body: {
                 id: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        listByProduct: {
-            /** 获取指定产品的所有可用价格方案 */
+        statusOptions: {
+            /** 获取积分触发状态下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        rewardTargetOptions: {
+            /** 获取奖励目标下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statistics: {
+            /** 获取积分触发历史统计数据 */
             post: (body: {
-                productId: string;
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+                period?: "today" | "week" | "month" | "year";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        listFreeActive: {
-            /** 获取当前应用可领取的免费体验价格方案 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        trends: {
+            /** 获取积分触发趋势图表数据 */
+            post: (body: {
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+                granularity?: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-    };
-    subscriptions: {
-        create: {
-            /** 创建新订阅并发起支付 */
+        pointsTrends: {
+            /** 获取积分变动趋势图表数据 */
             post: (body: {
-                priceId: string;
-                couponCode?: string;
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+                granularity?: "minute" | "hour" | "day" | "month" | "year";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        cancel: {
-            /** 取消订阅 */
+        completionAnalysis: {
+            /** 获取积分规则完成度分析数据 */
             post: (body: {
-                subscriptionId: string;
-                cancelAtPeriodEnd?: boolean;
-                reason?: string;
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        resume: {
-            /** 恢复已取消的订阅 */
+        triggerTypeTrends: {
+            /** 获取积分触发类型趋势图表数据 */
             post: (body: {
-                subscriptionId: string;
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+                granularity?: "minute" | "hour" | "day" | "month" | "year";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        change: {
-            /** 升级或降级订阅 */
+    };
+    pointsTriggerRule: {
+        create: {
+            /** 创建新积分触发规则 */
             post: (body: {
-                subscriptionId: string;
-                newPriceId: string;
-                proration?: boolean;
+                ruleName: string;
+                ruleCode: string;
+                description: string;
+                event?: string;
+                triggerCondition: unknown;
+                pointsReward: unknown;
+                constraints: unknown;
+                activeTimeRanges: unknown;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        my: {
-            /** 查询当前用户的订阅列表 */
+        find: {
+            /** 分页查询积分触发规则列表 */
             post: (body: {
                 current?: number;
                 pageSize?: number;
-                status?: string;
+                where?: {
+                    triggerType?: string;
+                    status?: string;
+                    ruleName?: string;
+                    ruleCode?: string;
+                    event?: string;
+                };
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        current: {
-            /** 获取当前活跃订阅 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        summary: {
-            /** 获取当前用户订阅、配额、积分和待支付账单摘要 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        findOne: {
+            /** 根据 ID 查询积分触发规则详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        find: {
-            /** 分页查询订阅列表（管理端） */
+        update: {
+            /** 更新积分触发规则配置 */
             post: (body: {
-                current: number;
-                pageSize: number;
-                where: {
-                    userId?: string;
-                    productId?: string;
-                    status?: string;
-                };
+                id: string;
+                ruleName?: string;
+                ruleCode?: string;
+                description?: string;
+                event?: string | null;
+                triggerCondition?: unknown;
+                pointsReward?: unknown;
+                constraints?: unknown;
+                activeTimeRanges?: unknown;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        count: {
-            /** 供其他服务查询用户订阅数量 */
+        updateStatus: {
+            /** 启用或禁用积分触发规则 */
             post: (body: {
-                userId: string;
-                appId?: string;
+                id: string;
+                status: "draft" | "active" | "inactive";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        countBatch: {
-            /** 供其他服务批量查询用户订阅数量 */
+        delete: {
+            /** 删除积分触发规则 */
             post: (body: {
-                userIds: string[];
-                appId?: string;
+                id: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
+        statusOptions: {
+            /** 获取积分触发规则状态下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        eventOptions: {
+            /** 获取可绑定的事件类型选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
     };
-    quotas: {
+    pointsPriceConfig: {
         create: {
-            /** 创建配额定义 */
+            /** 创建新的积分计价配置 */
             post: (body: {
-                priceId: string;
-                featureKey: string;
+                code: string;
                 name: string;
                 description?: string;
-                limit: number;
-                period: "day" | "week" | "month" | "year" | "lifetime";
-                metadata?: Record<string, unknown>;
+                billingMode: "per_request" | "per_unit";
+                unitPrice: number;
+                unit?: string;
+                minCharge?: number;
+                status?: "active" | "inactive";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        delete: {
-            /** 删除配额定义 */
+        find: {
+            /** 分页查询计价配置列表 */
             post: (body: {
-                id: string;
+                where?: {
+                    code?: string;
+                    name?: string;
+                    billingMode?: string;
+                    status?: string;
+                };
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 或 code 查询计价配置详情 */
+            post: (body: {
+                id?: string;
+                code?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
         update: {
-            /** 更新配额定义 */
+            /** 更新计价配置 */
             post: (body: {
                 id: string;
                 name?: string;
                 description?: string;
-                limit?: number;
-                period?: "day" | "week" | "month" | "year" | "lifetime";
-                metadata?: Record<string, unknown>;
+                billingMode?: "per_request" | "per_unit";
+                unitPrice?: number;
+                unit?: string;
+                minCharge?: number;
+                status?: "active" | "inactive";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        find: {
-            /** 分页查询配额列表 */
+        updateStatus: {
+            /** 启用或停用计价配置 */
             post: (body: {
-                current: number;
-                pageSize: number;
-                where: {
-                    productId?: string;
-                    priceId?: string;
-                    featureKey?: string;
-                };
+                id: string;
+                status: "active" | "inactive";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        check: {
-            /** 检查用户配额是否足够 */
+        delete: {
+            /** 删除计价配置 */
             post: (body: {
-                featureKey: string;
-                amount?: number;
+                id: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        my: {
-            /** 获取当前用户的配额使用情况 */
+        billingModeOptions: {
+            /** 获取计费方式下拉选项 */
             post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
     };
-    usageRecords: {
-        record: {
-            /** 记录用户功能使用量 */
+    pointsUsageRecord: {
+        find: {
+            /** 分页查询积分消费记录 */
             post: (body: {
-                userId?: string;
-                featureKey: string;
-                quantity?: number;
-                metadata?: Record<string, unknown>;
+                where?: {
+                    userId?: string;
+                    priceCode?: string;
+                    priceName?: string;
+                    billingMode?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                page?: number;
+                pageSize?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        recordWithQuotaCheck: {
-            /** 记录使用量并检查配额 */
+        statistics: {
+            /** 按维度统计消费数据 */
             post: (body: {
+                dimension: "priceCode" | "userId" | "date";
+                startDate?: string;
+                endDate?: string;
+                priceCode?: string;
                 userId?: string;
-                featureKey: string;
-                quantity?: number;
-                metadata?: Record<string, unknown>;
+                limit?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        checkQuota: {
-            /** 预检查配额是否足够（不记录使用量） */
+        overview: {
+            /** 获取消费概览数据 */
             post: (body: {
-                userId?: string;
-                featureKey: string;
-                quantity?: number;
+                startDate?: string;
+                endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        batchRecord: {
-            /** 批量记录使用量 */
+    };
+    pointsBalanceAlert: {
+        upsertConfig: {
+            /** 创建或更新预警配置 */
             post: (body: {
-                records: {
-                    userId: string;
-                    featureKey: string;
-                    quantity?: number;
-                    metadata?: Record<string, unknown>;
-                    timestamp?: string;
-                }[];
+                threshold: number;
+                enabled?: boolean;
+                notifyEmail?: boolean;
+                notifyEmails?: string[];
+                cooldownHours?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        find: {
-            /** 分页查询使用记录（管理端） */
+        getConfig: {
+            /** 获取当前预警配置 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findAlerts: {
+            /** 分页查询预警记录 */
             post: (body: {
-                current: number;
-                pageSize: number;
-                where: {
+                where?: {
                     userId?: string;
-                    featureKey?: string;
-                    startTime?: string;
-                    endTime?: string;
+                    alertType?: string;
+                    startDate?: string;
+                    endDate?: string;
                 };
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        triggerCheck: {
+            /** 手动触发预警检查（测试用） */
+            post: (body: {
+                userId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    consumption: {
+        trend: {
+            /** 聚合服务消费的趋势数据 */
+            post: (body: {
+                startDate?: string;
+                endDate?: string;
+                limit?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        my: {
-            /** 查询当前用户的使用记录 */
+        overview: {
+            /** 聚合服务消费的概览数据 */
             post: (body: {
-                current?: number;
-                pageSize?: number;
-                featureKey?: string;
-                startTime?: string;
-                endTime?: string;
+                startDate?: string;
+                endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        statistics: {
-            /** 获取使用量统计数据 */
+    };
+    pointsRecharge: {
+        packages: {
+            /** 获取可用的充值套餐列表 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        createOrder: {
+            /** 创建积分充值订单 */
             post: (body: {
-                userId?: string;
-                featureKey?: string;
-                startTime: string;
-                endTime: string;
-                granularity: "hour" | "day" | "week" | "month";
+                packageId: string;
+                payType: "alipay" | "weixinpay";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        getTrendChart: {
-            /** 获取使用量趋势图表数据 */
+        createQRCodeOrder: {
+            /** 创建支付宝扫码支付订单（当面付） */
             post: (body: {
-                featureKey?: string;
-                startTime: string;
-                endTime: string;
-                granularity: "hour" | "day" | "week" | "month";
+                packageId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        orders: {
+            /** 查询用户的充值订单记录 */
+            post: (body: {
+                status?: string;
+                page?: number;
+                pageSize?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-    };
-    invoices: {
         find: {
-            /** 分页查询发票列表（管理端） */
+            /** 管理端分页查询全部积分充值订单 */
             post: (body: {
                 current: number;
                 pageSize: number;
                 where: {
                     userId?: string;
-                    subscriptionId?: string;
                     status?: string;
                     startTime?: string;
                     endTime?: string;
                 };
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        findOne: {
-            /** 根据 ID 查询发票详情 */
-            post: (body: {
-                id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        my: {
-            /** 查询当前用户的发票列表 */
-            post: (body: {
-                current?: number;
-                pageSize?: number;
-                status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        pay: {
-            /** 支付我的账单 */
+        detail: {
+            /** 管理端查询单个积分充值订单详情及操作时间线 */
             post: (body: {
-                id: string;
+                orderId: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        void: {
-            /** 作废发票 */
+        adminStatistics: {
+            /** 管理端积分充值订单统计 */
             post: (body: {
-                id: string;
-                reason?: string;
+                startTime?: string;
+                endTime?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
         statistics: {
-            /** 获取发票统计数据 */
+            /** 获取用户积分充值订单统计 */
             post: (body: {
                 startTime?: string;
                 endTime?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        revenueReport: {
-            /** 获取收入报表数据 */
-            post: (body: {
-                startTime: string;
-                endTime: string;
-                granularity: "day" | "week" | "month" | "year";
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        statusOptions: {
+            /** 获取积分充值订单状态下拉选项与展示文案 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        stats: {
-            /** 供其他服务查询发票统计数据 */
+        verifyPayment: {
+            /** 查询支付宝订单状态，如果已支付则完成充值 */
             post: (body: {
-                appId: string;
-                userIds: string[];
-                status?: string;
+                orderId: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        statsByUser: {
-            /** 供其他服务按用户分组查询发票统计 */
-            post: (body: {
-                appId: string;
-                userIds: string[];
-                status?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        notify: {
+            alipay: {
+                /** 支付宝积分充值回调通知 */
+                post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
         };
     };
-    points: {
-        account: {
-            /** 查询用户积分账户余额 */
+    rechargePackage: {
+        list: {
+            /** 获取充值套餐列表（管理端） */
             post: (body: {
-                userId?: string;
+                includeDisabled?: boolean;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        earn: {
-            /** 发放积分（充值、奖励等） */
+        create: {
+            /** 创建新的充值套餐 */
             post: (body: {
-                userId: string;
-                amount: number;
-                subType: "recharge" | "referral" | "signup" | "subscription" | "activity" | "bonus";
-                requestId?: string;
-                description: string;
-                orderId?: string;
-                referrerId?: string;
-                ruleId?: string;
-                metadata?: Record<string, unknown>;
+                name: string;
+                price: number;
+                points: number;
+                bonus: number;
+                description?: string;
+                sort?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        consumeByPrice: {
-            /** 根据计价配置消费积分 */
+        update: {
+            /** 更新充值套餐信息 */
             post: (body: {
-                userId: string;
-                priceCode: string;
-                quantity?: number;
-                requestId?: string;
+                id: string;
+                name?: string;
+                price?: number;
+                points?: number;
+                bonus?: number;
                 description?: string;
-                metadata?: Record<string, unknown>;
+                sort?: number;
+                enabled?: boolean;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        checkBalance: {
-            /** 检查积分是否足够（不扣费） */
+        delete: {
+            /** 删除充值套餐 */
             post: (body: {
-                userId: string;
-                priceCode: string;
-                quantity?: number;
+                id: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        reversal: {
-            /** 冲正/退还已消费的积分 */
+        updateSort: {
+            /** 批量更新套餐排序 */
             post: (body: {
-                userId: string;
-                originalTransactionId: string;
-                requestId?: string;
-                reason: string;
+                items: {
+                    id: string;
+                    sort: number;
+                }[];
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        clawback: {
-            /** 追回/扣回已发放的积分 */
+    };
+    refund: {
+        apply: {
+            /** 对已支付订单申请退款 */
             post: (body: {
-                userId: string;
-                originalTransactionId: string;
-                requestId?: string;
-                reason: string;
+                orderId: string;
+                reason?: string;
+                refundAmount?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        adjust: {
-            /** 人工调整积分（加/减） */
+        applySubscription: {
+            /** 对已支付订阅账单申请退款 */
             post: (body: {
-                userId: string;
-                amount: number;
-                requestId?: string;
-                reason: string;
-                relatedOrderId?: string;
+                invoiceId: string;
+                reason?: string;
+                refundAmount?: number;
+                subscriptionAction?: "cancel_immediate" | "none";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        batchAdjust: {
-            /** 批量调整多用户积分 */
+        approve: {
+            /** 审批退款申请（通过或拒绝） */
             post: (body: {
-                userIds: string[];
-                amount: number;
-                requestId?: string;
-                reason: string;
+                refundNo: string;
+                action: "approve" | "reject";
+                remark?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        statistics: {
-            /** 获取用户积分统计数据 */
+        execute: {
+            /** 执行已审批的退款（调用支付宝/微信退款接口） */
             post: (body: {
-                userId?: string;
+                refundNo: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        leaderboard: {
-            /** 获取积分排行榜 */
+        manual: {
+            /** 管理员手动标记退款完成（用于线上接口故障或特殊情况） */
             post: (body: {
-                limit?: number;
+                refundNo: string;
+                manualRefundNo?: string;
+                remark: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-    };
-    pointsHistory: {
-        find: {
-            /** 分页查询积分变动历史 */
+        list: {
+            /** 查询退款记录列表 */
             post: (body: {
-                userId?: string;
-                type?: "earn" | "spend" | "reversal" | "clawback" | "adjust";
-                subType?: string;
                 page?: number;
                 pageSize?: number;
+                status?: string;
+                sourceType?: "points_recharge" | "subscription_invoice";
+                userId?: string;
                 startDate?: string;
                 endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        findOne: {
-            /** 根据 ID 查询积分历史详情 */
-            post: (body: {
-                id: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        statistics: {
-            /** 获取积分统计数据 */
+        detail: {
+            /** 查询单个退款单详情 */
             post: (body: {
-                userId?: string;
-                period?: "day" | "week" | "month" | "year";
+                refundNo: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        getTrendChart: {
-            /** 获取积分变动趋势图表数据 */
+        stats: {
+            /** 获取退款统计数据 */
             post: (body: {
-                userId?: string;
-                startTime: string;
-                endTime: string;
-                granularity: "minute" | "hour" | "day" | "month" | "year";
+                startDate?: string;
+                endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        getTypeDistributionChart: {
-            /** 获取积分类型分布图表数据 */
+        syncStatus: {
+            /** 手动同步单个退款单的支付宝退款状态 */
             post: (body: {
-                userId?: string;
-                startTime?: string;
-                endTime?: string;
+                refundNo: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        getRankingChart: {
-            /** 获取用户积分排行榜 */
-            post: (body: {
-                type?: "earn" | "spend" | "reversal" | "clawback" | "adjust";
-                startTime?: string;
-                endTime?: string;
-                limit?: number;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        statusOptions: {
+            /** 获取退款单状态下拉选项与展示文案 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
     };
-    pointsTrigger: {
-        trigger: {
-            /** 根据规则 ID 触发积分发放 */
-            post: (body: {
-                ruleId: string;
-                eventData?: Record<string, unknown>;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        triggerByEvent: {
-            /** 根据事件自动匹配并触发积分规则 */
+    serviceDefinition: {
+        list: {
+            /** 获取应用的所有服务定义 */
             post: (body: {
-                event: string;
-                eventData?: Record<string, unknown>;
-                userId?: string;
+                page?: number;
+                pageSize?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        batchTrigger: {
-            /** 批量触发多个积分规则 */
+        create: {
+            /** 创建新的服务定义 */
             post: (body: {
-                triggers: {
-                    ruleId: string;
-                    eventData?: Record<string, unknown>;
-                }[];
+                serviceType: string;
+                name: string;
+                description?: string;
+                billingUnit: string;
+                billingMode?: "event" | "continuous";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-    };
-    pointsTriggerHistory: {
-        find: {
-            /** 分页查询积分触发历史记录 */
+        update: {
+            /** 更新服务定义 */
             post: (body: {
-                current?: number;
-                pageSize?: number;
-                where?: {
-                    userId?: string;
-                    ruleId?: string;
-                    ruleCode?: string;
-                    event?: string;
-                    status?: "pending" | "success" | "completed" | "failed" | "cooldown" | "constraintFailed";
-                    rewardTarget?: "self" | "referrer";
-                    startDate?: string;
-                    endDate?: string;
-                };
+                id: string;
+                name?: string;
+                description?: string;
+                billingUnit?: string;
+                billingMode?: "event" | "continuous";
+                enabled?: boolean;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        findOne: {
-            /** 根据 ID 查询积分触发历史详情 */
+        delete: {
+            /** 删除服务定义 */
             post: (body: {
                 id: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        statusOptions: {
-            /** 获取积分触发状态下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        rewardTargetOptions: {
-            /** 获取奖励目标下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        statistics: {
-            /** 获取积分触发历史统计数据 */
+    };
+    pricingRule: {
+        get: {
+            /** 获取服务的定价规则 */
             post: (body: {
-                userId?: string;
-                ruleId?: string;
-                startTime?: string;
-                endTime?: string;
-                period?: "today" | "week" | "month" | "year";
+                serviceType: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        trends: {
-            /** 获取积分触发趋势图表数据 */
+        save: {
+            /** 创建或更新定价规则 */
             post: (body: {
-                userId?: string;
-                ruleId?: string;
-                startTime?: string;
-                endTime?: string;
-                granularity?: "minute" | "hour" | "day" | "month" | "year";
+                serviceType: string;
+                tiers?: {
+                    minUsage: number;
+                    maxUsage: number | null;
+                    pricePerUnit: number;
+                }[];
+                flatPrice?: number | null;
+                freeQuota?: number;
+                profitMargin?: number;
+                enabled?: boolean;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        pointsTrends: {
-            /** 获取积分变动趋势图表数据 */
+    };
+    usage: {
+        report: {
+            /** 上报服务用量，自动计费扣费 */
             post: (body: {
-                userId?: string;
-                ruleId?: string;
-                startTime?: string;
-                endTime?: string;
-                granularity?: "minute" | "hour" | "day" | "month" | "year";
+                serviceType: string;
+                metadata: Record<string, unknown>;
+                requestId?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        completionAnalysis: {
-            /** 获取积分规则完成度分析数据 */
+        preview: {
+            /** 按当前定价规则预估本次用量费用，不写入记录、不扣积分 */
             post: (body: {
-                userId?: string;
-                ruleId?: string;
-                startTime?: string;
-                endTime?: string;
+                serviceType: string;
+                metadata: Record<string, unknown>;
+                freeQuotaOverride?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        triggerTypeTrends: {
-            /** 获取积分触发类型趋势图表数据 */
+        stats: {
+            /** 获取用量统计数据 */
             post: (body: {
-                userId?: string;
-                ruleId?: string;
-                startTime?: string;
-                endTime?: string;
-                granularity?: "minute" | "hour" | "day" | "month" | "year";
+                startDate?: string;
+                endDate?: string;
+                serviceType?: string;
+                groupBy?: "day" | "service" | "user";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-    };
-    pointsTriggerRule: {
-        create: {
-            /** 创建新积分触发规则 */
+        records: {
+            /** 获取用量记录列表 */
             post: (body: {
-                ruleName: string;
-                ruleCode: string;
-                description: string;
-                event?: string;
-                triggerCondition: unknown;
-                pointsReward: unknown;
-                constraints: unknown;
-                activeTimeRanges: unknown;
+                page?: number;
+                pageSize?: number;
+                serviceType?: string;
+                startDate?: string;
+                endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        find: {
-            /** 分页查询积分触发规则列表 */
+    };
+    export: {
+        recharge: {
+            /** 导出充值订单记录为 CSV 格式 */
             post: (body: {
-                current?: number;
-                pageSize?: number;
-                where?: {
-                    triggerType?: string;
-                    status?: string;
-                    ruleName?: string;
-                    ruleCode?: string;
-                    event?: string;
-                };
+                startDate?: string;
+                endDate?: string;
+                status?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        findOne: {
-            /** 根据 ID 查询积分触发规则详情 */
+        refund: {
+            /** 导出退款记录为 CSV 格式 */
             post: (body: {
-                id: string;
+                startDate?: string;
+                endDate?: string;
+                status?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        update: {
-            /** 更新积分触发规则配置 */
+        pointsHistory: {
+            /** 导出积分变动记录为 CSV 格式 */
             post: (body: {
-                id: string;
-                ruleName?: string;
-                ruleCode?: string;
-                description?: string;
-                event?: string | null;
-                triggerCondition?: unknown;
-                pointsReward?: unknown;
-                constraints?: unknown;
-                activeTimeRanges?: unknown;
+                startDate?: string;
+                endDate?: string;
+                type?: string;
+                userId?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        updateStatus: {
-            /** 启用或禁用积分触发规则 */
+    };
+    financeReport: {
+        overview: {
+            /** 获取收入概览数据 */
             post: (body: {
-                id: string;
-                status: "draft" | "active" | "inactive";
+                startDate?: string;
+                endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        delete: {
-            /** 删除积分触发规则 */
+        trend: {
+            /** 获取收入趋势数据（按日/周/月） */
             post: (body: {
-                id: string;
+                period: "day" | "week" | "month";
+                days?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        statusOptions: {
-            /** 获取积分触发规则状态下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        packageRank: {
+            /** 获取套餐销售排行数据 */
+            post: (body: {
+                startDate?: string;
+                endDate?: string;
+                limit?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        eventOptions: {
-            /** 获取可绑定的事件类型选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        userRank: {
+            /** 获取用户充值排行数据 */
+            post: (body: {
+                startDate?: string;
+                endDate?: string;
+                limit?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
     };
-    pointsPriceConfig: {
-        create: {
-            /** 创建新的积分计价配置 */
+    reconciliation: {
+        generate: {
+            /** 生成指定日期的对账报告 */
             post: (body: {
-                code: string;
-                name: string;
-                description?: string;
-                billingMode: "per_request" | "per_unit";
-                unitPrice: number;
-                unit?: string;
-                minCharge?: number;
-                status?: "active" | "inactive";
+                date: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        find: {
-            /** 分页查询计价配置列表 */
+        list: {
+            /** 查询对账报告列表 */
             post: (body: {
-                where?: {
-                    code?: string;
-                    name?: string;
-                    billingMode?: string;
-                    status?: string;
-                };
                 page?: number;
                 pageSize?: number;
+                status?: string;
+                startDate?: string;
+                endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        findOne: {
-            /** 根据 ID 或 code 查询计价配置详情 */
-            post: (body: {
-                id?: string;
-                code?: string;
-            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-        update: {
-            /** 更新计价配置 */
+        detail: {
+            /** 查询对账报告详情 */
             post: (body: {
                 id: string;
-                name?: string;
-                description?: string;
-                billingMode?: "per_request" | "per_unit";
-                unitPrice?: number;
-                unit?: string;
-                minCharge?: number;
-                status?: "active" | "inactive";
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        updateStatus: {
-            /** 启用或停用计价配置 */
+        processAnomaly: {
+            /** 处理对账异常订单 */
             post: (body: {
-                id: string;
-                status: "active" | "inactive";
+                reportId: string;
+                orderId: string;
+                action: "confirm_paid" | "mark_cancelled" | "ignore";
+                remark?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        delete: {
-            /** 删除计价配置 */
+        batchGenerate: {
+            /** 批量生成指定日期范围的对账报告 */
             post: (body: {
-                id: string;
+                startDate: string;
+                endDate: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        billingModeOptions: {
-            /** 获取计费方式下拉选项 */
-            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
     };
-    pointsUsageRecord: {
-        find: {
-            /** 分页查询积分消费记录 */
+    invoice: {
+        apply: {
+            /** 申请开具发票 */
+            post: (body: {
+                invoiceType: "personal" | "company" | "vat_special";
+                title: string;
+                taxNumber?: string;
+                companyAddress?: string;
+                companyPhone?: string;
+                bankName?: string;
+                bankAccount?: string;
+                email: string;
+                receiverName?: string;
+                receiverPhone?: string;
+                receiverAddress?: string;
+                orderIds?: string[];
+                remark?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        list: {
+            /** 查询发票申请列表 */
             post: (body: {
-                where?: {
-                    userId?: string;
-                    priceCode?: string;
-                    priceName?: string;
-                    billingMode?: string;
-                    startDate?: string;
-                    endDate?: string;
-                };
                 page?: number;
                 pageSize?: number;
+                status?: string;
+                userId?: string;
+                startDate?: string;
+                endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        statistics: {
-            /** 按维度统计消费数据 */
+        detail: {
+            /** 查询发票详情 */
             post: (body: {
-                dimension: "priceCode" | "userId" | "date";
-                startDate?: string;
-                endDate?: string;
-                priceCode?: string;
-                userId?: string;
-                limit?: number;
+                invoiceNo: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        overview: {
-            /** 获取消费概览数据 */
+        review: {
+            /** 审核发票申请（通过/拒绝） */
+            post: (body: {
+                invoiceNo: string;
+                action: "approve" | "reject";
+                remark?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        issue: {
+            /** 标记发票已开具 */
+            post: (body: {
+                invoiceNo: string;
+                invoiceCode?: string;
+                invoiceNumber?: string;
+                invoiceUrl?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        stats: {
+            /** 获取发票统计数据 */
             post: (body: {
                 startDate?: string;
                 endDate?: string;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
+        cancel: {
+            /** 取消发票申请（仅待审核状态可取消） */
+            post: (body: {
+                invoiceNo: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
     };
-    pointsBalanceAlert: {
-        upsertConfig: {
-            /** 创建或更新预警配置 */
+    agreement: {
+        create: {
+            /** 创建支付宝签约代扣授权 */
             post: (body: {
-                threshold: number;
-                enabled?: boolean;
-                notifyEmail?: boolean;
-                notifyEmails?: string[];
-                cooldownHours?: number;
+                periodType: "DAY" | "MONTH" | "YEAR";
+                period: number;
+                singleAmount: number;
+                totalAmount?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        getConfig: {
-            /** 获取当前预警配置 */
+        query: {
+            /** 查询签约状态 */
+            post: (body: {
+                externalAgreementNo?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        my: {
+            /** 获取当前用户的签约信息 */
             post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        findAlerts: {
-            /** 分页查询预警记录 */
+        unsign: {
+            /** 解除签约授权 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        history: {
+            /** 查询签约历史记录 */
             post: (body: {
-                where?: {
-                    userId?: string;
-                    alertType?: string;
-                    startDate?: string;
-                    endDate?: string;
-                };
                 page?: number;
                 pageSize?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
-        triggerCheck: {
-            /** 手动触发预警检查（测试用） */
+        deductLogs: {
+            /** 查询代扣扣款记录 */
             post: (body: {
-                userId: string;
+                page?: number;
+                pageSize?: number;
             }, config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
+        signNotify: {
+            /** 支付宝签约异步通知回调 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    internal: {
+        events: {
+            trigger: {
+                /** 供 auth-server 等内部服务发布业务事件 */
+                post: (body: {
+                    appId: string;
+                    userId: string;
+                    event: string;
+                    eventData?: Record<string, unknown>;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        usage: {
+            preview: {
+                /** 供内部服务预估通用计费用量，不写入记录、不扣积分 */
+                post: (body: {
+                    appId: string;
+                    userId: string;
+                    serviceType: string;
+                    amount: number;
+                    freeQuotaOverride?: number;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            previewBatch: {
+                /** 供内部服务批量预估通用计费用量，不写入记录、不扣积分 */
+                post: (body: {
+                    appId: string;
+                    items: {
+                        key: string;
+                        userId: string;
+                        serviceType: string;
+                        amount: number;
+                        freeQuotaOverride?: number;
+                    }[];
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            report: {
+                /** 供内部服务上报通用计费用量并扣积分 */
+                post: (body: {
+                    appId: string;
+                    userId: string;
+                    serviceType: string;
+                    amount: number;
+                    metadata?: Record<string, unknown>;
+                    requestId?: string;
+                    usageKind?: "event" | "continuous_settlement";
+                    periodStart?: string;
+                    periodEnd?: string;
+                    freeQuotaOverride?: number;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
     };
     webhooks: {
         events: {
@@ -2077,12 +3686,6 @@ export interface ApiClient {
             get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
         };
     };
-    notify: {
-        alipay: {
-            /** 支付宝订阅支付回调通知 */
-            post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
-        };
-    };
 }
 /** API 客户端类型别名（基于 EdenClient 推断，提供完整类型检查） */
 export type ApiClientType = EdenClient<Api>;