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

package/esm/modern/core/bus/index.d.ts

@@ -0,0 +1,125 @@
+import type { Logger } from '../../util/logger';
+/**
+ * Bus 埋点内容定义
+ */
+export declare enum BusLogEventEnum {
+    /**
+     * 发送消息
+     * action：string
+     */
+    sdk_event_busPublishMessage = "sdk_event_busPublishMessage",
+    /**
+     * 发送消息时，返回事件结果(Web)
+     * action：string
+     */
+    sdk_event_busPublishCallback = "sdk_event_busPublishCallback",
+    /**
+     * 查询是否订阅
+     * action：string
+     * sub (processResult): bool
+     */
+    sdk_event_busIsSubscribe = "sdk_event_busIsSubscribe",
+    /**
+     * 订阅协议
+     * actions (actionNames): string[] , 用逗号拼接
+     */
+    sdk_event_busSubscribe = "sdk_event_busSubscribe",
+    /**
+     * 退订协议
+     * actions (actionNames): string[] , 用逗号拼接
+     */
+    sdk_event_busUnsubscribe = "sdk_event_busUnsubscribe",
+    /**
+     * 清除缓存（Web/Android）
+     */
+    sdk_event_busClear = "sdk_event_busClear",
+    /**
+     * 添加拦截器（Web/Android）
+     */
+    sdk_event_busAddInterceptor = "sdk_event_busAddInterceptor",
+    /**
+     * 发送消息时，对应aciton未订阅
+     */
+    sdk_error_busPublishUnsubscribeError = "sdk_error_busPublishUnsubscribeError",
+    /**
+     * 发送消息时异常
+     */
+    sdk_error_busPublishError = "sdk_error_busPublishError",
+    /**
+     * 发送消息无结果(Web)
+     */
+    sdk_error_busPublishNoResult = "sdk_error_busPublishNoResult"
+}
+/**
+ * 扩展协议可序列化的消息定义
+ */
+export declare class BusMessage {
+    private action;
+    private data;
+    private jsonData;
+    constructor(action: string, data?: string);
+    getAction(): string;
+    getData(): string;
+    isJSONData(): boolean;
+    getJSONObject(): any;
+    private parseJSONData;
+    result(result?: any): BusMessage;
+}
+export type OnBusCallback = (message: BusMessage) => void;
+/**
+ *  扩展总线可选的Context参数，在Web端用于实时回调
+ */
+export declare class BusContext {
+    private callback;
+    constructor(callback: OnBusCallback);
+    onCallBack(message: BusMessage): void;
+}
+/**
+ * 扩展能力的能力定义，基于此协议实现扩展能力
+ */
+export declare abstract class BusSubscriber {
+    abstract actionNames(): string[];
+    abstract onMessage(context: BusContext, message: BusMessage): void;
+}
+/**
+ * 拦截器，可增加扩展性
+ */
+export interface BusInterceptor {
+    /**
+     * 未订阅场景拦截
+     * @param actionName
+     */
+    onUnsubscribedAction?(actionName: string): boolean;
+    /**
+     * 分发消息场景处理异常
+     * @param message
+     */
+    onPublishException?(message: BusMessage, e: any): void;
+}
+/**
+ * 事件总线入口，支持的关系为：
+ * 发送者 和 接收者的关系：   一对一，大多数场景，支持callback
+ * 发送者 和 接收者的关系：   多对一， 设计上多一对，但是同一时间点，只会一个发送者，支持callback
+ * 发送者 和 接收者的关系：   一对多，可能有，埋点多重上报？不需要callback，业务场景应该是一个广播场景
+ */
+export declare class BusManager {
+    private static TAG;
+    private static _logSplit;
+    private static interceptors;
+    private static subscribersMap;
+    private static isDebug;
+    private static logger;
+    static debugTrace(enable: boolean, logger: Logger): void;
+    private static traceLog;
+    private static traceError;
+    static clear(): void;
+    static addInterceptor(interceptor: BusInterceptor): void;
+    static publishForResult(message: BusMessage, config?: {
+        timeoutMs?: number;
+        fallback?: any;
+    }): Promise<BusMessage>;
+    static publish(message: BusMessage, callback?: OnBusCallback): void;
+    static subscribe(subscriber: BusSubscriber): void;
+    static unsubscribe(subscriber: BusSubscriber): void;
+    static isSubscribed(actionName: string): boolean;
+}

package/esm/modern/core/bus/interface.d.ts

