@tagadapay/headless-sdk 1.6.0 → 1.8.0-rc.0

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

@@ -1,137 +0,0 @@
-import type { HttpClient } from '../http.js';
-import type { Offer, OfferPreview, OfferPayResult, ProcessPaymentResult } from '../types.js';
-import type { PaymentModule } from './payment.js';
-/**
- * Offers — upsells, downsells, order bumps, and post-purchase offers.
- *
- * Endpoints align with the plugin-sdk patterns:
- *   GET  /api/v1/offers/:id                             — single offer
- *   GET  /api/v1/stores/:storeId/offers                 — list store offers
- *   POST /api/v1/offers/:offerId/preview                — preview pricing
- *   POST /api/v1/offers/:offerId/pay-preview            — pay a previewed offer (one-click)
- *   POST /api/v1/checkout-sessions/:id/toggle-order-bump — toggle order bump
- *   GET  /api/v1/post-purchase/:orderId/offers          — post-purchase offers for an order
- *   POST /api/v1/orders/:orderId/post-purchase-offers/:offerId/accept  — accept
- *   POST /api/v1/orders/:orderId/post-purchase-offers/:offerId/decline — decline
- */
-export declare class OffersModule {
-    private readonly http;
-    private readonly storeId;
-    private readonly payment?;
-    constructor(http: HttpClient, storeId: string, payment?: PaymentModule | undefined);
-    /** Get a single offer by ID. */
-    getOffer(offerId: string): Promise<Offer>;
-    /** List offers for the current store. Optionally filter by type or a set of IDs. */
-    listOffers(opts?: {
-        type?: 'upsell' | 'orderbump';
-        ids?: string[];
-    }): Promise<Offer[]>;
-    /** Preview offer pricing. Returns line items with amounts and totals. */
-    previewOffer(opts: {
-        offerId: string;
-        currency?: string;
-        lineItems?: Array<{
-            lineItemId?: string;
-            productId?: string;
-            variantId: string;
-            quantity: number;
-        }>;
-    }): Promise<OfferPreview>;
-    /**
-     * Pay a previously previewed offer (one-click charge).
-     * Used after a main order so the stored payment instrument is reused.
-     *
-     * **Low-level API.** Returns the raw `OfferPayResult` — `requireAction`,
-     * polling, and 3DS redirects are NOT handled. For most cases, use
-     * {@link processOfferPayment} which orchestrates the full lifecycle.
-     */
-    payPreviewedOffer(opts: {
-        offerId: string;
-        mainOrderId: string;
-        currency?: string;
-        lineItems?: Array<{
-            lineItemId?: string;
-            productId?: string;
-            variantId: string;
-            quantity: number;
-        }>;
-        returnUrl?: string;
-        paymentInstrumentId?: string;
-    }): Promise<OfferPayResult>;
-    /**
-     * One-click upsell with full lifecycle handling.
-     *
-     * Like `payment.processPayment()` but for previewed offers: charges the
-     * stored instrument from `mainOrderId`, runs any 3DS challenge or bank
-     * redirect, polls until terminal, and returns a typed
-     * `ProcessPaymentResult` (`succeeded` / `requires_redirect` /
-     * `failed` / `pending`).
-     *
-     * Use this instead of the lower-level `payPreviewedOffer()` whenever you
-     * don't need to inspect the raw `OfferPayResult` shape — which is most
-     * of the time.
-     *
-     * @example
-     * ```ts
-     * const result = await tagada.offers.processOfferPayment({
-     *   offerId: 'offer_xxx',
-     *   mainOrderId: order.id,
-     *   returnUrl: window.location.href,
-     * });
-     *
-     * switch (result.status) {
-     *   case 'succeeded':
-     *     window.location.href = '/upsell-2';
-     *     break;
-     *   case 'requires_redirect':
-     *     window.location.href = result.redirectUrl;
-     *     break;
-     *   case 'failed':
-     *     showError(result.error);
-     *     break;
-     * }
-     * ```
-     */
-    processOfferPayment(opts: {
-        offerId: string;
-        mainOrderId: string;
-        currency?: string;
-        lineItems?: Array<{
-            lineItemId?: string;
-            productId?: string;
-            variantId: string;
-            quantity: number;
-        }>;
-        returnUrl?: string;
-        paymentInstrumentId?: string;
-    }): Promise<ProcessPaymentResult>;
-    /** Toggle an order bump on/off within a checkout session. */
-    toggleOrderBump(opts: {
-        checkoutSessionId: string;
-        orderBumpOfferId: string;
-        selected: boolean;
-    }): Promise<unknown>;
-    /** List post-purchase offers for an order. */
-    listPostPurchaseOffers(orderId: string): Promise<Offer[]>;
-    /** Accept a post-purchase offer. */
-    acceptPostPurchaseOffer(opts: {
-        orderId: string;
-        offerId: string;
-        items?: Array<{
-            variantId: string;
-            quantity: number;
-        }>;
-    }): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    /** Decline a post-purchase offer. */
-    declinePostPurchaseOffer(opts: {
-        orderId: string;
-        offerId: string;
-    }): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-}
-//# sourceMappingURL=offers.d.ts.map

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

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

