@alipay/ams-checkout 2.0.29 → 2.0.31

package/esm/modern/util/upgrade.d.ts

@@ -0,0 +1,39 @@
+export declare function isWebPlatform(platform?: string): boolean;
+export interface UpgradeItem {
+    productScene?: string;
+    v: string;
+    appVersion: string;
+    platform?: string;
+    mid?: string;
+    greyscale?: string;
+}
+export interface UpgradeSdkInfo {
+    productScene?: string;
+    sdkVersion: string;
+    appVersion?: string;
+    greyscale?: number;
+    mid?: string;
+}
+export declare function findUpgradeVersion(upgradeItems: UpgradeItem[], sdkInfo: UpgradeSdkInfo): string;
+export declare const getGrascaleId: (key?: string) => string;
+export declare function getGrayscaleValue(seed?: string): number;
+export declare function isGreyscaleMatch(item: UpgradeItem, randomGreyscale: number): boolean;
+/**
+ * 查询匹配到的版本
+ * @param _extendInfo
+ * @param param1
+ * @returns
+ */
+export declare const getMatchAppVersion: (_extendInfo: string, sdkInfo: UpgradeSdkInfo) => string;
+/**
+ * 获取保存的加载版本
+ * @param versionKey
+ * @returns
+ */
+export declare const getLastAppVersion: (versionKey: string) => string;
+/**
+ * 保存指定场景的加载版本供下次使用
+ * @param versionKey
+ * @returns
+ */
+export declare const setLastAppVersion: (versionKey: string, appVersion: string) => boolean;

package/esm/modern/util/versionCompare.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 返回值0标识一样大，1表示v1大，-1表示v2大
+ * @param v1
+ * @param v2
+ */
+export declare function compareVersion(v1: string, v2: string): 0 | 1 | -1;
+/**
+ * 判断version版本是否在range参数版本的范围内
+ * @param version
+ * @param range
+ * @returns
+ */
+export declare function isVersionInStringRange(version: string, range: string): boolean;
+export declare function isVersionInRange(currentVersion: any, minVersion: any, maxVersion: any): boolean;
+export declare function matchVersion(config: any, currentVersion: any): boolean;

package/esm/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.59.2"
+      "packageVersion": "7.60.0"
     }
   ]
 }

package/esm/types/index.d.ts

