@seekora-ai/search-sdk 0.2.8 → 0.2.12

package/dist/client.d.ts

@@ -345,11 +345,17 @@ export declare class SeekoraClient {
     /**
      * Get query suggestions
      *
-     * Uses POST when filtered_tabs or include_dropdown_recommendations is set (GET does not send include_dropdown_recommendations).
-     * With returnFullResponse: true returns full shape including extensions (trending_searches, top_searches, related_searches, popular_brands, filtered_tabs).
+     * **NEW:** Full GET/POST parity! Automatically chooses the best method:
+     * - GET: Default for simple requests, including filtered_tabs with ≤5 tabs (faster, cacheable)
+     * - POST: Used for complex filtered_tabs (>5 tabs) or when explicitly requested via options.method = 'POST'
+     *
+     * With returnFullResponse: true returns full shape including extensions (dropdown_recommendations with trending products, filtered_tabs).
      *
      * @param query - Partial query to get suggestions for
      * @param options - Optional parameters for suggestions
+     * @param options.filtered_tabs - Tab configurations (now supported in GET!)
+     * @param options.include_dropdown_recommendations - Include rich dropdown data
+     * @param options.method - Explicitly set 'POST' to force POST method
      * @returns Suggestion hits array, or QuerySuggestionsFullResponse when returnFullResponse is true
      */
     getSuggestions(query: string, options?: {

package/dist/client.js

@@ -325,11 +325,17 @@ class SeekoraClient {
     /**
      * Get query suggestions
      *
-     * Uses POST when filtered_tabs or include_dropdown_recommendations is set (GET does not send include_dropdown_recommendations).
-     * With returnFullResponse: true returns full shape including extensions (trending_searches, top_searches, related_searches, popular_brands, filtered_tabs).
+     * **NEW:** Full GET/POST parity! Automatically chooses the best method:
+     * - GET: Default for simple requests, including filtered_tabs with ≤5 tabs (faster, cacheable)
+     * - POST: Used for complex filtered_tabs (>5 tabs) or when explicitly requested via options.method = 'POST'
+     *
+     * With returnFullResponse: true returns full shape including extensions (dropdown_recommendations with trending products, filtered_tabs).
      *
      * @param query - Partial query to get suggestions for
      * @param options - Optional parameters for suggestions
+     * @param options.filtered_tabs - Tab configurations (now supported in GET!)
+     * @param options.include_dropdown_recommendations - Include rich dropdown data
+     * @param options.method - Explicitly set 'POST' to force POST method
      * @returns Suggestion hits array, or QuerySuggestionsFullResponse when returnFullResponse is true
      */
     async getSuggestions(query, options) {
@@ -345,10 +351,14 @@ class SeekoraClient {
                 headers['x-anon-id'] = this.anonId;
             if (this.sessionId)
                 headers['x-session-id'] = this.sessionId;
-            const usePost = (options?.filtered_tabs && options.filtered_tabs.length > 0) ||
-                options?.include_dropdown_recommendations === true ||
-                options?.include_dropdown_product_list === false ||
-                options?.include_filtered_tabs === false;
+            // Use POST for:
+            // - Complex filtered_tabs (5+ tabs or very long JSON would exceed URL limits)
+            // - Explicit preference for POST (options.method === 'POST')
+            // Use GET for everything else (including simple filtered_tabs)
+            const hasComplexFilteredTabs = options?.filtered_tabs &&
+                options.filtered_tabs.length > 5;
+            const usePost = hasComplexFilteredTabs ||
+                options?.method === 'POST'; // Allow explicit POST preference
             const defaults = this.clientConfig?.suggestionsDefaults;
             const buildRequestBody = () => {
                 const body = {
@@ -406,15 +416,27 @@ class SeekoraClient {
                 });
                 return suggestions;
             }
-            // GET for simple requests (no filtered_tabs, no include_dropdown_recommendations)
+            // GET for simple requests and simple filtered_tabs (URL-encoded JSON)
             this.logger.verbose('Using GET endpoint', {
                 endpoint: '/api/v1/suggestions/queries',
                 query,
+                hasFilteredTabs: !!(options?.filtered_tabs && options.filtered_tabs.length > 0),
             });
             const analyticsTags = Array.isArray(options?.analytics_tags)
                 ? options.analytics_tags.join(',')
                 : options?.analytics_tags;
-            const response = await this.suggestionsApi.v1SuggestionsQueriesGet(this.storeId, this.readSecret, this.userId, this.anonId, this.sessionId, query, options?.hitsPerPage || 5, options?.page, analyticsTags, options?.tags_match_mode, options?.include_categories, options?.include_facets, options?.max_categories, options?.max_facets, options?.min_popularity, options?.time_range, options?.disable_typo_tolerance, { headers });
+            // Encode filtered_tabs as JSON string for URL parameter
+            const filteredTabsParam = options?.filtered_tabs
+                ? JSON.stringify(options.filtered_tabs)
+                : undefined;
+            const response = await this.suggestionsApi.v1SuggestionsQueriesGet(this.storeId, this.readSecret, this.userId, this.anonId, this.sessionId, query, // query parameter
+            undefined, // q parameter (alias for query)
+            options?.hitsPerPage || 5, options?.page, analyticsTags, options?.tags_match_mode, options?.include_categories, options?.include_facets, options?.include_dropdown_recommendations, options?.include_dropdown_product_list, options?.include_filtered_tabs, undefined, // include_empty_query_recommendations
+            options?.max_categories, options?.max_facets, options?.min_popularity, options?.time_range, options?.disable_typo_tolerance, filteredTabsParam, // filtered_tabs as JSON string
+            undefined, // userId (using header instead)
+            undefined, // anonId (using header instead)
+            undefined, // sessionId (using header instead)
+            { headers });
             const responseData = response.data?.data || response.data;
             const suggestions = responseData?.results?.[0]?.hits || responseData?.hits || [];
             if (options?.returnFullResponse) {