@@ -0,0 +1,36 @@
+export declare enum PaymentActionEnum {
+    optional_init = "plugin_optional_init"
+}
+export declare enum ApplePayActionEnum {
+    canMakePayments = "plugin_CARD_APPLE_PAY_available",
+    createComponent = "plugin_CARD_APPLE_PAY_createComponent",
+    destroyComponent = "plugin_CARD_APPLE_PAY_destroyComponent"
+}
+export declare enum PaypalActionEnum {
+    mountComponent = "plugin_Paypal_mountComponent",
+    destroyComponent = "plugin_Paypal_destroyComponent"
+}
+export declare enum SDKCallbackActionEnum {
+    onEventCallback = "onEventCallback"
+}
+export declare enum SecuritySDKActionEnum {
+    getSecurityDeviceId = "getSecurityDeviceId"
+}
+export declare enum TrackerActionEnum {
+    /**
+     * level: string info/error
+     * basic: json object
+     * extra: json object
+     */
+    reportAnalytics = "reportAnalytics"
+}
+export declare enum ComponentActiontEnum {
+    onDestory = "onDestory"
+}
+export declare enum RequestActiontEnum {
+    onDestory = "httpRequest"
+}
+export declare enum LoadingActiontEnum {
+    showLoading = "showLoading",
+    dismissLoading = "dismissLoading"
+}

package/esm/modern/core/component/address.d.ts

@@ -0,0 +1,8 @@
+import { IoptionsParams } from '../../types';
+import { AMSComponent } from './index';
+export declare class AddressComponent extends AMSComponent {
+    constructor(options: IoptionsParams & {
+        appVersion: string;
+    });
+    getValue(hasValidate?: boolean): Promise<unknown>;
+}

package/esm/modern/core/component/appPreloadProcessing.d.ts

@@ -0,0 +1 @@
+export declare function loadChannelPneumaticControl(paymentSessionFactor: any, logger: any): Promise<unknown>;

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

@@ -0,0 +1,29 @@
+import { IcreateComponent, IoptionsParams } from '../../../types';
+import { Logger } from '../../../util/logger';
+type LOCAL_URL = string;
+export type CKPEmbeddedAppEnv = 'dev' | 'sit' | 'pre' | 'prod';
+export type CKPEmbeddedEventType = 'SDK_PAYMENT_SUCCESSFUL' | 'SDK_PAYMENT_FAIL' | 'SDK_PAYMENT_CANCEL' | 'SDK_PAYMENT_CLICK_BACK_TO_MERCHANT';
+export declare const getCKPPageAddress: (env: IoptionsParams["environment"] | LOCAL_URL) => string;
+export declare class AMSCheckoutPage {
+    logger: Logger;
+    private _instanceId;
+    private iframe;
+    private originOptions;
+    private readonly APP_IFRAME_ID;
+    private eventListener?;
+    constructor(options: Pick<IoptionsParams, 'environment' | 'locale' | 'onEventCallback'>);
+    private generateIframeSrc;
+    private eventListenerWrapper;
+    private addListener;
+    private removeListener;
+    private dispatchToApp;
+    /**
+     * 挂载组件
+     */
+    mountComponent(params: Pick<IcreateComponent, 'sessionData' | 'isDemoMode'>, selector: string): Promise<void>;
+    /**
+     * 卸载组件
+     */
+    unmount(): void;
+}
+export {};

package/esm/modern/core/component/element/EventCenter/index.d.ts

@@ -0,0 +1,41 @@
+import { LogService } from '../../../../foundation/service/log';
+export declare class EventCenter {
+    private activeEvents;
+    private heartbeatIntervalId;
+    private readonly HEARTBEAT_INTERVAL;
+    private uniqueId;
+    private readonly logger;
+    constructor({ logger }: {
+        logger: LogService;
+    });
+    /**
+     * 注册事件
+     * @param {string} functionName 函数名称
+     * @returns {string} 返回事件起始ID
+     */
+    registerEvent(functionName: string, sessionData?: string): string;
+    /**
+     * 结束事件
+     * @param startId 事件起始ID
+     * @returns
+     */
+    endEvent(startId: string, extra?: any): void;
+    /**
+     * Cancels a single active event and reports it as an ended event with canceled=true.
+     * This is used when the mount flow is terminated early (for example, on destroy or abnormal exit).
+     */
+    cancelEvent(startId: string, extra?: any): void;
+    /**
+     * Cancels all active events whose event id starts with the given prefix.
+     * For example, prefix 'mount' will cancel events like mount_1_start.
+     */
+    cancelByPrefix(prefix: string, extra?: any): void;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private sendHeartbeat;
+    private sendLog;
+    private buildId;
+    private getEventName;
+    private buildIdFromStart;
+    private getEventNameFromStart;
+}

