@alipay/ams-checkout 2.0.28 → 2.0.30

package/esm/modern/loadAntomTracker.d.ts

@@ -0,0 +1,7 @@
+interface LoadAntomTrackingConfig {
+    env: string;
+    locale?: string;
+    debug?: boolean;
+}
+export declare function runTrackedLoadAntom<T>(config: LoadAntomTrackingConfig, action: () => Promise<T>): Promise<T>;
+export {};

package/esm/modern/loadAntomTracker.js

@@ -0,0 +1,64 @@
+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 _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+import { tracker as loaderTracker } from '@antglobal/create-sdk-loader/lib/tracker';
+var getErrorCode = function getErrorCode(error) {
+  try {
+    var _value$error;
+    var value = error;
+    return (value === null || value === void 0 ? void 0 : value.code) || (value === null || value === void 0 || (_value$error = value.error) === null || _value$error === void 0 ? void 0 : _value$error.code) || 'UNKNOWN';
+  } catch (_unused) {
+    return 'UNKNOWN';
+  }
+};
+var reportLoadAntom = function reportLoadAntom(config, startedAt, outcome) {
+  var errorCode = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : '';
+  try {
+    loaderTracker.log({
+      code: '7882api',
+      msg: 'loadAntom',
+      d1: outcome,
+      d2: errorCode,
+      d3: '',
+      d4: '',
+      d5: 'loadAntom',
+      d6: config.env,
+      d7: String(config.locale !== undefined),
+      d8: config.debug === undefined ? '' : String(config.debug),
+      m1: Date.now() - startedAt
+    });
+  } catch (_unused2) {
+    // Loader diagnostics must never affect SDK loading.
+  }
+};
+export function runTrackedLoadAntom(_x, _x2) {
+  return _runTrackedLoadAntom.apply(this, arguments);
+}
+function _runTrackedLoadAntom() {
+  _runTrackedLoadAntom = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(config, action) {
+    var startedAt, result;
+    return _regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          startedAt = Date.now();
+          _context.prev = 1;
+          _context.next = 4;
+          return action();
+        case 4:
+          result = _context.sent;
+          reportLoadAntom(config, startedAt, 'success');
+          return _context.abrupt("return", result);
+        case 9:
+          _context.prev = 9;
+          _context.t0 = _context["catch"](1);
+          reportLoadAntom(config, startedAt, 'error', getErrorCode(_context.t0));
+          throw _context.t0;
+        case 13:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee, null, [[1, 9]]);
+  }));
+  return _runTrackedLoadAntom.apply(this, arguments);
+}

package/esm/modern/loader/constant.d.ts

@@ -0,0 +1,36 @@
+import type { AMSCashierPayment, AMSEasyPay, AMSElement } from '../main';
+declare global {
+    interface Window {
+        AMSCashierPayment?: typeof AMSCashierPayment;
+        AMSElement?: typeof AMSElement;
+        AMSEasyPay?: typeof AMSEasyPay;
+    }
+}
+/**
+ * 产品类型
+ */
+export type ProductType = AMSCashierPayment | AMSEasyPay | AMSElement;
+/**
+ * 产品构造函数
+ */
+export type ProductConstructor = typeof AMSCashierPayment | typeof AMSEasyPay | typeof AMSElement;
+/**
+ * 产品构造函数名称枚举
+ */
+export declare enum EConstructorName {
+    AMSCashierPayment = "AMSCashierPayment",
+    AMSEasyPay = "AMSEasyPay",
+    AMSElement = "AMSElement"
+}
+export declare const instanceApiMap: Record<EConstructorName, string[]>;
+/**
+ * SDK 集成类型枚举
+ */
+export type AntomWebSDKIntegrationType = 'CDN' | 'NPM';
+/**
+ * SDK 地址
+ */
+export declare const SDK_URL: {
+    DEV: string;
+    PROD: string;
+};

package/esm/modern/loader/utils/proxyPerformance.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 在window对象上记录商户初始化SDK的StartTime,加载结束时间
+ * 后续传递给Web应用,用于进行端到端渲染总耗时计算
+ * ***/
+import { ProductSceneEnum } from "../../types";
+import { EConstructorName } from '../constant';
+type TimeObject = {
+    startTime: number;
+    endTime: number;
+};
+/*** 扩展 Window 接口，添加 _ANTOM_SDK_PROXY_TIME 属性*/
+declare global {
+    interface Window {
+        _ANTOM_SDK_PROXY_TIME?: Partial<Record<EConstructorName, TimeObject>>;
+    }
+}
+export declare function setProxyStartTime(constructorName: EConstructorName, startTime: number): number;
+export declare function setProxyEndTime(constructorName: EConstructorName, endTime: number): number;
+export declare const getProxyCostTime: (productScene: ProductSceneEnum) => number;
+export {};

