@selwise/widget 0.0.1

package/dist/npm/esm/core/experiments.js.map

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

package/dist/npm/esm/core/frequency-caps.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Frequency Cap Configuration
+ *
+ * Controls how often a widget/campaign is shown to a user
+ *
+ * @example
+ * {
+ *   perSession: 1,      // Show once per session
+ *   perDay: 3,          // Show max 3 times per day
+ *   perWeek: 10,        // Show max 10 times per week
+ *   total: 50,          // Show max 50 times total
+ *   minInterval: '1h',  // Wait 1 hour between shows
+ * }
+ */
+export interface FrequencyCapConfig {
+    perSession?: number;
+    perDay?: number;
+    perWeek?: number;
+    total?: number;
+    minInterval?: string;
+}
+/**
+ * Widget display tracking data
+ */
+interface WidgetDisplayData {
+    sessionCount: number;
+    dayCount: number;
+    weekCount: number;
+    totalCount: number;
+    lastShownAt?: string;
+    sessionStart: string;
+    dayStart: string;
+    weekStart: string;
+}
+/**
+ * Frequency Cap Check Result
+ */
+export interface FrequencyCapCheckResult {
+    allowed: boolean;
+    reason?: string;
+    currentCount?: number;
+    limit?: number;
+    nextShowAt?: Date;
+}
+/**
+ * FrequencyCapManager
+ *
+ * Manages frequency caps for widgets/campaigns on the client side.
+ * Tracks display counts in localStorage and enforces limits.
+ */
+export declare class FrequencyCapManager {
+    private storageKey;
+    private sessionId;
+    private sessionStart;
+    constructor();
+    /**
+     * Parse min interval string to milliseconds
+     */
+    private parseInterval;
+    /**
+     * Get the current storage data
+     */
+    private getStorage;
+    /**
+     * Save storage data
+     */
+    private setStorage;
+    /**
+     * Reset counters when session/day/week changes
+     */
+    private resetCountersIfNeeded;
+    /**
+     * Get ISO week number
+     */
+    private getWeekNumber;
+    /**
+     * Get ISO week number (1-53)
+     */
+    private getIsoWeek;
+    /**
+     * Get or create widget display data
+     */
+    private getWidgetData;
+    /**
+     * Check if a widget can be shown according to its frequency cap
+     *
+     * @param widgetId - Widget or campaign ID
+     * @param config - Frequency cap configuration
+     * @returns Check result with allowed flag and optional reason
+     */
+    canShow(widgetId: string, config: FrequencyCapConfig): FrequencyCapCheckResult;
+    /**
+     * Record that a widget was shown
+     *
+     * @param widgetId - Widget or campaign ID
+     */
+    recordShown(widgetId: string): void;
+    /**
+     * Get current display counts for a widget
+     *
+     * @param widgetId - Widget or campaign ID
+     * @returns Display data or null if not found
+     */
+    getDisplayCounts(widgetId: string): WidgetDisplayData | null;
+    /**
+     * Reset tracking for a widget (useful for testing)
+     *
+     * @param widgetId - Widget or campaign ID
+     */
+    reset(widgetId: string): void;
+    /**
+     * Reset all tracking (useful for testing)
+     */
+    resetAll(): void;
+    /**
+     * Clean up old widget data (remove widgets not shown in 30 days)
+     */
+    cleanup(): void;
+}
+/**
+ * Get the singleton FrequencyCapManager instance
+ */
+export declare function getFrequencyCapManager(): FrequencyCapManager;
+export {};

package/dist/npm/esm/core/frequency-caps.js

