@alipay/ams-checkout 0.0.1756987734-dev.0 → 0.0.1756987734-dev.2

package/esm/config/index.d.ts

@@ -6,10 +6,10 @@ export declare const sdkVersion: string;
  * @description: 目前应用层分为v1和v2，会存在两个应用版本号不是同步发布的情况。所以需要把默认的应用版本号配置抽离出来。
  * TODO 这里考虑直接换成packagejson.version
  */
-export declare const AMSCheckoutAppVersion = "1.42.1";
-export declare const AMSAutoDebitAppVersion = "1.42.1";
-export declare const AMSEasyPayAppVersion = "1.42.1";
-export declare const AMSCashierPaymentAppVersion = "1.42.1";
-export declare const AMSVaultingAppVersion = "1.42.1";
-export declare const AMSPaymentElementAppVersion = "1.42.1";
-export declare const ADDRESSElementAppVersion = "1.42.1";
+export declare const AMSCheckoutAppVersion = "1.43.0";
+export declare const AMSAutoDebitAppVersion = "1.43.0";
+export declare const AMSEasyPayAppVersion = "1.43.0";
+export declare const AMSCashierPaymentAppVersion = "1.43.0";
+export declare const AMSVaultingAppVersion = "1.43.0";
+export declare const AMSPaymentElementAppVersion = "1.43.0";
+export declare const ADDRESSElementAppVersion = "1.43.0";

package/esm/config/index.js

@@ -36,10 +36,10 @@ export var sdkVersion = json.version;
  * @description: 目前应用层分为v1和v2，会存在两个应用版本号不是同步发布的情况。所以需要把默认的应用版本号配置抽离出来。
  * TODO 这里考虑直接换成packagejson.version
  */
-export var AMSCheckoutAppVersion = '1.42.1'; // 兜底版本号
-export var AMSAutoDebitAppVersion = '1.42.1'; // 代扣
-export var AMSEasyPayAppVersion = '1.42.1'; // easypay
-export var AMSCashierPaymentAppVersion = '1.42.1'; // 收银台（卡、apm）
-export var AMSVaultingAppVersion = '1.42.1'; // 绑卡
-export var AMSPaymentElementAppVersion = '1.42.1'; // payment element
-export var ADDRESSElementAppVersion = '1.42.1'; // address element
+export var AMSCheckoutAppVersion = '1.43.0'; // 兜底版本号
+export var AMSAutoDebitAppVersion = '1.43.0'; // 代扣
+export var AMSEasyPayAppVersion = '1.43.0'; // easypay
+export var AMSCashierPaymentAppVersion = '1.43.0'; // 收银台（卡、apm）
+export var AMSVaultingAppVersion = '1.43.0'; // 绑卡
+export var AMSPaymentElementAppVersion = '1.43.0'; // payment element
+export var ADDRESSElementAppVersion = '1.43.0'; // address element

package/esm/constant/index.d.ts

@@ -249,6 +249,15 @@ export declare const EVENT: {
     messageForward: {
         name: string;
     };
+    validateFieldsResult: {
+        name: string;
+        uniqueKey: string;
+    };
+};
+export declare const SENDEVENT: {
+    validateFields: {
+        name: string;
+    };
 };
 export declare const COMPONENT_CONTAINER_ID = "ams-component-container";
 export declare const COMPONENT_SECTION_ID = "ams-component-section";

package/esm/constant/index.js

@@ -250,6 +250,17 @@ export var EVENT = {
    */
   messageForward: {
     name: 'onMessageForward'
+  },
+  validateFieldsResult: {
+    name: 'validateFieldsResult',
+    uniqueKey: 'uservalidateFieldsResult'
+  }
+};
+
+// 2025.09新增，非全量SDK发送事件码
+export var SENDEVENT = {
+  validateFields: {
+    name: 'validateFields'
   }
 };
 export var COMPONENT_CONTAINER_ID = 'ams-component-container';

package/esm/core/component/index.d.ts

@@ -1,5 +1,5 @@
 import ComponentApp from '../../plugin/component';
-import { ComponentSignEnum, IappendIframeNodesParams, IcreateComponent, IoptionsParams, IPaymentSessionMetaData, Iselector, Isubmit, PaymentMethodTypeEnum, SubPaymentMethodTypeEnum } from '../../types';
+import { ComponentSignEnum, EventPayloadContext, IappendIframeNodesParams, IcreateComponent, IoptionsParams, IPaymentSessionMetaData, Iselector, Isubmit, PaymentMethodTypeEnum, SubPaymentMethodTypeEnum, ValidationResult } from '../../types';
 import CoreInstance from '../instance/index';
 export declare const getComponentSign: (params: IPaymentSessionMetaData) => ComponentSignEnum;
 export declare const parseSessionData: (sessionData: string) => [IPaymentSessionMetaData, string];
@@ -52,4 +52,6 @@ export declare class AMSComponent extends CoreInstance {
      * @param data - Transfer information in the submission interface according to your requirements (optional)
      */
     submit(data?: Isubmit): Promise<unknown>;
+    protected _validateFields(): Promise<ValidationResult>;
+    protected _sendMessageToAPP(eventContext: EventPayloadContext): void;
 }

