@tagadapay/headless-sdk 1.14.1 → 1.17.0

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

@@ -123,9 +123,40 @@ export interface RxCaseSummary {
     lastShipmentShippedAt: string | null;
     createdAt: string;
 }
+export type RxActivationStepKey = 'application' | 'approval' | 'payouts' | 'statement_descriptor' | 'storefront';
+export type RxActivationMissingItem = 'application' | 'approval' | 'payout_kyc' | 'payout_bank_account' | 'statement_descriptor' | 'statement_descriptor_rejected' | 'storefront' | 'partner_rx_option';
+/**
+ * Tagada Rx activation status of a store.
+ *
+ * `payments` is `'ready'` once the brand's Rx payment account is live and its
+ * payment flow is bound; `'setting_up'` before. It is a status, not a step:
+ * there is nothing for the brand to do while payments are being set up.
+ * The public storefront route leaves out payout verification and partner
+ * contract items (`payouts`, `payout_*`, `partner_rx_option`).
+ */
+export interface RxActivationStatus {
+    storeId: string;
+    state: 'not_requested' | 'pending_review' | 'active';
+    steps: {
+        key: RxActivationStepKey;
+        done: boolean;
+    }[];
+    missing: RxActivationMissingItem[];
+    payments: 'setting_up' | 'ready';
+    descriptorStatus: 'none' | 'pending' | 'approved' | 'rejected';
+}
 export declare class RxModule {
     private readonly http;
-    constructor(http: HttpClient);
+    private readonly storeId?;
+    constructor(http: HttpClient, storeId?: string | undefined);
+    /**
+     * Activation status of the store: steps, missing items and whether Rx
+     * payments are `setting_up` or `ready`. Storefronts use it to show
+     * "Payments are being set up" instead of letting a checkout fail.
+     *
+     * Read-only / public. Defaults to the client's `storeId`.
+     */
+    getActivationStatus(storeId?: string): Promise<RxActivationStatus>;
     /**
      * Check whether a product requires an Rx case. Storefronts call this
      * before rendering the intake form so they only ask the patient

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

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

package/dist/core/modules/rx.js

@@ -1,6 +1,22 @@
 export class RxModule {
-    constructor(http) {
+    constructor(http, storeId) {
         this.http = http;
+        this.storeId = storeId;
+    }
+    /**
+     * Activation status of the store: steps, missing items and whether Rx
+     * payments are `setting_up` or `ready`. Storefronts use it to show
+     * "Payments are being set up" instead of letting a checkout fail.
+     *
+     * Read-only / public. Defaults to the client's `storeId`.
+     */
+    async getActivationStatus(storeId) {
+        const id = storeId ?? this.storeId;
+        if (!id)
+            throw new Error('rx.getActivationStatus: storeId is required');
+        return this.http.get('/api/public/v1/rx/activation-status', {
+            params: { storeId: id },
+        });
     }
     /**
      * Check whether a product requires an Rx case. Storefronts call this

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

@@ -1 +1 @@
-{"version":3,"file":"rx.js","sourceRoot":"","sources":["../../../src/core/modules/rx.ts"],"names":[],"mappings":"AA6IA,MAAM,OAAO,QAAQ;IACnB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;OAMG;IACH,KAAK,CAAC,oBAAoB,CACxB,SAAiB,EACjB,IAAqC;QAErC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,wCAAwC,EAAE;YACnF,MAAM,EAAE;gBACN,SAAS;gBACT,iBAAiB,EAAE,IAAI,EAAE,iBAAiB;aAC3C;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAGtB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,gCAAgC,EAChC,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,KAAwB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAqB,gCAAgC,EAAE,KAAK,CAAC,CAAC;IACrF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAC1B,SAAiB,EACjB,SAAkB;QAElB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAwB,yCAAyC,EAAE;YACrF,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"rx.js","sourceRoot":"","sources":["../../../src/core/modules/rx.ts"],"names":[],"mappings":"AAgLA,MAAM,OAAO,QAAQ;IACnB,YACmB,IAAgB,EAChB,OAAgB;QADhB,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAS;IAChC,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CAAC,OAAgB;QACxC,MAAM,EAAE,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAqB,qCAAqC,EAAE;YAC9E,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,oBAAoB,CACxB,SAAiB,EACjB,IAAqC;QAErC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,wCAAwC,EAAE;YACnF,MAAM,EAAE;gBACN,SAAS;gBACT,iBAAiB,EAAE,IAAI,EAAE,iBAAiB;aAC3C;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAGtB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,gCAAgC,EAChC,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,KAAwB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAqB,gCAAgC,EAAE,KAAK,CAAC,CAAC;IACrF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAC1B,SAAiB,EACjB,SAAkB;QAElB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAwB,yCAAyC,EAAE;YACrF,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,135 @@
+/**
+ * The `track` capability: the merchant's coded funnel reports its steps and events,
+ * and the browser pixels bound on the canvas fire from here.
+ *
+ * Three rules hold this file together:
+ * - the constructor assigns fields and nothing else (the React provider builds the
+ *   client inside a `useMemo` that also runs during SSR);
+ * - every public method returns at once without a `window`;
+ * - everything automatic is gated on an opt-in flag that only `step()` writes, so a
+ *   site that upgrades and never calls `track.step()` makes zero new request.
+ */
+import type { TgdBootstrap, TgdPublicApi } from '../../tgd/contract/index.js';
+import type { CheckoutLineItem } from '../types.js';
+import { SDK_NAME, SDK_VERSION } from '../version.js';
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export interface StepData {
+    /** Overrides `location.pathname` for display and for the dedup key. */
+    path?: string;
+    props?: Record<string, JsonValue>;
+}
+export type EventData = Record<string, JsonValue>;
+export interface TrackIdentity {
+    email?: string;
+    phone?: string;
+    customerId?: string;
+}
+/** One cart line, as the pixel mappers read it. Amounts stay in MINOR units. */
+export interface PixelContent {
+    id: string;
+    quantity: number;
+    item_price?: number;
+}
+export interface TrackSignalNote {
+    signal: string;
+    value: string;
+    detail?: Record<string, string>;
+}
+/** A local view: what this page loaded and what it could not do. No server call of its own. */
+export interface TrackHealth {
+    enabled: boolean;
+    storeId: string;
+    funnelKey: string;
+    sdk: {
+        name: typeof SDK_NAME;
+        version: typeof SDK_VERSION;
+    };
+    manifestHash: string | null;
+    pixels: {
+        loaded: boolean;
+        providers: string[];
+    };
+    signals: TrackSignalNote[];
+}
+/** Cart lines as the pixel mappers read them. `unitAmount` stays minor; `baseTransform` converts. */
+export declare function toContents(items?: CheckoutLineItem[]): PixelContent[] | undefined;
+export declare class TrackModule {
+    private readonly baseUrl;
+    private readonly storeId;
+    private readonly funnelKey;
+    private readonly records;
+    private readonly lastStep;
+    private readonly signals;
+    private currentStepId;
+    private manifestHash;
+    private loadedProviders;
+    private configPromise;
+    private corePromise;
+    /** @internal Server assignment passed to the lazy runtime. */
+    bootstrap?: TgdBootstrap;
+    private enginePromise;
+    private flushTimer;
+    private listening;
+    constructor(baseUrl: string, storeId: string, funnelKey: string);
+    /**
+     * The flag is `<storeId>:<funnelKey>`. Only the storeId half arms it; the funnel half is DATA,
+     * read back by `flagFunnelKey()` so automatic events report the funnel the last `step()` named.
+     * A funnel-key mismatch never disarms tracking; only another tenant's storeId reads as disabled.
+     */
+    private flag;
+    private enabled;
+    private flagFunnelKey;
+    /** Every automatic path is off under SSR and off without the flag. */
+    private off;
+    private arm;
+    step(stepId: string, data?: StepData): void;
+    event(name: string, data?: EventData): void;
+    /** Keep the dedup map to entries still inside the window, and never past `STEP_MEMORY`. */
+    private remember;
+    identify(who: TrackIdentity): void;
+    consent(state: {
+        marketing: boolean;
+    }): void;
+    health(): Promise<TrackHealth>;
+    /** @internal */
+    noteCheckout(input: {
+        checkoutSessionId: string;
+        amount?: number;
+        currency?: string;
+        items?: PixelContent[];
+    }): void;
+    /** @internal */
+    notePaid(input: {
+        orderId: string;
+        amount?: number;
+        currency?: string;
+        items?: PixelContent[];
+    }): void;
+    /** The `eventId` formula is the server's `makeMetaEventId`, so Meta and TikTok dedup. */
+    private notePixel;
+    /** @internal */
+    noteSignal(signal: 'wallet_unavailable', value: 'applePay' | 'googlePay' | 'express', detail: {
+        reason: string;
+    }): void;
+    private snapshot;
+    /**
+     * R4, once per page. Plain `fetch`, no header, no credentials — never `HttpClient`,
+     * which adds `Content-Type` and `x-cms-token` and so preflights against a fixed allow-list.
+     */
+    private config;
+    /** @internal R4 is reused; loading is allowed only when it opts this store in. */
+    core(): Promise<TgdPublicApi | null>;
+    /** @internal Funnel navigation alone must not opt a site into tracking. */
+    noteFunnelSession(funnelSessionId: string): void;
+    private pixels;
+    private startEngine;
+    private onPixelSignal;
+    private listen;
+    private push;
+    /** `localStorage` is an undeclared identifier in Node, so it is read inside the try. */
+    private identifier;
+    private flush;
+}
+//# sourceMappingURL=track.d.ts.map

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

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

package/dist/core/modules/track.js

@@ -0,0 +1,412 @@
+import { SDK_NAME, SDK_VERSION } from '../version.js';
+const CDN_URL = typeof __TGD_PIXELS_CDN__ === 'undefined' ? '' : __TGD_PIXELS_CDN__;
+function loadScript(src, isReady) {
+    if (isReady())
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.src = src;
+        script.async = true;
+        script.onload = () => resolve();
+        script.onerror = () => reject(new Error('runtime script failed to load'));
+        document.head.appendChild(script);
+    });
+}
+async function loadPixels() {
+    if (typeof window === 'undefined')
+        return null;
+    if (CDN_URL) {
+        const w = window;
+        if (w.TagadaPixels)
+            return w.TagadaPixels;
+        await loadScript(CDN_URL, () => Boolean(w.TagadaPixels));
+        return w.TagadaPixels ?? null;
+    }
+    return (await import('../../pixels/index.js'));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const FLAG_KEY = '__tgd_track';
+const ANON_KEY = '__tgd_aid';
+const SESSION_KEY = '__tgd_sid';
+const QUEUE_LIMIT = 50;
+const FLUSH_MS = 2000;
+const DEDUP_MS = 1000;
+/** Hard ceiling on the dedup map. A long-lived SPA visiting hundreds of paths must not grow it. */
+const STEP_MEMORY = 64;
+/** Cart lines as the pixel mappers read them. `unitAmount` stays minor; `baseTransform` converts. */
+export function toContents(items) {
+    if (!Array.isArray(items) || items.length === 0)
+        return undefined;
+    return items.map((item) => ({ id: item.variantId, quantity: item.quantity, item_price: item.unitAmount }));
+}
+/** R5 carries flat scalars only; anything nested is dropped rather than stringified. */
+function scalars(data) {
+    if (!data)
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
+            out[key] = value;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/**
+ * Contract §3: the three SDK event names that carry a pixel meaning, and the standard event a
+ * canvas binding writes for them. The back end auto-binds `Lead`, not `lead`, so an event sent
+ * under its own name would be gated against a key `config.steps[...].events` never holds, and
+ * would reach Meta as an unknown custom event. Any other name is a custom event.
+ */
+const STANDARD_EVENTS = {
+    lead: 'Lead',
+    product_viewed: 'ViewContent',
+    added_to_cart: 'AddToCart',
+};
+function uuid() {
+    try {
+        return crypto.randomUUID();
+    }
+    catch {
+        return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+    }
+}
+/**
+ * R4 answers a flat array (one entry per configured integration); the engine reads the
+ * hosted runtime's per-provider map. This is the only place the two shapes meet.
+ */
+function toPixelsConfig(pixels) {
+    const out = {};
+    for (const pixel of pixels) {
+        // R4 builds each entry key by key, so spreading its own answer carries nothing extra.
+        const { provider, id, idKey, ...rest } = pixel;
+        (out[provider] ?? (out[provider] = [])).push({ ...rest, enabled: true, [idKey]: id, events: pixel.events ?? {} });
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// The module
+// ---------------------------------------------------------------------------
+export class TrackModule {
+    constructor(baseUrl, storeId, funnelKey) {
+        this.baseUrl = baseUrl;
+        this.storeId = storeId;
+        this.funnelKey = funnelKey;
+        this.records = [];
+        this.lastStep = new Map();
+        this.signals = [];
+        this.currentStepId = null;
+        this.manifestHash = null;
+        this.loadedProviders = [];
+        this.configPromise = null;
+        this.corePromise = null;
+        this.enginePromise = null;
+        this.flushTimer = null;
+        this.listening = false;
+    }
+    // -- opt-in flag ----------------------------------------------------------
+    /**
+     * The flag is `<storeId>:<funnelKey>`. Only the storeId half arms it; the funnel half is DATA,
+     * read back by `flagFunnelKey()` so automatic events report the funnel the last `step()` named.
+     * A funnel-key mismatch never disarms tracking; only another tenant's storeId reads as disabled.
+     */
+    flag() {
+        try {
+            return (localStorage.getItem(FLAG_KEY) ?? '').split(':');
+        }
+        catch {
+            return [];
+        }
+    }
+    enabled() {
+        return this.flag()[0] === this.storeId;
+    }
+    flagFunnelKey() {
+        return this.flag()[1] || this.funnelKey;
+    }
+    /** Every automatic path is off under SSR and off without the flag. */
+    off() {
+        return typeof window === 'undefined' || !this.enabled();
+    }
+    arm() {
+        try {
+            localStorage.setItem(FLAG_KEY, `${this.storeId}:${this.funnelKey}`);
+        }
+        catch {
+            /* private mode: tracking simply stays off */
+        }
+    }
+    // -- public API -----------------------------------------------------------
+    step(stepId, data) {
+        if (typeof window === 'undefined')
+            return;
+        this.arm();
+        const path = data?.path ?? window.location.pathname;
+        const key = `${stepId}|${path}`;
+        const at = Date.now();
+        const previous = this.lastStep.get(key);
+        if (previous !== undefined && at - previous < DEDUP_MS)
+            return;
+        this.remember(key, at);
+        this.currentStepId = stepId;
+        this.listen();
+        this.push({ kind: 'step', stepId, at, path });
+        void this.pixels().then((engine) => engine?.pageView(path, { stepId }));
+        void this.core().then((t) => t?.page({ step_id: stepId })).catch(() => undefined);
+    }
+    event(name, data) {
+        if (this.off())
+            return;
+        const stepId = this.currentStepId;
+        // An event before the first `step()` belongs to no step: it reaches neither R5 nor a pixel.
+        if (stepId === null)
+            return;
+        // One id, both destinations (contract §7.5: `'<PixelEvent>_' + uuid`). The pixel event is the
+        // standard name when there is one, so the id Meta receives is the id R5 recorded.
+        const standard = STANDARD_EVENTS[name];
+        const eventId = `${standard ?? name}_${uuid()}`;
+        this.push({ kind: 'event', stepId, name, at: Date.now(), eventId, props: scalars(data) });
+        void this.pixels().then((engine) => standard ? engine?.track(standard, data, { stepId, eventId }) : engine?.trackCustom(name, data, { stepId }));
+        void this.core().then((t) => t?.track(name, { ...(scalars(data) ?? {}), step_id: stepId, pixel_event_id: eventId })).catch(() => undefined);
+    }
+    /** Keep the dedup map to entries still inside the window, and never past `STEP_MEMORY`. */
+    remember(key, at) {
+        for (const [seen, when] of this.lastStep) {
+            if (at - when >= DEDUP_MS)
+                this.lastStep.delete(seen);
+        }
+        // Map iterates in insertion order, so the first key is the oldest one still held.
+        while (this.lastStep.size >= STEP_MEMORY) {
+            const oldest = this.lastStep.keys().next();
+            if (oldest.done === true)
+                break;
+            this.lastStep.delete(oldest.value);
+        }
+        this.lastStep.set(key, at);
+    }
+    identify(who) {
+        if (this.off())
+            return;
+        // The engine's identity field is `externalId`; the Tagada customer id is what fills it.
+        void this.pixels().then((engine) => engine?.identify({ email: who.email, phone: who.phone, externalId: who.customerId }));
+        void this.core().then((t) => t?.identify(who.customerId ?? null, { email: who.email, phone: who.phone, customerId: who.customerId })).catch(() => undefined);
+    }
+    consent(state) {
+        if (this.off())
+            return;
+        void this.pixels().then((engine) => engine?.consent(state));
+    }
+    async health() {
+        if (typeof window === 'undefined')
+            return this.snapshot();
+        if (this.enabled())
+            await this.config();
+        return this.snapshot();
+    }
+    // -- internal hooks, called by the checkout and payment modules -----------
+    /** @internal */
+    noteCheckout(input) {
+        this.notePixel('InitiateCheckout', input.checkoutSessionId, input);
+    }
+    /** @internal */
+    notePaid(input) {
+        this.notePixel('Purchase', input.orderId, input);
+    }
+    /** The `eventId` formula is the server's `makeMetaEventId`, so Meta and TikTok dedup. */
+    notePixel(event, id, input) {
+        if (this.off())
+            return;
+        void this.pixels().then((engine) => engine?.track(event, { value: input.amount, currency: input.currency, contents: input.items, num_items: input.items?.length }, { eventId: `${event}_${id}` }));
+    }
+    /** @internal */
+    noteSignal(signal, value, detail) {
+        if (this.off())
+            return;
+        this.signals.push({ signal, value, detail });
+        this.listen();
+        this.push({ kind: 'signal', signal, value, detail });
+    }
+    // -- config, engine -------------------------------------------------------
+    snapshot() {
+        return {
+            enabled: typeof window === 'undefined' ? false : this.enabled(),
+            storeId: this.storeId,
+            funnelKey: this.flagFunnelKey(),
+            sdk: { name: SDK_NAME, version: SDK_VERSION },
+            manifestHash: this.manifestHash,
+            pixels: { loaded: this.loadedProviders.length > 0, providers: [...this.loadedProviders] },
+            signals: [...this.signals],
+        };
+    }
+    /**
+     * R4, once per page. Plain `fetch`, no header, no credentials — never `HttpClient`,
+     * which adds `Content-Type` and `x-cms-token` and so preflights against a fixed allow-list.
+     */
+    config() {
+        if (this.configPromise !== null)
+            return this.configPromise;
+        const url = `${this.baseUrl}/api/public/v1/sdk/config` +
+            `?storeId=${encodeURIComponent(this.storeId)}&funnel=${encodeURIComponent(this.flagFunnelKey())}`;
+        this.configPromise = (async () => {
+            try {
+                const response = await fetch(url);
+                if (!response.ok)
+                    return null;
+                const config = (await response.json());
+                this.manifestHash = config.manifestHash || null;
+                return config;
+            }
+            catch {
+                return null;
+            }
+        })();
+        return this.configPromise;
+    }
+    /** @internal R4 is reused; loading is allowed only when it opts this store in. */
+    core() {
+        if (typeof window === 'undefined')
+            return Promise.resolve(null);
+        this.corePromise ?? (this.corePromise = (async () => {
+            try {
+                const config = await this.config();
+                if (!config || (!config.collect && !config.experiments))
+                    return null;
+                const base = this.baseUrl.replace(/\/+$/, '');
+                const w = window;
+                if (typeof w.tgd?.init !== 'function') {
+                    await loadScript(base + '/assets/js/tgd.js', () => typeof w.tgd?.init === 'function');
+                }
+                if (typeof w.tgd?.init !== 'function')
+                    return null;
+                w.tgd.init({ storeId: this.storeId, apiHost: config.collect ? new URL(config.collect.url).origin : base,
+                    bootstrap: this.bootstrap, _source: 'headless', _manualPages: true });
+                return w.tgd;
+            }
+            catch {
+                return null;
+            }
+        })());
+        return this.corePromise;
+    }
+    /** @internal Funnel navigation alone must not opt a site into tracking. */
+    noteFunnelSession(funnelSessionId) {
+        if (this.off())
+            return;
+        void this.core().then((t) => t?._link(funnelSessionId)).catch(() => undefined);
+    }
+    pixels() {
+        if (!this.enabled())
+            return Promise.resolve(null);
+        this.enginePromise ?? (this.enginePromise = this.startEngine());
+        return this.enginePromise;
+    }
+    async startEngine() {
+        try {
+            const config = await this.config();
+            if (config === null)
+                return null;
+            const module = await loadPixels();
+            if (module === null)
+                return null;
+            const engine = module.createPixelEngine({
+                pixels: toPixelsConfig(config.pixels ?? []),
+                steps: config.steps,
+                checkout: config.checkout,
+                requireConsent: config.consent?.required === true,
+                onSignal: (signal) => this.onPixelSignal(signal),
+            });
+            await engine.init();
+            this.loadedProviders = [...new Set((config.pixels ?? []).map((pixel) => pixel.provider))];
+            return engine;
+        }
+        catch {
+            return null;
+        }
+    }
+    onPixelSignal(signal) {
+        const detail = signal.detail ?? {};
+        this.signals.push({ signal: signal.kind, value: signal.provider, detail });
+        this.push({ kind: 'signal', signal: signal.kind, value: signal.provider, detail });
+    }
+    // -- R5 queue -------------------------------------------------------------
+    listen() {
+        if (this.listening || typeof window === 'undefined')
+            return;
+        this.listening = true;
+        const onLeave = (event) => {
+            if (event.type === 'visibilitychange' && document.visibilityState !== 'hidden')
+                return;
+            this.flush();
+        };
+        window.addEventListener('pagehide', onLeave);
+        window.addEventListener('visibilitychange', onLeave);
+    }
+    push(record) {
+        if (!this.enabled())
+            return;
+        this.records.push(record);
+        if (this.records.length >= QUEUE_LIMIT) {
+            this.flush();
+            return;
+        }
+        if (this.flushTimer === null)
+            this.flushTimer = setTimeout(() => this.flush(), FLUSH_MS);
+    }
+    /** `localStorage` is an undeclared identifier in Node, so it is read inside the try. */
+    identifier(scope, key) {
+        try {
+            const store = scope === 'local' ? localStorage : sessionStorage;
+            const existing = store.getItem(key);
+            if (existing)
+                return existing;
+            const fresh = uuid();
+            store.setItem(key, fresh);
+            return fresh;
+        }
+        catch {
+            return uuid();
+        }
+    }
+    flush() {
+        if (this.flushTimer !== null) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.records.length === 0)
+            return;
+        const records = this.records.splice(0, QUEUE_LIMIT);
+        const payload = {
+            storeId: this.storeId,
+            funnelKey: this.flagFunnelKey(),
+            sdk: { name: SDK_NAME, version: SDK_VERSION },
+            anonymousId: this.identifier('local', ANON_KEY),
+            sessionId: this.identifier('session', SESSION_KEY),
+            records,
+        };
+        if (this.manifestHash !== null)
+            payload.manifestHash = this.manifestHash;
+        const body = JSON.stringify(payload);
+        const url = `${this.baseUrl}/api/public/v1/sdk/events`;
+        try {
+            if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+                if (navigator.sendBeacon(url, new Blob([body], { type: 'text/plain;charset=UTF-8' })))
+                    return;
+            }
+        }
+        catch {
+            /* swallowed: tracking never surfaces an error */
+        }
+        try {
+            void fetch(url, {
+                method: 'POST',
+                body,
+                keepalive: true,
+                headers: { 'content-type': 'text/plain;charset=UTF-8' },
+            }).catch(() => undefined);
+        }
+        catch {
+            /* swallowed */
+        }
+    }
+}
+//# sourceMappingURL=track.js.map