@blotoutio/providers-evo-search-sdk 1.56.1 → 1.57.0

package/core.cjs.js

@@ -689,6 +689,10 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         logger.info('EvoSearch API: Fetching trending searches');
         return getJSON('/trending', 'Trending', undefined, signal);
     };
+    const config = (signal) => {
+        logger.info('EvoSearch API: Fetching ask config');
+        return getJSON('/config', 'Config', undefined, signal);
+    };
     const recents = (signal) => {
         logger.info('EvoSearch API: Fetching recent searches');
         return getJSON('/user/recents', 'Recents', undefined, signal);
@@ -723,6 +727,58 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
         return data;
     };
+    // SSE consumer for Ask AI. Decodes `event: <type>\ndata: <json>` frames
+    // from the worker stream and yields typed events as they arrive. Caller
+    // aborts via the AbortSignal — fetch teardown closes the underlying
+    // reader, the for-await loop drops out, and the iterator returns.
+    async function* askStream(query, signal) {
+        const url = getURL('/ask');
+        const response = await fetchImpl(url, {
+            method: 'POST',
+            headers: (() => {
+                const h = getHeaders();
+                h.set('Content-Type', 'application/json');
+                return h;
+            })(),
+            body: JSON.stringify({ query }),
+            credentials: 'omit',
+            signal,
+        });
+        if (!response.ok || !response.body) {
+            throw new Error(`Ask failed - ${response.status}`);
+        }
+        const reader = response.body
+            .pipeThrough(new TextDecoderStream())
+            .getReader();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                buffer += value;
+                let boundary = buffer.indexOf('\n\n');
+                while (boundary !== -1) {
+                    const frame = buffer.slice(0, boundary);
+                    buffer = buffer.slice(boundary + 2);
+                    const event = parseSseFrame(frame);
+                    if (event) {
+                        yield event;
+                    }
+                    boundary = buffer.indexOf('\n\n');
+                }
+            }
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
     const sendEvent = (action, currency, actionData, clickData, beacon) => {
         // Send event to backend /user/event endpoint for storage
         fetchImpl(getURL('/user/event'), {
@@ -766,15 +822,40 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     return {
         autocomplete,
         trending,
+        config,
         user: {
             recents,
             deleteRecent,
             clearRecents,
         },
         search,
+        askStream,
         sendEvent,
     };
 };
+const parseSseFrame = (frame) => {
+    let eventType = '';
+    const dataLines = [];
+    for (const line of frame.split('\n')) {
+        if (line.startsWith('event:')) {
+            eventType = line.slice(6).trim();
+        }
+        else if (line.startsWith('data:')) {
+            dataLines.push(line.slice(5).trim());
+        }
+    }
+    if (!eventType) {
+        return null;
+    }
+    try {
+        const data = dataLines.join('\n');
+        const parsed = data ? JSON.parse(data) : {};
+        return { type: eventType, ...parsed };
+    }
+    catch {
+        return null;
+    }
+};
 
 const error = (message) => console.error(message);
 const init = (params) => {
@@ -794,8 +875,9 @@ const init = (params) => {
                 error('EvoSearch SDK: Failed to set previewEvoSearch sessionStorage');
             }
         }
-        const { enabled, uiPreferences } = (_c = (_b = params.manifest) === null || _b === void 0 ? void 0 : _b.variables) !== null && _c !== void 0 ? _c : {};
+        const { enabled, uiPreferences, askAi } = (_c = (_b = params.manifest) === null || _b === void 0 ? void 0 : _b.variables) !== null && _c !== void 0 ? _c : {};
         const mode = uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.mode;
+        const askAiEnabled = (askAi === null || askAi === void 0 ? void 0 : askAi.enabled) === true;
         const hasPreview = hasPreviewKey();
         const shouldEnable = enabled || hasPreview;
         if (!shouldEnable) {
@@ -840,6 +922,7 @@ const init = (params) => {
             handpickedProducts: [],
             api: evoSearchAPI,
             uiPreferences,
+            askAiEnabled,
         });
         params.sendTag({
             eventId: crypto.randomUUID(),

package/core.js

@@ -690,6 +690,10 @@ var ProvidersEvoSearchSdk = (function () {
             logger.info('EvoSearch API: Fetching trending searches');
             return getJSON('/trending', 'Trending', undefined, signal);
         };
+        const config = (signal) => {
+            logger.info('EvoSearch API: Fetching ask config');
+            return getJSON('/config', 'Config', undefined, signal);
+        };
         const recents = (signal) => {
             logger.info('EvoSearch API: Fetching recent searches');
             return getJSON('/user/recents', 'Recents', undefined, signal);
@@ -724,6 +728,58 @@ var ProvidersEvoSearchSdk = (function () {
             logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
             return data;
         };
+        // SSE consumer for Ask AI. Decodes `event: <type>\ndata: <json>` frames
+        // from the worker stream and yields typed events as they arrive. Caller
+        // aborts via the AbortSignal — fetch teardown closes the underlying
+        // reader, the for-await loop drops out, and the iterator returns.
+        async function* askStream(query, signal) {
+            const url = getURL('/ask');
+            const response = await fetchImpl(url, {
+                method: 'POST',
+                headers: (() => {
+                    const h = getHeaders();
+                    h.set('Content-Type', 'application/json');
+                    return h;
+                })(),
+                body: JSON.stringify({ query }),
+                credentials: 'omit',
+                signal,
+            });
+            if (!response.ok || !response.body) {
+                throw new Error(`Ask failed - ${response.status}`);
+            }
+            const reader = response.body
+                .pipeThrough(new TextDecoderStream())
+                .getReader();
+            let buffer = '';
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) {
+                        break;
+                    }
+                    buffer += value;
+                    let boundary = buffer.indexOf('\n\n');
+                    while (boundary !== -1) {
+                        const frame = buffer.slice(0, boundary);
+                        buffer = buffer.slice(boundary + 2);
+                        const event = parseSseFrame(frame);
+                        if (event) {
+                            yield event;
+                        }
+                        boundary = buffer.indexOf('\n\n');
+                    }
+                }
+            }
+            finally {
+                try {
+                    reader.releaseLock();
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
         const sendEvent = (action, currency, actionData, clickData, beacon) => {
             // Send event to backend /user/event endpoint for storage
             fetchImpl(getURL('/user/event'), {
@@ -767,15 +823,40 @@ var ProvidersEvoSearchSdk = (function () {
         return {
             autocomplete,
             trending,
+            config,
             user: {
                 recents,
                 deleteRecent,
                 clearRecents,
             },
             search,
+            askStream,
             sendEvent,
         };
     };
+    const parseSseFrame = (frame) => {
+        let eventType = '';
+        const dataLines = [];
+        for (const line of frame.split('\n')) {
+            if (line.startsWith('event:')) {
+                eventType = line.slice(6).trim();
+            }
+            else if (line.startsWith('data:')) {
+                dataLines.push(line.slice(5).trim());
+            }
+        }
+        if (!eventType) {
+            return null;
+        }
+        try {
+            const data = dataLines.join('\n');
+            const parsed = data ? JSON.parse(data) : {};
+            return { type: eventType, ...parsed };
+        }
+        catch {
+            return null;
+        }
+    };
 
     const error = (message) => console.error(message);
     const init = (params) => {
@@ -795,8 +876,9 @@ var ProvidersEvoSearchSdk = (function () {
                     error('EvoSearch SDK: Failed to set previewEvoSearch sessionStorage');
                 }
             }
-            const { enabled, uiPreferences } = (_c = (_b = params.manifest) === null || _b === void 0 ? void 0 : _b.variables) !== null && _c !== void 0 ? _c : {};
+            const { enabled, uiPreferences, askAi } = (_c = (_b = params.manifest) === null || _b === void 0 ? void 0 : _b.variables) !== null && _c !== void 0 ? _c : {};
             const mode = uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.mode;
+            const askAiEnabled = (askAi === null || askAi === void 0 ? void 0 : askAi.enabled) === true;
             const hasPreview = hasPreviewKey();
             const shouldEnable = enabled || hasPreview;
             if (!shouldEnable) {
@@ -841,6 +923,7 @@ var ProvidersEvoSearchSdk = (function () {
                 handpickedProducts: [],
                 api: evoSearchAPI,
                 uiPreferences,
+                askAiEnabled,
             });
             params.sendTag({
                 eventId: crypto.randomUUID(),

package/core.mjs

@@ -687,6 +687,10 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         logger.info('EvoSearch API: Fetching trending searches');
         return getJSON('/trending', 'Trending', undefined, signal);
     };
+    const config = (signal) => {
+        logger.info('EvoSearch API: Fetching ask config');
+        return getJSON('/config', 'Config', undefined, signal);
+    };
     const recents = (signal) => {
         logger.info('EvoSearch API: Fetching recent searches');
         return getJSON('/user/recents', 'Recents', undefined, signal);
@@ -721,6 +725,58 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
         return data;
     };
+    // SSE consumer for Ask AI. Decodes `event: <type>\ndata: <json>` frames
+    // from the worker stream and yields typed events as they arrive. Caller
+    // aborts via the AbortSignal — fetch teardown closes the underlying
+    // reader, the for-await loop drops out, and the iterator returns.
+    async function* askStream(query, signal) {
+        const url = getURL('/ask');
+        const response = await fetchImpl(url, {
+            method: 'POST',
+            headers: (() => {
+                const h = getHeaders();
+                h.set('Content-Type', 'application/json');
+                return h;
+            })(),
+            body: JSON.stringify({ query }),
+            credentials: 'omit',
+            signal,
+        });
+        if (!response.ok || !response.body) {
+            throw new Error(`Ask failed - ${response.status}`);
+        }
+        const reader = response.body
+            .pipeThrough(new TextDecoderStream())
+            .getReader();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                buffer += value;
+                let boundary = buffer.indexOf('\n\n');
+                while (boundary !== -1) {
+                    const frame = buffer.slice(0, boundary);
+                    buffer = buffer.slice(boundary + 2);
+                    const event = parseSseFrame(frame);
+                    if (event) {
+                        yield event;
+                    }
+                    boundary = buffer.indexOf('\n\n');
+                }
+            }
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
     const sendEvent = (action, currency, actionData, clickData, beacon) => {
         // Send event to backend /user/event endpoint for storage
         fetchImpl(getURL('/user/event'), {
@@ -764,15 +820,40 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     return {
         autocomplete,
         trending,
+        config,
         user: {
             recents,
             deleteRecent,
             clearRecents,
         },
         search,
+        askStream,
         sendEvent,
     };
 };
+const parseSseFrame = (frame) => {
+    let eventType = '';
+    const dataLines = [];
+    for (const line of frame.split('\n')) {
+        if (line.startsWith('event:')) {
+            eventType = line.slice(6).trim();
+        }
+        else if (line.startsWith('data:')) {
+            dataLines.push(line.slice(5).trim());
+        }
+    }
+    if (!eventType) {
+        return null;
+    }
+    try {
+        const data = dataLines.join('\n');
+        const parsed = data ? JSON.parse(data) : {};
+        return { type: eventType, ...parsed };
+    }
+    catch {
+        return null;
+    }
+};
 
 const error = (message) => console.error(message);
 const init = (params) => {
@@ -792,8 +873,9 @@ const init = (params) => {
                 error('EvoSearch SDK: Failed to set previewEvoSearch sessionStorage');
             }
         }
-        const { enabled, uiPreferences } = (_c = (_b = params.manifest) === null || _b === void 0 ? void 0 : _b.variables) !== null && _c !== void 0 ? _c : {};
+        const { enabled, uiPreferences, askAi } = (_c = (_b = params.manifest) === null || _b === void 0 ? void 0 : _b.variables) !== null && _c !== void 0 ? _c : {};
         const mode = uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.mode;
+        const askAiEnabled = (askAi === null || askAi === void 0 ? void 0 : askAi.enabled) === true;
         const hasPreview = hasPreviewKey();
         const shouldEnable = enabled || hasPreview;
         if (!shouldEnable) {
@@ -838,6 +920,7 @@ const init = (params) => {
             handpickedProducts: [],
             api: evoSearchAPI,
             uiPreferences,
+            askAiEnabled,
         });
         params.sendTag({
             eventId: crypto.randomUUID(),

package/hooks.cjs.js

@@ -645,6 +645,7 @@ const mapAPIProductToSDKProduct = (apiProduct) => {
         handle,
         description: apiProduct.description,
         url: safeUrl,
+        inStock: apiProduct.inStock,
         image: {
             url: safeImg,
             alt: apiProduct.name,

package/hooks.d.ts

@@ -70,12 +70,65 @@ declare module '@blotoutio/providers-evo-search-sdk/hooks' {
     recents: string[]
   }
 
+  export type AskConfigResponse = {
+    askAiEnabled: boolean
+    defaultView?: 'search' | 'ask'
+    askStarters?: string[]
+  }
+
   export type EvoSearchUserAPI = {
     recents: (signal?: AbortSignal) => Promise<RecentsAPIResponse>
     deleteRecent: (value: string) => Promise<void>
     clearRecents: () => Promise<void>
   }
 
+  export type AskEvidenceProduct = {
+    id: string
+    title: string
+    vendor?: string
+    price?: number
+    compareAtPrice?: number
+    inStock?: boolean
+    imageUrl?: string
+    topTags?: string[]
+  }
+
+  export type AskEvidenceCollection = {
+    id: string
+    title: string
+    productCount?: number
+  }
+
+  export type AskEvidence = {
+    products: AskEvidenceProduct[]
+    collections: AskEvidenceCollection[]
+  }
+
+  export type AskCitations = {
+    productIds: string[]
+    collectionIds: string[]
+    resolved: Array<{
+      type: 'product' | 'collection'
+      id: string
+      title: string
+    }>
+  }
+
+  export type AskTimings = {
+    evidenceMs?: number
+    firstTokenMs?: number
+    totalMs?: number
+  }
+
+  export type AskEvent =
+    | { type: 'mode'; degraded?: string; redirect?: string }
+    | { type: 'evidence'; evidence: AskEvidence }
+    | { type: 'answer-delta'; token: string }
+    | { type: 'citations'; citations: AskCitations }
+    | { type: 'follow-ups'; chips: string[] }
+    | { type: 'done'; timings: AskTimings }
+    | { type: 'error'; message: string }
+
   export type EvoSearchAPI = {
     autocomplete: (
       query: string,
@@ -91,7 +144,9 @@ declare module '@blotoutio/providers-evo-search-sdk/hooks' {
       trending: string[]
       recommended_products: AutocompleteAPIProduct[]
     }>
+    config: (signal?: AbortSignal) => Promise<AskConfigResponse>
     user: EvoSearchUserAPI
+    askStream: (query: string, signal?: AbortSignal) => AsyncIterable<AskEvent>
     sendEvent: (
       action:
         | 'evoSearchProductRecommendationClicked'

package/hooks.mjs

@@ -643,6 +643,7 @@ const mapAPIProductToSDKProduct = (apiProduct) => {
         handle,
         description: apiProduct.description,
         url: safeUrl,
+        inStock: apiProduct.inStock,
         image: {
             url: safeImg,
             alt: apiProduct.name,