@seaverse/payment-sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,1177 @@
+'use strict';
+
+var axios = require('axios');
+
+/**
+ * Payment API error
+ */
+class PaymentAPIError extends Error {
+    constructor(message, code, response) {
+        super(message);
+        this.code = code;
+        this.response = response;
+        this.name = 'PaymentAPIError';
+    }
+}
+/**
+ * SeaVerse Payment API Client
+ *
+ * Provides query capabilities for user credit accounts and transactions with multi-tenant support.
+ * All methods are read-only - credit spending/granting is handled by platform backend.
+ *
+ * ## Multi-tenant Architecture
+ * - Each app has isolated credit accounts using `app_id`
+ * - Same user can have different credit accounts in different apps
+ * - Use `appId` to specify which app's credit pool to access
+ *
+ * @example
+ * ```typescript
+ * // SeaVerse platform usage
+ * const client = new PaymentClient({
+ *   appId: 'seaverse',
+ *   token: 'your-bearer-token'
+ * });
+ *
+ * // Third-party app usage
+ * const gameClient = new PaymentClient({
+ *   appId: 'game-abc123',
+ *   token: 'your-bearer-token'
+ * });
+ *
+ * // Get credit account
+ * const account = await client.getCreditAccount();
+ * console.log(`Balance: ${account.balance} credits`);
+ *
+ * // List recent transactions
+ * const transactions = await client.listTransactions({ page_size: 10 });
+ * ```
+ */
+class PaymentClient {
+    constructor(options) {
+        this.axios = axios.create({
+            baseURL: options.baseURL || 'https://payment.sg.seaverse.dev',
+            timeout: options.timeout || 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-App-ID': options.appId,
+                Authorization: `Bearer ${options.token}`,
+            },
+        });
+        // Add response interceptor for error handling
+        this.axios.interceptors.response.use((response) => response, (error) => {
+            if (error.response) {
+                const data = error.response.data;
+                throw new PaymentAPIError(data.message || error.message, data.code || error.response.status, data);
+            }
+            throw new PaymentAPIError(error.message, error.code === 'ECONNABORTED' ? 408 : 500);
+        });
+    }
+    /**
+     * Get credit detail with 4-pool system information
+     *
+     * Returns detailed credit information across 4 pools (daily/event/monthly/permanent)
+     * with expiration timestamps. This is the recommended method for displaying user credits.
+     *
+     * **Credit Pool Types:**
+     * - `daily`: Daily credits (expires at next day 00:00 UTC)
+     * - `event`: Event credits (expires at event deadline)
+     * - `monthly`: Monthly credits (expires 30 days after last grant)
+     * - `permanent`: Permanent credits (never expires)
+     *
+     * **Consumption Priority:**
+     * Daily → Event → Monthly → Permanent
+     *
+     * **Response Features:**
+     * - Only returns pools with balance > 0
+     * - `expires_at` is millisecond timestamp (0 means permanent)
+     * - Frontend can calculate remaining time from timestamp
+     *
+     * **Recommended Refresh Rate:** 30 seconds
+     *
+     * @returns Credit detail with pool breakdown
+     * @throws {PaymentAPIError} If request fails
+     *
+     * @example
+     * ```typescript
+     * const detail = await client.getCreditDetail();
+     * console.log(`Total Balance: ${detail.total_balance}`);
+     *
+     * detail.pools.forEach(pool => {
+     *   const label = pool.expires_at === 0
+     *     ? 'Permanent'
+     *     : `Expires in ${Math.floor((pool.expires_at - Date.now()) / 86400000)} days`;
+     *   console.log(`${pool.type}: ${pool.balance} (${label})`);
+     * });
+     * ```
+     */
+    async getCreditDetail() {
+        const response = await this.axios.get('/sdk/v1/credits/detail');
+        return response.data.data;
+    }
+    /**
+     * Get authenticated user's credit account information
+     *
+     * Returns current balance, total earned/spent, frozen balance, and account status.
+     *
+     * @deprecated Use getCreditDetail() instead for the new 4-pool credit system
+     * @returns Credit account information
+     * @throws {PaymentAPIError} If request fails
+     *
+     * @example
+     * ```typescript
+     * const account = await client.getCreditAccount();
+     * console.log(`Balance: ${account.balance}`);
+     * console.log(`Status: ${account.status}`);
+     * ```
+     */
+    async getCreditAccount() {
+        const response = await this.axios.get('/sdk/v1/credits/account');
+        return response.data.data;
+    }
+    /**
+     * List credit transactions with filters and pagination
+     *
+     * Query user's transaction history with optional filters for type, source, status, and date range.
+     * Supports pagination with max 50 items per page.
+     *
+     * @param request - List transactions request parameters
+     * @returns Paginated transaction list with has_more flag
+     * @throws {PaymentAPIError} If request fails
+     *
+     * @example
+     * ```typescript
+     * // Get recent transactions
+     * const result = await client.listTransactions({ page_size: 20 });
+     *
+     * // Filter by type
+     * const spending = await client.listTransactions({
+     *   type: 'spend',
+     *   page: 1,
+     *   page_size: 10
+     * });
+     *
+     * // Filter by date range
+     * const recentTransactions = await client.listTransactions({
+     *   start_date: '2024-01-01T00:00:00Z',
+     *   end_date: '2024-12-31T23:59:59Z',
+     *   status: 'completed'
+     * });
+     * ```
+     */
+    async listTransactions(request = {}) {
+        const params = {};
+        if (request.type)
+            params.type = request.type;
+        if (request.source)
+            params.source = request.source;
+        if (request.status)
+            params.status = request.status;
+        if (request.start_date)
+            params.start_date = request.start_date;
+        if (request.end_date)
+            params.end_date = request.end_date;
+        if (request.page)
+            params.page = request.page;
+        if (request.page_size)
+            params.page_size = request.page_size;
+        const response = await this.axios.get('/sdk/v1/credits/transactions', { params });
+        return response.data.data;
+    }
+    /**
+     * Update the bearer token for authentication
+     *
+     * Use this method to update the token when it expires or needs to be refreshed.
+     *
+     * @param token - New bearer token
+     *
+     * @example
+     * ```typescript
+     * client.setToken('new-bearer-token');
+     * ```
+     */
+    setToken(token) {
+        this.axios.defaults.headers.common['Authorization'] = `Bearer ${token}`;
+    }
+    /**
+     * Update the base URL for the API
+     *
+     * Use this method to switch between different environments (dev/staging/prod).
+     *
+     * @param baseURL - New base URL
+     *
+     * @example
+     * ```typescript
+     * client.setBaseURL('https://payment.sg.seaverse.dev');
+     * ```
+     */
+    setBaseURL(baseURL) {
+        this.axios.defaults.baseURL = baseURL;
+    }
+    /**
+     * Update the app ID for multi-tenant isolation
+     *
+     * Use this method to switch between different apps at runtime.
+     *
+     * @param appId - New app ID
+     *
+     * @example
+     * ```typescript
+     * // Switch to SeaVerse platform
+     * client.setAppId('seaverse');
+     *
+     * // Switch to third-party app
+     * client.setAppId('game-abc123');
+     * ```
+     */
+    setAppId(appId) {
+        this.axios.defaults.headers.common['X-App-ID'] = appId;
+    }
+}
+
+/**
+ * SeaVerse Payment SDK - 常量配置
+ */
+/**
+ * 环境配置
+ */
+const ENV_CONFIG = {
+    develop: {
+        apiHost: 'https://aiart-openresty.dev.seaart.dev',
+        iframeUrl: 'https://aiart-payment-page.dev.seaart.dev',
+    },
+    release: {
+        apiHost: 'https://www.seaart.ai',
+        iframeUrl: 'https://pay.seaart.ai',
+    },
+};
+/**
+ * SDK CDN 地址
+ */
+const SDK_CDN_URL = 'https://image.cdn2.seaart.me/seaart-payment-sdk/1.0.2/seaart-pay-sdk-umd.min.js';
+/**
+ * SDK 加载超时时间（毫秒）
+ */
+const SDK_LOAD_TIMEOUT = 15000;
+/**
+ * SDK 全局对象名称
+ */
+const SDK_GLOBAL_NAME = 'SeaArtPay';
+/**
+ * API 端点
+ */
+const API_ENDPOINTS = {
+    /** SDK 结账接口 */
+    SDK_CHECKOUT: '/api/v1/payment/sdk/checkout',
+};
+/**
+ * 默认配置
+ */
+const DEFAULT_CHECKOUT_CONFIG = {
+    environment: 'develop',
+    debug: false,
+    language: 'en',
+    sdkTimeout: SDK_LOAD_TIMEOUT,
+};
+/**
+ * HTTP 状态码
+ */
+const HTTP_STATUS = {
+    OK: 200,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    INTERNAL_ERROR: 500,
+};
+/**
+ * 业务状态码
+ */
+const BIZ_CODE = {
+    SUCCESS: 0,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    SERVER_ERROR: 500,
+};
+
+/**
+ * SeaArtPay SDK 加载器
+ * 负责从 CDN 动态加载 SeaArt 支付 SDK
+ */
+/**
+ * SDK 加载器类
+ */
+class SeaArtPayLoader {
+    constructor(config = {}) {
+        this.status = 'idle';
+        this.sdk = null;
+        this.loadPromise = null;
+        this.config = {
+            cdnUrl: config.cdnUrl ?? SDK_CDN_URL,
+            timeout: config.timeout ?? SDK_LOAD_TIMEOUT,
+            debug: config.debug ?? false,
+            environment: config.environment ?? 'develop',
+        };
+    }
+    /**
+     * 获取当前加载状态
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * 检查 SDK 是否已加载
+     */
+    isLoaded() {
+        return this.status === 'loaded' && this.sdk !== null;
+    }
+    /**
+     * 获取 SDK 实例
+     */
+    getSDK() {
+        return this.sdk;
+    }
+    /**
+     * 加载 SDK
+     */
+    async load() {
+        // 如果已加载，直接返回
+        if (this.sdk) {
+            return this.sdk;
+        }
+        // 如果正在加载，返回现有的 Promise
+        if (this.loadPromise) {
+            return this.loadPromise;
+        }
+        this.status = 'loading';
+        this.log('开始加载 SeaArtPay SDK...');
+        this.loadPromise = this.loadSDKFromSources();
+        try {
+            this.sdk = await this.loadPromise;
+            this.status = 'loaded';
+            this.initializeSDK();
+            this.log('SDK 加载成功');
+            return this.sdk;
+        }
+        catch (error) {
+            this.status = 'error';
+            this.loadPromise = null;
+            throw error;
+        }
+    }
+    /**
+     * 从多个源尝试加载 SDK
+     */
+    async loadSDKFromSources() {
+        const sources = [
+            { name: 'CDN', url: this.config.cdnUrl },
+        ];
+        for (const source of sources) {
+            this.log(`尝试从 ${source.name} 加载: ${source.url}`);
+            try {
+                await this.loadScript(source.url);
+                const sdk = this.extractSDKInstance();
+                if (sdk) {
+                    this.log(`成功从 ${source.name} 加载 SDK`);
+                    return sdk;
+                }
+                this.log(`${source.name} 加载的脚本无效`);
+            }
+            catch (error) {
+                this.log(`从 ${source.name} 加载失败: ${error}`);
+            }
+        }
+        throw new Error('所有 SDK 源加载失败');
+    }
+    /**
+     * 动态加载脚本
+     */
+    loadScript(url) {
+        return new Promise((resolve, reject) => {
+            // 检查是否在浏览器环境
+            if (typeof document === 'undefined') {
+                reject(new Error('非浏览器环境，无法加载脚本'));
+                return;
+            }
+            // 检查是否已加载
+            const existingScript = document.querySelector(`script[src="${url}"]`);
+            if (existingScript) {
+                resolve();
+                return;
+            }
+            const script = document.createElement('script');
+            script.src = url;
+            script.async = true;
+            script.setAttribute('data-sdk', 'seaart-payment');
+            const timer = setTimeout(() => {
+                cleanup();
+                reject(new Error(`脚本加载超时: ${url}`));
+            }, this.config.timeout);
+            const cleanup = () => {
+                clearTimeout(timer);
+                script.onload = null;
+                script.onerror = null;
+            };
+            script.onload = () => {
+                cleanup();
+                resolve();
+            };
+            script.onerror = () => {
+                cleanup();
+                document.head.removeChild(script);
+                reject(new Error(`脚本加载失败: ${url}`));
+            };
+            document.head.appendChild(script);
+        });
+    }
+    /**
+     * 提取 SDK 实例
+     * 处理 UMD 包装对象的情况
+     */
+    extractSDKInstance() {
+        if (typeof window === 'undefined') {
+            return null;
+        }
+        const globalObj = window.SeaArtPay;
+        if (!globalObj) {
+            return null;
+        }
+        // 检查是否是实际的 SDK 实例（有 show 方法）
+        if (this.isValidSDK(globalObj)) {
+            return globalObj;
+        }
+        // 检查是否是 UMD 包装对象
+        const wrapped = globalObj;
+        if (wrapped.SeaArtPay && this.isValidSDK(wrapped.SeaArtPay)) {
+            // 修复全局引用
+            window.SeaArtPay = wrapped.SeaArtPay;
+            return wrapped.SeaArtPay;
+        }
+        return null;
+    }
+    /**
+     * 验证 SDK 实例是否有效
+     */
+    isValidSDK(sdk) {
+        return (typeof sdk === 'object' &&
+            sdk !== null &&
+            typeof sdk.show === 'function');
+    }
+    /**
+     * 初始化 SDK
+     */
+    initializeSDK() {
+        if (!this.sdk)
+            return;
+        const envConfig = ENV_CONFIG[this.config.environment];
+        if (typeof this.sdk.init === 'function') {
+            this.sdk.init({
+                debug: this.config.debug,
+                iframeUrl: envConfig.iframeUrl,
+            });
+            this.log(`SDK 已初始化，环境: ${this.config.environment}`);
+        }
+    }
+    /**
+     * 日志输出
+     */
+    log(message) {
+        if (this.config.debug) {
+            console.log(`[SeaArtPayLoader] ${message}`);
+        }
+    }
+    /**
+     * 重置加载器
+     */
+    reset() {
+        this.status = 'idle';
+        this.sdk = null;
+        this.loadPromise = null;
+    }
+}
+/**
+ * 创建全局单例加载器
+ */
+let globalLoader = null;
+/**
+ * 获取或创建全局加载器
+ */
+function getGlobalLoader(config) {
+    if (!globalLoader) {
+        globalLoader = new SeaArtPayLoader(config);
+    }
+    return globalLoader;
+}
+/**
+ * 重置全局加载器
+ */
+function resetGlobalLoader() {
+    globalLoader?.reset();
+    globalLoader = null;
+}
+
+/**
+ * 结账 API 模块
+ * 实现 /api/v1/payment/sdk/checkout 接口调用
+ */
+/**
+ * 结账 API 客户端
+ */
+class CheckoutAPI {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * 创建一次性购买订单
+     */
+    async createOneTimeCheckout(params) {
+        return this.createCheckout({
+            product_id: params.productId,
+            product_name: params.productName,
+            price: params.price,
+            purchase_type: 1,
+            extra: params.extra,
+        });
+    }
+    /**
+     * 创建订阅订单
+     */
+    async createSubscriptionCheckout(params) {
+        return this.createCheckout({
+            product_id: params.productId,
+            product_name: params.productName,
+            price: params.price,
+            purchase_type: 2,
+            subscription: params.subscription,
+            extra: params.extra,
+        });
+    }
+    /**
+     * 创建结账订单
+     */
+    async createCheckout(request) {
+        this.validateRequest(request);
+        const url = `${this.config.apiHost}${API_ENDPOINTS.SDK_CHECKOUT}`;
+        const token = await this.config.getAuthToken();
+        if (!token) {
+            throw this.createError('UNAUTHORIZED', '未授权：缺少 JWT Token');
+        }
+        this.log('发起结账请求:', { url, request });
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${token}`,
+                },
+                body: JSON.stringify(request),
+            });
+            const data = await response.json();
+            this.log('结账响应:', data);
+            if (data.code !== BIZ_CODE.SUCCESS) {
+                throw this.createError(this.mapErrorCode(data.code), data.msg || '结账失败');
+            }
+            if (!data.data) {
+                throw this.createError('CHECKOUT_FAILED', '结账响应数据为空');
+            }
+            return this.transformResponse(data.data);
+        }
+        catch (error) {
+            if (this.isPaymentError(error)) {
+                throw error;
+            }
+            if (error instanceof TypeError) {
+                throw this.createError('NETWORK_ERROR', '网络请求失败', error);
+            }
+            throw this.createError('UNKNOWN_ERROR', '未知错误', error);
+        }
+    }
+    /**
+     * 验证请求参数
+     */
+    validateRequest(request) {
+        // 必须提供 productId 或 (productName + price)
+        const hasProductId = !!request.product_id;
+        const hasManualProduct = !!request.product_name && request.price != null;
+        if (!hasProductId && !hasManualProduct) {
+            throw this.createError('INVALID_PARAMS', '必须提供 productId 或 (productName + price)');
+        }
+        // 订阅类型必须提供订阅参数
+        if (request.purchase_type === 2 && !request.subscription) {
+            throw this.createError('INVALID_PARAMS', '订阅类型必须提供 subscription 参数');
+        }
+        // 验证订阅参数
+        if (request.subscription) {
+            if (!request.subscription.period) {
+                throw this.createError('INVALID_PARAMS', '订阅参数缺少 period');
+            }
+            if (request.subscription.periodAmount == null) {
+                throw this.createError('INVALID_PARAMS', '订阅参数缺少 periodAmount');
+            }
+        }
+    }
+    /**
+     * 转换响应数据
+     */
+    transformResponse(response) {
+        return {
+            orderId: response.order_id,
+            transactionId: response.transaction_id,
+            price: response.price,
+            currency: response.currency,
+            sdkConfig: {
+                appId: response.sdk_config.app_id,
+                apiHost: response.sdk_config.api_host,
+                environment: response.sdk_config.environment,
+            },
+        };
+    }
+    /**
+     * 映射错误代码
+     */
+    mapErrorCode(code) {
+        switch (code) {
+            case BIZ_CODE.BAD_REQUEST:
+                return 'INVALID_PARAMS';
+            case BIZ_CODE.UNAUTHORIZED:
+                return 'UNAUTHORIZED';
+            case BIZ_CODE.SERVER_ERROR:
+                return 'API_ERROR';
+            default:
+                return 'CHECKOUT_FAILED';
+        }
+    }
+    /**
+     * 创建支付错误
+     */
+    createError(code, message, cause) {
+        return { code, message, cause };
+    }
+    /**
+     * 检查是否是支付错误
+     */
+    isPaymentError(error) {
+        return (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            'message' in error);
+    }
+    /**
+     * 日志输出
+     */
+    log(message, data) {
+        if (this.config.debug) {
+            console.log(`[CheckoutAPI] ${message}`, data ?? '');
+        }
+    }
+}
+
+/**
+ * PaymentCheckoutClient - 支付弹窗客户端
+ * 提供支付弹窗的初始化、结账和订阅功能
+ */
+/**
+ * 支付弹窗客户端类
+ *
+ * 提供一次性购买和订阅购买功能，自动处理：
+ * - SeaArtPay SDK 的动态加载
+ * - 创建结账订单
+ * - 显示支付弹窗
+ * - 支付结果回调
+ *
+ * @example
+ * ```typescript
+ * // 创建客户端
+ * const checkoutClient = new PaymentCheckoutClient({
+ *   apiHost: 'https://payment.sg.seaverse.dev',
+ *   authToken: 'your-jwt-token',
+ *   environment: 'develop',
+ *   debug: true,
+ * });
+ *
+ * // 初始化
+ * await checkoutClient.init();
+ *
+ * // 发起购买
+ * const result = await checkoutClient.checkout({
+ *   productId: 'pkg_starter',
+ *   onSuccess: (res) => console.log('支付成功:', res),
+ *   onError: (err) => console.error('支付失败:', err),
+ * });
+ * ```
+ */
+class PaymentCheckoutClient {
+    constructor(config) {
+        this.status = 'idle';
+        this.initPromise = null;
+        // 验证必须提供 authToken 或 getAuthToken 其中之一
+        if (!config.authToken && !config.getAuthToken) {
+            throw new Error('必须提供 authToken 或 getAuthToken 其中之一');
+        }
+        this.config = {
+            ...config,
+            environment: config.environment ?? DEFAULT_CHECKOUT_CONFIG.environment,
+            debug: config.debug ?? DEFAULT_CHECKOUT_CONFIG.debug,
+        };
+        // 创建 SDK 加载器
+        this.loader = new SeaArtPayLoader({
+            cdnUrl: config.sdkCdnUrl,
+            timeout: config.sdkTimeout ?? DEFAULT_CHECKOUT_CONFIG.sdkTimeout,
+            debug: this.config.debug,
+            environment: this.config.environment,
+        });
+        // 创建获取 Token 的函数（支持静态 token 和动态获取）
+        const getAuthToken = config.authToken
+            ? () => config.authToken
+            : config.getAuthToken;
+        // 创建结账 API 客户端
+        this.checkoutAPI = new CheckoutAPI({
+            apiHost: this.config.apiHost,
+            getAuthToken,
+            debug: this.config.debug,
+        });
+    }
+    /**
+     * 获取客户端状态
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * 检查是否已初始化
+     */
+    isReady() {
+        return this.status === 'ready';
+    }
+    /**
+     * 初始化客户端
+     * 加载 SeaArtPay SDK
+     */
+    async init() {
+        if (this.status === 'ready') {
+            return;
+        }
+        if (this.initPromise) {
+            return this.initPromise;
+        }
+        this.status = 'initializing';
+        this.log('初始化支付弹窗客户端...');
+        this.initPromise = this.doInit();
+        try {
+            await this.initPromise;
+            this.status = 'ready';
+            this.log('支付弹窗客户端初始化完成');
+        }
+        catch (error) {
+            this.status = 'error';
+            this.initPromise = null;
+            throw error;
+        }
+    }
+    async doInit() {
+        try {
+            await this.loader.load();
+        }
+        catch (error) {
+            throw this.createError('SDK_LOAD_FAILED', 'SeaArt 支付 SDK 加载失败', error);
+        }
+    }
+    /**
+     * 一次性购买
+     * @param options 购买选项
+     * @returns 结账结果（包含 transactionId）
+     */
+    async checkout(options) {
+        await this.ensureReady();
+        this.log('发起一次性购买:', options);
+        // 调用结账 API
+        const result = await this.checkoutAPI.createOneTimeCheckout({
+            productId: options.productId,
+            productName: options.productName,
+            price: options.price,
+            extra: options.extra,
+        });
+        // 自动打开支付弹窗
+        this.showPaymentModal({
+            transactionId: result.transactionId,
+            language: options.language,
+            userName: options.userName,
+            productName: options.productName,
+            onSuccess: options.onSuccess,
+            onUnsuccess: (unsuccessResult) => {
+                if (unsuccessResult.reason === 'cancel') {
+                    options.onClose?.();
+                }
+                else {
+                    options.onError?.({
+                        code: 'PAYMENT_FAILED',
+                        message: unsuccessResult.message,
+                    });
+                }
+            },
+        });
+        return result;
+    }
+    /**
+     * 订阅购买
+     * @param options 订阅选项
+     * @returns 结账结果（包含 transactionId）
+     */
+    async subscribe(options) {
+        await this.ensureReady();
+        this.log('发起订阅购买:', options);
+        // 调用结账 API
+        const result = await this.checkoutAPI.createSubscriptionCheckout({
+            productId: options.productId,
+            productName: options.productName,
+            price: options.price,
+            subscription: {
+                period: options.period,
+                periodAmount: options.periodAmount,
+                firstDays: options.firstDays ?? 0,
+            },
+            extra: options.extra,
+        });
+        // 自动打开支付弹窗
+        this.showPaymentModal({
+            transactionId: result.transactionId,
+            language: options.language,
+            userName: options.userName,
+            productName: options.productName,
+            onSuccess: options.onSuccess,
+            onUnsuccess: (unsuccessResult) => {
+                if (unsuccessResult.reason === 'cancel') {
+                    options.onClose?.();
+                }
+                else {
+                    options.onError?.({
+                        code: 'PAYMENT_FAILED',
+                        message: unsuccessResult.message,
+                    });
+                }
+            },
+        });
+        return result;
+    }
+    /**
+     * 直接打开支付弹窗
+     * 使用已有的 transactionId
+     */
+    showPayment(options) {
+        if (!this.isReady()) {
+            throw this.createError('SDK_NOT_READY', '支付 SDK 未初始化');
+        }
+        this.showPaymentModal(options);
+    }
+    /**
+     * 关闭支付弹窗
+     */
+    close() {
+        const sdk = this.getSDK();
+        if (sdk && typeof sdk.close === 'function') {
+            sdk.close();
+            this.log('支付弹窗已关闭');
+        }
+    }
+    /**
+     * 获取环境配置
+     */
+    getEnvironmentConfig() {
+        return ENV_CONFIG[this.config.environment];
+    }
+    // ==================== 私有方法 ====================
+    /**
+     * 确保客户端已就绪
+     */
+    async ensureReady() {
+        if (this.status === 'ready') {
+            return;
+        }
+        if (this.status === 'initializing' && this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        await this.init();
+    }
+    /**
+     * 获取 SDK 实例
+     */
+    getSDK() {
+        return this.loader.getSDK();
+    }
+    /**
+     * 显示支付弹窗
+     */
+    showPaymentModal(options) {
+        const sdk = this.getSDK();
+        if (!sdk) {
+            throw this.createError('SDK_NOT_READY', '支付 SDK 未加载');
+        }
+        this.log('打开支付弹窗:', options.transactionId);
+        sdk.show({
+            transactionId: options.transactionId,
+            language: options.language ?? DEFAULT_CHECKOUT_CONFIG.language,
+            userName: options.userName,
+            productName: options.productName,
+            from: options.from,
+            onSuccess: (result) => {
+                this.log('支付成功:', result);
+                options.onSuccess?.({
+                    transactionId: options.transactionId,
+                    status: 'success',
+                    data: result,
+                });
+            },
+            onUnsuccess: (result) => {
+                this.log('支付未成功:', result);
+                const unsuccessResult = result;
+                options.onUnsuccess?.({
+                    reason: unsuccessResult.reason ?? 'error',
+                    message: unsuccessResult.message ?? '支付未完成',
+                    transactionId: options.transactionId,
+                });
+            },
+        });
+    }
+    /**
+     * 创建支付错误
+     */
+    createError(code, message, cause) {
+        return { code, message, cause };
+    }
+    /**
+     * 日志输出
+     */
+    log(message, data) {
+        if (this.config.debug) {
+            console.log(`[PaymentCheckoutClient] ${message}`, data ?? '');
+        }
+    }
+}
+
+/**
+ * 工具函数模块
+ */
+/**
+ * 生成唯一的订单引用号
+ * @param prefix 前缀
+ * @returns 唯一引用号
+ */
+function generateOrderReference(prefix = 'sv') {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${prefix}-${timestamp}-${random}`;
+}
+/**
+ * 将美元金额转换为分
+ * @param dollars 美元金额
+ * @returns 分
+ */
+function dollarsToCents(dollars) {
+    return Math.round(dollars * 100);
+}
+/**
+ * 将分转换为美元
+ * @param cents 分
+ * @returns 美元金额
+ */
+function centsToDollars(cents) {
+    return cents / 100;
+}
+/**
+ * 格式化价格显示
+ * @param amount 金额（美元）
+ * @param currency 货币代码
+ * @returns 格式化的价格字符串
+ */
+function formatPrice(amount, currency = 'USD') {
+    const symbols = {
+        USD: '$',
+        CNY: '¥',
+        EUR: '€',
+        GBP: '£',
+        JPY: '¥',
+        KRW: '₩',
+    };
+    const symbol = symbols[currency] || currency + ' ';
+    return `${symbol}${amount.toFixed(2)}`;
+}
+/**
+ * 创建支付错误对象
+ * @param code 错误代码
+ * @param message 错误消息
+ * @param cause 原始错误
+ * @returns 支付错误对象
+ */
+function createCheckoutPaymentError(code, message, cause) {
+    return { code, message, cause };
+}
+/**
+ * 检查是否是支付错误
+ * @param error 错误对象
+ * @returns 是否是支付错误
+ */
+function isCheckoutPaymentError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        'message' in error);
+}
+/**
+ * 延迟函数
+ * @param ms 毫秒
+ * @returns Promise
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 带超时的 Promise
+ * @param promise 原始 Promise
+ * @param ms 超时毫秒数
+ * @param errorMessage 超时错误消息
+ * @returns 带超时的 Promise
+ */
+function withTimeout(promise, ms, errorMessage = 'Operation timed out') {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(errorMessage)), ms);
+        }),
+    ]);
+}
+/**
+ * 安全的 JSON 解析
+ * @param json JSON 字符串
+ * @param defaultValue 默认值
+ * @returns 解析结果或默认值
+ */
+function safeJsonParse(json, defaultValue) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return defaultValue;
+    }
+}
+/**
+ * 检查是否在浏览器环境
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof document !== 'undefined';
+}
+/**
+ * 获取当前页面 URL
+ */
+function getCurrentUrl() {
+    if (!isBrowser())
+        return '';
+    return window.location.href;
+}
+/**
+ * Locale 映射（项目语言到 SDK 语言）
+ */
+const LOCALE_MAP = {
+    'zh-CN': 'zh-CN',
+    'zh-TW': 'zh-TW',
+    zh: 'zh-CN',
+    en: 'en-US',
+    'en-US': 'en-US',
+    ko: 'ko-KR',
+    'ko-KR': 'ko-KR',
+    ja: 'ja-JP',
+    'ja-JP': 'ja-JP',
+    es: 'es-ES',
+    fr: 'fr-FR',
+    de: 'de-DE',
+};
+/**
+ * 获取 SDK 支持的 locale
+ * @param locale 项目 locale
+ * @returns SDK locale
+ */
+function getSDKLocale(locale) {
+    return LOCALE_MAP[locale] || LOCALE_MAP['en'];
+}
+
+/**
+ * @seaverse/payment-sdk
+ *
+ * SeaVerse Payment SDK - Credit management and payment checkout
+ *
+ * This SDK provides two main features:
+ *
+ * ## 1. Credit Query (PaymentClient)
+ * Query user credit accounts and transaction history.
+ *
+ * ```typescript
+ * import { PaymentClient } from '@seaverse/payment-sdk';
+ *
+ * const client = new PaymentClient({
+ *   appId: 'seaverse',
+ *   token: 'your-bearer-token',
+ * });
+ *
+ * const detail = await client.getCreditDetail();
+ * console.log(`Total Balance: ${detail.total_balance}`);
+ * ```
+ *
+ * ## 2. Payment Checkout (PaymentCheckoutClient)
+ * Show payment modal for one-time purchases and subscriptions.
+ *
+ * ```typescript
+ * import { PaymentCheckoutClient } from '@seaverse/payment-sdk';
+ *
+ * const checkoutClient = new PaymentCheckoutClient({
+ *   apiHost: 'https://payment.sg.seaverse.dev',
+ *   authToken: 'your-jwt-token',
+ *   environment: 'develop',
+ * });
+ *
+ * await checkoutClient.init();
+ *
+ * await checkoutClient.checkout({
+ *   productId: 'pkg_starter',
+ *   onSuccess: (res) => console.log('Payment success:', res),
+ * });
+ * ```
+ */
+// ============================================================================
+// Credit Query API (PaymentClient)
+// ============================================================================
+// ============================================================================
+// Version
+// ============================================================================
+/**
+ * SDK version
+ */
+const VERSION = '0.1.0';
+
+exports.API_ENDPOINTS = API_ENDPOINTS;
+exports.BIZ_CODE = BIZ_CODE;
+exports.CheckoutAPI = CheckoutAPI;
+exports.DEFAULT_CHECKOUT_CONFIG = DEFAULT_CHECKOUT_CONFIG;
+exports.ENV_CONFIG = ENV_CONFIG;
+exports.HTTP_STATUS = HTTP_STATUS;
+exports.PaymentAPIError = PaymentAPIError;
+exports.PaymentCheckoutClient = PaymentCheckoutClient;
+exports.PaymentClient = PaymentClient;
+exports.SDK_CDN_URL = SDK_CDN_URL;
+exports.SDK_GLOBAL_NAME = SDK_GLOBAL_NAME;
+exports.SDK_LOAD_TIMEOUT = SDK_LOAD_TIMEOUT;
+exports.SeaArtPayLoader = SeaArtPayLoader;
+exports.VERSION = VERSION;
+exports.centsToDollars = centsToDollars;
+exports.createCheckoutPaymentError = createCheckoutPaymentError;
+exports.delay = delay;
+exports.dollarsToCents = dollarsToCents;
+exports.formatPrice = formatPrice;
+exports.generateOrderReference = generateOrderReference;
+exports.getCurrentUrl = getCurrentUrl;
+exports.getGlobalLoader = getGlobalLoader;
+exports.getSDKLocale = getSDKLocale;
+exports.isBrowser = isBrowser;
+exports.isCheckoutPaymentError = isCheckoutPaymentError;
+exports.resetGlobalLoader = resetGlobalLoader;
+exports.safeJsonParse = safeJsonParse;
+exports.withTimeout = withTimeout;
+//# sourceMappingURL=index.cjs.map