@alipay/ams-checkout 1.23.0 → 1.25.0

package/esm/foundation/utils/payment_context_utils.js

@@ -0,0 +1,57 @@
+import { parseBase64ToString } from "../../util";
+import { getStorageString, setStorageString } from "../../util/storage";
+import { compareVersion, isVersionInStringRange } from "../../util/versionCompare";
+import { getGrayscaleValue, isGreyscaleMatch, isWebPlatform } from "../../util/upgrade";
+/**
+ * @author 谦彧 <zhangmian.zm@alipay.com>
+ * @date 2024/9/17
+ */
+export function convertPaymentSession(sessionData) {
+  try {
+    return {
+      id: sessionData.split('&&').slice(0, 3).join('&&'),
+      data: JSON.parse(parseBase64ToString(sessionData.split('&&')[3]))
+    };
+  } catch (error) {
+    console.error('Parsing sessionData is abnormal and may affect the payment link. Please ensure to use the new version of SDK.', error);
+    return {
+      id: sessionData,
+      data: {}
+    };
+  }
+}
+export var getWebAppVersion = function getWebAppVersion(currentSDKMetaData) {
+  var mid = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  var config = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+  var webAppVersion = findTargetWebAppVersionByConfig(currentSDKMetaData, mid, config);
+  if (webAppVersion) {
+    return webAppVersion;
+  }
+  webAppVersion = getStorageString("Antom_".concat(currentSDKMetaData.sdkVersion + currentSDKMetaData.productScene, "_LastAppVersion"), '');
+  if (webAppVersion) {
+    return webAppVersion;
+  }
+  return currentSDKMetaData.sdkVersion;
+};
+export var saveWebAppVersion = function saveWebAppVersion(webAppVersion, currentSDKMetaData) {
+  setStorageString("Antom_".concat(currentSDKMetaData.sdkVersion + currentSDKMetaData.productScene, "_LastAppVersion"), '');
+};
+var findTargetWebAppVersionByConfig = function findTargetWebAppVersionByConfig(currentSDKInfo) {
+  var mid = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  var config = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
+  var sortedConfig = config.sort(function (a, b) {
+    return compareVersion(b.appVersion, a.appVersion);
+  });
+  var targetConfigEntry = sortedConfig.find(function (configEntry) {
+    if (isVersionInStringRange(currentSDKInfo.sdkVersion, configEntry.v) && isWebPlatform(configEntry.platform)) {
+      var _configEntry$productS, _currentSDKInfo$produ, _configEntry$mid, _currentSDKInfo$greys;
+      var isMatchProductScene = (_configEntry$productS = configEntry.productScene) !== null && _configEntry$productS !== void 0 && _configEntry$productS.trim() ? configEntry.productScene.toUpperCase().includes(currentSDKInfo === null || currentSDKInfo === void 0 || (_currentSDKInfo$produ = currentSDKInfo.productScene) === null || _currentSDKInfo$produ === void 0 ? void 0 : _currentSDKInfo$produ.toUpperCase()) : true;
+      var isMatchMid = (_configEntry$mid = configEntry.mid) !== null && _configEntry$mid !== void 0 && _configEntry$mid.trim() ? configEntry.mid.toUpperCase().includes(mid === null || mid === void 0 ? void 0 : mid.toUpperCase()) : true;
+      var matchGreyscale = isGreyscaleMatch(configEntry, (_currentSDKInfo$greys = currentSDKInfo.greyscaleId) !== null && _currentSDKInfo$greys !== void 0 ? _currentSDKInfo$greys : getGrayscaleValue());
+      if (isMatchProductScene && isMatchMid && matchGreyscale) {
+        return configEntry;
+      }
+    }
+  });
+  return (targetConfigEntry === null || targetConfigEntry === void 0 ? void 0 : targetConfigEntry.appVersion) || null;
+};

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

