@seaverse/payment-sdk 0.3.1 → 0.4.1

package/dist/index.d.ts

@@ -349,10 +349,10 @@ declare class PaymentClient {
  */
 /**
  * 支付环境
- * - development: 开发/测试环境
- * - production: 生产环境
+ * - develop: 开发/测试环境
+ * - release: 生产环境
  */
-type PaymentEnvironment = 'development' | 'production';
+type PaymentEnvironment = 'develop' | 'release';
 /**
  * 支付弹窗客户端配置
  */
@@ -425,6 +425,8 @@ interface BaseCheckoutOptions {
     language?: string;
     /** 用户名（显示用） */
     userName?: string;
+    /** 支付完成后的重定向 URL（可选，用于支付成功后跳转） */
+    redirectUrl?: string;
 }
 /**
  * 一次性购买选项
@@ -483,6 +485,8 @@ interface SDKCheckoutRequest {
     subscription?: SubscriptionParams;
     /** 额外数据 */
     extra?: Record<string, unknown>;
+    /** 支付完成后的重定向 URL（可选） */
+    redirect_url?: string;
 }
 /**
  * SDK 结账响应
@@ -496,6 +500,8 @@ interface SDKCheckoutResponse {
     price: number;
     /** 货币代码 */
     currency: string;
+    /** 支付完成后的跳转 URL（SDK 调用方应在支付完成后跳转到此 URL） */
+    redirect_url: string;
     /** SDK 初始化配置 */
     sdk_config: {
         app_id: string;
@@ -526,6 +532,8 @@ interface CheckoutResult {
     price: number;
     /** 货币代码 */
     currency: string;
+    /** 支付完成后的跳转 URL */
+    redirectUrl: string;
     /** SDK 配置 */
     sdkConfig: SDKConfig;
 }
@@ -563,6 +571,8 @@ interface CheckoutPaymentError {
     code: CheckoutPaymentErrorCode;
     /** 错误消息 */
     message: string;
+    /** 业务错误码（来自后端 API） */
+    bizCode?: number;
     /** 原始错误 */
     cause?: unknown;
 }
@@ -642,7 +652,7 @@ type CheckoutClientStatus = 'idle' | 'initializing' | 'ready' | 'error';
  * const checkoutClient = new PaymentCheckoutClient({
  *   apiHost: 'https://payment.sg.seaverse.dev',
  *   authToken: 'your-jwt-token',
- *   environment: 'development',
+ *   environment: 'develop',
  *   debug: true,
  * });
  *
@@ -706,6 +716,7 @@ declare class PaymentCheckoutClient {
      */
     getEnvironmentConfig(): {
         apiHost: string;
+        iframeUrl: string;
     };
     /**
      * 确保客户端已就绪
@@ -760,6 +771,8 @@ declare class CheckoutAPI {
         productName?: string;
         price?: number;
         extra?: Record<string, unknown>;
+        /** 支付完成后的重定向 URL */
+        redirectUrl?: string;
     }): Promise<CheckoutResult>;
     /**
      * 创建订阅订单
@@ -770,6 +783,8 @@ declare class CheckoutAPI {
         price?: number;
         subscription: SubscriptionParams;
         extra?: Record<string, unknown>;
+        /** 支付完成后的重定向 URL */
+        redirectUrl?: string;
     }): Promise<CheckoutResult>;
     /**
      * 创建结账订单
@@ -973,18 +988,17 @@ declare function getSDKLocale(locale: string): string;
 
 /**
  * 环境配置
- * - development: 开发/测试环境
- * - production: 生产环境
  */
 declare const ENV_CONFIG: Record<PaymentEnvironment, {
     apiHost: string;
+    iframeUrl: string;
 }>;
 /**
  * Web Component 加载超时时间（毫秒）
  */
 declare const COMPONENT_LOAD_TIMEOUT = 15000;
 /**
- * Web Component 自定义元素名称
+ * Web Component 元素名称
  */
 declare const PAYMENT_ELEMENT_NAME = "seaart-payment";
 /**
@@ -1001,6 +1015,8 @@ declare const DEFAULT_CHECKOUT_CONFIG: {
     readonly environment: PaymentEnvironment;
     readonly debug: false;
     readonly language: "en";
+    /** @deprecated 使用 componentTimeout 替代 */
+    readonly sdkTimeout: 15000;
     readonly componentTimeout: 15000;
 };
 /**
@@ -1022,6 +1038,12 @@ declare const BIZ_CODE: {
     readonly BAD_REQUEST: 400;
     readonly UNAUTHORIZED: 401;
     readonly SERVER_ERROR: 500;
+    readonly DAILY_LIMIT_EXCEEDED: 4001;
+    readonly PRODUCT_NOT_FOUND: 4002;
+    readonly PRODUCT_DISABLED: 4003;
+    readonly INSUFFICIENT_BALANCE: 4004;
+    readonly ORDER_NOT_FOUND: 4005;
+    readonly INVALID_ORDER_STATUS: 4006;
 };
 
 /**

package/dist/index.js

@@ -231,23 +231,28 @@ class PaymentClient {
  */
 /**
  * 环境配置
- * - development: 开发/测试环境
- * - production: 生产环境
  */
 const ENV_CONFIG = {
-    development: {
+    develop: {
         apiHost: 'https://aiart-openresty.dev.seaart.dev',
+        iframeUrl: 'https://aiart-payment-page.dev.seaart.dev',
     },
-    production: {
+    release: {
         apiHost: 'https://www.seaart.ai',
+        iframeUrl: 'https://pay.seaart.ai',
     },
 };
+/**
+ * SDK 加载超时时间（毫秒）
+ * @deprecated 使用 COMPONENT_LOAD_TIMEOUT 替代
+ */
+const SDK_LOAD_TIMEOUT = 15000;
 /**
  * Web Component 加载超时时间（毫秒）
  */
 const COMPONENT_LOAD_TIMEOUT = 15000;
 /**
- * Web Component 自定义元素名称
+ * Web Component 元素名称
  */
 const PAYMENT_ELEMENT_NAME = 'seaart-payment';
 /**
@@ -261,9 +266,11 @@ const API_ENDPOINTS$1 = {
  * 默认配置
  */
 const DEFAULT_CHECKOUT_CONFIG = {
-    environment: 'development',
+    environment: 'develop',
     debug: false,
     language: 'en',
+    /** @deprecated 使用 componentTimeout 替代 */
+    sdkTimeout: SDK_LOAD_TIMEOUT,
     componentTimeout: COMPONENT_LOAD_TIMEOUT,
 };
 /**
@@ -285,6 +292,13 @@ const BIZ_CODE = {
     BAD_REQUEST: 400,
     UNAUTHORIZED: 401,
     SERVER_ERROR: 500,
+    // 业务错误码 (4001-4006)
+    DAILY_LIMIT_EXCEEDED: 4001,
+    PRODUCT_NOT_FOUND: 4002,
+    PRODUCT_DISABLED: 4003,
+    INSUFFICIENT_BALANCE: 4004,
+    ORDER_NOT_FOUND: 4005,
+    INVALID_ORDER_STATUS: 4006,
 };
 
 /**
@@ -306,7 +320,7 @@ class SeaArtPayLoader {
         this.config = {
             timeout: config.timeout ?? COMPONENT_LOAD_TIMEOUT,
             debug: config.debug ?? false,
-            environment: config.environment ?? 'development',
+            environment: config.environment ?? 'develop',
         };
     }
     /**
@@ -395,19 +409,17 @@ class SeaArtPayLoader {
      */
     async loadComponent() {
         try {
-            // 动态导入 @seaart/payment-component
-            // 注意：消费方需要在项目中安装此依赖
-            await Promise.resolve().then(function () { return seaartPayment; });
+            // 动态导入内部打包的 Web Component
+            // Web Component 已经打包在 SDK 中，用户无需单独安装
+            await Promise.resolve().then(function () { return componentBundle; });
             this.log('模块导入成功');
             // 等待自定义元素注册完成
             await this.waitForElementDefined();
             this.log('自定义元素注册完成');
         }
         catch (error) {
-            // 如果动态导入失败，可能是消费方没有安装依赖
             const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new Error(`无法加载 @seaart/payment-component: ${errorMessage}\n` +
-                '请确保已安装依赖: npm install @seaart/payment-component');
+            throw new Error(`无法加载 Web Component: ${errorMessage}`);
         }
     }
     /**
@@ -487,6 +499,7 @@ class CheckoutAPI {
             price: params.price,
             purchase_type: 1,
             extra: params.extra,
+            redirect_url: params.redirectUrl,
         });
     }
     /**
@@ -500,6 +513,7 @@ class CheckoutAPI {
             purchase_type: 2,
             subscription: params.subscription,
             extra: params.extra,
+            redirect_url: params.redirectUrl,
         });
     }
     /**
@@ -525,7 +539,8 @@ class CheckoutAPI {
             const data = await response.json();
             this.log('结账响应:', data);
             if (data.code !== BIZ_CODE.SUCCESS) {
-                throw this.createError(this.mapErrorCode(data.code), data.msg || '结账失败');
+                throw this.createError(this.mapErrorCode(data.code), data.msg || '结账失败', undefined, data.code // 传递原始业务错误码
+                );
             }
             if (!data.data) {
                 throw this.createError('CHECKOUT_FAILED', '结账响应数据为空');
@@ -575,6 +590,7 @@ class CheckoutAPI {
             transactionId: response.transaction_id,
             price: response.price,
             currency: response.currency,
+            redirectUrl: response.redirect_url,
             sdkConfig: {
                 appId: response.sdk_config.app_id,
                 apiHost: response.sdk_config.api_host,
@@ -593,6 +609,14 @@ class CheckoutAPI {
                 return 'UNAUTHORIZED';
             case BIZ_CODE.SERVER_ERROR:
                 return 'API_ERROR';
+            // 业务错误码统一映射为 CHECKOUT_FAILED，通过 bizCode 区分具体原因
+            case BIZ_CODE.DAILY_LIMIT_EXCEEDED:
+            case BIZ_CODE.PRODUCT_NOT_FOUND:
+            case BIZ_CODE.PRODUCT_DISABLED:
+            case BIZ_CODE.INSUFFICIENT_BALANCE:
+            case BIZ_CODE.ORDER_NOT_FOUND:
+            case BIZ_CODE.INVALID_ORDER_STATUS:
+                return 'CHECKOUT_FAILED';
             default:
                 return 'CHECKOUT_FAILED';
         }
@@ -600,8 +624,8 @@ class CheckoutAPI {
     /**
      * 创建支付错误
      */
-    createError(code, message, cause) {
-        return { code, message, cause };
+    createError(code, message, cause, bizCode) {
+        return { code, message, cause, bizCode };
     }
     /**
      * 检查是否是支付错误
@@ -643,7 +667,7 @@ class CheckoutAPI {
  * const checkoutClient = new PaymentCheckoutClient({
  *   apiHost: 'https://payment.sg.seaverse.dev',
  *   authToken: 'your-jwt-token',
- *   environment: 'development',
+ *   environment: 'develop',
  *   debug: true,
  * });
  *
@@ -749,6 +773,7 @@ class PaymentCheckoutClient {
             productName: options.productName,
             price: options.price,
             extra: options.extra,
+            redirectUrl: options.redirectUrl,
         });
         // 自动打开支付弹窗
         this.showPaymentModal({
@@ -790,6 +815,7 @@ class PaymentCheckoutClient {
                 firstDays: options.firstDays ?? 0,
             },
             extra: options.extra,
+            redirectUrl: options.redirectUrl,
         });
         // 自动打开支付弹窗
         this.showPaymentModal({
@@ -866,6 +892,7 @@ class PaymentCheckoutClient {
         payment.setAttribute('transaction-id', options.transactionId);
         payment.setAttribute('environment', this.config.environment);
         payment.setAttribute('language', options.language ?? DEFAULT_CHECKOUT_CONFIG.language);
+        payment.setAttribute('api-host', this.config.apiHost);
         // 设置可选属性
         if (options.userName) {
             payment.setAttribute('user-name', options.userName);
@@ -17989,9 +18016,20 @@ if (typeof window !== "undefined" && !customElements.get("seaart-payment")) {
   customElements.define("seaart-payment", SeaArtPayment);
 }
 
-var seaartPayment = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    default: SeaArtPayment
+/**
+ * Internal module: SeaArt Payment Component Bundle
+ *
+ * This module re-exports @seaart/payment-component for internal bundling.
+ * End users don't need to install @seaart/payment-component separately -
+ * it's bundled into the SDK during the build process.
+ *
+ * @internal
+ */
+// Import and register the Web Component
+// This side-effect will register <seaart-payment> custom element
+
+var componentBundle = /*#__PURE__*/Object.freeze({
+    __proto__: null
 });
 
 var __defProp = Object.defineProperty;