package/esm/modern/core/component/element/config.d.ts

@@ -0,0 +1,10 @@
+export declare enum ProductScene {
+    EXPRESS_CHECKOUT = "EXPRESS_CHECKOUT",
+    ELEMENT_PAYMENT = "ELEMENT_PAYMENT"
+}
+interface EventScenario {
+    eventName: ProductScene;
+    supportedEvents: string[];
+}
+export declare const productEventScenarios: EventScenario[];
+export {};

package/esm/modern/core/component/element/elementContainerService/containerService.d.ts

@@ -0,0 +1,34 @@
+import BaseElementProcessor from '../elementProcessor/baseElementProcessor';
+import { ContainerService } from './../../../../foundation/service/container';
+import { EventCenter } from './../../../../foundation/service/event-center';
+export declare enum IContainerStatus {
+    UNINIT = "UNINIT",
+    INITING = "INITING",
+    READY = "READY",
+    IN_BIZ_FLOW = "IN_BIZ_FLOW",
+    DESTROYED = "DESTROYED"
+}
+export declare class ContainerController {
+    private containerStatus;
+    private instanceId;
+    private containerService;
+    private eventService;
+    private containerElement;
+    private _globalData?;
+    constructor({ type, instanceId, selector, processor, options, }: {
+        type: string;
+        instanceId: string;
+        selector: string;
+        processor: BaseElementProcessor;
+        options: any;
+    });
+    private addEventListener;
+    getContainerElement(): HTMLDivElement;
+    createWebLaunchPromise(): Promise<unknown>;
+    switchContainerStatus(status: IContainerStatus): void;
+    getContainerStatus(): IContainerStatus;
+    getEventService(): EventCenter;
+    destroy(): void;
+    getContainerService(): ContainerService;
+    getInstanceId(): string;
+}

package/esm/modern/core/component/element/elementContainerService/index.d.ts

@@ -0,0 +1,20 @@
+import { ElementType } from '../type';
+import { ContainerController } from './containerService';
+export declare class ElementContainerService {
+    private containerServices;
+    private instanceId;
+    constructor({ instanceId }: {
+        instanceId: any;
+    });
+    addContainerService(name: ElementType, service: ContainerController): void;
+    getContainerService(name: ElementType): ContainerController | undefined;
+    getContainerServices(): Map<ElementType, ContainerController>;
+    destroy(): void;
+    mount({ type, selector, processor, options }: {
+        type: any;
+        selector: any;
+        processor: any;
+        options: any;
+    }): void;
+    getEventService(name: ElementType): import("../../../../foundation/service/event-center").EventCenter;
+}

package/esm/modern/core/component/element/elementController/index.d.ts

@@ -0,0 +1,54 @@
+import { AddressMountOptions, EventDataMap, EVENTNAME, ICommonApiResponse, IElementController, IElementOptions, IPaymentApiResponse, LinkAuthMountOptions, PaymentMountOptions, SubmitFuncParams } from '../type';
+declare class ElementController implements IElementController {
+    private options;
+    private elementContainer;
+    private serviceMap;
+    private loading;
+    private elementProcessors;
+    private initTimeout;
+    private elementContainerService;
+    private onStatusChangeCallback;
+    private submitPayPromise;
+    private elementEventCenter;
+    /** Current selected payment method type (e.g. 'APPLEPAY', 'CARD'), updated via paymentMethodChanged event */
+    private currentPaymentMethodType;
+    constructor(options: IElementOptions);
+    private initService;
+    private initElementProcessors;
+    private onEventCallback;
+    /**
+     * 处理初始化错误的方法
+     */
+    private handleInitializationError;
+    private handleMountError;
+    private clearAndSetInitTimeout;
+    private clearInitTimeout;
+    private clearEvents;
+    private setInitTimeout;
+    private initializeAndMountProcessor;
+    private handleStartBizFlowError;
+    mount(renderOptions: LinkAuthMountOptions | AddressMountOptions | PaymentMountOptions, sdkSelector: string): Promise<ICommonApiResponse>;
+    private onValidateFunc;
+    private onValidateAndSubmitPay;
+    /**
+     * 25/09/08 新增商户主动校验api
+     * @returns {Promise<{isValid: boolean}>}
+     */
+    validateFields(): Promise<{
+        isValid: boolean;
+    }>;
+    submitPayment(submitParams: SubmitFuncParams): Promise<IPaymentApiResponse>;
+    private changeLoading;
+    private addEventListener;
+    private sendRequestAndWaitWebLaunch;
+    private getErrorFromResponse;
+    private areAllContainersReady;
+    private sendReady;
+    updatePayment(paymentSessionData: string): Promise<boolean>;
+    private destroyHandle;
+    destroy(): void;
+    private setControllerStatusOrView;
+    on<T extends EVENTNAME>(event: T, callback: (data: EventDataMap[T]) => void): void;
+    private isEventAllowed;
+}
+export default ElementController;

