@blotoutio/providers-evo-search-sdk 1.58.0 → 1.59.0

package/core.cjs.js

@@ -656,8 +656,8 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     };
     // Only `/user/*` endpoints return per-user PII (recents, profile-bound
     // data) and rely on the worker's HMAC-signed cookie. Sending
-    // `credentials: 'include'` on the public read endpoints (autocomplete,
-    // search, trending) is pointless and triggers the strict CORS contract
+    // `credentials: 'include'` on the public read endpoints (search,
+    // trending) is pointless and triggers the strict CORS contract
     // (`Allow-Credentials: true` + non-wildcard origin echo) on every
     // response — so default to `omit` and opt in below.
     const needsCredentials = (path) => path.startsWith('/user/');
@@ -679,12 +679,6 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         }
         return (await response.json());
     };
-    const autocomplete = async (query, limit = 8, signal) => {
-        logger.info(`EvoSearch API: Autocomplete request - query length: ${query.length}, limit: ${limit}`);
-        const data = await getJSON('/autocomplete', 'Autocomplete', { q: query, limit: String(limit) }, signal);
-        logger.info(`EvoSearch API: Autocomplete success - ${data.llmSuggestions.length} suggestions, ${data.products.length} products`);
-        return data;
-    };
     const trending = (signal) => {
         logger.info('EvoSearch API: Fetching trending searches');
         return getJSON('/trending', 'Trending', undefined, signal);
@@ -693,6 +687,17 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         logger.info('EvoSearch API: Fetching ask config');
         return getJSON('/config', 'Config', undefined, signal);
     };
+    // Fire-and-forget isolate warmer: tells the worker to prime its search
+    // index off the request path so the first keystroke doesn't pay the cold
+    // prime. Errors are irrelevant — autocomplete just falls back to priming
+    // inline like before.
+    const warm = () => {
+        fetchImpl(getURL('/warm'), {
+            method: 'GET',
+            headers: getHeaders(),
+            credentials: 'omit',
+        }).catch(() => undefined);
+    };
     const recents = (signal) => {
         logger.info('EvoSearch API: Fetching recent searches');
         return getJSON('/user/recents', 'Recents', undefined, signal);
@@ -724,7 +729,7 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     const search = async (query, limit = 8, signal) => {
         logger.info(`EvoSearch API: Search request - query length: ${query.length}, limit: ${limit}`);
         const data = await getJSON('/search', 'Search', { q: query, limit: String(limit) }, signal);
-        logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
+        logger.info(`EvoSearch API: Search success - ${data.llmSuggestions.length} suggestions, ${data.products.length} products`);
         return data;
     };
     // SSE consumer for Ask AI. Decodes `event: <type>\ndata: <json>` frames
@@ -793,6 +798,11 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
                 },
             }),
             credentials: 'include',