@@ -0,0 +1,13 @@
+import { ProductSceneEnum } from "../../types";
+export declare class ProductInfoCacheUtil {
+    static savePreviousProductInfo(productScene: ProductSceneEnum, info: {
+        productSceneVersion: string;
+        paymentMethodCategoryType: string;
+        hostSign: string;
+    }): void;
+    static getPreviousProductInfo(productScene: ProductSceneEnum, onError: (msg: string) => void): {
+        productSceneVersion: string;
+        paymentMethodCategoryType: string;
+        hostSign: string;
+    } | null;
+}

package/esm/foundation/utils/payment_product_utils.js

@@ -0,0 +1,38 @@
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+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); }
+var KEY_PREVIOUS_PRODUCT_INFO = 'antom_checkout_previous_ProductInfo_';
+export var ProductInfoCacheUtil = /*#__PURE__*/function () {
+  function ProductInfoCacheUtil() {
+    _classCallCheck(this, ProductInfoCacheUtil);
+  }
+  _createClass(ProductInfoCacheUtil, null, [{
+    key: "savePreviousProductInfo",
+    value: function savePreviousProductInfo(productScene, info) {
+      var key = KEY_PREVIOUS_PRODUCT_INFO + '_' + productScene;
+      localStorage.setItem(key, JSON.stringify({
+        productSceneVersion: info.productSceneVersion,
+        paymentMethodCategoryType: info.paymentMethodCategoryType,
+        hostSign: info.hostSign
+      }));
+    }
+  }, {
+    key: "getPreviousProductInfo",
+    value: function getPreviousProductInfo(productScene, onError) {
+      var key = KEY_PREVIOUS_PRODUCT_INFO + '_' + productScene;
+      var previousProductInfoString = localStorage.getItem(key);
+      if (previousProductInfoString) {
+        try {
+          return JSON.parse(previousProductInfoString);
+        } catch (error) {
+          onError(error === null || error === void 0 ? void 0 : error.message);
+        }
+      }
+      return null;
+    }
+  }]);
+  return ProductInfoCacheUtil;
+}();

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

@@ -0,0 +1,11 @@
+import { RedirectBehaviorPayload } from '../index';
+import { LogService } from '../service/log';
+/**
+ * @author 谦彧 <zhangmian.zm@alipay.com>
+ * @date 2024/9/19
+ */
+export declare const redirect: (payload: RedirectBehaviorPayload, instanceId: string) => void;
+/**
+ * 通过配置规则检测 UA 和获得回跳 scheme
+ */
+export declare function getBackScheme(mockUa?: string, logger?: LogService): any;

package/esm/foundation/utils/redirect_utils.js

