@alipay/ams-checkout 0.0.1748326942-dev.0 → 0.0.1749206034-dev.0

package/esm/foundation/service/container/index.js

@@ -11,7 +11,7 @@ import { isEmpty } from "../../../util";
 import { addInlineLoading, createInlineBaseElement } from "../../../component/component.inline.style";
 import { addPopupLoading, createBaseElement } from "../../../component/component.popup.style";
 import { insertStyleSheet } from "../../../component/popupWindow.style";
-import { COMPONENT_CLOSE_BLOCK_ID, COMPONENT_CLOSE_MASK_BLOCK_ID, COMPONENT_CONTAINER_ID, ERRORMESSAGE, EVENT, LOADING_ID, MOCKUP_ID, TIMEOUT_WEB_APP_HEART_BEAT, TIME_DELAY_SEND_HEART_BEAT } from "../../../constant";
+import { COMPONENT_CLOSE_BLOCK_ID, COMPONENT_CLOSE_MASK_BLOCK_ID, COMPONENT_CONTAINER_ID, ERRORMESSAGE, EVENT, LOADING_ID, MOCKUP_ID, TIMEOUT_WEB_APP_HEART_BEAT, TIME_DELAY_SEND_HEART_BEAT, closeImg, closeImgLight } from "../../../constant";
 import { DisplayTypeEnum, ProductSceneEnum } from "../../../types";
 import { ServiceProvider } from "../index";
 import { PopupManager } from "./popup";
@@ -35,6 +35,7 @@ export var ContainerService = /*#__PURE__*/function () {
     _defineProperty(this, "displayInfo", void 0);
     _defineProperty(this, "webApp", void 0);
     _defineProperty(this, "_webAppHeartBeatTimeoutFn", void 0);
+    _defineProperty(this, "clientHeight", void 0);
     // if this variable is true, SDK will invoke listener instead of showing loading
     _defineProperty(this, "customizedLoadingListener", void 0);
   }