+            // Finalize events often fire at widget teardown (disconnectedCallback
+            // settles the on-screen query) — i.e. right as the shopper navigates
+            // away after a result click. keepalive lets the POST outlive the page;
+            // sendBeacon can't carry the identity headers or credentials.
+            keepalive: true,
         })
             .then(async (response) => {
             if (!response.ok) {
@@ -820,9 +830,9 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         });
     };
     return {
-        autocomplete,
         trending,
         config,
+        warm,
         user: {
             recents,
             deleteRecent,

package/core.js

@@ -657,8 +657,8 @@ var ProvidersEvoSearchSdk = (function () {
         };
         // Only `/user/*` endpoints return per-user PII (recents, profile-bound
         // data) and rely on the worker's HMAC-signed cookie. Sending
-        // `credentials: 'include'` on the public read endpoints (autocomplete,
-        // search, trending) is pointless and triggers the strict CORS contract
+        // `credentials: 'include'` on the public read endpoints (search,
+        // trending) is pointless and triggers the strict CORS contract
         // (`Allow-Credentials: true` + non-wildcard origin echo) on every
         // response — so default to `omit` and opt in below.
         const needsCredentials = (path) => path.startsWith('/user/');
@@ -680,12 +680,6 @@ var ProvidersEvoSearchSdk = (function () {
             }
             return (await response.json());
         };
-        const autocomplete = async (query, limit = 8, signal) => {
-            logger.info(`EvoSearch API: Autocomplete request - query length: ${query.length}, limit: ${limit}`);
-            const data = await getJSON('/autocomplete', 'Autocomplete', { q: query, limit: String(limit) }, signal);
-            logger.info(`EvoSearch API: Autocomplete success - ${data.llmSuggestions.length} suggestions, ${data.products.length} products`);
-            return data;
-        };
         const trending = (signal) => {
             logger.info('EvoSearch API: Fetching trending searches');
             return getJSON('/trending', 'Trending', undefined, signal);
@@ -694,6 +688,17 @@ var ProvidersEvoSearchSdk = (function () {
             logger.info('EvoSearch API: Fetching ask config');
             return getJSON('/config', 'Config', undefined, signal);
         };
+        // Fire-and-forget isolate warmer: tells the worker to prime its search
+        // index off the request path so the first keystroke doesn't pay the cold
+        // prime. Errors are irrelevant — autocomplete just falls back to priming
+        // inline like before.
+        const warm = () => {
+            fetchImpl(getURL('/warm'), {
+                method: 'GET',
+                headers: getHeaders(),
+                credentials: 'omit',
+            }).catch(() => undefined);
+        };
         const recents = (signal) => {
             logger.info('EvoSearch API: Fetching recent searches');
             return getJSON('/user/recents', 'Recents', undefined, signal);
@@ -725,7 +730,7 @@ var ProvidersEvoSearchSdk = (function () {
         const search = async (query, limit = 8, signal) => {
             logger.info(`EvoSearch API: Search request - query length: ${query.length}, limit: ${limit}`);
             const data = await getJSON('/search', 'Search', { q: query, limit: String(limit) }, signal);
-            logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
+            logger.info(`EvoSearch API: Search success - ${data.llmSuggestions.length} suggestions, ${data.products.length} products`);
             return data;
         };
         // SSE consumer for Ask AI. Decodes `event: <type>\ndata: <json>` frames
@@ -794,6 +799,11 @@ var ProvidersEvoSearchSdk = (function () {
                     },
                 }),
                 credentials: 'include',
+                // Finalize events often fire at widget teardown (disconnectedCallback
+                // settles the on-screen query) — i.e. right as the shopper navigates
+                // away after a result click. keepalive lets the POST outlive the page;
+                // sendBeacon can't carry the identity headers or credentials.
+                keepalive: true,
             })
                 .then(async (response) => {
                 if (!response.ok) {
@@ -821,9 +831,9 @@ var ProvidersEvoSearchSdk = (function () {
             });
         };
         return {
-            autocomplete,
             trending,
             config,
+            warm,
             user: {
                 recents,
                 deleteRecent,

package/core.mjs

@@ -654,8 +654,8 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     };
     // Only `/user/*` endpoints return per-user PII (recents, profile-bound
     // data) and rely on the worker's HMAC-signed cookie. Sending
-    // `credentials: 'include'` on the public read endpoints (autocomplete,
-    // search, trending) is pointless and triggers the strict CORS contract
+    // `credentials: 'include'` on the public read endpoints (search,
+    // trending) is pointless and triggers the strict CORS contract
     // (`Allow-Credentials: true` + non-wildcard origin echo) on every
     // response — so default to `omit` and opt in below.
     const needsCredentials = (path) => path.startsWith('/user/');
@@ -677,12 +677,6 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         }
         return (await response.json());
     };
-    const autocomplete = async (query, limit = 8, signal) => {
-        logger.info(`EvoSearch API: Autocomplete request - query length: ${query.length}, limit: ${limit}`);
-        const data = await getJSON('/autocomplete', 'Autocomplete', { q: query, limit: String(limit) }, signal);
-        logger.info(`EvoSearch API: Autocomplete success - ${data.llmSuggestions.length} suggestions, ${data.products.length} products`);
-        return data;
-    };
     const trending = (signal) => {
         logger.info('EvoSearch API: Fetching trending searches');
         return getJSON('/trending', 'Trending', undefined, signal);
@@ -691,6 +685,17 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         logger.info('EvoSearch API: Fetching ask config');
         return getJSON('/config', 'Config', undefined, signal);
     };
+    // Fire-and-forget isolate warmer: tells the worker to prime its search
+    // index off the request path so the first keystroke doesn't pay the cold
+    // prime. Errors are irrelevant — autocomplete just falls back to priming
+    // inline like before.
+    const warm = () => {
+        fetchImpl(getURL('/warm'), {
+            method: 'GET',
+            headers: getHeaders(),
+            credentials: 'omit',
+        }).catch(() => undefined);
+    };
     const recents = (signal) => {
         logger.info('EvoSearch API: Fetching recent searches');
         return getJSON('/user/recents', 'Recents', undefined, signal);
@@ -722,7 +727,7 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     const search = async (query, limit = 8, signal) => {
         logger.info(`EvoSearch API: Search request - query length: ${query.length}, limit: ${limit}`);
         const data = await getJSON('/search', 'Search', { q: query, limit: String(limit) }, signal);
-        logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
+        logger.info(`EvoSearch API: Search success - ${data.llmSuggestions.length} suggestions, ${data.products.length} products`);
         return data;
     };
     // SSE consumer for Ask AI. Decodes `event: <type>\ndata: <json>` frames
@@ -791,6 +796,11 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
                 },
             }),
             credentials: 'include',
+            // Finalize events often fire at widget teardown (disconnectedCallback
+            // settles the on-screen query) — i.e. right as the shopper navigates
+            // away after a result click. keepalive lets the POST outlive the page;
+            // sendBeacon can't carry the identity headers or credentials.
+            keepalive: true,
         })
             .then(async (response) => {
             if (!response.ok) {
@@ -818,9 +828,9 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         });
     };
     return {
-        autocomplete,
         trending,
         config,
+        warm,
         user: {
             recents,
             deleteRecent,

package/hooks.cjs.js

@@ -665,9 +665,6 @@ const processAutocompleteResponse = (response) => {
         products: response.products.map(mapAPIProductToSDKProduct),
     };
 };
-const processSearchResponse = (response) => {
-    return response.results.map(mapAPIProductToSDKProduct);
-};
 
 const isDevEnv$1 = () => typeof process != 'undefined' && process.env['NODE_ENV'] != 'production';
 const emptyReturn = (query, setQuery, trackClick) => ({
@@ -707,9 +704,10 @@ const useEvoSearch = (options = {}) => {
             setError(null);
             return;
         }
-        const wantsSearch = mode === 'search' || mode === 'both';
-        const wantsAutocomplete = mode === 'autocomplete' || mode === 'both';
-        if (!wantsAutocomplete) {
+        // A single /search call serves both results and suggestions; `mode` only
+        // controls whether the suggestions state populates.
+        const wantsSuggestions = mode === 'autocomplete' || mode === 'both';
+        if (!wantsSuggestions) {
             setSuggestions([]);
         }
         setLoading(true);
@@ -717,28 +715,17 @@ const useEvoSearch = (options = {}) => {
         const controller = new AbortController();
         const timer = setTimeout(async () => {
             try {
-                const [searchRes, autocompleteRes] = await Promise.all([
-                    wantsSearch ? api.search(query, undefined, controller.signal) : null,
-                    wantsAutocomplete
-                        ? api.autocomplete(query, undefined, controller.signal)
-                        : null,
-                ]);
-                if (searchRes) {
-                    setResults(processSearchResponse(searchRes));
-                }
-                if (autocompleteRes) {
+                const res = await api.search(query, undefined, controller.signal);
+                setResults(processAutocompleteResponse(res).products);
+                if (wantsSuggestions) {
                     setSuggestions((prev) => {
-                        const next = autocompleteRes.llmSuggestions;
+                        const next = res.llmSuggestions;
                         if (prev.length === next.length &&
                             prev.every((p, i) => p.phrase === next[i])) {
                             return prev;
                         }
                         return next.map((phrase) => ({ phrase }));
                     });
-                    if (!searchRes) {
-                        const processed = processAutocompleteResponse(autocompleteRes);
-                        setResults(processed.products);
-                    }
                 }
             }
             catch (err) {

package/hooks.d.ts

@@ -56,14 +56,6 @@ declare module '@blotoutio/providers-evo-search-sdk/hooks' {
     llmSuggestions: string[]
     products: AutocompleteAPIProduct[]
     collections?: AutocompleteAPICollection[]
-    didYouMean?: string
-  }
-
-  export type SearchAPIResponse = {
-    query: string
-    results: AutocompleteAPIProduct[]
-    collections?: AutocompleteAPICollection[]
-    didYouMean?: string
   }
 
   export type RecentsAPIResponse = {
@@ -130,21 +122,17 @@ declare module '@blotoutio/providers-evo-search-sdk/hooks' {
     | { type: 'error'; message: string }
 
   export type EvoSearchAPI = {
-    autocomplete: (
-      query: string,
-      limit?: number,
-      signal?: AbortSignal
-    ) => Promise<AutocompleteAPIResponse>
     search: (
       query: string,
       limit?: number,
       signal?: AbortSignal
-    ) => Promise<SearchAPIResponse>
+    ) => Promise<AutocompleteAPIResponse>
     trending: (signal?: AbortSignal) => Promise<{
       trending: string[]
       recommended_products: AutocompleteAPIProduct[]
     }>
     config: (signal?: AbortSignal) => Promise<AskConfigResponse>
+    warm: () => void
     user: EvoSearchUserAPI
     askStream: (query: string, signal?: AbortSignal) => AsyncIterable<AskEvent>
     sendEvent: (

package/hooks.mjs

@@ -663,9 +663,6 @@ const processAutocompleteResponse = (response) => {
         products: response.products.map(mapAPIProductToSDKProduct),
     };
 };
-const processSearchResponse = (response) => {
-    return response.results.map(mapAPIProductToSDKProduct);
-};
 
 const isDevEnv$1 = () => typeof process != 'undefined' && process.env['NODE_ENV'] != 'production';
 const emptyReturn = (query, setQuery, trackClick) => ({
@@ -705,9 +702,10 @@ const useEvoSearch = (options = {}) => {
             setError(null);
             return;
         }
-        const wantsSearch = mode === 'search' || mode === 'both';
-        const wantsAutocomplete = mode === 'autocomplete' || mode === 'both';
-        if (!wantsAutocomplete) {
+        // A single /search call serves both results and suggestions; `mode` only
+        // controls whether the suggestions state populates.
+        const wantsSuggestions = mode === 'autocomplete' || mode === 'both';
+        if (!wantsSuggestions) {
             setSuggestions([]);
         }
         setLoading(true);
@@ -715,28 +713,17 @@ const useEvoSearch = (options = {}) => {
         const controller = new AbortController();
         const timer = setTimeout(async () => {
             try {
-                const [searchRes, autocompleteRes] = await Promise.all([
-                    wantsSearch ? api.search(query, undefined, controller.signal) : null,
-                    wantsAutocomplete
-                        ? api.autocomplete(query, undefined, controller.signal)
-                        : null,
-                ]);
-                if (searchRes) {
-                    setResults(processSearchResponse(searchRes));
-                }
-                if (autocompleteRes) {
+                const res = await api.search(query, undefined, controller.signal);
+                setResults(processAutocompleteResponse(res).products);
+                if (wantsSuggestions) {
                     setSuggestions((prev) => {
-                        const next = autocompleteRes.llmSuggestions;
+                        const next = res.llmSuggestions;
                         if (prev.length === next.length &&
                             prev.every((p, i) => p.phrase === next[i])) {
                             return prev;
                         }
                         return next.map((phrase) => ({ phrase }));
                     });
-                    if (!searchRes) {
-                        const processed = processAutocompleteResponse(autocompleteRes);
-                        setResults(processed.products);
-                    }
                 }
             }
             catch (err) {