@selwise/widget 0.0.3 → 1.0.1

package/dist/npm/esm/datalayer/cart-association.js

@@ -1,222 +0,0 @@
-/**
- * Cart Association Tracker
- * Tracks products added to cart together for "added to cart together" analytics
- * Supports both session-based and cart-based association tracking
- */
-import { DATA_SOURCE } from './constants.js';
-import { testModeLog } from '../utils/logger.js';
-export class CartAssociationTracker {
-    constructor(config) {
-        // Track cart contents per session
-        this.sessionCartContents = new Map();
-        // Track all cart products across sessions (for cart-based associations)
-        this.globalCartContents = new Set();
-        this.config = config;
-    }
-    /**
-     * Track add_to_cart with association data
-     * Captures both session-based and cart-based associations
-     */
-    trackAddToCartWithAssociations(basketData) {
-        if (!basketData || !basketData.products || basketData.products.length === 0) {
-            return;
-        }
-        const sessionId = this.config.tracker.getSessionId();
-        const visitorId = this.config.tracker.getVisitorId();
-        // Get current session cart contents
-        const currentCart = this.sessionCartContents.get(sessionId)?.products || [];
-        // Track each product added
-        for (const product of basketData.products) {
-            const productItemCode = this.resolveProductItemCode(product);
-            if (!productItemCode)
-                continue;
-            // Find associations with products already in cart
-            const sessionAssociations = [];
-            const cartAssociations = [];
-            // Session-based associations: products in current session cart
-            for (const existingProductId of currentCart) {
-                if (existingProductId !== productItemCode && !sessionAssociations.includes(existingProductId)) {
-                    sessionAssociations.push(existingProductId);
-                }
-            }
-            // Cart-based associations: products in global cart (across sessions)
-            for (const globalProductId of this.globalCartContents) {
-                if (globalProductId !== productItemCode &&
-                    !cartAssociations.includes(globalProductId) &&
-                    globalProductId !== productItemCode) {
-                    cartAssociations.push(globalProductId);
-                }
-            }
-            const productItemCodes = this.getBasketProductItemCodes(basketData.products);
-            // Track the add_to_cart event with association metadata
-            const metadata = {
-                dataSource: DATA_SOURCE,
-                pageUrl: window.location.href,
-                referrer: document.referrer,
-                timestamp: Date.now(),
-                productName: product.title,
-                productItemCode,
-                productItemCodes,
-                productCategory: product.category,
-                quantity: product.quantity || 1,
-                price: product.price,
-                currency: basketData.currency,
-                cartId: basketData.id,
-                // Association data for server-side processing
-                cartAssociations: {
-                    session: sessionAssociations,
-                    cart: cartAssociations,
-                },
-                cartSize: {
-                    session: currentCart.length,
-                    global: this.globalCartContents.size,
-                },
-                sessionId,
-                visitorId,
-            };
-            this.config.tracker.track('add_to_cart', {
-                entityType: 'basket',
-                entityId: productItemCode,
-                metadata,
-            });
-            // Add to cart contents (both session and global)
-            if (!currentCart.includes(productItemCode)) {
-                currentCart.push(productItemCode);
-            }
-            this.globalCartContents.add(productItemCode);
-            this.log('Tracked add_to_cart with associations:', productItemCode, {
-                sessionAssociations,
-                cartAssociations,
-            });
-        }
-        // Update session cart snapshot
-        this.sessionCartContents.set(sessionId, {
-            products: currentCart,
-            lastUpdated: Date.now(),
-        });
-    }
-    /**
-     * Update cart contents (called when cart is viewed/updated)
-     */
-    updateCartContents(products) {
-        const sessionId = this.config.tracker.getSessionId();
-        const productIds = products
-            .map((product) => this.resolveProductItemCode(product))
-            .filter((p) => !!p);
-        this.sessionCartContents.set(sessionId, {
-            products: productIds,
-            lastUpdated: Date.now(),
-        });
-        // Update global cart contents
-        for (const productId of productIds) {
-            this.globalCartContents.add(productId);
-        }
-        this.log('Updated cart contents:', productIds);
-    }
-    /**
-     * Clear cart on checkout/purchase
-     */
-    clearCart(sessionId) {
-        const key = sessionId || this.config.tracker.getSessionId();
-        this.sessionCartContents.delete(key);
-        // Note: We don't clear globalCartContents here as it persists
-        // for cart-based associations across sessions
-        this.log('Cleared session cart:', key);
-    }
-    /**
-     * Clear all cart data (e.g., after order completion)
-     */
-    clearAllCarts() {
-        this.sessionCartContents.clear();
-        this.globalCartContents.clear();
-        this.log('Cleared all cart data');
-    }
-    /**
-     * Get current session cart contents
-     */
-    getSessionCart(sessionId) {
-        const key = sessionId || this.config.tracker.getSessionId();
-        return this.sessionCartContents.get(key)?.products || [];
-    }
-    /**
-     * Get global cart contents
-     */
-    getGlobalCart() {
-        return Array.from(this.globalCartContents);
-    }
-    /**
-     * Process a data layer event for cart association tracking
-     */
-    processDataLayer(data) {
-        if (!data.basket) {
-            return;
-        }
-        switch (data.event) {
-            case 'add_to_cart':
-                this.trackAddToCartWithAssociations(data.basket);
-                break;
-            case 'update_cart':
-                if (data.basket.products) {
-                    this.updateCartContents(data.basket.products);
-                }
-                break;
-            case 'purchase':
-            case 'checkout_begin':
-                // Clear session cart on checkout/purchase
-                this.clearCart();
-                break;
-            case 'remove_from_cart':
-                // Update cart contents after removal
-                if (data.basket.products) {
-                    this.updateCartContents(data.basket.products);
-                }
-                break;
-            default:
-                // For other cart events, track with associations
-                if (data.basket.products && data.basket.products.length > 0) {
-                    this.trackAddToCartWithAssociations(data.basket);
-                }
-        }
-    }
-    /**
-     * Cleanup
-     */
-    destroy() {
-        this.sessionCartContents.clear();
-        this.globalCartContents.clear();
-    }
-    resolveProductItemCode(product) {
-        if (!product) {
-            return null;
-        }
-        const rawValue = product.sku;
-        if (!rawValue) {
-            return null;
-        }
-        const normalized = rawValue.trim();
-        return normalized.length > 0 ? normalized : null;
-    }
-    getBasketProductItemCodes(products) {
-        if (!products || products.length === 0) {
-            return [];
-        }
-        const seen = new Set();
-        const codes = [];
-        for (const product of products) {
-            const code = this.resolveProductItemCode(product);
-            if (!code || seen.has(code)) {
-                continue;
-            }
-            seen.add(code);
-            codes.push(code);
-        }
-        return codes;
-    }
-    /**
-     * Log in debug mode
-     */
-    log(...args) {
-        testModeLog('CartAssociationTracker', ...args);
-    }
-}
-//# sourceMappingURL=cart-association.js.map

