@tagadapay/headless-sdk 1.16.0 → 1.18.0

package/dist/core/modules/customer.js

@@ -1,3 +1,13 @@
+import { TagadaError, TagadaNotFoundError } from '../errors.js';
+function toSubscription(row, storeId) {
+    return {
+        ...row,
+        storeId,
+        amount: row.priceCurrencyOptions?.[row.currency]?.amount ?? 0,
+        interval: row.priceInterval ?? '',
+        intervalCount: row.priceIntervalCount ?? 1,
+    };
+}
 /**
  * Customer data -- profile, orders, subscriptions.
  *
@@ -13,24 +23,39 @@ export class CustomerModule {
         const res = await this.http.get(`/api/v1/customers/${customerId}`, { params: { storeId: this.storeId } });
         return res.customer;
     }
-    /** Get customer profile by email. */
+    /**
+     * Not available: no route finds a customer by email for a storefront session. The only email
+     * search (`POST /api/v1/customers/search`) needs a secret API key of the whole account, which a
+     * storefront must never ship. Always rejects with a `TagadaError` of code `not_supported`, without
+     * sending a request. For the logged-in customer use `portal.getMe()` (Subscriptions V3 stores) or
+     * `getProfile(customerId)`.
+     *
+     * @deprecated There is no API route behind it.
+     */
     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;
-        }
+        throw new TagadaError('customer.getByEmail is not available: no API route finds a customer by email for a storefront session.', 'not_supported');
     }
-    /** Update customer profile fields. */
+    /**
+     * Update the customer's email (`POST /api/v1/customers/:id`, the checkout's email step): the
+     * route stores the email only. A portal customer's name and phone go through `portal.updateProfile`.
+     */
     async updateProfile(customerId, data) {
-        const res = await this.http.patch(`/api/v1/customers/${customerId}`, { storeId: this.storeId, ...data });
-        return res.customer;
+        await this.http.post(`/api/v1/customers/${customerId}`, { customerId, data: { email: data.email } });
+        return this.getProfile(customerId);
     }
-    /** List orders for a customer. */
+    /**
+     * The customer's orders on this store, newest first (`GET /api/v1/orders/customer/:customerId`).
+     * Needs a session of that customer: the checkout session, or a portal login
+     * (`portal.verifyCode`). Another customer's id rejects with `TagadaNotFoundError`. The route sends
+     * every order at once: `limit` and `offset` slice them here, `total` counts them all.
+     */
     async getOrders(customerId, opts) {
-        return this.http.get(`/api/v1/customers/${customerId}/orders`, { params: { storeId: this.storeId, limit: opts?.limit, offset: opts?.offset } });
+        const { orders } = await this.http.get(`/api/v1/orders/customer/${customerId}`, {
+            params: { storeId: this.storeId },
+        });
+        const start = opts?.offset ?? 0;
+        const end = opts?.limit === undefined ? undefined : start + opts.limit;
+        return { orders: orders.slice(start, end), total: orders.length };
     }
     /**
      * Get a single order by ID.
@@ -73,15 +98,81 @@ export class CustomerModule {
         }
         return order;
     }
-    /** List subscriptions for a customer. */
+    /**
+     * The customer's subscriptions on this store, newest first (`GET /api/v1/subscriptions`). The
+     * route answers for the customer of the session: the checkout session, or a portal login
+     * (`portal.verifyCode`), which a Subscriptions V3 store requires. Another customer's id gets `[]`.
+     * Only the 20 most recent come back: the route's page size cannot travel in a query string.
+     */
     async getSubscriptions(customerId) {
-        const res = await this.http.get(`/api/v1/customers/${customerId}/subscriptions`, { params: { storeId: this.storeId } });
-        return res.subscriptions;
+        const { items } = await this.http.get('/api/v1/subscriptions');
+        return items.filter((row) => row.customerId === customerId).map((row) => toSubscription(row, this.storeId));
     }
