@selwise/widget 0.0.2 → 1.0.0

package/dist/npm/esm/core/conflict-resolver.d.ts

@@ -1,96 +0,0 @@
-/**
- * Conflict Resolution Behavior
- */
-export type ConflictBehavior = 'highest_priority' | 'random' | 'all';
-/**
- * Widget conflict resolution configuration
- */
-export interface ConflictResolutionConfig {
-    priority: number;
-    behavior: ConflictBehavior;
-}
-/**
- * Widget/Campaign item for conflict resolution
- */
-export interface WidgetItem {
-    id: string;
-    type: 'campaign' | 'widget' | 'recommendation';
-    priority?: number;
-    conflictBehavior?: ConflictBehavior;
-    frequencyCapConfig?: any;
-    selector?: string;
-    placementPosition?: string;
-    scope?: string;
-    [key: string]: any;
-}
-/**
- * Conflict resolution result
- */
-export interface ConflictResolutionResult {
-    selected: WidgetItem[];
-    rejected: WidgetItem[];
-    reason: string;
-}
-/**
- * ConflictResolver
- *
- * Handles conflicts when multiple widgets compete for the same screen space.
- * Uses priority and behavior rules to determine which widgets to show.
- */
-export declare class ConflictResolver {
-    private normalizeSelector;
-    private normalizePlacementPosition;
-    private buildConflictScope;
-    /**
-     * Resolve conflicts between multiple widgets
-     *
-     * @param widgets - Array of widgets/campaigns competing for display
-     * @param selector - CSS selector of the target container (optional)
-     * @returns Resolution result with selected and rejected widgets
-     */
-    resolve(widgets: WidgetItem[], selector?: string): ConflictResolutionResult;
-    /**
-     * Select a random widget from the array
-     */
-    private selectRandom;
-    /**
-     * Check if widgets conflict (target the same scope)
-     *
-     * @param widgetA - First widget
-     * @param widgetB - Second widget
-     * @returns True if widgets conflict
-     */
-    widgetsConflict(widgetA: WidgetItem, widgetB: WidgetItem): boolean;
-    /**
-     * Group widgets by conflict groups
-     *
-     * @param widgets - Array of widgets
-     * @returns Array of conflict groups
-     */
-    groupByConflicts(widgets: WidgetItem[]): WidgetItem[][];
-    /**
-     * Resolve conflicts for multiple groups
-     *
-     * @param widgets - Array of all widgets
-     * @returns Array of resolution results
-     */
-    resolveAll(widgets: WidgetItem[]): ConflictResolutionResult[];
-    /**
-     * Parse conflict resolution config from widget data
-     *
-     * @param widget - Widget data
-     * @returns Conflict resolution config
-     */
-    parseConfig(widget: any): ConflictResolutionConfig;
-    /**
-     * Apply conflict resolution to widget data
-     *
-     * @param widget - Widget data
-     * @returns Widget data with conflict config
-     */
-    applyConfig(widget: WidgetItem): WidgetItem;
-}
-/**
- * Get the singleton ConflictResolver instance
- */
-export declare function getConflictResolver(): ConflictResolver;

package/dist/npm/esm/core/conflict-resolver.js

