@selwise/widget 0.0.1

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

@@ -0,0 +1,94 @@
+/**
+ * Page Tracking Module
+ * Handles page view tracking and automatic page type detection
+ */
+import type { SelwiseDataLayer, DataLayerConfig, PageType } from './types';
+interface PageTrackerConfig {
+    siteKey: string;
+    tracker: {
+        track(name: string, args?: {
+            entityType?: string;
+            entityId?: string;
+            metadata?: Record<string, any>;
+        }): void;
+        getSessionId(): string;
+        getVisitorId(): string;
+    };
+    config: DataLayerConfig;
+    scheduleProcess: () => void;
+}
+export declare class PageTracker {
+    private config;
+    private lastTrackedUrl;
+    private titleObserver;
+    constructor(config: PageTrackerConfig);
+    /**
+     * Setup observer for title changes (SPA navigation indicator)
+     */
+    private setupTitleObserver;
+    /**
+     * Maybe track page view if URL has changed
+     */
+    private maybeTrackPageView;
+    /**
+     * Detect page type from URL patterns
+     */
+    detectPageType(): PageType;
+    /**
+     * Detect page type from DOM elements
+     */
+    private detectPageTypeFromDom;
+    /**
+     * Extract page metadata
+     */
+    private getPageMetadata;
+    /**
+     * Extract product information from DOM (product pages)
+     */
+    private extractProductInfoFromDom;
+    /**
+     * Extract category information from DOM (category pages)
+     */
+    private extractCategoryInfoFromDom;
+    /**
+     * Get meta tag content by name or property
+     */
+    private getMetaContent;
+    /**
+     * Track a page view event
+     */
+    trackPageView(customData?: SelwiseDataLayer): void;
+    /**
+     * Store last page type in sessionStorage
+     */
+    private storeLastPageType;
+    /**
+     * Get last page type from sessionStorage
+     */
+    getLastPageType(): PageType | null;
+    /**
+     * Process a data layer event for page tracking
+     */
+    processDataLayer(data: SelwiseDataLayer): void;
+    /**
+     * Track a virtual page view (for SPAs without URL changes)
+     */
+    private trackVirtualPageView;
+    /**
+     * Increment page view count for session
+     */
+    incrementPageViewCount(): number;
+    /**
+     * Get current page view count
+     */
+    getPageViewCount(): number;
+    /**
+     * Log in debug mode
+     */
+    private log;
+    /**
+     * Cleanup
+     */
+    destroy(): void;
+}
+export {};

package/dist/npm/esm/datalayer/page.js