package/esm/modern/main.d.ts

@@ -0,0 +1,54 @@
+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, ValidationResult } from './types';
+export { AMSCheckoutPage } from './core/component/ckp';
+export * from './types';
+export declare class AMSCheckout extends AMSComponent {
+    constructor(_options: IoptionsParams, channelType?: ComponentSignEnum[], productSceneVersion?: string);
+}
+export declare class AMSAutoDebitPay extends AMSCheckout {
+    constructor(options: IoptionsParams);
+    static preload(options?: IPreloadOptions): void;
+}
+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);
+    static preload(options?: IPreloadOptions): void;
+}
+export declare class AntomElement extends AMSCheckout {
+    constructor(options: IoptionsParams);
+}
+export declare class AddressElement extends AddressComponent {
+    constructor(options: IoptionsAddressParams);
+}
+export declare class AMSElement extends ElementComponent {
+    constructor(options: IElementOptions);
+}
+export declare class AMSEasyPay {
+    private core;
+    constructor(options: IoptionsParams);
+    static preload(options?: IPreloadOptions): void;
+    createComponent(params: IcreateComponent): void;
+    unmount(): void;
+}
+export declare class AMSAutoDebit {
+    private core;
+    constructor(options: IoptionsParams);
+    createComponent(params: IcreateComponent): Promise<void>;
+    unmount(): void;
+    static preload(options?: IPreloadOptions): void;
+}
+export default AMSCheckout;

package/esm/modern/{index.d.ts → modern/index.d.ts}

@@ -1,4 +1,4 @@
-import type { AntomSDK, LoadAntomConfig, ShippingInfo } from "../../types";
+import type { AntomSDK, LoadAntomConfig, ShippingInfo } from "../../../types";
 /**
  * @description load Antom instance
  */

package/esm/modern/modern/loadAntomTracker.d.ts

@@ -0,0 +1,7 @@
+interface LoadAntomTrackingConfig {
+    env: string;
+    locale?: string;
+    debug?: boolean;
+}
+export declare function runTrackedLoadAntom<T>(config: LoadAntomTrackingConfig, action: () => Promise<T>): Promise<T>;
+export {};

package/esm/modern/modern/preload/antomManifestAdapter.d.ts

@@ -0,0 +1,11 @@
+import { type PreloadManifest, type PreloadPlan, type ResourceRule } from '@antintl/opensdk-preload';
+import { type AntomPreloadElement } from './config';
+interface ResolveAntomPreloadPlanOptions {
+    elements: readonly AntomPreloadElement[];
+    manifestUrl: string;
+    resourceRules: readonly ResourceRule[];
+    requireHttps: boolean;
+}
+export declare function resolveAntomPreloadPlan(options: ResolveAntomPreloadPlanOptions): Promise<PreloadPlan>;
+export declare function adaptAntomManifest(manifest: PreloadManifest, elements: readonly AntomPreloadElement[], options: Pick<ResolveAntomPreloadPlanOptions, 'resourceRules' | 'requireHttps'>): PreloadPlan;
+export {};

package/esm/modern/modern/preload/config.d.ts

@@ -0,0 +1,10 @@
+import type { ResourceRule } from '@antintl/opensdk-preload/types';
+export declare const ANTOM_PRELOAD_MANIFEST = "/elements2/manifest.json";
+export declare const ANTOM_PRELOAD_ELEMENTS: readonly ["payment", "express", "vaulting", "CVV"];
+export type AntomPreloadElement = (typeof ANTOM_PRELOAD_ELEMENTS)[number];
+export declare function getAntomPreloadRuntimeConfig(): {
+    manifestUrl: string;
+    runnerUrl: string;
+    resourceRules: ResourceRule[];
+    requireHttps: boolean;
+};

package/esm/modern/modern/preload/gatewayPreconnection.d.ts