@@ -0,0 +1,263 @@
+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 { eventCodeEnum, RedirectType, TargetEnum } from "../../types";
+import { ServiceProvider } from "../service";
+import { isPC } from "../../util";
+import CallApp from "../../util/intl-callapp/es/index";
+import { EVENT } from "../../constant";
+
+/**
+ * @author 谦彧 <zhangmian.zm@alipay.com>
+ * @date 2024/9/19
+ */
+export var redirect = function redirect(payload, instanceId) {
+  var serviceProvider = ServiceProvider.getInstance(instanceId);
+  var logService = serviceProvider.getService('Log');
+  logService.logInfo({
+    title: 'sdk_event_call_url_start'
+  }, _objectSpread({}, payload)).send();
+  try {
+    if (payload.isCallApp && payload.schemeUrl) {
+      var detectSuccessDelay = payload.callAppDetectSuccessDelay;
+      var _callAppLib = new CallApp({
+        successCb: function successCb() {
+          successCallback(payload, RedirectType.SchemeUrl, payload.schemeUrl, serviceProvider);
+        },
+        resultJudgmentTime: detectSuccessDelay
+      });
+      _callAppLib.open({
+        scheme: payload.schemeUrl,
+        fallback: function fallback() {
+          failCallback(payload, RedirectType.SchemeUrl, payload.schemeUrl, serviceProvider);
+        }
+      });
+      return;
+    }
+    // 支持 target: _blank，新开tab页打开
+    if (payload.browserLinkTarget === TargetEnum.BLANK) {
+      if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
+      successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
+      window.open(payload.url);
+      return;
+    }
+    if (payload.browserLinkTarget === TargetEnum.REPLACE && !(payload !== null && payload !== void 0 && payload.applinkUrl) && !(payload !== null && payload !== void 0 && payload.schemeUrl)) {
+      if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
+      successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
+      window.location.replace(payload.url);
+      return;
+    }
+    if (isPC()) {
+      if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
+      successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
+      window.location.href = payload.url;
+      return;
+    }
+    if (!payload.schemeUrl && !payload.applinkUrl) {
+      if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
+      successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
+      window.location.href = payload.url;
+      return;
+    }
+    // Use callApp lib to evoke
+    var callAppLib = new CallApp({
+      successCb: function successCb(evokeAppBy) {
+        var type = evokeAppBy.type == 'Scheme' ? RedirectType.SchemeUrl : RedirectType.ApplinkUrl;
+        successCallback(payload, type, evokeAppBy.url, serviceProvider);
+      }
+    });
+    var callSchemeUrl = function callSchemeUrl() {
+      callAppLib.open({
+        scheme: payload.schemeUrl,
+        fallback: function fallback() {
+          failCallback(payload, RedirectType.SchemeUrl, payload.schemeUrl, serviceProvider);
+          if (!payload.url) return failCallback(payload, RedirectType.NormalUrl, '', serviceProvider);
+          successCallback(payload, RedirectType.NormalUrl, payload.url, serviceProvider);
+          window.location.href = payload.url;
+        }
+      });
+    };
+    if (payload.applinkUrl) {
+      callAppLib.open({
+        link: payload.applinkUrl,
+        fallback: function fallback() {
+          failCallback(payload, RedirectType.ApplinkUrl, payload.applinkUrl, serviceProvider);
+          // Applink evoke failed, try to use scheme url
+          callSchemeUrl();
+        }
+      });
+    } else if (payload.schemeUrl) {
+      callSchemeUrl();
+    }
+  } catch (e) {
+    serviceProvider.getService('Log').logInfo({
+      title: 'sdk_event_call_url_failed'
+    }, {
+      redirectInfo: JSON.stringify(payload),
+      errorMessage: JSON.stringify(e)
+    }).send();
+  }
+};
+var successCallback = function successCallback(payload, type, url, serviceProvider) {
+  serviceProvider.getService('EventCenter').emit(EVENT.eventCallback.name, {
+    code: eventCodeEnum.SDK_CALL_URL_SUCCESS,
+    message: "Successfully opened the app,".concat(type, ": ").concat(url)
+  });
+  serviceProvider.getService('Log').logInfo({
+    title: 'sdk_event_call_url_success'
+  }, {
+    redirectInfo: JSON.stringify(payload),
+    openType: type,
+    url: url
+  }).send();
+};
+var failCallback = function failCallback(payload, type, url, serviceProvider) {
+  serviceProvider.getService('EventCenter').emit(EVENT.eventCallback.name, {
+    code: eventCodeEnum.SDK_CALL_URL_ERROR,
+    message: "Failed to open app,applinkUrl: ".concat(payload === null || payload === void 0 ? void 0 : payload.applinkUrl, " schemeUrl: ").concat(payload === null || payload === void 0 ? void 0 : payload.schemeUrl, " normalUrl: ").concat(payload === null || payload === void 0 ? void 0 : payload.url)
+  });
+  serviceProvider.getService('Log').logInfo({
+    title: 'sdk_error_call_url_failed'
+  }, {
+    redirectInfo: JSON.stringify(payload),
+    openType: type,
+    url: url
+  }).send();
+};
+var UA_MATCH_RULES = [{
+  matchRule: 'AppleWebKit\\/([0-9\\.]+).* Version\\/([0-9\\._]+) Mobile\\/([0-9\\._A-Z]+) Safari\\/([0-9\\._]+)$',
+  iosScheme: 'https',
+  andScheme: ''
+}, {
+  matchRule: 'HeyTapBrowser',
+  iosScheme: '',
+  andScheme: ''
+}, {
+  matchRule: 'HuaweiBrowser',
+  iosScheme: '',
+  andScheme: ''
+}, {
+  matchRule: 'Kwai',
+  iosScheme: 'kwai',
+  andScheme: ''
+}, {
+  matchRule: 'MQQBrowser',
+  iosScheme: 'mttbrowser',
+  andScheme: ''
+}, {
+  matchRule: 'MicroMessenger',
+  iosScheme: '',
+  andScheme: ''
+}, {
+  matchRule: 'MiuiBrowser',
+  iosScheme: '',
+  andScheme: ''
+}, {
+  matchRule: 'Mozilla\\/([0-9\\.]+).* AppleWebKit\\/([0-9\\.]+).* CriOS\\/([0-9\\._]+) Mobile\\/([0-9\\._A-Z\\._a-z]+) Safari\\/([0-9\\._]+)$',
+  iosScheme: 'googlechrome',
+  andScheme: ''
+}, {
+  matchRule: 'Mozilla\\/([0-9\\.]+).* AppleWebKit\\/([0-9\\.]+).* Version\\/([0-9\\._]+) Mobile Safari\\/([0-9\\._]+)$',
+  iosScheme: 'googlechrome',
+  andScheme: ''
+}, {
+  matchRule: 'NewsArticle',
+  iosScheme: 'snssdk141',
+  andScheme: ''
+}, {
+  matchRule: 'UCBrowser',
+  iosScheme: 'ucbrowser',
+  andScheme: ''
+}, {
+  matchRule: 'VideoArticle',
+  iosScheme: 'snssdk32',
+  andScheme: ''
+}, {
+  matchRule: 'VivoBrowser',
+  iosScheme: '',
+  andScheme: ''
+}, {
+  matchRule: 'ZhongAnWebView',
+  iosScheme: 'zaapp',
+  andScheme: ''
+}, {
+  matchRule: 'aweme',
+  iosScheme: 'snssdk1128',
+  andScheme: ''
+}, {
+  matchRule: 'aweme_lite',
+  iosScheme: 'snssdk2329',
+  andScheme: ''
+}, {
+  matchRule: 'com.xs.fm',
+  iosScheme: 'novelfm3040',
+  andScheme: ''
+}, {
+  matchRule: 'netdisk',
+  iosScheme: '',
+  andScheme: ''
+}, {
+  matchRule: 'qqnews',
+  iosScheme: 'qqnews',
+  andScheme: ''
+}];
+
+/**
+ * 通过配置规则检测 UA 和获得回跳 scheme
+ */
+export function getBackScheme(mockUa, logger) {
+  var ua = mockUa || window.navigator.userAgent || '';
+  // 获取规则
+  var uaMatchedRule = UA_MATCH_RULES;
+  var matchedRule;
+  var matched = null;
+  for (var i = 0; i < uaMatchedRule.length; i++) {
+    var rule = uaMatchedRule[i];
+    matched = ua.match(rule.matchRule);
+    if (matched) {
+      matchedRule = rule;
+      break;
+    }
+  }
+  if (!matchedRule) {
+    logBackScheme(logger, ua, '');
+    return;
+  }
+  if (isAndroid(ua)) {
+    logBackScheme(logger, ua, matchedRule.andScheme);
+    return matchedRule.andScheme;
+  }
+  if (isIOS(ua)) {
+    logBackScheme(logger, ua, matchedRule.iosScheme);
+    return matchedRule.iosScheme;
+  }
+}
+function logBackScheme(logger, userAgent, scheme) {
+  if (logger) {
+    logger.logInfo({
+      title: 'a3753.b101271.c377460'
+    }, {
+      userAgent: userAgent,
+      backScheme: scheme
+    });
+  }
+}
+
+/**
+ * 当前运行环境是否 Android
+ */
+function isAndroid(mockUA) {
+  var ua = (mockUA || navigator.userAgent).toLowerCase();
+  return /android|adr|linux/.test(ua);
+}
+
+/**
+ * 当前运行环境是否 IOS
+ */
+function isIOS(mockUA) {
+  var ua = (mockUA || navigator.userAgent).toLowerCase();
+  return /iphone|ipad|ipod|ios|macintosh/.test(ua);
+}

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