@@ -46,6 +47,7 @@ export var ContainerService = /*#__PURE__*/function () {
     value: function init(initOptions, instanceId, sdkMetaData) {
       this.instanceId = instanceId;
       this.sdkMetaData = sdkMetaData;
+      this.clientHeight = Math.max(window.innerHeight, window.visualViewport.height);
       this.eventCenter = ServiceProvider.getInstance(instanceId).getService('EventCenter');
       this.logService = ServiceProvider.getInstance(instanceId).getService('Log');
       this.popupManager = new PopupManager();
@@ -156,6 +158,22 @@ export var ContainerService = /*#__PURE__*/function () {
         container === null || container === void 0 || container.classList.add("".concat(COMPONENT_CONTAINER_ID, "-hidden-").concat(this.displayInfo.platform));
       }
     }
+  }, {
+    key: "handleAccountFocus",
+    value: function handleAccountFocus(focus) {
+      var _window$visualViewpor, _window;
+      // 失焦时v2会走默认的sizeChange还原高度，这里仅移除监听
+      (_window$visualViewpor = window.visualViewport) === null || _window$visualViewpor === void 0 || _window$visualViewpor.removeEventListener('resize', this.focusResizeChange.bind(this));
+      (_window = window) === null || _window === void 0 || _window.removeEventListener('resize', this.focusResizeChange.bind(this));
+      // 只有聚焦才监听，失焦后移除，避免影响别的场景
+      if (focus) {
+        var _window$visualViewpor2;
+        // 监听页面visualViewport的高度变化，适用于主流机型更精准获取当前页面高度
+        (_window$visualViewpor2 = window.visualViewport) === null || _window$visualViewpor2 === void 0 || _window$visualViewpor2.addEventListener('resize', this.focusResizeChange.bind(this));
+        // 兼容visualViewport处理不到的场景，一般存在于老版本浏览器
+        window.addEventListener('resize', this.focusResizeChange.bind(this));
+      }
+    }
   }, {
     key: "addCapabilityToEventCenter",
     value: function addCapabilityToEventCenter() {
@@ -194,7 +212,8 @@ export var ContainerService = /*#__PURE__*/function () {
       this.eventCenter.listen(EVENT.sizeChanged.name, function (data) {
         _this.handleSizeChanged(_objectSpread({}, data));
       });
-      this.eventCenter.listen(EVENT.showCloseButton.name, function () {
+      this.eventCenter.listen(EVENT.showCloseButton.name, function (data) {
+        _this.handleCloseButtonTheme(data.theme);
         _this.changeCloseBtnVisibility(true);
       });
       this.eventCenter.listen(EVENT.hideCloseButton.name, function () {
@@ -206,6 +225,22 @@ export var ContainerService = /*#__PURE__*/function () {
       this.eventCenter.listen(EVENT.appHeartBeat.name, function () {
         _this.handleAppHeartBeat();
       });
+      /**
+       * 目前仅用于ESP V2的 web sdk
+       * 原因： 在账户输入页和OTP页面的h5场景下键盘弹起页面会有问题，iframe有固定高度，键盘弹起时应用层不会触发大小变化
+       *   account账号输入页需要在sdk监听键盘弹起后高度变化并修改iframe及iframe外层容器，account需要按钮置底的放在键盘上面，必须修改高度而不是让容器定位
+       *   otp页面需要在聚焦时给iframe及外层容器设置fixed定位，让页面不被弹起
+       * 目的： esp页面输入框聚焦/失焦后给sdk发送消息
+       */
+      this.eventCenter.listen(EVENT.inputFocus.name, function (data) {
+        // 账号输入页需要修改iframe高度
+        if (data.source === 'ESP_V2' && data.type === 'account') {
+          _this.handleAccountFocus(data.focus);
+          // otp页面需要定位元素
+        } else if (data.source === 'ESP_V2' && data.type === 'otp') {
+          _this.focusScrollFixed(data.focus);
+        }
+      });
     }
   }, {
     key: "addCapabilityToApiBusManager",
@@ -266,6 +301,48 @@ export var ContainerService = /*#__PURE__*/function () {
         this.webApp.style.height = "".concat(data.height, "px");
       }
     }
+
+    // 目前仅用于esp账号输入页聚焦
+  }, {
+    key: "focusResizeChange",
+    value: function focusResizeChange() {
+      var _window2;
+      // 计算出当前iframe应有的高度，需要和顶部留有距离
+      var webPageHeightRatio = 0.9;
+      // sdk层才能拿到当前键盘弹起后页面的高度
+      var height = ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.visualViewport) === null || _window2 === void 0 ? void 0 : _window2.height) || window.innerHeight;
+      height = height * webPageHeightRatio;
+      // 调用handleSizeChanged修改iframe高度
+      this.handleSizeChanged({
+        width: 0,
+        height: height
+      });
+    }
+
+    // 目前仅用于esp otp页面账号聚焦
+  }, {
+    key: "focusScrollFixed",
+    value: function focusScrollFixed(focus) {
+      // 获取iframe dom元素
+      var _this$displayInfo4 = this.displayInfo,
+        appendAliasContainerId = _this$displayInfo4.appendAliasContainerId,
+        selector = _this$displayInfo4.selector;
+      var cashierId = appendAliasContainerId ? "".concat(COMPONENT_CONTAINER_ID, "-").concat((selector === null || selector === void 0 ? void 0 : selector.indexOf('#')) === -1 ? selector : selector.slice(1)) : COMPONENT_CONTAINER_ID;
+      if (!this.webApp || !this.displayInfo) {
+        return;
+      }
+      var cashier = document.getElementById(cashierId);
+      if (!cashier) return;
+      // 输入框聚焦时修改定位信息和top距离
+      if (focus) {
+        cashier.style.position = 'fixed';
+        cashier.style.top = "".concat(this.clientHeight - cashier.clientHeight, "px");
+      } else {
+        // 失焦时移除定位信息
+        cashier.style.position = '';
+        cashier.style.top = '';
+      }
+    }
   }, {
     key: "handleAppHeartBeat",
     value: function handleAppHeartBeat() {
@@ -323,6 +400,23 @@ export var ContainerService = /*#__PURE__*/function () {
         closeBlock === null || closeBlock === void 0 || closeBlock.classList.add("".concat(COMPONENT_CLOSE_MASK_BLOCK_ID, "-hidden"));
       }
     }
+  }, {
+    key: "handleCloseButtonTheme",
+    value: function handleCloseButtonTheme(theme) {
+      if (!theme) return;
+      var closeBlock = document.getElementById(COMPONENT_CLOSE_BLOCK_ID);
+      var closeButtonImg = closeBlock === null || closeBlock === void 0 ? void 0 : closeBlock.querySelector('img');
+      var maskCloseBlock = document.getElementById(COMPONENT_CLOSE_MASK_BLOCK_ID);
+      if (theme === 'light') {
+        closeButtonImg === null || closeButtonImg === void 0 || closeButtonImg.setAttribute('src', closeImgLight);
+        closeBlock === null || closeBlock === void 0 || closeBlock.classList.add("".concat(COMPONENT_CLOSE_BLOCK_ID, "-light"));
+        maskCloseBlock === null || maskCloseBlock === void 0 || maskCloseBlock.classList.add("".concat(COMPONENT_CLOSE_MASK_BLOCK_ID, "-light"));
+      } else {
+        closeButtonImg === null || closeButtonImg === void 0 || closeButtonImg.setAttribute('src', closeImg);
+        closeBlock === null || closeBlock === void 0 || closeBlock.classList.remove("".concat(COMPONENT_CLOSE_BLOCK_ID, "-light"));
+        maskCloseBlock === null || maskCloseBlock === void 0 || maskCloseBlock.classList.remove("".concat(COMPONENT_CLOSE_MASK_BLOCK_ID, "-light"));
+      }
+    }
   }, {
     key: "getWebApp",
     value: function getWebApp() {

package/esm/foundation/utils/preload_helper.d.ts

@@ -4,10 +4,10 @@ export default class PreloadHelper {
     static isWebAppPreloaded: boolean;
     static isSecuritySDKPreloaded: boolean;
     private static securitySdkMap;
-    static preloadWebApp(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment?: string): void;
+    static preloadWebApp(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment?: string, useV2?: boolean): void;
     static preloadSecuritySDK(product: ProductSceneEnum, securityRegion?: string): void;
     static getSecuritySdk(scene: any): Security;
-    static buildWebAppPreloadUrl(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment: string): {
+    static buildWebAppPreloadUrl(productScene: ProductSceneEnum, paymentMethodCategoryType: PaymentMethodCategoryTypeEnum, environment: string, useV2?: boolean): {
         preloadUrl: string;
         containerId: string;
     };

package/esm/foundation/utils/preload_helper.js

@@ -8,7 +8,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import { sdkVersion } from "../../config";
 import { createPreloadIframe } from "../service/container/utils";
 import { ProductSceneEnum } from "../../types";
-import { getWebAppUrl } from "../utils/web_app_url_utils";
+import { getWebAppUrl, getWebAppV2Url } from "../utils/web_app_url_utils";
 import { ProductInfoCacheUtil } from "../utils/payment_product_utils";
 import { getWebAppVersion } from "./payment_context_utils";
 import { getSecurityConfigStorageKey, getSecurityHost, getSecurityScene, Security } from "../../util/security";
@@ -22,12 +22,13 @@ var PreloadHelper = /*#__PURE__*/function () {
     key: "preloadWebApp",
     value: function preloadWebApp(productScene, paymentMethodCategoryType) {
       var environment = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'prod';
+      var useV2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       try {
         if (this.isWebAppPreloaded) {
           console.log('[web-sdk] web app already preloaded');
           return;
         }
-        var _this$buildWebAppPrel = this.buildWebAppPreloadUrl(productScene, paymentMethodCategoryType, environment),
+        var _this$buildWebAppPrel = this.buildWebAppPreloadUrl(productScene, paymentMethodCategoryType, environment, useV2),
           preloadUrl = _this$buildWebAppPrel.preloadUrl,
           containerId = _this$buildWebAppPrel.containerId;
         var preloadIframe = createPreloadIframe(containerId);
@@ -89,6 +90,7 @@ var PreloadHelper = /*#__PURE__*/function () {
   }, {
     key: "buildWebAppPreloadUrl",
     value: function buildWebAppPreloadUrl(productScene, paymentMethodCategoryType, environment) {
+      var useV2 = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       var productSceneVersion = productScene === ProductSceneEnum.EASY_PAY ? '2.0' : '1.0';
       var previousProductInfo = ProductInfoCacheUtil.getPreviousProductInfo(productScene);
       if (previousProductInfo) {
@@ -101,14 +103,16 @@ var PreloadHelper = /*#__PURE__*/function () {
         webAppVersion: ''
       };
       sdkMetaData.webAppVersion = getWebAppVersion(sdkMetaData);
-      var preloadUrl = getWebAppUrl({
+      var preloadUrlParams = {
         environment: environment,
         sdkMetaData: sdkMetaData,
         paymentMethodCategoryType: paymentMethodCategoryType,
         isPreload: true,
+        productScene: productScene,
         productSceneVersion: productSceneVersion,
         query: undefined
-      });
+      };
+      var preloadUrl = useV2 ? getWebAppV2Url(preloadUrlParams) : getWebAppUrl(preloadUrlParams);
       return {
         preloadUrl: preloadUrl,
         containerId: containerId

package/esm/foundation/utils/web_app_url_utils.d.ts

@@ -1,5 +1,6 @@
-import { DisplayTypeEnum, PaymentMethodCategoryTypeEnum } from '../../types';
+import { DisplayTypeEnum, PaymentMethodCategoryTypeEnum, ProductSceneEnum, IPaymentSessionMetaData } from '../../types';
 import { SDKMetaData } from '../index';
+import { ESP_PAGE_NAME } from "../../constant/easysafepay";
 /**
  * Tell the SDK which version of the Web App to load.
  * Sent by server inside paymentSession.
@@ -16,6 +17,16 @@ export interface WebAppMatchConfig {
     mid?: string;
     greyscale?: string;
 }
+/**
+ * Tell the SDK which Web App URL to load.
+ * Sent by server inside paymentSession.
+ */
+export interface WebAppUrlMatchConfig {
+    minSDKVersion: string;
+    url: string;
+    doubleFa: string;
+    mids?: string[];
+}
 export interface QueryParams {
     displayType: DisplayTypeEnum;
     locale: string;
@@ -27,20 +38,79 @@ export interface QueryParams {
 export declare const getWebAppUrlInfo: (params: {
     environment: string;
     sdkMetaData: SDKMetaData;
+    productScene: ProductSceneEnum;
     productSceneVersion: string;
     paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
     isPreload?: boolean;
     query: QueryParams;
+    v2Url?: string;
 }) => {
     path: string;
     locationSearch: string;
 };
+export declare const getWebAppV2Url: (params: {
+    environment: string;
+    sdkMetaData: SDKMetaData;
+    productScene: ProductSceneEnum;
+    productSceneVersion: string;
+    paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
+    isPreload?: boolean;
+    query: QueryParams;
+    mid?: string;
+    extendInfo?: string;
+}) => string;
 export declare const getWebAppUrl: (params: {
     environment: string;
     sdkMetaData: SDKMetaData;
+    productScene: ProductSceneEnum;
     productSceneVersion: string;
     paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
     isPreload?: boolean;
     query: QueryParams;
+    v2Url?: string;
 }) => string;
 export declare const parseWebAppMatchConfig: (extendInfo: string) => WebAppMatchConfig[];
+export declare const parseWebAppUrlMatchConfig: (extendInfo: string) => WebAppUrlMatchConfig[];
+/**
+ * Save the current checkout URL to localStorage for the specified product scene.
+ *
+ * @param productScene - The product scene for which the checkout URL should be saved.
+ */
+export declare const saveLocalCheckoutUrl: (productScene: ProductSceneEnum, url: string) => void;
+/**
+ * 获取从外部动态下发的V2AppUrl.
+ *
+ * @param config - sessionData解析来的checkoutInfo列表.
+ */
+export declare const getMatchedWebAppV2Url: (productScene: ProductSceneEnum, mid: string, configs: WebAppUrlMatchConfig[], env: string) => string;
+/**
+ * 获取ESP从sessionData.checkoutInfo内动态下发的Url.
+ */
+export declare const matchEasySafePayV2Url: (params: {
+    configs: WebAppUrlMatchConfig[];
+    mid: string;
+    env: string;
+    pageName: ESP_PAGE_NAME;
+}) => string;
+/**
+ * Retrieve the saved checkout URL from localStorage for the specified product scene.
+ * If no url is found, a default checkout url string is returned.
+ *
+ * @param productScene - The product scene for which the checkout URL should be retrieved.
+ */
+export declare const getLocalCheckoutUrl: (productScene: ProductSceneEnum, environment: string) => string;
+/**
+ * Provide default checkout URL for the specified product scene.
+ * Return URL for 'EASY_PAY' product scene, while for other product scenes, it returns an empty string as they are not currently in use
+ *
+ * @param productScene - The product scene for which the default checkout URL should be provided.
+ */
+export declare const defaultCheckoutUrl: (productScene: ProductSceneEnum, environment?: string) => string;
+/**
+ * V2应用EasySafePay 热更新兜底URL构建规则
+ * 1. 兜底URL版本与sdk版本保持一致
+ * 2. DEV环境下html新增版本前缀
+**/
+export declare const getDefaultEasySafePayPageUrl: (pageName: ESP_PAGE_NAME, env: string) => string;
+/**通过sessionData获取doubleFa,于createComponent时传递给WEB应用*/
+export declare const getDoubleFaUrlFromSession: (paymentSessionObj: IPaymentSessionMetaData, env?: string) => string;

package/esm/foundation/utils/web_app_url_utils.js

@@ -1,25 +1,35 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-import { ComponentSignEnum } from "../../types";
-import { marmotMap } from "../../config";
+import { ComponentSignEnum, ProductSceneEnum } from "../../types";
+import { marmotMap, v2AppMarmotMap, sdkVersion } from "../../config";
 import { queryParse, serialize } from "../../util";
+import { compareVersion } from "../../util/versionCompare";
 import { isDebugLog } from "../../util/debug";
-
+import { ESP_PAGE_NAME } from "../../constant/easysafepay";
 /**
  * Tell the SDK which version of the Web App to load.
  * Sent by server inside paymentSession.
  */
 
+/**
+ * Tell the SDK which Web App URL to load.
+ * Sent by server inside paymentSession.
+ */
+
 export var getWebAppUrlInfo = function getWebAppUrlInfo(params) {
   var environment = params.environment,
     sdkMetaData = params.sdkMetaData,
+    productScene = params.productScene,
     productSceneVersion = params.productSceneVersion,
     paymentMethodCategoryType = params.paymentMethodCategoryType,
     query = params.query,
-    isPreload = params.isPreload;
-  var path = getAppPath(environment, sdkMetaData, productSceneVersion, paymentMethodCategoryType);
+    isPreload = params.isPreload,
+    v2Url = params.v2Url;
+  var path = getAppPath(environment, sdkMetaData, productScene, productSceneVersion, paymentMethodCategoryType, v2Url);
   var _queryParse = queryParse(),
     _sandbox = _queryParse._sandbox,
     _light_sandbox = _queryParse._light_sandbox,
@@ -57,6 +67,30 @@ export var getWebAppUrlInfo = function getWebAppUrlInfo(params) {
     locationSearch: locationSearch
   };
 };
+export var getWebAppV2Url = function getWebAppV2Url(params) {
+  var productScene = params.productScene,
+    isPreload = params.isPreload,
+    mid = params.mid,
+    extendInfo = params.extendInfo,
+    environment = params.environment;
+  var webAppUrlMatchConfig = parseWebAppUrlMatchConfig(extendInfo);
+  var v2Url = isPreload ? getLocalCheckoutUrl(productScene, environment) : getMatchedWebAppV2Url(productScene, mid, webAppUrlMatchConfig, environment);
+  var info = getWebAppUrlInfo(_objectSpread(_objectSpread({}, params), {}, {
+    v2Url: v2Url
+  }));
+  if (!isPreload && v2Url && info.path) {
+    console.log('[web-sdk] save web app, url: ', info.path);
+    saveLocalCheckoutUrl(productScene, info.path);
+  }
+  var webAppUrl;
+  if (info.path.indexOf('?') !== -1) {
+    webAppUrl = "".concat(info.path, "&").concat(info.locationSearch);
+  } else {
+    webAppUrl = "".concat(info.path, "?").concat(info.locationSearch);
+  }
+  console.log('[web-sdk] web app, url: ', webAppUrl);
+  return webAppUrl;
+};
 export var getWebAppUrl = function getWebAppUrl(params) {
   var info = getWebAppUrlInfo(params);
   var webAppUrl;
@@ -70,8 +104,10 @@ export var getWebAppUrl = function getWebAppUrl(params) {
 var getAppPath = function getAppPath() {
   var environment = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'prod';
   var sdkMetaData = arguments.length > 1 ? arguments[1] : undefined;
-  var productSceneVersion = arguments.length > 2 ? arguments[2] : undefined;
-  var paymentMethodCategoryType = arguments.length > 3 ? arguments[3] : undefined;
+  var productScene = arguments.length > 2 ? arguments[2] : undefined;
+  var productSceneVersion = arguments.length > 3 ? arguments[3] : undefined;
+  var paymentMethodCategoryType = arguments.length > 4 ? arguments[4] : undefined;
+  var v2Url = arguments.length > 5 ? arguments[5] : undefined;
   var _ref = queryParse() || {},
     urlTestHost = _ref.host;
   // only for test while testurl?host=https://xxxxx.test.html
@@ -81,7 +117,12 @@ var getAppPath = function getAppPath() {
   var validProductSceneVersion = getValidProductSceneVersion(sdkMetaData.productScene, productSceneVersion, paymentMethodCategoryType);
   var productSceneWithPaymentMethodCategoryType = "".concat(sdkMetaData.productScene, "_").concat(paymentMethodCategoryType);
   var webAppVersion = sdkMetaData.webAppVersion;
-  return "".concat(marmotMap[environment], "/").concat(productSceneWithPaymentMethodCategoryType, "/").concat(validProductSceneVersion, "/index.").concat(webAppVersion, ".html");
+  switch (productScene) {
+    case ProductSceneEnum.EASY_PAY:
+      return v2Url !== null && v2Url !== void 0 ? v2Url : defaultCheckoutUrl(productScene, environment);
+    default:
+      return "".concat(marmotMap[environment], "/").concat(productSceneWithPaymentMethodCategoryType, "/").concat(validProductSceneVersion, "/index.").concat(webAppVersion, ".html");
+  }
 };
 export var parseWebAppMatchConfig = function parseWebAppMatchConfig(extendInfo) {
   if (!extendInfo) {
@@ -96,6 +137,18 @@ export var parseWebAppMatchConfig = function parseWebAppMatchConfig(extendInfo)
     return [];
   }
 };
+export var parseWebAppUrlMatchConfig = function parseWebAppUrlMatchConfig(extendInfo) {
+  if (!extendInfo) {
+    return [];
+  }
+  try {
+    var extendInfoJson = JSON.parse(extendInfo);
+    return extendInfoJson === null || extendInfoJson === void 0 ? void 0 : extendInfoJson.checkoutInfo;
+  } catch (error) {
+    console.error('Parse the url config for Web app failed#', error);
+    return [];
+  }
+};
 var getValidProductSceneVersion = function getValidProductSceneVersion(productScene, productSceneVer, paymentMethodCategoryType) {
   var _supportMapping;
   var supportMapping = (_supportMapping = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_supportMapping, ComponentSignEnum.NONE, ['']), ComponentSignEnum.AUTO_DEBIT_WALLET, ['1.0']), ComponentSignEnum.AUTO_DEBIT_PAY_WALLET, ['']), ComponentSignEnum.CASHIER_PAYMENT_BANK, ['1.0']), ComponentSignEnum.CASHIER_PAYMENT_CARD, ['1.0']), ComponentSignEnum.CASHIER_PAYMENT_APM, ['1.0']), ComponentSignEnum.EASY_PAY_WALLET, ['1.0', '2.0']), ComponentSignEnum.EASY_PAY_APM, ['2.0']), ComponentSignEnum.VAULTING_CARD, ['1.0']), ComponentSignEnum.ELEMENT_PAYMENT, ['1.0']), _defineProperty(_defineProperty(_supportMapping, ComponentSignEnum.ELEMENT_ADDRESS, ['1.0']), ComponentSignEnum.CHECKOUT_PAYMENT, ['1.0']));
@@ -109,4 +162,158 @@ var getValidProductSceneVersion = function getValidProductSceneVersion(productSc
   });
   var latestVersion = targetVersions[targetVersions.length - 1];
   return isSupport ? productSceneVer : latestVersion;
+};
+var KEY_CHECKOUT_URL = "web_url_";
+
+/**
+ * Save the current checkout URL to localStorage for the specified product scene.
+ *
+ * @param productScene - The product scene for which the checkout URL should be saved.
+ */
+export var saveLocalCheckoutUrl = function saveLocalCheckoutUrl(productScene, url) {
+  var key = KEY_CHECKOUT_URL + productScene;
+  localStorage.setItem(key, url);
+};
+
+/**
+ * 获取从外部动态下发的V2AppUrl.
+ *
+ * @param config - sessionData解析来的checkoutInfo列表.
+ */
+export var getMatchedWebAppV2Url = function getMatchedWebAppV2Url(productScene) {
+  var mid = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  var configs = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+  var env = arguments.length > 3 ? arguments[3] : undefined;
+  switch (productScene) {
+    case ProductSceneEnum.EASY_PAY:
+      return matchEasySafePayV2Url({
+        configs: configs,
+        mid: mid,
+        env: env,
+        pageName: ESP_PAGE_NAME.SDK_PORTAL
+      });
+    default:
+      return defaultCheckoutUrl(productScene, env);
+  }
+};
+
+/**
+ * 获取ESP从sessionData.checkoutInfo内动态下发的Url.
+ */
+export var matchEasySafePayV2Url = function matchEasySafePayV2Url(params) {
+  var _params$configs = params.configs,
+    configs = _params$configs === void 0 ? [] : _params$configs,
+    _params$mid = params.mid,
+    mid = _params$mid === void 0 ? '' : _params$mid,
+    env = params.env,
+    pageName = params.pageName;
+  var matchURLByMid = function matchURLByMid() {
+    var sortedConfigs = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+    var targetConfigEntry = sortedConfigs.find(function (configEntry) {
+      var _configEntry$mids;
+      var isMatchMid = !!(configEntry !== null && configEntry !== void 0 && (_configEntry$mids = configEntry.mids) !== null && _configEntry$mids !== void 0 && _configEntry$mids.includes(mid));
+      var isMatchVersion = compareVersion(sdkVersion, configEntry.minSDKVersion) >= 0;
+      if (isMatchMid && isMatchVersion) {
+        return configEntry;
+      }
+    });
+    return targetConfigEntry;
+  };
+  var matchURLBySDKVersion = function matchURLBySDKVersion() {
+    var sortedConfigs = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+    var targetConfigEntry = sortedConfigs.find(function (configEntry) {
+      var isCommonConfig = (configEntry === null || configEntry === void 0 ? void 0 : configEntry.mids) === undefined;
+      var isMatchVersion = compareVersion(sdkVersion, configEntry.minSDKVersion) >= 0;
+      if (isCommonConfig && isMatchVersion) {
+        return configEntry;
+      }
+    });
+    return targetConfigEntry;
+  };
+  var matchConfig = function matchConfig() {
+    // 按SDK版本降排序
+    var sortedConfig = configs.sort(function (a, b) {
+      return compareVersion(b.minSDKVersion, a.minSDKVersion);
+    });
+
+    // 匹配仅针对部分商户生效(mid),且符合版本号的URL
+    var matchedURLByMid = matchURLByMid(sortedConfig);
+    if (matchedURLByMid) return matchedURLByMid;
+
+    // 匹配对所有商户生效(无mid),且符合版本号的URL
+    var matchedURLBySDKVersion = matchURLBySDKVersion(sortedConfig);
+    if (matchedURLBySDKVersion) return matchedURLBySDKVersion;
+  };
+  var defaultEspUrl = getDefaultEasySafePayPageUrl(pageName, env);
+
+  // 匹配config
+  var config = matchConfig();
+  if (!config) return defaultEspUrl;
+
+  // 根据pageName匹配URL
+  if (pageName == ESP_PAGE_NAME.SDK_PORTAL) return (config === null || config === void 0 ? void 0 : config.url) || defaultEspUrl;
+  if (pageName == ESP_PAGE_NAME.DOUBLE_FA) return (config === null || config === void 0 ? void 0 : config.doubleFa) || defaultEspUrl;
+  return defaultEspUrl;
+};
+
+/**
+ * Retrieve the saved checkout URL from localStorage for the specified product scene.
+ * If no url is found, a default checkout url string is returned.
+ *
+ * @param productScene - The product scene for which the checkout URL should be retrieved.
+ */
+export var getLocalCheckoutUrl = function getLocalCheckoutUrl(productScene, environment) {
+  var key = KEY_CHECKOUT_URL + productScene;
+  var previousCheckoutUrl = localStorage.getItem(key);
+  return previousCheckoutUrl !== null && previousCheckoutUrl !== void 0 ? previousCheckoutUrl : defaultCheckoutUrl(productScene, environment);
+};
+
+/**
+ * Provide default checkout URL for the specified product scene.
+ * Return URL for 'EASY_PAY' product scene, while for other product scenes, it returns an empty string as they are not currently in use
+ *
+ * @param productScene - The product scene for which the default checkout URL should be provided.
+ */
+export var defaultCheckoutUrl = function defaultCheckoutUrl(productScene) {
+  var environment = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "prod";
+  switch (productScene) {
+    case ProductSceneEnum.EASY_PAY:
+      return getDefaultEasySafePayPageUrl(ESP_PAGE_NAME.SDK_PORTAL, environment);
+    default:
+      return '';
+  }
+};
+
+/**
+ * V2应用EasySafePay 热更新兜底URL构建规则
+ * 1. 兜底URL版本与sdk版本保持一致
+ * 2. DEV环境下html新增版本前缀
+**/
+export var getDefaultEasySafePayPageUrl = function getDefaultEasySafePayPageUrl(pageName, env) {
+  // 生成的URL EXAMPLE:
+  // const DEFAULT_DOUBLE_FA_URL_MAPPING = {
+  //   local: 'http://page.alipay.net/page/antom-web-checkout-v2/easysafepay/1.36.0/pages/double-fa/index-1.36.0.html',
+  //   dev: 'http://page.alipay.net/page/antom-web-checkout-v2/easysafepay/1.36.0/pages/double-fa/index-1.36.0.html',
+  //   sit: 'http://page.test.alipay.net/page/antom-web-checkout-v2/easysafepay/1.36.0/pages/double-fa/index.html',
+  //   pre: 'https://pre.ac.alipay.com/page/antom-web-checkout-v2/easysafepay/1.36.0/pages/double-fa/index.html',
+  //   prod: 'https://checkout.antom.com/easysafepay/1.36.0/pages/double-fa/index.html',
+  // };
+  var environment = env || "prod";
+  if (environment === "dev") return "".concat(v2AppMarmotMap[environment], "/easysafepay/").concat(sdkVersion, "/pages/").concat(pageName, "/index-").concat(sdkVersion, ".html");else return "".concat(v2AppMarmotMap[environment], "/easysafepay/").concat(sdkVersion, "/pages/").concat(pageName, "/index.html");
+};
+
+/**通过sessionData获取doubleFa,于createComponent时传递给WEB应用*/
+//TODO 后续需要构造一个类，专门用于构造&存储web应用url
+export var getDoubleFaUrlFromSession = function getDoubleFaUrlFromSession(paymentSessionObj) {
+  var env = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "prod";
+  var mid = paymentSessionObj.clientId;
+  var extendInfo = paymentSessionObj.extendInfo;
+  var configs = parseWebAppUrlMatchConfig(extendInfo);
+  var url = matchEasySafePayV2Url({
+    configs: configs,
+    mid: mid,
+    env: env,
+    pageName: ESP_PAGE_NAME.DOUBLE_FA
+  });
+  return url;
 };

package/esm/index.js

@@ -271,7 +271,7 @@ export var AMSEasyPay = /*#__PURE__*/function () {
         securityRegion: 'SG',
         environment: 'prod'
       };
-      PreloadHelper.preloadWebApp(ProductSceneEnum.EASY_PAY, PaymentMethodCategoryTypeEnum.WALLET, options.environment);
+      PreloadHelper.preloadWebApp(ProductSceneEnum.EASY_PAY, PaymentMethodCategoryTypeEnum.WALLET, options.environment, true);
     }
   }]);
   return AMSEasyPay;

package/esm/plugin/component/cashierApp.js

@@ -15,7 +15,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * 1. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE; and
  * 2. If applicable, the use of the Software is also subject to the terms and conditions of any non-disclosure agreement signed by you and the relevant Ant Group entity.
  */
-import { elementAppMarmotMap, marmotMap, sdkVersion } from "../../config/index";
+import { v2AppMarmotMap, marmotMap, sdkVersion } from "../../config/index";
 import { ComponentSignEnum, ComponentSignEnumV2 } from "../../types";
 import { isDebugLog } from "../../util/debug";
 import { queryParse, serialize } from "../../util/index";
@@ -103,7 +103,7 @@ export var getAppPath = function getAppPath() {
   }
   // 地址应用特殊处理
   if (componentSign === ComponentSignEnum.ELEMENT_ADDRESS) {
-    return "".concat(elementAppMarmotMap[environment], "/element-address/").concat(finalAppVersion, "/pages/address/index.html");
+    return "".concat(v2AppMarmotMap[environment], "/element-address/").concat(finalAppVersion, "/pages/address/index.html");
   }
   // element应用特殊处理
   if (_toConsumableArray(Object.values(ComponentSignEnumV2)).includes(componentSign)) {
@@ -117,9 +117,9 @@ export var getAppPath = function getAppPath() {
     }
     if (isExpressCheckout) {
       // express_checkout模式走单独映射
-      return "".concat(elementAppMarmotMap[environment], "/elements/").concat(finalAppVersion, "/pages/express_checkout/index.html");
+      return "".concat(v2AppMarmotMap[environment], "/elements/").concat(finalAppVersion, "/pages/express_checkout/index.html");
     } else {
-      return "".concat(elementAppMarmotMap[environment], "/elements/").concat(finalAppVersion, "/pages/").concat(productScene.toLowerCase(), "/index.html");
+      return "".concat(v2AppMarmotMap[environment], "/elements/").concat(finalAppVersion, "/pages/").concat(productScene.toLowerCase(), "/index.html");
     }
   }
   return "".concat(marmotMap[environment], "/").concat(componentSign, "/").concat(finalProductSceneVersion, "/index.").concat(finalAppVersion, ".html");

package/esm/plugin/component/channel.d.ts

@@ -11,12 +11,14 @@ export type IChannelBehavior = {
 type GetDoubleFaParams = {
     instanceId: string;
     paymentSessionData: string;
+    paymentSessionObj: IPaymentSessionMetaData;
     locale: string;
     paymentMethodType: string;
     env: string;
     sdkVersion: string;
+    notRedirectAfterComplete: boolean;
 };
-export declare function getChannelBehavior(paymentSessionMetaData?: IPaymentSessionMetaData): IChannelBehavior | undefined;
+export declare function getChannelBehavior(paymentSessionMetaData?: IPaymentSessionMetaData, notRedirectAfterComplete?: boolean): IChannelBehavior | undefined;
 export declare function getDoubleFaUrl(params: GetDoubleFaParams): string;
 export declare const handleGooglePay: (data: EventPayload) => Promise<unknown>;
 export declare class ApplePaySdk {