package/esm/modern/core/component/element/elementProcessor/addressProcessor.d.ts

@@ -0,0 +1,20 @@
+import BaseElementProcessor from './baseElementProcessor';
+declare class AddressProcessor extends BaseElementProcessor {
+    onReady(extraParam: {
+        [key: string]: any;
+    }): void;
+    parameterInitAndCheck(): void;
+    beforeMount(): void;
+    preload(): void;
+    generateIframeSrc({ link, instanceId }: {
+        link: any;
+        instanceId: any;
+    }): string;
+    obtainData(): any;
+    getValue(hasValidate?: boolean): any;
+    update({ data, paymentSessionData }: {
+        data: any;
+        paymentSessionData: any;
+    }): void;
+}
+export default AddressProcessor;

package/esm/modern/core/component/element/elementProcessor/authProcessor.d.ts

@@ -0,0 +1,20 @@
+import BaseElementProcessor from './baseElementProcessor';
+declare class AuthProcessor extends BaseElementProcessor {
+    onReady(extraParam: {
+        [key: string]: any;
+    }): void;
+    parameterInitAndCheck(): void;
+    beforeMount(): void;
+    preload(): void;
+    generateIframeSrc({ link, instanceId }: {
+        link: any;
+        instanceId: any;
+    }): string;
+    obtainData(): any;
+    getValue(): any;
+    update({ data, paymentSessionData }: {
+        data: any;
+        paymentSessionData: any;
+    }): void;
+}
+export default AuthProcessor;

package/esm/modern/core/component/element/elementProcessor/baseElementProcessor.d.ts

@@ -0,0 +1,42 @@
+import { AntomSDKCore } from "../../../../foundation/core";
+import { Ianalytics, Ienv } from '../../../../types';
+import { EventCenter } from './../../../../foundation/service/event-center';
+interface ElementProcessorOptions {
+    env: Ienv;
+    locale: string;
+    networkMode: string;
+    mode: string;
+    analytics?: Ianalytics;
+    product: string;
+    preview?: boolean | 'web' | 'mobile';
+}
+declare abstract class BaseElementProcessor {
+    elementContainer: AntomSDKCore;
+    instanceId: string;
+    options: ElementProcessorOptions;
+    obtainDataRes: any;
+    elementUrl: string;
+    eventCenter: EventCenter;
+    eventListener: {};
+    abstract beforeMount(): void;
+    abstract preload(): void;
+    abstract generateIframeSrc({ instanceId, link }: {
+        instanceId: any;
+        link: any;
+    }): string;
+    abstract obtainData(): any;
+    abstract getValue(): any;
+    abstract onReady(extraParam: {
+        [key: string]: any;
+    }): void;
+    constructor(options: any);
+    private _setOptions;
+    abstract update(data: any): void;
+    registerElementContainer(elementContainer: AntomSDKCore): void;
+    registerEventCenter(eventCenter: EventCenter): void;
+    registerEventListener(event: any, callback: any): void;
+    setElementUrl(url: any): void;
+    getElementUrl(): string;
+    getObtainDataRes(): any;
+}
+export default BaseElementProcessor;

package/esm/modern/core/component/element/elementProcessor/convertPaymentMethods.d.ts

@@ -0,0 +1,22 @@
+import { IPaymentMethod } from "../../../../types";
+interface PaymentMethodsConfig {
+    expressCheckout?: {
+        enabled: boolean;
+        methods?: {
+            paymentMethodName: string;
+            paymentMethodType: string;
+        }[];
+    };
+    supportedMethods?: {
+        paymentMethodName: string;
+        paymentMethodType: string;
+        logoUrl?: string;
+    }[];
+    topping?: string;
+}
+/**
+ * 将 paymentMethods 配置转换为内部格式
+ * 与 CKP 的 convertPaymentMethods 逻辑保持一致
+ */
+export declare function convertPaymentMethods(paymentMethodsConf?: PaymentMethodsConfig): IPaymentMethod[];
+export {};