@@ -0,0 +1,4 @@
+import { EventCenter } from '../service/event-center';
+export declare const registerSystemEvents: (eventCenter: EventCenter) => void;
+export declare const unRegisterSystemEvents: (eventCenter: EventCenter) => void;
+export declare const getIframeOrigin: (iframe: HTMLIFrameElement) => string;

package/esm/foundation/utils/system_events.js

@@ -0,0 +1,66 @@
+import { EVENT } from "../../constant";
+import { v4 as uuid } from 'uuid';
+export var registerSystemEvents = function registerSystemEvents(eventCenter) {
+  var handleSubmitForm = function handleSubmitForm(data) {
+    var attributes = data.attributes;
+    var _document = document,
+      body = _document.body;
+    var form = document.createElement('form');
+    form.setAttribute('height', '1');
+    form.setAttribute('width', '1');
+    Object.keys(attributes.data).forEach(function (key) {
+      var input = document.createElement('input');
+      input.setAttribute('type', 'hidden');
+      input.setAttribute('name', key);
+      input.setAttribute('value', attributes.data[key]);
+      form.appendChild(input);
+    });
+    form.setAttribute('action', attributes.action);
+    form.setAttribute('method', 'post');
+    body.appendChild(form);
+    setTimeout(function () {
+      form.submit();
+    }, 0);
+  };
+  var handleBeforeSubmit = function handleBeforeSubmit(data) {
+    if (eventCenter.isExist(EVENT.beforeSubmit.name)) {
+      eventCenter.emit(EVENT.beforeSubmit.name, data);
+      return;
+    }
+    var eventCallbackId = uuid();
+    eventCenter.dispatchToApp({
+      event: EVENT.beforeSubmitDone.name,
+      eventCallbackId: eventCallbackId,
+      data: {
+        result: 'IGNORE'
+      }
+    });
+  };
+  var handleSendBroadcast = function handleSendBroadcast(data) {
+    eventCenter.dispatchToApp({
+      event: EVENT.receiveBroadcast.name,
+      data: data
+    });
+  };
+  var handleSendMultiAppEventToSdk = function handleSendMultiAppEventToSdk(data) {
+    eventCenter.dispatchToApp({
+      event: EVENT.receiveMuitiAppFromSdk.name,
+      data: data
+    });
+  };
+  eventCenter.listen(EVENT.submitForm.name, handleSubmitForm);
+  eventCenter.listen(EVENT.beforeSubmit.name, handleBeforeSubmit);
+  eventCenter.listen(EVENT.sendBroadcast.name, handleSendBroadcast);
+  // deprecated
+  eventCenter.listen(EVENT.sendMuitiAppEventToSdk.name, handleSendMultiAppEventToSdk);
+};
+export var unRegisterSystemEvents = function unRegisterSystemEvents(eventCenter) {
+  eventCenter.unlisten(EVENT.submitForm.name);
+  eventCenter.unlisten(EVENT.beforeSubmit.name);
+  eventCenter.unlisten(EVENT.sendBroadcast.name);
+  eventCenter.unlisten(EVENT.sendMuitiAppEventToSdk.name);
+};
+export var getIframeOrigin = function getIframeOrigin(iframe) {
+  var url = new URL(iframe.src);
+  return url.origin;
+};

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