@@ -1,198 +0,0 @@
-/**
- * ConflictResolver
- *
- * Handles conflicts when multiple widgets compete for the same screen space.
- * Uses priority and behavior rules to determine which widgets to show.
- */
-export class ConflictResolver {
-    normalizeSelector(selector) {
-        if (!selector || typeof selector !== 'string')
-            return '';
-        return selector.trim().replace(/\s+/g, ' ').toLowerCase();
-    }
-    normalizePlacementPosition(position) {
-        if (!position || typeof position !== 'string')
-            return '';
-        return position.trim().toLowerCase();
-    }
-    buildConflictScope(widget) {
-        if (widget.scope && typeof widget.scope === 'string' && widget.scope.trim().length > 0) {
-            return widget.scope;
-        }
-        const normalizedSelector = this.normalizeSelector(widget.selector);
-        if (normalizedSelector) {
-            return `selector:${normalizedSelector}`;
-        }
-        const normalizedPosition = this.normalizePlacementPosition(widget.placementPosition);
-        if (normalizedPosition) {
-            return `fixed:${normalizedPosition}`;
-        }
-        return `entity:${widget.id}`;
-    }
-    /**
-     * Resolve conflicts between multiple widgets
-     *
-     * @param widgets - Array of widgets/campaigns competing for display
-     * @param selector - CSS selector of the target container (optional)
-     * @returns Resolution result with selected and rejected widgets
-     */
-    resolve(widgets, selector) {
-        if (widgets.length === 0) {
-            return { selected: [], rejected: [], reason: 'No widgets to resolve' };
-        }
-        if (widgets.length === 1) {
-            return {
-                selected: [widgets[0]],
-                rejected: [],
-                reason: 'Single widget, no conflict',
-            };
-        }
-        // Group widgets by behavior
-        const randomWidgets = widgets.filter((w) => w.conflictBehavior === 'random');
-        const allWidgets = widgets.filter((w) => w.conflictBehavior === 'all');
-        // If any widget has 'all' behavior, show all
-        if (allWidgets.length > 0) {
-            return {
-                selected: widgets,
-                rejected: [],
-                reason: 'All widgets shown (behavior=all)',
-            };
-        }
-        // If all widgets use 'random' behavior
-        if (randomWidgets.length === widgets.length) {
-            const selected = this.selectRandom(widgets);
-            return {
-                selected,
-                rejected: widgets.filter((w) => !selected.includes(w)),
-                reason: 'Random selection',
-            };
-        }
-        // Default: highest_priority behavior
-        // Sort by priority (descending) and select the highest
-        const sorted = [...widgets].sort((a, b) => {
-            const priorityA = a.priority ?? 0;
-            const priorityB = b.priority ?? 0;
-            if (priorityB !== priorityA) {
-                return priorityB - priorityA;
-            }
-            return a.id.localeCompare(b.id);
-        });
-        const highestPriority = sorted[0].priority ?? 0;
-        const tiedWidgets = sorted.filter((w) => (w.priority ?? 0) === highestPriority);
-        const selected = [tiedWidgets[0]];
-        return {
-            selected,
-            rejected: widgets.filter((w) => !selected.includes(w)),
-            reason: `Highest priority (${highestPriority})`,
-        };
-    }
-    /**
-     * Select a random widget from the array
-     */
-    selectRandom(widgets) {
-        if (widgets.length === 0)
-            return [];
-        if (widgets.length === 1)
-            return [widgets[0]];
-        // Fisher-Yates shuffle (partial - just need one)
-        const randomIndex = Math.floor(Math.random() * widgets.length);
-        return [widgets[randomIndex]];
-    }
-    /**
-     * Check if widgets conflict (target the same scope)
-     *
-     * @param widgetA - First widget
-     * @param widgetB - Second widget
-     * @returns True if widgets conflict
-     */
-    widgetsConflict(widgetA, widgetB) {
-        const scopeA = this.buildConflictScope(widgetA);
-        const scopeB = this.buildConflictScope(widgetB);
-        return scopeA === scopeB;
-    }
-    /**
-     * Group widgets by conflict groups
-     *
-     * @param widgets - Array of widgets
-     * @returns Array of conflict groups
-     */
-    groupByConflicts(widgets) {
-        const groups = [];
-        const processed = new Set();
-        for (const widget of widgets) {
-            if (processed.has(widget.id))
-                continue;
-            const conflictGroup = [widget];
-            processed.add(widget.id);
-            // Find all widgets that conflict with this one
-            for (const other of widgets) {
-                if (other.id === widget.id || processed.has(other.id))
-                    continue;
-                if (this.widgetsConflict(widget, other)) {
-                    conflictGroup.push(other);
-                    processed.add(other.id);
-                }
-            }
-            if (conflictGroup.length > 1) {
-                groups.push(conflictGroup);
-            }
-            else {
-                // No conflicts, single widget group
-                groups.push([widget]);
-            }
-        }
-        return groups;
-    }
-    /**
-     * Resolve conflicts for multiple groups
-     *
-     * @param widgets - Array of all widgets
-     * @returns Array of resolution results
-     */
-    resolveAll(widgets) {
-        const groups = this.groupByConflicts(widgets);
-        return groups.map((group) => this.resolve(group));
-    }
-    /**
-     * Parse conflict resolution config from widget data
-     *
-     * @param widget - Widget data
-     * @returns Conflict resolution config
-     */
-    parseConfig(widget) {
-        const placementConfig = widget.placementConfigJson || widget.placementConfig || {};
-        const conflictResolution = placementConfig.conflictResolution || {};
-        return {
-            priority: widget.priority ?? conflictResolution.priority ?? 0,
-            behavior: conflictResolution.behavior || 'highest_priority',
-        };
-    }
-    /**
-     * Apply conflict resolution to widget data
-     *
-     * @param widget - Widget data
-     * @returns Widget data with conflict config
-     */
-    applyConfig(widget) {
-        const config = this.parseConfig(widget);
-        const scope = this.buildConflictScope(widget);
-        return {
-            ...widget,
-            scope,
-            priority: config.priority,
-            conflictBehavior: config.behavior,
-        };
-    }
-}
-// Singleton instance
-let conflictResolverInstance = null;
-/**
- * Get the singleton ConflictResolver instance
- */
-export function getConflictResolver() {
-    if (!conflictResolverInstance) {
-        conflictResolverInstance = new ConflictResolver();
-    }
-    return conflictResolverInstance;
-}
-//# sourceMappingURL=conflict-resolver.js.map

