@alipay/ams-checkout 0.0.1788166152-dev.1 → 0.0.1788166152-dev.2

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

@@ -1,24 +1,34 @@
-import { type BaseAppearance, type BaseElementAppConfig, BaseMainElement, type PickAppearance, type BaseElementConfig, type ErrorPayload } from '@antintl/opensdk-core';
-import { type AntomTheme, type AntomBridgeWithNativeEventMap, type SubmitResult, type AntomVariables, type SubmitParams, type AntomLayouts } from '../types';
-import type { CashierSdkActionQueryResult, OneAccountQueryResult, PaymentSessionConfig } from '../oneapi/iexpfront/definitions';
 import { type RequestOptions } from '@antintl/antom-toolset';
+import { type BaseElementAppConfig, type BaseElementConfig, BaseMainElement, type ErrorPayload } from '@antintl/opensdk-core';
+import type { CashierSdkActionQueryResult, OneAccountQueryResult, PaymentSessionConfig } from '../oneapi/iexpfront/definitions';
 import { type IPaymentSessionMetaData } from '../tools/getMetaData';
+import { type GetApplePayTokenReply, type GetApplePayTokenRequest } from '../tools/paymentElement/applePayHostToken';
+import { type GetGooglePayTokenReply, type GetGooglePayTokenRequest } from '../tools/paymentElement/googlePayHostToken';
+import { type AntomBridgeWithNativeEventMap, type AntomLayouts, type AntomTheme, type AntomVariables, type AppearanceVariables, type SubmitParams, type SubmitResult } from '../types';
+import { type AppearanceRuleSelector, type PickAntomAppearance } from './appearanceRules';
 /**
- * @description Payment element appearance type
+ * @description Payment element appearance properties
  */
-export type PaymentAppearance = PickAppearance<{
+export type PaymentAppearanceProps = {
     displaySetting: 'showPaymentMethodListWhenSingleOption' | 'showCardBrandIcon' | 'showRadioWhenAccordionLayout' | 'showCardCVV';
     theme: AntomTheme;
-    variables: AntomVariables;
+    variables: AppearanceVariables | AntomVariables;
     layout: AntomLayouts;
-}>;
+    rules: AppearanceRuleSelector<string>;
+};
+/**
+ * @description Payment element appearance type
+ */
+export type PaymentAppearance = PickAntomAppearance<PaymentAppearanceProps>;
 /**
  * @description Payment element app config type
  */