@@ -0,0 +1,292 @@
+import { STORAGE_KEYS } from '../constants.js';
+import { testModeWarn } from '../utils/logger.js';
+import { validateFrequencyInterval } from '../modules/contract/tracking-contract.js';
+/**
+ * FrequencyCapManager
+ *
+ * Manages frequency caps for widgets/campaigns on the client side.
+ * Tracks display counts in localStorage and enforces limits.
+ */
+export class FrequencyCapManager {
+    constructor() {
+        this.storageKey = STORAGE_KEYS.FREQUENCY_CAPS;
+        this.sessionStart = Date.now();
+        // Get or create session ID
+        this.sessionId =
+            (sessionStorage.getItem(STORAGE_KEYS.SESSION_ID) ||
+                localStorage.getItem(STORAGE_KEYS.SESSION_ID)) ||
+                '';
+    }
+    /**
+     * Parse min interval string to milliseconds
+     */
+    parseInterval(interval) {
+        if (!validateFrequencyInterval(interval)) {
+            return 0;
+        }
+        const match = interval.match(/^(\d+)([hmdw])$/);
+        if (!match)
+            return 0;
+        const value = parseInt(match[1], 10);
+        const unit = match[2];
+        switch (unit) {
+            case 'h':
+                return value * 60 * 60 * 1000;
+            case 'm':
+                return value * 60 * 1000;
+            case 'd':
+                return value * 24 * 60 * 60 * 1000;
+            case 'w':
+                return value * 7 * 24 * 60 * 60 * 1000;
+            default:
+                return 0;
+        }
+    }
+    /**
+     * Get the current storage data
+     */
+    getStorage() {
+        try {
+            const data = localStorage.getItem(this.storageKey);
+            return data ? JSON.parse(data) : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Save storage data
+     */
+    setStorage(data) {
+        try {
+            localStorage.setItem(this.storageKey, JSON.stringify(data));
+        }
+        catch (e) {
+            // Storage might be full or disabled
+            testModeWarn('FrequencyCapManager', 'Could not save to localStorage:', e);
+        }
+    }
+    /**
+     * Reset counters when session/day/week changes
+     */
+    resetCountersIfNeeded(data) {
+        const now = Date.now();
+        const sessionStart = new Date(data.sessionStart).getTime();
+        const dayStart = new Date(data.dayStart).getTime();
+        const weekStart = new Date(data.weekStart).getTime();
+        // Check if session changed (sessionStorage was cleared or different)
+        if (now - sessionStart > 30 * 60 * 1000) {
+            // 30 minutes without activity = new session
+            data.sessionCount = 0;
+            data.sessionStart = new Date(now).toISOString();
+        }
+        // Check if day changed
+        const currentDay = new Date(now).toDateString();
+        const storedDay = new Date(dayStart).toDateString();
+        if (currentDay !== storedDay) {
+            data.dayCount = 0;
+            data.dayStart = new Date(now).toISOString();
+        }
+        // Check if week changed
+        const currentWeek = this.getWeekNumber(now);
+        const storedWeek = this.getWeekNumber(weekStart);
+        if (currentWeek !== storedWeek) {
+            data.weekCount = 0;
+            data.weekStart = new Date(now).toISOString();
+        }
+        return data;
+    }
+    /**
+     * Get ISO week number
+     */
+    getWeekNumber(timestamp) {
+        const date = new Date(timestamp);
+        const year = date.getFullYear();
+        const week = this.getIsoWeek(date);
+        return `${year}-W${week}`;
+    }
+    /**
+     * Get ISO week number (1-53)
+     */
+    getIsoWeek(date) {
+        const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+        const dayNum = d.getUTCDay() || 7;
+        d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+        const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+        return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+    }
+    /**
+     * Get or create widget display data
+     */
+    getWidgetData(widgetId) {
+        const storage = this.getStorage();
+        const now = Date.now();
+        if (!storage[widgetId]) {
+            // Initialize new widget data
+            const newData = {
+                sessionCount: 0,
+                dayCount: 0,
+                weekCount: 0,
+                totalCount: 0,
+                sessionStart: new Date(now).toISOString(),
+                dayStart: new Date(now).toISOString(),
+                weekStart: new Date(now).toISOString(),
+            };
+            storage[widgetId] = newData;
+            this.setStorage(storage);
+            return newData;
+        }
+        // Reset counters if needed
+        const data = this.resetCountersIfNeeded(storage[widgetId]);
+        storage[widgetId] = data;
+        this.setStorage(storage);
+        return data;
+    }
+    /**
+     * Check if a widget can be shown according to its frequency cap
+     *
+     * @param widgetId - Widget or campaign ID
+     * @param config - Frequency cap configuration
+     * @returns Check result with allowed flag and optional reason
+     */
+    canShow(widgetId, config) {
+        // No config = no restrictions
+        if (!config || Object.keys(config).length === 0) {
+            return { allowed: true };
+        }
+        const data = this.getWidgetData(widgetId);
+        // Check per session limit
+        if (config.perSession !== undefined && data.sessionCount >= config.perSession) {
+            return {
+                allowed: false,
+                reason: 'perSession',
+                currentCount: data.sessionCount,
+                limit: config.perSession,
+            };
+        }
+        // Check per day limit
+        if (config.perDay !== undefined && data.dayCount >= config.perDay) {
+            return {
+                allowed: false,
+                reason: 'perDay',
+                currentCount: data.dayCount,
+                limit: config.perDay,
+            };
+        }
+        // Check per week limit
+        if (config.perWeek !== undefined && data.weekCount >= config.perWeek) {
+            return {
+                allowed: false,
+                reason: 'perWeek',
+                currentCount: data.weekCount,
+                limit: config.perWeek,
+            };
+        }
+        // Check total limit
+        if (config.total !== undefined && data.totalCount >= config.total) {
+            return {
+                allowed: false,
+                reason: 'total',
+                currentCount: data.totalCount,
+                limit: config.total,
+            };
+        }
+        // Check min interval
+        if (config.minInterval && data.lastShownAt) {
+            const lastShown = new Date(data.lastShownAt).getTime();
+            const minIntervalMs = this.parseInterval(config.minInterval);
+            const elapsed = Date.now() - lastShown;
+            if (elapsed < minIntervalMs) {
+                const nextShowAt = new Date(lastShown + minIntervalMs);
+                return {
+                    allowed: false,
+                    reason: 'minInterval',
+                    nextShowAt,
+                };
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Record that a widget was shown
+     *
+     * @param widgetId - Widget or campaign ID
+     */
+    recordShown(widgetId) {
+        const storage = this.getStorage();
+        const now = Date.now();
+        let data = storage[widgetId];
+        if (!data) {
+            data = this.getWidgetData(widgetId);
+        }
+        // Reset counters if needed
+        data = this.resetCountersIfNeeded(data);
+        // Increment counters
+        data.sessionCount++;
+        data.dayCount++;
+        data.weekCount++;
+        data.totalCount++;
+        data.lastShownAt = new Date(now).toISOString();
+        storage[widgetId] = data;
+        this.setStorage(storage);
+    }
+    /**
+     * Get current display counts for a widget
+     *
+     * @param widgetId - Widget or campaign ID
+     * @returns Display data or null if not found
+     */
+    getDisplayCounts(widgetId) {
+        const storage = this.getStorage();
+        return storage[widgetId] || null;
+    }
+    /**
+     * Reset tracking for a widget (useful for testing)
+     *
+     * @param widgetId - Widget or campaign ID
+     */
+    reset(widgetId) {
+        const storage = this.getStorage();
+        delete storage[widgetId];
+        this.setStorage(storage);
+    }
+    /**
+     * Reset all tracking (useful for testing)
+     */
+    resetAll() {
+        localStorage.removeItem(this.storageKey);
+    }
+    /**
+     * Clean up old widget data (remove widgets not shown in 30 days)
+     */
+    cleanup() {
+        const storage = this.getStorage();
+        const thirtyDaysAgo = Date.now() - 30 * 24 * 60 * 60 * 1000;
+        let modified = false;
+        for (const widgetId in storage) {
+            const data = storage[widgetId];
+            if (data.lastShownAt) {
+                const lastShown = new Date(data.lastShownAt).getTime();
+                if (lastShown < thirtyDaysAgo) {
+                    delete storage[widgetId];
+                    modified = true;
+                }
+            }
+        }
+        if (modified) {
+            this.setStorage(storage);
+        }
+    }
+}
+// Singleton instance
+let frequencyCapManagerInstance = null;
+/**
+ * Get the singleton FrequencyCapManager instance
+ */
+export function getFrequencyCapManager() {
+    if (!frequencyCapManagerInstance) {
+        frequencyCapManagerInstance = new FrequencyCapManager();
+    }
+    return frequencyCapManagerInstance;
+}
+//# sourceMappingURL=frequency-caps.js.map

package/dist/npm/esm/core/frequency-caps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequency-caps.js","sourceRoot":"","sources":["../../../../src/core/frequency-caps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAwDlF;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IAK9B;QAJQ,eAAU,GAAG,YAAY,CAAC,cAAc,CAAC;QAK/C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,2BAA2B;QAC3B,IAAI,CAAC,SAAS;YACZ,CAAC,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC;gBAC9C,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAChD,EAAE,CAAC;IACP,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAgB;QACpC,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QAErB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAChC,KAAK,GAAG;gBACN,OAAO,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC;YAC3B,KAAK,GAAG;gBACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YACrC,KAAK,GAAG;gBACN,OAAO,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YACzC;gBACE,OAAO,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAAyB;QAC1C,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oCAAoC;YACpC,YAAY,CAAC,qBAAqB,EAAE,iCAAiC,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,IAAuB;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAErD,qEAAqE;QACrE,IAAI,GAAG,GAAG,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACxC,4CAA4C;YAC5C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,CAAC;QAED,uBAAuB;QACvB,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,YAAY,EAAE,CAAC;QACpD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;QAED,wBAAwB;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,SAAiB;QACrC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,GAAG,IAAI,KAAK,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAAU;QAC3B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAgB;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,6BAA6B;YAC7B,MAAM,OAAO,GAAsB;gBACjC,YAAY,EAAE,CAAC;gBACf,QAAQ,EAAE,CAAC;gBACX,SAAS,EAAE,CAAC;gBACZ,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;gBACzC,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;gBACrC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;aACvC,CAAC;YACF,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,2BAA2B;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAgB,EAAE,MAA0B;QAClD,8BAA8B;QAC9B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE1C,0BAA0B;QAC1B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC9E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,YAAY;gBACpB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,MAAM,CAAC,UAAU;aACzB,CAAC;QACJ,CAAC;QAED,sBAAsB;QACtB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAE,IAAI,CAAC,QAAQ;gBAC3B,KAAK,EAAE,MAAM,CAAC,MAAM;aACrB,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACrE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,SAAS;gBACjB,YAAY,EAAE,IAAI,CAAC,SAAS;gBAC5B,KAAK,EAAE,MAAM,CAAC,OAAO;aACtB,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,OAAO;gBACf,YAAY,EAAE,IAAI,CAAC,UAAU;gBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,IAAI,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;YACvD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEvC,IAAI,OAAO,GAAG,aAAa,EAAE,CAAC;gBAC5B,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC;gBACvD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,aAAa;oBACrB,UAAU;iBACX,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,QAAgB;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,2BAA2B;QAC3B,IAAI,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAExC,qBAAqB;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAE/C,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,QAAgB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAgB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC5D,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;gBACvD,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;oBAC9B,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;oBACzB,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED,qBAAqB;AACrB,IAAI,2BAA2B,GAA+B,IAAI,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACjC,2BAA2B,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,2BAA2B,CAAC;AACrC,CAAC"}

package/dist/npm/esm/core/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core Module Exports
+ */
+export * from './experiments';
+export * from './tracker';
+export * from './segments';
+export * from './frequency-caps';
+export * from './conflict-resolver';
+export * from './event-batcher';
+export * from './page-targeting';

package/dist/npm/esm/core/index.js

@@ -0,0 +1,11 @@
+/**
+ * Core Module Exports
+ */
+export * from './experiments.js';
+export * from './tracker.js';
+export * from './segments.js';
+export * from './frequency-caps.js';
+export * from './conflict-resolver.js';
+export * from './event-batcher.js';
+export * from './page-targeting/index.js';
+//# sourceMappingURL=index.js.map

package/dist/npm/esm/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/npm/esm/core/indexeddb-queue.d.ts

@@ -0,0 +1,83 @@
+/**
+ * IndexedDB Queue Storage
+ *
+ * Provides persistent overflow storage for events when the in-memory queue is full.
+ * This prevents silent data loss during high-traffic periods.
+ *
+ * Features:
+ * - Asynchronous operations (non-blocking)
+ * - Automatic cleanup of old events (24-hour TTL)
+ * - Size limits to prevent storage bloat
+ * - Graceful fallback when IndexedDB is unavailable
+ */
+import { EventBatch } from './event-batcher';
+export interface StoredEvent extends EventBatch {
+    id: number;
+    queuedAt: number;
+}
+/**
+ * IndexedDB Queue Manager
+ * Manages persistent storage for event overflow
+ */
+export declare class IndexedDBQueue {
+    private db;
+    private initialized;
+    private initPromise;
+    private disabled;
+    constructor();
+    /**
+     * Initialize IndexedDB
+     */
+    private init;
+    /**
+     * Wait for initialization to complete
+     */
+    private ready;
+    /**
+     * Store events in IndexedDB
+     */
+    store(events: EventBatch[]): Promise<void>;
+    /**
+     * Retrieve events from IndexedDB
+     */
+    retrieve(limit?: number): Promise<EventBatch[]>;
+    /**
+     * Get event by eventId for duplicate checking
+     */
+    private getByEventId;
+    /**
+     * Remove events by their IDs
+     */
+    private remove;
+    /**
+     * Enforce size limit by removing oldest events
+     */
+    private enforceSizeLimit;
+    /**
+     * Get count of stored events
+     */
+    private getCount;
+    /**
+     * Cleanup old events (older than 24 hours)
+     */
+    private cleanupOldEvents;
+    /**
+     * Get statistics about stored events
+     */
+    getStats(): Promise<{
+        count: number;
+        oldestTimestamp: number | null;
+    }>;
+    /**
+     * Clear all stored events
+     */
+    clear(): Promise<void>;
+    /**
+     * Check if IndexedDB is available
+     */
+    isAvailable(): boolean;
+}
+/**
+ * Get or create the singleton IndexedDBQueue instance
+ */
+export declare function getIndexedDBQueue(): IndexedDBQueue;