@fat-zebra/sdk 1.4.15 → 1.5.1

package/dist/main.d.ts

@@ -1,7 +1,7 @@
 import { Customer, PaymentIntent, PaymentMethod, PublicEvent } from './shared/types';
 import { HppLoadParams } from './hpp';
-import { PayPalConfig } from './paypal/types';
 import { ChallengeWindowSize } from './sca/types';
+import { HppClickToPayParams } from './click_to_pay/types';
 export interface FZConfig {
     username: string;
     test?: boolean;
@@ -31,8 +31,10 @@ export default class FatZebra {
     cardDidTokenize(headless: HTMLIFrameElement, callback: (data: any) => void): void;
     verifyCard(params: VerifyCardParams): Promise<void>;
     renderPaymentsPage(params: HppLoadParams): void;
+    renderClickToPay(params: HppClickToPayParams): void;
     checkout(): void;
-    setupPayPal(config: PayPalConfig): void;
     on(event: PublicEvent, callback: (e: any) => void): void;
+    off(event: PublicEvent, callback: (e: any) => void): void;
+    onOnce(event: PublicEvent, callback: (e: any) => void): void;
 }
 export { type HppLoadParams, FatZebra, };

package/dist/main.js

@@ -11,12 +11,12 @@ import Sca from './sca';
 import { PostMessageClient, } from './shared/post-message-client';
 import { BridgeEvent, PaymentMethodType, PublicEvent, } from './shared/types';
 import { LocalStorageAccessTokenKey } from './shared/constants';
-import { emit, on } from './shared/event-manager';
+import { emit, on, off, onOnce } from './shared/event-manager';
 import * as bridge from './shared/bridge-client';
-import { validateHppLoadParams, validateVerifyCardParams, toHumanizedErrors, } from './validation';
+import { validateHppLoadParams, validateVerifyCardParams, toHumanizedErrors, validateClickToPayLoadParams, } from './validation';
 import GatewayClient from './shared/api-gateway-client';
 import { Hpp } from './hpp';
-import { PayPalCheckout } from './paypal/paypal-checkout';
+import ClickToPay from './click_to_pay';
 export default class FatZebra {
     constructor(config) {
         this.fzConfig = config;
@@ -120,29 +120,33 @@ export default class FatZebra {
         });
         window.HPP.load(params);
     }
-    checkout() {
-        window.HPP.purchase();
-    }
-    setupPayPal(config) {
-        const paypalCheckout = new PayPalCheckout({
-            currency: config.currency,
-            payment: config.payment,
-            containerId: config.containerId,
-            style: config.style
-        });
-        paypalCheckout.load()
-            .then(function () {
-            paypalCheckout.render();
-        })
-            .catch(function (error) {
-            emit(PublicEvent.PAYPAL_ERROR, {
-                errors: [error].flat(),
+    renderClickToPay(params) {
+        const valid = validateClickToPayLoadParams(params);
+        if (!valid) {
+            emit(PublicEvent.VALIDATION_ERROR, {
+                errors: toHumanizedErrors(validateClickToPayLoadParams.errors),
                 data: null
             });
+            return;
+        }
+        window.HPP = new ClickToPay({
+            paymentIntent: params.paymentIntent,
+            username: this.fzConfig.username,
+            test: this.fzConfig.test,
         });
+        window.HPP.load(params);
+    }
+    checkout() {
+        window.HPP.purchase();
     }
     on(event, callback) {
         on(event, callback);
     }
+    off(event, callback) {
+        off(event, callback);
+    }
+    onOnce(event, callback) {
+        onOnce(event, callback);
+    }
 }
 export { FatZebra, };

package/dist/react/VerifyCard.d.ts

@@ -5,5 +5,5 @@ type FrameProps = {
     config: FatZebra.PaymentConfig;
     iframeProps?: HTMLProps<HTMLIFrameElement>;
 };
-declare const Frame: ({ handlers, config, iframeProps }: FrameProps) => React.JSX.Element;
-export default Frame;
+declare const VerifyCard: ({ handlers, config, iframeProps }: FrameProps) => React.JSX.Element;
+export default VerifyCard;

package/dist/react/VerifyCard.js

@@ -1,11 +1,11 @@
 import React from "react";
 import useFatZebra from "./useFatZebra";
-const Frame = ({ handlers, config, iframeProps }) => {
-    const { url } = useFatZebra({
+const VerifyCard = ({ handlers, config, iframeProps }) => {
+    const { paymentUrl } = useFatZebra({
         config,
         handlers: handlers,
     });
     return (React.createElement("div", null,
-        React.createElement("iframe", Object.assign({ src: url, title: "verification-form" }, iframeProps))));
+        React.createElement("iframe", Object.assign({ src: paymentUrl, "data-test-id": "verify-card", title: "verification-form" }, iframeProps))));
 };
-export default Frame;
+export default VerifyCard;

package/dist/react/VerifyExistingCard.d.ts

@@ -0,0 +1,10 @@
+import React, { HTMLProps } from "react";
+import * as FatZebra from "../shared/types";
+type FrameProps = {
+    handlers: FatZebra.Handlers;
+    config: FatZebra.PaymentConfig;
+    iframeProps?: HTMLProps<HTMLIFrameElement>;
+    cardToken: string;
+};
+declare const VerifyExistingCard: ({ handlers, cardToken, config, iframeProps }: FrameProps) => React.JSX.Element;
+export default VerifyExistingCard;

package/dist/react/VerifyExistingCard.js

@@ -0,0 +1,12 @@
+import React from "react";
+import useFatZebra from "./useFatZebra";
+const VerifyExistingCard = ({ handlers, cardToken, config, iframeProps }) => {
+    const { verifyUrl } = useFatZebra({
+        config,
+        cardToken,
+        handlers: handlers,
+    });
+    return (React.createElement("div", null,
+        React.createElement("iframe", Object.assign({ src: verifyUrl, "data-test-id": "verify-existing-card", title: "verification-form" }, iframeProps))));
+};
+export default VerifyExistingCard;

package/dist/react/index.d.ts

@@ -1,3 +1,4 @@
 import VerifyCard from "./VerifyCard";
+import VerifyExistingCard from "./VerifyExistingCard";
 import submitForm from "./submitForm";
-export { VerifyCard, submitForm };
+export { VerifyCard, VerifyExistingCard, submitForm };

package/dist/react/index.js

@@ -1,3 +1,4 @@
 import VerifyCard from "./VerifyCard";
+import VerifyExistingCard from "./VerifyExistingCard";
 import submitForm from "./submitForm";
-export { VerifyCard, submitForm };
+export { VerifyCard, VerifyExistingCard, submitForm };

package/dist/react/paymentUrl.d.ts

@@ -0,0 +1,12 @@
+import { Environment } from "../shared/env";
+import { OptionalUrlValues } from '../shared/types';
+type RequiredURLValues = {
+    merchant: string;
+    hash: string;
+    reference: string;
+    amount: number;
+    currency: string;
+};
+type UrlValues = RequiredURLValues & OptionalUrlValues;
+declare const generatePaymentURL: (values: UrlValues, environment?: Environment) => string;
+export { generatePaymentURL };

package/dist/react/paymentUrl.js

@@ -0,0 +1,33 @@
+import { parseTemplate } from 'url-template';
+import env, { Environment } from "../shared/env";
+const generatePaymentURL = (values, environment) => {
+    const queryParts = [
+        "tokenize_only",
+        "css",
+        "css_signature",
+        "iframe",
+        "postmessage",
+        "hide_card_holder",
+        "hide_button",
+        "sca_enabled",
+    ];
+    const environmentConfig = env[environment || Environment.sandbox];
+    const urlTemplate = parseTemplate(`${environmentConfig.payNowUrl}/sdk/v3/{merchant}/{reference}/{currency}/{amount}/{verification}{?${queryParts.join(",")}}`);
+    const url = urlTemplate.expand({
+        merchant: values.merchant,
+        reference: values.reference,
+        currency: values.currency,
+        amount: values.amount,
+        verification: values.hash,
+        sca_enabled: values.sca_enabled,
+        css: values.css,
+        css_signature: values.css_signature,
+        iframe: true,
+        postmessage: true,
+        tokenize_only: values.tokenize_only,
+        hide_card_holder: values.hide_card_holder,
+        hide_button: values.hide_button,
+    });
+    return url;
+};
+export { generatePaymentURL };

package/dist/react/useFatZebra.d.ts

@@ -2,8 +2,10 @@ import * as FatZebra from "../shared/types";
 type UseFatZebraProps = {
     handlers: FatZebra.Handlers;
     config: FatZebra.PaymentConfig;
+    cardToken?: string;
 };
-declare const useFatZebra: ({ config, handlers }: UseFatZebraProps) => {
-    url: string;
+declare const useFatZebra: ({ config, handlers, cardToken }: UseFatZebraProps) => {
+    paymentUrl: string;
+    verifyUrl: string;
 };
 export default useFatZebra;

package/dist/react/useFatZebra.js

@@ -1,9 +1,10 @@
 import { useEffect, useMemo } from "react";
 import * as FatZebra from "../shared/types";
-import { generatePaymentURL } from "./url";
+import { generatePaymentURL } from "./paymentUrl";
 import Sca from "../sca";
 import GatewayClient from "../shared/api-gateway-client";
-const useFatZebra = ({ config, handlers }) => {
+import { generateVerifyURL } from "./verifyUrl";
+const useFatZebra = ({ config, handlers, cardToken }) => {
     const { options, accessToken, paymentIntent, username } = config;
     const sca = useMemo(() => {
         const gatewayClient = new GatewayClient({ accessToken, username, environment: config.environment });
@@ -68,9 +69,10 @@ const useFatZebra = ({ config, handlers }) => {
         return () => {
             window.removeEventListener("message", messageHandler);
         };
-    }, []);
+    }, [paymentIntent]);
     const payment = paymentIntent.payment;
-    const url = generatePaymentURL(Object.assign({ merchant: username, reference: payment.reference, amount: payment.amount, currency: payment.currency, hash: paymentIntent.verification }, options), config.environment);
-    return { url };
+    const verifyUrl = generateVerifyURL(Object.assign({ token: cardToken, verification: paymentIntent.verification, merchant: username }, options), config.environment);
+    const paymentUrl = generatePaymentURL(Object.assign({ merchant: username, reference: payment.reference, amount: payment.amount, currency: payment.currency, hash: paymentIntent.verification }, options), config.environment);
+    return { paymentUrl, verifyUrl };
 };
 export default useFatZebra;

package/dist/react/verifyUrl.d.ts

@@ -0,0 +1,8 @@
+import { Environment } from "../shared/env";
+type RequiredURLValues = {
+    token: string;
+    verification: string;
+    merchant: string;
+};
+declare const generateVerifyURL: (values: RequiredURLValues, environment?: Environment) => string;
+export { generateVerifyURL };

package/dist/react/verifyUrl.js

@@ -0,0 +1,22 @@
+import { parseTemplate } from 'url-template';
+import env, { Environment } from "../shared/env";
+const generateVerifyURL = (values, environment) => {
+    const queryParts = [
+        "hide_button",
+        "iframe",
+        "verification",
+        "username",
+        "cardToken"
+    ];
+    const environmentConfig = env[environment || Environment.sandbox];
+    const urlTemplate = parseTemplate(`${environmentConfig.payNowUrl}/sdk/v3/verify{?${queryParts.join(",")}}`);
+    const url = urlTemplate.expand({
+        cardToken: values.token,
+        verification: values.verification,
+        username: values.merchant,
+        iframe: true,
+        hide_button: true
+    });
+    return url;
+};
+export { generateVerifyURL };

package/dist/sca/cardinal.d.ts

@@ -1,10 +1,3 @@
-interface CardinalConfig {
-    timeout?: number;
-    maxRequestRetries?: number;
-    logging?: {
-        level: 'on' | 'off' | 'verbose';
-    };
-}
 interface CardinalSetupCompleteResponseData {
     sessionId: string;
     modules: {
@@ -16,12 +9,20 @@ interface PaymentValidatedDTO {
     processorTransactionId: string;
     jwt: string;
 }
+export declare const defaultConfig: {
+    timeout: number;
+    maxRequestRetries: number;
+    logging: {
+        level: string;
+    };
+};
 export default class CardinalManager {
-    private cardinal;
-    constructor(config?: CardinalConfig);
+    private retries;
+    constructor(retries?: Array<number>);
+    configure(retryCount?: number, lastError?: string): Promise<any>;
     setup(jwt: any): void;
     onPaymentValidated(handler: (data: PaymentValidatedDTO, error: string) => void): void;
-    onPaymentSetupComplete(): Promise<CardinalSetupCompleteResponseData>;
+    onPaymentSetupComplete(callback: (data: CardinalSetupCompleteResponseData) => void): void;
     processBin(bin: string): Promise<any>;
     continue(acsUrl: string, pareq: string, transactionId: string): void;
 }

package/dist/sca/cardinal.js

@@ -17,22 +17,45 @@ var CardinalPaymentEvent;
     CardinalPaymentEvent["SETUP_COMPLETE"] = "payments.setupComplete";
     CardinalPaymentEvent["VALIDATED"] = "payments.validated";
 })(CardinalPaymentEvent || (CardinalPaymentEvent = {}));
-const defaultConfig = {
+export const defaultConfig = {
     timeout: 8000,
     maxRequestRetries: 3,
     logging: {
-        level: 'on'
+        level: 'verbose'
     }
 };
 export default class CardinalManager {
-    constructor(config) {
-        window.Cardinal.configure((config ? config : defaultConfig));
+    constructor(retries) {
+        this.retries = retries || [10, 100, 1000, 5000, 10000];
+    }
+    // https://www.bayanbennett.com/posts/retrying-and-exponential-backoff-with-promises/
+    // Attempts 5 times to setup Cardinal.
+    // 10ms, 100ms, 1s, 5s, 10s.
+    // Cardinal may take a while to load, for example if the user is on a slow connection (train in a tunnel, for example)
+    configure(retryCount, lastError) {
+        return __awaiter(this, void 0, void 0, function* () {
+            retryCount || (retryCount = 1);
+            const delayMs = this.retries[retryCount - 1];
+            const delay = (delayMs) => new Promise(resolve => setTimeout(resolve, delayMs));
+            if (retryCount > 5)
+                throw new Error(lastError);
+            try {
+                console.log("Attempting to load Cardinal", { retryCount, delay: delayMs });
+                window.Cardinal.configure(defaultConfig);
+            }
+            catch (error) {
+                yield delay(delayMs);
+                yield this.configure(retryCount + 1, error);
+            }
+        });
     }
     setup(jwt) {
+        console.log("CARDINAL SETUP", jwt);
         window.Cardinal.setup(CardinalWorkflow.INIT, { jwt });
     }
     onPaymentValidated(handler) {
         window.Cardinal.on('payments.validated', (data, jwt) => {
+            window.Cardinal.off('payments.validated');
             if (data.ErrorDescription.toLowerCase() === 'success') {
                 handler({
                     processorTransactionId: data.Payment.ProcessorTransactionId,
@@ -44,11 +67,10 @@ export default class CardinalManager {
             }
         });
     }
-    onPaymentSetupComplete() {
-        return new Promise((resolve, reject) => {
-            window.Cardinal.on(CardinalPaymentEvent.SETUP_COMPLETE, (data) => {
-                resolve(data);
-            });
+    onPaymentSetupComplete(callback) {
+        window.Cardinal.on(CardinalPaymentEvent.SETUP_COMPLETE, (data) => {
+            window.Cardinal.off(CardinalPaymentEvent.SETUP_COMPLETE);
+            callback(data);
         });
     }
     processBin(bin) {

package/dist/sca/index.d.ts

@@ -36,6 +36,9 @@ declare class Sca {
     reportFailure(message: string, data?: any): void;
     reportSuccess(message: string, data: any): void;
     run(config: ScaRunProps): Promise<void>;
+    perform3DS({ sessionID }: {
+        sessionID: string;
+    }): Promise<void>;
     createCardinalJWT(): Promise<string>;
     check3DSEnrollment(): Promise<void>;
     customerProperties(customer: Customer): CustomerSnakeCase;

package/dist/sca/index.js

@@ -64,6 +64,7 @@ class Sca {
             try {
                 if (!this._cardinal) {
                     this._cardinal = new CardinalManager();
+                    yield this._cardinal.configure();
                 }
             }
             catch (error) {
@@ -85,53 +86,58 @@ class Sca {
                 this.reportFailure('FatZebra.3DS: JWT creation failed.');
                 return;
             }
-            // Init cardinal
-            this._cardinal.setup(cardinalJwt);
-            if (!this.sessionId) {
-                const paymentsSetupCompleteResponse = yield this._cardinal.onPaymentSetupComplete();
+            this._cardinal.onPaymentSetupComplete((paymentsSetupCompleteResponse) => __awaiter(this, void 0, void 0, function* () {
                 this.sessionId = paymentsSetupCompleteResponse.sessionId;
-                // Register handler. Called after OTP is entered on challenge prompt.
-                this._cardinal.onPaymentValidated((data, error) => __awaiter(this, void 0, void 0, function* () {
-                    var _a;
-                    if (typeof error == 'string') {
-                        this.reportFailure(`FatZebra.3DS: Validation failed. ${error}.`);
-                        return;
-                    }
-                    const decodeSCASessionResponse = (yield this.gatewayClient.decodeSCASession({
-                        token: data.jwt
-                    })).data;
-                    if (data.processorTransactionId !== decodeSCASessionResponse.processor_transaction_id) {
-                        this.reportFailure("FatZebra.3DS: Validation failed. Invalid process transaction id.");
-                    }
-                    let validateSCAResponse;
-                    try {
-                        const requestParams = {
-                            amount: this.paymentIntent.payment.amount,
-                            authentication_transaction_id: this.enrollmentResult.authentication_transaction_id,
-                            card_token: this.cardToken,
-                            currency: this.paymentIntent.payment.currency,
-                            pareq: this.enrollmentResult.pareq,
-                            reference: this.paymentIntent.payment.reference,
-                        };
-                        validateSCAResponse = (yield this.gatewayClient.validateSCA(requestParams)).data;
-                    }
-                    catch (errorResponse) {
-                        this.reportFailure('FatZebra.3DS: Validation failed. Server error.');
-                        return;
-                    }
-                    const threedsData = threedsResponseData(validateSCAResponse);
-                    const scenario = getValidationResult(validateSCAResponse);
-                    if (scenario.outcome.success) {
-                        this.reportSuccess(`FatZebra.3DS: 3DS success - ${scenario.description}.`, threedsData);
-                    }
-                    else {
-                        const failureMessage = [scenario.description, (_a = scenario.outcome) === null || _a === void 0 ? void 0 : _a.errorCode].filter(Boolean).join(' - ');
-                        this.reportFailure(`FatZebra.3DS: 3DS error - ${failureMessage}`, {
-                            errorCode: scenario.outcome.errorCode,
-                        });
-                    }
-                }));
-            }
+                this.perform3DS({ sessionID: paymentsSetupCompleteResponse.sessionId });
+            }));
+            console.log("CARDINAL SETUP GOES HERE");
+            this._cardinal.setup(cardinalJwt);
+        });
+    }
+    perform3DS({ sessionID }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.sessionId = sessionID;
+            // Register handler. Called after OTP is entered on challenge prompt.
+            this._cardinal.onPaymentValidated((data, error) => __awaiter(this, void 0, void 0, function* () {
+                var _a;
+                if (typeof error == 'string') {
+                    this.reportFailure(`FatZebra.3DS: Validation failed. ${error}.`);
+                    return;
+                }
+                const decodeSCASessionResponse = (yield this.gatewayClient.decodeSCASession({
+                    token: data.jwt
+                })).data;
+                if (data.processorTransactionId !== decodeSCASessionResponse.processor_transaction_id) {
+                    this.reportFailure("FatZebra.3DS: Validation failed. Invalid process transaction id.");
+                }
+                let validateSCAResponse;
+                try {
+                    const requestParams = {
+                        amount: this.paymentIntent.payment.amount,
+                        authentication_transaction_id: this.enrollmentResult.authentication_transaction_id,
+                        card_token: this.cardToken,
+                        currency: this.paymentIntent.payment.currency,
+                        pareq: this.enrollmentResult.pareq,
+                        reference: this.paymentIntent.payment.reference,
+                    };
+                    validateSCAResponse = (yield this.gatewayClient.validateSCA(requestParams)).data;
+                }
+                catch (errorResponse) {
+                    this.reportFailure('FatZebra.3DS: Validation failed. Server error.');
+                    return;
+                }
+                const threedsData = threedsResponseData(validateSCAResponse);
+                const scenario = getValidationResult(validateSCAResponse);
+                if (scenario.outcome.success) {
+                    this.reportSuccess(`FatZebra.3DS: 3DS success - ${scenario.description}.`, threedsData);
+                }
+                else {
+                    const failureMessage = [scenario.description, (_a = scenario.outcome) === null || _a === void 0 ? void 0 : _a.errorCode].filter(Boolean).join(' - ');
+                    this.reportFailure(`FatZebra.3DS: 3DS error - ${failureMessage}`, {
+                        errorCode: scenario.outcome.errorCode,
+                    });
+                }
+            }));
             // Cardinal processs BIN using directory server. This determines the 3DS version used.
             try {
                 yield this._cardinal.processBin(this.bin);

package/dist/shared/api-gateway-client.d.ts

@@ -1,7 +1,6 @@
 import { AxiosResponse, AxiosInstance } from "axios";
 import { Environment } from "../shared/env";
 import * as sca from "../sca/types";
-import * as paypal from "../paypal/types";
 export type GatewayClientProps = {
     username: string;
     environment?: Environment;
@@ -18,11 +17,5 @@ declare class GatewayClient {
     enrolSCA(data: sca.EnrollSCARequest): Promise<AxiosResponse>;
     validateSCA(data: sca.ValidateSCARequest): Promise<AxiosResponse>;
     getCard(data: sca.GetCardRequest): Promise<AxiosResponse>;
-    /**************** PayPal /****************/
-    createPayPalOrder(data: paypal.CreatePayPalOrderRequest): Promise<AxiosResponse>;
-    capturePayPalOrder(data: paypal.CapturePayPalOrderRequest): Promise<AxiosResponse>;
-    authorizePayPalOrder(data: paypal.AuthorizePayPalOrderRequest): Promise<AxiosResponse>;
-    createPayPalBillingAgreement(data: paypal.CreatePayPalBillingAgreementRequest): Promise<AxiosResponse>;
-    approvePayPalBillingAgreement(data: paypal.ApprovePayPalBillingAgreementRequest): Promise<AxiosResponse>;
 }
 export default GatewayClient;

package/dist/shared/api-gateway-client.js

@@ -7,7 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { RequestHeaderSdkVersion, RequestHeaderMerchantUsername, RequestTimeout, LongRequestTimeout, LocalStorageAccessTokenKey, } from "./constants";
+import { RequestHeaderSdkVersion, RequestHeaderMerchantUsername, RequestTimeout, LocalStorageAccessTokenKey, } from "./constants";
 import axios from "axios";
 import { getSdkVersionNumber } from "./util";
 import env, { Environment } from "../shared/env";
@@ -76,39 +76,5 @@ class GatewayClient {
             return this.client.get(`/credit_cards/${data.card_token}`);
         });
     }
-    /**************** PayPal /****************/
-    createPayPalOrder(data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.client.post("/paypal/orders", data, {
-                timeout: LongRequestTimeout,
-            });
-        });
-    }
-    capturePayPalOrder(data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.client.post(`/paypal/orders/${data.id}/capture`, null, {
-                timeout: LongRequestTimeout,
-            });
-        });
-    }
-    authorizePayPalOrder(data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.client.post(`/paypal/orders/${data.id}/authorize`, null, {
-                timeout: LongRequestTimeout,
-            });
-        });
-    }
-    createPayPalBillingAgreement(data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.client.post("/paypal/billing_agreements", data, {
-                timeout: LongRequestTimeout,
-            });
-        });
-    }
-    approvePayPalBillingAgreement(data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.client.post(`/paypal/billing_agreements/${data.id}/approve`, null, { timeout: LongRequestTimeout });
-        });
-    }
 }
 export default GatewayClient;

package/dist/shared/event-manager.d.ts

@@ -24,6 +24,8 @@ interface ErrorEventDetail {
     data: any;
 }
 declare const emit: (event: PublicEvent, data: SuccessEventDetail | ErrorEventDetail, target?: HTMLElement | Window) => void;
+declare const off: (event: PublicEvent, callback: (e: any) => void, target?: HTMLElement | Window) => void;
+declare const onOnce: (event: PublicEvent, callback: (e: any) => void, target?: HTMLElement | Window) => void;
 declare const on: (event: PublicEvent, callback: (e: any) => void, target?: HTMLElement | Window) => void;
-export { emit, on };
+export { emit, on, onOnce, off };
 export type { EventData, SuccessEventDetail, ErrorEventDetail };

package/dist/shared/event-manager.js

@@ -1,7 +1,13 @@
 const emit = (event, data, target = window) => {
     target.dispatchEvent(new CustomEvent(event, { detail: data }));
 };
+const off = (event, callback, target = window) => {
+    target.removeEventListener(event, callback);
+};
+const onOnce = (event, callback, target = window) => {
+    target.addEventListener(event, callback, { once: true });
+};
 const on = (event, callback, target = window) => {
     target.addEventListener(event, callback);
 };
-export { emit, on };
+export { emit, on, onOnce, off };