@huyooo/ui 0.7.26 → 0.8.0

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

@@ -0,0 +1,2747 @@
+import { ApiResponse, RequestConfig, Client, EdenClient } from '@vafast/api-client';
+/** API 契约类型 */
+export type Api = {
+    health: {
+        /** 检查服务健康状态 */
+        get: {
+            return: any;
+        };
+    };
+    'api-spec': {
+        /** 获取 API 规范，用于类型同步 */
+        get: {
+            return: any;
+        };
+    };
+    apiKeys: {
+        verify: {
+            /** 验证 API Key 有效性 */
+            post: {
+                body: {
+                    apiKeyId: string;
+                    secretKey: string;
+                };
+                return: any;
+            };
+        };
+        create: {
+            /** 创建新的 API Key */
+            post: {
+                body: {
+                    name: string;
+                    description?: string;
+                    expiration: "permanent" | "1h" | "1d" | "7d" | "30d" | "90d" | "180d" | "1y";
+                    permissions?: string[];
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新 API Key 信息 */
+            post: {
+                body: {
+                    id: string;
+                    name: string;
+                    expiration: "permanent" | "1h" | "1d" | "7d" | "30d" | "90d" | "180d" | "1y";
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除 API Key */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询 API Key 列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        id?: string;
+                        name?: string;
+                        expiration?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询 API Key 详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        updateStatus: {
+            /** 启用或禁用 API Key */
+            post: {
+                body: {
+                    apiKeyId: string;
+                    status: "active" | "disabled";
+                };
+                return: any;
+            };
+        };
+        regenerate: {
+            /** 密钥轮换，生成新的 Secret Key */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
+    verify: {
+        jwt: {
+            /** 供其他服务验证用户 JWT 并获取用户信息 */
+            post: {
+                body: {
+                    token: string;
+                    appId?: string;
+                };
+                return: any;
+            };
+        };
+        apiKey: {
+            /** 验证 API Key 有效性 */
+            post: {
+                body: {
+                    apiKeyId: string;
+                    secretKey: string;
+                };
+                return: any;
+            };
+        };
+        email: {
+            /** 验证邮箱验证码 */
+            post: {
+                body: {
+                    userToken: string;
+                    email: string;
+                    emailVerifyId: string;
+                };
+                return: any;
+            };
+            retry: {
+                /** 重新发送邮箱验证码 */
+                post: {
+                    body: {
+                        email: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        sms: {
+            send: {
+                /** 发送短信验证码 */
+                post: {
+                    body: {
+                        phone: string;
+                    };
+                    return: any;
+                };
+            };
+            verify: {
+                /** 验证短信验证码 */
+                post: {
+                    body: {
+                        phone: string;
+                        code: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        password: {
+            /** 验证用户密码 */
+            post: {
+                body: {
+                    password: string;
+                };
+                return: any;
+            };
+        };
+    };
+    users: {
+        batch: {
+            /** 根据 ID 列表批量查询用户 */
+            post: {
+                body: {
+                    userIds: string[];
+                    appId?: string;
+                };
+                return: any;
+            };
+        };
+        subscription: {
+            /** 供 billing-server 更新用户的订阅信息和权益 */
+            post: {
+                body: {
+                    userId: string;
+                    appId: string;
+                    subscriptionId?: string | null;
+                    subscriptionStatus?: string | null;
+                    entitlements?: Record<string, unknown>;
+                };
+                return: any;
+            };
+        };
+        search: {
+            /** 供其他服务按昵称/邮箱/手机号搜索用户 */
+            post: {
+                body: {
+                    appId: string;
+                    keyword: string;
+                    limit?: number;
+                };
+                return: any;
+            };
+        };
+        stats: {
+            /** 供其他服务获取用户数量统计 */
+            post: {
+                body: {
+                    appId?: string;
+                    appIds?: string[];
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        trend: {
+            /** 供 analytics 服务获取用户增长趋势 */
+            post: {
+                body: {
+                    appId: string;
+                    startTime: string;
+                    endTime: string;
+                    granularity: "hour" | "day" | "month";
+                };
+                return: any;
+            };
+        };
+        organizations: {
+            /** 供 ones-server 更新用户的组织列表 */
+            post: {
+                body: {
+                    userId: string;
+                    action: "add" | "remove";
+                    organizationId: string;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 管理员删除用户账号 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 管理员更新用户信息 */
+            post: {
+                body: {
+                    id: string;
+                    phone: string;
+                    roleId: string;
+                    email: string;
+                    status: "normal" | "forbidden";
+                };
+                return: any;
+            };
+            phone: {
+                /** 管理员更新用户手机号 */
+                post: {
+                    body: {
+                        id: string;
+                        phone: string;
+                    };
+                    return: any;
+                };
+            };
+            status: {
+                /** 管理员更新用户启用状态 */
+                post: {
+                    body: {
+                        id: string;
+                        status: "normal" | "forbidden";
+                    };
+                    return: any;
+                };
+            };
+            baseInfo: {
+                /** 管理员更新用户基本信息 */
+                post: {
+                    body: {
+                        id: string;
+                        avatar?: string;
+                        nickname?: string;
+                        description?: string;
+                        roleId?: string;
+                    };
+                    return: any;
+                };
+            };
+            email: {
+                /** 用户更新自己的邮箱 */
+                post: {
+                    body: {
+                        userToken: string;
+                        emailVerifyId: string;
+                        email: string;
+                        password: string;
+                    };
+                    return: any;
+                };
+            };
+            password: {
+                /** 用户更新自己的密码 */
+                post: {
+                    body: {
+                        password: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        deleteAccount: {
+            /** 用户主动注销自己的账号 */
+            post: {
+                body: {
+                    password: string;
+                    userToken: string;
+                    emailVerifyId: string;
+                    confirmText?: string;
+                };
+                return: any;
+            };
+        };
+        unbind: {
+            email: {
+                /** 用户解绑自己的邮箱 */
+                post: {
+                    return: any;
+                };
+            };
+        };
+        profile: {
+            /** 用户更新自己的个人资料 */
+            post: {
+                return: any;
+            };
+        };
+        me: {
+            /** 获取当前登录用户的信息 */
+            get: {
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询用户列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        id?: string;
+                        email?: string;
+                        phone?: string;
+                        status?: "normal" | "forbidden";
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询用户详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        getUsers: {
+            /** 根据 ID 列表批量获取用户 */
+            post: {
+                body: {
+                    userIds: string[];
+                };
+                return: any;
+            };
+        };
+        'with-points': {
+            /** 查询用户详情含积分信息 */
+            post: {
+                body: {
+                    userId: string;
+                    appId: string;
+                };
+                return: any;
+            };
+        };
+        'referral-tree': {
+            /** 查询用户推荐关系树 */
+            post: {
+                body: {
+                    userId: string;
+                    appId: string;
+                    depth?: number;
+                };
+                return: any;
+            };
+        };
+        'activity-analysis': {
+            /** 分析用户活跃度 */
+            post: {
+                body: {
+                    userId: string;
+                    appId: string;
+                    days?: number;
+                };
+                return: any;
+            };
+        };
+        'batch-stats': {
+            /** 批量获取用户统计数据 */
+            post: {
+                body: {
+                    userIds: string[];
+                    appId: string;
+                };
+                return: any;
+            };
+        };
+        export: {
+            points: {
+                /** 导出用户积分报告 */
+                post: {
+                    body: {
+                        appId: string;
+                        startDate?: string;
+                        endDate?: string;
+                        format?: "json" | "csv";
+                    };
+                    return: any;
+                };
+            };
+            activity: {
+                /** 导出用户活跃度报告 */
+                post: {
+                    body: {
+                        appId: string;
+                        days?: number;
+                        format?: "json" | "csv";
+                    };
+                    return: any;
+                };
+            };
+            referral: {
+                /** 导出用户推荐关系报告 */
+                post: {
+                    body: {
+                        appId: string;
+                        format?: "json" | "csv";
+                    };
+                    return: any;
+                };
+            };
+        };
+        sync: {
+            /** 获取待同步的用户数据 */
+            post: {
+                body: {
+                    lastSyncTime?: string;
+                    limit?: number;
+                    appId?: string;
+                };
+                return: any;
+            };
+        };
+        events: {
+            /** 获取用户数据变更事件 */
+            post: {
+                body: {
+                    since: string;
+                    appId?: string;
+                };
+                return: any;
+            };
+        };
+        statistics: {
+            /** 获取用户整体统计数据 */
+            post: {
+                body: {
+                    appId?: string;
+                };
+                return: any;
+            };
+        };
+    };
+    oauth: {
+        github: {
+            login: {
+                /** 跳转到 GitHub 授权登录 */
+                get: {
+                    query: {
+                        appId: string;
+                        referrerId?: string;
+                        redirectUri?: string;
+                    };
+                    return: any;
+                };
+            };
+            callback: {
+                /** GitHub 授权回调 */
+                get: {
+                    query: {
+                        code: string;
+                        state: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        google: {
+            login: {
+                /** 跳转到 Google 授权登录 */
+                get: {
+                    query: {
+                        appId: string;
+                        referrerId?: string;
+                        redirectUri?: string;
+                    };
+                    return: any;
+                };
+            };
+            callback: {
+                /** Google 授权回调 */
+                get: {
+                    query: {
+                        code: string;
+                        state: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        microsoft: {
+            login: {
+                /** 跳转到 Microsoft 授权登录 */
+                get: {
+                    query: {
+                        appId: string;
+                        referrerId?: string;
+                        redirectUri?: string;
+                    };
+                    return: any;
+                };
+            };
+            callback: {
+                /** Microsoft 授权回调 */
+                get: {
+                    query: {
+                        code: string;
+                        state: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
+    oauth2: {
+        authorize: {
+            /** 获取 OAuth2 授权码 */
+            post: {
+                body: {
+                    client_id: string;
+                    redirect_uri: string;
+                    scope: string;
+                    state: string;
+                    response_type: "code" | "token";
+                };
+                return: any;
+            };
+        };
+        token: {
+            /** 使用授权码获取访问令牌 */
+            post: {
+                body: {
+                    grant_type: string;
+                    code: string;
+                    redirect_uri: string;
+                    client_id: string;
+                    client_secret?: string;
+                };
+                return: any;
+            };
+        };
+        refresh: {
+            /** 刷新访问令牌 */
+            post: {
+                body: {
+                    refresh_token: string;
+                    client_id: string;
+                };
+                return: any;
+            };
+        };
+        revoke: {
+            /** 撤销访问令牌 */
+            post: {
+                body: {
+                    token: string;
+                    client_id: string;
+                };
+                return: any;
+            };
+        };
+    };
+    auth: {
+        signIn: {
+            /** 用户通过邮箱和密码登录 */
+            post: {
+                body: {
+                    email: string;
+                    password: string;
+                };
+                return: any;
+            };
+            unified: {
+                /** 用户通过邮箱/手机号登录（自动识别） */
+                post: {
+                    body: {
+                        identifier: string;
+                        password?: string;
+                        code?: string;
+                        method: "password" | "code";
+                    };
+                    return: any;
+                };
+            };
+        };
+        signUp: {
+            /** 用户通过邮箱注册账号 */
+            post: {
+                body: {
+                    email: string;
+                    password: string;
+                    referrerId?: string;
+                    userToken: string;
+                    emailVerifyId: string;
+                };
+                return: any;
+            };
+            phone: {
+                /** 用户通过手机号注册账号 */
+                post: {
+                    body: {
+                        phone: string;
+                        code: string;
+                        password?: string;
+                        referrerId?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        refresh: {
+            /** 使用 refreshToken 刷新 JWT */
+            post: {
+                body: {
+                    refreshToken: string;
+                };
+                return: any;
+            };
+        };
+        signOut: {
+            /** 用户主动登出当前会话 */
+            post: {
+                return: any;
+            };
+        };
+        logout: {
+            /** 登出指定设备的会话 */
+            post: {
+                return: any;
+            };
+        };
+        logoutAll: {
+            /** 登出所有设备的会话 */
+            post: {
+                return: any;
+            };
+        };
+        sessions: {
+            /** 获取用户所有登录会话 */
+            get: {
+                return: any;
+            };
+            cleanup: {
+                /** 清理用户过期的会话 */
+                post: {
+                    return: any;
+                };
+            };
+            ':id': {
+                revoke: {
+                    /** 撤销指定的登录会话 */
+                    post: {
+                        params: {
+                            sessionId: string;
+                        };
+                        return: any;
+                    };
+                };
+            };
+        };
+        passwordVerify: {
+            /** 验证用户当前密码 */
+            post: {
+                body: {
+                    password: string;
+                };
+                return: any;
+            };
+        };
+        resetPassword: {
+            /** 用户通过验证码重置密码 */
+            post: {
+                body: {
+                    userToken: string;
+                    emailVerifyId: string;
+                    email: string;
+                    password: string;
+                };
+                return: any;
+            };
+        };
+        verify: {
+            token: {
+                /** 验证 JWT Token 有效性 */
+                post: {
+                    body: {
+                        token: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        bind: {
+            email: {
+                /** 用户绑定邮箱地址 */
+                post: {
+                    body: {
+                        email: string;
+                        userToken: string;
+                        emailVerifyId: string;
+                    };
+                    return: any;
+                };
+            };
+            phone: {
+                /** 用户绑定手机号 */
+                post: {
+                    body: {
+                        phone: string;
+                        code: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+    };
+    passkey: {
+        auth: {
+            options: {
+                /** 获取 Passkey 登录认证选项 */
+                post: {
+                    body: {
+                        email?: string;
+                    };
+                    return: any;
+                };
+            };
+            verify: {
+                /** 用户通过 Passkey 无密码登录 */
+                post: {
+                    body: {
+                        response: unknown;
+                    };
+                    return: any;
+                };
+            };
+        };
+        register: {
+            options: {
+                /** 获取 Passkey 注册选项 */
+                post: {
+                    return: any;
+                };
+            };
+            verify: {
+                /** 用户注册新的 Passkey 凭证 */
+                post: {
+                    body: {
+                        response: unknown;
+                        name?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        list: {
+            /** 获取用户已注册的 Passkey 列表 */
+            post: {
+                return: any;
+            };
+        };
+        delete: {
+            /** 用户删除 Passkey 凭证 */
+            post: {
+                body: {
+                    credentialId: string;
+                };
+                return: any;
+            };
+        };
+        rename: {
+            /** 修改 Passkey 名称 */
+            post: {
+                body: {
+                    credentialId: string;
+                    name: string;
+                };
+                return: any;
+            };
+        };
+    };
+    apps: {
+        authPageInfo: {
+            /** 获取应用认证页面配置信息 */
+            post: {
+                return: any;
+            };
+        };
+        create: {
+            /** 创建新应用 */
+            post: {
+                body: {
+                    appKey: string;
+                    name: string;
+                    homePageUrl?: string;
+                    authorizationCallback?: string;
+                    applicationLogo?: string;
+                    description?: string;
+                    extensions?: Record<string, string>;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除应用 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新应用信息 */
+            post: {
+                body: {
+                    id: string;
+                    appKey?: string;
+                    name?: string;
+                    homePageUrl?: string;
+                    authorizationCallback?: string;
+                    applicationLogo?: string;
+                    description?: string;
+                    defaultRoleId?: string;
+                };
+                return: any;
+            };
+            emailConfig: {
+                /** 更新应用邮件发送配置 */
+                post: {
+                    body: {
+                        supportEmail?: string;
+                    };
+                    return: any;
+                };
+            };
+            brand: {
+                /** 更新应用品牌展示配置 */
+                post: {
+                    body: {
+                        theme: "dark" | "light";
+                        logo: string;
+                        favicon: string;
+                        backgroundType: "color" | "image";
+                        backgroundImage: string;
+                        backgroundColor: string;
+                    };
+                    return: any;
+                };
+            };
+            emailAuth: {
+                /** 更新邮箱认证相关配置 */
+                post: {
+                    body: {
+                        enabled: boolean;
+                        confirmEmail: boolean;
+                        expiration: number;
+                    };
+                    return: any;
+                };
+            };
+            passwordAuth: {
+                /** 更新密码认证相关配置 */
+                post: {
+                    body: {
+                        minPasswordComplexity: number;
+                        rejectBreachedPasswords: boolean;
+                    };
+                    return: any;
+                };
+            };
+            sessionsAuth: {
+                /** 更新登录会话相关配置 */
+                post: {
+                    body: {
+                        maximumSessionLength: number;
+                        accessTokenDuration: number;
+                        maximumSessionLengthUnit: string;
+                        accessTokenDurationUnit: string;
+                    };
+                    return: any;
+                };
+            };
+            signUpAuth: {
+                /** 更新用户注册相关配置 */
+                post: {
+                    body: {
+                        enabled: boolean;
+                    };
+                    return: any;
+                };
+            };
+            singleSignOn: {
+                /** 更新单点登录 (SSO) 配置 */
+                post: {
+                    body: {
+                        enabled: boolean;
+                    };
+                    return: any;
+                };
+            };
+            oauth: {
+                /** 更新第三方 OAuth 登录配置 */
+                post: {
+                    body: {
+                        type: "google" | "microsoft" | "github" | "wechat";
+                        enabled: boolean;
+                    };
+                    return: any;
+                };
+            };
+            aboutUs: {
+                personalInformationCollectionList: {
+                    /** 更新个人信息收集清单配置 */
+                    post: {
+                        body: {
+                            value: {
+                                type: "doc";
+                                content: unknown[];
+                            };
+                        };
+                        return: any;
+                    };
+                };
+                thirdPartyInformationSharingList: {
+                    /** 更新第三方信息共享清单配置 */
+                    post: {
+                        body: {
+                            value: {
+                                type: "doc";
+                                content: unknown[];
+                            };
+                        };
+                        return: any;
+                    };
+                };
+                userServiceAgreement: {
+                    /** 更新用户服务协议配置 */
+                    post: {
+                        body: {
+                            value: {
+                                type: "doc";
+                                content: unknown[];
+                            };
+                        };
+                        return: any;
+                    };
+                };
+                privacyPolicy: {
+                    /** 更新隐私政策配置 */
+                    post: {
+                        body: {
+                            value: {
+                                type: "doc";
+                                content: unknown[];
+                            };
+                        };
+                        return: any;
+                    };
+                };
+                licenseInformation: {
+                    /** 更新许可信息配置 */
+                    post: {
+                        body: {
+                            value: {
+                                type: "doc";
+                                content: unknown[];
+                            };
+                        };
+                        return: any;
+                    };
+                };
+            };
+        };
+        find: {
+            /** 分页查询应用列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        id?: string;
+                        appKey?: string;
+                        name?: string;
+                        homePageUrl?: string;
+                        extensions?: Record<string, string>;
+                    };
+                };
+                return: any;
+            };
+        };
+        findAll: {
+            /** 查询用户所有应用 */
+            post: {
+                body: {
+                    where: {
+                        id?: string;
+                        appKey?: string;
+                        name?: string;
+                        homePageUrl?: string;
+                        extensions?: Record<string, string>;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询应用详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        findByIds: {
+            /** 根据 ID 列表批量查询应用 */
+            post: {
+                body: {
+                    ids: string[];
+                };
+                return: any;
+            };
+        };
+        emailConfigInfo: {
+            /** 获取应用邮件配置信息 */
+            post: {
+                return: any;
+            };
+        };
+    };
+    roles: {
+        create: {
+            /** 创建新角色 */
+            post: {
+                body: {
+                    name: string;
+                    roleKey: string;
+                    permissions?: string[];
+                    description: string;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除角色 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新角色信息 */
+            post: {
+                body: {
+                    id: string;
+                    name: string;
+                    roleKey: string;
+                    permissions?: string[];
+                    description: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询角色列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        name?: string;
+                        roleKey?: string;
+                        description?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询角色详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            /** 获取角色下拉选项 */
+            post: {
+                return: any;
+            };
+        };
+    };
+    permissions: {
+        create: {
+            /** 创建新权限 */
+            post: {
+                body: {
+                    name: string;
+                    permissionKey: string;
+                    description: string;
+                    isPublic: boolean;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除权限 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新权限信息 */
+            post: {
+                body: {
+                    id: string;
+                    name: string;
+                    permissionKey: string;
+                    description: string;
+                    isPublic: boolean;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询权限列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        name?: string;
+                        permissionKey?: string;
+                        description?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询权限详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            /** 获取权限下拉选项 */
+            post: {
+                body: {
+                    excludePublic?: boolean;
+                };
+                return: any;
+            };
+        };
+    };
+    referrer: {
+        find: {
+            /** 分页查询推荐人列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        referrerId?: string;
+                        referrerEmail?: string;
+                        referrerPhone?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询推荐人详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        referees: {
+            /** 查询推荐人邀请的用户列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除推荐记录 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        getReferrerStatistics: {
+            /** 获取推荐统计数据 */
+            post: {
+                return: any;
+            };
+        };
+        getReferralCountChart: {
+            /** 获取推荐数量趋势图表 */
+            post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                    granularity: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        getReferralConversionChart: {
+            /** 获取推荐转化率趋势图表 */
+            post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                    granularity: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        getAvgReferralsChart: {
+            /** 获取平均推荐数趋势图表 */
+            post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                    granularity: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        getReferralOrderAmountChart: {
+            /** 获取推荐订单金额趋势图表 */
+            post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                    granularity: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+        getReferralOrderCountChart: {
+            /** 获取推荐订单数量趋势图表 */
+            post: {
+                body: {
+                    startTime: string;
+                    endTime: string;
+                    granularity: "minute" | "hour" | "day" | "month" | "year";
+                };
+                return: any;
+            };
+        };
+    };
+    authLogs: {
+        list: {
+            /** 分页获取认证审计日志列表 */
+            post: {
+                body: {
+                    page?: number;
+                    pageSize?: number;
+                    userId?: string;
+                    event?: string;
+                    method?: string;
+                    success?: boolean;
+                    startTime?: string;
+                    endTime?: string;
+                    clientIp?: string;
+                    email?: string;
+                };
+                return: any;
+            };
+        };
+        stats: {
+            /** 获取认证审计日志统计数据 */
+            post: {
+                body: {
+                    startTime?: string;
+                    endTime?: string;
+                };
+                return: any;
+            };
+        };
+        ':id': {
+            /** 根据 ID 获取认证审计日志详情 */
+            get: {
+                params: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+    };
+    inviteCodes: {
+        create: {
+            /** 创建新邀请码 */
+            post: {
+                body: {
+                    name: string;
+                    type: "personal" | "channel" | "campaign";
+                    channel?: string;
+                    maxUses?: number;
+                    expiresAt?: string;
+                    description?: string;
+                };
+                return: any;
+            };
+        };
+        delete: {
+            /** 删除邀请码 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        update: {
+            /** 更新邀请码信息 */
+            post: {
+                body: {
+                    id: string;
+                    name: string;
+                    channel?: string;
+                    maxUses?: number;
+                    expiresAt?: string;
+                    status: "active" | "inactive" | "expired";
+                    description?: string;
+                };
+                return: any;
+            };
+        };
+        find: {
+            /** 分页查询邀请码列表 */
+            post: {
+                body: {
+                    current: number;
+                    pageSize: number;
+                    where: {
+                        name?: string;
+                        code?: string;
+                        type?: string;
+                        channel?: string;
+                        status?: string;
+                    };
+                };
+                return: any;
+            };
+        };
+        findOne: {
+            /** 根据 ID 查询邀请码详情 */
+            post: {
+                body: {
+                    id: string;
+                };
+                return: any;
+            };
+        };
+        validate: {
+            /** 验证邀请码是否有效 */
+            post: {
+                body: {
+                    code: string;
+                };
+                return: any;
+            };
+        };
+        options: {
+            type: {
+                /** 获取邀请码类型下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+            status: {
+                /** 获取邀请码状态下拉选项 */
+                post: {
+                    return: any;
+                };
+            };
+        };
+    };
+    security: {
+        ip: {
+            list: {
+                /** 获取 IP 黑白名单规则列表 */
+                post: {
+                    body: {
+                        appId?: string;
+                        type?: "whitelist" | "blacklist";
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+            add: {
+                /** 添加 IP 黑白名单规则 */
+                post: {
+                    body: {
+                        appId?: string;
+                        ip: string;
+                        type: "whitelist" | "blacklist";
+                        reason?: string;
+                        expiresInMinutes?: number;
+                    };
+                    return: any;
+                };
+            };
+            remove: {
+                /** 删除 IP 黑白名单规则 */
+                post: {
+                    body: {
+                        id: string;
+                    };
+                    return: any;
+                };
+            };
+            block: {
+                /** 将 IP 加入黑名单 */
+                post: {
+                    body: {
+                        ip: string;
+                        reason: string;
+                        durationMinutes?: number;
+                        appId?: string;
+                    };
+                    return: any;
+                };
+            };
+            unblock: {
+                /** 将 IP 从黑名单移除 */
+                post: {
+                    body: {
+                        ip: string;
+                        appId?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        alerts: {
+            list: {
+                /** 获取可疑登录告警列表 */
+                post: {
+                    body: {
+                        appId?: string;
+                        type?: string;
+                        riskLevel?: "low" | "medium" | "high" | "critical";
+                        resolved?: boolean;
+                        page?: number;
+                        pageSize?: number;
+                    };
+                    return: any;
+                };
+            };
+            resolve: {
+                /** 标记安全告警为已处理 */
+                post: {
+                    body: {
+                        alertId: string;
+                    };
+                    return: any;
+                };
+            };
+            stats: {
+                /** 获取安全告警统计数据 */
+                post: {
+                    body: {
+                        appId?: string;
+                    };
+                    return: any;
+                };
+            };
+        };
+        detection: {
+            config: {
+                /** 获取可疑登录检测配置 */
+                get: {
+                    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>>;
+    };
+    apiKeys: {
+        verify: {
+            /** 验证 API Key 有效性 */
+            post: (body: {
+                apiKeyId: string;
+                secretKey: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        create: {
+            /** 创建新的 API Key */
+            post: (body: {
+                name: string;
+                description?: string;
+                expiration: "permanent" | "1h" | "1d" | "7d" | "30d" | "90d" | "180d" | "1y";
+                permissions?: string[];
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新 API Key 信息 */
+            post: (body: {
+                id: string;
+                name: string;
+                expiration: "permanent" | "1h" | "1d" | "7d" | "30d" | "90d" | "180d" | "1y";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除 API Key */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询 API Key 列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    id?: string;
+                    name?: string;
+                    expiration?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询 API Key 详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        updateStatus: {
+            /** 启用或禁用 API Key */
+            post: (body: {
+                apiKeyId: string;
+                status: "active" | "disabled";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        regenerate: {
+            /** 密钥轮换，生成新的 Secret Key */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    verify: {
+        jwt: {
+            /** 供其他服务验证用户 JWT 并获取用户信息 */
+            post: (body: {
+                token: string;
+                appId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        apiKey: {
+            /** 验证 API Key 有效性 */
+            post: (body: {
+                apiKeyId: string;
+                secretKey: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        email: {
+            /** 验证邮箱验证码 */
+            post: (body: {
+                userToken: string;
+                email: string;
+                emailVerifyId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            retry: {
+                /** 重新发送邮箱验证码 */
+                post: (body: {
+                    email: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        sms: {
+            send: {
+                /** 发送短信验证码 */
+                post: (body: {
+                    phone: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            verify: {
+                /** 验证短信验证码 */
+                post: (body: {
+                    phone: string;
+                    code: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        password: {
+            /** 验证用户密码 */
+            post: (body: {
+                password: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    users: {
+        batch: {
+            /** 根据 ID 列表批量查询用户 */
+            post: (body: {
+                userIds: string[];
+                appId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        subscription: {
+            /** 供 billing-server 更新用户的订阅信息和权益 */
+            post: (body: {
+                userId: string;
+                appId: string;
+                subscriptionId?: string | null;
+                subscriptionStatus?: string | null;
+                entitlements?: Record<string, unknown>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        search: {
+            /** 供其他服务按昵称/邮箱/手机号搜索用户 */
+            post: (body: {
+                appId: string;
+                keyword: string;
+                limit?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        stats: {
+            /** 供其他服务获取用户数量统计 */
+            post: (body: {
+                appId?: string;
+                appIds?: string[];
+                startTime?: string;
+                endTime?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        trend: {
+            /** 供 analytics 服务获取用户增长趋势 */
+            post: (body: {
+                appId: string;
+                startTime: string;
+                endTime: string;
+                granularity: "hour" | "day" | "month";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        organizations: {
+            /** 供 ones-server 更新用户的组织列表 */
+            post: (body: {
+                userId: string;
+                action: "add" | "remove";
+                organizationId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 管理员删除用户账号 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 管理员更新用户信息 */
+            post: (body: {
+                id: string;
+                phone: string;
+                roleId: string;
+                email: string;
+                status: "normal" | "forbidden";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            phone: {
+                /** 管理员更新用户手机号 */
+                post: (body: {
+                    id: string;
+                    phone: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            status: {
+                /** 管理员更新用户启用状态 */
+                post: (body: {
+                    id: string;
+                    status: "normal" | "forbidden";
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            baseInfo: {
+                /** 管理员更新用户基本信息 */
+                post: (body: {
+                    id: string;
+                    avatar?: string;
+                    nickname?: string;
+                    description?: string;
+                    roleId?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            email: {
+                /** 用户更新自己的邮箱 */
+                post: (body: {
+                    userToken: string;
+                    emailVerifyId: string;
+                    email: string;
+                    password: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            password: {
+                /** 用户更新自己的密码 */
+                post: (body: {
+                    password: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        deleteAccount: {
+            /** 用户主动注销自己的账号 */
+            post: (body: {
+                password: string;
+                userToken: string;
+                emailVerifyId: string;
+                confirmText?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        unbind: {
+            email: {
+                /** 用户解绑自己的邮箱 */
+                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        profile: {
+            /** 用户更新自己的个人资料 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        me: {
+            /** 获取当前登录用户的信息 */
+            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询用户列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    id?: string;
+                    email?: string;
+                    phone?: string;
+                    status?: "normal" | "forbidden";
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询用户详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getUsers: {
+            /** 根据 ID 列表批量获取用户 */
+            post: (body: {
+                userIds: string[];
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        'with-points': {
+            /** 查询用户详情含积分信息 */
+            post: (body: {
+                userId: string;
+                appId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        'referral-tree': {
+            /** 查询用户推荐关系树 */
+            post: (body: {
+                userId: string;
+                appId: string;
+                depth?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        'activity-analysis': {
+            /** 分析用户活跃度 */
+            post: (body: {
+                userId: string;
+                appId: string;
+                days?: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        'batch-stats': {
+            /** 批量获取用户统计数据 */
+            post: (body: {
+                userIds: string[];
+                appId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        export: {
+            points: {
+                /** 导出用户积分报告 */
+                post: (body: {
+                    appId: string;
+                    startDate?: string;
+                    endDate?: string;
+                    format?: "json" | "csv";
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            activity: {
+                /** 导出用户活跃度报告 */
+                post: (body: {
+                    appId: string;
+                    days?: number;
+                    format?: "json" | "csv";
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            referral: {
+                /** 导出用户推荐关系报告 */
+                post: (body: {
+                    appId: string;
+                    format?: "json" | "csv";
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        sync: {
+            /** 获取待同步的用户数据 */
+            post: (body: {
+                lastSyncTime?: string;
+                limit?: number;
+                appId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        events: {
+            /** 获取用户数据变更事件 */
+            post: (body: {
+                since: string;
+                appId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        statistics: {
+            /** 获取用户整体统计数据 */
+            post: (body: {
+                appId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    oauth: {
+        github: {
+            login: {
+                /** 跳转到 GitHub 授权登录 */
+                get: (query?: {
+                    appId: string;
+                    referrerId?: string;
+                    redirectUri?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            callback: {
+                /** GitHub 授权回调 */
+                get: (query?: {
+                    code: string;
+                    state: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        google: {
+            login: {
+                /** 跳转到 Google 授权登录 */
+                get: (query?: {
+                    appId: string;
+                    referrerId?: string;
+                    redirectUri?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            callback: {
+                /** Google 授权回调 */
+                get: (query?: {
+                    code: string;
+                    state: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        microsoft: {
+            login: {
+                /** 跳转到 Microsoft 授权登录 */
+                get: (query?: {
+                    appId: string;
+                    referrerId?: string;
+                    redirectUri?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            callback: {
+                /** Microsoft 授权回调 */
+                get: (query?: {
+                    code: string;
+                    state: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+    };
+    oauth2: {
+        authorize: {
+            /** 获取 OAuth2 授权码 */
+            post: (body: {
+                client_id: string;
+                redirect_uri: string;
+                scope: string;
+                state: string;
+                response_type: "code" | "token";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        token: {
+            /** 使用授权码获取访问令牌 */
+            post: (body: {
+                grant_type: string;
+                code: string;
+                redirect_uri: string;
+                client_id: string;
+                client_secret?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        refresh: {
+            /** 刷新访问令牌 */
+            post: (body: {
+                refresh_token: string;
+                client_id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        revoke: {
+            /** 撤销访问令牌 */
+            post: (body: {
+                token: string;
+                client_id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    auth: {
+        signIn: {
+            /** 用户通过邮箱和密码登录 */
+            post: (body: {
+                email: string;
+                password: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            unified: {
+                /** 用户通过邮箱/手机号登录（自动识别） */
+                post: (body: {
+                    identifier: string;
+                    password?: string;
+                    code?: string;
+                    method: "password" | "code";
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        signUp: {
+            /** 用户通过邮箱注册账号 */
+            post: (body: {
+                email: string;
+                password: string;
+                referrerId?: string;
+                userToken: string;
+                emailVerifyId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            phone: {
+                /** 用户通过手机号注册账号 */
+                post: (body: {
+                    phone: string;
+                    code: string;
+                    password?: string;
+                    referrerId?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        refresh: {
+            /** 使用 refreshToken 刷新 JWT */
+            post: (body: {
+                refreshToken: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        signOut: {
+            /** 用户主动登出当前会话 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        logout: {
+            /** 登出指定设备的会话 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        logoutAll: {
+            /** 登出所有设备的会话 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        sessions: {
+            /** 获取用户所有登录会话 */
+            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            cleanup: {
+                /** 清理用户过期的会话 */
+                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            ':id': {
+                revoke: {
+                    /** 撤销指定的登录会话 */
+                    post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+                };
+            };
+        };
+        passwordVerify: {
+            /** 验证用户当前密码 */
+            post: (body: {
+                password: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        resetPassword: {
+            /** 用户通过验证码重置密码 */
+            post: (body: {
+                userToken: string;
+                emailVerifyId: string;
+                email: string;
+                password: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        verify: {
+            token: {
+                /** 验证 JWT Token 有效性 */
+                post: (body: {
+                    token: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        bind: {
+            email: {
+                /** 用户绑定邮箱地址 */
+                post: (body: {
+                    email: string;
+                    userToken: string;
+                    emailVerifyId: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            phone: {
+                /** 用户绑定手机号 */
+                post: (body: {
+                    phone: string;
+                    code: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+    };
+    passkey: {
+        auth: {
+            options: {
+                /** 获取 Passkey 登录认证选项 */
+                post: (body: {
+                    email?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            verify: {
+                /** 用户通过 Passkey 无密码登录 */
+                post: (body: {
+                    response: unknown;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        register: {
+            options: {
+                /** 获取 Passkey 注册选项 */
+                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            verify: {
+                /** 用户注册新的 Passkey 凭证 */
+                post: (body: {
+                    response: unknown;
+                    name?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        list: {
+            /** 获取用户已注册的 Passkey 列表 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 用户删除 Passkey 凭证 */
+            post: (body: {
+                credentialId: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        rename: {
+            /** 修改 Passkey 名称 */
+            post: (body: {
+                credentialId: string;
+                name: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    apps: {
+        authPageInfo: {
+            /** 获取应用认证页面配置信息 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        create: {
+            /** 创建新应用 */
+            post: (body: {
+                appKey: string;
+                name: string;
+                homePageUrl?: string;
+                authorizationCallback?: string;
+                applicationLogo?: string;
+                description?: string;
+                extensions?: Record<string, string>;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除应用 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新应用信息 */
+            post: (body: {
+                id: string;
+                appKey?: string;
+                name?: string;
+                homePageUrl?: string;
+                authorizationCallback?: string;
+                applicationLogo?: string;
+                description?: string;
+                defaultRoleId?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            emailConfig: {
+                /** 更新应用邮件发送配置 */
+                post: (body: {
+                    supportEmail?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            brand: {
+                /** 更新应用品牌展示配置 */
+                post: (body: {
+                    theme: "dark" | "light";
+                    logo: string;
+                    favicon: string;
+                    backgroundType: "color" | "image";
+                    backgroundImage: string;
+                    backgroundColor: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            emailAuth: {
+                /** 更新邮箱认证相关配置 */
+                post: (body: {
+                    enabled: boolean;
+                    confirmEmail: boolean;
+                    expiration: number;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            passwordAuth: {
+                /** 更新密码认证相关配置 */
+                post: (body: {
+                    minPasswordComplexity: number;
+                    rejectBreachedPasswords: boolean;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            sessionsAuth: {
+                /** 更新登录会话相关配置 */
+                post: (body: {
+                    maximumSessionLength: number;
+                    accessTokenDuration: number;
+                    maximumSessionLengthUnit: string;
+                    accessTokenDurationUnit: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            signUpAuth: {
+                /** 更新用户注册相关配置 */
+                post: (body: {
+                    enabled: boolean;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            singleSignOn: {
+                /** 更新单点登录 (SSO) 配置 */
+                post: (body: {
+                    enabled: boolean;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            oauth: {
+                /** 更新第三方 OAuth 登录配置 */
+                post: (body: {
+                    type: "google" | "microsoft" | "github" | "wechat";
+                    enabled: boolean;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            aboutUs: {
+                personalInformationCollectionList: {
+                    /** 更新个人信息收集清单配置 */
+                    post: (body: {
+                        value: {
+                            type: "doc";
+                            content: unknown[];
+                        };
+                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                };
+                thirdPartyInformationSharingList: {
+                    /** 更新第三方信息共享清单配置 */
+                    post: (body: {
+                        value: {
+                            type: "doc";
+                            content: unknown[];
+                        };
+                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                };
+                userServiceAgreement: {
+                    /** 更新用户服务协议配置 */
+                    post: (body: {
+                        value: {
+                            type: "doc";
+                            content: unknown[];
+                        };
+                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                };
+                privacyPolicy: {
+                    /** 更新隐私政策配置 */
+                    post: (body: {
+                        value: {
+                            type: "doc";
+                            content: unknown[];
+                        };
+                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                };
+                licenseInformation: {
+                    /** 更新许可信息配置 */
+                    post: (body: {
+                        value: {
+                            type: "doc";
+                            content: unknown[];
+                        };
+                    }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+                };
+            };
+        };
+        find: {
+            /** 分页查询应用列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    id?: string;
+                    appKey?: string;
+                    name?: string;
+                    homePageUrl?: string;
+                    extensions?: Record<string, string>;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findAll: {
+            /** 查询用户所有应用 */
+            post: (body: {
+                where: {
+                    id?: string;
+                    appKey?: string;
+                    name?: string;
+                    homePageUrl?: string;
+                    extensions?: Record<string, string>;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询应用详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findByIds: {
+            /** 根据 ID 列表批量查询应用 */
+            post: (body: {
+                ids: string[];
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        emailConfigInfo: {
+            /** 获取应用邮件配置信息 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    roles: {
+        create: {
+            /** 创建新角色 */
+            post: (body: {
+                name: string;
+                roleKey: string;
+                permissions?: string[];
+                description: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除角色 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新角色信息 */
+            post: (body: {
+                id: string;
+                name: string;
+                roleKey: string;
+                permissions?: string[];
+                description: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询角色列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    name?: string;
+                    roleKey?: string;
+                    description?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询角色详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        options: {
+            /** 获取角色下拉选项 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    permissions: {
+        create: {
+            /** 创建新权限 */
+            post: (body: {
+                name: string;
+                permissionKey: string;
+                description: string;
+                isPublic: boolean;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除权限 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新权限信息 */
+            post: (body: {
+                id: string;
+                name: string;
+                permissionKey: string;
+                description: string;
+                isPublic: boolean;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询权限列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    name?: string;
+                    permissionKey?: string;
+                    description?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询权限详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        options: {
+            /** 获取权限下拉选项 */
+            post: (body: {
+                excludePublic?: boolean;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    referrer: {
+        find: {
+            /** 分页查询推荐人列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    referrerId?: string;
+                    referrerEmail?: string;
+                    referrerPhone?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询推荐人详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        referees: {
+            /** 查询推荐人邀请的用户列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除推荐记录 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getReferrerStatistics: {
+            /** 获取推荐统计数据 */
+            post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getReferralCountChart: {
+            /** 获取推荐数量趋势图表 */
+            post: (body: {
+                startTime: string;
+                endTime: string;
+                granularity: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getReferralConversionChart: {
+            /** 获取推荐转化率趋势图表 */
+            post: (body: {
+                startTime: string;
+                endTime: string;
+                granularity: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getAvgReferralsChart: {
+            /** 获取平均推荐数趋势图表 */
+            post: (body: {
+                startTime: string;
+                endTime: string;
+                granularity: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getReferralOrderAmountChart: {
+            /** 获取推荐订单金额趋势图表 */
+            post: (body: {
+                startTime: string;
+                endTime: string;
+                granularity: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        getReferralOrderCountChart: {
+            /** 获取推荐订单数量趋势图表 */
+            post: (body: {
+                startTime: string;
+                endTime: string;
+                granularity: "minute" | "hour" | "day" | "month" | "year";
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    authLogs: {
+        list: {
+            /** 分页获取认证审计日志列表 */
+            post: (body: {
+                page?: number;
+                pageSize?: number;
+                userId?: string;
+                event?: string;
+                method?: string;
+                success?: boolean;
+                startTime?: string;
+                endTime?: string;
+                clientIp?: string;
+                email?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        stats: {
+            /** 获取认证审计日志统计数据 */
+            post: (body: {
+                startTime?: string;
+                endTime?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        ':id': {
+            /** 根据 ID 获取认证审计日志详情 */
+            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+    };
+    inviteCodes: {
+        create: {
+            /** 创建新邀请码 */
+            post: (body: {
+                name: string;
+                type: "personal" | "channel" | "campaign";
+                channel?: string;
+                maxUses?: number;
+                expiresAt?: string;
+                description?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        delete: {
+            /** 删除邀请码 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        update: {
+            /** 更新邀请码信息 */
+            post: (body: {
+                id: string;
+                name: string;
+                channel?: string;
+                maxUses?: number;
+                expiresAt?: string;
+                status: "active" | "inactive" | "expired";
+                description?: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        find: {
+            /** 分页查询邀请码列表 */
+            post: (body: {
+                current: number;
+                pageSize: number;
+                where: {
+                    name?: string;
+                    code?: string;
+                    type?: string;
+                    channel?: string;
+                    status?: string;
+                };
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        findOne: {
+            /** 根据 ID 查询邀请码详情 */
+            post: (body: {
+                id: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        validate: {
+            /** 验证邀请码是否有效 */
+            post: (body: {
+                code: string;
+            }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+        };
+        options: {
+            type: {
+                /** 获取邀请码类型下拉选项 */
+                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            status: {
+                /** 获取邀请码状态下拉选项 */
+                post: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+    };
+    security: {
+        ip: {
+            list: {
+                /** 获取 IP 黑白名单规则列表 */
+                post: (body: {
+                    appId?: string;
+                    type?: "whitelist" | "blacklist";
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            add: {
+                /** 添加 IP 黑白名单规则 */
+                post: (body: {
+                    appId?: string;
+                    ip: string;
+                    type: "whitelist" | "blacklist";
+                    reason?: string;
+                    expiresInMinutes?: number;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            remove: {
+                /** 删除 IP 黑白名单规则 */
+                post: (body: {
+                    id: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            block: {
+                /** 将 IP 加入黑名单 */
+                post: (body: {
+                    ip: string;
+                    reason: string;
+                    durationMinutes?: number;
+                    appId?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            unblock: {
+                /** 将 IP 从黑名单移除 */
+                post: (body: {
+                    ip: string;
+                    appId?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        alerts: {
+            list: {
+                /** 获取可疑登录告警列表 */
+                post: (body: {
+                    appId?: string;
+                    type?: string;
+                    riskLevel?: "low" | "medium" | "high" | "critical";
+                    resolved?: boolean;
+                    page?: number;
+                    pageSize?: number;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            resolve: {
+                /** 标记安全告警为已处理 */
+                post: (body: {
+                    alertId: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+            stats: {
+                /** 获取安全告警统计数据 */
+                post: (body: {
+                    appId?: string;
+                }, config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        detection: {
+            config: {
+                /** 获取可疑登录检测配置 */
+                get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+    };
+    webhooks: {
+        events: {
+            /** 获取所有可用的 Webhook 事件类型 */
+            get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            ':id': {
+                /** 获取指定分类的 Webhook 事件 */
+                get: (config?: RequestConfig) => Promise<ApiResponse<any>>;
+            };
+        };
+        categories: {
+            /** 获取所有 Webhook 事件分类 */
+            get: (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>;