@seekora-ai/ui-sdk-core 0.2.12 → 0.2.14

package/dist/index.d.ts

@@ -311,6 +311,12 @@ interface SearchStateManagerConfig {
     autoSearch?: boolean;
     debounceMs?: number;
     defaultSearchOptions?: Partial<SearchOptions>;
+    /** When query is cleared to empty string, retain previous results instead of triggering a search (default: true) */
+    keepResultsOnClear?: boolean;
+    /** A/B test experiment ID to include in all analytics events */
+    abTestId?: string;
+    /** A/B test variant to include in all analytics events */
+    abVariant?: string;
 }
 declare class SearchStateManager {
     private client;
@@ -320,6 +326,9 @@ declare class SearchStateManager {
     private autoSearch;
     private debounceMs;
     private defaultSearchOptions;
+    private keepResultsOnClear;
+    private abTestId?;
+    private abVariant?;
     constructor(config: SearchStateManagerConfig);
     getState(): SearchState;
     getQuery(): string;
@@ -341,6 +350,11 @@ declare class SearchStateManager {
     subscribe(listener: (state: SearchState) => void): () => void;
     private setState;
     private notifyListeners;
+    /** Explicitly clear results (bypasses keepResultsOnClear) */
+    clearResults(): void;
+    getAbTestId(): string | undefined;
+    getAbVariant(): string | undefined;
+    setAbTest(abTestId?: string, abVariant?: string): void;
     clear(): void;
 }
 
@@ -572,5 +586,25 @@ declare class Fingerprint {
  */
 declare function getFingerprint(config?: Partial<FingerprintConfig>): Promise<FingerprintResult>;
 
-export { Fingerprint, LogLevel, SearchStateManager, URLRouter, announce, announceFilterChange, announceResults, createFocusTrap, createKeyboardShortcuts, createLogger, createRovingTabIndex, createTheme, createURLRouter, darkThemeVariables, extractField, focusFirstError, formatPrice, generateCompleteStylesheet, generateId, generateThemeStylesheet, getFingerprint, getFocusableElements, getHighlightedValue, getLogger, getNestedValue, getSnippetedValue, getTheme, handleKeyboardNavigation, highContrastThemeVariables, highlightQuery, injectStyles, lightThemeVariables, log, mergeThemes, minimalThemeVariables, parseHighlightedParts, parseQueryHighlightParts, prefersHighContrast, prefersReducedMotion, setAriaDescribedBy, setDefaultLogger, setLogLevel, setLogPrefix, setLogTimestamp, setTheme, stripHighlightTags, themeToCSSVariables };
-export type { CSSVariablesConfig, FingerprintComponents, FingerprintConfig, FingerprintResult, HighlightOptions, HighlightPart, KeyboardNavigationOptions, KeyboardShortcut, LoggerConfig, Refinement, SearchState, SearchStateManagerConfig, SnippetOptions, URLRouterConfig, URLStateMapping };
+/**
+ * Analytics beacon utility
+ *
+ * Uses navigator.sendBeacon() for reliable event delivery during page navigation,
+ * with fetch() as the primary method for normal operation.
+ */
+interface BeaconPayload {
+    [key: string]: unknown;
+}
+/**
+ * Send an analytics event using sendBeacon (for page unload scenarios)
+ * or fetch (for normal operation). Returns true if the event was queued.
+ */
+declare function sendAnalyticsBeacon(url: string, payload: BeaconPayload): boolean;
+/**
+ * Send an analytics event via fetch (normal operation).
+ * Returns the fetch promise for awaiting if needed.
+ */
+declare function sendAnalyticsEvent(url: string, payload: BeaconPayload): Promise<boolean>;
+
+export { Fingerprint, LogLevel, SearchStateManager, URLRouter, announce, announceFilterChange, announceResults, createFocusTrap, createKeyboardShortcuts, createLogger, createRovingTabIndex, createTheme, createURLRouter, darkThemeVariables, extractField, focusFirstError, formatPrice, generateCompleteStylesheet, generateId, generateThemeStylesheet, getFingerprint, getFocusableElements, getHighlightedValue, getLogger, getNestedValue, getSnippetedValue, getTheme, handleKeyboardNavigation, highContrastThemeVariables, highlightQuery, injectStyles, lightThemeVariables, log, mergeThemes, minimalThemeVariables, parseHighlightedParts, parseQueryHighlightParts, prefersHighContrast, prefersReducedMotion, sendAnalyticsBeacon, sendAnalyticsEvent, setAriaDescribedBy, setDefaultLogger, setLogLevel, setLogPrefix, setLogTimestamp, setTheme, stripHighlightTags, themeToCSSVariables };
+export type { BeaconPayload, CSSVariablesConfig, FingerprintComponents, FingerprintConfig, FingerprintResult, HighlightOptions, HighlightPart, KeyboardNavigationOptions, KeyboardShortcut, LoggerConfig, Refinement, SearchState, SearchStateManagerConfig, SnippetOptions, URLRouterConfig, URLStateMapping };

package/dist/index.esm.js

@@ -1402,6 +1402,9 @@ class SearchStateManager {
         this.autoSearch = config.autoSearch !== false;
         this.debounceMs = config.debounceMs || 300;
         this.defaultSearchOptions = config.defaultSearchOptions || { widget_mode: true };
+        this.keepResultsOnClear = config.keepResultsOnClear !== false;
+        this.abTestId = config.abTestId;
+        this.abVariant = config.abVariant;
         this.state = {
             query: config.initialQuery || '',
             refinements: [],
@@ -1450,6 +1453,15 @@ class SearchStateManager {
             }
             return;
         }
+        // When query is cleared to empty and keepResultsOnClear is true,
+        // preserve previous results and skip triggering a search
+        if (query === '' && this.keepResultsOnClear) {
+            log.verbose('SearchStateManager: Query cleared, keeping previous results');
+            this.state.query = '';
+            this.state.currentPage = 1;
+            this.notifyListeners();
+            return;
+        }
         this.state.query = query;
         this.state.currentPage = 1; // Reset to first page on new query
         log.verbose('SearchStateManager: Query updated', { query, triggerSearch, autoSearch: this.autoSearch });
@@ -1648,6 +1660,23 @@ class SearchStateManager {
             }
         });
     }
+    /** Explicitly clear results (bypasses keepResultsOnClear) */
+    clearResults() {
+        this.setState({ results: null, loading: false, error: null });
+        log.verbose('SearchStateManager: Results explicitly cleared');
+    }
+    // A/B test getters
+    getAbTestId() {
+        return this.abTestId;
+    }
+    getAbVariant() {
+        return this.abVariant;
+    }
+    setAbTest(abTestId, abVariant) {
+        this.abTestId = abTestId;
+        this.abVariant = abVariant;
+        log.verbose('SearchStateManager: A/B test updated', { abTestId, abVariant });
+    }
     // Clear all state
     clear() {
         this.state = {
@@ -2627,5 +2656,56 @@ async function getFingerprint(config) {
     return fingerprint.get();
 }
 
-export { Fingerprint, LogLevel, SearchStateManager, URLRouter, announce, announceFilterChange, announceResults, createFocusTrap, createKeyboardShortcuts, createLogger, createRovingTabIndex, createTheme, createURLRouter, darkThemeVariables, extractField, focusFirstError, formatPrice, generateCompleteStylesheet, generateId, generateThemeStylesheet, getFingerprint, getFocusableElements, getHighlightedValue, getLogger, getNestedValue$1 as getNestedValue, getSnippetedValue, getTheme, handleKeyboardNavigation, highContrastThemeVariables, highlightQuery, injectStyles, lightThemeVariables, log, mergeThemes, minimalThemeVariables, parseHighlightedParts, parseQueryHighlightParts, prefersHighContrast, prefersReducedMotion, setAriaDescribedBy, setDefaultLogger, setLogLevel, setLogPrefix, setLogTimestamp, setTheme, stripHighlightTags, themeToCSSVariables };
+/**
+ * Analytics beacon utility
+ *
+ * Uses navigator.sendBeacon() for reliable event delivery during page navigation,
+ * with fetch() as the primary method for normal operation.
+ */
+/**
+ * Send an analytics event using sendBeacon (for page unload scenarios)
+ * or fetch (for normal operation). Returns true if the event was queued.
+ */
+function sendAnalyticsBeacon(url, payload) {
+    const body = JSON.stringify(payload);
+    // Try sendBeacon first (works during page unload)
+    if (typeof navigator !== 'undefined' && navigator.sendBeacon) {
+        const blob = new Blob([body], { type: 'application/json' });
+        return navigator.sendBeacon(url, blob);
+    }
+    // Fallback to fetch with keepalive
+    if (typeof fetch !== 'undefined') {
+        fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body,
+            keepalive: true,
+        }).catch(() => {
+            // Silently fail — beacon is best-effort
+        });
+        return true;
+    }
+    return false;
+}
+/**
+ * Send an analytics event via fetch (normal operation).
+ * Returns the fetch promise for awaiting if needed.
+ */
+async function sendAnalyticsEvent(url, payload) {
+    if (typeof fetch === 'undefined')
+        return false;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+
+export { Fingerprint, LogLevel, SearchStateManager, URLRouter, announce, announceFilterChange, announceResults, createFocusTrap, createKeyboardShortcuts, createLogger, createRovingTabIndex, createTheme, createURLRouter, darkThemeVariables, extractField, focusFirstError, formatPrice, generateCompleteStylesheet, generateId, generateThemeStylesheet, getFingerprint, getFocusableElements, getHighlightedValue, getLogger, getNestedValue$1 as getNestedValue, getSnippetedValue, getTheme, handleKeyboardNavigation, highContrastThemeVariables, highlightQuery, injectStyles, lightThemeVariables, log, mergeThemes, minimalThemeVariables, parseHighlightedParts, parseQueryHighlightParts, prefersHighContrast, prefersReducedMotion, sendAnalyticsBeacon, sendAnalyticsEvent, setAriaDescribedBy, setDefaultLogger, setLogLevel, setLogPrefix, setLogTimestamp, setTheme, stripHighlightTags, themeToCSSVariables };
 //# sourceMappingURL=index.esm.js.map