@@ -807,6 +807,12 @@ export interface IPaymentMethod {
     category?: string;
     paymentElements?: IPaymentElement[];
     paymentMethodId?: string;
+    /** Token 支付模式；缺失或 null 表示不支持 */
+    supportTokenizedMode?: 'EASYSAFEPAY' | 'TOKENIZEDPAY' | null;
+    /** Token 状态 */
+    paymentMethodIdStatus?: 'ACTIVE' | 'INACTIVE' | null;
+    /** 脱敏后的渠道账号 */
+    userLoginId?: string;
     paymentMethodDetail?: {
         last4?: string;
         requireIssuerAuthentication?: string;

package/esm/util/logger.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/ams-checkout",
-  "version": "2.0.29",
+  "version": "2.0.31",
   "description": "",
   "author": "",
   "exports": {
@@ -89,6 +89,7 @@
     ]
   },
   "dependencies": {
+    "@antintl/opensdk-preload": "^1.0.0",
     "axios": "^1.3.4",
     "proxy-polyfill": "^0.3.2",
     "uuid": "^9.0.0"

package/types.d.ts

@@ -203,6 +203,13 @@ export declare type AntomLayouts = 'tabs' | 'accordion';
 
 /* Excluded from this release type: AntomOpenModalConfig */
 
+export declare interface AntomPreloadConfig {
+    /** Elements2 types the merchant expects to create after loading the SDK. */
+    elements: AntomPreloadElement[];
+}
+
+export declare type AntomPreloadElement = 'payment' | 'express' | 'vaulting' | 'CVV';
+
 /**
  * @description The Antom main class, all uses are based on this class instance
  */
@@ -347,8 +354,8 @@ export declare const AntomSDKErrorCodes: {
     readonly ELEMENT_DEFINE_ERROR: "ELEMENT_DEFINE_ERROR";
     readonly ELEMENT_ALREADY_REGISTERED: "ELEMENT_ALREADY_REGISTERED";
     readonly CANNOT_CREATE_SAME_ELEMENT_TWICE: "CANNOT_CREATE_SAME_ELEMENT_TWICE";
-    readonly GROUPS_ONLY_ONE_MAIN_ELEMENT: "GROUPS_ONLY_ONE_MAIN_ELEMENT"; /** @deprecated 传入 elements 时无需重复传递，且不会覆盖 Element 的会话。 */
-    readonly GROUPS_NOT_FOUND_MAIN_ELEMENT: "GROUPS_NOT_FOUND_MAIN_ELEMENT"; /** 无 UI 模式必填，仅用于创建内部 CVVElement。 */
+    readonly GROUPS_ONLY_ONE_MAIN_ELEMENT: "GROUPS_ONLY_ONE_MAIN_ELEMENT";
+    readonly GROUPS_NOT_FOUND_MAIN_ELEMENT: "GROUPS_NOT_FOUND_MAIN_ELEMENT";
     readonly NOT_SUPPORT_ELEMENT: "NOT_SUPPORT_ELEMENT";
     readonly NOT_SUPPORT_SUBMIT: "NOT_SUPPORT_SUBMIT";
     readonly UPDATE_CONFIG_TIMEOUT: "UPDATE_CONFIG_TIMEOUT";
@@ -2331,6 +2338,7 @@ export declare interface CVVAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: renderData */
     /* Excluded from this release type: sdkVersion */
     /* Excluded from this release type: _requestConfig */
+    /* Excluded from this release type: preloadTelemetryContext */
     /**
      * @description 语言配置
      */
@@ -3287,6 +3295,7 @@ export declare interface ExpressAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: setupError */
     /* Excluded from this release type: locale */
     /* Excluded from this release type: _paypalSdkEnvironment */
+    /* Excluded from this release type: preloadTelemetryContext */
     /**
      * 是否运行在 Native App 的 WebView 中。
      * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
@@ -4793,6 +4802,8 @@ export declare interface LoadAntomConfig extends Omit<BaseFactoryConfig, 'tracke
      * @description 环境配置，默认为prod
      */
     env?: 'sandbox' | 'prod';
+    /** Starts best-effort Elements2 resource preload without delaying loadAntom. */
+    preload?: AntomPreloadConfig;
 }
 
 /**
@@ -7368,6 +7379,7 @@ export declare interface PaymentAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: sdkVersion */
     /* Excluded from this release type: _requestConfig */
     /* Excluded from this release type: logMetaData */
+    /* Excluded from this release type: preloadTelemetryContext */
     /* Excluded from this release type: heightOfVisible */
     /**
      * Amount & Currency
@@ -7802,6 +7814,33 @@ declare interface PaymentMethodView {
      * @description 分期银行信息列表
      */
     supportIppBankList?: FrontSupportIppBank[];
+    /**
+     * @description consult 是否打标该支付方式支持代扣(tokenPay)。
+     *
+     * <p>来源 iexpprod {@code PaymentOption.supportTokenPay}(Boolean, 默认 false), 仅当 iexpfront 显式传
+     * {@code PaymentFactor.markSupportTokenPay=true} 时 iexpprod 才会打标。 sdkQuery 内部流转字段。
+     */
+    supportTokenPay?: boolean;
+    /**
+     * @description tokenized 模式, 取值 EASYSAFEPAY / TOKENIZEDPAY；null 或缺失表示不支持。
+     *
+     * <p>sdkQuery 响应下发, submitPayByPaymentSession 由 SDK 原值回传; 服务端不信任前端回传值, 必须与会话上下文比对。
+     */
+    supportTokenizedMode?: 'EASYSAFEPAY' | 'TOKENIZEDPAY' | null;
+    /**
+     * @description 用户是否选择开启 token 支付(首次支付/授权场景的入口标识)。
+     *
+     * <p>submitPayByPaymentSession 请求入参, 由前端上报。
+     */
+    enableTokenPay?: boolean;
+    /**
+     * @description token(accessToken) 状态, 取值 ACTIVE / INACTIVE, 对齐 iexpprod facade {@code
+     * AlipayAccessTokenStatusEnum}。
+     *
+     * <p>sdkQuery 响应下发, 取 {@code PaymentMethodTokenDetail.alipayAccessTokenStatus}; 首次支付(无
+     * tokenDetail)不下发。
+     */
+    paymentMethodIdStatus?: 'ACTIVE' | 'INACTIVE' | null;
 }
 
 declare interface PaymentOption {
@@ -7925,6 +7964,14 @@ declare interface PaymentOption {
      * @description 支付支持的交互方式
      */
     interactionTypes?: string[];
+    /**
+     * @description 支付方式是否支持代扣(token pay)
+     * <p>
+     * 仅当请求侧 PaymentFactor.markSupportTokenPay=true 时才可能被置为 true;
+     * 默认 false, 未打标时与现状完全一致, 向后兼容。
+     * @default false
+     */
+    supportTokenPay?: boolean;
 }
 
 declare interface PaymentQuoteInfo {
@@ -8216,6 +8263,8 @@ declare interface PollingSetting {
     pollingTimes?: string;
 }
 
+/* Excluded from this release type: PreloadTelemetryContext */
+
 declare interface PromotionDetail {
     /**
      * @description promotion amount for mobile view
@@ -24882,6 +24931,7 @@ export declare interface VaultingAppConfig extends BaseElementAppConfig {
     /* Excluded from this release type: renderDataError */
     /* Excluded from this release type: sdkVersion */
     /* Excluded from this release type: _requestConfig */
+    /* Excluded from this release type: preloadTelemetryContext */
 }
 
 export declare type VaultingAppearance = PickAntomAppearance<VaultingAppearanceProps>;

package/types.untrimmed.d.ts

@@ -284,6 +284,13 @@ export declare interface AntomMiddlePageEventMap extends AntomBridgeEventMap {
 export declare interface AntomOpenModalConfig extends OpenModalParams {
 }
 
+export declare interface AntomPreloadConfig {
+    /** Elements2 types the merchant expects to create after loading the SDK. */
+    elements: AntomPreloadElement[];
+}
+
+export declare type AntomPreloadElement = 'payment' | 'express' | 'vaulting' | 'CVV';
+
 /**
  * @description The Antom main class, all uses are based on this class instance
  */
@@ -439,8 +446,8 @@ export declare const AntomSDKErrorCodes: {
     readonly ELEMENT_DEFINE_ERROR: "ELEMENT_DEFINE_ERROR";
     readonly ELEMENT_ALREADY_REGISTERED: "ELEMENT_ALREADY_REGISTERED";
     readonly CANNOT_CREATE_SAME_ELEMENT_TWICE: "CANNOT_CREATE_SAME_ELEMENT_TWICE";
-    readonly GROUPS_ONLY_ONE_MAIN_ELEMENT: "GROUPS_ONLY_ONE_MAIN_ELEMENT"; /** @deprecated 传入 elements 时无需重复传递，且不会覆盖 Element 的会话。 */
-    readonly GROUPS_NOT_FOUND_MAIN_ELEMENT: "GROUPS_NOT_FOUND_MAIN_ELEMENT"; /** 无 UI 模式必填，仅用于创建内部 CVVElement。 */
+    readonly GROUPS_ONLY_ONE_MAIN_ELEMENT: "GROUPS_ONLY_ONE_MAIN_ELEMENT";
+    readonly GROUPS_NOT_FOUND_MAIN_ELEMENT: "GROUPS_NOT_FOUND_MAIN_ELEMENT";
     readonly NOT_SUPPORT_ELEMENT: "NOT_SUPPORT_ELEMENT";
     readonly NOT_SUPPORT_SUBMIT: "NOT_SUPPORT_SUBMIT";
     readonly UPDATE_CONFIG_TIMEOUT: "UPDATE_CONFIG_TIMEOUT";
@@ -2738,6 +2745,8 @@ export declare interface CVVAppConfig extends BaseElementAppConfig {
      * @internal 内部联调使用，生产环境传递无效
      */
     _requestConfig?: Partial<Omit<RequestOptions, 'scope' | 'tracker'>>;
+    /** @internal Elements2 preload grouping data. */
+    preloadTelemetryContext?: PreloadTelemetryContext;
     /**
      * @description 语言配置
      */
@@ -3719,6 +3728,8 @@ export declare interface ExpressAppConfig extends BaseElementAppConfig {
     locale?: string;
     /** @internal PayPal v6 core script environment injected from the element env. */
     _paypalSdkEnvironment?: 'sandbox' | 'prod';
+    /** @internal Elements2 preload grouping data. */
+    preloadTelemetryContext?: PreloadTelemetryContext;
     /**
      * 是否运行在 Native App 的 WebView 中。
      * 为 true 时，跳转通过 onRedirect 事件委托给 Native 端处理。
@@ -5244,6 +5255,8 @@ export declare interface LoadAntomConfig extends Omit<BaseFactoryConfig, 'tracke
      * @description 环境配置，默认为prod
      */
     env?: 'sandbox' | 'prod';
+    /** Starts best-effort Elements2 resource preload without delaying loadAntom. */
+    preload?: AntomPreloadConfig;
 }
 
 /**
@@ -7852,6 +7865,8 @@ export declare interface PaymentAppConfig extends BaseElementAppConfig {
         merchantId?: string;
         paymentMethodType?: string;
     };
+    /** @internal Elements2 preload grouping data. */
+    preloadTelemetryContext?: PreloadTelemetryContext;
     /**
      * @internal 内部使用，无需用户传递，高度信息
      */
@@ -8295,6 +8310,33 @@ declare interface PaymentMethodView {
      * @description 分期银行信息列表
      */
     supportIppBankList?: FrontSupportIppBank[];
+    /**
+     * @description consult 是否打标该支付方式支持代扣(tokenPay)。
+     *
+     * <p>来源 iexpprod {@code PaymentOption.supportTokenPay}(Boolean, 默认 false), 仅当 iexpfront 显式传
+     * {@code PaymentFactor.markSupportTokenPay=true} 时 iexpprod 才会打标。 sdkQuery 内部流转字段。
+     */
+    supportTokenPay?: boolean;
+    /**
+     * @description tokenized 模式, 取值 EASYSAFEPAY / TOKENIZEDPAY；null 或缺失表示不支持。
+     *
+     * <p>sdkQuery 响应下发, submitPayByPaymentSession 由 SDK 原值回传; 服务端不信任前端回传值, 必须与会话上下文比对。
+     */
+    supportTokenizedMode?: 'EASYSAFEPAY' | 'TOKENIZEDPAY' | null;
+    /**
+     * @description 用户是否选择开启 token 支付(首次支付/授权场景的入口标识)。
+     *
+     * <p>submitPayByPaymentSession 请求入参, 由前端上报。
+     */
+    enableTokenPay?: boolean;
+    /**
+     * @description token(accessToken) 状态, 取值 ACTIVE / INACTIVE, 对齐 iexpprod facade {@code
+     * AlipayAccessTokenStatusEnum}。
+     *
+     * <p>sdkQuery 响应下发, 取 {@code PaymentMethodTokenDetail.alipayAccessTokenStatus}; 首次支付(无
+     * tokenDetail)不下发。
+     */
+    paymentMethodIdStatus?: 'ACTIVE' | 'INACTIVE' | null;
 }
 
 declare interface PaymentOption {
@@ -8418,6 +8460,14 @@ declare interface PaymentOption {
      * @description 支付支持的交互方式
      */
     interactionTypes?: string[];
+    /**
+     * @description 支付方式是否支持代扣(token pay)
+     * <p>
+     * 仅当请求侧 PaymentFactor.markSupportTokenPay=true 时才可能被置为 true;
+     * 默认 false, 未打标时与现状完全一致, 向后兼容。
+     * @default false
+     */
+    supportTokenPay?: boolean;
 }
 
 declare interface PaymentQuoteInfo {
@@ -8709,6 +8759,22 @@ declare interface PollingSetting {
     pollingTimes?: string;
 }
 
+/** @internal Telemetry context passed to Elements2 through the existing handshake. */
+export declare interface PreloadTelemetryContext {
+    requested: boolean;
+    phaseAtElementCreate: 'not_requested' | 'resolving' | 'running' | 'critical_completed' | 'failed' | 'skipped';
+    leadTimeMs?: number;
+    criticalDurationMs?: number;
+    taskId?: string;
+    preconnectedRegions?: readonly ('SG' | 'US' | 'DE')[];
+    preconnectionMode?: 'configured' | 'regional';
+    actualRegion?: string;
+    predictionResult?: 'hit' | 'miss';
+    preconnectionStatus?: 'running' | 'completed' | 'partial_failed' | 'failed';
+    preconnectionLeadTimeMs?: number;
+    preconnectionReadyBeforeFirstRpc?: boolean;
+}
+
 declare interface PromotionDetail {
     /**
      * @description promotion amount for mobile view
@@ -25400,6 +25466,8 @@ export declare interface VaultingAppConfig extends BaseElementAppConfig {
      * @internal 内部联调使用，生产环境传递无效
      */
     _requestConfig?: Partial<Omit<RequestOptions, 'scope' | 'tracker'>>;
+    /** @internal Elements2 preload grouping data. */
+    preloadTelemetryContext?: PreloadTelemetryContext;
 }
 
 export declare type VaultingAppearance = PickAntomAppearance<VaultingAppearanceProps>;