@alipay/ams-checkout 2.0.22 → 2.0.24

package/esm/util/logger.js

@@ -296,6 +296,6 @@ export var LogConfig = {
   version: 'iteration/20231021',
   mdata: {
     firstLogTime: Date.now(),
-    sdkVersion: "2.0.22"
+    sdkVersion: "2.0.24"
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/ams-checkout",
-  "version": "2.0.22",
+  "version": "2.0.24",
   "description": "",
   "author": "",
   "exports": {

package/types.d.ts

@@ -629,6 +629,8 @@ declare type AxiosHeaderMatcher =
 | RegExp
 | ((this: AxiosHeaders, value: string, name: string) => boolean);
 
+declare type AxiosHeaderParameters = Record<string, string>;
+
 declare type AxiosHeaderParser = (this: AxiosHeaders, value: AxiosHeaderValue, header: string) => any;
 
 declare class AxiosHeaders {
@@ -644,6 +646,7 @@ declare class AxiosHeaders {
     set(headers?: RawAxiosHeaders | AxiosHeaders | string, rewrite?: boolean): AxiosHeaders;
     set(headers?: Iterable<[string, AxiosHeaderValue]>, rewrite?: boolean): AxiosHeaders;
 
+    get(headerName: string, parser: typeof AxiosHeaders.parseParameters): AxiosHeaderParameters;
     get(headerName: string, parser: RegExp): RegExpExecArray | null;
     get(headerName: string, matcher?: true | AxiosHeaderParser): AxiosHeaderValue;
 
@@ -665,6 +668,8 @@ declare class AxiosHeaders {
 
     static from(thing?: AxiosHeaders | RawAxiosHeaders | string): AxiosHeaders;
 
+    static parseParameters(value: AxiosHeaderValue): AxiosHeaderParameters;
+
     static accessor(header: string | string[]): AxiosHeaders;
 
     static concat(
@@ -767,6 +772,7 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
     /* Excluded from this release type: "OPENSDK@CLOSE_MODAL" */
     /* Excluded from this release type: "OPENSDK@REDIRECT" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_MODAL_PORT" */
+    /* Excluded from this release type: "OPENSDK@MODAL_TRANSFER_READY" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_MODAL_APPEARANCE" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_MODAL_INITIALDATA" */
     /* Excluded from this release type: "OPENSDK@TRANSFER_APP_PORT" */
@@ -920,6 +926,7 @@ declare abstract class BaseFactory {
     /* Excluded from this release type: globalBridgeForModal */
     /* Excluded from this release type: openModalHandle */
     /* Excluded from this release type: elementClasses */
+    /* Excluded from this release type: modalIsReady */
     /**
      * @param config 配置
      */
@@ -3165,10 +3172,8 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
      */
     paymentMethods?: string[];
     /* Excluded from this release type: setupError */
-    /**
-     * Locale for internationalization, passed from entry params (loadAntom), default to en_US
-     */
-    locale?: string;
+    /* Excluded from this release type: locale */
+    /* Excluded from this release type: _paypalSdkEnvironment */
     /**
      * 是否运行在 Native App 的 WebView 中。
      * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
@@ -3256,9 +3261,7 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
     private _paypalOverlay;
     constructor(name: string, config: ExpressElementConfig);
     /**
-     * 重写 on：
-     * 1. 对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
-     * 2. 对 onRedirect 事件同步注册到 _localHandlers（SDK host 主动推送时商户能收到）
+     * 重写 on：对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
      */
     on(event: string, handler: (...args: any[]) => void): void;
     /**
@@ -3279,6 +3282,8 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
             code: string;
             message: string;
         };
+        /** 用户是否手动关闭 3D 弹窗（透传 webapp COMPLETE_PAYMENT_RESULT.userCanceled3D） */
+        userCanceled3D?: boolean;
     }>;
     setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     private registerInternalListeners;
@@ -3377,6 +3382,14 @@ export declare interface ExpressElementEvents extends AntomBridgeWithNativeEvent
     };
 }
 
+declare type ExpressPaymentMethod = (typeof SUPPORTED_EXPRESS_METHODS)[number];
+
+declare type ExpressSetupError = ErrorPayload & {
+    expressPaymentType?: ExpressPaymentMethod;
+    /** 服务端返回的 errorMessage 已完成国际化，可直接对客展示 */
+    mulityLanguageMapping?: boolean;
+};
+
 declare interface ExpSupportBank {
     /**
      * @description 银行名称
@@ -6676,11 +6689,14 @@ declare interface OneAccountQueryResult {
  */
 declare type OpenModalHandle = {
     destroy: () => void;
-    onLoadedSuccess: (onLoadSuccess: () => void) => void;
+    /**
+     * @deprecated 移除，内部监听ready事件
+     */
+    onLoadedSuccess?: (onLoadSuccess: () => void) => void;
     getContentWindow: () => Window | null;
 };
 
-declare interface OpenModalParams extends BaseOpenModalConfig {
+declare interface OpenModalParams extends Omit<BaseOpenModalConfig, 'hideCloseWhenLoaded'> {
     mode: 'desktop' | 'mobile';
     loadingConfig?: {
         theme?: 'light' | 'dark';
@@ -6904,6 +6920,15 @@ export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearan
     /* Excluded from this release type: _requestConfig */
     /* Excluded from this release type: logMetaData */
     /* Excluded from this release type: heightOfVisible */
+    /**
+     * Amount & Currency
+     *
+     * Only effective via `updateConfig({ amount })` at runtime.
+     */
+    amount?: {
+        currency: string;
+        value: string;
+    };
 }
 
 /**
@@ -6921,8 +6946,13 @@ export declare type PaymentAppearance = PickAppearance<{
  */
 export declare class PaymentElement extends BaseMainElement<PaymentElementConfig, PaymentElementEvents> {
     static elementType: string;
+    private _paymentInProgress;
     constructor(name: string, config: PaymentElementConfig);
     /* Excluded from this release type: setup */
+    /**
+     * @description Update payment element configuration with amount validation
+     */
+    updateConfig(newConfig: Pick<PaymentAppConfig, 'amount'>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
     /* Excluded from this release type: submit */
     protected focus(): void;
     protected blur(): void;
@@ -23785,6 +23815,10 @@ export declare type SubmitResult = {
          * 查询到的结果消息
          */
         message?: string;
+        /**
+         * @description 接口错误时的链路追踪 id，用于定位排查根因（非错误状态无该字段）
+         */
+        traceId?: string;
         /**
          * @description 是否需要更换 session 重试
          */
@@ -23906,6 +23940,8 @@ declare interface SubscriptionPricePlan {
     pricePlanAmountView?: PaymentView;
 }
 
+declare const SUPPORTED_EXPRESS_METHODS: readonly ["paypal", "applePay", "googlePay", "alipay"];
+
 declare type SvgAttributes =
 | "[-khtml-opacity]"
 | "[-moz-opacity]"

package/types.untrimmed.d.ts

@@ -306,7 +306,6 @@ export declare class AntomSDK extends BaseElementsFactory {
      */
     protected openModal(payload: AntomOpenModalConfig): Promise<{
         destroy: () => void;
-        onLoadedSuccess: (onLoadSuccess: () => void) => void;
         getContentWindow: () => Window;
     }>;
     elements(): Elements;
@@ -722,6 +721,8 @@ declare type AxiosHeaderMatcher =
 | RegExp
 | ((this: AxiosHeaders, value: string, name: string) => boolean);
 
+declare type AxiosHeaderParameters = Record<string, string>;
+
 declare type AxiosHeaderParser = (this: AxiosHeaders, value: AxiosHeaderValue, header: string) => any;
 
 declare class AxiosHeaders {
@@ -737,6 +738,7 @@ declare class AxiosHeaders {
     set(headers?: RawAxiosHeaders | AxiosHeaders | string, rewrite?: boolean): AxiosHeaders;
     set(headers?: Iterable<[string, AxiosHeaderValue]>, rewrite?: boolean): AxiosHeaders;
 
+    get(headerName: string, parser: typeof AxiosHeaders.parseParameters): AxiosHeaderParameters;
     get(headerName: string, parser: RegExp): RegExpExecArray | null;
     get(headerName: string, matcher?: true | AxiosHeaderParser): AxiosHeaderValue;
 
@@ -758,6 +760,8 @@ declare class AxiosHeaders {
 
     static from(thing?: AxiosHeaders | RawAxiosHeaders | string): AxiosHeaders;
 
+    static parseParameters(value: AxiosHeaderValue): AxiosHeaderParameters;
+
     static accessor(header: string | string[]): AxiosHeaders;
 
     static concat(
@@ -898,6 +902,10 @@ declare interface BaseBridgeEventMap<AppConfig extends Record<string, any> = Rec
      * @internal 内部事件 不暴露给商户
      */
     "OPENSDK@TRANSFER_MODAL_PORT": string;
+    /**
+     * @internal 内部事件 不暴露给商户
+     */
+    "OPENSDK@MODAL_TRANSFER_READY": void;
     /**
      * @internal 内部事件 不暴露给商户
      */
@@ -1228,6 +1236,11 @@ declare abstract class BaseFactory {
      * @internal
      */
     protected elementClasses: Record<string, iBaseElementClass | undefined>;
+    /**
+     * @description modal是否已准备好
+     * @internal
+     */
+    private modalIsReady;
     /**
      * @param config 配置
      */
@@ -3580,11 +3593,13 @@ export declare interface ExpressAppConfig extends BaseAppearance<AppearanceSetti
     /**
      * @internal setup 阶段的错误信息，传给 iframe 侧处理
      */
-    setupError?: ErrorPayload;
+    setupError?: ExpressSetupError;
     /**
-     * Locale for internationalization, passed from entry params (loadAntom), default to en_US
+     * @internal Locale is injected from loadAntom and defaults to en_US.
      */
     locale?: string;
+    /** @internal PayPal v6 core script environment injected from the element env. */
+    _paypalSdkEnvironment?: 'sandbox' | 'prod';
     /**
      * 是否运行在 Native App 的 WebView 中。
      * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
@@ -3674,9 +3689,7 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
     private _paypalOverlay;
     constructor(name: string, config: ExpressElementConfig);
     /**
-     * 重写 on：
-     * 1. 对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
-     * 2. 对 onRedirect 事件同步注册到 _localHandlers（SDK host 主动推送时商户能收到）
+     * 重写 on：对 confirm 事件拦截，在商户回调执行前注入 paymentFailed()
      */
     on(event: string, handler: (...args: any[]) => void): void;
     /**
@@ -3697,6 +3710,8 @@ export declare class ExpressElement extends BaseMainElement<ExpressElementConfig
             code: string;
             message: string;
         };
+        /** 用户是否手动关闭 3D 弹窗（透传 webapp COMPLETE_PAYMENT_RESULT.userCanceled3D） */
+        userCanceled3D?: boolean;
     }>;
     setup(): Promise<Partial<ExpressAppConfig> | undefined>;
     private registerInternalListeners;
@@ -3795,6 +3810,14 @@ export declare interface ExpressElementEvents extends AntomBridgeWithNativeEvent
     };
 }
 
+declare type ExpressPaymentMethod = (typeof SUPPORTED_EXPRESS_METHODS)[number];
+
+declare type ExpressSetupError = ErrorPayload & {
+    expressPaymentType?: ExpressPaymentMethod;
+    /** 服务端返回的 errorMessage 已完成国际化，可直接对客展示 */
+    mulityLanguageMapping?: boolean;
+};
+
 declare interface ExpSupportBank {
     /**
      * @description 银行名称
@@ -7094,11 +7117,14 @@ declare interface OneAccountQueryResult {
  */
 declare type OpenModalHandle = {
     destroy: () => void;
-    onLoadedSuccess: (onLoadSuccess: () => void) => void;
+    /**
+     * @deprecated 移除，内部监听ready事件
+     */
+    onLoadedSuccess?: (onLoadSuccess: () => void) => void;
     getContentWindow: () => Window | null;
 };
 
-declare interface OpenModalParams extends BaseOpenModalConfig {
+declare interface OpenModalParams extends Omit<BaseOpenModalConfig, 'hideCloseWhenLoaded'> {
     mode: 'desktop' | 'mobile';
     loadingConfig?: {
         theme?: 'light' | 'dark';
@@ -7358,6 +7384,15 @@ export declare interface PaymentAppConfig extends BaseAppearance<PaymentAppearan
      * @internal 内部使用，无需用户传递，高度信息
      */
     heightOfVisible?: number;
+    /**
+     * Amount & Currency
+     *
+     * Only effective via `updateConfig({ amount })` at runtime.
+     */
+    amount?: {
+        currency: string;
+        value: string;
+    };
 }
 
 /**
@@ -7375,11 +7410,16 @@ export declare type PaymentAppearance = PickAppearance<{
  */
 export declare class PaymentElement extends BaseMainElement<PaymentElementConfig, PaymentElementEvents> {
     static elementType: string;
+    private _paymentInProgress;
     constructor(name: string, config: PaymentElementConfig);
     /**
      * @internal
      */
     setup(): Promise<Partial<PaymentAppConfig> | undefined>;
+    /**
+     * @description Update payment element configuration with amount validation
+     */
+    updateConfig(newConfig: Pick<PaymentAppConfig, 'amount'>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
     /**
      * @internal
      */
@@ -24255,6 +24295,10 @@ export declare type SubmitResult = {
          * 查询到的结果消息
          */
         message?: string;
+        /**
+         * @description 接口错误时的链路追踪 id，用于定位排查根因（非错误状态无该字段）
+         */
+        traceId?: string;
         /**
          * @description 是否需要更换 session 重试
          */
@@ -24376,6 +24420,8 @@ declare interface SubscriptionPricePlan {
     pricePlanAmountView?: PaymentView;
 }
 
+declare const SUPPORTED_EXPRESS_METHODS: readonly ["paypal", "applePay", "googlePay", "alipay"];
+
 declare type SvgAttributes =
 | "[-khtml-opacity]"
 | "[-moz-opacity]"