@@ -0,0 +1,46 @@
+import { DisplayTypeEnum, PaymentMethodCategoryTypeEnum } from '../../types';
+import { SDKMetaData } from '../index';
+/**
+ * Tell the SDK which version of the Web App to load.
+ * Sent by server inside paymentSession.
+ */
+export interface WebAppMatchConfig {
+    /**
+     * SDK support version range, '{minVer}|{maxVer}', such as '1.0.0' or '1.0.0|2.0.0' or '2.0.0'
+     * If SDK version < maxVer and > minVer, then will use this config entry.
+     */
+    v: string;
+    appVersion: string;
+    productScene?: string;
+    platform?: string;
+    mid?: string;
+    greyscale?: string;
+}
+export interface QueryParams {
+    displayType: DisplayTypeEnum;
+    locale: string;
+    instanceId: string;
+    analyticsEnabled: boolean;
+    isPreload?: string;
+    hostSign?: string;
+}
+export declare const getWebAppUrlInfo: (params: {
+    environment: string;
+    sdkMetaData: SDKMetaData;
+    productSceneVersion: string;
+    paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
+    isPreload?: boolean;
+    query: QueryParams;
+}) => {
+    path: string;
+    locationSearch: string;
+};
+export declare const getWebAppUrl: (params: {
+    environment: string;
+    sdkMetaData: SDKMetaData;
+    productSceneVersion: string;
+    paymentMethodCategoryType: PaymentMethodCategoryTypeEnum;
+    isPreload?: boolean;
+    query: QueryParams;
+}) => string;
+export declare const parseWebAppMatchConfig: (extendInfo: string) => WebAppMatchConfig[];