package/esm/core/component/index.js

@@ -35,7 +35,7 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  * 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 { v4 as uuid } from 'uuid';
-import { COMPONENTPLUGINID, ERRORMESSAGE, EVENT } from "../../constant";
+import { COMPONENTPLUGINID, ERRORMESSAGE, EVENT, SENDEVENT } from "../../constant";
 import { ApplePayBusSubscriber } from "../../plugin/applepay";
 import ComponentApp from "../../plugin/component";
 import { ExtendPlugin } from "../../plugin/const";
@@ -526,6 +526,88 @@ export var AMSComponent = /*#__PURE__*/function (_CoreInstance) {
         }
       });
     }
+
+    // 预留给AMSVaulting复用
+  }, {
+    key: "_validateFields",
+    value: function _validateFields() {
+      var _this9 = this;
+      return new Promise(function (resolve) {
+        // 收银台应用渲染表单后，才允许发送校验消息，三端约定一致
+        if (!_this9._componentApp.shouldValidateFields()) {
+          resolve({
+            isValid: false
+          });
+          _this9.logger.logInfo({
+            title: 'sdk_event_validateFields'
+          }, {
+            processResult: 'notRenderComponent'
+          });
+          return;
+        }
+        var timeoutId;
+        var validationPromise = new Promise(function (validationResolve) {
+          // 发送validateFields消息
+          _this9._sendMessageToAPP({
+            event: SENDEVENT.validateFields.name,
+            data: {}
+          });
+          // 接收收银台应用的返回validateFieldsResult消息
+          _this9._overrideSubscription(EVENT.validateFieldsResult.name, /*#__PURE__*/function () {
+            var _ref5 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(payload) {
+              return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+                while (1) switch (_context2.prev = _context2.next) {
+                  case 0:
+                    _this9.logger.logInfo({
+                      title: 'sdk_event_validateFields'
+                    }, {
+                      processResult: payload.isValid ? 'true' : 'false'
+                    });
+                    // 收银台应用保证数据格式，三端SDK负责透传
+                    validationResolve(payload);
+                  case 2:
+                  case "end":
+                    return _context2.stop();
+                }
+              }, _callee2);
+            }));
+            return function (_x2) {
+              return _ref5.apply(this, arguments);
+            };
+          }(), EVENT.validateFieldsResult.uniqueKey);
+        });
+
+        // 兜底场景，三端约定超时时间15秒，兼容cpf网络校验超时场景
+        var timeoutPromise = new Promise(function (timeoutResolve) {
+          timeoutId = setTimeout(function () {
+            _this9.logger.logInfo({
+              title: 'sdk_event_validateFields'
+            }, {
+              processResult: 'timeout'
+            });
+            timeoutResolve({
+              isValid: false
+            });
+          }, 15000);
+        });
+        Promise.race([validationPromise, timeoutPromise]).then(function (result) {
+          clearTimeout(timeoutId);
+          resolve(result);
+        }).catch(function () {
+          clearTimeout(timeoutId);
+          resolve({
+            isValid: false
+          });
+        });
+      });
+    }
+  }, {
+    key: "_sendMessageToAPP",
+    value: function _sendMessageToAPP(eventContext) {
+      this._componentApp.dispatchToApp({
+        context: eventContext
+      });
+    }
   }]);
   return AMSComponent;
 }(CoreInstance);

package/esm/index.d.ts

@@ -1,7 +1,7 @@
 import { AddressComponent } from './core/component/address';
 import { ElementComponent } from './core/component/element';
 import { AMSComponent } from './core/component/index';