package/dist/core/modules/offers.js

@@ -1,141 +0,0 @@
-/**
- * Offers — upsells, downsells, order bumps, and post-purchase offers.
- *
- * Endpoints align with the plugin-sdk patterns:
- *   GET  /api/v1/offers/:id                             — single offer
- *   GET  /api/v1/stores/:storeId/offers                 — list store offers
- *   POST /api/v1/offers/:offerId/preview                — preview pricing
- *   POST /api/v1/offers/:offerId/pay-preview            — pay a previewed offer (one-click)
- *   POST /api/v1/checkout-sessions/:id/toggle-order-bump — toggle order bump
- *   GET  /api/v1/post-purchase/:orderId/offers          — post-purchase offers for an order
- *   POST /api/v1/orders/:orderId/post-purchase-offers/:offerId/accept  — accept
- *   POST /api/v1/orders/:orderId/post-purchase-offers/:offerId/decline — decline
- */
-export class OffersModule {
-    constructor(http, storeId, payment) {
-        this.http = http;
-        this.storeId = storeId;
-        this.payment = payment;
-    }
-    // ---------------------------------------------------------------------------
-    // Offer loading
-    // ---------------------------------------------------------------------------
-    /** Get a single offer by ID. */
-    async getOffer(offerId) {
-        return this.http.get(`/api/v1/offers/${offerId}`);
-    }
-    /** List offers for the current store. Optionally filter by type or a set of IDs. */
-    async listOffers(opts) {
-        let url = `/api/v1/stores/${this.storeId}/offers`;
-        const queryParts = [];
-        if (opts?.type)
-            queryParts.push(`type=${encodeURIComponent(opts.type)}`);
-        if (opts?.ids?.length) {
-            for (const id of opts.ids)
-                queryParts.push(`ids=${encodeURIComponent(id)}`);
-        }
-        if (queryParts.length)
-            url += `?${queryParts.join('&')}`;
-        const res = await this.http.get(url);
-        return res.offers ?? [];
-    }
-    // ---------------------------------------------------------------------------
-    // Preview & pay (one-click upsell flow from plugin-sdk)
-    // ---------------------------------------------------------------------------
-    /** Preview offer pricing. Returns line items with amounts and totals. */
-    async previewOffer(opts) {
-        return this.http.post(`/api/v1/offers/${opts.offerId}/preview`, {
-            offerId: opts.offerId,
-            currency: opts.currency ?? '',
-            lineItems: opts.lineItems,
-        });
-    }
-    /**
-     * Pay a previously previewed offer (one-click charge).
-     * Used after a main order so the stored payment instrument is reused.
-     *
-     * **Low-level API.** Returns the raw `OfferPayResult` — `requireAction`,
-     * polling, and 3DS redirects are NOT handled. For most cases, use
-     * {@link processOfferPayment} which orchestrates the full lifecycle.
-     */
-    async payPreviewedOffer(opts) {
-        return this.http.post(`/api/v1/offers/${opts.offerId}/pay-preview`, {
-            offerId: opts.offerId,
-            currency: opts.currency ?? '',
-            lineItems: opts.lineItems,
-            returnUrl: opts.returnUrl ?? (typeof window !== 'undefined' ? window.location.href : ''),
-            mainOrderId: opts.mainOrderId,
-            paymentInstrumentId: opts.paymentInstrumentId,
-        });
-    }
-    /**
-     * One-click upsell with full lifecycle handling.
-     *
-     * Like `payment.processPayment()` but for previewed offers: charges the
-     * stored instrument from `mainOrderId`, runs any 3DS challenge or bank
-     * redirect, polls until terminal, and returns a typed
-     * `ProcessPaymentResult` (`succeeded` / `requires_redirect` /
-     * `failed` / `pending`).
-     *
-     * Use this instead of the lower-level `payPreviewedOffer()` whenever you
-     * don't need to inspect the raw `OfferPayResult` shape — which is most
-     * of the time.
-     *
-     * @example
-     * ```ts
-     * const result = await tagada.offers.processOfferPayment({
-     *   offerId: 'offer_xxx',
-     *   mainOrderId: order.id,
-     *   returnUrl: window.location.href,
-     * });
-     *
-     * switch (result.status) {
-     *   case 'succeeded':
-     *     window.location.href = '/upsell-2';
-     *     break;
-     *   case 'requires_redirect':
-     *     window.location.href = result.redirectUrl;
-     *     break;
-     *   case 'failed':
-     *     showError(result.error);
-     *     break;
-     * }
-     * ```
-     */
-    async processOfferPayment(opts) {
-        if (!this.payment) {
-            throw new Error('OffersModule: no PaymentModule injected. ' +
-                'Use createHeadlessClient() instead of constructing OffersModule directly.');
-        }
-        const returnUrl = opts.returnUrl ?? (typeof window !== 'undefined' ? window.location.href : undefined);
-        const payResult = await this.payPreviewedOffer({ ...opts, returnUrl });
-        return this.payment.finalize({ payment: payResult.payment, order: payResult.order }, { returnUrl });
-    }
-    // ---------------------------------------------------------------------------
-    // Order bumps (checkout-session scoped)
-    // ---------------------------------------------------------------------------
-    /** Toggle an order bump on/off within a checkout session. */
-    async toggleOrderBump(opts) {
-        return this.http.post(`/api/v1/checkout-sessions/${opts.checkoutSessionId}/toggle-order-bump`, {
-            orderBumpOfferId: opts.orderBumpOfferId,
-            selected: opts.selected,
-        });
-    }
-    // ---------------------------------------------------------------------------
-    // Post-purchase offers (order-scoped)
-    // ---------------------------------------------------------------------------
-    /** List post-purchase offers for an order. */
-    async listPostPurchaseOffers(orderId) {
-        const res = await this.http.get(`/api/v1/post-purchase/${orderId}/offers`);
-        return Array.isArray(res) ? res : [];
-    }
-    /** Accept a post-purchase offer. */
-    async acceptPostPurchaseOffer(opts) {
-        return this.http.post(`/api/v1/orders/${opts.orderId}/post-purchase-offers/${opts.offerId}/accept`, { items: opts.items ?? [] });
-    }
-    /** Decline a post-purchase offer. */
-    async declinePostPurchaseOffer(opts) {
-        return this.http.post(`/api/v1/orders/${opts.orderId}/post-purchase-offers/${opts.offerId}/decline`);
-    }
-}
-//# sourceMappingURL=offers.js.map

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

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

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

