@selwise/widget 0.0.1

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

@@ -0,0 +1,297 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrequencyCapManager = void 0;
+exports.getFrequencyCapManager = getFrequencyCapManager;
+const constants_1 = require("../constants");
+const logger_1 = require("../utils/logger");
+const tracking_contract_1 = require("../modules/contract/tracking-contract");
+/**
+ * FrequencyCapManager
+ *
+ * Manages frequency caps for widgets/campaigns on the client side.
+ * Tracks display counts in localStorage and enforces limits.
+ */
+class FrequencyCapManager {
+    constructor() {
+        this.storageKey = constants_1.STORAGE_KEYS.FREQUENCY_CAPS;
+        this.sessionStart = Date.now();
+        // Get or create session ID
+        this.sessionId =
+            (sessionStorage.getItem(constants_1.STORAGE_KEYS.SESSION_ID) ||
+                localStorage.getItem(constants_1.STORAGE_KEYS.SESSION_ID)) ||
+                '';
+    }
+    /**
+     * Parse min interval string to milliseconds
+     */
+    parseInterval(interval) {
+        if (!(0, tracking_contract_1.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
+            (0, logger_1.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);
+        }
+    }
+}
+exports.FrequencyCapManager = FrequencyCapManager;
+// Singleton instance
+let frequencyCapManagerInstance = null;
+/**
+ * Get the singleton FrequencyCapManager instance
+ */
+function getFrequencyCapManager() {
+    if (!frequencyCapManagerInstance) {
+        frequencyCapManagerInstance = new FrequencyCapManager();
+    }
+    return frequencyCapManagerInstance;
+}
+//# sourceMappingURL=frequency-caps.js.map

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

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

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

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Core Module Exports
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./experiments"), exports);
+__exportStar(require("./tracker"), exports);
+__exportStar(require("./segments"), exports);
+__exportStar(require("./frequency-caps"), exports);
+__exportStar(require("./conflict-resolver"), exports);
+__exportStar(require("./event-batcher"), exports);
+__exportStar(require("./page-targeting"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,4CAA0B;AAC1B,6CAA2B;AAC3B,mDAAiC;AACjC,sDAAoC;AACpC,kDAAgC;AAChC,mDAAiC"}

package/dist/npm/cjs/core/indexeddb-queue.js

@@ -0,0 +1,333 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexedDBQueue = void 0;
+exports.getIndexedDBQueue = getIndexedDBQueue;
+const DB_NAME = 'selwise_event_queue';
+const DB_VERSION = 1;
+const STORE_NAME = 'events';
+const MAX_STORED_EVENTS = 1000;
+const EVENT_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * IndexedDB Queue Manager
+ * Manages persistent storage for event overflow
+ */
+class IndexedDBQueue {
+    constructor() {
+        this.db = null;
+        this.initialized = false;
+        this.initPromise = null;
+        this.disabled = false;
+        this.initPromise = this.init();
+    }
+    /**
+     * Initialize IndexedDB
+     */
+    async init() {
+        if (this.disabled) {
+            return false;
+        }
+        // Check if IndexedDB is available
+        if (typeof indexedDB === 'undefined') {
+            this.disabled = true;
+            return false;
+        }
+        try {
+            this.db = await new Promise((resolve, reject) => {
+                const request = indexedDB.open(DB_NAME, DB_VERSION);
+                request.onerror = () => reject(request.error);
+                request.onsuccess = () => resolve(request.result);
+                request.onupgradeneeded = (event) => {
+                    const db = event.target.result;
+                    // Create object store for events
+                    if (!db.objectStoreNames.contains(STORE_NAME)) {
+                        const store = db.createObjectStore(STORE_NAME, {
+                            keyPath: 'id',
+                            autoIncrement: true,
+                        });
+                        // Create indexes for efficient queries
+                        store.createIndex('queuedAt', 'queuedAt');
+                        store.createIndex('eventId', 'eventId', { unique: true });
+                    }
+                };
+            });
+            this.initialized = true;
+            await this.cleanupOldEvents();
+            return true;
+        }
+        catch (error) {
+            // IndexedDB not available (private browsing, quota exceeded, etc.)
+            this.disabled = true;
+            return false;
+        }
+    }
+    /**
+     * Wait for initialization to complete
+     */
+    async ready() {
+        if (this.initialized) {
+            return this.db !== null;
+        }
+        if (this.initPromise) {
+            return this.initPromise;
+        }
+        return false;
+    }
+    /**
+     * Store events in IndexedDB
+     */
+    async store(events) {
+        if (!(await this.ready()) || events.length === 0) {
+            return;
+        }
+        try {
+            const transaction = this.db.transaction([STORE_NAME], 'readwrite');
+            const store = transaction.objectStore(STORE_NAME);
+            const queuedAt = Date.now();
+            for (const event of events) {
+                // Check if event already exists (duplicate)
+                const existing = await this.getByEventId(event.eventId);
+                if (existing) {
+                    continue;
+                }
+                store.add({
+                    ...event,
+                    queuedAt,
+                });
+            }
+            // Enforce size limit after adding
+            await this.enforceSizeLimit();
+        }
+        catch (error) {
+            // Silently fail - IndexedDB errors shouldn't break the app
+        }
+    }
+    /**
+     * Retrieve events from IndexedDB
+     */
+    async retrieve(limit = 50) {
+        if (!(await this.ready())) {
+            return [];
+        }
+        try {
+            const transaction = this.db.transaction([STORE_NAME], 'readonly');
+            const store = transaction.objectStore(STORE_NAME);
+            const index = store.index('queuedAt');
+            const events = await new Promise((resolve, reject) => {
+                const request = index.openCursor(null, 'next'); // Oldest first
+                const results = [];
+                request.onsuccess = (event) => {
+                    const cursor = event.target.result;
+                    if (cursor && results.length < limit) {
+                        results.push(cursor.value);
+                        cursor.continue();
+                    }
+                    else {
+                        resolve(results);
+                    }
+                };
+                request.onerror = () => reject(request.error);
+            });
+            // Remove retrieved events from storage
+            if (events.length > 0) {
+                await this.remove(events.map(e => e.id));
+            }
+            // Convert to EventBatch format (remove id and queuedAt)
+            return events.map(({ id, queuedAt, ...event }) => event);
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Get event by eventId for duplicate checking
+     */
+    async getByEventId(eventId) {
+        if (!this.db) {
+            return null;
+        }
+        try {
+            const transaction = this.db.transaction([STORE_NAME], 'readonly');
+            const store = transaction.objectStore(STORE_NAME);
+            const index = store.index('eventId');
+            return await new Promise((resolve, reject) => {
+                const request = index.get(eventId);
+                request.onsuccess = () => resolve(request.result || null);
+                request.onerror = () => reject(request.error);
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Remove events by their IDs
+     */
+    async remove(ids) {
+        if (!this.db || ids.length === 0) {
+            return;
+        }
+        try {
+            const transaction = this.db.transaction([STORE_NAME], 'readwrite');
+            const store = transaction.objectStore(STORE_NAME);
+            for (const id of ids) {
+                store.delete(id);
+            }
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    /**
+     * Enforce size limit by removing oldest events
+     */
+    async enforceSizeLimit() {
+        if (!this.db) {
+            return;
+        }
+        try {
+            const count = await this.getCount();
+            if (count > MAX_STORED_EVENTS) {
+                const toRemove = count - MAX_STORED_EVENTS;
+                // Remove oldest events
+                const transaction = this.db.transaction([STORE_NAME], 'readwrite');
+                const store = transaction.objectStore(STORE_NAME);
+                const index = store.index('queuedAt');
+                let removed = 0;
+                const request = index.openCursor(null, 'next');
+                request.onsuccess = (event) => {
+                    const cursor = event.target.result;
+                    if (cursor && removed < toRemove) {
+                        cursor.delete();
+                        removed++;
+                        cursor.continue();
+                    }
+                };
+            }
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    /**
+     * Get count of stored events
+     */
+    async getCount() {
+        if (!this.db) {
+            return 0;
+        }
+        try {
+            const transaction = this.db.transaction([STORE_NAME], 'readonly');
+            const store = transaction.objectStore(STORE_NAME);
+            return await new Promise((resolve, reject) => {
+                const request = store.count();
+                request.onsuccess = () => resolve(request.result);
+                request.onerror = () => reject(request.error);
+            });
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Cleanup old events (older than 24 hours)
+     */
+    async cleanupOldEvents() {
+        if (!this.db) {
+            return;
+        }
+        try {
+            const cutoffTime = Date.now() - EVENT_TTL_MS;
+            const transaction = this.db.transaction([STORE_NAME], 'readwrite');
+            const store = transaction.objectStore(STORE_NAME);
+            const index = store.index('queuedAt');
+            const range = IDBKeyRange.upperBound(cutoffTime);
+            const request = index.openCursor(range);
+            request.onsuccess = (event) => {
+                const cursor = event.target.result;
+                if (cursor) {
+                    cursor.delete();
+                    cursor.continue();
+                }
+            };
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    /**
+     * Get statistics about stored events
+     */
+    async getStats() {
+        if (!(await this.ready())) {
+            return { count: 0, oldestTimestamp: null };
+        }
+        try {
+            const count = await this.getCount();
+            let oldestTimestamp = null;
+            if (count > 0) {
+                const transaction = this.db.transaction([STORE_NAME], 'readonly');
+                const store = transaction.objectStore(STORE_NAME);
+                const index = store.index('queuedAt');
+                oldestTimestamp = await new Promise((resolve) => {
+                    const request = index.openCursor(null, 'next');
+                    request.onsuccess = (event) => {
+                        const cursor = event.target.result;
+                        resolve(cursor ? cursor.value.queuedAt : null);
+                    };
+                    request.onerror = () => resolve(null);
+                });
+            }
+            return { count, oldestTimestamp };
+        }
+        catch {
+            return { count: 0, oldestTimestamp: null };
+        }
+    }
+    /**
+     * Clear all stored events
+     */
+    async clear() {
+        if (!(await this.ready())) {
+            return;
+        }
+        try {
+            const transaction = this.db.transaction([STORE_NAME], 'readwrite');
+            const store = transaction.objectStore(STORE_NAME);
+            store.clear();
+        }
+        catch {
+            // Silently fail
+        }
+    }
+    /**
+     * Check if IndexedDB is available
+     */
+    isAvailable() {
+        return !this.disabled && this.initialized && this.db !== null;
+    }
+}
+exports.IndexedDBQueue = IndexedDBQueue;
+// Singleton instance
+let indexedDBQueueInstance = null;
+/**
+ * Get or create the singleton IndexedDBQueue instance
+ */
+function getIndexedDBQueue() {
+    if (!indexedDBQueueInstance) {
+        indexedDBQueueInstance = new IndexedDBQueue();
+    }
+    return indexedDBQueueInstance;
+}
+//# sourceMappingURL=indexeddb-queue.js.map