-    /** Get a single subscription by ID. */
+    /**
+     * One subscription of the session's customer. No route reads a subscription by id: this picks it
+     * from `getSubscriptions`' route, so it needs the same session and finds only the 20 most recent.
+     * Rejects with `TagadaNotFoundError` when it is not among them.
+     */
     async getSubscription(subscriptionId) {
-        const res = await this.http.get(`/api/v1/subscriptions/${subscriptionId}`, { params: { storeId: this.storeId } });
-        return res.subscription;
+        const { items } = await this.http.get('/api/v1/subscriptions');
+        const row = items.find((item) => item.id === subscriptionId);
+        if (!row)
+            throw new TagadaNotFoundError('Subscription', subscriptionId);
+        return toSubscription(row, this.storeId);
+    }
+    // ---------------------------------------------------------------------------
+    // Subscription actions of the logged-in customer (customer portal session).
+    // Each one is refused when the store turned that action off.
+    // ---------------------------------------------------------------------------
+    /** Pause billing. `resumeAt` (ISO date) resumes it on that day. */
+    async pauseSubscription(subscriptionId, opts) {
+        await this.http.post('/api/v1/subscriptions/pause', { subscriptionId, resumeAt: opts?.resumeAt });
+    }
+    /** Resume a paused subscription, or one scheduled for cancellation. */
+    async resumeSubscription(subscriptionId) {
+        await this.http.post('/api/v1/subscriptions/resume', { subscriptionId });
+    }
+    /** Defer the next charge by one billing period. */
+    async skipSubscription(subscriptionId) {
+        await this.http.post('/api/v1/subscriptions/skip', { subscriptionId });
+    }
+    /** Move the next billing date (ISO date, within a year). */
+    async rescheduleSubscription(subscriptionId, nextBillingDate) {
+        await this.http.post('/api/v1/subscriptions/reschedule', { subscriptionId, nextBillingDate });
+    }
+    /** Change how many units each delivery bills for. */
+    async updateSubscriptionQuantity(subscriptionId, quantity) {
+        await this.http.post('/api/v1/subscriptions/quantity', { subscriptionId, quantity });
+    }
+    /**
+     * Move to another frequency of the same product: a recurring price id, or `{ optionId }` (a
+     * purchase option of the product, priced for the subscription's variant).
+     */
+    async changeSubscriptionFrequency(subscriptionId, target) {
+        const body = typeof target === 'string' ? { priceId: target } : target;
+        await this.http.post('/api/v1/subscriptions/frequency', { subscriptionId, ...body });
+    }
+    /**
+     * Swap the product a subscription bills for: at one of its recurring prices, or at one of its
+     * purchase options (`variantId` defaults to the product's default variant).
+     */
+    async swapSubscriptionProduct(subscriptionId, target) {
+        await this.http.post('/api/v1/subscriptions/swap-product', { subscriptionId, ...target });
+    }
+    /** Attach a newly tokenized card to a subscription. */
+    async updateSubscriptionPaymentMethod(subscriptionId, tagadaToken) {
+        await this.http.post('/api/v1/subscriptions/payment-method', { subscriptionId, tagadaToken });
+    }
+    /**
+     * Cancel a subscription, at the end of the paid period by default. Refused with HTTP 403 when the
+     * store does not offer it for this product, or before the subscription's minimum paid orders
+     * (error `name` `MINIMUM_ORDERS_NOT_REACHED`).
+     */
+    async cancelSubscription(subscriptionId, opts) {
+        await this.http.post('/api/v1/subscriptions/cancel', {
+            subscriptionId,
+            cancelAtPeriodEnd: opts?.cancelAtPeriodEnd ?? true,
+        });
     }
 }
 //# sourceMappingURL=customer.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { JsonValue, TgdBootstrap, TgdPublicApi } from '../../tgd/contract/index.js';
+/** Lazy facade. Only the shared tgd runtime evaluates assignments and emits exposures. */
+export declare class ExperimentsModule {
+    private readonly core;
+    private readonly bootstrap?;
+    private runtime;
+    private loading;
+    private settled;
+    private readonly reads;
+    private readonly subscribers;
+    constructor(core: () => Promise<TgdPublicApi | null>, bootstrap?: TgdBootstrap | undefined);
+    private variant;
+    private start;
+    private read;
+    getVariant(key: string): string | null;
+    getPayload(key: string): JsonValue | null;
+    isEnabled(flagKey: string): boolean;
+    onVariant(key: string, cb: (variant: string | null) => void): void;
+    ready(): Promise<void>;
+}
+//# sourceMappingURL=experiments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.d.ts","sourceRoot":"","sources":["../../../src/core/modules/experiments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIzF,0FAA0F;AAC1F,qBAAa,iBAAiB;IAOhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAsC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IANlG,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAEnB,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,EAAmB,SAAS,CAAC,EAAE,YAAY,YAAA;IAEhH,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,IAAI;IAKZ,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMtC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAMzC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMnC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAOlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CACvB"}