package/esm/modern/core/component/element/elementProcessor/paymentProcessor.d.ts

@@ -0,0 +1,37 @@
+import { LogService } from '../../../../foundation/service/log';
+import BaseElementProcessor from './baseElementProcessor';
+declare class PaymentProcessor extends BaseElementProcessor {
+    private ApplePayService;
+    /**
+     * Merchant's onBeforeConfirm callback reference, used in Apple Pay scenario only.
+     * Set by elementController.submitPayment before payment,
+     * triggered via beforeConfirm event after Apple Pay authorization in iframe.
+     */
+    private _onBeforeConfirm;
+    private _merchantAmount;
+    private _merchantCurrency;
+    setOnBeforeConfirm(callback: (() => Promise<boolean>) | null): void;
+    setMerchantAmountOverride(amount: string | null, currency: string | null): void;
+    onReady(extraParam: any): void;
+    getLogger(): LogService;
+    private addEventListener;
+    private initApplePaySdk;
+    beforeMount(): void;
+    preload(): void;
+    generateIframeSrc({ link, instanceId }: {
+        link: any;
+        instanceId: any;
+    }): string;
+    obtainData(): Promise<any>;
+    /**
+     * 构建预览模式的 mock 数据
+     * 合并 mock.ts 的硬编码数据和 mount 传入的 paymentMethods 配置
+     */
+    private buildPreviewMockData;
+    getValue(): any;
+    update({ data, paymentSessionData }: {
+        data: any;
+        paymentSessionData: any;
+    }): void;
+}
+export default PaymentProcessor;

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

@@ -0,0 +1,17 @@
+import { EventDataMap, EVENTNAME, IElementOptions, PaymentMountOptions, SubmitFuncParams } from './type';
+export declare class ElementComponent {
+    private options;
+    private controller;
+    constructor(options: IElementOptions);
+    /**
+     * @deprecated 不要使用，internal experiment方法
+     */
+    updatePayment(paymentSessionData: any): Promise<boolean>;
+    mount(renderOptions: PaymentMountOptions, sdkSelector: string): Promise<import("./type").ICommonApiResponse>;
+    validateFields(): Promise<{
+        isValid: boolean;
+    }>;
+    submitPayment(params: SubmitFuncParams): Promise<import("./type").IPaymentApiResponse>;
+    destroy(): void;
+    on<T extends EVENTNAME>(event: T, callback: (data: EventDataMap[T]) => void): void;
+}

package/esm/modern/core/component/element/mock.d.ts

@@ -0,0 +1,10 @@
+export declare const sdkAction1: any;
+export declare const sdkAction2: any;
+export declare const sdkAction: any;
+export declare const oneAccount1: any;
+export declare const oneAccount2: any;
+export declare const oneAccount: any;
+export declare const paymentResult: any;
+export declare const submitResult: any;
+export declare const sdkActionUpdate: any;
+export declare const oneAccountUpdate: any;

package/esm/modern/core/component/element/modernElementController/adapter.d.ts

@@ -0,0 +1,19 @@
+import type { IMerchantAppointParam } from "../../../../types";
+import type { IPaymentApiResponse, PaymentMountOptions } from '../type';
+import { EventCallbackCode } from '../type';
+import type { PaymentSubmitResult, ErrorPayload } from "../../../../modern/tools";
+export declare function adaptSubmitResult(result: PaymentSubmitResult): IPaymentApiResponse;
+export declare function adaptErrorToEventCallback(error: ErrorPayload): {
+    code: EventCallbackCode;
+    message: string;
+};
+/**
+ * 将老架构的 appearance 格式转换为新架构格式
+ *
+ * 转换规则：
+ * 1. theme: kebab-case → camelCase（如 'nostalgic-gray' → 'nostalgicGray'），其余保持不变
+ * 2. variables: 直接透传（kebab-case CSS 变量 key-value）
+ * 3. card.showBrandIcon → displaySetting.showCardBrandIcon
+ * 4. layout: 直接透传
+ */
+export declare function adaptAppearance(appearance?: PaymentMountOptions['appearance'], merchantAppointParam?: IMerchantAppointParam): any;