@paydock/client-sdk 1.104.9-beta → 1.105.56-beta

package/bundles/index.cjs.d.ts

@@ -1,3 +1,6 @@
+import { Observable, Subscriber } from 'rxjs';
+import { MicroAgent } from '@newrelic/browser-agent/loaders/micro-agent';
+
 declare class ApiCharge {
     protected api: Api;
     constructor(api: Api);
@@ -54,6 +57,57 @@ declare class Env implements IEnvironment {
     private isValidMode;
 }
 
+type HttpRequestMethod = 'DELETE' | 'GET' | 'OPTIONS' | 'POST' | 'PUT';
+
+type AgentPrototype = Pick<(typeof MicroAgent)['prototype'], 'addPageAction' | 'noticeError'>;
+type AgentMethodNames = keyof AgentPrototype;
+type AgentMethodParameters<T extends AgentMethodNames> = Parameters<AgentPrototype[T]>;
+declare class InstrumentationAgent extends MicroAgent {
+    private static agent;
+    private static available;
+    private static initialized;
+    private constructor();
+    static get instance(): InstrumentationAgent;
+    isAvailable(): boolean;
+    call: <T extends "addPageAction" | "noticeError">(method: T, ...args: AgentMethodParameters<T>) => void;
+}
+
+interface CustomEventDTO {
+    environment: string;
+    appId?: never;
+    timestamp?: never;
+    [x: string]: unknown;
+}
+interface ReportBaseContext {
+    environment: string;
+    sdkVersion: string | null;
+    description?: string;
+    [x: string]: SerializableValue | undefined;
+}
+type SerializableValue = string | number | symbol | object | null;
+
+type ReportErrorFn = (repository: ErrorRepository, error: string | Error, ctx: ReportBaseContext & ({
+    className: string;
+    classMethod: string;
+    functionName?: never;
+} | {
+    className?: never;
+    classMethod?: never;
+    functionName: string;
+})) => void;
+declare class ErrorRepository {
+    private readonly agent;
+    constructor();
+    createError(...args: Parameters<InstrumentationAgent['noticeError']>): Promise<void>;
+}
+
+type ReportEventFn = (repository: EventRepository, actionName: string, ctx: ReportBaseContext & CustomEventDTO) => void;
+declare class EventRepository {
+    private readonly agent;
+    constructor();
+    createEvent(...args: Parameters<InstrumentationAgent['addPageAction']>): Promise<void>;
+}
+
 declare enum API_AUTH_TYPE {
     PUBLIC_KEY = 0,
     TOKEN = 1
@@ -62,6 +116,7 @@ declare class ApiBase {
     protected env: Env;
     auth: string;
     authType: API_AUTH_TYPE;
+    private stoppedPooling;
     constructor(auth: string, authType?: API_AUTH_TYPE);
     /**
      * Current method can change environment. By default environment = sandbox.
@@ -73,12 +128,15 @@ declare class ApiBase {
      * @param {string} [alias] - Own domain alias
      */
     setEnv(env: string, alias?: string): ApiBase;
+    longPollingObservable<Req extends object, Res>(method: 'GET' | 'POST', url: string, requestBody: Req, sessionId: string, reconnectInterval?: number): Observable<Res>;
+    longPull(subscriber: Subscriber<any>, method: any, link: any, auth: any, requestBody: any, sessionId: any, reconnectInterval: any): void;
+    destroyLongPolling(): void;
     setAuthType(): API_AUTH_TYPE;
-    getClient(method: 'GET' | 'POST', link: string): {
+    getClient(method: Extract<HttpRequestMethod, 'GET' | 'POST'>, link: string): {
         config: XMLHttpRequest;
-        send: (body: any, cb?: (data: any) => void, errorCb?: (data: any) => void) => void;
+        send: (body: any, cb?: (data) => void, errorCb?: (data: any) => any) => void;
     };
-    getClientPromise<Req extends object, Res>(method: 'GET' | 'POST', link: string): {
+    getClientPromise<Req extends object, Res>(method: Extract<HttpRequestMethod, 'GET' | 'POST'>, link: string): {
         config: XMLHttpRequest;
         send: (body: Req) => Promise<Res>;
     };
@@ -90,7 +148,14 @@ declare class ApiBase {
         text: string;
         status: number;
     }): Promise<Res>;
-    setAuthHeader(request: XMLHttpRequest): void;
+    reportEvent: ReportEventFn;
+    reportError: ReportErrorFn;
+    protected newApiRequest(method: Extract<HttpRequestMethod, 'GET' | 'POST'>, link: string): XMLHttpRequest;
+    protected get ctx(): {
+        sdkVersion: string;
+        className: string;
+        environment: string;
+    };
 }
 
 interface BrowserDetails {
@@ -560,6 +625,7 @@ interface IWalletMeta {
     refresh_token?: string;
     style?: WalletStyles;
     wallets?: WALLET_TYPE[];
+    client_id?: string;
 }
 
 declare class Link {
@@ -605,6 +671,8 @@ declare class IFrame {
     isExist(): boolean;
     getElement(): HTMLIFrameElement;
     setStyle(property: string, value: string): void;
+    setIframeHeight(iframeElement: HTMLIFrameElement, iFrameDocument: Document, selector: string): void;
+    private setStyles;
 }
 
 /**
@@ -628,7 +696,7 @@ interface IEventData$1 {
     data?: any;
     ref_id?: string;
 }
-declare const EVENT: {
+declare const EVENT$1: {
     AFTER_LOAD: string;
     SUBMIT: string;
     FINISH: string;
@@ -641,6 +709,8 @@ declare const EVENT: {
     CHECKOUT_COMPLETED: string;
     CHECKOUT_POPUP_OPEN: string;
     CHECKOUT_POPUP_CLOSE: string;
+    RECOGNITION_TOKEN_REQUESTED: string;
+    RECOGNITION_TOKEN_DROPPED: string;
     VALIDATION: string;
     SELECT: string;
     UNSELECT: string;
@@ -834,6 +904,7 @@ declare class Configuration {
 declare class EventEmitter {
     private events;
     emit<T>(eventName: string, data?: T): void;
+    emitWithResult<T, R>(eventName: string, data?: T): Promise<R[]>;
     subscribe<T>(eventName: string, handler: (data: T) => void): () => void;
 }
 
@@ -1092,13 +1163,18 @@ interface IRunner {
     setEnv(env: string, alias?: string): void;
 }
 
+interface IDispatcherData {
+    message_source: string;
+    event: string;
+}
+
 interface IContextualRunner extends IRunner {
     run(): void;
     isRunning(): boolean;
     continue(): void;
     stop(): void;
     onStop(cb: () => void): void;
-    onCheckout(event: string, cb: (checkout: ICheckout) => void): void;
+    onCheckout<T extends IDispatcherData>(event: string, cb: (checkout: ICheckout, data?: T) => void): void;
     setBackgroundTitle(text: string): void;
     setBackgroundDescription(text: string): void;
     turnOffBackdrop(): void;
@@ -1703,6 +1779,7 @@ interface IClickToPayMeta extends IBaseSRCMeta {
     };
     customer?: Customer;
     unaccepted_card_type?: 'CREDIT' | 'DEBIT';
+    recognition_token?: string;
 }
 type MASTERCARD_DPA_SHIPPING_BILLING_PREFERENCE = 'FULL' | 'POSTAL_COUNTRY' | 'NONE';
 type MASTERCARD_ORDER_TYPE = 'SPLIT_SHIPMENT' | 'PREFERRED_CARD';
@@ -1747,6 +1824,7 @@ interface WalletCaptureBody {
             address_country?: string;
             external_payer_id?: string;
             ref_token?: string;
+            wallet_express?: boolean;
         };
     };
 }
@@ -1811,6 +1889,17 @@ interface ProcessAuthenticationResponse {
     };
 }
 
+declare class ApiGatewayInternal {
+    protected api: ApiInternal;
+    constructor(api: ApiInternal);
+    getWalletConfig(gateway_id: string): Promise<GetWalletConfigResponse>;
+}
+interface GetWalletConfigResponse {
+    type: string;
+    mode: string;
+    credentials?: object;
+}
+
 declare class ApiServiceInternal {
     protected api: ApiInternal;
     constructor(api: ApiInternal);
@@ -1825,9 +1914,19 @@ interface GetConfigResponse {
     certificate_passphrase: string;
 }
 
+declare class ApiCheckoutInternal {
+    protected api: ApiInternal;
+    constructor(api: ApiInternal);
+    instructions(session_id: string): Observable<object>;
+    callback(payload: Object): Promise<Object>;
+    status(id: string): Promise<Object>;
+}
+
 declare class ApiInternal extends ApiBase {
     charge(): ApiChargeInternal;
     service(): ApiServiceInternal;
+    checkout(): ApiCheckoutInternal;
+    gateway(): ApiGatewayInternal;
 }
 
 interface SRCProvider {
@@ -2057,51 +2156,6 @@ declare class VaultDisplayWidget {
     load(): void;
 }
 
-interface IWalletPaymentSuccessful {
-    id: string;
-    amount: number;
-    currency: string;
-    status: string;
-    payer_name?: string;
-    payer_email?: string;
-    payer_phone?: string;
-}
-interface IWalletUnavailable {
-    wallet?: WALLET_TYPE;
-}
-interface IWalletOnClick {
-    attachResult: (result: Promise<void> | boolean) => void;
-}
-interface IWalletUpdate {
-    wallet_response_code?: string;
-    wallet_order_id?: string;
-    wallet_session_id?: string;
-    payment_source?: {
-        wallet_payment_method_id?: string;
-        card_number_last4?: string;
-        card_scheme?: string;
-    };
-    wallet_loyalty_account?: {
-        id?: string;
-        barcode?: string;
-    };
-    shipping?: {
-        address_line1?: string;
-        address_line2?: string;
-        address_postcode?: string;
-        address_city?: string;
-        address_state?: string;
-        address_country?: string;
-        address_company?: string;
-        post_office_box_number?: string;
-        wallet_address_id?: string;
-        wallet_address_name?: string;
-        wallet_address_created_timestamp?: string;
-        wallet_address_updated_timestamp?: string;
-    };
-    selected_shipping_option?: IShippingOption;
-}
-
 interface IWalletServiceUpdateData {
     amount: number;
     shipping_options?: IShippingOption[];
@@ -2171,6 +2225,51 @@ interface IWalletService {
     on(eventName: string, cb?: (data: IUnavailableWalletEventBody | IPaymentMethodSelectedWalletEventBody | any) => void): any;
 }
 
+interface IWalletPaymentSuccessful {
+    id: string;
+    amount: number;
+    currency: string;
+    status: string;
+    payer_name?: string;
+    payer_email?: string;
+    payer_phone?: string;
+}
+interface IWalletUnavailable {
+    wallet?: WALLET_TYPE;
+}
+interface IWalletOnClick {
+    attachResult: (result: Promise<void> | boolean) => void;
+}
+interface IWalletUpdate {
+    wallet_response_code?: string;
+    wallet_order_id?: string;
+    wallet_session_id?: string;
+    payment_source?: {
+        wallet_payment_method_id?: string;
+        card_number_last4?: string;
+        card_scheme?: string;
+    };
+    wallet_loyalty_account?: {
+        id?: string;
+        barcode?: string;
+    };
+    shipping?: {
+        address_line1?: string;
+        address_line2?: string;
+        address_postcode?: string;
+        address_city?: string;
+        address_state?: string;
+        address_country?: string;
+        address_company?: string;
+        post_office_box_number?: string;
+        wallet_address_id?: string;
+        wallet_address_name?: string;
+        wallet_address_created_timestamp?: string;
+        wallet_address_updated_timestamp?: string;
+    };
+    selected_shipping_option?: IShippingOption;
+}
+
 interface IEventData {
     event: string;
     data: void | IWalletPaymentSuccessful | IWalletUpdate | IWalletUnavailable | IWalletOnClick | any;
@@ -2784,6 +2883,7 @@ interface IEventMetaData extends IEventData$1 {
 }
 interface IEventFinishData extends IEventData$1 {
     payment_source: string;
+    payment_source_token?: string;
 }
 /**
  * Interface of data from validation event.
@@ -3203,4 +3303,719 @@ declare class HtmlWidget extends HtmlMultiWidget {
     setGiftCardScheme(giftCardScheme: any, processingNetwork: any): void;
 }
 
-export { AfterpayCheckoutButton, Api, CHECKOUT_BUTTON_EVENT, Canvas3ds, ClickToPay, Configuration, ELEMENT, EVENT, Builder$1 as ExternalCheckoutBuilder, Checker as ExternalCheckoutChecker, FORM_FIELD, HtmlMultiWidget, HtmlPaymentSourceWidget, HtmlWidget, type ICheckout, type IDetails, type IElementStyleInput, type IEventCheckoutFinishData, type IPayPalMeta, type IStyles$1 as IStyles, type ITexts, MultiWidget, PAYMENT_TYPE, PURPOSE, Builder as PaymentSourceBuilder, PaymentSourceWidget, PaypalCheckoutButton, STYLABLE_ELEMENT, STYLABLE_ELEMENT_STATE, STYLE, SUPPORTED_CARD_TYPES, TEXT, TRIGGER, TYPE, VAULT_DISPLAY_STYLE, type VaultDisplayStyle, VaultDisplayWidget, WalletButtons, ZipmoneyCheckoutButton };
+type Instruction = new (selector: string, formSelector: string, api: ApiInternal) => InstructionHandler & InstructionDestroyable & InstructionDecorated;
+interface InstructionHandleable {
+    handle(payload: object, eventEmitter: EventEmitter): void;
+}
+interface InstructionDecorated {
+    instruction: string;
+}
+interface InstructionDestroyable {
+    destroy(): void;
+}
+declare abstract class InstructionHandler implements InstructionHandleable, InstructionDestroyable, InstructionDecorated {
+    selector: string;
+    formSelector: string;
+    api: ApiInternal;
+    constructor(selector: string, formSelector: string, api: ApiInternal);
+    instruction: string;
+    abstract handle(context: object, eventEmitter?: any): void;
+    abstract destroy(): void;
+    getEnv(instruction_token: string): string;
+}
+
+declare class InstructionModule {
+    instructions: any[];
+    getInstruction(id: string): Instruction | null;
+}
+
+interface IntentTokenPayload {
+    env: string;
+    intent_id: string;
+    version: number;
+    env_alias: string;
+}
+declare class InstructionDebugger {
+    constructor(selector: string, formSelector: string, version: number, instructionName: string, context: object, token?: string);
+}
+/**
+ * Class CheckoutButton transform usual button into checkout
+ *
+ * @constructor
+ *
+ * @param {string} selector - Selector of html element.
+ * @param {string} intentToken - PayDock intent token
+ * @example
+ * var widget = new Checkout('#widget', 'intent_token');
+ **/
+declare class Checkout {
+    protected formSelector: string;
+    protected intentToken: string;
+    protected debug: boolean;
+    protected window: Window;
+    protected eventEmitter: EventEmitter;
+    protected container: Container;
+    protected intentTokenPayload: IntentTokenPayload;
+    protected api: ApiInternal;
+    protected instructions: InstructionModule;
+    protected currentInstruction: InstructionDestroyable & InstructionHandleable;
+    constructor(formSelector: string, intentToken: string, debug?: boolean);
+    private extractIntentTokenPayload;
+    private ready;
+    private initContractVersion;
+    private listenInstructions;
+    private setEnv;
+    private createWidgetStructure;
+    /**
+     * If the payment was successful, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * widget.onPaymentSuccessful((data) => {
+     *      console.log('Payment successful!');
+     * });
+     */
+    onPaymentSuccessful(handler: (data: IEventData$1) => void): () => void;
+    /**
+     * If the payment was not successful, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * widget.onPaymentError((err) => {
+     *      console.log('Payment not successful');
+     * });
+     */
+    onPaymentFailure(handler: (data: IEventData$1) => void): () => void;
+    /**
+     * If the payment was expired, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * widget.onPaymentInReview((data) => {
+     *      console.log('Payment in fraud review');
+     * });
+     */
+    onPaymentExpired(handler: (data: IEventData$1) => void): () => void;
+    private setStyles;
+}
+
+declare enum EVENT {
+    UNAVAILABLE = "unavailable",
+    ERROR = "error",
+    PAYMENT_SUCCESSFUL = "paymentSuccessful",
+    PAYMENT_ERROR = "paymentError",
+    PAYMENT_IN_REVIEW = "paymentInReview",
+    ON_CLICK = "onClick",
+    ON_CHECKOUT_CLOSE = "onCheckoutClose"
+}
+
+interface BaseEventData<T> {
+    event: string;
+    chargeId?: string;
+    data?: T | undefined;
+}
+
+interface OnClickEventData extends BaseEventData<undefined> {
+    event: EVENT.ON_CLICK;
+}
+
+interface OnPaymentSuccessfulEventData extends BaseEventData<{
+    id: string;
+    amount: number;
+    currency: string;
+    status: string;
+}> {
+    event: EVENT.PAYMENT_SUCCESSFUL;
+}
+
+interface OnCloseEventData extends BaseEventData<undefined> {
+    event: EVENT.ON_CHECKOUT_CLOSE;
+}
+
+interface OnPaymentInReviewEventData extends Omit<OnPaymentSuccessfulEventData, 'event'> {
+    event: EVENT.PAYMENT_IN_REVIEW;
+}
+
+interface OnPaymentErrorEventData extends BaseEventData<{
+    message?: string;
+    code?: string;
+}> {
+    event: EVENT.PAYMENT_ERROR;
+}
+
+interface WalletCaptureRequest {
+    payment_method_id?: string;
+    customer: {
+        email?: string;
+        phone?: string;
+        first_name?: string;
+        last_name?: string;
+        payment_source?: {
+            wallet_type?: string;
+            address_line1?: string;
+            address_line2?: string;
+            address_country?: string;
+            address_city?: string;
+            address_postcode?: string;
+            address_state?: string;
+            ref_token?: string;
+            external_payer_id?: string;
+            wallet_express?: boolean;
+        };
+    };
+}
+
+interface OnUnavailableEventData extends BaseEventData<undefined> {
+    event: EVENT.UNAVAILABLE;
+}
+
+interface BaseGatewayConfig<T> {
+    type: string;
+    mode: string;
+    credentials?: T;
+}
+
+interface BaseWalletMeta {
+    amount: number;
+    currency: string;
+}
+
+interface OnErrorEventData extends BaseEventData<Error> {
+    event: EVENT.ERROR;
+}
+
+declare abstract class BaseWalletButton<T extends BaseWalletMeta> {
+    protected container: Container;
+    protected api: ApiInternal;
+    protected env: string;
+    protected gatewayId: string;
+    protected meta: T;
+    private eventEmitter;
+    private chargeWalletTokenMeta?;
+    constructor(selector: string, publicKeyOrAccessToken: string, gatewayId: string, meta: T, requiredMetaFields: string[]);
+    private getApiAuthType;
+    /**
+     * Current method can change environment. By default environment = sandbox.
+     * Also we can change domain alias for this environment. By default domain_alias = paydock.com
+     * Bear in mind that you must set an environment before calling `button.load()`.
+     *
+     * @example
+     * button.setEnv('production', 'paydock.com');
+     * @param {string} env - sandbox, production
+     * @param {string} [alias] - Own domain alias
+     */
+    setEnv(env: string, alias?: string): void;
+    /**
+     * Callback for onClick method.
+     *
+     * @callback OnClickCallback
+     * @param {OnClickEventData} data
+     * @return {Promise<string>} walletToken string result
+     */
+    /**
+     * Registers a callback function to be invoked when the wallet button gets clicked.
+     * **Note:** is mandatory to handle this event to perform the wallet initialization (and optionally any validation logic).
+     * The event handler needs to return the wallet token string in order for the Wallet charge processing to proceed, or throw an error in case of failure or validation errors.
+     * **Note:** this callback may be called multiple times as the customer closes the payment checkout and re-clicks the button.
+     * It's the merchant's responsibility to handle this situation and evaluate in each case if generating a new WalletCharge Token is required or the previous one can be used in each case, depending on order data and updates.
+     * In case a new one needs to be generated, remember it will need to be preceded by a `setMeta` call.
+     *
+     * @example
+     * button.onClick(async (data) => {
+     *      const responseData = await fetch('https://your-server.com/init-wallet-charge');
+     *      return responseData.walletToken;
+     * });
+     *
+     * @param {OnClickCallback} handler - Function to be called when the wallet button is clicked.
+     */
+    onClick(handler: (data: OnClickEventData) => Promise<string>): () => void;
+    /**
+     * Callback for onPaymentSuccessful method.
+     *
+     * @callback OnPaymentSuccessfulCallback
+     * @param {OnPaymentSuccessfulEventData} data
+     */
+    /**
+     * If the payment was successful, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * button.onPaymentSuccessful((data) => {
+     *      console.log('Payment successful!');
+     * });
+     *
+     * @example
+     * button.onPaymentSuccessful().then((data) => console.log('Payment successful!'));
+     *
+     * @param {OnPaymentSuccessfulCallback} [handler] - Function to be called when the payment was successful.
+     */
+    onPaymentSuccessful(handler?: (data: OnPaymentSuccessfulEventData) => void): Promise<unknown> | (() => void);
+    /**
+     * Callback for onPaymentInReview method.
+     *
+     * @callback OnPaymentInReviewCallback
+     * @param {OnPaymentInReviewEventData} data
+     */
+    /**
+     * If the payment was left in fraud review, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * button.onPaymentInReview((data) => {
+     *      console.log('Payment in fraud review');
+     * });
+     *
+     * @example
+     * button.onPaymentInReview().then((data) => console.log('Payment in fraud review'));
+     *
+     * @param {OnPaymentInReviewCallback} [handler] - Function to be called when the payment was left in fraud review status.
+     */
+    onPaymentInReview(handler?: (err: OnPaymentInReviewEventData) => void): Promise<unknown> | (() => void);
+    /**
+     * Callback for onPaymentError method.
+     *
+     * @callback OnPaymentErrorCallback
+     * @param {OnPaymentErrorEventData} data
+     */
+    /**
+     * If the payment was not successful, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * button.onPaymentError((err) => {
+     *      console.log('Payment not successful');
+     * });
+     *
+     * @example
+     * button.onPaymentError().then((err) => console.log('Payment not successful'));
+     *
+     * @param {OnPaymentErrorCallback} [handler] - Function to be called when the payment was not successful.
+     */
+    onPaymentError(handler?: (err: OnPaymentErrorEventData) => void): Promise<unknown> | (() => void);
+    /**
+     * Callback for onCheckoutClose method.
+     *
+     * @callback OnCheckoutCloseCallback
+     * @param {OnCloseEventData} data
+     */
+    /**
+     * Registers a callback function to be invoked when the wallet checkout closes.
+     *
+     * @example
+     * button.onCheckoutClose(() => {
+     *      console.log('Wallet checkout closes');
+     * });
+     *
+     * @param {OnCheckoutCloseCallback} handler - Function to be called when the wallet checkout closes.
+     */
+    onCheckoutClose(handler?: (err: OnCloseEventData) => void): Promise<unknown> | (() => void);
+    /**
+     * Callback for onUnavailable method.
+     *
+     * @callback OnUnavailableCallback
+     * @param {OnUnavailableEventData} data
+     */
+    /**
+     * Registers a callback function to be invoked when the wallet is not available in the current context.
+     *
+     * @example
+     * button.onUnavailable(() => {
+     *      console.log('Wallet not available');
+     * });
+     *
+     * @param {OnUnavailableCallback} handler - Function to be called when the wallet is not available in the current context.
+     */
+    onUnavailable(handler?: (err: OnUnavailableEventData) => void): Promise<unknown> | (() => void);
+    /**
+     * Callback for onError method.
+     *
+     * @callback OnErrorCallback
+     * @param {OnErrorEventData} data
+     */
+    /**
+     * Registers a callback function to be invoked when an error that is not related to payment execution occurs.
+     * For example, if the amount of the wallet token injected via the `onClick` event handler does not match the amount provided via the initial `meta` or `setMeta` method.
+     *
+     * @example
+     * button.onError((error) => {
+     *      console.log('WalletButtonExpress error', error);
+     * });
+     *
+     * @param {OnErrorCallback} handler - Function to be called when the WalletButton has an error.
+     */
+    onError(handler?: (err: OnErrorEventData) => void): Promise<unknown> | (() => void);
+    /**
+     * Add docs on each child class
+     */
+    abstract load(): void;
+    /**
+     * Add docs on each child class
+     */
+    abstract setMeta(meta: object): void;
+    protected getGatewayWalletConfig<T>(): Promise<BaseGatewayConfig<T>>;
+    protected executeWalletCallback<T, U extends {
+        request_type: string;
+    }>(data: U): Promise<T>;
+    protected executeWalletCapture<T>(data: WalletCaptureRequest): Promise<T>;
+    protected handleMerchantOnExpressButtonClickEvent(): Promise<void>;
+    private setWalletToken;
+    protected handleCheckoutClose(): void;
+    protected handleOnUnavailable(): void;
+    protected handleOnError(error?: Error): void;
+    protected eventDataFromApiError(err: any): OnPaymentErrorEventData['data'];
+    protected validateRequiredMetaFields(requiredMetaFields: string[]): void;
+}
+
+type ApplePayButtonStyle = 'black' | 'white' | 'white-outline';
+
+type ApplePayButtonType = 'add-money' | 'book' | 'buy' | 'check-out' | 'continue' | 'contribute' | 'donate' | 'order' | 'pay' | 'plain' | 'reload' | 'rent' | 'set-up' | 'subscribe' | 'support' | 'tip' | 'top-up';
+
+interface ApplePayWalletMeta extends BaseWalletMeta {
+    amount_label: string;
+    country: string;
+    merchant_capabilities?: Array<'supports3DS' | 'supportsEMV' | 'supportsCredit' | 'supportsDebit'>;
+    supported_networks?: Array<'visa' | 'masterCard' | 'amex' | 'chinaUnionPay' | 'discover' | 'interac' | 'jcb' | 'privateLabel'>;
+    required_billing_contact_fields?: Array<'email' | 'name' | 'phone' | 'postalAddress'>;
+    required_shipping_contact_fields?: Array<'email' | 'phone'>;
+    supported_countries?: string[];
+    style?: {
+        button_type?: ApplePayButtonType;
+        button_style?: ApplePayButtonStyle;
+    };
+}
+
+/**
+ * Class ApplePayWalletButtonExpress to work with Apple Pay Wallet.
+ *
+ * @extends BaseWalletButton
+ *
+ * @constructor
+ *
+ * @example
+ * var button = new ApplePayWalletButtonExpress('#wallet-buttons', 'publicKeyOrAccessToken', 'gatewayId', meta);
+ *
+ * @param {string} selector - Selector of html element. Container for the ApplePayWalletButtonExpress.
+ * @param {string} publicKeyOrAccessToken - Public key or Access token for the ApplePayWalletButtonExpress.
+ * @param {string} gatewayId - Gateway ID for the ApplePayWalletButtonExpress.
+ * @param {ApplePayWalletMeta} meta - data that configures the Apple Pay Wallet.
+ */
+declare class ApplePayWalletButtonExpress extends BaseWalletButton<ApplePayWalletMeta> {
+    private paymentSession;
+    /** @constructs */ constructor(selector: string, publicKeyOrAccessToken: string, gatewayId: string, meta: ApplePayWalletMeta);
+    /**
+     * Initializes the availability checks and inserts the button if possible.
+     * Otherwise function onUnavailable(handler: VoidFunction) will be called.
+     * **Important**: Is required to invoke this method to render the wallet button.
+     *
+     * @example
+     *  button.load();
+     */
+    load(): void;
+    /**
+     * Call this method if updating the originally-provided meta object after order information changed.
+     * For example, if the order amount has changed from the time where the button was originally rendered.
+     *
+     * @example
+     * button.setMeta(meta);
+     *
+     * @param {ApplePayWalletMeta} meta - // data that configures the Apple Pay Wallet.
+     */
+    setMeta(meta: ApplePayWalletMeta): void;
+    private checkAvailability;
+    private mount;
+    private onApplePayButtonClicked;
+    private createRequest;
+    private onValidateMerchant;
+    private getMerchantSession;
+    private onPaymentAuthorized;
+    private onCancelPayment;
+}
+
+interface PaypalWalletMeta extends BaseWalletMeta {
+    pay_later?: boolean;
+    standalone?: boolean;
+    capture?: boolean;
+    style?: {
+        layout?: 'vertical' | 'horizontal';
+        color?: 'gold' | 'blue' | 'silver' | 'black' | 'white';
+        shape?: 'rect' | 'pill' | 'sharp';
+        borderRadius?: number;
+        height?: number;
+        disableMaxWidth?: boolean;
+        label?: 'paypal' | 'checkout' | 'buynow' | 'pay' | 'installment';
+        tagline?: boolean;
+        messages?: {
+            layout?: 'text' | 'flex';
+            logo?: {
+                type?: 'primary' | 'alternative' | 'inline' | 'none';
+                position?: 'left' | 'right' | 'top';
+            };
+            text?: {
+                color?: 'black' | 'white' | 'monochrome' | 'grayscale';
+                size?: 10 | 11 | 12 | 13 | 14 | 15 | 16;
+                align?: 'left' | 'center' | 'right';
+            };
+            color?: 'blue' | 'black' | 'white' | 'white-no-border' | 'gray' | 'monochrome' | 'grayscale';
+            ratio?: '1x1' | '1x4' | '8x1' | '20x1';
+        };
+    };
+}
+
+/**
+ * Class PaypalWalletButtonExpress to work with Paypal Wallet.
+ *
+ * @extends BaseWalletButton
+ *
+ * @constructor
+ *
+ * @example
+ * var button = new PaypalWalletButtonExpress('#wallet-buttons', 'publicKeyOrAccessToken', 'gatewayId', meta);
+ *
+ * @param {string} selector - Selector of html element. Container for the PaypalWalletButtonExpress.
+ * @param {string} publicKeyOrAccessToken - Public key or Access token for the PaypalWalletButtonExpress.
+ * @param {string} gatewayId - Gateway ID for the PaypalWalletButtonExpress.
+ * @param {PaypalWalletMeta} meta - data that configures the Paypal Wallet.
+ */
+declare class PaypalWalletButtonExpress extends BaseWalletButton<PaypalWalletMeta> {
+    private config;
+    protected paypal: any;
+    protected pendingApprovalPromise?: Promise<any>;
+    /** @constructs */ constructor(selector: string, publicKeyOrAccessToken: string, gatewayId: string, meta: PaypalWalletMeta);
+    /**
+     * Initializes the availability checks and inserts the button if possible.
+     * Otherwise function onUnavailable(handler: VoidFunction) will be called.
+     * **Important**: Is required to invoke this method to render the wallet button.
+     *
+     * @example
+     *  button.load();
+     */
+    load(): void;
+    /**
+     * Call this method if updating the originally-provided meta object after order information changed.
+     * For example, if the order amount has changed from the time where the button was originally rendered.
+     *
+     * @example
+     * button.setMeta(meta);
+     * @param {PaypalWalletMeta} meta - // data that configures the Paypal Wallet.
+     */
+    setMeta(meta: PaypalWalletMeta): void;
+    private renderPaypalButton;
+    private renderPaypalCommonComponent;
+    private renderPaypalStandaloneComponent;
+    private paypalSharedProps;
+}
+
+declare enum ErrorCodes$1 {
+    PROMISE_NOT_ENABLED = "promise_not_enabled",
+    SCRIPT_ERROR = "script_error"
+}
+interface PayPalDataCollectorConfig {
+    mouse_movement?: boolean;
+}
+interface IPayPalDataCollector {
+    collectDeviceData(): Promise<CollectedDeviceData>;
+    setEnv(env: string): void;
+}
+interface CollectedDeviceData {
+    correlation_id: string;
+}
+interface IOnErrorEventData$1 {
+    error_code: ErrorCodes$1;
+}
+
+/**
+ * PayPal Data Collector Widget constructor
+ *
+ * @param {string} flowId - This string identifies the source website of the FraudNet request.
+ * @param {PayPalDataCollectorConfig} config - Extra configuration for the widget.
+ *
+ * @example
+ * var payPalDataCollector = new PayPalDataCollector('FLOW_ID', {});
+ */
+declare class PayPalDataCollector {
+    protected service: IPayPalDataCollector;
+    protected eventEmitter: EventEmitter;
+    private widgetActionLogger;
+    /** @constructs */ constructor(flowId?: string, config?: PayPalDataCollectorConfig);
+    /**
+     * After configuring the PayPalDataCollector Widget, starts the process and returns
+     * the correlation id used among the requests.
+     *
+     * @returns {Promise<CollectedDeviceData>} Promise when resolved, returnsa an object
+     * that contains the `correlation_id` key.
+     *
+     * @example
+     * const collectedDeviceData = await payPalDataCollectorWidget.collectDeviceData();
+     * console.log(collectedDeviceData.correlation_id)
+     */
+    collectDeviceData(): Promise<CollectedDeviceData>;
+    /**
+     * Callback for onError method.
+     *
+     * @callback OnErrorCallback
+     * @param {IOnErrorEventData|null} data
+     */
+    /**
+     * If the process fails, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * PayPalDataCollector.onError((eventData) => console.log('Some error occur'));
+     *
+     * @param {OnErrorCallback} [callback] - Function to be called when there is an error in the flow.
+     */
+    onError(callback?: (data?: IOnErrorEventData$1) => void): () => void;
+    /**
+     * Current method can change environment. By default environment = test.
+     * This method does not affect Paydock's API calls or environments, is only for PayPal Data Collector
+     * script, in order to know if the script is injected on a live server or is a testing
+     * environment. The available values are `test` and `live`. This should match with the used
+     * `gateway.mode` in Paydock to process the transaction.
+     *
+     * @example
+     * PayPalDataCollector.setEnv('live');
+     * @param {string} env - test, live
+     */
+    setEnv(env: string): void;
+}
+
+interface PayPalStyleConfig {
+    layout?: 'vertical' | 'horizontal';
+    color?: 'blue' | 'gold' | 'silver' | 'black' | 'white';
+    shape?: 'rect' | 'sharp' | 'pill';
+    label?: 'paypal' | 'checkout' | 'buynow' | 'pay';
+    disableMaxWidth?: boolean;
+    disableMaxHeight?: boolean;
+    height?: number;
+    borderRadius?: number;
+    tagline?: boolean;
+}
+interface PayPalMessageConfig {
+    amount?: number;
+    align?: 'center' | 'left' | 'right';
+    color?: 'black' | 'white';
+    position?: 'top' | 'bottom';
+}
+interface PayPalSavePaymentSourceWidgetConfig {
+    style?: PayPalStyleConfig;
+    message?: PayPalMessageConfig;
+}
+interface IPayPalSavePaymentSourceWidget {
+    load(container: Container): void;
+    setEnv(env: string, alias?: string): void;
+}
+declare enum ErrorCodes {
+    UNAVAILABLE = "unavailable",
+    ON_PAYPAL_VAULT_SETUP_TOKEN_ERROR = "onPaypalVaultSetupTokenError",
+    ON_GET_ID_TOKEN_ERROR = "onGetIdTokenError",
+    ON_GET_WALLET_CONFIG_ERROR = "onGetWalletConfigError",
+    ON_GET_SETUP_TOKEN_ERROR = "onGetSetupTokenError",
+    ON_ONE_TIME_TOKEN_ERROR = "onOneTimeTokenError"
+}
+declare enum EVENTS {
+    ON_SUCCESS = "ON_SUCCESS",
+    ON_ERROR = "ON_ERROR",
+    ON_CANCEL = "ON_CANCEL"
+}
+interface IOnSuccessEventData {
+    event: EVENTS.ON_SUCCESS;
+    data: {
+        token: string;
+        email: string;
+    };
+}
+interface IOnErrorEventData {
+    event: EVENTS.ON_ERROR;
+    data: {
+        error_code: ErrorCodes;
+        details?: string;
+        message?: string;
+    };
+}
+interface IOnCancelEventData {
+    event: EVENTS.ON_CANCEL;
+}
+
+/**
+ * PayPal Save Payment Source Widget constructor
+ *
+ * @param {string} selector - Selector of html element. Container for PayPal Save Payment Source Widget.
+ * @param {string} publicKey - PayDock users public key.
+ * @param {string} gatewayId - PayDock's PayPal gatewayId.
+ * @param {PayPalSavePaymentSourceWidgetConfig} config - Extra configuration for the widget, like styles.
+ *
+ * @example
+ * var payPalSavePaymentSourceWidget = new PayPalSavePaymentSourceWidget('#paypalButton', 'public_key', 'gateway_id');
+ */
+declare class PayPalSavePaymentSourceWidget {
+    protected container: Container;
+    protected service: IPayPalSavePaymentSourceWidget;
+    protected eventEmitter: EventEmitter;
+    private widgetActionLogger;
+    /** @constructs */ constructor(selector: string, publicKey: string, gatewayId: string, config?: PayPalSavePaymentSourceWidgetConfig);
+    /**
+     * The final method after configuring the PayPalSavePaymentSource Widget to
+     * start the load process.
+     */
+    load(): void;
+    /**
+     * Current method can change environment. By default environment = sandbox.
+     * Also we can change domain alias for this environment. By default domain_alias = paydock.com
+     *
+     * @example
+     * payPalSavePaymentSourceWidget.setEnv('production');
+     * @param {string} env - sandbox, production
+     * @param {string} [alias] - Own domain alias
+     */
+    setEnv(env: string, alias?: string): void;
+    /**
+     * Callback for onSuccess method.
+     *
+     * @callback OnSuccessCallback
+     * @param {IOnSuccessEventData} data
+     */
+    /**
+     * If the setup token was successfully approved and a OTT was generated, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * payPalSavePaymentSourceWidget.onSuccess((eventData) => console.log('One time token and email obtained successfully'));
+     *
+     * @param {OnSuccessCallback} [callback] - Function to be called when the result is successful.
+     */
+    onSuccess(callback?: (data: IOnSuccessEventData) => void): () => void;
+    /**
+     * Callback for onError method.
+     *
+     * @callback OnErrorCallback
+     * @param {IOnErrorEventData} data
+     */
+    /**
+     * If in the process for obtaining the setup token fails, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * payPalSavePaymentSourceWidget.onError((eventData) => console.log('Some error occurred'));
+     *
+     * @param {OnErrorCallback} [callback] - Function to be called when there is an error in the flow.
+     */
+    onError(callback?: (data: IOnErrorEventData) => void): () => void;
+    /**
+     * Callback for onCancel method.
+     *
+     * @callback OnCancelCallback
+     * @param {IOnCancelEventData} data
+     */
+    /**
+     * If in the process for obtaining the setup token was cancelled, the function passed as parameter will be called.
+     * Important: Do not perform thread blocking operations in callback such as window.alert() calls.
+     *
+     * @example
+     * payPalSavePaymentSourceWidget.onCancel(() => console.log('Operation cancelled'));
+     *
+     * @param {OnCancelCallback} [callback] - Function to be called when the operation is cancelled.
+     */
+    onCancel(callback?: (data?: IOnCancelEventData) => void): () => void;
+}
+
+export { AfterpayCheckoutButton, Api, ApplePayWalletButtonExpress, CHECKOUT_BUTTON_EVENT, Canvas3ds, Checkout, ClickToPay, Configuration, ELEMENT, EVENT$1 as EVENT, Builder$1 as ExternalCheckoutBuilder, Checker as ExternalCheckoutChecker, FORM_FIELD, HtmlMultiWidget, HtmlPaymentSourceWidget, HtmlWidget, type ICheckout, type IDetails, type IElementStyleInput, type IEventCheckoutFinishData, type IPayPalMeta, type IStyles$1 as IStyles, type ITexts, InstructionDebugger, MultiWidget, PAYMENT_TYPE, PURPOSE, PayPalDataCollector, PayPalSavePaymentSourceWidget, Builder as PaymentSourceBuilder, PaymentSourceWidget, PaypalCheckoutButton, PaypalWalletButtonExpress, STYLABLE_ELEMENT, STYLABLE_ELEMENT_STATE, STYLE, SUPPORTED_CARD_TYPES, TEXT, TRIGGER, TYPE, VAULT_DISPLAY_STYLE, type VaultDisplayStyle, VaultDisplayWidget, WalletButtons, ZipmoneyCheckoutButton };