@seekora-ai/ui-sdk-core 0.2.23 → 0.2.25

package/dist/index.d.ts

@@ -323,8 +323,11 @@ declare class SearchStateManager {
     private state;
     private listeners;
     private debounceTimer;
+    private notifyScheduled;
     private autoSearch;
     private debounceMs;
+    private searchCoalesceTimer;
+    private searchCoalesceResolvers;
     private defaultSearchOptions;
     private keepResultsOnClear;
     private abTestId?;
@@ -345,6 +348,7 @@ declare class SearchStateManager {
     setSortBy(sortBy: string, triggerSearch?: boolean): void;
     setItemsPerPage(itemsPerPage: number, triggerSearch?: boolean): void;
     search(additionalOptions?: Partial<SearchOptions>): Promise<SearchResponse | null>;
+    private _executeSearch;
     private buildSearchOptions;
     private debouncedSearch;
     subscribe(listener: (state: SearchState) => void): () => void;

package/dist/index.esm.js

@@ -1392,6 +1392,9 @@ class SearchStateManager {
     constructor(config) {
         this.listeners = [];
         this.debounceTimer = null;
+        this.notifyScheduled = false;
+        this.searchCoalesceTimer = null;
+        this.searchCoalesceResolvers = [];
         this.client = config.client;
         this.autoSearch = config.autoSearch !== false;
         this.debounceMs = config.debounceMs || 300;
@@ -1536,13 +1539,27 @@ class SearchStateManager {
             this.debouncedSearch();
         }
     }
-    // Manual search trigger
+    // Manual search trigger — coalesces rapid calls within 10ms into a single API request
     async search(additionalOptions) {
         // Clear debounce timer if exists
         if (this.debounceTimer) {
             clearTimeout(this.debounceTimer);
             this.debounceTimer = null;
         }
+        return new Promise((resolve, reject) => {
+            this.searchCoalesceResolvers.push({ resolve, reject });
+            if (this.searchCoalesceTimer) {
+                clearTimeout(this.searchCoalesceTimer);
+            }
+            this.searchCoalesceTimer = setTimeout(() => {
+                this.searchCoalesceTimer = null;
+                const resolvers = [...this.searchCoalesceResolvers];
+                this.searchCoalesceResolvers = [];
+                this._executeSearch(additionalOptions).then((result) => resolvers.forEach(r => r.resolve(result)), (err) => resolvers.forEach(r => r.reject(err)));
+            }, 10);
+        });
+    }
+    async _executeSearch(additionalOptions) {
         this.setState({ loading: true, error: null });
         try {
             const searchOptions = this.buildSearchOptions(additionalOptions);
@@ -1639,19 +1656,27 @@ class SearchStateManager {
         this.state = { ...this.state, ...updates };
         this.notifyListeners();
     }
-    // Notify all listeners of state changes
+    // Notify all listeners of state changes, batched via microtask.
+    // Multiple synchronous mutations (e.g. addRefinement + page reset)
+    // coalesce into a single listener notification.
     notifyListeners() {
-        const state = this.getState();
-        this.listeners.forEach(listener => {
-            try {
-                listener(state);
-            }
-            catch (err) {
-                const error = err instanceof Error ? err : new Error(String(err));
-                log.error('SearchStateManager: Error in listener', {
-                    error: error.message,
-                });
-            }
+        if (this.notifyScheduled)
+            return;
+        this.notifyScheduled = true;
+        queueMicrotask(() => {
+            this.notifyScheduled = false;
+            const state = this.getState();
+            this.listeners.forEach(listener => {
+                try {
+                    listener(state);
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    log.error('SearchStateManager: Error in listener', {
+                        error: error.message,
+                    });
+                }
+            });
         });
     }
     /** Explicitly clear results (bypasses keepResultsOnClear) */
@@ -1697,10 +1722,13 @@ class SearchStateManager {
     async fetchFilters(options) {
         log.verbose('SearchStateManager: Fetching filters', { options });
         try {
-            const filterString = this.buildFilterString();
+            // Do NOT pass refinement-based filters to the Filters API.
+            // Facets should be generated from the search query only, not narrowed
+            // by active filter selections. This keeps facet options stable when
+            // users toggle filters (same behaviour as performSimplifiedFacetSearch
+            // in the search API).
             const response = await this.client.getFilters({
                 q: this.state.query || undefined,
-                filter: filterString || undefined,
                 ...options,
             });
             log.info('SearchStateManager: Filters fetched', {