package/dist/core/modules/experiments.js

@@ -0,0 +1,85 @@
+/** Lazy facade. Only the shared tgd runtime evaluates assignments and emits exposures. */
+export class ExperimentsModule {
+    constructor(core, bootstrap) {
+        this.core = core;
+        this.bootstrap = bootstrap;
+        this.runtime = null;
+        this.loading = null;
+        this.settled = false;
+        this.reads = new Set();
+        this.subscribers = [];
+    }
+    variant(key) {
+        return this.bootstrap?.experiments[key]?.arm ?? this.bootstrap?.flags[key]?.variant ?? null;
+    }
+    start() {
+        if (typeof window === 'undefined')
+            return Promise.resolve();
+        this.loading ?? (this.loading = (async () => {
+            try {
+                this.runtime = await this.core();
+            }
+            catch { /* Fall back to bootstrap. */ }
+            this.settled = true;
+            const runtime = this.runtime;
+            for (const key of this.reads) {
+                try {
+                    runtime?.getVariant(key);
+                }
+                catch { /* Runtime failures cannot interrupt the merchant. */ }
+            }
+            this.reads.clear();
+            for (const { key, cb } of this.subscribers.splice(0)) {
+                try {
+                    if (runtime)
+                        runtime.onVariant(key, cb);
+                    else
+                        cb(this.variant(key));
+                }
+                catch { /* Isolate subscribers. */ }
+            }
+            try {
+                await runtime?.ready();
+            }
+            catch { /* Offline assignment is a settled facade. */ }
+        })());
+        return this.loading;
+    }
+    read(key) {
+        if (!this.settled)
+            this.reads.add(key);
+        void this.start();
+    }
+    getVariant(key) {
+        if (this.runtime)
+            return this.runtime.getVariant(key);
+        this.read(key);
+        return this.variant(key);
+    }
+    getPayload(key) {
+        if (this.runtime)
+            return this.runtime.getPayload(key);
+        this.read(key);
+        return this.bootstrap?.experiments[key]?.payload ?? this.bootstrap?.flags[key]?.payload ?? null;
+    }
+    isEnabled(flagKey) {
+        if (this.runtime)
+            return this.runtime.isEnabled(flagKey);
+        this.read(flagKey);
+        return this.bootstrap?.flags[flagKey]?.enabled ?? false;
+    }
+    onVariant(key, cb) {
+        if (this.runtime) {
+            this.runtime.onVariant(key, cb);
+            return;
+        }
+        if (this.settled) {
+            cb(this.variant(key));
+            return;
+        }
+        this.subscribers.push({ key, cb });
+        void this.start();
+    }
+    ready() { return this.start(); }
+}
+//# sourceMappingURL=experiments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../../src/core/modules/experiments.ts"],"names":[],"mappings":"AAIA,0FAA0F;AAC1F,MAAM,OAAO,iBAAiB;IAO5B,YAA6B,IAAwC,EAAmB,SAAwB;QAAnF,SAAI,GAAJ,IAAI,CAAoC;QAAmB,cAAS,GAAT,SAAS,CAAe;QANxG,YAAO,GAAwB,IAAI,CAAC;QACpC,YAAO,GAAyB,IAAI,CAAC;QACrC,YAAO,GAAG,KAAK,CAAC;QACP,UAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAC1B,gBAAW,GAAiB,EAAE,CAAC;IAEmE,CAAC;IAE5G,OAAO,CAAC,GAAW;QACzB,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;IAC9F,CAAC;IAEO,KAAK;QACX,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,KAAZ,IAAI,CAAC,OAAO,GAAK,CAAC,KAAK,IAAI,EAAE;YAC3B,IAAI,CAAC;gBAAC,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;YACjF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,qDAAqD,CAAC,CAAC;YACnG,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC;oBAAC,IAAI,OAAO;wBAAE,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;;wBAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;YACnH,CAAC;YACD,IAAI,CAAC;gBAAC,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,6CAA6C,CAAC,CAAC;QACzF,CAAC,CAAC,EAAE,EAAC;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,IAAI,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;IAClG,CAAC;IAED,SAAS,CAAC,OAAe;QACvB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI,KAAK,CAAC;IAC1D,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,EAAoC;QACzD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACpD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,KAAoB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CAChD"}

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