package/dist/npm/esm/core/conflict-resolver.js.map

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

package/dist/npm/esm/core/event-batcher.d.ts

@@ -1,253 +0,0 @@
-/**
- * Event Batcher
- * Advanced event batching with offline support and retry logic
- * Now with consent-based event filtering
- */
-export interface EventBatch {
-    eventId: string;
-    eventSchemaVersion?: number;
-    eventTs?: number;
-    name: string;
-    entityType: string;
-    entityId?: string;
-    productItemCode?: string;
-    metadata?: Record<string, any>;
-    timestamp: number;
-    retryCount?: number;
-    correlationId?: string;
-    parentEventId?: string;
-    journeyId?: string;
-    journeySequence?: number;
-}
-export interface EventBatcherConfig {
-    apiUrl?: string;
-    siteKey?: string;
-    sessionId?: string;
-    visitorId?: string;
-    siteUserId?: string;
-    batchSize?: number;
-    flushInterval?: number;
-    enablePersistence?: boolean;
-    enableSendBeacon?: boolean;
-    maxRetries?: number;
-    maxQueueSize?: number;
-    maxStorageEvents?: number;
-    debugMode?: boolean;
-}
-export declare class EventBatcher {
-    private queue;
-    private consentQueue;
-    private flushTimeout;
-    private pageHideHandler;
-    private cleanupInterval?;
-    private isFlushing;
-    private consentChecked;
-    private consentGranted;
-    private useIndexedDBForConsent;
-    private config;
-    private maxRetries;
-    private maxQueueSize;
-    private maxStorageEvents;
-    private debugMode;
-    private sessionData;
-    private processedEvents;
-    private lastEventId;
-    private journeyEventCount;
-    private overflowStorage;
-    private tabCorrelationId;
-    private metrics;
-    private initialized;
-    constructor(config?: EventBatcherConfig);
-    /**
-     * Asynchronous initialization - must be called after constructor
-     * This loads events from IndexedDB overflow storage and immediately flushes them
-     *
-     * IMPORTANT: Call this after creating EventBatcher instance
-     */
-    initialize(): Promise<void>;
-    /**
-     * Check if the batcher has been initialized
-     */
-    isReady(): boolean;
-    setSessionData(sessionId: string, visitorId: string, siteUserId?: string): void;
-    setSiteKey(siteKey: string): void;
-    /**
-     * Update configuration dynamically (e.g., after fetching from server)
-     */
-    updateConfig(config: Partial<EventBatcherConfig>): void;
-    /**
-     * Add an event to the batch queue
-     * Checks consent before adding - queues events if consent pending
-     * Populates correlation fields for attribution tracking
-     */
-    add(event: EventBatch): void;
-    /**
-     * Check if an event can be sent based on current consent state
-     */
-    private checkConsentForEvent;
-    /**
-     * Schedule a flush after the configured interval
-     */
-    private scheduleFlush;
-    /**
-     * Flush all queued events to the server
-     */
-    flush(): Promise<void>;
-    /**
-     * Send batch to server
-     * Returns true if successful, false otherwise
-     * Only increments journey counter on confirmed success
-     */
-    private sendBatch;
-    /**
-     * Re-queue events with exponential backoff
-     * Uses overflow storage instead of dropping events when queue is full
-     */
-    private requeueEvents;
-    /**
-     * Setup page hide handler for send beacon
-     *
-     * KNOWN LIMITATION: sendBeacon doesn't provide success/failure feedback.
-     * - The browser returns true if it accepted the payload, NOT if server received it
-     * - Network failures after browser acceptance are undetectable
-     * - Journey sequence counter is NOT incremented (see persistPendingJourneyIncrement)
-     * - Sequence numbers from sendBeacon may not match actual server-side sequences
-     *
-     * This is a fundamental limitation of the sendBeacon API with no workaround.
-     */
-    private setupPageHideHandler;
-    /**
-     * Persist pending journey counter increment to localStorage
-     *
-     * KNOWN LIMITATION: sendBeacon doesn't provide success/failure feedback.
-     * The browser queues the request but we can't know if it reached the server.
-     *
-     * We do NOT increment the journey counter here because:
-     * 1. sendBeacon may fail silently (network, server error, queue full)
-     * 2. Counter increment would cause permanent gaps in sequence numbers
-     * 3. There's no server validation endpoint to confirm receipt
-     *
-     * Consequence: On page hide, journey sequence numbers may not match
-     * server-side sequences. This is accepted as a known limitation of
-     * the sendBeacon API.
-     */
-    private persistPendingJourneyIncrement;
-    /**
-     * Check and recover pending journey increment on initialization
-     * If server confirmed receipt, the increment is valid
-     * Otherwise we need to roll back
-     */
-    private recoverPendingJourneyIncrement;
-    /**
-     * Save queue to localStorage for offline persistence
-     * Includes quota checking to prevent quota exhaustion DoS
-     */
-    private saveToStorage;
-    /**
-     * Check if we have enough storage quota for Selwise data
-     * Returns false if quota would be exceeded (prevents DoS via quota exhaustion)
-     */
-    private checkStorageQuota;
-    /**
-     * Cleanup old Selwise storage items to free up quota
-     */
-    private cleanupOldStorage;
-    /**
-     * Load queue from localStorage
-     */
-    private loadFromStorage;
-    /**
-     * Get queue size
-     */
-    getQueueSize(): number;
-    /**
-     * Get processed events count
-     */
-    getProcessedCount(): number;
-    /**
-     * Clear all queued events
-     */
-    clear(): void;
-    /**
-     * Reset correlation tracking for new attribution journey
-     * Call this after a conversion event to start fresh attribution
-     */
-    resetCorrelation(): void;
-    /**
-     * Get consent queue size
-     */
-    getConsentQueueSize(): number;
-    /**
-     * Flush consent queue - called when user grants consent
-     * Re-evaluates each queued event and adds to main queue if consented
-     */
-    flushConsentQueue(): void;
-    /**
-     * Cleanup
-     */
-    destroy(): void;
-    /**
-     * Start periodic cleanup of processed events set
-     */
-    private startCleanupInterval;
-    /**
-     * Cleanup old processed event IDs to prevent memory growth
-     *
-     * NOTE: After 10000 events, old event IDs can be re-sent and may create duplicates.
-     * This is a known limitation - the deduplication Set is kept to a reasonable size
-     * to prevent memory issues while still providing good duplicate detection for
-     * typical user sessions.
-     *
-     * Server-side deduplication cache provides additional protection.
-     */
-    private cleanupProcessedEvents;
-    private generateSessionId;
-    private generateVisitorId;
-    /**
-     * Generate tab-specific correlation ID
-     * This prevents correlation ID collisions between multiple tabs
-     */
-    private generateTabCorrelationId;
-    /**
-     * Store events in IndexedDB overflow storage
-     * Non-blocking - errors are logged but don't throw
-     */
-    private storeInOverflow;
-    /**
-     * Load events from IndexedDB overflow storage
-     * Called during initialization to recover persisted events
-     */
-    private loadFromOverflowStorage;
-    /**
-     * Get metrics for monitoring
-     */
-    getMetrics(): {
-        eventsDropped: number;
-        batchesFailed: number;
-        sendBeaconFailed: number;
-        overflowStored: number;
-        queueSize: number;
-        processedCount: number;
-        consentQueueSize: number;
-        overflowStats: {
-            count: number;
-            oldestTimestamp: number | null;
-        };
-    };
-    /**
-     * Get overflow storage stats (async)
-     */
-    getOverflowStats(): Promise<{
-        count: number;
-        oldestTimestamp: number | null;
-    }>;
-    /**
-     * Report metric to monitoring endpoint
-     * Non-blocking - failures are ignored
-     */
-    private reportMetric;
-    /**
-     * Send all accumulated metrics to monitoring endpoint
-     */
-    flushMetrics(): Promise<void>;
-}