@selwise/widget 0.0.1

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

@@ -0,0 +1,222 @@
+/**
+ * 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

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

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

@@ -0,0 +1,96 @@
+/**
+ * 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 {};