package/esm/foundation/utils/web_app_url_utils.js

@@ -0,0 +1,112 @@
+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 _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 { queryParse, serialize } from "../../util";
+import { isDebugLog } from "../../util/debug";
+
+/**
+ * Tell the SDK which version of the Web App to load.
+ * Sent by server inside paymentSession.
+ */
+
+export var getWebAppUrlInfo = function getWebAppUrlInfo(params) {
+  var environment = params.environment,
+    sdkMetaData = params.sdkMetaData,
+    productSceneVersion = params.productSceneVersion,
+    paymentMethodCategoryType = params.paymentMethodCategoryType,
+    query = params.query,
+    isPreload = params.isPreload;
+  var path = getAppPath(environment, sdkMetaData, productSceneVersion, paymentMethodCategoryType);
+  var _queryParse = queryParse(),
+    _sandbox = _queryParse._sandbox,
+    _light_sandbox = _queryParse._light_sandbox,
+    _queryParse$requestHo = _queryParse.requestHost,
+    requestHost = _queryParse$requestHo === void 0 ? '' : _queryParse$requestHo,
+    _queryParse$groupId = _queryParse.groupId,
+    groupId = _queryParse$groupId === void 0 ? '' : _queryParse$groupId,
+    LOCAL_MOCK = _queryParse.LOCAL_MOCK,
+    _displayType = _queryParse._displayType;
+  var urlParams = {};
+  for (var key in query) {
+    urlParams[key] = '' + query[key];
+  }
+  // 如果是preload模式，添加一个preload的query参数
+  if (isPreload) {
+    urlParams['isPreload'] = 'true';
+  }
+  urlParams.appMatched = sdkMetaData.webAppVersion ? 'true' : 'false';
+  urlParams.sdkVersion = sdkMetaData.sdkVersion;
+  urlParams.refUrl = window.location.href;
+  urlParams._componentStartTime = "".concat(Date.now());
+  if (LOCAL_MOCK) urlParams.LOCAL_MOCK = LOCAL_MOCK;
+  if (requestHost) urlParams.requestHost = requestHost;
+  if (groupId) urlParams.groupId = groupId;
+  if (environment === 'light_sandbox' || _light_sandbox === 'true') urlParams.sandbox = 'true';
+  if (environment === 'sandbox' || _sandbox === 'true') urlParams.shadow = 'true';
+  if (_displayType) urlParams.displayType = _displayType;
+  var locationSearch = serialize(urlParams);
+  if (isDebugLog()) {
+    console.log('appUpgrade#getIframeUrl#appMatched', urlParams.appMatched);
+    console.log('appUpgrade#getIframeUrl#url', path, locationSearch);
+  }
+  return {
+    path: path,
+    locationSearch: locationSearch
+  };
+};
+export var getWebAppUrl = function getWebAppUrl(params) {
+  var info = getWebAppUrlInfo(params);
+  var webAppUrl;
+  if (info.path.indexOf('?') !== -1) {
+    webAppUrl = "".concat(info.path, "&").concat(info.locationSearch);
+  } else {
+    webAppUrl = "".concat(info.path, "?").concat(info.locationSearch);
+  }
+  return webAppUrl;
+};
+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 _ref = queryParse() || {},
+    urlTestHost = _ref.host;
+  // only for test while testurl?host=https://xxxxx.test.html
+  if (urlTestHost && !['sandbox', 'light_sandbox', 'prod'].includes(environment)) {
+    return urlTestHost;
+  }
+  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");
+};
+export var parseWebAppMatchConfig = function parseWebAppMatchConfig(extendInfo) {
+  if (!extendInfo) {
+    return [];
+  }
+  try {
+    var _extendInfoJson$sdkUp;
+    var extendInfoJson = JSON.parse(extendInfo);
+    return extendInfoJson === null || extendInfoJson === void 0 || (_extendInfoJson$sdkUp = extendInfoJson.sdkUpgradeInfo) === null || _extendInfoJson$sdkUp === void 0 ? void 0 : _extendInfoJson$sdkUp.versions;
+  } catch (error) {
+    console.error('Parse the 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']));
+  var targetVersions = supportMapping[productScene + '_' + paymentMethodCategoryType];
+  if (!targetVersions) {
+    return '';
+  }
+  // 从左到右，从旧到新
+  var isSupport = targetVersions.find(function (it) {
+    return it === productSceneVer;
+  });
+  var latestVersion = targetVersions[targetVersions.length - 1];
+  return isSupport ? productSceneVer : latestVersion;
+};