package/dist/npm/esm/datalayer/cart-association.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cart-association.js","sourceRoot":"","sources":["../../../../src/datalayer/cart-association.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAqB9C,MAAM,OAAO,sBAAsB;IAOjC,YAAY,MAAoC;QALhD,kCAAkC;QAC1B,wBAAmB,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC9D,wEAAwE;QAChE,uBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;QAG7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,8BAA8B,CAAC,UAAsC;QACnE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAErD,oCAAoC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;QAE5E,2BAA2B;QAC3B,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAE7D,IAAI,CAAC,eAAe;gBAAE,SAAS;YAE/B,kDAAkD;YAClD,MAAM,mBAAmB,GAAa,EAAE,CAAC;YACzC,MAAM,gBAAgB,GAAa,EAAE,CAAC;YAEtC,+DAA+D;YAC/D,KAAK,MAAM,iBAAiB,IAAI,WAAW,EAAE,CAAC;gBAC5C,IAAI,iBAAiB,KAAK,eAAe,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBAC9F,mBAAmB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YAED,qEAAqE;YACrE,KAAK,MAAM,eAAe,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACtD,IAAI,eAAe,KAAK,eAAe;oBACnC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,eAAe,CAAC;oBAC3C,eAAe,KAAK,eAAe,EAAE,CAAC;oBACxC,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;YAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAE7E,wDAAwD;YACxD,MAAM,QAAQ,GAAwB;gBACpC,UAAU,EAAE,WAAW;gBACvB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;gBAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,WAAW,EAAE,OAAO,CAAC,KAAK;gBAC1B,eAAe;gBACf,gBAAgB;gBAChB,eAAe,EAAE,OAAO,CAAC,QAAQ;gBACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;gBAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,MAAM,EAAE,UAAU,CAAC,EAAE;gBACrB,8CAA8C;gBAC9C,gBAAgB,EAAE;oBAChB,OAAO,EAAE,mBAAmB;oBAC5B,IAAI,EAAE,gBAAgB;iBACvB;gBACD,QAAQ,EAAE;oBACR,OAAO,EAAE,WAAW,CAAC,MAAM;oBAC3B,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI;iBACrC;gBACD,SAAS;gBACT,SAAS;aACV,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE;gBACvC,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,eAAe;gBACzB,QAAQ;aACT,CAAC,CAAC;YAEH,iDAAiD;YACjD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC3C,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAE7C,IAAI,CAAC,GAAG,CAAC,wCAAwC,EAAE,eAAe,EAAE;gBAClE,mBAAmB;gBACnB,gBAAgB;aACjB,CAAC,CAAC;QACL,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE;YACtC,QAAQ,EAAE,WAAW;YACrB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAyB;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,QAAQ;aACxB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;aACtD,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE;YACtC,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;QAEH,8BAA8B;QAC9B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,SAAkB;QAC1B,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC5D,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAErC,8DAA8D;QAC9D,8CAA8C;QAC9C,IAAI,CAAC,GAAG,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAkB;QAC/B,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAsB;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,aAAa;gBAChB,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACjD,MAAM;YAER,KAAK,aAAa;gBAChB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACzB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAChD,CAAC;gBACD,MAAM;YAER,KAAK,UAAU,CAAC;YAChB,KAAK,gBAAgB;gBACnB,0CAA0C;gBAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjB,MAAM;YAER,KAAK,kBAAkB;gBACrB,qCAAqC;gBACrC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACzB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAChD,CAAC;gBACD,MAAM;YAER;gBACE,iDAAiD;gBACjD,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5D,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnD,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAEO,sBAAsB,CAAC,OAAyC;QACtE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;QAC7B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAEO,yBAAyB,CAAC,QAAqC;QACrE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,GAAG,CAAC,GAAG,IAAe;QAC5B,WAAW,CAAC,wBAAwB,EAAE,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/npm/esm/datalayer/checkout.d.ts

