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

package/dist/core/modules/funnel.js

@@ -0,0 +1,143 @@
+import { TagadaError } from '../errors.js';
+/**
+ * Initialize a funnel session from the SDK's current cart and produce a
+ * redirect URL into a funnel step.
+ *
+ * Mirrors the WooCommerce checkout plugin
+ * (`public/assets/php/woocommerce/tagada-checkout-plugin.php`):
+ *
+ *  1. `POST /api/v1/cms/session/anonymous` — public, returns a CMS token.
+ *  2. `POST /api/v1/cms/session/v2/init`   — uses the token, returns a CMS customer id.
+ *  3. `POST /api/v1/funnel/initialize`     — creates the funnel session.
+ *  4. `POST /api/v1/funnel/navigate`       — fires an `INIT_CHECKOUT` event and returns `{ url }`.
+ *
+ * Steps 1–3 are cached on the module instance, so repeat `navigate()` calls in
+ * the same page only fire step 4.
+ *
+ * **Prerequisite**: the SDK must have a loaded `CheckoutSession`
+ * (`sdk.checkout.loadSession(...)`). The cart is sourced from `session.items`,
+ * the currency from `session.currency`, the customer email from
+ * `session.customer.email`, and the promotion code from `session.promotionCode`.
+ */
+export class FunnelModule {
+    constructor(http, storeId, checkout, accountId) {
+        this.http = http;
+        this.storeId = storeId;
+        this.checkout = checkout;
+        this.accountId = accountId;
+    }
+    async navigate(input) {
+        const session = this.checkout.getCurrentSession();
+        if (!session) {
+            throw new TagadaError('No checkout session loaded. Call sdk.checkout.loadSession(...) before sdk.funnel.navigate(...).', 'no_cart_loaded');
+        }
+        const accountId = input.accountId ?? this.accountId;
+        if (!accountId) {
+            throw new TagadaError('accountId is required for funnel.navigate(). Set it on createHeadlessClient({ accountId }) or pass it per call.', 'missing_account_id');
+        }
+        const currentUrl = input.currentUrl ?? (typeof globalThis !== 'undefined' ? globalThis.location?.href : undefined);
+        await this.ensureCmsSession(session, accountId, input);
+        const funnelSessionId = await this.initializeFunnel({
+            funnelId: input.funnelId,
+            stepId: input.stepId,
+            accountId,
+            currentUrl,
+        });
+        const url = await this.runNavigate({
+            funnelSessionId,
+            stepId: input.stepId,
+            session,
+            input,
+            currentUrl,
+        });
+        return { url, funnelSessionId };
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    async ensureCmsSession(session, accountId, input) {
+        if (this._cmsToken && this._cmsSessionId && this._cmsCustomerId)
+            return;
+        const anon = await this.http.post('/api/v1/cms/session/anonymous', { storeId: this.storeId, role: 'anonymous', draft: false });
+        this._cmsToken = anon.token;
+        this._cmsSessionId = anon.sessionId;
+        const init = await this.http.post('/api/v1/cms/session/v2/init', {
+            storeId: this.storeId,
+            accountId,
+            customerId: 'anon_placeholder',
+            browserLocale: input.customer?.locale ?? defaultLocale(),
+            userAgent: defaultUserAgent(),
+            queryCurrency: input.customer?.currency ?? session.currency,
+            queryLocale: input.customer?.locale,
+        }, { token: this._cmsToken });
+        this._cmsCustomerId = init.customer.id;
+    }
+    async initializeFunnel(args) {
+        const res = await this.http.post('/api/v1/funnel/initialize', {
+            cmsSession: {
+                customerId: this._cmsCustomerId,
+                sessionId: this._cmsSessionId,
+                storeId: this.storeId,
+                accountId: args.accountId,
+            },
+            funnelId: args.funnelId,
+            entryStepId: args.stepId,
+            funnelStepId: args.stepId,
+            currentUrl: args.currentUrl,
+            draft: false,
+        }, { token: this._cmsToken });
+        return res.context.sessionId;
+    }
+    async runNavigate(args) {
+        const { funnelSessionId, stepId, session, input, currentUrl } = args;
+        const lineItems = session.items.map((i) => ({
+            variantId: i.variantId,
+            priceId: i.priceId,
+            quantity: i.quantity,
+        }));
+        const discountCodes = input.discountCodes ??
+            (session.promotionCode ? [session.promotionCode] : undefined);
+        const customer = {
+            email: input.customer?.email ?? session.customer?.email,
+            currency: input.customer?.currency ?? session.currency,
+            locale: input.customer?.locale,
+        };
+        const res = await this.http.post('/api/v1/funnel/navigate', {
+            sessionId: funnelSessionId,
+            currentUrl,
+            funnelStepId: stepId,
+            fireAndForget: false,
+            event: {
+                type: 'INIT_CHECKOUT',
+                data: {
+                    checkoutInit: {
+                        cartToken: session.id,
+                        lineItems,
+                        customer,
+                        returnUrl: input.returnUrl,
+                        storeId: this.storeId,
+                        metadata: input.metadata,
+                        discountCodes,
+                        // Pins the session to this exact shipping amount when the caller's
+                        // storefront already settled one (#TAG-1785). Left undefined when
+                        // absent, so it is omitted from the JSON body and the platform
+                        // auto-selects a rate exactly as before.
+                        externalShipping: input.externalShipping,
+                    },
+                },
+            },
+        }, { token: this._cmsToken });
+        return res.result.url;
+    }
+}
+function defaultLocale() {
+    if (typeof navigator !== 'undefined' && navigator.language)
+        return navigator.language;
+    return 'en-US';
+}
+function defaultUserAgent() {
+    if (typeof navigator !== 'undefined' && navigator.userAgent)
+        return navigator.userAgent;
+    return 'tagadapay-headless-sdk';
+}
+//# sourceMappingURL=funnel.js.map

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

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

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

@@ -0,0 +1,137 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,141 @@
+/**
+ * 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

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