package/esm/index.d.ts

@@ -1,10 +1,11 @@
-import { AMSComponent } from './core/component/index';
 import { AddressComponent } from './core/component/address';
-import { IoptionsParams, componentSignEnum, IoptionsAddressParams } from './types';
+import { ElementComponent } from './core/component/element';
+import { AMSComponent } from './core/component/index';
+import { ComponentSignEnum, IcreateComponent, IElementOptions, IoptionsAddressParams, IoptionsParams } from './types';
 export { AMSCheckoutPage } from './core/component/ckp';
 export * from './types';
 export declare class AMSCheckout extends AMSComponent {
-    constructor(_options: IoptionsParams, channelType?: componentSignEnum[], productSceneVersion?: string);
+    constructor(_options: IoptionsParams, channelType?: ComponentSignEnum[], productSceneVersion?: string);
 }
 export declare class AMSAutoDebit extends AMSCheckout {
     constructor(options: IoptionsParams);
@@ -12,9 +13,6 @@ export declare class AMSAutoDebit extends AMSCheckout {
 export declare class AMSAutoDebitPay extends AMSCheckout {
     constructor(options: IoptionsParams);
 }
-export declare class AMSEasyPay extends AMSCheckout {
-    constructor(options: IoptionsParams);
-}
 export declare class AMSCashierPayment extends AMSCheckout {
     constructor(options: IoptionsParams);
 }
@@ -27,4 +25,12 @@ export declare class AntomElement extends AMSCheckout {
 export declare class AddressElement extends AddressComponent {
     constructor(options: IoptionsAddressParams);
 }
+export declare class Element extends ElementComponent {
+    constructor(options: IElementOptions);
+}
 export default AMSCheckout;
+export declare class AMSEasyPay {
+    private core;
+    constructor(options: IoptionsParams);
+    createComponent(params: IcreateComponent): void;
+}