@@ -26,10 +26,11 @@ export declare class FunnelModule {
     private readonly storeId;
     private readonly checkout;
     private readonly accountId;
+    private readonly onFunnelSession?;
     private _cmsToken;
     private _cmsSessionId;
     private _cmsCustomerId;
-    constructor(http: HttpClient, storeId: string, checkout: CheckoutModule, accountId: string | undefined);
+    constructor(http: HttpClient, storeId: string, checkout: CheckoutModule, accountId: string | undefined, onFunnelSession?: ((funnelSessionId: string) => void) | undefined);
     navigate(input: FunnelNavigateInput): Promise<FunnelNavigateResult>;
     private ensureCmsSession;
     private initializeFunnel;

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

@@ -1 +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"}
+{"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;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IATnC,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,EAC7B,eAAe,CAAC,GAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,aAAA;IAGhE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YA8C3D,gBAAgB;YA+BhB,gBAAgB;YA0BhB,WAAW;CAyD1B"}

package/dist/core/modules/funnel.js

@@ -20,11 +20,12 @@ import { TagadaError } from '../errors.js';
  * `session.customer.email`, and the promotion code from `session.promotionCode`.
  */
 export class FunnelModule {
-    constructor(http, storeId, checkout, accountId) {
+    constructor(http, storeId, checkout, accountId, onFunnelSession) {
         this.http = http;
         this.storeId = storeId;
         this.checkout = checkout;
         this.accountId = accountId;
+        this.onFunnelSession = onFunnelSession;
     }
     async navigate(input) {
         const session = this.checkout.getCurrentSession();
@@ -43,6 +44,10 @@ export class FunnelModule {
             accountId,
             currentUrl,
         });
+        try {
+            this.onFunnelSession?.(funnelSessionId);
+        }
+        catch { /* Tracking cannot interrupt navigation. */ }
         const url = await this.runNavigate({
             funnelSessionId,
             stepId: input.stepId,

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

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

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

@@ -0,0 +1,16 @@
+import type { CustomerPortalModule } from './portal/index.js';
+import type { CustomerModule } from './customer.js';
+import type { OffersModule } from './offers.js';
+type Commerce = {
+    CustomerPortalModule: typeof CustomerPortalModule;
+    OffersModule: typeof OffersModule;
+    CustomerModule: typeof CustomerModule;
+};
+declare global {
+    interface Window {
+        TagadaHeadlessCommerce?: Commerce;
+    }
+}
+export declare function loadCommerce(): Promise<Commerce>;
+export {};
+//# sourceMappingURL=lazyCommerce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lazyCommerce.d.ts","sourceRoot":"","sources":["../../../src/core/modules/lazyCommerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,KAAK,QAAQ,GAAG;IAAE,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAAC,YAAY,EAAE,OAAO,YAAY,CAAC;IAAC,cAAc,EAAE,OAAO,cAAc,CAAA;CAAE,CAAC;AAChJ,OAAO,CAAC,MAAM,CAAC;IAAE,UAAU,MAAM;QAAG,sBAAsB,CAAC,EAAE,QAAQ,CAAA;KAAE;CAAE;AAKzE,wBAAgB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAWhD"}

package/dist/core/modules/lazyCommerce.js

@@ -0,0 +1,20 @@
+const script = typeof document === 'undefined' ? null : document.currentScript;
+const url = script?.src ? new URL('tagada-headless-commerce.min.js', script.src).href : __TGD_COMMERCE_CDN__;
+let loading;
+export function loadCommerce() {
+    if (window.TagadaHeadlessCommerce)
+        return Promise.resolve(window.TagadaHeadlessCommerce);
+    if (!loading)
+        loading = new Promise((resolve, reject) => {
+            const element = document.createElement('script');
+            element.src = url;
+            element.async = true;
+            if (script?.nonce)
+                element.nonce = script.nonce;
+            element.addEventListener('load', () => window.TagadaHeadlessCommerce ? resolve(window.TagadaHeadlessCommerce) : reject(new Error('Commerce bundle did not initialize')));
+            element.addEventListener('error', () => { element.remove(); reject(new Error('Unable to load commerce bundle')); });
+            document.head.appendChild(element);
+        }).catch(error => { loading = undefined; throw error; });
+    return loading;
+}
+//# sourceMappingURL=lazyCommerce.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lazyCommerce.js","sourceRoot":"","sources":["../../../src/core/modules/lazyCommerce.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAyC,CAAC;AAC3G,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,iCAAiC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC;AAC7G,IAAI,OAAsC,CAAC;AAE3C,MAAM,UAAU,YAAY;IAC1B,IAAI,MAAM,CAAC,sBAAsB;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACzF,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;YAAC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;YACxC,IAAI,MAAM,EAAE,KAAK;gBAAE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAChD,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC;YACzK,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpH,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -11,8 +11,7 @@ import type { PaymentModule } from './payment.js';
  *   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
+ *   Post-purchase acceptance uses pay-preview; declining is a local decision.
  */
 export declare class OffersModule {
     private readonly http;
@@ -26,7 +25,13 @@ export declare class OffersModule {
         type?: 'upsell' | 'orderbump';
         ids?: string[];
     }): Promise<Offer[]>;
-    /** Preview offer pricing. Returns line items with amounts and totals. */
+    /**
+     * Preview offer pricing. Returns line items with amounts and totals.
+     *
+     * A Studio offer block is previewed under `blockoffer:<blockId>` and read from
+     * the step its funnel session stands on: pass that session's id
+     * (see {@link enterFunnelStep}).
+     */
     previewOffer(opts: {
         offerId: string;
         currency?: string;
@@ -36,7 +41,25 @@ export declare class OffersModule {
             variantId: string;
             quantity: number;
         }>;
+        funnelSessionId?: string;
     }): Promise<OfferPreview>;
+    /**
+     * Put the buyer on a step of a funnel, for pages the funnel does not serve
+     * itself: its offer blocks are then previewed and accepted as
+     * `blockoffer:<blockId>` with the returned `funnelSessionId`. Uses the
+     * checkout session's token, so the funnel session is the paying customer's.
+     * Pass `checkoutToken` at checkout to link that checkout to the funnel
+     * session, and `funnelSessionId` to move an open session to another step.
+     */
+    enterFunnelStep(opts: {
+        funnelId: string;
+        stepId: string;
+        accountId: string;
+        funnelSessionId?: string;
+        checkoutToken?: string;
+    }): Promise<{
+        funnelSessionId: string;
+    }>;
     /**
      * Pay a previously previewed offer (one-click charge).
      * Used after a main order so the stored payment instrument is reused.
@@ -57,6 +80,7 @@ export declare class OffersModule {
         }>;
         returnUrl?: string;
         paymentInstrumentId?: string;
+        funnelSessionId?: string;
     }): Promise<OfferPayResult>;
     /**
      * One-click upsell with full lifecycle handling.
@@ -104,6 +128,7 @@ export declare class OffersModule {
         }>;
         returnUrl?: string;
         paymentInstrumentId?: string;
+        funnelSessionId?: string;
     }): Promise<ProcessPaymentResult>;
     /** Toggle an order bump on/off within a checkout session. */
     toggleOrderBump(opts: {
@@ -113,7 +138,7 @@ export declare class OffersModule {
     }): Promise<unknown>;
     /** List post-purchase offers for an order. */
     listPostPurchaseOffers(orderId: string): Promise<Offer[]>;
-    /** Accept a post-purchase offer. */
+    /** Accept a post-purchase offer. Only a confirmed charge returns success. */
     acceptPostPurchaseOffer(opts: {
         orderId: string;
         offerId: string;
@@ -125,7 +150,7 @@ export declare class OffersModule {
         success: boolean;
         error?: string;
     }>;
-    /** Decline a post-purchase offer. */
+    /** Decline locally; the backend has no persisted refusal and no charge is made. */
     declinePostPurchaseOffer(opts: {
         orderId: string;
         offerId: string;

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

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

@@ -8,8 +8,7 @@
  *   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
+ *   Post-purchase acceptance uses pay-preview; declining is a local decision.
  */
 export class OffersModule {
     constructor(http, storeId, payment) {
@@ -42,13 +41,41 @@ export class OffersModule {
     // ---------------------------------------------------------------------------
     // Preview & pay (one-click upsell flow from plugin-sdk)
     // ---------------------------------------------------------------------------
-    /** Preview offer pricing. Returns line items with amounts and totals. */
+    /**
+     * Preview offer pricing. Returns line items with amounts and totals.
+     *
+     * A Studio offer block is previewed under `blockoffer:<blockId>` and read from
+     * the step its funnel session stands on: pass that session's id
+     * (see {@link enterFunnelStep}).
+     */
     async previewOffer(opts) {
         return this.http.post(`/api/v1/offers/${opts.offerId}/preview`, {
             offerId: opts.offerId,
             currency: opts.currency ?? '',
             lineItems: opts.lineItems,
+            funnelSessionId: opts.funnelSessionId,
+        });
+    }
+    /**
+     * Put the buyer on a step of a funnel, for pages the funnel does not serve
+     * itself: its offer blocks are then previewed and accepted as
+     * `blockoffer:<blockId>` with the returned `funnelSessionId`. Uses the
+     * checkout session's token, so the funnel session is the paying customer's.
+     * Pass `checkoutToken` at checkout to link that checkout to the funnel
+     * session, and `funnelSessionId` to move an open session to another step.
+     */
+    async enterFunnelStep(opts) {
+        const here = typeof window !== 'undefined' ? window.location.origin : 'http://localhost';
+        const res = await this.http.post('/api/v1/funnel/initialize', {
+            // Placeholder ids: the server takes the customer and the CMS session from the token.
+            cmsSession: { customerId: 'anon_placeholder', sessionId: 'anon_placeholder', storeId: this.storeId, accountId: opts.accountId },
+            funnelId: opts.funnelId,
+            funnelStepId: opts.stepId,
+            existingSessionId: opts.funnelSessionId,
+            currentUrl: opts.checkoutToken ? `${here}/?checkoutToken=${encodeURIComponent(opts.checkoutToken)}` : undefined,
+            draft: false,
         });
+        return { funnelSessionId: res.context.sessionId };
     }
     /**
      * Pay a previously previewed offer (one-click charge).
@@ -66,6 +93,7 @@ export class OffersModule {
             returnUrl: opts.returnUrl ?? (typeof window !== 'undefined' ? window.location.href : ''),
             mainOrderId: opts.mainOrderId,
             paymentInstrumentId: opts.paymentInstrumentId,
+            funnelSessionId: opts.funnelSessionId,
         });
     }
     /**
@@ -129,13 +157,44 @@ export class OffersModule {
         const res = await this.http.get(`/api/v1/post-purchase/${orderId}/offers`);
         return Array.isArray(res) ? res : [];
     }
-    /** Accept a post-purchase offer. */
+    /** Accept a post-purchase offer. Only a confirmed charge returns success. */
     async acceptPostPurchaseOffer(opts) {
-        return this.http.post(`/api/v1/orders/${opts.orderId}/post-purchase-offers/${opts.offerId}/accept`, { items: opts.items ?? [] });
+        // The server matches overrides by line-item/product ID, not variant alone.
+        // Resolve against this offer's quote so an unrelated variant cannot silently
+        // fall back to charging the offer's default selection.
+        let lineItems;
+        if (opts.items?.length) {
+            const quote = await this.http.post(`/api/v1/offers/${opts.offerId}/preview`, { offerId: opts.offerId, currency: '' });
+            lineItems = [];
+            for (const item of opts.items) {
+                const matches = quote.lineItems.filter(line => line.variantId === item.variantId ||
+                    quote.preview.options[line.productId]?.some(variant => variant.id === item.variantId));
+                if (matches.length !== 1 || lineItems.some(line => line.lineItemId === matches[0].lineItemId)) {
+                    return { success: false, error: 'Invalid selection' };
+                }
+                lineItems.push({ ...item, lineItemId: matches[0].lineItemId, productId: matches[0].productId });
+            }
+        }
+        const result = await this.payPreviewedOffer({
+            offerId: opts.offerId,
+            mainOrderId: opts.orderId,
+            lineItems,
+        });
+        if (result.payment.status === 'succeeded')
+            return { success: true };
+        return {
+            success: false,
+            error: result.payment.status === 'pending'
+                ? 'Payment pending'
+                : result.payment.status === 'requires_action' ||
+                    (result.payment.requireAction && result.payment.requireAction !== 'none')
+                    ? 'Payment requires authentication'
+                    : result.payment.requireActionData?.message || 'Payment declined',
+        };
     }
-    /** Decline a post-purchase offer. */
+    /** Decline locally; the backend has no persisted refusal and no charge is made. */
     async declinePostPurchaseOffer(opts) {
-        return this.http.post(`/api/v1/orders/${opts.orderId}/post-purchase-offers/${opts.offerId}/decline`);
+        return { success: true };
     }
 }
 //# sourceMappingURL=offers.js.map