@selwise/widget 0.0.1

package/dist/npm/esm/core/page-targeting/index.d.ts

@@ -0,0 +1,8 @@
+export interface PageTargetingConfig {
+    showOnAllPages: boolean;
+    includeUrls: string[];
+    excludeUrls: string[];
+}
+export declare function normalizePageTargeting(input: unknown): PageTargetingConfig;
+export declare function matchUrlPattern(url: string, pattern: string): boolean;
+export declare function evaluatePageTargeting(targetingInput: unknown, currentUrl: string): boolean;

package/dist/npm/esm/core/page-targeting/index.js

@@ -0,0 +1,67 @@
+const DEFAULT_PAGE_TARGETING = {
+    showOnAllPages: true,
+    includeUrls: [],
+    excludeUrls: [],
+};
+function normalizePatternList(value) {
+    if (!Array.isArray(value))
+        return [];
+    const seen = new Set();
+    const normalized = [];
+    for (const raw of value) {
+        if (typeof raw !== 'string')
+            continue;
+        const pattern = raw.trim();
+        if (!pattern)
+            continue;
+        if (seen.has(pattern))
+            continue;
+        seen.add(pattern);
+        normalized.push(pattern);
+    }
+    return normalized;
+}
+export function normalizePageTargeting(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        return { ...DEFAULT_PAGE_TARGETING };
+    }
+    const payload = input;
+    return {
+        showOnAllPages: Boolean(payload.showOnAllPages ?? DEFAULT_PAGE_TARGETING.showOnAllPages),
+        includeUrls: normalizePatternList(payload.includeUrls),
+        excludeUrls: normalizePatternList(payload.excludeUrls),
+    };
+}
+export function matchUrlPattern(url, pattern) {
+    const normalizedUrl = String(url || '').toLowerCase();
+    const normalizedPattern = String(pattern || '').toLowerCase().trim();
+    if (!normalizedPattern)
+        return false;
+    if (normalizedPattern.includes('*')) {
+        const regexPattern = normalizedPattern
+            .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+            .replace(/\*/g, '.*');
+        return new RegExp(`^${regexPattern}$`).test(normalizedUrl);
+    }
+    return normalizedUrl === normalizedPattern || normalizedUrl.includes(normalizedPattern);
+}
+export function evaluatePageTargeting(targetingInput, currentUrl) {
+    const targeting = normalizePageTargeting(targetingInput);
+    const normalizedCurrentUrl = String(currentUrl || '');
+    if (targeting.excludeUrls.length > 0) {
+        const excluded = targeting.excludeUrls.some((pattern) => matchUrlPattern(normalizedCurrentUrl, pattern));
+        if (excluded)
+            return false;
+    }
+    if (targeting.showOnAllPages === false) {
+        if (targeting.includeUrls.length === 0)
+            return false;
+        if (!normalizedCurrentUrl)
+            return false;
+        const included = targeting.includeUrls.some((pattern) => matchUrlPattern(normalizedCurrentUrl, pattern));
+        if (!included)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=index.js.map

package/dist/npm/esm/core/page-targeting/index.js.map

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

package/dist/npm/esm/core/script-executor.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Script Execution Module
+ * Handles JavaScript execution for custom cards, widgets, campaigns
+ */
+export interface ScriptConfig {
+    code: string;
+    timing: 'immediate' | 'domReady' | 'customEvent';
+    eventName?: string;
+    container?: HTMLElement;
+    context?: Record<string, any>;
+    force?: boolean;
+}
+export declare class ScriptExecutor {
+    private pendingScripts;
+    /**
+     * Execute script based on timing configuration
+     */
+    execute(config: ScriptConfig): void;
+    /**
+     * Execute script immediately with proper scoping
+     */
+    private executeNow;
+    /**
+     * Trigger a custom event for pending scripts
+     */
+    triggerCustomEvent(eventName: string): void;
+    /**
+     * Clean up pending scripts and executed scripts
+     */
+    destroy(): void;
+}

package/dist/npm/esm/core/script-executor.js

@@ -0,0 +1,76 @@
+/**
+ * Script Execution Module
+ * Handles JavaScript execution for custom cards, widgets, campaigns
+ */
+import { testModeError } from '../utils/logger.js';
+export class ScriptExecutor {
+    constructor() {
+        this.pendingScripts = new Map();
+    }
+    /**
+     * Execute script based on timing configuration
+     */
+    execute(config) {
+        if (!config.code?.trim())
+            return;
+        switch (config.timing) {
+            case 'immediate':
+                this.executeNow(config);
+                break;
+            case 'domReady':
+                if (document.readyState === 'loading') {
+                    document.addEventListener('DOMContentLoaded', () => this.executeNow(config));
+                }
+                else {
+                    this.executeNow(config);
+                }
+                break;
+            case 'customEvent':
+                if (config.eventName) {
+                    this.pendingScripts.set(config.eventName, config);
+                    document.addEventListener(config.eventName, () => {
+                        this.executeNow(config);
+                    }, { once: true });
+                }
+                break;
+        }
+    }
+    /**
+     * Execute script immediately with proper scoping
+     */
+    executeNow(config) {
+        try {
+            const script = document.createElement('script');
+            script.setAttribute('data-selwise-custom-js', 'true');
+            // Wrap in IIFE with context available
+            const contextStr = config.context
+                ? `const context = ${JSON.stringify(config.context)};`
+                : '';
+            script.textContent = `(function() { ${contextStr} ${config.code} }).call(window);`;
+            if (config.container) {
+                config.container.appendChild(script);
+            }
+            else {
+                document.body.appendChild(script);
+            }
+        }
+        catch (error) {
+            testModeError('Selwise', 'Script execution error:', error);
+        }
+    }
+    /**
+     * Trigger a custom event for pending scripts
+     */
+    triggerCustomEvent(eventName) {
+        const event = new CustomEvent(eventName);
+        document.dispatchEvent(event);
+    }
+    /**
+     * Clean up pending scripts and executed scripts
+     */
+    destroy() {
+        this.pendingScripts.clear();
+        document.querySelectorAll('script[data-selwise-custom-js]').forEach(el => el.remove());
+    }
+}
+//# sourceMappingURL=script-executor.js.map

package/dist/npm/esm/core/script-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-executor.js","sourceRoot":"","sources":["../../../../src/core/script-executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAYhD,MAAM,OAAO,cAAc;IAA3B;QACU,mBAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;IAsE3D,CAAC;IApEC;;OAEG;IACH,OAAO,CAAC,MAAoB;QAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE;YAAE,OAAO;QAEjC,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,WAAW;gBACd,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,UAAU;gBACb,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;oBACtC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC/E,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC1B,CAAC;gBACD,MAAM;YACR,KAAK,aAAa;gBAChB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;oBACrB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;oBAClD,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE;wBAC/C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;oBAC1B,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrB,CAAC;gBACD,MAAM;QACV,CAAC;IACH,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,MAAoB;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;YAEtD,sCAAsC;YACtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO;gBAC/B,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG;gBACtD,CAAC,CAAC,EAAE,CAAC;YAEP,MAAM,CAAC,WAAW,GAAG,iBAAiB,UAAU,IAAI,MAAM,CAAC,IAAI,mBAAmB,CAAC;YAEnF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,SAAS,EAAE,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,SAAiB;QAClC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;QACzC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,QAAQ,CAAC,gBAAgB,CAAC,gCAAgC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;CACF"}

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

@@ -0,0 +1,39 @@
+/**
+ * Segment Evaluation for Client-Side Targeting
+ */
+export declare class SegmentManager {
+    private apiUrl;
+    private siteKey;
+    private segmentCache;
+    private segmentCacheTimestamps;
+    private visitorId;
+    private sessionId;
+    private siteUserId?;
+    private siteUserProfileId?;
+    constructor(apiUrl: string, siteKey: string, visitorId: string, sessionId: string, siteUserId?: string, siteUserProfileId?: string);
+    /**
+     * Update user identifiers (called after identify)
+     */
+    updateUserIdentifiers(siteUserId?: string, siteUserProfileId?: string): void;
+    /**
+     * Evaluate if user matches segment targeting
+     */
+    shouldShow(segmentTargetingMode: string, segmentIds: string[] | any): Promise<boolean>;
+    /**
+     * Evaluate multiple segments at once
+     */
+    private evaluateSegments;
+    /**
+     * Get device type
+     */
+    private getDeviceType;
+    /**
+     * Fallback results when API fails (show to everyone to avoid breaking site)
+     */
+    private getFallbackResults;
+    private normalizeSegmentIds;
+    /**
+     * Clear segment cache
+     */
+    clearCache(): void;
+}

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

@@ -0,0 +1,168 @@
+/**
+ * Segment Evaluation for Client-Side Targeting
+ */
+import { testModeLog, testModeError } from '../utils/logger.js';
+// Cache TTL: 5 minutes
+const CACHE_TTL = 5 * 60 * 1000;
+export class SegmentManager {
+    constructor(apiUrl, siteKey, visitorId, sessionId, siteUserId, siteUserProfileId) {
+        this.segmentCache = new Map();
+        this.segmentCacheTimestamps = new Map();
+        this.apiUrl = apiUrl;
+        this.siteKey = siteKey;
+        this.visitorId = visitorId;
+        this.sessionId = sessionId;
+        this.siteUserId = siteUserId;
+        this.siteUserProfileId = siteUserProfileId;
+    }
+    /**
+     * Update user identifiers (called after identify)
+     */
+    updateUserIdentifiers(siteUserId, siteUserProfileId) {
+        this.siteUserId = siteUserId;
+        this.siteUserProfileId = siteUserProfileId;
+    }
+    /**
+     * Evaluate if user matches segment targeting
+     */
+    async shouldShow(segmentTargetingMode, segmentIds) {
+        // Convert JSON field to array if needed
+        const ids = this.normalizeSegmentIds(segmentIds);
+        testModeLog('SegmentManager', 'Evaluating segment targeting:', {
+            mode: segmentTargetingMode,
+            segmentIds: ids,
+            visitorId: this.visitorId,
+            sessionId: this.sessionId
+        });
+        // If mode is 'all', show to everyone
+        if (segmentTargetingMode === 'all' || ids.length === 0) {
+            testModeLog('SegmentManager', 'Mode is "all" or no segments, showing content');
+            return true;
+        }
+        // Evaluate all segments
+        const results = await this.evaluateSegments(ids);
+        // Check if user matches any segment
+        const matchedSegmentIds = Object.keys(results).filter(id => results[id]);
+        testModeLog('SegmentManager', 'Evaluation results:', {
+            results,
+            matchedSegments: matchedSegmentIds,
+            mode: segmentTargetingMode
+        });
+        if (segmentTargetingMode === 'include') {
+            // User must be in at least one segment
+            const shouldShow = matchedSegmentIds.length > 0;
+            testModeLog('SegmentManager', `Include mode: ${shouldShow ? 'SHOW' : 'HIDE'}`);
+            return shouldShow;
+        }
+        if (segmentTargetingMode === 'exclude') {
+            // User must NOT be in any segment
+            const shouldShow = matchedSegmentIds.length === 0;
+            testModeLog('SegmentManager', `Exclude mode: ${shouldShow ? 'SHOW' : 'HIDE'}`);
+            return shouldShow;
+        }
+        return true;
+    }
+    /**
+     * Evaluate multiple segments at once
+     */
+    async evaluateSegments(segmentIds) {
+        // Check cache first with TTL validation
+        const now = Date.now();
+        const uncachedIds = segmentIds.filter(id => {
+            if (!this.segmentCache.has(id))
+                return true;
+            const cachedTime = this.segmentCacheTimestamps.get(id);
+            if (!cachedTime)
+                return true;
+            // Cache entry is expired
+            return (now - cachedTime) > CACHE_TTL;
+        });
+        // If all segments are cached and valid, return cached results
+        if (uncachedIds.length === 0) {
+            const results = {};
+            segmentIds.forEach(id => {
+                results[id] = this.segmentCache.get(id) || false;
+            });
+            return results;
+        }
+        // Fetch segment evaluation from API
+        try {
+            const requestPayload = {
+                segmentIds: this.normalizeSegmentIds(segmentIds),
+                visitorId: this.visitorId,
+                siteUserId: this.siteUserId,
+                siteUserProfileId: this.siteUserProfileId,
+                sessionId: this.sessionId,
+                deviceType: this.getDeviceType(),
+                referrer: document.referrer,
+                pageUrl: window.location.href,
+            };
+            testModeLog('SegmentManager', 'Calling API to evaluate segments:', {
+                endpoint: `${this.apiUrl}/public/segments/evaluate?siteKey=${this.siteKey}`,
+                payload: requestPayload
+            });
+            const response = await fetch(`${this.apiUrl}/public/segments/evaluate?siteKey=${this.siteKey}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(requestPayload),
+            });
+            if (!response.ok) {
+                testModeError('SegmentManager', 'API returned error:', response.status, response.statusText);
+                return this.getFallbackResults(segmentIds);
+            }
+            const data = await response.json();
+            testModeLog('SegmentManager', 'API response:', data);
+            // Cache results with timestamps
+            const cacheTime = Date.now();
+            Object.keys(data.results).forEach(id => {
+                this.segmentCache.set(id, data.results[id]);
+                this.segmentCacheTimestamps.set(id, cacheTime);
+            });
+            return data.results;
+        }
+        catch (error) {
+            testModeError('SegmentManager', 'Error evaluating segments:', error);
+            return this.getFallbackResults(segmentIds);
+        }
+    }
+    /**
+     * Get device type
+     */
+    getDeviceType() {
+        const ua = navigator.userAgent;
+        if (/(tablet|ipad|playbook|silk)|(android(?!.*mobi))/i.test(ua)) {
+            return 'tablet';
+        }
+        if (/Mobile|Android|iP(hone|od)|IEMobile|BlackBerry|Kindle|Silk-Accelerated|(hpw|web)OS|Opera M(obi|ini)/.test(ua)) {
+            return 'mobile';
+        }
+        return 'desktop';
+    }
+    /**
+     * Fallback results when API fails (show to everyone to avoid breaking site)
+     */
+    getFallbackResults(segmentIds) {
+        const results = {};
+        segmentIds.forEach(id => {
+            results[id] = false;
+        });
+        return results;
+    }
+    normalizeSegmentIds(segmentIds) {
+        if (!Array.isArray(segmentIds)) {
+            return [];
+        }
+        return Array.from(new Set(segmentIds
+            .filter((segmentId) => typeof segmentId === 'string')
+            .map((segmentId) => segmentId.trim())
+            .filter((segmentId) => segmentId.length > 0))).sort();
+    }
+    /**
+     * Clear segment cache
+     */
+    clearCache() {
+        this.segmentCache.clear();
+        this.segmentCacheTimestamps.clear();
+    }
+}
+//# sourceMappingURL=segments.js.map

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

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

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

@@ -0,0 +1,182 @@
+/**
+ * Event Tracker
+ * Comprehensive tracking for impressions, clicks, views, and conversions
+ *
+ * Now with optional EventBatcher for advanced batching capabilities:
+ * - Configurable batch size (default: 50 events)
+ * - Configurable flush interval (default: 30 seconds)
+ * - Page hide/send beacon support
+ * - Offline persistence (localStorage)
+ * - Event deduplication
+ * - Retry logic with exponential backoff
+ */
+import { type EventBatcherConfig } from './event-batcher';
+interface OrderData {
+    orderId?: string;
+    currency?: string;
+    total: number;
+    subtotal?: number;
+    discountTotal?: number;
+    shippingTotal?: number;
+    taxTotal?: number;
+    status?: string;
+    placedAt?: string;
+    visitorId?: string;
+    siteUserId?: string;
+    items?: Array<{
+        productItemCode?: string;
+        name?: string;
+        quantity?: number;
+        unitPrice?: number;
+        totalPrice?: number;
+        metadata?: Record<string, any>;
+    }>;
+    metadata?: Record<string, any>;
+}
+export declare class Tracker {
+    private apiUrl;
+    private siteKey;
+    private sessionId;
+    private visitorId;
+    private siteUserId?;
+    private queue;
+    private flushTimeout;
+    private viewObservers;
+    private viewedElements;
+    private hoverStartTimes;
+    private batcher?;
+    private useAdvancedBatching;
+    private spaCleanupSetup;
+    constructor(apiUrl?: string, siteKey?: string, batchingConfig?: EventBatcherConfig & {
+        enabled?: boolean;
+    });
+    /**
+     * Enable SPA cleanup (call this if your app uses client-side routing)
+     * This should be called once during initialization
+     */
+    enableSPACleanup(): void;
+    setSiteKey(siteKey: string): void;
+    /**
+     * Configure or enable advanced batching
+     * Can be called to update configuration dynamically after fetching from server
+     */
+    setBatcherConfig(config: EventBatcherConfig & {
+        enabled?: boolean;
+    }): void;
+    setSiteUserId(siteUserId?: string): void;
+    getSessionId(): string;
+    getVisitorId(): string;
+    getSiteUserId(): string | undefined;
+    /**
+     * Get the current journey ID
+     * Returns the active journey ID or null if no journey is active
+     */
+    getJourneyId(): string | null;
+    /**
+     * End the current journey
+     * Clears the journey ID and starts a new one on next event
+     */
+    endJourney(): void;
+    /**
+     * Get the journey state for debugging
+     */
+    getJourneyState(): {
+        journeyId: string | null;
+        age: number | null;
+        isValid: boolean;
+    };
+    /**
+     * Get the internal SiteUser profile ID (UUID) for segment evaluation
+     * This is set after identify() and persists for merged behavior lookup
+     */
+    getSiteUserProfileId(): string | undefined;
+    /**
+     * Identify a user and merge anonymous visitor data
+     * Calls the backend API to perform identity merge
+     */
+    identify(userId: string, metadata?: Record<string, any>): Promise<{
+        success: boolean;
+        merged?: boolean;
+    }>;
+    /**
+     * Set user traits without changing identity
+     * Calls the backend API to update user attributes
+     */
+    setTraits(traits: Record<string, any>): Promise<boolean>;
+    /**
+     * Track merged visitor IDs for cross-device reference
+     */
+    private updateMergedVisitorIds;
+    /**
+     * Get all merged visitor IDs for this user
+     */
+    getMergedVisitorIds(): string[];
+    track(name: string, args?: {
+        entityType?: string;
+        entityId?: string;
+        metadata?: Record<string, any>;
+    }): void;
+    trackView(element: HTMLElement, entityType: string, entityId: string, metadata?: Record<string, any>): void;
+    trackProductImpression(element: HTMLElement, widgetId: string, productItemCode: string, position: number): void;
+    trackHoverStart(entityType: string, entityId: string): void;
+    trackHoverEnd(entityType: string, entityId: string, metadata?: Record<string, any>): void;
+    trackScroll(entityType: string, entityId: string, scrollPercent: number): void;
+    trackSliderNavigate(widgetId: string, direction: 'prev' | 'next', fromSlide: number, toSlide: number): void;
+    trackSliderSwipe(widgetId: string, direction: 'left' | 'right'): void;
+    trackSearchOpen(trigger?: 'click' | 'hotkey' | 'auto'): void;
+    trackSearchClose(query: string, resultCount: number, dwellTime: number): void;
+    trackCategoryFilter(categoryName: string, resultCount: number): void;
+    trackRecentSearchClick(query: string): void;
+    trackPopularSearchClick(query: string): void;
+    trackPopularCategoryClick(categoryName: string): void;
+    trackPopularProductClick(productItemCode: string): void;
+    trackZeroResults(query: string): void;
+    trackOrder(order: OrderData): Promise<void>;
+    private scheduleFlush;
+    flush(): Promise<void>;
+    cleanup(): void;
+    /**
+     * Setup SPA navigation cleanup listener
+     * Automatically cleans up observers when page navigation is detected
+     * This prevents memory leaks in single-page applications
+     */
+    setupSPACleanup(): void;
+    /**
+     * Schedule deferred cleanup with a small delay
+     * This allows the new page to settle before cleaning up
+     */
+    private scheduleDeferredCleanup;
+    /**
+     * Manually flush pending events (useful for testing or before page unload)
+     */
+    flushBatcher(): Promise<void>;
+    /**
+     * Get batcher stats (useful for debugging)
+     */
+    getBatcherStats(): {
+        queueSize: number;
+        consentQueueSize: number;
+        processedCount: number;
+        enabled: boolean;
+    };
+    /**
+     * Initialize the batcher (must be called after construction)
+     * This loads overflow events from IndexedDB and flushes them immediately
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the batcher has been initialized
+     */
+    isReady(): boolean;
+    /**
+     * Flush consent queue - called when user grants consent
+     * Re-evaluates all queued events and sends those that now have consent
+     */
+    flushConsentQueue(): void;
+    /**
+     * Set up the global consent queue flush callback
+     * This allows the cookie consent widget to trigger queue flush when consent is granted
+     */
+    setupConsentCallback(): void;
+}
+export {};