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

package/dist/core/modules/checkout.js

@@ -0,0 +1,470 @@
+/**
+ * Manages checkout sessions — load, update cart, apply promo codes, handle shipping.
+ *
+ * Works for both **shipped** and **digital** products:
+ *
+ * **Shipped products** (physical goods):
+ * ```
+ * updateCustomer(id, { email, firstName, lastName })
+ * updateAddress(id, { shippingAddress: { line1, city, ... } })
+ * getShippingRates(id)
+ * selectShippingRate(id, rateId)
+ * ```
+ *
+ * **Digital products** (no shipping needed):
+ * ```
+ * updateCustomer(id, { email, firstName, lastName })
+ * updateAddress(id, { billingAddress: { line1, city, country } })
+ * // Skip shipping rates — go straight to payment
+ * ```
+ */
+export class CheckoutModule {
+    constructor(http, storeId, onTokenChange) {
+        this.http = http;
+        this.storeId = storeId;
+        this.onTokenChange = onTokenChange;
+    }
+    /**
+     * Returns the most recently loaded `CheckoutSession`, if any.
+     *
+     * Populated by `loadSession()`. Returns `undefined` if the SDK has not
+     * loaded a session yet. Used by `funnel.navigate()` to source the cart.
+     */
+    getCurrentSession() {
+        return this._currentSession;
+    }
+    /**
+     * Load an existing checkout session by its checkout token.
+     *
+     * @param checkoutToken The checkout token (from URL param `checkoutToken`).
+     * @param sessionToken The JWT session token (from URL param `token`). Required for auth.
+     * @param opts.currency Optional presentment currency override (e.g. 'EUR').
+     *   Only applied when the session has no currency set yet (first load).
+     *   Once set, currency is locked to the session and this param is ignored.
+     *
+     * Both `checkoutToken` and `sessionToken` come from the redirect URL returned by `createSession()`.
+     * Example URL: `/checkout?checkoutToken=abc123&token=eyJ...`
+     */
+    async loadSession(checkoutToken, sessionToken, opts) {
+        if (sessionToken) {
+            this.sessionToken = sessionToken;
+            this.onTokenChange?.(sessionToken);
+        }
+        const params = { skipAsyncWait: 'false' };
+        if (opts?.currency) {
+            params.currency = opts.currency;
+        }
+        const raw = await this.http.get(`/api/v1/checkout-sessions/${checkoutToken}/v2`, {
+            params,
+            token: this.sessionToken,
+        });
+        const session = this.normalizeSession(raw);
+        this._currentSession = session;
+        return session;
+    }
+    /**
+     * Create a new checkout session.
+     *
+     * Returns a `checkoutToken` and `sessionToken` (JWT) needed for all subsequent calls.
+     * Also returns a `checkoutUrl` (the full Tagada-hosted checkout URL, for reference).
+     */
+    async createSession(opts) {
+        const lineItems = opts.items.map((i) => ({
+            variantId: i.variantId,
+            priceId: i.priceId,
+            quantity: i.quantity,
+        }));
+        const body = {
+            storeId: this.storeId,
+            lineItems,
+        };
+        if (opts.returnUrl)
+            body.returnUrl = opts.returnUrl;
+        // Always send currency in customer object (backend reads customer.currency)
+        const customerData = {};
+        if (opts.currency)
+            customerData.currency = opts.currency;
+        if (opts.customerEmail) {
+            customerData.email = opts.customerEmail;
+            customerData.firstName = opts.customerFirstName;
+            customerData.lastName = opts.customerLastName;
+        }
+        if (Object.keys(customerData).length > 0) {
+            body.customer = customerData;
+        }
+        const res = await this.http.post('/api/v1/checkout/session/init', body);
+        const url = new URL(res.checkoutUrl);
+        const sessionToken = url.searchParams.get('token') ?? '';
+        this.sessionToken = sessionToken;
+        if (sessionToken)
+            this.onTokenChange?.(sessionToken);
+        return {
+            checkoutUrl: res.checkoutUrl,
+            checkoutToken: res.checkoutToken,
+            sessionToken,
+            customerId: res.customerId,
+        };
+    }
+    /**
+     * Create a session and produce a self-hosted redirect URL.
+     *
+     * Convenience wrapper around `createSession()`. Builds a URL of the
+     * form `${origin}${checkoutPath}?checkoutToken=...&sessionToken=...`
+     * that you can navigate to from a Cart page. The receiving page reads
+     * the params via {@link CheckoutModule.parseTokensFromUrl} and calls
+     * {@link CheckoutModule.loadSession}.
+     *
+     * For Tagada-hosted checkouts use the `checkoutUrl` returned by
+     * `createSession()` directly — this helper is for **self-hosted**
+     * checkout pages.
+     *
+     * @example
+     * ```ts
+     * const { url } = await tagada.checkout.createSessionUrl({
+     *   items: [{ variantId, quantity: 1 }],
+     *   checkoutPath: '/checkout',
+     * });
+     * window.location.href = url;
+     * ```
+     */
+    async createSessionUrl(opts) {
+        const session = await this.createSession({
+            items: opts.items,
+            currency: opts.currency,
+            returnUrl: opts.returnUrl,
+            customerEmail: opts.customerEmail,
+            customerFirstName: opts.customerFirstName,
+            customerLastName: opts.customerLastName,
+        });
+        const origin = opts.origin ?? (typeof window !== 'undefined' ? window.location.origin : '');
+        const checkoutPath = opts.checkoutPath ?? '/checkout';
+        const params = new URLSearchParams({
+            checkoutToken: session.checkoutToken,
+            sessionToken: session.sessionToken,
+        });
+        const url = `${origin}${checkoutPath}?${params.toString()}`;
+        return { ...session, url };
+    }
+    /**
+     * Read `checkoutToken` and session token from a URL.
+     *
+     * Recognizes both the SDK convention (`?sessionToken=`) and the
+     * Tagada-hosted convention (`?token=`), so the same checkout page
+     * works whether the user came from `createSessionUrl()` or directly
+     * from a Tagada-hosted redirect.
+     *
+     * Returns `null` if `checkoutToken` is missing.
+     *
+     * @example
+     * ```ts
+     * const tokens = CheckoutModule.parseTokensFromUrl();
+     * if (!tokens) {
+     *   window.location.href = '/cart';
+     *   return;
+     * }
+     * const session = await tagada.checkout.loadSession(
+     *   tokens.checkoutToken,
+     *   tokens.sessionToken,
+     * );
+     * ```
+     */
+    static parseTokensFromUrl(url) {
+        if (typeof url === 'undefined' && typeof window === 'undefined')
+            return null;
+        const href = url ?? window.location.href;
+        let parsed;
+        try {
+            parsed = new URL(href);
+        }
+        catch {
+            return null;
+        }
+        const checkoutToken = parsed.searchParams.get('checkoutToken');
+        if (!checkoutToken)
+            return null;
+        const sessionToken = parsed.searchParams.get('sessionToken') ?? parsed.searchParams.get('token') ?? '';
+        return { checkoutToken, sessionToken };
+    }
+    /**
+     * Add or update cart items on an existing session (upsert by product).
+     *
+     * Sends each item as `lineItems` to `POST /checkout-sessions/:id/line-items`.
+     * The endpoint UPSERTs by product: it adds new products and updates the
+     * variant/quantity of products already in the cart, but it does NOT remove
+     * products omitted from `items`, and an empty array is a no-op (it does not
+     * clear the cart). Each `quantity` must be >= 1 — removal is not supported by
+     * this endpoint.
+     *
+     * Returns a server-side mutation summary (counts of created/updated rows).
+     * It does NOT return the updated `CheckoutSession` — the underlying endpoint
+     * never has and the previous typing was a lie that quietly assigned
+     * `{ success, updated, ... }` into a `CheckoutSession` slot in `useCheckout`.
+     *
+     * Call `loadSession()` after this if you need the refreshed session
+     * (the React `useCheckout` hook does this for you).
+     */
+    async updateCart(sessionId, items) {
+        const lineItems = items.map((i) => ({
+            variantId: i.variantId,
+            priceId: i.priceId,
+            quantity: i.quantity,
+        }));
+        return this.http.post(`/api/v1/checkout-sessions/${sessionId}/line-items`, { lineItems }, { token: this.sessionToken });
+    }
+    /**
+     * Update customer identity (email, name, phone).
+     *
+     * Call this before `updateAddress()` — the SDK remembers the values and
+     * includes them automatically when addresses are submitted.
+     *
+     * If you prefer a single call, use `updateCustomerAndAddress()` instead.
+     */
+    async updateCustomer(sessionId, customer) {
+        if (customer.email)
+            this.customerEmail = customer.email;
+        if (customer.firstName)
+            this.customerFirstName = customer.firstName;
+        if (customer.lastName)
+            this.customerLastName = customer.lastName;
+        if (customer.phone)
+            this.customerPhone = customer.phone;
+    }
+    /**
+     * Update shipping and/or billing address on the session.
+     *
+     * Automatically includes customer name/phone stored from `updateCustomer()`.
+     * Uses the same atomic API call as the production checkout, so email,
+     * customer name, and addresses are all persisted together.
+     *
+     * **Shipped products**: pass `shippingAddress`. If `billingAddress` is omitted,
+     * the shipping address is automatically used as billing.
+     *
+     * **Digital products**: pass only `billingAddress` (no shipping needed).
+     *
+     * @example
+     * // Shipped product — billing = shipping automatically
+     * await checkout.updateAddress(sessionId, {
+     *   shippingAddress: { line1: '10 Rue de la Paix', city: 'Paris', postalCode: '75002', country: 'FR' },
+     * });
+     *
+     * @example
+     * // Digital product — billing only
+     * await checkout.updateAddress(sessionId, {
+     *   billingAddress: { country: 'FR' },
+     * });
+     */
+    async updateAddress(sessionId, addresses) {
+        const shipping = this.mapAddress(addresses.shippingAddress);
+        const billing = this.mapAddress(addresses.billingAddress);
+        const effectiveShipping = shipping ?? billing ?? {};
+        const effectiveBilling = billing ?? shipping;
+        const differentBilling = !!(addresses.billingAddress && addresses.shippingAddress);
+        await this.http.post(`/api/v1/checkout-sessions/${sessionId}/customer-and-session-info`, {
+            checkoutSessionId: sessionId,
+            customerData: {
+                email: this.customerEmail,
+            },
+            shippingAddress: effectiveShipping,
+            billingAddress: effectiveBilling ?? {},
+            differentBillingAddress: differentBilling,
+        }, { token: this.sessionToken });
+    }
+    /**
+     * Set customer info + addresses in one call (mirrors production checkout).
+     *
+     * Equivalent to calling `updateCustomer()` then `updateAddress()`, but
+     * in a single network request.
+     */
+    async updateCustomerAndAddress(sessionId, data) {
+        if (data.customer.email)
+            this.customerEmail = data.customer.email;
+        if (data.customer.firstName)
+            this.customerFirstName = data.customer.firstName;
+        if (data.customer.lastName)
+            this.customerLastName = data.customer.lastName;
+        if (data.customer.phone)
+            this.customerPhone = data.customer.phone;
+        const shipping = this.mapAddress(data.shippingAddress);
+        const billing = this.mapAddress(data.billingAddress);
+        const effectiveShipping = shipping ?? billing ?? {};
+        const effectiveBilling = billing ?? shipping;
+        const differentBilling = !!(data.billingAddress && data.shippingAddress);
+        await this.http.post(`/api/v1/checkout-sessions/${sessionId}/customer-and-session-info`, {
+            checkoutSessionId: sessionId,
+            customerData: {
+                email: this.customerEmail,
+            },
+            shippingAddress: effectiveShipping,
+            billingAddress: effectiveBilling ?? {},
+            differentBillingAddress: differentBilling,
+        }, { token: this.sessionToken });
+    }
+    /** Map an SDK Address to the API shape, injecting stored customer fields. */
+    mapAddress(a) {
+        if (!a)
+            return undefined;
+        return stripEmpty({
+            firstName: a.firstName ?? this.customerFirstName,
+            lastName: a.lastName ?? this.customerLastName,
+            phone: a.phone ?? this.customerPhone,
+            address1: a.line1,
+            address2: a.line2,
+            city: a.city,
+            state: a.state,
+            postal: a.postalCode,
+            country: a.country,
+        });
+    }
+    /** Apply a promotion code to the session. */
+    async applyPromoCode(sessionId, code) {
+        await this.http.post(`/api/v1/checkout-sessions/${sessionId}/promotions/apply`, { checkoutSessionId: sessionId, code }, { token: this.sessionToken });
+    }
+    /** Remove a promotion from the session by promotion ID. */
+    async removePromoCode(sessionId, promotionId) {
+        const promoId = promotionId ?? 'default';
+        await this.http.delete(`/api/v1/checkout-sessions/${sessionId}/promotions/${promoId}`, { token: this.sessionToken });
+    }
+    /**
+     * Fetch available shipping rates for the session's address.
+     * Only relevant for **shipped products** — digital products can skip this step.
+     *
+     * Requires a shipping address to be set first via `updateAddress()`.
+     * Returns an empty array if no rates are configured or address is missing.
+     */
+    async getShippingRates(sessionId) {
+        const res = await this.http.get(`/api/v1/checkout-sessions/${sessionId}/shipping-rates`, { token: this.sessionToken });
+        return (res.rates ?? []).map((r) => this.normalizeShippingRate(r));
+    }
+    /**
+     * Normalize the v1 rates payload (`shippingRateName`, `estimatedDeliveryTime`)
+     * to the SDK's `ShippingRate` shape (`name`, `estimatedDays`). Without
+     * this the consumer's UI shows blank rate names — the demo's "Delivery"
+     * radios were rendering only the price, no label.
+     */
+    normalizeShippingRate(r) {
+        return {
+            id: r.id,
+            name: (r.name ?? r.shippingRateName ?? ''),
+            description: (r.description ?? undefined),
+            amount: (r.amount ?? 0),
+            currency: (r.currency ?? 'USD'),
+            estimatedDays: (r.estimatedDays ?? r.estimatedDeliveryTime ?? undefined),
+        };
+    }
+    /**
+     * Select a shipping rate for the session.
+     * Only relevant for **shipped products** — digital products can skip this step.
+     */
+    async selectShippingRate(sessionId, rateId) {
+        await this.http.post(`/api/v1/checkout-sessions/${sessionId}/shipping-rate`, { checkoutSessionId: sessionId, shippingRateId: rateId }, { token: this.sessionToken });
+    }
+    /**
+     * Normalize the raw v2 API response into a cleaner CheckoutSession shape.
+     * The raw response has nested `checkoutSession` + `summary` -- we flatten it.
+     */
+    normalizeSession(raw) {
+        const cs = raw.checkoutSession;
+        const orderSummaries = (cs.orderSummaries ?? []);
+        const summary = (raw.summary ?? cs.summary ?? orderSummaries[0] ?? {});
+        const lineItems = (cs.sessionLineItems ?? []);
+        const customer = cs.customer;
+        const sessionCurrency = (summary.currency ?? cs.selectedPresentmentCurrency)?.toUpperCase();
+        const items = lineItems.map((li) => {
+            const price = li.price;
+            // The v2 endpoint returns `product` and `variant` as siblings of
+            // `price` on each line item — not nested under `price`. Reading
+            // them from `price.variant.product` (the old code) silently gave
+            // back empty objects, which is why the order summary rendered
+            // blank product names and a placeholder image instead of the
+            // actual product art.
+            const variant = (li.variant ?? price?.variant ?? {});
+            const product = (li.product ?? variant.product ?? {});
+            const currencyOpts = (price?.currencyOptions ?? {});
+            // Pick the amount bucket matching the session's presentment currency, then fall back to first available
+            const priceEntry = (sessionCurrency ? currencyOpts[sessionCurrency] : undefined)
+                ?? currencyOpts[Object.keys(currencyOpts)[0]];
+            const amount = priceEntry?.amount ?? 0;
+            return {
+                id: li.id,
+                variantId: li.variantId,
+                priceId: li.priceId,
+                productName: (product.name ?? ''),
+                variantName: (variant.name ?? ''),
+                quantity: (li.quantity ?? 1),
+                unitAmount: amount,
+                totalAmount: amount * (li.quantity ?? 1),
+                currency: (sessionCurrency ?? 'USD'),
+                imageUrl: (variant.imageUrl ?? product.imageUrl ?? ''),
+            };
+        });
+        const summaryItems = (summary.items ?? []);
+        return {
+            id: cs.id,
+            storeId: cs.storeId,
+            checkoutToken: cs.checkoutToken,
+            currency: (sessionCurrency ?? 'USD'),
+            items,
+            totals: {
+                subtotal: (summary.subtotalAmount ?? 0),
+                discount: (summary.totalPromotionAmount ?? 0),
+                shipping: (summary.shippingCost ?? 0),
+                tax: (summary.totalTaxAmount ?? 0),
+                total: (summary.totalAmount ?? summaryItems.reduce((s, i) => s + (i.amount ?? 0), 0)),
+                currency: (sessionCurrency ?? 'USD'),
+            },
+            customer: customer
+                ? {
+                    id: customer.id,
+                    email: customer.email,
+                    firstName: customer.firstName,
+                    lastName: customer.lastName,
+                    phone: customer.phone,
+                }
+                : undefined,
+            shippingAddress: this.normalizeAddress(cs.shippingAddress),
+            billingAddress: this.normalizeAddress(cs.billingAddress),
+            selectedShippingRateId: (cs.shippingRateId ?? null),
+            metadata: cs.metadata,
+        };
+    }
+    /**
+     * Map the raw API address shape (`address1`, `address2`, `postal`) onto
+     * the SDK's `Address` shape (`line1`, `line2`, `postalCode`). Without
+     * this, `session.shippingAddress.line1` is silently undefined after a
+     * reload — the type was lying about the actual key names — which is
+     * what makes the demo lose form state on refresh.
+     */
+    normalizeAddress(raw) {
+        if (!raw || typeof raw !== 'object')
+            return undefined;
+        const a = raw;
+        const out = {
+            firstName: a.firstName,
+            lastName: a.lastName,
+            line1: (a.line1 ?? a.address1),
+            line2: (a.line2 ?? a.address2),
+            city: a.city,
+            state: a.state,
+            postalCode: (a.postalCode ?? a.postal),
+            country: a.country,
+            phone: a.phone,
+        };
+        // If every field is undefined the API returned an empty address slot.
+        // Hand back undefined so consumers can `if (session.shippingAddress)`.
+        return Object.values(out).some((v) => v !== undefined && v !== '') ? out : undefined;
+    }
+}
+/**
+ * Remove keys with empty-string / null / undefined values from an object.
+ * Prevents sending `""` to APIs that reject empty values (e.g. Stripe `country`).
+ */
+function stripEmpty(obj) {
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined && v !== null && v !== '') {
+            result[k] = v;
+        }
+    }
+    return (Object.keys(result).length > 0 ? result : undefined);
+}
+//# sourceMappingURL=checkout.js.map

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

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

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