@@ -0,0 +1,53 @@
+declare const PRECONNECTION_REGIONS: readonly ["SG", "US", "DE"];
+export type PreconnectionRegion = (typeof PRECONNECTION_REGIONS)[number];
+export type GatewayPreconnectionStatus = 'running' | 'completed' | 'partial_failed' | 'failed';
+type RegionResult = {
+    status: 'completed' | 'failed';
+    endTime: number;
+};
+export interface GatewayPreconnectionSnapshot {
+    mode: 'configured' | 'regional';
+    preconnectedRegions: readonly PreconnectionRegion[];
+    failedRegions: PreconnectionRegion[];
+    regionResults: Partial<Record<PreconnectionRegion, RegionResult>>;
+    gatewayUrl?: string;
+    actualRegion?: string;
+    predictionResult?: 'hit' | 'miss';
+    status: GatewayPreconnectionStatus;
+    preconnectionStartTime: number;
+    preconnectionEndTime?: number;
+    firstRpcStartTime?: number;
+    firstRpcEndTime?: number;
+    firstRpcTotalMs?: number;
+    preconnectionLeadTimeMs?: number;
+    preconnectionReadyBeforeFirstRpc?: boolean;
+    dnsDurationMs?: number;
+    tcpDurationMs?: number;
+    tlsDurationMs?: number;
+}
+export declare function startGatewayPreconnection(env: 'sandbox' | 'prod'): Promise<GatewayPreconnectionSnapshot>;
+export declare function recordActualRegion(region: string, env?: 'sandbox' | 'prod'): GatewayPreconnectionSnapshot | undefined;
+export declare function recordFirstRpcStart(env?: 'sandbox' | 'prod'): GatewayPreconnectionSnapshot | undefined;
+export declare function recordFirstRpcEnd(env?: 'sandbox' | 'prod'): GatewayPreconnectionSnapshot | undefined;
+export declare function getGatewayPreconnectionSnapshot(env?: 'sandbox' | 'prod'): {
+    mode: "configured" | "regional";
+    preconnectedRegions: readonly PreconnectionRegion[];
+    failedRegions: PreconnectionRegion[];
+    regionResults: Partial<Record<PreconnectionRegion, RegionResult>>;
+    gatewayUrl?: string;
+    actualRegion?: string;
+    predictionResult?: "hit" | "miss";
+    status: GatewayPreconnectionStatus;
+    preconnectionStartTime: number;
+    preconnectionEndTime?: number;
+    firstRpcStartTime?: number;
+    firstRpcEndTime?: number;
+    firstRpcTotalMs?: number;
+    preconnectionLeadTimeMs?: number;
+    preconnectionReadyBeforeFirstRpc?: boolean;
+    dnsDurationMs?: number;
+    tcpDurationMs?: number;
+    tlsDurationMs?: number;
+};
+export declare function waitForGatewayPreconnection(env?: 'sandbox' | 'prod'): Promise<GatewayPreconnectionSnapshot>;
+export {};

package/esm/modern/modern/preload/preloadAntomElements.d.ts

@@ -0,0 +1,12 @@
+import type { AntomPreloadElement } from './config';
+export declare function preloadAntomElements(elements: readonly AntomPreloadElement[]): Promise<void>;
+export declare function getAntomPreloadTelemetry(element: AntomPreloadElement): {
+    requested: boolean;
+    phaseAtElementCreate: "running" | "failed" | "resolving" | "critical_completed" | "skipped" | "not_requested";
+    leadTimeMs: number;
+    criticalDurationMs: number;
+    criticalTotal: number;
+    criticalSuccess: number;
+    criticalFailed: number;
+    taskId: string;
+};

package/esm/modern/modern/preload/startAntomPreload.d.ts

@@ -0,0 +1,2 @@
+import type { AntomPreloadElement } from './config';
+export declare function startAntomPreload(env: 'sandbox' | 'prod', elements?: readonly AntomPreloadElement[]): void;

package/esm/modern/modern/sdk/applepay-core/ApplePayHostService.d.ts