-export interface PaymentAppConfig extends BaseAppearance<PaymentAppearance>, BaseElementAppConfig {
+export interface PaymentAppConfig extends BaseElementAppConfig {
+    /** Payment appearance configuration including optional alias-only Rules. */
+    appearance?: PaymentAppearance;
     /**
-      * @description sessionData，无法通过updateConfig更新
-      */
+     * @description sessionData，无法通过updateConfig更新
+     */
     sessionData?: string;
     /**
      * @internal sdk所在hostname
@@ -133,6 +143,25 @@ export interface PaymentSubmitResult extends SubmitResult {
  * @description Payment element events
  */
 export interface PaymentElementEvents extends AntomBridgeWithNativeEventMap<PaymentAppConfig, PaymentSubmitParams, PaymentSubmitResult> {
+    /**
+     * webapp 委托 host(父 frame)拉起 Apple Pay 拿 token。
+     * payload 结构对齐 ModernElementController.GetApplePayTokenRequest(放 paymentMethod/shipping)。
+     */
+    'OPENSDK@GET_APPLE_PAY_TOKEN': GetApplePayTokenRequest;
+    /** host 完成 Apple Pay token 获取后回包给 webapp */
+    'OPENSDK@GET_APPLE_PAY_TOKEN_REPLY': GetApplePayTokenReply;
+    /**
+     * webapp 委托 host(父 frame)拉起 Google Pay 拿 token。
+     * payload 结构对齐 ModernElementController.GetGooglePayTokenRequest(放 data.environment/paymentRequest)。
+     */
+    'OPENSDK@GET_GOOGLE_PAY_TOKEN': GetGooglePayTokenRequest;
+    /** host 完成 Google Pay token 获取后回包给 webapp */
+    'OPENSDK@GET_GOOGLE_PAY_TOKEN_REPLY': GetGooglePayTokenReply;
+    /** WebApp notifies the host when the selected payment method changes. */
+    paymentMethodChanged: {
+        type: string;
+        name?: string;
+    };
 }
 /**
  * @description Payment element config type
@@ -145,19 +174,29 @@ interface PaymentElementConfig extends BaseElementConfig<PaymentAppConfig> {
 export declare class PaymentElement extends BaseMainElement<PaymentElementConfig, PaymentElementEvents> {
     static elementType: string;
     private _paymentInProgress;
+    private readonly paymentTracker;
+    private _mountStartedAt;
+    private _mountInProgress;
+    private _mountPhase;
+    private _destroyInProgress;
+    private readonly walletLogger;
     constructor(name: string, config: PaymentElementConfig);
     /**
      * @internal
      */
     setup(): Promise<Partial<PaymentAppConfig> | undefined>;
+    mount(container: HTMLElement): Promise<void>;
     /**
-     * @description Update payment element configuration with amount validation
+     * @description Update payment element configuration with amount validation and appearance Rules support
      */
-    updateConfig(newConfig: Pick<PaymentAppConfig, 'amount'>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
+    updateConfig(newConfig: Partial<PaymentAppConfig>): Promise<PaymentElementEvents['OPENSDK@UPDATE_CONFIG_REPLY']>;
     /**
      * @internal
      */
     submit(data?: PaymentSubmitParams): Promise<PaymentSubmitResult>;
+    on<T extends keyof PaymentElementEvents>(event: T, handler: (payload: PaymentElementEvents[T]) => void): void;
+    unmount(): void;
+    destroy(): void;
     protected focus(): void;
     protected blur(): void;
     protected clear(): void;

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

@@ -0,0 +1,59 @@
+import type { PickAppearance } from '@antintl/opensdk-core';
+/** Semantic states accepted by the merchant selector grammar. */
+type AppearanceRuleState = 'hover' | 'focus' | 'focus-visible' | 'active' | 'disabled' | 'loading' | 'selected' | 'checked' | 'expanded' | 'invalid' | 'success' | 'error';
+/** Controlled pseudo-class accepted by the merchant selector grammar. */
+type AppearanceRulePseudoClass = 'autofill';
+/** Controlled pseudo-element accepted by the merchant selector grammar. */
+type AppearanceRulePseudoElement = 'placeholder' | 'selection';
+/**
+ * Optional state or controlled pseudo suffix on one alias.
+ */
+export type AppearanceRuleScopeSuffix = '' | `:${AppearanceRuleState | AppearanceRulePseudoClass}` | `::${AppearanceRulePseudoElement}`;
+/** One merchant alias with an optional semantic suffix. */
+export type AppearanceRuleSelector<RuleAlias extends string> = `${RuleAlias}${AppearanceRuleScopeSuffix}`;
+/** Paint-only property names exposed by the SDK contract. */
+export type AppearancePaintProperty = 'color' | 'WebkitTextFillColor' | 'textDecorationColor' | 'textDecorationLine' | 'textDecorationStyle' | 'textShadow' | 'backgroundColor' | 'borderColor' | 'borderTopColor' | 'borderRightColor' | 'borderBottomColor' | 'borderLeftColor' | 'borderRadius' | 'borderTopLeftRadius' | 'borderTopRightRadius' | 'borderBottomRightRadius' | 'borderBottomLeftRadius' | 'borderStyle' | 'boxShadow' | 'fill' | 'stroke' | 'fillOpacity' | 'strokeOpacity' | 'strokeWidth' | 'outlineColor' | 'outlineStyle' | 'outlineWidth' | 'outlineOffset' | 'caretColor' | 'accentColor';
+/** Controlled layout longhands intersected with the concrete Part at runtime. */
+export type AppearanceLayoutProperty = 'marginTop' | 'marginRight' | 'marginBottom' | 'marginLeft' | 'paddingTop' | 'paddingRight' | 'paddingBottom' | 'paddingLeft' | 'height';
+/** Exact official spacing Token accepted by controlled margin and padding. */
+export type AppearanceSpacingToken = `var(--spacing-${'base' | 'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl'})`;
+/** Runtime-constrained non-negative integer pixel value for spacing longhands. */
+export type AppearanceSpacingValue = '0' | `${number}px` | AppearanceSpacingToken;
+/** Paint declarations accepted before WebApp and Components runtime validation. */
+type AppearancePaintDeclarations = Partial<Record<Exclude<AppearancePaintProperty, 'fillOpacity' | 'strokeOpacity' | 'strokeWidth' | 'textDecorationStyle' | 'outlineStyle'>, string> & Record<'fillOpacity' | 'strokeOpacity' | 'strokeWidth', string | number> & {
+    textDecorationStyle: '-moz-initial' | 'inherit' | 'initial' | 'revert' | 'revert-layer' | 'unset' | 'dashed' | 'dotted' | 'double' | 'solid' | 'wavy';
+    outlineStyle: '-moz-initial' | 'inherit' | 'initial' | 'revert' | 'revert-layer' | 'unset' | 'auto' | 'dashed' | 'dotted' | 'double' | 'groove' | 'inset' | 'none' | 'outset' | 'ridge' | 'solid';
+}>;
+/** Target-level layout declarations admitted before runtime capability intersection. */
+export type AppearanceLayoutDeclarations = {
+    [Property in Exclude<AppearanceLayoutProperty, 'height'>]?: AppearanceSpacingValue;
+} & {
+    /** Exact integer-pixel enum allocated by the target contract. */
+    readonly height?: `${number}px`;
+};
+/** Paint declarations plus controlled typography and target-level layout fields. */
+type AppearanceRuleDeclarations = AppearancePaintDeclarations & AppearanceLayoutDeclarations & {
+    /** Single font family identifier admitted only for authorized targets at runtime. */
+    readonly fontFamily?: string;
+    /** Integer pixel size admitted only for authorized text targets at runtime. */
+    readonly fontSize?: `${number}px`;
+    /** Controlled font weight admitted only for authorized text targets at runtime. */
+    readonly fontWeight?: 400 | 500 | 600 | 700;
+    /** Controlled font style admitted only for authorized text targets at runtime. */
+    readonly fontStyle?: 'normal' | 'italic';
+};
+/** Builds an Antom appearance type with the restricted Rules declaration contract. */
+export type PickAntomAppearance<T extends Record<string, any>> = PickAppearance<T, AppearanceRuleDeclarations>;
+type AppearanceRulesAppConfig = {
+    appearance?: {
+        rules?: unknown;
+    };
+};
+/**
+ * Resets stored Rules before the core deep merge handles an explicit empty patch.
+ *
+ * @param currentConfig - Current complete SDK configuration.
+ * @param update - Merchant configuration patch being merged.
+ */
+export declare function prepareAppearanceRulesUpdate(currentConfig: AppearanceRulesAppConfig, update: AppearanceRulesAppConfig): void;
+export {};

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

@@ -0,0 +1,2 @@
+/** Shared immutable snapshot used when an Element must send an explicit Rules clear. */
+export declare const EMPTY_APPEARANCE_RULES: Readonly<{}>;

package/esm/modern/modern/sdk/tools/expressElement/applePayHostToken.d.ts

@@ -4,13 +4,18 @@ interface HandleApplePayTokenAtHostOptions {
     requestId: string;
     renderData: unknown;
     appConfig?: ExpressAppConfig;
+    /** iframe 已转好的 major unit 金额（来自 resolvedAmount）；host 委托直接消费，不再做 minor→major 转换。 */
+    walletAmount?: {
+        value: string;
+        currency: string;
+    };
     sendReply: (payload: ApplePayTokenReply) => void;
 }
 /**
  * 非 Safari PC 路径：host 只负责在顶层 document 拉起 ApplePaySession 并取 token。
  * token 回到 express_element webapp 后，submit/2DS/3DS/polling 继续由 webapp 承接。
  */
-export declare function handleApplePayTokenAtHost({ requestId, renderData, appConfig, sendReply, }: HandleApplePayTokenAtHostOptions): Promise<void>;
+export declare function handleApplePayTokenAtHost({ requestId, renderData, appConfig, walletAmount, sendReply, }: HandleApplePayTokenAtHostOptions): Promise<void>;
 export declare function buildRecurringPaymentRequest(sessionData: string, merchantInfo: {
     countryCode?: string;
     merchantName?: string;

package/esm/modern/modern/sdk/tools/expressElement/types.d.ts

@@ -1,4 +1,5 @@
-import type { BaseAppearance, BaseElementAppConfig, BaseElementConfig, ErrorPayload } from '@antintl/opensdk-core';
+import type { BaseElementAppConfig, BaseElementConfig, ErrorPayload } from '@antintl/opensdk-core';
+import type { AppearanceRuleSelector, PickAntomAppearance } from '../../elements/appearanceRules';
 import type { AntomBridgeWithNativeEventMap, PreloadTelemetryContext } from '../../types';
 export declare const SUPPORTED_EXPRESS_METHODS: readonly ["paypal", "applePay", "googlePay", "alipay"];
 export type ExpressPaymentMethod = (typeof SUPPORTED_EXPRESS_METHODS)[number];
@@ -7,11 +8,17 @@ export type ExpressSetupError = ErrorPayload & {
     /** 服务端返回的 errorMessage 已完成国际化，可直接对客展示 */
     mulityLanguageMapping?: boolean;
 };
-export type AppearanceSetting = {
-    displaySetting: Record<'showCardBrandIcon', boolean>;
+/** Express element appearance properties. */
+export type ExpressAppearanceProps = {
+    displaySetting: 'showCardBrandIcon';
     theme: 'light' | 'dark';
     layout: 'accordion' | 'tabs';
+    rules: AppearanceRuleSelector<string>;
 };
+/** Express element appearance configuration. */
+type ExpressAppearance = PickAntomAppearance<ExpressAppearanceProps>;
+/** Backward-compatible name for the Express appearance configuration. */
+export type AppearanceSetting = ExpressAppearance;
 /**
  * @public
  * @description PayPal button style configuration
@@ -29,6 +36,7 @@ export interface PayPalConfig {
     channelMerchantAccountId?: string;
     /** Button style (fine-grained override) */
     style?: PayPalButtonStyle;
+    businessDivision?: string;
     /** Callback to create PayPal order, no params, returns sessionData */
     createOrder?: () => Promise<string>;
     /** Callback when user changes shipping address, data is raw data returned by PayPal */
@@ -104,20 +112,21 @@ export interface ExpressCancelEvent {
  * @public
  * @description Express element app config type
  */
-export interface ExpressAppConfig extends BaseAppearance<AppearanceSetting>, BaseElementAppConfig {
+export interface ExpressAppConfig extends BaseElementAppConfig {
+    /** Express appearance configuration. */
+    appearance?: ExpressAppearance;
     /** payment SessionData */
     sessionData?: string;
-    /** Business division (country/region) */
-    businessDivision?: string;
     /**
      * Amount & Currency
      *
-     * Only effective via `updateConfig({ amount })` at runtime.
-     * Passing amount at creation time is ignored; the initial amount
-     * comes from the server-side sdkQuery result (renderData.paymentAmount).
+     * For Apple Pay and Google Pay, `value` is a positive ASCII digit string in
+     * the payment session currency's minor unit; `currency` may be omitted.
+     * For example, USD 10.99 is passed as `{ value: '1099' }`.
+     * PayPal keeps its existing major-unit amount semantics and requires `currency`.
      */
     amount?: {
-        currency: string;
+        currency?: string;
         value: string;
     };
     /** PayPal 配置 */
@@ -237,6 +246,11 @@ export interface ExpressElementEvents extends AntomBridgeWithNativeEventMap<Expr
     'OPENSDK@GET_APPLE_PAY_TOKEN': {
         requestId: string;
         expressPaymentType: string;
+        /** iframe 已转好的 major unit 金额（来自 resolvedAmount）；host 委托 Apple Pay 消费，不再做 minor→major 转换。 */
+        walletAmount?: {
+            value: string;
+            currency: string;
+        };
     };
     /** host 完成 Apple Pay token 获取后回包给 iframe，submit/3DS/polling 均由 webapp 完成 */
     'OPENSDK@GET_APPLE_PAY_TOKEN_REPLY': {
@@ -260,3 +274,4 @@ export interface ExpressElementEvents extends AntomBridgeWithNativeEventMap<Expr
         needReset: boolean;
     };
 }
+export {};

package/esm/modern/modern/sdk/tools/getMetaData.d.ts

@@ -108,7 +108,14 @@ export declare const getMetaData: (sessionData: string) => IPaymentSessionMetaDa
  * Local debug switch used to force modernWeb in production during controlled rollout.
  */
 export declare const MODERN_WEB_STORAGE_KEY = "antom-web-checkout-v2_modern_web";
-export declare const isModernWeb: (sessionData: string | undefined) => {
+/**
+ * Resolves whether a session enables the selected modern Web flow.
+ *
+ * @param sessionData Opaque payment session data parsed by `getMetaData`.
+ * @param key Exact, case-sensitive `flowSwitchTags` entry to match.
+ * @returns The resolved modern-flow state and the non-production frontend source when present.
+ */
+export declare const isModernWeb: (sessionData: string | undefined, key?: string) => {
     fromFrontend?: boolean;
     modernWeb: boolean;
 };

package/esm/modern/modern/sdk/tools/modalMessageMonitor.d.ts

@@ -0,0 +1,41 @@
+interface ModalMessageReport {
+    stage: string;
+    modalId: string;
+    scope: string;
+    origin: string;
+    elapsedMs: number;
+    modalState: string;
+    modalStyle: string;
+    iframePath: string;
+    visibilityState: string;
+    layerState: string;
+    sourceState: string;
+    sourceFrameIndex: number;
+    modalCount: number;
+    overlayCount: number;
+}
+/** Maps a modal lifecycle snapshot to the shared tracker field schema. */
+export declare const getModalMessageTrackData: (data: ModalMessageReport) => {
+    d1: string;
+    d2: string;
+    d3: string;
+    d4: string;
+    d5: string;
+    d6: string;
+    d7: string;
+    d8: string;
+    d9: string;
+    d10: string;
+    d11: string;
+    m1: number;
+    m2: number;
+    m3: number;
+};
+/**
+ * Installs a passive host-window monitor for the modal bridge lifecycle.
+ * @param report Receives sanitized lifecycle snapshots.
+ * @param acceptOpen Restricts which OPEN_MODAL source starts this monitor.
+ * @returns A function that removes the listener and pending timers.
+ */
+export declare function installModalMessageMonitor(report: (data: ModalMessageReport) => void, acceptOpen?: (event: MessageEvent) => boolean): () => void;
+export {};

package/esm/modern/modern/sdk/tools/paymentElement/applePayHostToken.d.ts

@@ -0,0 +1,38 @@
+import { Logger } from "../../../../util/logger";
+import type { PaymentHostTracker } from './tracker';
+/** webapp 传来的 OPENSDK@GET_APPLE_PAY_TOKEN payload 形态。 */
+export interface GetApplePayTokenRequest {
+    paymentMethod?: {
+        paymentMethodDetail?: {
+            applePayProps?: {
+                paymentRequest?: unknown;
+            };
+        };
+    };
+    shipping?: unknown;
+}
+/** host 回传 webapp 的 OPENSDK@GET_APPLE_PAY_TOKEN_REPLY 形态(result 对齐老链路 {token,billingContact,shippingContact})。 */
+export interface GetApplePayTokenReply {
+    success: boolean;
+    result?: {
+        token?: unknown;
+        billingContact?: unknown;
+        shippingContact?: unknown;
+    } | {
+        errorCode: string;
+    };
+}
+interface HandleApplePayTokenAtHostOptions {
+    sessionData: string;
+    env: string;
+    payload: unknown;
+    logger: Logger;
+    tracker: PaymentHostTracker;
+    sendReply: (reply: GetApplePayTokenReply) => void;
+}
+/**
+ * host 端拉起 Apple Pay sheet 拿 token,拿到后通过 sendReply 回传给 webapp。
+ * 失败/取消也通过 sendReply 回传,webapp 侧自行决定是否走 doSubmit。
+ */
+export declare function handleApplePayTokenAtHost({ sessionData, env, payload, logger, tracker, sendReply, }: HandleApplePayTokenAtHostOptions): Promise<void>;
+export {};

package/esm/modern/modern/sdk/tools/paymentElement/googlePayHostToken.d.ts

@@ -0,0 +1,38 @@
+import type { PaymentHostTracker } from './tracker';
+/** webapp 传来的 OPENSDK@GET_GOOGLE_PAY_TOKEN payload 形态。 */
+export interface GetGooglePayTokenRequest {
+    actionName?: string;
+    data?: {
+        environment?: string;
+        paymentRequest?: unknown;
+        paymentMethod?: unknown;
+        paymentMethodDetail?: {
+            googlePayProps?: {
+                environment?: string;
+                paymentRequest?: unknown;
+            };
+        };
+        [key: string]: unknown;
+    };
+}
+/** host 回传 webapp 的 OPENSDK@GET_GOOGLE_PAY_TOKEN_REPLY 形态。 */
+export interface GetGooglePayTokenReply {
+    success: boolean;
+    result?: unknown;
+    err?: {
+        statusCode?: string;
+        [key: string]: unknown;
+    };
+}
+type SendReply = (reply: GetGooglePayTokenReply) => void;
+interface HandleGooglePayTokenAtHostOptions {
+    payload: unknown;
+    tracker: PaymentHostTracker;
+    sendReply: SendReply;
+}
+/**
+ * host 端拉起 Google Pay 拿 token,通过 sendReply 回传给 webapp。
+ * 动态加载 GP SDK(若未加载)→ PaymentsClient.isReadyToPay → loadPaymentData。
+ */
+export declare function handleGooglePayTokenAtHost({ payload, tracker, sendReply }: HandleGooglePayTokenAtHostOptions): void;
+export {};

package/esm/modern/modern/sdk/tools/paymentElement/tracker.d.ts

@@ -0,0 +1,16 @@
+import { type ApiError, type ApiOutput, type ApiReport, type AsyncApiRunOptions, type ElementTracker, type ElementTrackerEnrichment, type SyncApiRunOptions } from '../../tracking/elementTracker';
+export { normalizeElementEventName } from '../../tracking/elementTracker';
+export type { ApiOutcome } from '../../tracking/elementTracker';
+export type PaymentTrackerEnrichment = ElementTrackerEnrichment;
+export type PaymentApiReport = ApiReport;
+export type PaymentApiOutput = ApiOutput;
+export type PaymentApiError = ApiError;
+export type PaymentAsyncApiRunOptions<T> = AsyncApiRunOptions<T>;
+export type PaymentSyncApiRunOptions<T> = SyncApiRunOptions<T>;
+export type PaymentHostTracker = ElementTracker;
+interface CreatePaymentHostTrackerOptions {
+    env?: string;
+    locale?: string;
+    elementInstanceId?: string;
+}
+export declare function createPaymentHostTracker(sessionData?: string, options?: CreatePaymentHostTrackerOptions): PaymentHostTracker;

package/esm/modern/modern/sdk/tools/paymentElement/walletHostListeners.d.ts

@@ -0,0 +1,19 @@
+import { Logger } from "../../../../util/logger";
+import { type PaymentHostTracker } from './tracker';
+/** BaseMainElement 的 on/send 收发接口(避免耦合具体 element 类)。 */
+export interface WalletHostBridge {
+    on: (event: string, handler: (payload: unknown) => void) => void;
+    send: (event: string, payload: unknown) => void;
+}
+interface RegisterWalletHostListenersOptions {
+    bridge: WalletHostBridge;
+    sessionData: string | undefined;
+    env: string;
+    logger: Logger;
+    tracker?: PaymentHostTracker;
+}
+/**
+ * 注册 GP/AP host 监听。在 element setup() 内调用一次,生命周期与 element 一致。
+ */
+export declare function registerWalletHostListeners({ bridge, sessionData, env, logger, tracker, }: RegisterWalletHostListenersOptions): void;
+export {};

package/esm/modern/modern/sdk/tracking/elementTracker.d.ts

@@ -0,0 +1,65 @@
+import { sdkTracker } from '@antintl/opensdk-core';
+import type { CashierSdkActionQueryResult } from '../oneapi/iexpfront/definitions';
+import { type IPaymentSessionMetaData } from '../tools/getMetaData';
+export type ApiOutcome = 'success' | 'fail' | 'cancelled' | 'processing' | 'error' | 'unknown';
+export declare const normalizeElementEventName: (event: PropertyKey) => string;
+export interface ElementTrackerEnrichment {
+    metaData?: IPaymentSessionMetaData;
+    renderData?: CashierSdkActionQueryResult;
+    locale?: string;
+}
+export interface ApiReport {
+    outcome: ApiOutcome;
+    durationMs: number;
+    errorCode?: string;
+    traceId?: string;
+}
+export interface ApiOutput {
+    outcome: ApiOutcome;
+    errorCode?: string;
+    traceId?: string;
+    fields?: Record<string, unknown>;
+}
+export interface ApiError {
+    code: string;
+    source: string;
+    traceId: string;
+}
+interface ApiRunOptions<T> {
+    msg: string;
+    inputFields?: () => Record<string, unknown>;
+    outputFields?: (result: T) => ApiOutput;
+    errorFields?: (error: ApiError) => Record<string, unknown>;
+}
+export interface AsyncApiRunOptions<T> extends ApiRunOptions<T> {
+    action: () => Promise<T>;
+}
+export interface SyncApiRunOptions<T> extends ApiRunOptions<T> {
+    action: () => T;
+}
+export interface ElementTracker {
+    readonly merchantId: string;
+    readonly productScene: string;
+    readonly productSceneVersion: string;
+    readonly paymentMethodCategoryType: string;
+    readonly paymentMethodType: string;
+    readonly trackId: string;
+    readonly requestTracker: typeof sdkTracker;
+    enrich: (data: ElementTrackerEnrichment) => void;
+    setPaymentMethodType: (paymentMethodType?: string) => void;
+    trackMount: (msg: string, extra?: Record<string, unknown>) => void;
+    trackHandshake: (msg: string, extra?: Record<string, unknown>) => void;
+    trackElement: (msg: string, extra?: Record<string, unknown>) => void;
+    trackApi: (msg: string, report: ApiReport, extra?: Record<string, unknown>) => void;
+    trackError: (msg: string, extra?: Record<string, unknown>) => void;
+    runAsyncApi: <T>(options: AsyncApiRunOptions<T>) => Promise<T>;
+    runSyncApi: <T>(options: SyncApiRunOptions<T>) => T;
+}
+export interface CreateElementTrackerOptions {
+    elementType: string;
+    env?: string;
+    locale?: string;
+    elementInstanceId?: string;
+}
+export declare function createElementTracker(sessionData: string | undefined, options: CreateElementTrackerOptions): ElementTracker;
+export {};