@@ -0,0 +1,33 @@
+import type { HttpClient } from '../http.js';
+import type { Customer, Order, Subscription } from '../types.js';
+/**
+ * Customer data -- profile, orders, subscriptions.
+ *
+ * Requires either an API key or a session token for authentication.
+ */
+export declare class CustomerModule {
+    private readonly http;
+    private readonly storeId;
+    constructor(http: HttpClient, storeId: string);
+    /** Get customer profile by ID. */
+    getProfile(customerId: string): Promise<Customer>;
+    /** Get customer profile by email. */
+    getByEmail(email: string): Promise<Customer | null>;
+    /** Update customer profile fields. */
+    updateProfile(customerId: string, data: Partial<Pick<Customer, 'email' | 'firstName' | 'lastName' | 'phone' | 'metadata'>>): Promise<Customer>;
+    /** List orders for a customer. */
+    getOrders(customerId: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        orders: Order[];
+        total: number;
+    }>;
+    /** Get a single order by ID. */
+    getOrder(orderId: string): Promise<Order>;
+    /** List subscriptions for a customer. */
+    getSubscriptions(customerId: string): Promise<Subscription[]>;
+    /** Get a single subscription by ID. */
+    getSubscription(subscriptionId: string): Promise<Subscription>;
+}
+//# sourceMappingURL=customer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customer.d.ts","sourceRoot":"","sources":["../../../src/core/modules/customer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC,kCAAkC;IAC5B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQvD,qCAAqC;IAC/B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAYzD,sCAAsC;IAChC,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,GACvF,OAAO,CAAC,QAAQ,CAAC;IAQpB,kCAAkC;IAC5B,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO9C,gCAAgC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAO/C,yCAAyC;IACnC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQnE,uCAAuC;IACjC,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAOrE"}

