@huyooo/ui 0.7.24 → 0.8.0

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

@@ -0,0 +1,1964 @@
+import { ApiResponse, RequestConfig, Client, EdenClient } from '@vafast/api-client';
+/** API 契约类型 */
+export type Api = {
+    health: {
+        get: {
+            return: any;
+        };
+    };
+    'api-spec': {
+        /** 获取 API 规范，用于类型同步 */
+        get: {
+            return: any;
+        };
+    };
+    products: {
+        create: {
+            /** 创建新产品 */
+            post: {
+                body: {
+                    name: string;
+                    description?: string;
+                    features: {
+                        key: string;
+                        name: string;
+                        description?: string;
+                        type: "boolean" | "quota" | "unlimited";
+                        value?: boolean | number;
+                        highlight?: boolean;
+                    }[];
+                    metadata?: Record<string, unknown>;
+                    displayOrder?: number;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除产品 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新产品信息 */
+            post: {
+                body: {
+                    id: string;
+                    name?: string;
+                    description?: string;
+                    features?: {
+                        key: string;
+                        name: string;
+                        description?: string;
+                        type: "boolean" | "quota" | "unlimited";
+                        value?: boolean | number;
+                        highlight?: boolean;
+                    }[];
+                    status?: "active" | "archived";
+                    metadata?: Record<string, unknown>;
+                    displayOrder?: number;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询产品列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        name?: string;
+                        status?: "" | "active" | "archived";
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询产品详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        listActive: {
+            /** 获取定价页面可用产品列表（公开） */
+            post: {
+                return: any;
+            };
+        };
+    };
+    prices: {
+        create: {
+            /** 创建新价格方案 */
+            post: {
+                body: {
+                    productId: string;
+                    nickname?: string;
+                    type: "one_time" | "recurring";
+                    currency: string;
+                    unitAmount: number;
+                    interval?: "day" | "week" | "month" | "year";
+                    intervalCount?: number;
+                    trialPeriodDays?: number;
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除价格方案 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新价格方案信息 */
+            post: {
+                body: {
+                    id: string;
+                    nickname?: string;
+                    active?: boolean;
+                    trialPeriodDays?: number;
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询价格方案列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        productId?: string;
+                        type?: "" | "one_time" | "recurring";
+                        active?: boolean;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询价格方案详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        listByProduct: {
+            /** 获取指定产品的所有可用价格方案 */
+            post: {
+                body: {
+                    productId: string;
+                };
+                return: any;
+            };
+        };
+    };
+    subscriptions: {
+        create: {
+            /** 创建新订阅并发起支付 */
+            post: {
+                body: {
+                    priceId: string;
+                    couponCode?: string;
+                };
+                return: any;
+            };
+        };
+        cancel: {
+            /** 取消订阅 */
+            post: {
+                body: {
+                    subscriptionId: string;
+                    cancelAtPeriodEnd?: boolean;
+                    reason?: string;
+                };
+                return: any;
+            };
+        };
+        resume: {
+            /** 恢复已取消的订阅 */
+            post: {
+                body: {
+                    subscriptionId: string;
+                };
+                return: any;
+            };
+        };
+        change: {
+            /** 升级或降级订阅 */
+            post: {
+                body: {
+                    subscriptionId: string;
+                    newPriceId: string;
+                    proration?: boolean;
+                };
+                return: any;
+            };
+        };
+        my: {
+            /** 查询当前用户的订阅列表 */
+            post: {
+                body: {
+                    current?: number;
+                    pageSize?: number;
+                    status?: string;
+                };
+                return: any;
+            };
+        };
+        current: {
+            /** 获取当前活跃订阅 */
+            post: {
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询订阅列表（管理端） */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        userId?: string;
+                        productId?: string;
+                        status?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+    };
+    quotas: {
+        create: {
+            /** 创建配额定义 */
+            post: {
+                body: {
+                    productId: string;
+                    featureKey: string;
+                    name: string;
+                    description?: string;
+                    limit: number;
+                    allowOverage?: boolean;
+                    pointsCostPerUnit?: number;
+                    period: "day" | "week" | "month" | "year" | "lifetime";
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除配额定义 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新配额定义 */
+            post: {
+                body: {
+                    id: string;
+                    name?: string;
+                    description?: string;
+                    limit?: number;
+                    period?: "day" | "week" | "month" | "year" | "lifetime";
+                    allowOverage?: boolean;
+                    pointsCostPerUnit?: number;
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询配额列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        productId?: string;
+                        featureKey?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        check: {
+            /** 检查用户配额是否足够 */
+            post: {
+                body: {
+                    featureKey: string;
+                    amount?: number;
+                };
+                return: any;
+            };
+        };
+        my: {
+            /** 获取当前用户的配额使用情况 */
+            post: {
+                return: any;
+            };
+        };
+    };
+    usageRecords: {
+        record: {
+            /** 记录用户功能使用量 */
+            post: {
+                body: {
+                    userId?: string;
+                    featureKey: string;
+                    quantity?: number;
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        recordWithQuotaCheck: {
+            /** 记录使用量并检查配额，支持超额积分扣费 */
+            post: {
+                body: {
+                    userId?: string;
+                    featureKey: string;
+                    quantity?: number;
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        checkQuota: {
+            /** 预检查配额是否足够（不记录使用量） */
+            post: {
+                body: {
+                    userId?: string;
+                    featureKey: string;
+                    quantity?: number;
+                };
+                return: any;
+            };
+        };
+        batchRecord: {
+            /** 批量记录使用量 */
+            post: {
+                body: {
+                    records: {
+                        userId: string;
+                        featureKey: string;
+                        quantity?: number;
+                        metadata?: Record<string, unknown>;
+                        timestamp?: string;
+                    }[];
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询使用记录（管理端） */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        userId?: string;
+                        featureKey?: string;
+                        startTime?: string;
+                        endTime?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        my: {
+            /** 查询当前用户的使用记录 */
+            post: {
+                body: {
+                    current?: number;
+                    pageSize?: number;
+                    featureKey?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        statistics: {
+            /** 获取使用量统计数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    featureKey?: string;
+                    startTime: string;
+                    endTime: string;
+                    granularity: "hour" | "day" | "week" | "month";
+                };
+                return: any;
+            };
+        };
+        getTrendChart: {
+            /** 获取使用量趋势图表数据 */
+            post: {
+                body: {
+                    featureKey?: string;
+                    startTime: string;
+                    endTime: string;
+                    granularity: "hour" | "day" | "week" | "month";
+                };
+                return: any;
+            };
+        };
+    };
+    invoices: {
+        find: {
+            /** 分页查询发票列表（管理端） */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        userId?: string;
+                        subscriptionId?: string;
+                        status?: string;
+                        startTime?: string;
+                        endTime?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询发票详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        my: {
+            /** 查询当前用户的发票列表 */
+            post: {
+                body: {
+                    current?: number;
+                    pageSize?: number;
+                    status?: string;
+                };
+                return: any;
+            };
+        };
+        void: {
+            /** 作废发票 */
+            post: {
+                body: {
+                    id: string;
+                    reason?: string;
+                };
+                return: any;
+            };
+        };
+        statistics: {
+            /** 获取发票统计数据 */
+            post: {
+                body: {
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        revenueReport: {
+            /** 获取收入报表数据 */
+            post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                    granularity: "day" | "week" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+    };
+    points: {
+        account: {
+            /** 查询用户积分账户余额 */
+            post: {
+                body: {
+                    userId?: string;
+                };
+                return: 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>;
+                };
+                return: any;
+            };
+        };
+        consumeByPrice: {
+            /** 根据计价配置消费积分 */
+            post: {
+                body: {
+                    userId: string;
+                    priceCode: string;
+                    quantity?: number;
+                    requestId?: string;
+                    description?: string;
+                    metadata?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        checkBalance: {
+            /** 检查积分是否足够（不扣费） */
+            post: {
+                body: {
+                    userId: string;
+                    priceCode: string;
+                    quantity?: number;
+                };
+                return: any;
+            };
+        };
+        reversal: {
+            /** 冲正/退还已消费的积分 */
+            post: {
+                body: {
+                    userId: string;
+                    originalTransactionId: string;
+                    requestId?: string;
+                    reason: string;
+                };
+                return: any;
+            };
+        };
+        clawback: {
+            /** 追回/扣回已发放的积分 */
+            post: {
+                body: {
+                    userId: string;
+                    originalTransactionId: string;
+                    requestId?: string;
+                    reason: string;
+                };
+                return: any;
+            };
+        };
+        adjust: {
+            /** 人工调整积分（加/减） */
+            post: {
+                body: {
+                    userId: string;
+                    amount: number;
+                    requestId?: string;
+                    reason: string;
+                    relatedOrderId?: string;
+                };
+                return: any;
+            };
+        };
+        batchAdjust: {
+            /** 批量调整多用户积分 */
+            post: {
+                body: {
+                    userIds: string[];
+                    amount: number;
+                    requestId?: string;
+                    reason: string;
+                };
+                return: any;
+            };
+        };
+        statistics: {
+            /** 获取用户积分统计数据 */
+            post: {
+                body: {
+                    userId?: string;
+                };
+                return: any;
+            };
+        };
+        leaderboard: {
+            /** 获取积分排行榜 */
+            post: {
+                body: {
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+    };
+    pointsHistory: {
+        find: {
+            /** 分页查询积分变动历史 */
+            post: {
+                body: {
+                    userId?: string;
+                    type?: "earn" | "spend" | "reversal" | "clawback" | "adjust";
+                    subType?: string;
+                    page?: number;
+                    pageSize?: number;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询积分历史详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        statistics: {
+            /** 获取积分统计数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    period?: "day" | "week" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        getTrendChart: {
+            /** 获取积分变动趋势图表数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    startTime: string;
+                    endTime: string;
+                    granularity: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        getTypeDistributionChart: {
+            /** 获取积分类型分布图表数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        getRankingChart: {
+            /** 获取用户积分排行榜 */
+            post: {
+                body: {
+                    type?: "earn" | "spend" | "reversal" | "clawback" | "adjust";
+                    startTime?: string;
+                    endTime?: string;
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+    };
+    pointsTrigger: {
+        trigger: {
+            /** 根据规则 ID 触发积分发放 */
+            post: {
+                body: {
+                    ruleId: string;
+                    eventData?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        triggerByEvent: {
+            /** 根据事件自动匹配并触发积分规则 */
+            post: {
+                body: {
+                    event: string;
+                    eventData?: Record<string, unknown>;
+                    userId?: string;
+                };
+                return: any;
+            };
+        };
+        batchTrigger: {
+            /** 批量触发多个积分规则 */
+            post: {
+                body: {
+                    triggers: {
+                        ruleId: string;
+                        eventData?: Record<string, unknown>;
+                    }[];
+                };
+                return: any;
+            };
+        };
+    };
+    pointsTriggerHistory: {
+        find: {
+            /** 分页查询积分触发历史记录 */
+            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;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询积分触发历史详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        statusOptions: {
+            /** 获取积分触发状态下拉选项 */
+            post: {
+                return: any;
+            };
+        };
+        rewardTargetOptions: {
+            /** 获取奖励目标下拉选项 */
+            post: {
+                return: any;
+            };
+        };
+        statistics: {
+            /** 获取积分触发历史统计数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    ruleId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                    period?: "today" | "week" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        trends: {
+            /** 获取积分触发趋势图表数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    ruleId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                    granularity?: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        pointsTrends: {
+            /** 获取积分变动趋势图表数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    ruleId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                    granularity?: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        completionAnalysis: {
+            /** 获取积分规则完成度分析数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    ruleId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        triggerTypeTrends: {
+            /** 获取积分触发类型趋势图表数据 */
+            post: {
+                body: {
+                    userId?: string;
+                    ruleId?: string;
+                    startTime?: string;
+                    endTime?: string;
+                    granularity?: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+    };
+    pointsTriggerRule: {
+        create: {
+            /** 创建新积分触发规则 */
+            post: {
+                body: {
+                    ruleName: string;
+                    ruleCode: string;
+                    description: string;
+                    event?: string;
+                    triggerCondition: unknown;
+                    pointsReward: unknown;
+                    constraints: unknown;
+                    activeTimeRanges: unknown;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询积分触发规则列表 */
+            post: {
+                body: {
+                    current?: number;
+                    pageSize?: number;
+                    where?: {
+                        triggerType?: string;
+                        status?: string;
+                        ruleName?: string;
+                        ruleCode?: string;
+                        event?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询积分触发规则详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新积分触发规则配置 */
+            post: {
+                body: {
+                    id: string;
+                    ruleName?: string;
+                    ruleCode?: string;
+                    description?: string;
+                    event?: string | null;
+                    triggerCondition?: unknown;
+                    pointsReward?: unknown;
+                    constraints?: unknown;
+                    activeTimeRanges?: unknown;
+                };
+                return: any;
+            };
+        };
+        updateStatus: {
+            /** 启用或禁用积分触发规则 */
+            post: {
+                body: {
+                    id: string;
+                    status: "draft" | "active" | "inactive";
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除积分触发规则 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        statusOptions: {
+            /** 获取积分触发规则状态下拉选项 */
+            post: {
+                return: any;
+            };
+        };
+        eventOptions: {
+            /** 获取可绑定的事件类型选项 */
+            post: {
+                return: any;
+            };
+        };
+    };
+    pointsPriceConfig: {
+        create: {
+            /** 创建新的积分计价配置 */
+            post: {
+                body: {
+                    code: string;
+                    name: string;
+                    description?: string;
+                    billingMode: "per_request" | "per_unit";
+                    unitPrice: number;
+                    unit?: string;
+                    minCharge?: number;
+                    status?: "active" | "inactive";
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询计价配置列表 */
+            post: {
+                body: {
+                    where?: {
+                        code?: string;
+                        name?: string;
+                        billingMode?: string;
+                        status?: string;
+                    };
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 或 code 查询计价配置详情 */
+            post: {
+                body: {
+                    id?: string;
+                    code?: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新计价配置 */
+            post: {
+                body: {
+                    id: string;
+                    name?: string;
+                    description?: string;
+                    billingMode?: "per_request" | "per_unit";
+                    unitPrice?: number;
+                    unit?: string;
+                    minCharge?: number;
+                    status?: "active" | "inactive";
+                };
+                return: any;
+            };
+        };
+        updateStatus: {
+            /** 启用或停用计价配置 */
+            post: {
+                body: {
+                    id: string;
+                    status: "active" | "inactive";
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除计价配置 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        billingModeOptions: {
+            /** 获取计费方式下拉选项 */
+            post: {
+                return: any;
+            };
+        };
+    };
+    pointsUsageRecord: {
+        find: {
+            /** 分页查询积分消费记录 */
+            post: {
+                body: {
+                    where?: {
+                        userId?: string;
+                        priceCode?: string;
+                        priceName?: string;
+                        billingMode?: string;
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        statistics: {
+            /** 按维度统计消费数据 */
+            post: {
+                body: {
+                    dimension: "priceCode" | "userId" | "date";
+                    startDate?: string;
+                    endDate?: string;
+                    priceCode?: string;
+                    userId?: string;
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+        overview: {
+            /** 获取消费概览数据 */
+            post: {
+                body: {
+                    startDate?: string;
+                    endDate?: string;
+                };
+                return: any;
+            };
+        };
+    };
+    pointsBalanceAlert: {
+        upsertConfig: {
+            /** 创建或更新预警配置 */
+            post: {
+                body: {
+                    threshold: number;
+                    enabled?: boolean;
+                    notifyEmail?: boolean;
+                    notifyEmails?: string[];
+                    cooldownHours?: number;
+                };
+                return: any;
+            };
+        };
+        getConfig: {
+            /** 获取当前预警配置 */
+            post: {
+                return: any;
+            };
+        };
+        findAlerts: {
+            /** 分页查询预警记录 */
+            post: {
+                body: {
+                    where?: {
+                        userId?: string;
+                        alertType?: string;
+                        startDate?: string;
+                        endDate?: string;
+                    };
+                    page?: number;
+                    pageSize?: number;
+                };
+                return: any;
+            };
+        };
+        triggerCheck: {
+            /** 手动触发预警检查（测试用） */
+            post: {
+                body: {
+                    userId: string;
+                };
+                return: any;
+            };
+        };
+    };
+    notify: {
+        alipay: {
+            /** 支付宝订阅支付回调通知 */
+            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" | "quota" | "unlimited";
+                    value?: boolean | number;
+                    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" | "quota" | "unlimited";
+                    value?: boolean | number;
+                    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 查询产品详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        listActive: {
+            /** 获取定价页面可用产品列表（公开） */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    prices: {
+        create: {
+            /** 创建新价格方案 */
+            post: (body: {
+                productId: string;
+                nickname?: string;
+                type: "one_time" | "recurring";
+                currency: string;
+                unitAmount: number;
+                interval?: "day" | "week" | "month" | "year";
+                intervalCount?: number;
+                trialPeriodDays?: 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;
+                trialPeriodDays?: number;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询价格方案列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    productId?: string;
+                    type?: "" | "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>>;
+        };
+    };
+    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>>;
+        };
+        find: {
+            /** 分页查询订阅列表（管理端） */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    userId?: string;
+                    productId?: string;
+                    status?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    quotas: {
+        create: {
+            /** 创建配额定义 */
+            post: (body: {
+                productId: string;
+                featureKey: string;
+                name: string;
+                description?: string;
+                limit: number;
+                allowOverage?: boolean;
+                pointsCostPerUnit?: 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";
+                allowOverage?: boolean;
+                pointsCostPerUnit?: number;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询配额列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    productId?: string;
+                    featureKey?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        check: {
+            /** 检查用户配额是否足够 */
+            post: (body: {
+                featureKey: string;
+                amount?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        my: {
+            /** 获取当前用户的配额使用情况 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    usageRecords: {
+        record: {
+            /** 记录用户功能使用量 */
+            post: (body: {
+                userId?: string;
+                featureKey: string;
+                quantity?: number;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        recordWithQuotaCheck: {
+            /** 记录使用量并检查配额，支持超额积分扣费 */
+            post: (body: {
+                userId?: string;
+                featureKey: string;
+                quantity?: number;
+                metadata?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        checkQuota: {
+            /** 预检查配额是否足够（不记录使用量） */
+            post: (body: {
+                userId?: string;
+                featureKey: string;
+                quantity?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        batchRecord: {
+            /** 批量记录使用量 */
+            post: (body: {
+                records: {
+                    userId: string;
+                    featureKey: string;
+                    quantity?: number;
+                    metadata?: Record<string, unknown>;
+                    timestamp?: string;
+                }[];
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询使用记录（管理端） */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    userId?: string;
+                    featureKey?: string;
+                    startTime?: string;
+                    endTime?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        my: {
+            /** 查询当前用户的使用记录 */
+            post: (body: {
+                current?: number;
+                pageSize?: number;
+                featureKey?: 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>>;
+        };
+        getTrendChart: {
+            /** 获取使用量趋势图表数据 */
+            post: (body: {
+                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>>;
+        };
+        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>>;
+        };
+    };
+    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>>;
+        };
+        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>>;
+        };
+        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>>;
+        };
+    };
+    pointsTrigger: {
+        trigger: {
+            /** 根据规则 ID 触发积分发放 */
+            post: (body: {
+                ruleId: string;
+                eventData?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        triggerByEvent: {
+            /** 根据事件自动匹配并触发积分规则 */
+            post: (body: {
+                event: string;
+                eventData?: Record<string, unknown>;
+                userId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        batchTrigger: {
+            /** 批量触发多个积分规则 */
+            post: (body: {
+                triggers: {
+                    ruleId: string;
+                    eventData?: Record<string, unknown>;
+                }[];
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    pointsTriggerHistory: {
+        find: {
+            /** 分页查询积分触发历史记录 */
+            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;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询积分触发历史详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statusOptions: {
+            /** 获取积分触发状态下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        rewardTargetOptions: {
+            /** 获取奖励目标下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statistics: {
+            /** 获取积分触发历史统计数据 */
+            post: (body: {
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+                period?: "today" | "week" | "month" | "year";
+            }, 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>>;
+        };
+        pointsTrends: {
+            /** 获取积分变动趋势图表数据 */
+            post: (body: {
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+                granularity?: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        completionAnalysis: {
+            /** 获取积分规则完成度分析数据 */
+            post: (body: {
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        triggerTypeTrends: {
+            /** 获取积分触发类型趋势图表数据 */
+            post: (body: {
+                userId?: string;
+                ruleId?: string;
+                startTime?: string;
+                endTime?: string;
+                granularity?: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    pointsTriggerRule: {
+        create: {
+            /** 创建新积分触发规则 */
+            post: (body: {
+                ruleName: string;
+                ruleCode: string;
+                description: string;
+                event?: string;
+                triggerCondition: unknown;
+                pointsReward: unknown;
+                constraints: unknown;
+                activeTimeRanges: unknown;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询积分触发规则列表 */
+            post: (body: {
+                current?: number;
+                pageSize?: number;
+                where?: {
+                    triggerType?: string;
+                    status?: string;
+                    ruleName?: string;
+                    ruleCode?: string;
+                    event?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询积分触发规则详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新积分触发规则配置 */
+            post: (body: {
+                id: string;
+                ruleName?: string;
+                ruleCode?: string;
+                description?: string;
+                event?: string | null;
+                triggerCondition?: unknown;
+                pointsReward?: unknown;
+                constraints?: unknown;
+                activeTimeRanges?: unknown;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        updateStatus: {
+            /** 启用或禁用积分触发规则 */
+            post: (body: {
+                id: string;
+                status: "draft" | "active" | "inactive";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除积分触发规则 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statusOptions: {
+            /** 获取积分触发规则状态下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        eventOptions: {
+            /** 获取可绑定的事件类型选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    pointsPriceConfig: {
+        create: {
+            /** 创建新的积分计价配置 */
+            post: (body: {
+                code: string;
+                name: string;
+                description?: string;
+                billingMode: "per_request" | "per_unit";
+                unitPrice: number;
+                unit?: string;
+                minCharge?: number;
+                status?: "active" | "inactive";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询计价配置列表 */
+            post: (body: {
+                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;
+                billingMode?: "per_request" | "per_unit";
+                unitPrice?: number;
+                unit?: string;
+                minCharge?: number;
+                status?: "active" | "inactive";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        updateStatus: {
+            /** 启用或停用计价配置 */
+            post: (body: {
+                id: string;
+                status: "active" | "inactive";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除计价配置 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        billingModeOptions: {
+            /** 获取计费方式下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    pointsUsageRecord: {
+        find: {
+            /** 分页查询积分消费记录 */
+            post: (body: {
+                where?: {
+                    userId?: string;
+                    priceCode?: string;
+                    priceName?: string;
+                    billingMode?: string;
+                    startDate?: string;
+                    endDate?: string;
+                };
+                page?: number;
+                pageSize?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statistics: {
+            /** 按维度统计消费数据 */
+            post: (body: {
+                dimension: "priceCode" | "userId" | "date";
+                startDate?: string;
+                endDate?: string;
+                priceCode?: string;
+                userId?: string;
+                limit?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        overview: {
+            /** 获取消费概览数据 */
+            post: (body: {
+                startDate?: string;
+                endDate?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    pointsBalanceAlert: {
+        upsertConfig: {
+            /** 创建或更新预警配置 */
+            post: (body: {
+                threshold: number;
+                enabled?: boolean;
+                notifyEmail?: boolean;
+                notifyEmails?: string[];
+                cooldownHours?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getConfig: {
+            /** 获取当前预警配置 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findAlerts: {
+            /** 分页查询预警记录 */
+            post: (body: {
+                where?: {
+                    userId?: 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>>;
+        };
+    };
+    notify: {
+        alipay: {
+            /** 支付宝订阅支付回调通知 */
+            post: (body: Record<string, unknown>, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+}
+/** API 客户端类型别名（基于 EdenClient 推断，提供完整类型检查） */
+export type ApiClientType = EdenClient<Api>;
+/**
+ * 创建类型安全的 API 客户端
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@vafast/api-client'
+ * import { createApiClient } from './api.generated'
+ *
+ * const client = createClient('/api').use(authMiddleware)
+ * const api = createApiClient(client)
+ *
+ * // 完整的 IDE 智能提示和类型检查
+ * const { data, error } = await api.users.find.post({ current: 1, pageSize: 10 })
+ * // ❌ 错误路径会被 TypeScript 检测到
+ * // api.nonExistent.post() // Error: Property 'nonExistent' does not exist
+ * ```
+ */
+export declare function createApiClient(client: Client): EdenClient<Api>;