@@ -0,0 +1,339 @@
+/**
+ * Page Tracking Module
+ * Handles page view tracking and automatic page type detection
+ */
+import { PAGE_TYPES, DEFAULT_PAGE_PATTERNS, DATA_SOURCE, STORAGE_KEYS } from './constants.js';
+import { testModeLog } from '../utils/logger.js';
+export class PageTracker {
+    constructor(config) {
+        this.lastTrackedUrl = '';
+        this.titleObserver = null;
+        this.config = config;
+        this.setupTitleObserver();
+    }
+    /**
+     * Setup observer for title changes (SPA navigation indicator)
+     */
+    setupTitleObserver() {
+        const titleElement = document.querySelector('title');
+        if (!titleElement)
+            return;
+        this.titleObserver = new MutationObserver(() => {
+            // Title changed, likely a page navigation
+            this.maybeTrackPageView();
+        });
+        this.titleObserver.observe(titleElement, { subtree: true, characterData: true, childList: true });
+    }
+    /**
+     * Maybe track page view if URL has changed
+     */
+    maybeTrackPageView() {
+        const currentUrl = window.location.href;
+        if (currentUrl !== this.lastTrackedUrl) {
+            this.trackPageView();
+        }
+    }
+    /**
+     * Detect page type from URL patterns
+     */
+    detectPageType() {
+        const path = window.location.pathname;
+        const searchParams = window.location.search;
+        const fullUrl = path + searchParams;
+        // Check against configured patterns (server config overrides defaults)
+        const patterns = this.config.config.pageTypePatterns || DEFAULT_PAGE_PATTERNS;
+        // Check each pattern in priority order
+        for (const [type, pattern] of Object.entries(patterns)) {
+            // Convert string patterns to RegExp if needed
+            const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
+            if (regex.test(fullUrl)) {
+                return type;
+            }
+        }
+        // Check DOM-based detection as fallback
+        const domType = this.detectPageTypeFromDom();
+        if (domType) {
+            return domType;
+        }
+        return PAGE_TYPES.OTHER;
+    }
+    /**
+     * Detect page type from DOM elements
+     */
+    detectPageTypeFromDom() {
+        // Check body classes
+        const bodyClass = document.body.className.toLowerCase();
+        if (bodyClass.includes('product') || bodyClass.includes('item')) {
+            return PAGE_TYPES.PRODUCT;
+        }
+        if (bodyClass.includes('category') || bodyClass.includes('collection') || bodyClass.includes('catalog')) {
+            return PAGE_TYPES.CATEGORY;
+        }
+        if (bodyClass.includes('checkout')) {
+            return PAGE_TYPES.CHECKOUT;
+        }
+        if (bodyClass.includes('cart') || bodyClass.includes('basket')) {
+            return PAGE_TYPES.CART;
+        }
+        if (bodyClass.includes('account') || bodyClass.includes('profile') || bodyClass.includes('my-account')) {
+            return PAGE_TYPES.ACCOUNT;
+        }
+        // Check for structured data (Schema.org)
+        const productSchema = document.querySelector('[itemtype*="Product"]');
+        if (productSchema) {
+            return PAGE_TYPES.PRODUCT;
+        }
+        return null;
+    }
+    /**
+     * Extract page metadata
+     */
+    getPageMetadata(pageType) {
+        const metadata = {
+            dataSource: DATA_SOURCE,
+            pageUrl: window.location.href,
+            referrer: document.referrer,
+            timestamp: Date.now(),
+        };
+        // Page type info
+        metadata.pageType = pageType;
+        metadata.pageTitle = document.title;
+        metadata.pagePath = window.location.pathname;
+        metadata.pageSearch = window.location.search;
+        metadata.pageHash = window.location.hash;
+        // Language
+        metadata.language = document.documentElement.lang || navigator.language || 'en';
+        // Extract product info if on product page
+        if (pageType === PAGE_TYPES.PRODUCT) {
+            const productInfo = this.extractProductInfoFromDom();
+            if (productInfo) {
+                metadata.productInfo = productInfo;
+            }
+        }
+        // Extract category info if on category page
+        if (pageType === PAGE_TYPES.CATEGORY) {
+            const categoryInfo = this.extractCategoryInfoFromDom();
+            if (categoryInfo) {
+                metadata.categoryInfo = categoryInfo;
+            }
+        }
+        return metadata;
+    }
+    /**
+     * Extract product information from DOM (product pages)
+     */
+    extractProductInfoFromDom() {
+        // Try Schema.org structured data
+        const schemaScript = document.querySelector('script[type="application/ld+json"]');
+        if (schemaScript) {
+            try {
+                const schema = JSON.parse(schemaScript.textContent || '{}');
+                if (schema['@type'] === 'Product') {
+                    return {
+                        productItemCode: schema.productID || schema.sku || undefined,
+                        name: schema.name,
+                        price: schema.offers?.price || undefined,
+                        currency: schema.offers?.priceCurrency || undefined,
+                        availability: schema.offers?.availability || undefined,
+                    };
+                }
+            }
+            catch {
+                // Invalid JSON, continue
+            }
+        }
+        // Try meta tags (Open Graph, Product meta)
+        const productItemCode = this.getMetaContent('product:product_id') ||
+            this.getMetaContent('product:id') ||
+            this.getMetaContent('product:upc');
+        const name = this.getMetaContent('og:title') ||
+            this.getMetaContent('product:name') ||
+            this.getMetaContent('twitter:title');
+        const price = this.getMetaContent('product:price:amount') ||
+            this.getMetaContent('product:price') ||
+            this.getMetaContent('og:price:amount');
+        const currency = this.getMetaContent('product:price:currency') ||
+            this.getMetaContent('og:price:currency');
+        if (name || productItemCode) {
+            return { productItemCode, name, price, currency };
+        }
+        return null;
+    }
+    /**
+     * Extract category information from DOM (category pages)
+     */
+    extractCategoryInfoFromDom() {
+        // Try meta tags
+        const category = this.getMetaContent('category') ||
+            this.getMetaContent('product:category') ||
+            this.getMetaContent('og:type');
+        // Try breadcrumb
+        const breadcrumb = document.querySelector('[itemtype*="BreadcrumbList"]');
+        if (breadcrumb) {
+            const items = breadcrumb.querySelectorAll('[itemprop="itemListElement"]');
+            const categories = [];
+            items.forEach((item) => {
+                const name = item.querySelector('[itemprop="name"]')?.textContent;
+                if (name) {
+                    categories.push(name);
+                }
+            });
+            if (categories.length > 0) {
+                return { category, categories };
+            }
+        }
+        if (category) {
+            return { category, categories: [category] };
+        }
+        return null;
+    }
+    /**
+     * Get meta tag content by name or property
+     */
+    getMetaContent(attr) {
+        // Try by name
+        let meta = document.querySelector(`meta[name="${attr}"]`);
+        if (meta)
+            return meta.getAttribute('content') || undefined;
+        // Try by property
+        meta = document.querySelector(`meta[property="${attr}"]`);
+        if (meta)
+            return meta.getAttribute('content') || undefined;
+        return undefined;
+    }
+    /**
+     * Track a page view event
+     */
+    trackPageView(customData) {
+        const currentUrl = window.location.href;
+        // Prevent duplicate tracking of same URL
+        if (currentUrl === this.lastTrackedUrl && !customData) {
+            return;
+        }
+        this.lastTrackedUrl = currentUrl;
+        const detectedPageType = this.detectPageType();
+        const pageType = (customData?.page?.type || detectedPageType);
+        const metadata = this.getPageMetadata(pageType);
+        // Merge with custom data if provided
+        if (customData?.page) {
+            Object.assign(metadata, {
+                pageTitle: customData.page.title || metadata.pageTitle,
+                pageType: customData.page.type || metadata.pageType,
+                categories: customData.page.categories,
+                tags: customData.page.tags,
+                params: customData.page.params,
+            });
+        }
+        // Track the event
+        this.config.tracker.track('page_view', {
+            entityType: 'page',
+            entityId: pageType,
+            metadata,
+        });
+        this.log('Tracked page_view:', pageType, metadata);
+        // Store last page type for session tracking
+        this.storeLastPageType(pageType);
+    }
+    /**
+     * Store last page type in sessionStorage
+     */
+    storeLastPageType(pageType) {
+        try {
+            sessionStorage.setItem(STORAGE_KEYS.LAST_PAGE_TYPE, pageType);
+        }
+        catch {
+            // Ignore storage errors
+        }
+    }
+    /**
+     * Get last page type from sessionStorage
+     */
+    getLastPageType() {
+        try {
+            const stored = sessionStorage.getItem(STORAGE_KEYS.LAST_PAGE_TYPE);
+            return stored || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Process a data layer event for page tracking
+     */
+    processDataLayer(data) {
+        if (data.event === 'virtual_page_view') {
+            // Virtual page view - use custom URL from data
+            this.trackVirtualPageView(data);
+        }
+        else {
+            this.trackPageView(data);
+        }
+    }
+    /**
+     * Track a virtual page view (for SPAs without URL changes)
+     */
+    trackVirtualPageView(data) {
+        const pageType = data.page?.type || this.detectPageType();
+        const metadata = {
+            dataSource: DATA_SOURCE,
+            pageUrl: data.page?.url || window.location.href,
+            referrer: data.page?.referrer || document.referrer,
+            timestamp: Date.now(),
+            pageTitle: data.page?.title || document.title,
+            pagePath: data.page?.path || window.location.pathname,
+            pageType,
+            virtual: true,
+            categories: data.page?.categories,
+            tags: data.page?.tags,
+            params: data.page?.params,
+        };
+        this.config.tracker.track('virtual_page_view', {
+            entityType: 'page',
+            entityId: pageType,
+            metadata,
+        });
+        this.log('Tracked virtual_page_view:', pageType, metadata);
+        // Don't update lastTrackedUrl for virtual views since URL didn't change
+    }
+    /**
+     * Increment page view count for session
+     */
+    incrementPageViewCount() {
+        try {
+            const current = parseInt(sessionStorage.getItem(STORAGE_KEYS.PAGE_VIEW_COUNT) || '0', 10);
+            const next = current + 1;
+            sessionStorage.setItem(STORAGE_KEYS.PAGE_VIEW_COUNT, next.toString());
+            return next;
+        }
+        catch {
+            return 1;
+        }
+    }
+    /**
+     * Get current page view count
+     */
+    getPageViewCount() {
+        try {
+            return parseInt(sessionStorage.getItem(STORAGE_KEYS.PAGE_VIEW_COUNT) || '0', 10);
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Log in debug mode
+     */
+    log(...args) {
+        testModeLog('PageTracker', ...args);
+    }
+    /**
+     * Cleanup
+     */
+    destroy() {
+        if (this.titleObserver) {
+            this.titleObserver.disconnect();
+            this.titleObserver = null;
+        }
+    }
+}
+//# sourceMappingURL=page.js.map

package/dist/npm/esm/datalayer/page.js.map

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

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

@@ -0,0 +1,133 @@
+/**
+ * Product Tracking Module
+ * Handles product view, click, and impression tracking
+ */
+import type { SelwiseDataLayer, DataLayerConfig } from './types';
+interface ProductTrackerConfig {
+    siteKey: string;
+    apiUrl: string;
+    tracker: {
+        track(name: string, args?: {
+            entityType?: string;
+            entityId?: string;
+            metadata?: Record<string, any>;
+        }): void;
+        getSessionId(): string;
+        getVisitorId(): string;
+    };
+    config: DataLayerConfig;
+    scheduleProcess: () => void;
+}
+export declare class ProductTracker {
+    private config;
+    private lastTrackedProduct;
+    private impressionObserver;
+    private trackedProducts;
+    private dwellTimeStartTime;
+    private dwellTimeAccumulated;
+    private visibilityHandler;
+    private beforeUnloadHandler;
+    private pageHideHandler;
+    constructor(config: ProductTrackerConfig);
+    /**
+     * Check if current page is a product page
+     */
+    isProductPage(): boolean;
+    /**
+     * Extract product data from DOM
+     */
+    extractProductFromDom(): {
+        productItemCode: string;
+        title?: string;
+        price?: number;
+        category?: string;
+    } | null;
+    /**
+     * Extract from Schema.org structured data
+     */
+    private extractFromSchema;
+    /**
+     * Parse product from Schema.org data
+     * Prioritizes SKU as the primary product identifier
+     */
+    private parseSchemaProduct;
+    /**
+     * Extract from Open Graph / meta tags
+     * Prioritizes SKU as the primary product identifier
+     */
+    private extractFromMetaTags;
+    /**
+     * Extract from data attributes
+     * Prioritizes SKU as the primary product identifier
+     */
+    private extractFromDataAttributes;
+    /**
+     * Track a product view event
+     * Uses SKU (productItemCode) as the primary product identifier
+     */
+    trackProductView(productData?: SelwiseDataLayer['product']): void;
+    /**
+     * Track a product click event
+     * Uses SKU (productItemCode) as the primary product identifier
+     */
+    trackProductClick(productData: SelwiseDataLayer['product']): void;
+    /**
+     * Track product impressions for a list of products
+     * Uses SKU (productItemCode) as the primary product identifier
+     */
+    trackProductImpressions(products: Array<{
+        sku?: string;
+        title?: string;
+        price?: number;
+        position?: number;
+    }>): void;
+    /**
+     * Setup intersection observer for automatic impression tracking
+     * Uses SKU (productItemCode) as the primary product identifier
+     */
+    setupImpressionTracking(selector?: string): void;
+    /**
+     * Start tracking dwell time for product view using Page Visibility API
+     */
+    startDwellTimeTracking(): void;
+    /**
+     * Handle visibility change (Page Visibility API)
+     * Pauses tracking when page is hidden, resumes when visible
+     */
+    private handleVisibilityChange;
+    /**
+     * Handle before unload - send final dwell time event
+     */
+    private handleBeforeUnload;
+    /**
+     * Handle page hide event (more reliable than beforeunload in modern browsers)
+     */
+    private handlePageHide;
+    /**
+     * Get total dwell time in milliseconds
+     */
+    private getTotalDwellTime;
+    /**
+     * Stop dwell time tracking and send the dwell time event
+     * Called when navigating away from product page (SPA navigation)
+     */
+    stopDwellTimeTracking(): void;
+    /**
+     * Process a data layer event for product tracking
+     * Uses SKU (productItemCode) as the primary product identifier
+     */
+    processDataLayer(data: SelwiseDataLayer): void;
+    /**
+     * Clear tracked products cache
+     */
+    clearTrackedProducts(): void;
+    /**
+     * Log in debug mode
+     */
+    private log;
+    /**
+     * Cleanup
+     */
+    destroy(): void;
+}
+export {};