@tagadapay/headless-sdk 1.16.0 → 1.17.0

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":"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"}

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

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

@@ -1 +1 @@
-{"version":3,"file":"offers.js","sourceRoot":"","sources":["../../../src/core/modules/offers.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IACvB,YACmB,IAAgB,EAChB,OAAe,EACf,OAAuB;QAFvB,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;QACf,YAAO,GAAP,OAAO,CAAgB;IACvC,CAAC;IAEJ,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E,gCAAgC;IAChC,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAQ,kBAAkB,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,UAAU,CAAC,IAGhB;QACC,IAAI,GAAG,GAAG,kBAAkB,IAAI,CAAC,OAAO,SAAS,CAAC;QAElD,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,IAAI;YAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;YACtB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG;gBAAE,UAAU,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,UAAU,CAAC,MAAM;YAAE,GAAG,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAEzD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,GAAG,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,8EAA8E;IAC9E,wDAAwD;IACxD,8EAA8E;IAE9E,yEAAyE;IACzE,KAAK,CAAC,YAAY,CAAC,IAIlB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,kBAAkB,IAAI,CAAC,OAAO,UAAU,EAAE;YAC5E,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAOvB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,kBAAkB,IAAI,CAAC,OAAO,cAAc,EAAE;YAClF,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;SAC9C,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,mBAAmB,CAAC,IAYzB;QACC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,2CAA2C;gBACzC,2EAA2E,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GACb,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAC1B,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,EACtD,EAAE,SAAS,EAAE,CACd,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,wCAAwC;IACxC,8EAA8E;IAE9E,6DAA6D;IAC7D,KAAK,CAAC,eAAe,CAAC,IAIrB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,6BAA6B,IAAI,CAAC,iBAAiB,oBAAoB,EACvE;YACE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CACF,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,sCAAsC;IACtC,8EAA8E;IAE9E,8CAA8C;IAC9C,KAAK,CAAC,sBAAsB,CAAC,OAAe;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,yBAAyB,OAAO,SAAS,CAAC,CAAC;QACpF,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,uBAAuB,CAAC,IAI7B;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,kBAAkB,IAAI,CAAC,OAAO,yBAAyB,IAAI,CAAC,OAAO,SAAS,EAC5E,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,wBAAwB,CAAC,IAG9B;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,kBAAkB,IAAI,CAAC,OAAO,yBAAyB,IAAI,CAAC,OAAO,UAAU,CAC9E,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"offers.js","sourceRoot":"","sources":["../../../src/core/modules/offers.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/portal/index.d.ts

@@ -0,0 +1,102 @@
+import type { HttpClient } from '../../http.js';
+import type { Billing, PortalAcceptOfferInput, PortalAddToNextOrderInput, PortalAcceptOfferResult, PortalAddCardInput, PortalAddressInput, PortalBuyAgainLine, PortalBuyCreditPackInput, PortalCancelFlowInput, PortalCancelOfferInput, PortalCheckoutResult, PortalCredits, PortalCreditsOrderResult, PortalMe, PortalOffer, PortalProfileInput, PortalPublicConfig, PortalRedeemCreditsInput, PortalSubscriptionResult, PortalSwitchInput, PortalSwitchResult, PortalTargetResult, PortalVerifyCodeResult } from './types.js';
+/**
+ * Customer portal (Subscriptions V3): the store's portal config, the logged-in
+ * customer, retention, plan switches, upsell links and credits.
+ *
+ * Log in with `requestCode` then `verifyCode`; every other call except
+ * `getConfig` needs that session. Subscription actions (pause, skip, …) live on
+ * `client.customer`.
+ *
+ * Endpoints:
+ *   GET  /api/v1/portal/config
+ *   GET  /api/v1/portal/me
+ *   POST /api/v1/portal/cancel-flow
+ *   POST /api/v1/portal/cancel-flow/accept
+ *   POST /api/v1/portal/switch
+ *   GET  /api/v1/portal/offers/:token
+ *   POST /api/v1/portal/offers/accept
+ *   POST /api/v1/portal/next-order
+ *   GET  /api/v1/portal/credits
+ *   POST /api/v1/portal/credits/redeem
+ *   POST /api/v1/portal/credits/packs/buy
+ *   POST /api/v1/portal/profile, /profile/email-code
+ *   POST /api/v1/portal/addresses, /addresses/remove, /addresses/default
+ *   POST /api/v1/portal/payment-methods, /payment-methods/remove, /payment-methods/default
+ *   POST /api/v1/portal/retry-payment
+ *   POST /api/v1/portal/buy-again
+ *   POST /api/v1/portal/membership/join
+ *   POST /api/v1/subscriptions/send-now, /reactivate, /saved-card, /shipping-address, /skip-date, /unskip
+ */
+export declare class CustomerPortalModule {
+    private readonly http;
+    private readonly storeId;
+    private readonly setToken;
+    constructor(http: HttpClient, storeId: string, setToken: (token: string) => void);
+    /** Email a login code to the customer. */
+    requestCode(email: string): Promise<void>;
+    /** Exchange the emailed code for a session; later calls send it. */
+    verifyCode(email: string, code: string): Promise<PortalVerifyCodeResult>;
+    /** The store's published portal: design, retention, membership program, products. */
+    getConfig(): Promise<PortalPublicConfig>;
+    /** The logged-in customer: profile, orders, subscriptions, membership, credit ledger. */
+    getMe(): Promise<PortalMe>;
+    /** Cancel a subscription or the membership after the reasons step. */
+    cancelFlow(input: PortalCancelFlowInput): Promise<PortalTargetResult>;
+    /** Take the retention offer mapped to the chosen reason instead of cancelling. */
+    acceptCancelOffer(input: PortalCancelOfferInput): Promise<PortalTargetResult>;
+    /** Move a subscription or the membership to another option now, charged now. */
+    switchOption(input: PortalSwitchInput): Promise<PortalSwitchResult>;
+    /** The upsell a signed link (`/account/offer/<token>`) offers. No login: the token is the authorization. */
+    getOffer(token: string): Promise<PortalOffer>;
+    /** Accept a signed upsell link and pay it with the card of the original order. A second accept charges nothing. */
+    acceptOffer(input: PortalAcceptOfferInput): Promise<PortalAcceptOfferResult>;
+    /** Ship a one-time item with the subscription's next renewal, charged with it; quantity 0 takes it off. */
+    addToNextOrder(input: PortalAddToNextOrderInput): Promise<PortalTargetResult>;
+    /** Credit balance and ledger of the logged-in customer. */
+    getCredits(): Promise<PortalCredits>;
+    /** Pay a product with credits. */
+    redeemCredits(input: PortalRedeemCreditsInput): Promise<PortalCreditsOrderResult>;
+    /** Buy a credit pack with the stored card. */
+    buyCreditPack(input: PortalBuyCreditPackInput): Promise<PortalCreditsOrderResult>;
+    /** Email a code to a new address; `updateProfile` saves that email with it (`emailCode`). */
+    requestEmailChangeCode(email: string): Promise<void>;
+    /** The logged-in customer's name, email and phone. */
+    updateProfile(profile: PortalProfileInput): Promise<void>;
+    /** Add an address, or replace the one with that id; `isDefault` makes it the default. */
+    saveAddress(address: PortalAddressInput): Promise<{
+        addressId: string;
+    }>;
+    /** Remove an address; the default one stays until another is the default. */
+    removeAddress(addressId: string): Promise<void>;
+    setDefaultAddress(addressId: string): Promise<void>;
+    /** Save a card tokenized with `client.payment.tokenizeCard`. */
+    addCard(input: PortalAddCardInput): Promise<{
+        paymentMethodId: string;
+    }>;
+    /** Remove a saved card; refused while a live subscription is paid with it. */
+    removeCard(paymentMethodId: string): Promise<void>;
+    /** The default card also becomes the card of every live subscription. */
+    setDefaultPaymentMethod(paymentMethodId: string): Promise<void>;
+    /** Charge a past-due subscription again now. */
+    retryPayment(subscriptionId: string): Promise<PortalSubscriptionResult>;
+    /** Order products again at today's one-time price with the default card and address. */
+    buyAgain(lines: readonly PortalBuyAgainLine[]): Promise<PortalCheckoutResult>;
+    /** Buy the Membership's monthly or yearly option with the default card. */
+    joinMembership(billing: Billing): Promise<PortalCheckoutResult>;
+    /** Buy one product now at its one-time price with the default card and address. */
+    buyNow(variantId: string, quantity?: number): Promise<PortalCheckoutResult>;
+    /** Charge and ship a subscription's next order today. */
+    sendNow(subscriptionId: string): Promise<PortalSubscriptionResult>;
+    /** Restart a cancelled subscription, or keep one set to end at its period end. */
+    reactivateSubscription(subscriptionId: string): Promise<PortalSubscriptionResult>;
+    /** Bill a subscription on another saved card. */
+    setSubscriptionCard(subscriptionId: string, paymentMethodId: string): Promise<PortalSubscriptionResult>;
+    /** Ship a subscription to an address of the book; null follows the default address. */
+    setSubscriptionAddress(subscriptionId: string, addressId: string | null): Promise<PortalSubscriptionResult>;
+    /** Skip one upcoming delivery date (`YYYY-MM-DD`); skipping the next one moves the next charge. */
+    skipDate(subscriptionId: string, date: string): Promise<PortalSubscriptionResult>;
+    /** Take back a skipped delivery date (`YYYY-MM-DD`). */
+    unskipDate(subscriptionId: string, date: string): Promise<PortalSubscriptionResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/modules/portal/index.d.ts.map

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