package/dist/core/modules/customer.js

@@ -0,0 +1,53 @@
+/**
+ * Customer data -- profile, orders, subscriptions.
+ *
+ * Requires either an API key or a session token for authentication.
+ */
+export class CustomerModule {
+    constructor(http, storeId) {
+        this.http = http;
+        this.storeId = storeId;
+    }
+    /** Get customer profile by ID. */
+    async getProfile(customerId) {
+        const res = await this.http.get(`/api/v1/customers/${customerId}`, { params: { storeId: this.storeId } });
+        return res.customer;
+    }
+    /** Get customer profile by email. */
+    async getByEmail(email) {
+        try {
+            const res = await this.http.get('/api/v1/customers/by-email', { params: { email, storeId: this.storeId } });
+            return res.customer;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Update customer profile fields. */
+    async updateProfile(customerId, data) {
+        const res = await this.http.patch(`/api/v1/customers/${customerId}`, { storeId: this.storeId, ...data });
+        return res.customer;
+    }
+    /** List orders for a customer. */
+    async getOrders(customerId, opts) {
+        return this.http.get(`/api/v1/customers/${customerId}/orders`, { params: { storeId: this.storeId, limit: opts?.limit, offset: opts?.offset } });
+    }
+    /** Get a single order by ID. */
+    async getOrder(orderId) {
+        const res = await this.http.get(`/api/v1/orders/${orderId}`, {
+            params: { storeId: this.storeId },
+        });
+        return res.order;
+    }
+    /** List subscriptions for a customer. */
+    async getSubscriptions(customerId) {
+        const res = await this.http.get(`/api/v1/customers/${customerId}/subscriptions`, { params: { storeId: this.storeId } });
+        return res.subscriptions;
+    }
+    /** Get a single subscription by ID. */
+    async getSubscription(subscriptionId) {
+        const res = await this.http.get(`/api/v1/subscriptions/${subscriptionId}`, { params: { storeId: this.storeId } });
+        return res.subscription;
+    }
+}
+//# sourceMappingURL=customer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customer.js","sourceRoot":"","sources":["../../../src/core/modules/customer.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACzB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,kCAAkC;IAClC,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,qBAAqB,UAAU,EAAE,EACjC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,UAAU,CAAC,KAAa;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,4BAA4B,EAC5B,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAC7C,CAAC;YACF,OAAO,GAAG,CAAC,QAAQ,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,aAAa,CACjB,UAAkB,EAClB,IAAwF;QAExF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAC/B,qBAAqB,UAAU,EAAE,EACjC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CACnC,CAAC;QACF,OAAO,GAAG,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,SAAS,CACb,UAAkB,EAClB,IAA0C;QAE1C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,qBAAqB,UAAU,SAAS,EACxC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAChF,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAmB,kBAAkB,OAAO,EAAE,EAAE;YAC7E,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SAClC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,qBAAqB,UAAU,gBAAgB,EAC/C,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,eAAe,CAAC,cAAsB;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,yBAAyB,cAAc,EAAE,EACzC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CACtC,CAAC;QACF,OAAO,GAAG,CAAC,YAAY,CAAC;IAC1B,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+import type { HttpClient } from '../http.js';
+import type { FunnelNavigateInput, FunnelNavigateResult } from '../types.js';
+import type { CheckoutModule } from './checkout.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 declare class FunnelModule {
+    private readonly http;
+    private readonly storeId;
+    private readonly checkout;
+    private readonly accountId;
+    private _cmsToken;
+    private _cmsSessionId;
+    private _cmsCustomerId;
+    constructor(http: HttpClient, storeId: string, checkout: CheckoutModule, accountId: string | undefined);
+    navigate(input: FunnelNavigateInput): Promise<FunnelNavigateResult>;
+    private ensureCmsSession;
+    private initializeFunnel;
+    private runNavigate;
+}
+//# sourceMappingURL=funnel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.d.ts","sourceRoot":"","sources":["../../../src/core/modules/funnel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAAqB;gBAGxB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAAG,SAAS;IAG1C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YA4C3D,gBAAgB;YA+BhB,gBAAgB;YA0BhB,WAAW;CAyD1B"}