@seaverse/payment-sdk 0.9.0 → 0.9.2

package/dist/index.d.ts

@@ -1032,10 +1032,96 @@ declare const BIZ_CODE: {
     readonly INVALID_ORDER_STATUS: 4006;
 };
 
+/**
+ * 共享类型定义
+ * Shared types for CreditPackageModal and GenericPackageModal
+ */
+
+/** 环境类型 */
+type Environment = 'development' | 'production';
+/** 环境配置接口 */
+interface EnvironmentConfig {
+    /** SDK 脚本 URL */
+    scriptUrl: string;
+    /** 客户端 ID */
+    clientId: string;
+    /** 订单 API 地址 */
+    orderApiUrl: string;
+    /** 钱包 API 地址 */
+    walletApiUrl: string;
+    /** CSS 文件 URL */
+    cssUrl: string;
+}
+/**
+ * 语言代码（ISO 639-1 + BCP 47 区域子标签）
+ *
+ * 格式说明：
+ * - 基础码：ISO 639-1 两字母语言码（en, zh, ja, ko...）
+ * - 区域变体：BCP 47 格式 language-REGION（zh-CN, zh-TW, pt-BR...）
+ * - zh-CN / zh-TW 需要区分简繁体，不能只用 zh
+ */
+type LocaleCode = 'en' | 'zh' | 'zh-TW' | 'ja' | 'ko' | 'es' | 'fr' | 'de' | 'pt' | 'ru' | 'ar' | 'hi' | 'id';
+/** 国家/地区代码（ISO 3166-1 alpha-2） */
+type CountryCode = 'US' | 'CN' | 'TW' | 'JP' | 'KR' | 'ES' | 'FR' | 'DE' | 'PT' | 'BR' | 'RU' | 'SA' | 'IN' | 'ID';
+/**
+ * SDK 配置选项 - 简化版（支持环境变量）
+ * 用户只需提供 environment、countryCode、accountToken 三个核心参数
+ * SDK 会自动根据 environment 选择对应的配置
+ */
+interface PaymentSDKConfig {
+    /** 环境变量（development/production） - SDK 自动选择对应配置 */
+    environment: Environment;
+    /** 国家/地区代码 */
+    countryCode?: CountryCode;
+    /** 账户 Token（用于用户认证） */
+    accountToken: string;
+    /** 业务类型：1-一次性，2-订阅（可选，默认为 1） */
+    businessType?: 1 | 2;
+    /** 脚本加载超时（毫秒，默认 10000ms） */
+    scriptTimeout?: number;
+    /** 支付方式类型过滤（可选，默认 'dropin'） */
+    paymentMethodType?: string;
+    /** 自定义脚本 URL（覆盖环境配置） */
+    scriptUrl?: string;
+    /** 自定义客户端 ID（覆盖环境配置） */
+    clientId?: string;
+    /** 自定义订单 API 地址（覆盖环境配置） */
+    orderApiUrl?: string;
+    /** 自定义 CSS URL（覆盖环境配置） */
+    cssUrl?: string;
+}
+/**
+ * Base package modal options - common configuration for all package modals
+ */
+interface BasePackageModalOptions<TPackage extends BasePackage> {
+    /** SDK configuration (required for automatic SDK initialization) */
+    sdkConfig: PaymentSDKConfig;
+    /** Language (default 'en') */
+    language: LocaleCode;
+    /**
+     * Payment success callback - notifies when payment is completed
+     * @param orderId Order ID
+     * @param transactionId Transaction ID
+     * @param pkg Purchased package
+     */
+    onPaymentSuccess?: (orderId: string, transactionId: string, pkg: TPackage) => void;
+    /**
+     * Payment failed callback
+     * @param error Error information
+     * @param pkg Package that failed to purchase
+     */
+    onPaymentFailed?: (error: Error, pkg: TPackage) => void;
+    /** Modal close callback */
+    onClose?: () => void;
+    paymentMethod?: PaymentMethod;
+    accountToken?: string;
+}
+
 /**
  * SeaartPayment Types
  * SeaartPaymentComponent SDK 相关类型定义
  */
