@alipay/ams-checkout 0.0.1788166152-dev.7 → 0.0.1788166152-dev.8

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/util/logger.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/ams-checkout",
-  "version": "0.0.1788166152-dev.7",
+  "version": "0.0.1788166152-dev.8",
   "description": "",
   "author": "",
   "exports": {
@@ -89,6 +89,7 @@
     ]
   },
   "dependencies": {
+    "@antintl/opensdk-preload": "^0.0.20260831034810-yinan-kuro-dev.15",
     "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
@@ -8216,6 +8228,8 @@ declare interface PollingSetting {
     pollingTimes?: string;
 }
 
+/* Excluded from this release type: PreloadTelemetryContext */
+
 declare interface PromotionDetail {
     /**
      * @description promotion amount for mobile view
@@ -24882,6 +24896,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 内部使用，无需用户传递，高度信息
      */
@@ -8709,6 +8724,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 +25431,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>;