@tagadapay/headless-sdk 1.0.0

package/dist/core/modules/offers.d.ts

@@ -0,0 +1,43 @@
+import type { HttpClient } from '../http.js';
+import type { Offer, OfferResult } from '../types.js';
+/**
+ * Post-purchase offers -- upsells, downsells, and order bumps.
+ *
+ * Offers are configured in the CRM and referenced by ID.
+ * The headless SDK lets you load offer details, accept (one-click charge),
+ * or decline from your own UI.
+ */
+export declare class OffersModule {
+    private readonly http;
+    private readonly storeId;
+    constructor(http: HttpClient, storeId: string);
+    /** Load offer details by ID. */
+    loadOffer(offerId: string): Promise<Offer>;
+    /** List all offers for the store. */
+    listOffers(opts?: {
+        type?: 'upsell' | 'orderbump';
+    }): Promise<Offer[]>;
+    /**
+     * Accept an offer (one-click upsell).
+     * Charges the stored payment instrument from the main checkout order.
+     */
+    acceptOffer(opts: {
+        offerId: string;
+        checkoutSessionId: string;
+        paymentInstrumentId?: string;
+    }): Promise<OfferResult>;
+    /** Decline an offer. Advances the funnel to the next step. */
+    declineOffer(opts: {
+        offerId: string;
+        checkoutSessionId: string;
+    }): Promise<OfferResult>;
+    /** List order bumps available for a checkout session (shown on the checkout page). */
+    listOrderBumps(checkoutSessionId: string): Promise<Offer[]>;
+    /** Toggle an order bump on/off for a checkout session. */
+    toggleOrderBump(opts: {
+        checkoutSessionId: string;
+        offerId: string;
+        selected: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=offers.d.ts.map

package/dist/core/modules/offers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.d.ts","sourceRoot":"","sources":["../../../src/core/modules/offers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC,gCAAgC;IAC1B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAQhD,qCAAqC;IAC/B,UAAU,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ5E;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,OAAO,CAAC,WAAW,CAAC;IASxB,8DAA8D;IACxD,YAAY,CAAC,IAAI,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxB,sFAAsF;IAChF,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQjE,0DAA0D;IACpD,eAAe,CAAC,IAAI,EAAE;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;CAMlB"}

package/dist/core/modules/offers.js

@@ -0,0 +1,56 @@
+/**
+ * Post-purchase offers -- upsells, downsells, and order bumps.
+ *
+ * Offers are configured in the CRM and referenced by ID.
+ * The headless SDK lets you load offer details, accept (one-click charge),
+ * or decline from your own UI.
+ */
+export class OffersModule {
+    constructor(http, storeId) {
+        this.http = http;
+        this.storeId = storeId;
+    }
+    /** Load offer details by ID. */
+    async loadOffer(offerId) {
+        const res = await this.http.get(`/api/v1/checkout-offers/${offerId}`, { params: { storeId: this.storeId } });
+        return res.offer;
+    }
+    /** List all offers for the store. */
+    async listOffers(opts) {
+        const res = await this.http.get('/api/v1/checkout-offers', { params: { storeId: this.storeId, type: opts?.type } });
+        return res.offers;
+    }
+    /**
+     * Accept an offer (one-click upsell).
+     * Charges the stored payment instrument from the main checkout order.
+     */
+    async acceptOffer(opts) {
+        return this.http.post('/api/v1/checkout-offers/accept', {
+            offerId: opts.offerId,
+            checkoutSessionId: opts.checkoutSessionId,
+            storeId: this.storeId,
+            paymentInstrumentId: opts.paymentInstrumentId,
+        });
+    }
+    /** Decline an offer. Advances the funnel to the next step. */
+    async declineOffer(opts) {
+        return this.http.post('/api/v1/checkout-offers/decline', {
+            offerId: opts.offerId,
+            checkoutSessionId: opts.checkoutSessionId,
+            storeId: this.storeId,
+        });
+    }
+    /** List order bumps available for a checkout session (shown on the checkout page). */
+    async listOrderBumps(checkoutSessionId) {
+        const res = await this.http.get('/api/v1/checkout-offers', { params: { storeId: this.storeId, checkoutSessionId, type: 'orderbump' } });
+        return res.offers;
+    }
+    /** Toggle an order bump on/off for a checkout session. */
+    async toggleOrderBump(opts) {
+        await this.http.post(`/api/v1/checkout-sessions/${opts.checkoutSessionId}/order-bumps`, {
+            offerId: opts.offerId,
+            selected: opts.selected,
+        });
+    }
+}
+//# sourceMappingURL=offers.js.map

package/dist/core/modules/offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.js","sourceRoot":"","sources":["../../../src/core/modules/offers.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACvB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,gCAAgC;IAChC,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,2BAA2B,OAAO,EAAE,EACpC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,UAAU,CAAC,IAAwC;QACvD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,yBAAyB,EACzB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CACxD,CAAC;QACF,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,IAIjB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAc,gCAAgC,EAAE;YACnE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,YAAY,CAAC,IAGlB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAc,iCAAiC,EAAE;YACpE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,cAAc,CAAC,iBAAyB;QAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,yBAAyB,EACzB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAC5E,CAAC;QACF,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,eAAe,CAAC,IAIrB;QACC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,iBAAiB,cAAc,EAAE;YACtF,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/modules/payment.d.ts

@@ -0,0 +1,123 @@
+import type { HttpClient } from '../http.js';
+import type { Environment, PaymentSetupConfig, ExpressMethods, StoreConfig, PayResult, PayOptions, PayDirectOptions, CreateInstrumentOptions, PaymentInstrument, ThreedsSession, PaymentStatus } from '../types.js';
+/**
+ * Full payment lifecycle -- discover APMs, tokenize, create instruments,
+ * process payments, handle 3DS, and poll for status.
+ *
+ * Wraps the same REST endpoints that plugin-sdk uses internally.
+ */
+export declare class PaymentModule {
+    private readonly http;
+    private readonly storeId;
+    private readonly environment;
+    constructor(http: HttpClient, storeId: string, environment: Environment);
+    /**
+     * Get the full payment setup config for a checkout session.
+     * Returns a map of payment methods with their configuration
+     * (card, apple_pay, google_pay, klarna, etc.).
+     */
+    getPaymentSetup(checkoutSessionId: string): Promise<PaymentSetupConfig>;
+    /**
+     * Get express payment methods (Apple Pay, Google Pay, PayPal, etc.)
+     * filtered to only those available in the current browser.
+     */
+    getExpressMethods(checkoutSessionId: string): Promise<ExpressMethods>;
+    /**
+     * Get store-level payment config (3DS flags, default flow ID, etc.).
+     */
+    getStoreConfig(): Promise<StoreConfig>;
+    /**
+     * Convenience: return only enabled payment method keys.
+     */
+    getEnabledMethods(checkoutSessionId: string): Promise<string[]>;
+    /**
+     * Tokenize a card using @tagadapay/core-js.
+     * Requires `@tagadapay/core-js` to be installed as a peer dependency.
+     *
+     * @returns tagadaToken (base64 string) and rawToken with SCA metadata.
+     */
+    tokenizeCard(card: {
+        cardNumber: string;
+        expiryDate: string;
+        cvc: string;
+        cardholderName?: string;
+    }): Promise<{
+        tagadaToken: string;
+        rawToken: Record<string, unknown>;
+    }>;
+    /**
+     * Create a reusable payment instrument from a TagadaToken.
+     * Session-authenticated (uses the checkout session JWT).
+     */
+    createInstrument(opts: CreateInstrumentOptions): Promise<{
+        paymentInstrument: PaymentInstrument;
+    }>;
+    /**
+     * Create a 3DS session on the TagadaPay backend.
+     * This persists the session so the processor can use it during payment.
+     */
+    create3dsSession(opts: {
+        paymentInstrumentId: string;
+        sessionData: {
+            sessionId: string;
+            metadata?: Record<string, unknown>;
+        };
+        provider?: string;
+    }): Promise<ThreedsSession>;
+    /**
+     * High-level pay: single API call that decodes tagadaToken server-side,
+     * creates the payment instrument, and processes payment.
+     *
+     * Also accepts `paymentInstrumentId` directly for pre-created instruments.
+     */
+    pay(opts: PayOptions): Promise<PayResult>;
+    /**
+     * Low-level pay: process payment with an existing instrument or for APM/express flows
+     * where no instrument is needed (redirect-based methods).
+     */
+    payDirect(opts: PayDirectOptions): Promise<PayResult>;
+    /**
+     * Process an Apple Pay payment.
+     * Tokenizes the Apple Pay token and processes payment in one call.
+     */
+    processApplePay(opts: {
+        checkoutSessionId: string;
+        applePayToken: unknown;
+        paymentFlowId?: string;
+        processorId?: string;
+    }): Promise<PayResult>;
+    /**
+     * Process a Google Pay payment.
+     * Tokenizes the Google Pay token and processes payment in one call.
+     */
+    processGooglePay(opts: {
+        checkoutSessionId: string;
+        googlePayToken: string;
+        paymentFlowId?: string;
+        processorId?: string;
+    }): Promise<PayResult>;
+    /**
+     * Process an APM payment (Klarna, iDEAL, etc.) via redirect.
+     * These typically don't require a payment instrument -- the processor handles the redirect.
+     */
+    processApm(opts: {
+        checkoutSessionId: string;
+        paymentMethod: string;
+        processorId: string;
+        paymentFlowId?: string;
+    }): Promise<PayResult>;
+    /** Get current status of a payment. */
+    getPaymentStatus(paymentId: string): Promise<PaymentStatus>;
+    /**
+     * Poll a payment until it reaches a terminal status.
+     * Returns the final status or throws on timeout.
+     */
+    pollPaymentStatus(paymentId: string, opts?: {
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<PaymentStatus>;
+    /** Finalize a payment after a 3DS challenge completes. */
+    completeAfter3ds(paymentId: string): Promise<PaymentStatus>;
+    private loadCoreJs;
+}
+//# sourceMappingURL=payment.d.ts.map

package/dist/core/modules/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/core/modules/payment.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/payment.js

@@ -0,0 +1,279 @@
+/**
+ * Full payment lifecycle -- discover APMs, tokenize, create instruments,
+ * process payments, handle 3DS, and poll for status.
+ *
+ * Wraps the same REST endpoints that plugin-sdk uses internally.
+ */
+export class PaymentModule {
+    constructor(http, storeId, environment) {
+        this.http = http;
+        this.storeId = storeId;
+        this.environment = environment;
+    }
+    // ---------------------------------------------------------------------------
+    // Discovery: what payment methods are available?
+    // ---------------------------------------------------------------------------
+    /**
+     * Get the full payment setup config for a checkout session.
+     * Returns a map of payment methods with their configuration
+     * (card, apple_pay, google_pay, klarna, etc.).
+     */
+    async getPaymentSetup(checkoutSessionId) {
+        const methods = await this.http.get('/api/v1/payment-methods', { params: { checkoutSessionId } });
+        const config = {};
+        for (const m of methods.methods ?? []) {
+            const key = m.provider ? `${m.method}:${m.provider}` : m.method;
+            config[key] = m;
+        }
+        return config;
+    }
+    /**
+     * Get express payment methods (Apple Pay, Google Pay, PayPal, etc.)
+     * filtered to only those available in the current browser.
+     */
+    async getExpressMethods(checkoutSessionId) {
+        const setup = await this.getPaymentSetup(checkoutSessionId);
+        const result = {};
+        for (const [, config] of Object.entries(setup)) {
+            if (!config.enabled || !config.express)
+                continue;
+            const method = config.method;
+            const base = {
+                type: method,
+                available: true,
+                processorId: config.processorId,
+                publishableKey: config.publishableKey,
+                metadata: config.metadata,
+            };
+            if (method === 'apple_pay' || config.type === 'apple_pay') {
+                const hasApplePay = typeof window !== 'undefined' &&
+                    'ApplePaySession' in window &&
+                    window
+                        .ApplePaySession?.canMakePayments?.();
+                result.applePay = { ...base, available: !!hasApplePay };
+            }
+            else if (method === 'google_pay' || config.type === 'google_pay') {
+                result.googlePay = base;
+            }
+            else if (method === 'paypal') {
+                result.paypal = base;
+            }
+            else if (method === 'klarna' || method === 'klarna_express') {
+                result.klarna = base;
+            }
+            else if (method === 'link') {
+                result.link = base;
+            }
+        }
+        return result;
+    }
+    /**
+     * Get store-level payment config (3DS flags, default flow ID, etc.).
+     */
+    async getStoreConfig() {
+        const res = await this.http.get('/api/v1/checkout/config', { params: { storeId: this.storeId } });
+        return res.config ?? res;
+    }
+    /**
+     * Convenience: return only enabled payment method keys.
+     */
+    async getEnabledMethods(checkoutSessionId) {
+        const setup = await this.getPaymentSetup(checkoutSessionId);
+        return Object.entries(setup)
+            .filter(([, c]) => c.enabled)
+            .map(([key]) => key);
+    }
+    // ---------------------------------------------------------------------------
+    // Tokenization (delegates to @tagadapay/core-js if available)
+    // ---------------------------------------------------------------------------
+    /**
+     * Tokenize a card using @tagadapay/core-js.
+     * Requires `@tagadapay/core-js` to be installed as a peer dependency.
+     *
+     * @returns tagadaToken (base64 string) and rawToken with SCA metadata.
+     */
+    async tokenizeCard(card) {
+        const coreJs = await this.loadCoreJs();
+        const tokenizer = new coreJs.Tokenizer({ environment: this.environment });
+        await tokenizer.initialize();
+        const sanitized = {
+            cardNumber: card.cardNumber,
+            expiryDate: card.expiryDate,
+            cvc: card.cvc,
+        };
+        if (card.cardholderName)
+            sanitized.cardholderName = card.cardholderName;
+        const [tagadaToken, rawToken] = await Promise.all([
+            tokenizer.tokenizeCard(sanitized),
+            tokenizer.tokenizeCardRaw(sanitized),
+        ]);
+        return { tagadaToken, rawToken };
+    }
+    // ---------------------------------------------------------------------------
+    // Instrument creation
+    // ---------------------------------------------------------------------------
+    /**
+     * Create a reusable payment instrument from a TagadaToken.
+     * Session-authenticated (uses the checkout session JWT).
+     */
+    async createInstrument(opts) {
+        return this.http.post('/api/v1/payment/create-instrument-from-token', {
+            tagadaToken: opts.tagadaToken,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // 3DS
+    // ---------------------------------------------------------------------------
+    /**
+     * Create a 3DS session on the TagadaPay backend.
+     * This persists the session so the processor can use it during payment.
+     */
+    async create3dsSession(opts) {
+        return this.http.post('/api/public/v1/threeds/create-session', {
+            provider: opts.provider ?? 'basis_theory',
+            storeId: this.storeId,
+            paymentInstrumentId: opts.paymentInstrumentId,
+            sessionData: opts.sessionData,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Payment processing
+    // ---------------------------------------------------------------------------
+    /**
+     * High-level pay: single API call that decodes tagadaToken server-side,
+     * creates the payment instrument, and processes payment.
+     *
+     * Also accepts `paymentInstrumentId` directly for pre-created instruments.
+     */
+    async pay(opts) {
+        if (opts.tagadaToken && !opts.paymentInstrumentId) {
+            return this.http.post('/api/v1/payment/pay-with-token', {
+                tagadaToken: opts.tagadaToken,
+                checkoutSessionId: opts.checkoutSessionId,
+                paymentFlowId: opts.paymentFlowId,
+                processorId: opts.processorId,
+                paymentMethod: opts.paymentMethod,
+                isExpress: opts.isExpress,
+                metadata: opts.metadata,
+            });
+        }
+        return this.http.post('/api/public/v1/checkout/pay-v2', {
+            checkoutSessionId: opts.checkoutSessionId,
+            paymentInstrumentId: opts.paymentInstrumentId,
+            storeId: this.storeId,
+            paymentFlowId: opts.paymentFlowId,
+            threedsSessionId: opts.threedsSessionId,
+            processorId: opts.processorId,
+            paymentMethod: opts.paymentMethod,
+            isExpress: opts.isExpress,
+            metadata: opts.metadata,
+        });
+    }
+    /**
+     * Low-level pay: process payment with an existing instrument or for APM/express flows
+     * where no instrument is needed (redirect-based methods).
+     */
+    async payDirect(opts) {
+        return this.http.post('/api/public/v1/checkout/pay-v2', {
+            checkoutSessionId: opts.checkoutSessionId,
+            paymentInstrumentId: opts.paymentInstrumentId ?? '',
+            storeId: this.storeId,
+            paymentFlowId: opts.paymentFlowId,
+            processorId: opts.processorId,
+            paymentMethod: opts.paymentMethod,
+            isExpress: opts.isExpress,
+            threedsSessionId: opts.threedsSessionId,
+        });
+    }
+    /**
+     * Process an Apple Pay payment.
+     * Tokenizes the Apple Pay token and processes payment in one call.
+     */
+    async processApplePay(opts) {
+        const coreJs = await this.loadCoreJs();
+        const tokenizer = new coreJs.Tokenizer({ environment: this.environment });
+        await tokenizer.initialize();
+        const { tagadaToken } = await tokenizer.tokenizeApplePay(opts.applePayToken);
+        return this.pay({
+            checkoutSessionId: opts.checkoutSessionId,
+            tagadaToken,
+            paymentFlowId: opts.paymentFlowId,
+            processorId: opts.processorId,
+            paymentMethod: 'apple_pay',
+            isExpress: true,
+        });
+    }
+    /**
+     * Process a Google Pay payment.
+     * Tokenizes the Google Pay token and processes payment in one call.
+     */
+    async processGooglePay(opts) {
+        const coreJs = await this.loadCoreJs();
+        const tokenizer = new coreJs.Tokenizer({ environment: this.environment });
+        await tokenizer.initialize();
+        const { tagadaToken } = await tokenizer.tokenizeGooglePay(opts.googlePayToken);
+        return this.pay({
+            checkoutSessionId: opts.checkoutSessionId,
+            tagadaToken,
+            paymentFlowId: opts.paymentFlowId,
+            processorId: opts.processorId,
+            paymentMethod: 'google_pay',
+            isExpress: true,
+        });
+    }
+    /**
+     * Process an APM payment (Klarna, iDEAL, etc.) via redirect.
+     * These typically don't require a payment instrument -- the processor handles the redirect.
+     */
+    async processApm(opts) {
+        return this.payDirect({
+            checkoutSessionId: opts.checkoutSessionId,
+            paymentMethod: opts.paymentMethod,
+            processorId: opts.processorId,
+            paymentFlowId: opts.paymentFlowId,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Status polling
+    // ---------------------------------------------------------------------------
+    /** Get current status of a payment. */
+    async getPaymentStatus(paymentId) {
+        return this.http.get(`/api/v1/payments/${paymentId}`);
+    }
+    /**
+     * Poll a payment until it reaches a terminal status.
+     * Returns the final status or throws on timeout.
+     */
+    async pollPaymentStatus(paymentId, opts) {
+        const interval = opts?.intervalMs ?? 1500;
+        const timeout = opts?.timeoutMs ?? 60000;
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            const status = await this.getPaymentStatus(paymentId);
+            if (status.status === 'succeeded' || status.status === 'failed' || status.status === 'declined') {
+                return status;
+            }
+            await new Promise((r) => setTimeout(r, interval));
+        }
+        throw new Error(`Payment ${paymentId} did not reach terminal status within ${timeout}ms.`);
+    }
+    /** Finalize a payment after a 3DS challenge completes. */
+    async completeAfter3ds(paymentId) {
+        return this.http.post('/api/v1/payments/complete-after-3ds', {
+            paymentId,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Internal helpers
+    // ---------------------------------------------------------------------------
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async loadCoreJs() {
+        try {
+            return await import('@tagadapay/core-js');
+        }
+        catch {
+            throw new Error('This method requires @tagadapay/core-js. Install it: npm install @tagadapay/core-js');
+        }
+    }
+}
+//# sourceMappingURL=payment.js.map

package/dist/core/modules/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../../src/core/modules/payment.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACxB,YACmB,IAAgB,EAChB,OAAe,EACf,WAAwB;QAFxB,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;QACf,gBAAW,GAAX,WAAW,CAAa;IACxC,CAAC;IAEJ,8EAA8E;IAC9E,iDAAiD;IACjD,8EAA8E;IAE9E;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,iBAAyB;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CACjC,yBAAyB,EACzB,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,EAAE,CAClC,CAAC;QAEF,MAAM,MAAM,GAAuB,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAChE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,iBAAyB;QAC/C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAmB,EAAE,CAAC;QAElC,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,SAAS;YAEjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,MAAM,IAAI,GAAG;gBACX,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC;YAEF,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC1D,MAAM,WAAW,GACf,OAAO,MAAM,KAAK,WAAW;oBAC7B,iBAAiB,IAAI,MAAM;oBAC1B,MAAyE;yBACvE,eAAe,EAAE,eAAe,EAAE,EAAE,CAAC;gBAC1C,MAAM,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1D,CAAC;iBAAM,IAAI,MAAM,KAAK,YAAY,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACnE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YAC1B,CAAC;iBAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACvB,CAAC;iBAAM,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBAC9D,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACvB,CAAC;iBAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,yBAAyB,EACzB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,MAAM,IAAK,GAA8B,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,iBAAyB;QAC/C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aACzB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,8EAA8E;IAC9E,8DAA8D;IAC9D,8EAA8E;IAE9E;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,IAKlB;QACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAEvC,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;QAE7B,MAAM,SAAS,GAA2B;YACxC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;QACF,IAAI,IAAI,CAAC,cAAc;YAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAExE,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChD,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC;YACjC,SAAS,CAAC,eAAe,CAAC,SAAS,CAAC;SACrC,CAAC,CAAC;QAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED,8EAA8E;IAC9E,sBAAsB;IACtB,8EAA8E;IAE9E;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CACpB,IAA6B;QAE7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,8CAA8C,EAAE;YACpE,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,MAAM;IACN,8EAA8E;IAE9E;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAItB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC,EAAE;YAC7D,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,cAAc;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,qBAAqB;IACrB,8EAA8E;IAE9E;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,IAAgB;QACxB,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAY,gCAAgC,EAAE;gBACjE,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAY,gCAAgC,EAAE;YACjE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,IAAsB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAY,gCAAgC,EAAE;YACjE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,IAAI,EAAE;YACnD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,IAKrB;QACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE7E,OAAO,IAAI,CAAC,GAAG,CAAC;YACd,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,WAAW;YACX,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,WAAW;YAC1B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAKtB;QACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAE/E,OAAO,IAAI,CAAC,GAAG,CAAC;YACd,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,WAAW;YACX,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,YAAY;YAC3B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,IAKhB;QACC,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,iBAAiB;IACjB,8EAA8E;IAE9E,uCAAuC;IACvC,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,oBAAoB,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CACrB,SAAiB,EACjB,IAAkD;QAElD,MAAM,QAAQ,GAAG,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,EAAE,SAAS,IAAI,KAAM,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAChG,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,yCAAyC,OAAO,KAAK,CAAC,CAAC;IAC7F,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAgB,qCAAqC,EAAE;YAC1E,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E,8DAA8D;IACtD,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}