@@ -1,96 +0,0 @@
-/**
- * Checkout Tracking Module
- * Handles checkout funnel tracking (begin, progress, purchase)
- */
-import type { SelwiseDataLayer, DataLayerConfig, BasketProduct } from './types';
-interface CheckoutTrackerConfig {
-    siteKey: string;
-    tracker: {
-        track(name: string, args?: {
-            entityType?: string;
-            entityId?: string;
-            metadata?: Record<string, any>;
-        }): void;
-        getSessionId(): string;
-        getVisitorId(): string;
-    };
-    config: DataLayerConfig;
-    scheduleProcess: () => void;
-}
-interface CheckoutState {
-    step: number;
-    beganAt: number;
-    totalPrice?: number;
-    currency?: string;
-    productCount?: number;
-    products?: BasketProduct[];
-}
-export declare class CheckoutTracker {
-    private config;
-    private checkoutState;
-    private checkoutStorageKey;
-    constructor(config: CheckoutTrackerConfig);
-    /**
-     * Load checkout state from sessionStorage
-     */
-    private loadCheckoutState;
-    /**
-     * Save checkout state to sessionStorage
-     */
-    private saveCheckoutState;
-    /**
-     * Clear checkout state
-     */
-    private clearCheckoutState;
-    /**
-     * Track checkout begin event
-     */
-    trackCheckoutBegin(checkoutData: SelwiseDataLayer['checkout']): void;
-    /**
-     * Track checkout progress event
-     */
-    trackCheckoutProgress(checkoutData: SelwiseDataLayer['checkout']): void;
-    /**
-     * Track checkout option event (e.g., payment method selected)
-     */
-    trackCheckoutOption(checkoutData: SelwiseDataLayer['checkout']): void;
-    /**
-     * Track purchase event
-     */
-    trackPurchase(orderData: SelwiseDataLayer['order']): void;
-    /**
-     * Get human-readable step name
-     */
-    private getStepName;
-    /**
-     * Get option type from option value
-     */
-    private getOptionType;
-    private resolveProductItemCode;
-    private getProductItemCodes;
-    /**
-     * Auto-detect checkout step from URL
-     */
-    detectCheckoutStep(): number | null;
-    /**
-     * Auto-track checkout progress based on URL detection
-     */
-    autoTrackCheckoutStep(): void;
-    /**
-     * Process a data layer event for checkout tracking
-     */
-    processDataLayer(data: SelwiseDataLayer): void;
-    /**
-     * Get current checkout state
-     */
-    getCheckoutState(): CheckoutState | null;
-    /**
-     * Log in debug mode
-     */
-    private log;
-    /**
-     * Cleanup
-     */
-    destroy(): void;
-}
-export {};