@@ -0,0 +1,102 @@
+declare global {
+    interface Window {
+        ApplePaySession?: any;
+    }
+}
+export interface ApplePayHostPaymentRequest {
+    countryCode: string;
+    currencyCode: string;
+    merchantCapabilities: string[];
+    supportedNetworks: string[];
+    requiredBillingContactFields?: string[];
+    requiredShippingContactFields?: string[];
+    total: {
+        type: string;
+        label: string;
+        amount: string;
+    };
+    version: number;
+    lineItems?: any[];
+    recurringPaymentRequest?: any;
+}
+export interface ApplePayHostAuthorizedEvent {
+    token: any;
+    billingContact?: any;
+    shippingContact?: any;
+}
+export interface ApplePayHostAuthorizedResult {
+    /** true = ApplePaySession.completePayment(STATUS_SUCCESS),false = STATUS_FAILURE */
+    success: boolean;
+    /** 业务返回(由调用方在外部使用) */
+    result?: any;
+    /** 失败时的错误码 / 提示(由调用方决定如何上抛) */
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface ApplePayHostServiceCallbacks {
+    /**
+     * 商户验证:onvalidatemerchant 触发,调用商户验证 API,返回 merchantSession 对象(
+     * 已 parse 的 object;若调用方拿到的是 JSON string,自行 parse 后再 resolve)
+     * reject 时 ApplePayHostService 会 session.abort() 并 reject startPay Promise
+     */
+    validateMerchant: (validationURL: string) => Promise<any>;
+    /**
+     * 用户授权完成:拿到 token + billing/shipping 后调商户的提交逻辑,返回结果
+     * 成功 → ApplePayHostService 调 completePayment(STATUS_SUCCESS) 并 resolve startPay Promise
+     * 失败 → ApplePayHostService 调 completePayment(STATUS_FAILURE) 并 reject startPay Promise
+     * 抛异常 → 视同失败
+     */
+    onAuthorized: (event: ApplePayHostAuthorizedEvent) => Promise<ApplePayHostAuthorizedResult>;
+}
+export interface ApplePayHostServiceOptions {
+    /** Apple Pay sheet 请求参数;字段校验在 startPay 入口做 */
+    paymentRequest: ApplePayHostPaymentRequest;
+    /** Callbacks 集合 */
+    callbacks: ApplePayHostServiceCallbacks;
+    /**
+     * 是否开启 modal close shadow DOM listener(国内非标方案监听 .modal-close-button 点击)
+     * 普通 elements2 路径开启;Express 路径默认不开启(原 _handleApplePayAtHost 没用)
+     */
+    enableModalCloseListener?: boolean;
+}
+export declare class ApplePayHostService {
+    private opts;
+    private session;
+    private settled;
+    /** session 生命周期阶段 */
+    private phase;
+    /**
+     * oncancel 原因标记：区分商户通过 onBeforeConfirm 中止 vs 其他。
+     * - null: 默认（非商户中止，即用户取消或其他原因）
+     * - 'MERCHANT_ABORT': 商户 onBeforeConfirm 返回 false 或异常导致中止
+     * - 'MERCHANT_TIMEOUT': 商户 onBeforeConfirm 超时导致中止
+     */
+    private cancelReason;
+    private modalCloseHandler;
+    /**
+     * 实例级并发守卫：startPay 进行中时，再次调用复用同一个 Promise 而非新建，
+     * 避免覆盖共享 session/settled 导致 Promise 永久 pending。null 表示当前无进行中流程。
+     */
+    private _activePay;
+    constructor(opts: ApplePayHostServiceOptions);
+    /**
+     * 启动 Apple Pay 流程。Promise 完成时机:
+     *   - resolve():onAuthorized 返回 success=true,completePayment(SUCCESS) 已调
+     *   - reject(err):onAuthorized 返回 success=false / 抛异常 / SDK 加载失败 / new session 失败 /
+     *     oncancel / validateMerchant 失败
+     */
+    startPay(): Promise<void>;
+    private _startPayInternal;
+    /**
+     * 构造 ApplePaySession 入参:从 paymentRequest 取字段,recurringPaymentRequest 若有则带上。
+     */
+    private buildSessionParams;
+    private safeAbort;
+    private safeComplete;
+    /**
+     * 监听 apple-pay-modal 的 close button(shadow DOM,国内非标方案)。
+     * 来源:原 ApplePaySdk.addEventListener(plugin/component/channel.ts:528-542)。
+     */
+    private attachModalCloseListener;
+    private clearModalCloseListener;
+}

package/esm/modern/modern/sdk/elements/CVVElement.d.ts

@@ -0,0 +1,144 @@
+import { type RequestOptions } from '@antintl/antom-toolset';
+import { type FontSource } from '@antintl/opensdk-bridge';
+import { type BaseElementAppConfig, type BaseElementConfig, BaseMainElement } from '@antintl/opensdk-core';
+import type { CashierSdkActionQueryResult, PaymentSessionConfig } from '../oneapi/iexpfront/definitions';
+import { type AntomBridgeEventMap, type AntomTheme, type AntomVariables, type AppearanceVariables, type PreloadTelemetryContext } from '../types';
+import { type AppearanceRuleSelector, type PickAntomAppearance } from './appearanceRules';
+export type CVVAppearanceProps = {
+    theme: AntomTheme;
+    variables: AppearanceVariables | AntomVariables;
+    fonts?: FontSource[];
+    rules: AppearanceRuleSelector<string>;
+};
+export type CVVAppearance = PickAntomAppearance<CVVAppearanceProps>;
+/**
+ * @public
+ * @description CVV element app config type
+ */
+export interface CVVAppConfig extends BaseElementAppConfig {
+    /** CVV appearance configuration including optional alias-only Rules. */
+    appearance?: CVVAppearance;
+    /**
+     * @description 创建时必填的支付会话；不可通过 updateConfig 或 submit 替换
+     */
+    sessionData: string;
+    /**
+     * @internal sessionConfig 渲染数据，内部使用，无需用户传递
+     */
+    paymentSessionConfig?: PaymentSessionConfig;
+    /**
+     * @internal 渲染数据，内部使用，无需用户传递
+     */
+    renderData?: CashierSdkActionQueryResult;
+    /**
+     * @internal sdk 版本号，内部使用，无需用户传递
+     */
+    sdkVersion?: string;
+    /**
+     * @internal 内部联调使用，生产环境传递无效
+     */
+    _requestConfig?: Partial<Omit<RequestOptions, 'scope' | 'tracker'>>;
+    /** @internal Elements2 preload grouping data. */
+    preloadTelemetryContext?: PreloadTelemetryContext;
+    /**
+     * @description 语言配置
+     */
+    locale?: string;
+    /**
+     * 支付流程类型
+     * - 'automatic'：无 UI，页面挂载后自动提交（无UI支付）
+     * - 'cvv'：有 UI，展示 CVV 输入框，由用户手动输入后提交
+     * @internal paymentFlow 内部使用，无需用户传递
+     */
+    paymentFlow?: 'automatic' | 'cvv';
+}
+export type CVVSubmitErrorCodes = 'NOT_FIND_MAINELEMENT' | 'SESSION_DATA_INVALID' | 'SDK_LAUNCH_PAYMENT_APP_ERROR' | string;
+/**
+ * @description CVV 支付错误结果
+ */
+export interface CVVSubmitError {
+    /**
+     * 是否成功
+     */
+    success: false;
+    /**
+     * 错误信息
+     */
+    error: {
+        /**
+         * 错误码
+         */
+        code: string;
+        /**
+         * 错误信息
+         */
+        message: string;
+        /**
+         * 错误类型
+         */
+        type?: string;
+        /**
+         * 错误详情
+         */
+        detail?: any;
+    };
+}
+/**
+ * @description CVV 支付提交参数
+ */
+export interface CVVSubmitParams {
+    /**
+     * 重定向策略
+     */
+    redirect?: 'always' | 'if_required';
+    /**
+     * 集成用户自定义信息（如 cardHolderName）
+     */
+    params?: Record<string, unknown>;
+}
+export interface CVVElementEvents extends AntomBridgeEventMap<CVVAppConfig, CVVSubmitParams & Pick<CVVAppConfig, 'sessionData'>> {
+    /**
+     * @description Emitted when the element is destroy
+     */
+    destroy: void;
+}
+/**
+ * @public
+ * @description CVV element config type
+ */
+export interface CVVElementConfig extends BaseElementConfig<CVVAppConfig> {
+    appConfig: CVVAppConfig;
+}
+/**
+ * @description CVV element
+ */
+export declare class CVVElement extends BaseMainElement<CVVElementConfig, CVVElementEvents> {
+    static elementType: string;
+    private readonly sessionData;
+    private readonly elementTracker;
+    private _mountInProgress;
+    private _destroyInProgress;
+    constructor(name: string, config: CVVElementConfig);
+    /**
+     * @internal
+     */
+    setup(): Promise<Partial<CVVAppConfig> | undefined>;
+    /**
+     * @internal Not supported by the public CVV integration API.
+     * Updates appearance only, preserving the Rules clear semantics.
+     * @param newConfig Appearance configuration patch.
+     * @returns The WebApp update acknowledgement.
+     */
+    updateConfig(newConfig: Pick<CVVAppConfig, 'appearance'>): Promise<CVVElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
+    /**
+     * @internal
+     */
+    submit(data?: CVVSubmitParams): Promise<import("../types").SubmitResult>;
+    mount(container: HTMLElement): Promise<void>;
+    on<T extends keyof CVVElementEvents>(event: T, handler: (payload: CVVElementEvents[T]) => void): void;
+    unmount(): void;
+    destroy(): void;
+    protected focus(): void;
+    protected blur(): void;
+    protected clear(): void;
+}