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

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

@@ -0,0 +1,58 @@
+import ComponentApp from '../../plugin/component';
+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];
+export declare const handleParams: (params: IcreateComponent, _this: any) => Promise<{
+    iframeNodesParams: IappendIframeNodesParams;
+    componentSign: ComponentSignEnum.EASY_PAY_WALLET | ComponentSignEnum.EASY_PAY_APM | ComponentSignEnum.CASHIER_PAYMENT_CARD | ComponentSignEnum.CASHIER_PAYMENT_BANK | ComponentSignEnum.CASHIER_PAYMENT_APM | ComponentSignEnum.AUTO_DEBIT_WALLET | ComponentSignEnum.AUTO_DEBIT_PAY_WALLET | ComponentSignEnum.VAULTING_CARD | ComponentSignEnum.CHECKOUT_PAYMENT | ComponentSignEnum.ELEMENT_PAYMENT | ComponentSignEnum.ELEMENT_ADDRESS | ComponentSignEnum.AUTO_DEBIT_APM;
+}>;
+export type IAMSComponentOptions = IoptionsParams & {
+    appVersion: string;
+};
+export declare class AMSComponent extends CoreInstance {
+    _componentApp: ComponentApp;
+    channelType: ComponentSignEnum[];
+    productSceneVersion: string;
+    timer: any;
+    private _validateResolveMap;
+    constructor(options: IAMSComponentOptions);
+    private parameterInitAndCheck;
+    private pluginAppendIframe;
+    private savePreviousChannel;
+    /**
+     * 初始化 Bus总线的能力
+     */
+    private registerBusAbility;
+    /**
+     * To determine whether the corresponding payment method is available,
+     *  only the channel described in the document will be called, and it will be returned as available by default
+     * @param paymentMethod  - described in the document
+     * @param subPaymentMethod - described in the document
+     * @returns
+     */
+    canMakePayments(paymentMethod: PaymentMethodTypeEnum, subPaymentMethod?: SubPaymentMethodTypeEnum): Promise<boolean>;
+    /**
+     * @description Create component application
+     * @param params - The data source created by the component, necessary sessionData, optional appearance configuration, and refer to the documentation for other parameters and detailed information.
+     */
+    createComponent(params: IcreateComponent): Promise<void>;
+    private createComponentProcess;
+    preloadComponent(channelType: any, productSceneVersion: any): void;
+    private clearPreloadIframe;
+    /**
+     * @description Create and render components in the specified element area
+     * @param params - The data source created by the component, necessary sessionData, optional appearance configurations, and refer to the documentation for other parameters and detailed information.
+     * @param selector - Necessary element selector ID
+     */
+    mountComponent(params: IcreateComponent, selector: Iselector): Promise<void>;
+    private mountComponentProcess;
+    /**
+     * @description Execute payment submission process
+     * @description - When using your own payment button, you can execute the submit payment process by actively calling this function.
+     * @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/modern/core/instance/index.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Copyright (c) 2022 International Business Group, Ant Group. All rights reserved.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), the rights to use, copy, modify, merge, and/or distribute the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ * 1. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE; and
+ * 2. If applicable, the use of the Software is also subject to the terms and conditions of any non-disclosure agreement signed by you and the relevant Ant Group entity.
+ */
+import { ComponentActionNamesType } from '../../plugin/type';
+import ComponentApp from '../../plugin/component';
+import type { AMSCheckoutOptions, IAppendParams, InitSecurityConfig, IoptionsParams } from '../../types/index';
+import { EventCenter } from '../../util/index';
+import { Logger } from '../../util/logger';
+import { Security } from '../../util/security';
+import type { ISecurity } from '../../util/security-registry';
+export default class AMSSDK {
+    options: AMSCheckoutOptions;
+    originOptions: IoptionsParams;
+    logger: Logger;
+    _eventCenter: EventCenter;
+    _instanceId: string;
+    _storageId: string;
+    _appendParams: IAppendParams;
+    _componentApp: ComponentApp;
+    protected securitySdkMap: Map<string, Security>;
+    protected plugins: Map<string, any>;
+    constructor(options: IoptionsParams);
+    private preInitSecurity;
+    /**
+     * @description Destroy and process some contents of the plug-in
+     */
+    unmount(): void;
+    /**
+     * @description init security SDK
+     * @param product Product Scenarios
+     * @param scene Scenario of the product (compatible with old version parameters, about to be deleted)
+     */
+    initSecurity({ product, scene, }: InitSecurityConfig & {
+        scene?: string;
+    }): void;
+    /**
+     * @description Obtain security SDK through scenario identification (async-aware)
+     * Handles three states: ready, loading, not found
+     */
+    _getSecuritySDKByProductScene(securityConfig: InitSecurityConfig): ISecurity;
+    /**
+     * @description Await security SDK by product scene (async)
+     * Returns the Security instance even if currently loading
+     */
+    _awaitSecuritySDKByProductScene(securityConfig: InitSecurityConfig): Promise<Security | undefined>;
+    /**
+     * @description New security SDK through scenario identification (async-aware)
+     * Uses shared SecuritySdkRegistry and triggers ApdidLoader
+     */
+    _newSecuritySDKByScene(securityConfig: InitSecurityConfig, successCallback?: () => void, failCallback?: (errMsg?: string) => void): void;
+    /**
+     * @description Obtain risk control configuration in local storage
+     */
+    private getSecurityConfigStorage;
+    /**
+     * @description Set the sdk basic configuration
+     */
+    private _setOptions;
+    /**
+     * @description Set environment variables
+     */
+    private _setEnv;
+    /**
+     * @description Set UI and Network Mode
+     */
+    private _setMode;
+    /**
+     * @description Initialize event related tasks
+     */
+    private _initEvent;
+    /**
+     * @description Register plug-in
+     */
+    protected _registerPlugin(pluginId: string, plugin: any): void;
+    /**
+     * @description Get Plug-in
+     */
+    protected _getPlugin(pluginId: string): any;
+    /**
+     * @description Execute to open app or jump link
+     */
+    _redirect(data: {
+        normalUrl?: string;
+        schemeUrl?: string;
+        applinkUrl?: string;
+        callAppJudgeTime?: number;
+    }): Promise<void>;
+    /**
+     * @description Overlay Subscription
+     */
+    protected _overrideSubscription(name: string, func: any, funcKey: string): void;
+    protected getBusActionNames(): ComponentActionNamesType;
+}

package/esm/modern/core/utils/connectConfig.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Determines whether to query oneAccount API based on connect mode and merchant flag.
+ *
+ * In simpler connect mode (when onlyIntegrateCardElementConnectMerchantFlag is 'true'),
+ * the oneAccount API call should be skipped to avoid unnecessary network requests.
+ *
+ * @param isConnect - Whether connect mode is enabled
+ * @param extendInfo - JSON string containing merchant configuration flags
+ * @returns true if oneAccount API should be queried, false otherwise
+ */
+export declare function shouldQueryOneAccount(isConnect: boolean, extendInfo?: string): boolean;

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

@@ -0,0 +1,36 @@
+import { IoptionsParams, ProductSceneEnum } from '../../types';
+import { BizFlowStartBehavior, IElementStatus, PaymentContext, ProductProcessor, StartBizFlowOptions } from '../index';
+import { ServiceProvider } from '../service';
+/**
+ * @author 谦彧 <zhangmian.zm@alipay.com>
+ * @date 2024/9/17
+ */
+export declare class AntomSDKCore {
+    private bizFlowStartBehavior;
+    private initOptions;
+    private paymentContext;
+    private instanceId;
+    private sdkMetaData;
+    private productProcessors;
+    private enablePopWindowEventCallback;
+    private eventLogging;
+    private status;
+    private logger;
+    constructor();
+    getStatus(): IElementStatus;
+    setStatus(status: any): void;
+    updatePaymentSessionData(paymentSession: string): void;
+    registerProcessor(productScene: string, paymentMethod: string, processor: ProductProcessor): void;
+    init(options: IoptionsParams, productScene: ProductSceneEnum): void;
+    private prepare;
+    startBizFlow(options: StartBizFlowOptions): Promise<void>;
+    getServiceProvider(): ServiceProvider;
+    getBizFlowBehavior(): BizFlowStartBehavior;
+    getPaymentContext(): PaymentContext;
+    destroy(): void;
+    private handleBehaviorRender;
+    private handleRemain;
+    private handleClose;
+    private cleanRender;
+    getInstanceId(): string;
+}

package/esm/modern/foundation/index.d.ts

@@ -0,0 +1,93 @@
+import { DisplayTypeEnum, IMerchantAppointParam, IoptionsParams, IPaymentSessionMetaData, PlatformEnum, ProductSceneEnum, TargetEnum } from '../types';
+/**
+ * @author 谦彧 <zhangmian.zm@alipay.com>
+ * @date 2024/9/17
+ */
+/**
+ * Represent one transaction, each transaction has its own instance.
+ */
+export interface PaymentContext {
+    initOptions: IoptionsParams;
+    startBizFlowOptions: StartBizFlowOptions;
+    displayInfo: DisplayInfo;
+    paymentSession: string;
+    paymentSessionId: string;
+    paymentSessionObj: IPaymentSessionMetaData;
+    sdkMetaData: SDKMetaData;
+}
+export interface StartBizFlowOptions {
+    paymentSession: string;
+    displayInfo?: Partial<DisplayInfo>;
+    submitPayRequestExtra?: any;
+    isAppWebview?: boolean;
+    isNativeAppWebview?: boolean;
+}
+export declare class DisplayInfo {
+    type: DisplayTypeEnum;
+    platform: PlatformEnum;
+    isRetention: boolean;
+    selector: string;
+    appearance?: Record<string, any>;
+    appendAliasContainerId?: boolean;
+    merchantAppointParam?: IMerchantAppointParam;
+    iframeStyle?: Partial<CSSStyleDeclaration>;
+    notRedirectAfterComplete?: boolean;
+    constructor();
+}
+/**
+ * Provide unique logic for specified product, or specified product and its payment method.
+ * Such as: EasySafePay, PayPal in Cashier
+ */
+export interface ProductProcessor {
+    init(config: IoptionsParams, instanceId: string, sdkMetaData: SDKMetaData): any;
+    startBizFlow(paymentContext: PaymentContext): Promise<BizFlowStartBehavior>;
+}
+export interface BizFlowStartBehavior {
+    behaviorType: 'RENDER' | 'REDIRECT' | 'NONE';
+    payload: RenderBehaviorPayload | RedirectBehaviorPayload;
+    data?: any;
+}
+export interface RenderBehaviorPayload {
+    url: string;
+    allowClickPopupOutsideClose?: boolean;
+}
+export interface RedirectBehaviorPayload {
+    url?: string;
+    schemeUrl?: string;
+    applinkUrl?: string;
+    browserLinkTarget?: TargetEnum;
+    isCallApp?: boolean;
+    callAppDetectSuccessDelay?: number;
+    openInApp?: boolean;
+}
+/**
+ * Provide some capability, such as MonitorService, EventBusService, SecurityService
+ */
+export interface Service {
+    init(initOptions: IoptionsParams, instanceId: string, sdkMetaData: SDKMetaData): any;
+    update(paymentContext: PaymentContext): any;
+    destroy(): any;
+}
+export interface SDKMetaData {
+    productScene: ProductSceneEnum;
+    sdkVersion: string;
+    webAppVersion: string;
+    greyscaleId?: number;
+}
+export interface EventLogging {
+    enableLogging?: boolean;
+    eventName?: string;
+    eventAlias?: string;
+    userPath?: string;
+}
+export interface InitContext {
+    initOptions: IoptionsParams;
+    sdkMetaData: SDKMetaData;
+}
+export declare enum IElementStatus {
+    UNINIT = "UNINIT",
+    INITING = "INITING",
+    READY = "READY",
+    IN_BIZ_FLOW = "IN_BIZ_FLOW",
+    DESTROYED = "DESTROYED"
+}

package/esm/modern/foundation/product-processor/autoDebit/deps.d.ts

@@ -0,0 +1,14 @@
+export type { BizFlowStartBehavior, PaymentContext, ProductProcessor, RedirectBehaviorPayload, RenderBehaviorPayload, SDKMetaData, } from '../..';
+export { v2AppMarmotMap } from '../../../config';
+export { COMPONENT_CONTAINER_ID, COMPONENT_SECTION_ID, ERRORMESSAGE, EVENT, LOADTIME_LIMIT } from '../../../constant';
+export { getComponentSign } from '../../../core/component';
+export { ComponentSignEnum, eventCodeEnum, PlatformEnum } from '../../../types';
+export type { CashierSdkActionQueryRequest, IoptionsParams } from '../../../types';
+export { isPC, isTrue, queryParse } from '../../../util';
+export { isLocalMock } from '../../../util/mock';
+export { EventCenter } from '../..//service/event-center';
+export { ServiceProvider } from '../../service';
+export { LogService } from '../../service/log';
+export { RequesterService } from '../../service/requester/requester';
+export { SecurityService } from '../../service/security';
+export { getWebAppV2Url } from '../../utils/web_app_url_utils';

package/esm/modern/foundation/product-processor/autoDebit/index.d.ts

@@ -0,0 +1,48 @@
+import { BizFlowStartBehavior, IoptionsParams, PaymentContext, ProductProcessor, SDKMetaData } from './deps';
+export declare class AutoDebitProcessor implements ProductProcessor {
+    private paymentContext?;
+    private initConfig;
+    private logger;
+    private eventCenter;
+    private securityService;
+    private instanceId;
+    private componentSign;
+    private hostSign;
+    private _performanceData;
+    private SECURITY_SDK_INIT_TIMEOUT;
+    init(config: IoptionsParams, instanceId: string, sdkMetaData: SDKMetaData): void;
+    startBizFlow(paymentContext: PaymentContext): Promise<BizFlowStartBehavior>;
+    private acquireApdidToken;
+    /**
+     * 获取SDK操作查询请求
+     * @returns {Promise<CashierSdkActionQueryRequest | { message?: string; success: boolean }>} 返回SDK操作查询请求或错误信息
+     */
+    private getSdkActionQuery;
+    /**
+     * webLaunchPromise方法用于返回一个Promise对象，用于异步加载Web App
+     * @returns {Promise} 返回一个Promise对象
+     */
+    private webLaunchPromise;
+    private sendRequestAndWaitWebLaunch;
+    private buildRedirectResult;
+    /**
+     * 构建 Web App 的 URL
+     * @returns {string} Web App 的 URL
+     */
+    private buildWebAppUrl;
+    /**
+     * 初始化安全SDK
+     * @returns {Promise}
+     */
+    private initSecuritySDK;
+    /**
+     * 设置容器宽度
+     * 如果是 Trustly 支付方式，并且显示平台为桌面端，则设置组件区块和容器的最大宽度为 656px
+     */
+    private setAchAutoDebitContainerWidth;
+    /**
+     * 判断是否为Trustly支付方式
+     * @returns {boolean} true 表示是Trustly支付方式
+     */
+    private get isTrustly();
+}

package/esm/modern/foundation/product-processor/easysafepay/deps.d.ts

@@ -0,0 +1,20 @@
+export type { SDKMetaData } from "../..";
+export { v4 as uuid } from 'uuid';
+export type { BizFlowStartBehavior, PaymentContext, ProductProcessor, RedirectBehaviorPayload, RenderBehaviorPayload, } from '../..';
+export * as ChannelCustomize from '../../../component/channel';
+export type { IChannelBehavior } from '../../../component/channel';
+export { DisplayTypeEnum, PaymentMethodCategoryTypeEnum, ProductSceneEnum, RiskSdkInfoEnum } from '../../../types';
+export type { CashierSdkActionQueryRequest, CashierSdkActionQueryResult, CashierSdkActionQuerySessionResult, CashierSubmitPayRequest, CashierSubmitPayResult, IoptionsParams, } from '../../../types';
+export { isPC } from '../../../util';
+export { getBackScheme } from '../../utils/redirect_utils';
+export { isLocalMock } from '../../../util/mock';
+export { ServiceProvider } from '../../service';
+export type { ContainerService } from '../../service/container';
+export type { EventCenter } from '../../service/event-center';
+export { LogService } from '../../service/log';
+export type { RequesterService } from '../../service/requester/requester';
+export type { SecurityService } from '../../service/security';
+export { ProductInfoCacheUtil } from '../../utils/payment_product_utils';
+export * as WebAppUrlUtil from '../../utils/web_app_url_utils';
+export { eventCodeEnum } from '../../../types';
+export { EVENT } from '../../../constant';

package/esm/modern/foundation/product-processor/easysafepay/index.d.ts

@@ -0,0 +1,29 @@
+import { BizFlowStartBehavior, IoptionsParams, PaymentContext, ProductProcessor, SDKMetaData } from './deps';
+export declare class EasySafePayProcessor implements ProductProcessor {
+    private paymentContext?;
+    private initConfig;
+    private logger;
+    private securityService;
+    private eventCenter;
+    private instanceId;
+    private hostSign;
+    private allowQueryCall;
+    private allowSubmitPayCallAhead;
+    private channelBehavior?;
+    private SECURITY_SDK_INIT_TIMEOUT;
+    private SDK_REQUEST_TIMEOUT;
+    private LOAD_APP_RESOURCES_TIMEOUT;
+    init(config: IoptionsParams, instanceId: string, sdkMetaData: SDKMetaData): void;
+    startBizFlow(paymentContext: PaymentContext): Promise<BizFlowStartBehavior>;
+    private buildWebAppUrl;
+    private buildRedirectResult;
+    /**
+     * 等待Web应用启动，然后发送renderComponent事件
+     *  start waiting web launch, then send renderComponent event
+     * */
+    private sendRequestAndWaitWebLaunch;
+    private processQuery;
+    private processSubmitPay;
+    private acquireApdidToken;
+    private initSecuritySDK;
+}

package/esm/modern/foundation/product-processor/element/index.d.ts

@@ -0,0 +1,7 @@
+import { BizFlowStartBehavior, ProductProcessor } from "../..";
+declare class ElementProcessor implements ProductProcessor {
+    constructor();
+    init(config: any, instanceId: string): any;
+    startBizFlow(): Promise<BizFlowStartBehavior>;
+}
+export { ElementProcessor };

package/esm/modern/foundation/service/api-bus/ability/globalData.d.ts

@@ -0,0 +1,10 @@
+import { BusContext, BusMessage, BusSubscriber } from '../../../../foundation/service/api-bus/busManager';
+export declare class DataBusSubscriber extends BusSubscriber {
+    private instanceId;
+    constructor(instanceId: string);
+    actionNames(): string[];
+    protected getGlobalData(context: BusContext, message: BusMessage): void;
+    protected setGlobalData(context: BusContext, message: BusMessage): void;
+    protected clearGlobalData(context: BusContext, message: BusMessage): void;
+    onMessage(context: BusContext, message: BusMessage): void;
+}

package/esm/modern/foundation/service/api-bus/ability/request.d.ts

@@ -0,0 +1,10 @@
+import { BusContext, BusMessage, BusSubscriber } from "../../../../foundation/service/api-bus/busManager";
+export declare class RequestBusSubscriber extends BusSubscriber {
+    private instanceId;
+    constructor(instanceId: string);
+    actionNames(): string[];
+    protected request(context: BusContext, message: BusMessage): Promise<void>;
+    protected getEnvInfo(context: BusContext, message: BusMessage): Promise<void>;
+    protected getUserAgent(context: BusContext, message: BusMessage): void;
+    onMessage(context: BusContext, message: BusMessage): void;
+}

package/esm/modern/foundation/service/api-bus/ability/security.d.ts

@@ -0,0 +1,12 @@
+import { DeviceIdParameter } from "../../../../types";
+import { BusContext, BusMessage, BusSubscriber } from '../busManager';
+export type onDeviceIdCallback = (deviceIdParameter?: DeviceIdParameter, isPolling?: boolean) => Promise<string>;
+export declare class SecurityBusSubscriber extends BusSubscriber {
+    private instanceId;
+    constructor(instanceId: string);
+    actionNames(): string[];
+    protected preInitSecurity(context: BusContext, message: BusMessage): Promise<void>;
+    protected initSecurity(context: BusContext, message: BusMessage): Promise<void>;
+    protected getSecurityDeviceId(context: BusContext, message: BusMessage): Promise<void>;
+    onMessage(context: BusContext, message: BusMessage): void;
+}

package/esm/modern/foundation/service/api-bus/ability/tracker.d.ts

@@ -0,0 +1,9 @@
+import { BusContext, BusMessage, BusSubscriber } from '../busManager';
+export declare class TrackerBusSubscriber extends BusSubscriber {
+    private instanceId;
+    private logger;
+    constructor(instanceId: string);
+    actionNames(): string[];
+    protected reportAnalytics(context: BusContext, message: BusMessage): Promise<void>;
+    onMessage(context: BusContext, message: BusMessage): void;
+}

package/esm/modern/foundation/service/api-bus/busManager.d.ts

@@ -0,0 +1,127 @@
+/**
+ * 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 interceptors;
+    private static subscribersMap;
+    private static TAG;
+    private static _logSplit;
+    private isDebug;
+    private instanceId;
+    private logger;
+    constructor(instanceId?: string);
+    debugTrace(enable: boolean): void;
+    private traceLog;
+    private traceError;
+    private static getInstanceActionName;
+    clear(): void;
+    addInterceptor(interceptor: BusInterceptor): void;
+    publishForResult(message: BusMessage, config?: {
+        timeoutMs?: number;
+        fallback?: any;
+    }): Promise<BusMessage>;
+    publish(message: BusMessage, callback?: OnBusCallback): void;
+    subscribe(subscriber: BusSubscriber): void;
+    unsubscribe(subscriber: BusSubscriber): void;
+    isSubscribed(actionName: string): boolean;
+}

package/esm/modern/foundation/service/api-bus/index.d.ts

@@ -0,0 +1,20 @@
+import { Service } from '../../index';
+import { IoptionsParams } from '../../../types';
+import { LogService } from '../log';
+import { BusMessage, BusSubscriber, OnBusCallback } from './busManager';
+/**
+ * @author 谦彧 <zhangmian.zm@alipay.com>
+ * @date 2024/9/17
+ */
+export declare class ApiBusManagerService implements Service {
+    protected logger: LogService;
+    protected instanceId: string;
+    private busManager;
+    init(initOptions: IoptionsParams, instanceId: string): void;
+    subscribe(subscriber: BusSubscriber): void;
+    unsubscribe(subscriber: BusSubscriber): void;
+    isSubscribed(actionName: string): boolean;
+    publish(message: BusMessage, callback?: OnBusCallback): void;
+    update(): void;
+    destroy(): void;
+}

package/esm/modern/foundation/service/api-bus/interface.d.ts

@@ -0,0 +1,48 @@
+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 RequestActiontEnum {
+    request = "request",
+    getEnvInfo = "getEnvInfo",
+    getUserAgent = "getUserAgent"
+}
+export declare enum DataActiontEnum {
+    getGlobalData = "getGlobalData",
+    setGlobalData = "setGlobalData",
+    clearGlobalData = "clearGlobalData"
+}
+export declare enum SecuritySDKActionEnum {
+    preInitSecurity = "preInitSecurity",
+    initSecurity = "initSecurity",
+    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"
+}