+
 declare global {
     interface Window {
         SeaartPaymentComponent: SeaartPaymentComponentSDK;
@@ -1187,7 +1273,7 @@ interface SeaartPaymentSDKConfig {
     /** 客户端 ID */
     clientId: string;
     /** 语言 */
-    language?: string;
+    language?: LocaleCode;
     /** 脚本加载超时（毫秒） */
     scriptTimeout?: number;
     /** CSS 样式表 URL（可选） */
@@ -1569,9 +1655,10 @@ declare class PaymentModal {
  *
  * 设计风格：深色卡片 + 清晰信息层次 + 渐变 CTA 按钮
  */
+
 interface RetentionModalOptions {
     /** 语言，默认 'en' */
-    language?: 'en' | 'zh-CN';
+    language?: LocaleCode;
     /** 商品名称 */
     productName: string;
     /** 购买数量（积分数等） */
@@ -1767,80 +1854,6 @@ declare class SeaartPaymentSDK {
     destroy(): void;
 }
 
-/**
- * 共享类型定义
- * Shared types for CreditPackageModal and GenericPackageModal
- */
-
-/** 环境类型 */
-type Environment = 'development' | 'production';
-/** 环境配置接口 */
-interface EnvironmentConfig {
-    /** SDK 脚本 URL */
-    scriptUrl: string;
-    /** 客户端 ID */
-    clientId: string;
-    /** 订单 API 地址 */
-    orderApiUrl: string;
-    /** 钱包 API 地址 */
-    walletApiUrl: string;
-    /** CSS 文件 URL */
-    cssUrl: string;
-}
-/**
- * SDK 配置选项 - 简化版（支持环境变量）
- * 用户只需提供 environment、countryCode、accountToken 三个核心参数
- * SDK 会自动根据 environment 选择对应的配置
- */
-interface PaymentSDKConfig {
-    /** 环境变量（development/production） - SDK 自动选择对应配置 */
-    environment: Environment;
-    /** 国家/地区代码 */
-    countryCode: string;
-    /** 账户 Token（用于用户认证） */
-    accountToken?: string;
-    /** 业务类型：1-一次性，2-订阅（可选，默认为 1） */
-    businessType?: 1 | 2;
-    /** 脚本加载超时（毫秒，默认 10000ms） */
-    scriptTimeout?: number;
-    /** 支付方式类型过滤（可选，默认 'dropin'） */
-    paymentMethodType?: string;
-    /** 自定义脚本 URL（覆盖环境配置） */
-    scriptUrl?: string;
-    /** 自定义客户端 ID（覆盖环境配置） */
-    clientId?: string;
-    /** 自定义订单 API 地址（覆盖环境配置） */
-    orderApiUrl?: string;
-    /** 自定义 CSS URL（覆盖环境配置） */
-    cssUrl?: string;
-}
-/**
- * Base package modal options - common configuration for all package modals
- */
-interface BasePackageModalOptions<TPackage extends BasePackage> {
-    /** SDK configuration (required for automatic SDK initialization) */
-    sdkConfig: PaymentSDKConfig;
-    /** Language (default 'en') */
-    language?: 'en' | 'zh-CN';
-    /**
-     * Payment success callback - notifies when payment is completed
-     * @param orderId Order ID
-     * @param transactionId Transaction ID
-     * @param pkg Purchased package
-     */
-    onPaymentSuccess?: (orderId: string, transactionId: string, pkg: TPackage) => void;
-    /**
-     * Payment failed callback
-     * @param error Error information
-     * @param pkg Package that failed to purchase
-     */
-    onPaymentFailed?: (error: Error, pkg: TPackage) => void;
-    /** Modal close callback */
-    onClose?: () => void;
-    paymentMethod?: PaymentMethod;
-    accountToken?: string;
-}
-
 /**
  * BasePackageModal - Abstract base class for package modals
  * Provides shared logic for SDK initialization, payment flow, and event handling
@@ -1853,7 +1866,7 @@ interface BasePackageModalOptions<TPackage extends BasePackage> {
 declare abstract class BasePackageModal<TPackage extends BasePackage, TOptions extends BasePackageModalOptions<TPackage>> {
     protected modal: PaymentModal;
     protected options: TOptions;
-    protected language: 'en' | 'zh-CN';
+    protected language: LocaleCode;
     protected resizeHandler: (() => void) | null;
     protected isInitializingSDK: boolean;
     protected sdkInitialized: boolean;
@@ -1960,6 +1973,17 @@ declare class CreditPackageModal extends BasePackageModal<CreditPackageItem, Cre
      * Override open to fetch packages before rendering
      */
     open(): Promise<void>;
+    /**
+     * 覆盖 BasePackageModal 的 initializeSDK 方法
+     * CreditPackageModal 使用 PaymentCheckoutModal，不需要 BasePackageModal 的 SDK 初始化
+     * PaymentCheckoutModal 会自行处理 SDK 初始化
+     */
+    protected initializeSDK(): Promise<void>;
+    /**
+     * 覆盖 BasePackageModal 的 waitForSDKInitialization 方法
+     * CreditPackageModal 使用 PaymentCheckoutModal，不需要等待 BasePackageModal 的 SDK 初始化
+     */
+    protected waitForSDKInitialization(_timeout?: number, _maxRetries?: number): Promise<boolean>;
     /**
      * Create and configure the PaymentModal instance
      */
@@ -2029,6 +2053,17 @@ interface GenericPackageModalOptions extends BasePackageModalOptions<GenericPack
 }
 declare class GenericPackageModal extends BasePackageModal<GenericPackage, GenericPackageModalOptions> {
     constructor(options: GenericPackageModalOptions);
+    /**
+     * 覆盖 BasePackageModal 的 initializeSDK 方法
+     * GenericPackageModal 使用 PaymentCheckoutModal，不需要 BasePackageModal 的 SDK 初始化
+     * PaymentCheckoutModal 会自行处理 SDK 初始化
+     */
+    protected initializeSDK(): Promise<void>;
+    /**
+     * 覆盖 BasePackageModal 的 waitForSDKInitialization 方法
+     * GenericPackageModal 使用 PaymentCheckoutModal，不需要等待 BasePackageModal 的 SDK 初始化
+     */
+    protected waitForSDKInitialization(_timeout?: number, _maxRetries?: number): Promise<boolean>;
     /**
      * Create and configure the PaymentModal instance
      */
@@ -2202,7 +2237,7 @@ interface AutoCreateOrderConfig {
     /** 客户端 ID */
     clientId: string;
     /** 国家代码 */
-    countryCode: string;
+    language_code: LocaleCode;
 }
 /**
  * PaymentCheckoutModal 配置选项
@@ -2245,7 +2280,7 @@ interface PaymentCheckoutModalOptions {
     /** 用户账号名称 */
     accountName?: string;
     /** 语言设置 */
-    language?: 'en' | 'zh-CN';
+    language?: LocaleCode;
 }
 
 /**
@@ -2327,7 +2362,10 @@ declare class PaymentCheckoutModal {
      */
     private renderPaymentMethods;
     /**
-     * 自动选中默认支付方式（优先选中第一个 Dropin 支付方式）
+     * 自动选中默认支付方式
+     * 策略：
+     * - 如果有 Dropin（payment_type === 2），自动选中并渲染表单
+     * - 如果只有 Link（payment_type === 1），不自动选中，让用户手动选择
      */
     private autoSelectDefaultPaymentMethod;
     /**
@@ -2452,6 +2490,16 @@ declare function hideLoadingIndicator(loader?: HTMLElement | null): void;
  */
 declare function showInfoMessage(message: string, duration?: number): void;
 
+/**
+ * PurchaseSuccessModal - 购买成功弹窗
+ * 纯 JavaScript 实现，不依赖 React
+ *
+ * 参考设计: credit-pack-success-modal
+ * - 邮件确认卡片风格
+ * - 精美的动画效果（淡入淡出、缩放）
+ * - 包含成功图标、套餐详情、积分数、支付金额
+ */
+
 interface PurchaseSuccessData {
     /** 套餐名称 */
     packName: string;
@@ -2470,7 +2518,7 @@ interface PurchaseSuccessModalOptions {
     /** 购买成功数据 */
     data: PurchaseSuccessData;
     /** 语言，默认 'en' */
-    language?: 'en' | 'zh-CN';
+    language?: LocaleCode;
     /** 关闭回调 */
     onClose?: () => void;
 }
@@ -2540,9 +2588,10 @@ declare class PurchaseSuccessModal {
  * 样式完全参考 next-meta 项目的设计
  * 按钮逻辑参考 @seaart/payment-component
  */
+
 interface PaymentVerificationOptions {
     /** 语言，默认 'en' */
-    language?: 'en' | 'zh-CN';
+    language?: LocaleCode;
     /** 交易ID */
     transactionId: string;
     /** 产品名称（可选） */
@@ -2645,9 +2694,10 @@ declare class PaymentVerificationModal {
  * 样式与 PaymentVerificationModal 保持一致
  * 深蓝渐变主题背景，按钮样式统一
  */
+
 interface PaymentFailedModalOptions {
     /** 语言，默认 'en' */
-    language?: 'en' | 'zh-CN';
+    language?: LocaleCode;
     /** 错误标题 */
     title?: string;
     /** 错误消息 */
@@ -2989,6 +3039,7 @@ declare function fetchAvailablePackages(apiHost: string, token: string): Promise
  * - SVG 徽章装饰（首充双倍）
  * - 悬停微交互和平滑过渡
  */
+
 interface CreditPackCardOptions {
     /** 积分包 ID */
     id: string;
@@ -3009,7 +3060,7 @@ interface CreditPackCardOptions {
     /** 是否首充双倍 */
     isFirstPurchase?: boolean;
     /** 语言 */
-    language?: 'en' | 'zh-CN';
+    language?: LocaleCode;
     /** 点击购买回调 */
     onBuy: (packId: string) => Promise<void>;
 }
@@ -3090,7 +3141,7 @@ declare class CreditPackCard {
 /**
  * SDK version
  */
-declare const VERSION = "0.9.0";
+declare const VERSION = "0.9.2";
 
 export { API_ENDPOINTS, BIZ_CODE, BindCardPaymentComponent, COMPONENT_LOAD_TIMEOUT, CheckoutAPI, CreditPackCard, CreditPackageModal, DEFAULT_CHECKOUT_CONFIG, DropinPaymentComponent, DropinPaymentModal, ENVIRONMENT_CONFIGS, ENV_CONFIG, ErrorHandler, GRID_COLUMNS, GenericPackageModal, HTTP_STATUS, LinkPaymentComponent, OrderPayment, PAYMENT_ELEMENT_NAME, PaymentAPIError, PaymentCheckoutClient, PaymentCheckoutModal, PaymentClient, PaymentError, PaymentFailedModal, PaymentModal, PaymentStorage, PaymentVerificationModal, PurchaseSuccessModal, RESPONSIVE_BREAKPOINTS, RetentionModal, SDK_CONFIG, ScriptLoader, SeaArtPayLoader, SeaartPaymentSDK, StylesheetLoader, VERSION, centsToDollars, changeSubscription, checkOrderStatus, createCheckoutPaymentError, createOrder, delay, dollarsToCents, fetchAvailablePackages, formatPrice, generateOrderReference, getActiveSubscription, getCreditDetail, getCurrentSubscription, getCurrentUrl, getGlobalLoader, getSDKLocale, hideLoadingIndicator, isBrowser, isCheckoutPaymentError, pollOrderStatus, resetGlobalLoader, restartSubscription, safeJsonParse, showErrorMessage, showInfoMessage, showLoadingIndicator, showSuccessMessage, withTimeout };
-export type { ActiveSubscription, ApiErrorResponse, ApiResponse, ApiSuccessResponse, AutoCreateOrderConfig, AvailablePackagesResponse, BaseCheckoutOptions, BillingPeriod$1 as BillingPeriod, BindCard, BindCardCallbacks, BindCardPaymentOptions, CheckoutAPIConfig, CheckoutAPIResponse, CheckoutClientConfig, CheckoutClientStatus, CheckoutOptions, CheckoutPaymentError, CheckoutPaymentErrorCode, CheckoutResult, ComponentLoadStatus, CreateOrderResponse, CreditAccount, CreditAccountStatus, CreditDetailResponse$1 as CreditDetailResponse, CreditDetailSuccessResponse, CreditPackCardOptions, CreditPackageModalOptions, CreditPoolDetail, CreditPoolType$1 as CreditPoolType, CreditTransaction, CurrentSubscription, DropinCallbacks, DropinPaymentModalOptions, DropinPaymentOptions, Environment, EnvironmentConfig, GenericPackage, GenericPackageModalOptions, LinkPaymentOptions, ListTransactionsRequest, LoaderConfig, OrderInfo, OrderStatus, OrderStatusResponse, PaymentCheckoutModalOptions, PaymentClientOptions, PaymentEnvironment, PaymentFailedModalOptions, PaymentMethod, PaymentMethodsParams, PaymentModalOptions, PaymentReadyEventDetail, PaymentResult, PaymentSDKConfig, PaymentSuccessEventDetail, PaymentUnsuccessEventDetail, PaymentUnsuccessResult, PaymentVerificationOptions, Product, PurchaseSuccessData, PurchaseSuccessModalOptions, PurchaseType, RetentionModalOptions, SDKCheckoutRequest, SDKCheckoutResponse, SDKConfig, SDKLoadStatus, ScriptLoaderOptions, SeaArtPaymentElement, SeaartBindCardPayment, SeaartDropinPayment, SeaartLinkPayment, SeaartPaymentComponentSDK, SeaartPaymentInstance, SeaartPaymentSDKConfig, ShowPaymentOptions, SubscribeOptions, SubscriptionParams, SubscriptionPeriod, TransactionListResponse, TransactionStatus, TransactionStorageData, TransactionType };
+export type { ActiveSubscription, ApiErrorResponse, ApiResponse, ApiSuccessResponse, AutoCreateOrderConfig, AvailablePackagesResponse, BaseCheckoutOptions, BillingPeriod$1 as BillingPeriod, BindCard, BindCardCallbacks, BindCardPaymentOptions, CheckoutAPIConfig, CheckoutAPIResponse, CheckoutClientConfig, CheckoutClientStatus, CheckoutOptions, CheckoutPaymentError, CheckoutPaymentErrorCode, CheckoutResult, ComponentLoadStatus, CreateOrderResponse, CreditAccount, CreditAccountStatus, CreditDetailResponse$1 as CreditDetailResponse, CreditDetailSuccessResponse, CreditPackCardOptions, CreditPackageModalOptions, CreditPoolDetail, CreditPoolType$1 as CreditPoolType, CreditTransaction, CurrentSubscription, DropinCallbacks, DropinPaymentModalOptions, DropinPaymentOptions, Environment, EnvironmentConfig, GenericPackage, GenericPackageModalOptions, LinkPaymentOptions, ListTransactionsRequest, LoaderConfig, LocaleCode, OrderInfo, OrderStatus, OrderStatusResponse, PaymentCheckoutModalOptions, PaymentClientOptions, PaymentEnvironment, PaymentFailedModalOptions, PaymentMethod, PaymentMethodsParams, PaymentModalOptions, PaymentReadyEventDetail, PaymentResult, PaymentSDKConfig, PaymentSuccessEventDetail, PaymentUnsuccessEventDetail, PaymentUnsuccessResult, PaymentVerificationOptions, Product, PurchaseSuccessData, PurchaseSuccessModalOptions, PurchaseType, RetentionModalOptions, SDKCheckoutRequest, SDKCheckoutResponse, SDKConfig, SDKLoadStatus, ScriptLoaderOptions, SeaArtPaymentElement, SeaartBindCardPayment, SeaartDropinPayment, SeaartLinkPayment, SeaartPaymentComponentSDK, SeaartPaymentInstance, SeaartPaymentSDKConfig, ShowPaymentOptions, SubscribeOptions, SubscriptionParams, SubscriptionPeriod, TransactionListResponse, TransactionStatus, TransactionStorageData, TransactionType };