-import { ComponentSignEnum, IcreateComponent, IElementOptions, IoptionsAddressParams, IoptionsParams, IPreloadOptions } from './types';
+import { ComponentSignEnum, IcreateComponent, IElementOptions, IoptionsAddressParams, IoptionsParams, IPreloadOptions, ValidationResult } from './types';
 export { AMSCheckoutPage } from './core/component/ckp';
 export * from './types';
 export declare class AMSCheckout extends AMSComponent {
@@ -14,6 +14,15 @@ export declare class AMSAutoDebitPay extends AMSCheckout {
 export declare class AMSCashierPayment extends AMSCheckout {
     constructor(options: IoptionsParams);
     static preload(options?: IPreloadOptions): void;
+    /**
+   * Form validation function
+   * If the form is currently displayed:
+   *   - Successful validation: isValid is true
+   *   - Failed validation: isValid is false, and error messages are displayed on the form page
+   * If not on the form display page, isValid returns false
+   * @returns {Promise<ValidationResult>} Returns a Promise containing the validation result
+   */
+    validateFields(): Promise<ValidationResult>;
 }
 export declare class AMSVaulting extends AMSCheckout {
     constructor(options: IoptionsParams);

package/esm/index.js

@@ -111,7 +111,21 @@ export var AMSCashierPayment = /*#__PURE__*/function (_AMSCheckout2) {
     }
     return _super3.call(this, _options, currentChannelType);
   }
-  _createClass(AMSCashierPayment, null, [{
+  _createClass(AMSCashierPayment, [{
+    key: "validateFields",
+    value:
+    /**
+    * Form validation function
+    * If the form is currently displayed:
+    *   - Successful validation: isValid is true
+    *   - Failed validation: isValid is false, and error messages are displayed on the form page
+    * If not on the form display page, isValid returns false
+    * @returns {Promise<ValidationResult>} Returns a Promise containing the validation result
+    */
+    function validateFields() {
+      return this._validateFields();
+    }
+  }], [{
     key: "preload",
     value: function preload() {
       var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {

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

@@ -28,6 +28,7 @@ export default class ComponentApp {
     private _isAppWebview;
     _merchantAppointParam: IMerchantAppointParam;
     private _webAppHeartBeatTimeoutFn;
+    private _hasRenderComponent;
     constructor(componentOption?: {
         appVersion?: string;
     });
@@ -126,5 +127,6 @@ export default class ComponentApp {
     private showRetentionPopup;
     private hideRetentionPopupFunc;
     private submitForm;
+    shouldValidateFields(): boolean;
 }
 export {};

package/esm/plugin/component/index.js

@@ -23,7 +23,7 @@ import { COMPONENTPLUGINID, COMPONENT_CLOSE_BLOCK_ID, COMPONENT_CLOSE_MASK_BLOCK
 import { ElementPaymentMethod } from "../../core/component/oldElement/type";
 import { queryPaymentInfo, submitPayInfo } from "../../service";
 import { ComponentSignEnum, DisplayTypeEnum, eventCodeEnum, MessageName, PlatformEnum, ProductSceneEnum, RedirectType, TargetEnum } from "../../types";
-import { getType, isJsonString, isPC } from "../../util";
+import { getType, isJsonString, isPC, device } from "../../util";
 import { getBackScheme } from "../../util/getBackScheme";
 import { isLocalMock } from "../../util/mock";
 import { matchVersion } from "../../util/versionCompare";
@@ -62,6 +62,7 @@ var ComponentApp = /*#__PURE__*/function () {
     _defineProperty(this, "_isAppWebview", void 0);
     _defineProperty(this, "_merchantAppointParam", void 0);
     _defineProperty(this, "_webAppHeartBeatTimeoutFn", void 0);
+    _defineProperty(this, "_hasRenderComponent", false);
     this._appVersion = componentOption.appVersion;
     this._isInitComponent = false;
     this._selector = "#".concat(COMPONENT_SECTION_ID);
@@ -71,7 +72,7 @@ var ComponentApp = /*#__PURE__*/function () {
     this.createPreloadIframeNode = function () {
       return Promise.resolve();
     };
-    this.platform = isPC() ? PlatformEnum.desktop : PlatformEnum.mobile;
+    this.platform = device.isMobile ? PlatformEnum.mobile : PlatformEnum.desktop;
     this._isRetention = true;
     this._appLocationSearch = '';
     this._performanceData.push({
@@ -1842,6 +1843,7 @@ var ComponentApp = /*#__PURE__*/function () {
               return this._actionSubmitPromise;
             case 9:
               submitRes = _context8.sent;
+              this._hasRenderComponent = true;
               this._performanceData.push({
                 key: 'sdk_render_component',
                 value: Date.now()
@@ -1897,16 +1899,16 @@ var ComponentApp = /*#__PURE__*/function () {
                 }
               });
               // eslint-disable-next-line no-empty
-              _context8.next = 18;
+              _context8.next = 19;
               break;
-            case 16:
-              _context8.prev = 16;
+            case 17:
+              _context8.prev = 17;
               _context8.t0 = _context8["catch"](0);
-            case 18:
+            case 19:
             case "end":
               return _context8.stop();
           }
-        }, _callee8, this, [[0, 16]]);
+        }, _callee8, this, [[0, 17]]);
       }));
       function sendRenderEvent() {
         return _sendRenderEvent.apply(this, arguments);
@@ -1933,6 +1935,7 @@ var ComponentApp = /*#__PURE__*/function () {
       this._performanceData = [];
       this._isInitComponent = false;
       this.app = null;
+      this._hasRenderComponent = false;
       if (immediately) this.cleanElement();else {
         setTimeout(function () {
           _this10.cleanElement();
@@ -2019,6 +2022,11 @@ var ComponentApp = /*#__PURE__*/function () {
         form.submit();
       }, 0);
     }
+  }, {
+    key: "shouldValidateFields",
+    value: function shouldValidateFields() {
+      return this._hasRenderComponent;
+    }
   }]);
   return ComponentApp;
 }();

package/esm/types/index.d.ts

@@ -40,6 +40,9 @@ export interface IoptionsParams {
     mode?: string;
     securityRegion?: 'US' | 'SG' | 'DE';
 }
+export interface ValidationResult {
+    isValid: boolean;
+}
 export interface IPreloadOptions {
     environment?: string;
     securityRegion?: 'US' | 'SG' | 'DE';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/ams-checkout",
-  "version": "0.0.1756987734-dev.0",
+  "version": "0.0.1756987734-dev.2",
   "description": "",
   "author": "",
   "main": "esm/index.js",