@@ -1,298 +0,0 @@
-import type { HttpClient } from '../http.js';
-import type { Environment, PaymentSetupConfig, ExpressMethods, StoreConfig, PayResult, PayOptions, PayDirectOptions, CreateInstrumentOptions, PaymentInstrument, ThreedsSession, PaymentStatus, ProcessPaymentOptions, ProcessPaymentResult } 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.
- *
- * @remarks PCI DSS compliance notice
- *
- * This SDK collects card data (PAN, expiry, CVC) in the merchant's page
- * context and sends it directly to Basis Theory for tokenization. Card data
- * never reaches TagadaPay servers.
- *
- * Because card data transits through the merchant's JavaScript environment,
- * merchants using this SDK are responsible for **PCI DSS SAQ-A-EP**
- * compliance. This includes quarterly ASV scans, secure page delivery
- * (TLS), and ensuring no unauthorized scripts can access cardholder data.
- *
- * TagadaPay is PCI DSS Level 1 certified. The merchant's PCI scope is
- * determined by their integration method, not by TagadaPay's certification.
- *
- * See: https://docs.tagada.io/developer-tools/headless-sdk/pci-compliance
- */
-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.).
-     *
-     * Priority chain:
-     * 1. Explicit `paymentSetupConfig` parameter (developer override)
-     * 2. `window.__TGD_STEP_CONFIG__` injection (Tagada routing infra)
-     * 3. API fallback (`GET /api/v1/payment-methods`)
-     */
-    getPaymentSetup(checkoutSessionId: string, opts?: {
-        paymentSetupConfig?: PaymentSetupConfig;
-    }): Promise<PaymentSetupConfig>;
-    /**
-     * Get express payment methods (Apple Pay, Google Pay, PayPal, etc.)
-     * filtered to only those available in the current browser.
-     */
-    getExpressMethods(checkoutSessionId: string, opts?: {
-        paymentSetupConfig?: PaymentSetupConfig;
-    }): 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, opts?: {
-        paymentSetupConfig?: PaymentSetupConfig;
-    }): Promise<string[]>;
-    /**
-     * Tokenize a card using @tagadapay/core-js.
-     * Requires `@tagadapay/core-js` to be installed as a peer dependency.
-     *
-     * Card data is sent directly to Basis Theory for tokenization and never
-     * reaches TagadaPay servers. The returned `tagadaToken` is safe to pass
-     * to the TagadaPay API.
-     *
-     * **PCI note:** Using this method means card data passes through your
-     * JavaScript environment. You are responsible for PCI DSS SAQ-A-EP
-     * compliance. See https://docs.tagada.io/developer-tools/headless-sdk/pci-compliance
-     *
-     * @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>;
-    /**
-     * Initiate a Stripe Express Checkout payment (Apple Pay, Google Pay, Link, etc.).
-     *
-     * Calls `pay-v2` with `isExpress: true`, which returns a `clientSecret` in
-     * `payment.requireActionData.metadata.stripeExpressCheckout.clientSecret`.
-     * The caller must then call `stripe.confirmPayment()` with that secret.
-     *
-     * Used by the `StripeExpressCheckout` class and `useStripeExpress` hook.
-     * Not typically called directly — use the Stripe integration classes instead.
-     */
-    processStripeExpress(opts: {
-        checkoutSessionId: string;
-        processorId: string;
-        paymentMethod: string;
-    }): Promise<PayResult>;
-    /**
-     * Process a payment end-to-end: pay, handle 3DS / redirects, poll until done.
-     *
-     * This is the **recommended** way to process payments. It wraps `pay()`, detects
-     * `requireAction`, runs 3DS challenges (if `@tagadapay/core-js` is installed),
-     * and polls until a terminal status.
-     *
-     * Returns a discriminated union so you can pattern-match on `result.status`:
-     *
-     * @example
-     * ```ts
-     * const result = await payment.processPayment({
-     *   checkoutSessionId: session.id,
-     *   tagadaToken,
-     * });
-     *
-     * switch (result.status) {
-     *   case 'succeeded':
-     *     console.log('Paid!', result.payment.id);
-     *     break;
-     *   case 'requires_redirect':
-     *     // In browser: window.location.href = result.redirectUrl
-     *     // The React hook handles this automatically.
-     *     break;
-     *   case 'failed':
-     *     console.error(result.error);
-     *     break;
-     * }
-     * ```
-     */
-    processPayment(opts: ProcessPaymentOptions): Promise<ProcessPaymentResult>;
-    /**
-     * Resolve a raw `PayResult` (from any pay endpoint — `pay()`, `payDirect()`,
-     * `processApplePay()`, `offers.payPreviewedOffer()`, …) into a typed
-     * `ProcessPaymentResult` (`succeeded` / `requires_redirect` / `failed`
-     * / `pending`).
-     *
-     * Handles 3DS routing (modal challenge via core-js, or bank redirect)
-     * and async polling until the payment reaches a terminal status.
-     *
-     * This is the same logic `processPayment()` runs after `pay()` — exposed
-     * so callers (and the offers module) that already have a raw `PayResult`
-     * don't need to re-pay.
-     */
-    finalize(input: PayResult, opts?: {
-        returnUrl?: string;
-    }): Promise<ProcessPaymentResult>;
-    /**
-     * Resume a payment after the user returns from a redirect (3DS, processor auth, APM).
-     *
-     * Called automatically by `usePayment()` in React when it detects return-URL params.
-     * You can also call it manually in non-React apps.
-     */
-    resumeAfterRedirect(paymentId: string): Promise<ProcessPaymentResult>;
-    /**
-     * Detect a return from a 3DS / processor redirect by inspecting the
-     * current page URL, then poll the payment to completion.
-     *
-     * The post-3DS URL convention used by Tagada-routed processors is
-     * `?paymentAction=requireAction&paymentActionStatus=completed&paymentId=pay_xxx`.
-     * If those params are present, this method polls the payment, cleans the
-     * URL (so a refresh doesn't re-trigger), and returns the resolved
-     * `ProcessPaymentResult`. Otherwise it returns `null`.
-     *
-     * Use this in vanilla apps as the first thing on page load. The React
-     * `usePayment` hook does the same automatically — don't call this when
-     * also using `usePayment`, you'll double-poll.
-     *
-     * @example
-     * ```ts
-     * const tagada = createHeadlessClient({ storeId, environment });
-     *
-     * const resumed = await tagada.payment.maybeResumeFromUrl();
-     * if (resumed?.status === 'succeeded') {
-     *   window.location.href = `/thank-you?orderId=${resumed.order?.id}`;
-     *   return;
-     * }
-     * if (resumed?.status === 'failed') {
-     *   showError(resumed.error);
-     *   return;
-     * }
-     * // No 3DS return — render the normal page.
-     * ```
-     */
-    maybeResumeFromUrl(opts?: {
-        /**
-         * URL to inspect (defaults to `window.location.href`). Pass an explicit
-         * URL when running outside the browser or when integrating with a
-         * router that hasn't navigated yet.
-         */
-        url?: string;
-        /**
-         * Whether to clean the redirect query params from the address bar
-         * once the payment has been resolved. Defaults to `true`.
-         */
-        cleanUrl?: boolean;
-    }): Promise<ProcessPaymentResult | null>;
-    /** 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>;
-    /** Tell the server this action has been seen / is being processed. */
-    markActionProcessed(paymentId: string): Promise<void>;
-    /**
-     * Route a payment action to the appropriate handler.
-     * Returns `requires_redirect` for browser-level redirects,
-     * or attempts 3DS inline and polls to completion.
-     */
-    private handlePaymentAction;
-    /**
-     * Extract redirect info from actionData.
-     * Works for processor_auth (GET or POST), redirect, and any unknown type with a URL.
-     */
-    private extractRedirect;
-    /**
-     * Run a 3DS challenge using @tagadapay/core-js.
-     * If core-js is not installed, falls back to redirect.
-     */
-    private handleThreedsAuth;
-    /**
-     * Poll until the payment reaches a terminal status, then return a ProcessPaymentResult.
-     * Also handles new requireAction that may appear during polling.
-     */
-    private pollUntilDone;
-    /**
-     * Read paymentSetupConfig from the Tagada routing injection.
-     * Only available when running on Tagada infra (not on external hosting like Vercel).
-     */
-    private readInjectedStepConfig;
-    private loadCoreJs;
-}
-//# sourceMappingURL=payment.d.ts.map

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

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