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

package/core.cjs.js

@@ -511,6 +511,15 @@ new Set([
     OFFLINE_TOUCH,
 ]);
 
+const CURRENCY_CODE_PATTERN = /^[A-Z]{3}$/;
+const parseCurrencyCode = (value) => {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const code = value.trim().toUpperCase();
+    return CURRENCY_CODE_PATTERN.test(code) ? code : undefined;
+};
+
 const uiActions = new Set([
     'evoSearchProductRecommendationClicked',
     'evoSearchProductClicked',
@@ -601,7 +610,24 @@ const notifyReady = () => {
     notifySubscribers(registry.subscribers, 'notifyReady');
 };
 
-const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId, sessionId, sendTag, }) => {
+// Always defer to what the storefront itself is rendering — same source
+// shop-gpt reads from. Two widgets on the same page would otherwise drift:
+// shop-gpt picks Shopify, evo-search would pick its own override and show
+// the same product in a different currency. `uiPreferences.currency` is
+// kept as a last-resort fallback for non-Shopify hosts; 'USD' is the
+// final default to match shop-gpt's behaviour.
+const readShopifyCurrency = () => {
+    var _a;
+    try {
+        const shopify = window.Shopify;
+        return parseCurrencyCode((_a = shopify === null || shopify === void 0 ? void 0 : shopify.currency) === null || _a === void 0 ? void 0 : _a.active);
+    }
+    catch {
+        return undefined;
+    }
+};
+const resolveDisplayCurrency = (uiPreferences) => { var _a, _b; return (_b = (_a = readShopifyCurrency()) !== null && _a !== void 0 ? _a : parseCurrencyCode(uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.currency)) !== null && _b !== void 0 ? _b : 'USD'; };
+const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId, sessionId, sendTag, uiPreferences, }) => {
     if (!baseURL) {
         throw new Error('baseURL missing');
     }
@@ -618,62 +644,82 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         }
         return headers;
     };
+    // Parsing `baseURL` once at API construction avoids re-parsing the host on
+    // every keystroke when `getURL` runs inside the autocomplete hot path.
+    const baseOrigin = new URL(baseURL).origin;
+    const PROVIDER_PATH_PREFIX = '/providers/evoSearch';
     const getURL = (path) => {
-        return new URL(`/providers/evoSearch${path}`, baseURL);
+        const url = new URL(baseOrigin);
+        url.pathname = `${PROVIDER_PATH_PREFIX}${path}`;
+        url.searchParams.set('currency', resolveDisplayCurrency(uiPreferences));
+        return url;
     };
-    const autocomplete = async (query, limit = 8, signal) => {
-        const url = getURL('/autocomplete');
-        url.searchParams.set('q', query);
-        url.searchParams.set('limit', limit.toString());
-        const headers = getHeaders();
-        logger.info(`EvoSearch API: Autocomplete request - query length: ${query.length}, limit: ${limit}`);
+    // 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
+    // (`Allow-Credentials: true` + non-wildcard origin echo) on every
+    // response — so default to `omit` and opt in below.
+    const needsCredentials = (path) => path.startsWith('/user/');
+    const getJSON = async (path, label, params, signal) => {
+        const url = getURL(path);
+        for (const [key, value] of Object.entries(params !== null && params !== void 0 ? params : {})) {
+            url.searchParams.set(key, value);
+        }
         const response = await fetchImpl(url, {
             method: 'GET',
-            headers,
-            credentials: 'include',
+            headers: getHeaders(),
+            credentials: needsCredentials(path) ? 'include' : 'omit',
             signal,
         });
         if (!response.ok) {
-            const errorText = await response.text();
-            logger.error(`EvoSearch API: Autocomplete failed - ${response.status}: ${errorText}`);
-            throw new Error(`Autocomplete failed - ${response.status}`);
+            const errorText = await response.text().catch(() => '');
+            logger.error(`EvoSearch API: ${label} failed - ${response.status}: ${errorText}`);
+            throw new Error(`${label} failed - ${response.status}`);
         }
-        const data = (await response.json());
+        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 = async (signal) => {
-        const url = getURL('/trending');
+    const trending = (signal) => {
         logger.info('EvoSearch API: Fetching trending searches');
-        const response = await fetchImpl(url, {
-            method: 'GET',
-            headers: getHeaders(),
-            credentials: 'include',
-            signal,
-        });
-        if (!response.ok) {
-            throw new Error(`Trending failed - ${response.status}`);
+        return getJSON('/trending', 'Trending', undefined, signal);
+    };
+    const recents = (signal) => {
+        logger.info('EvoSearch API: Fetching recent searches');
+        return getJSON('/user/recents', 'Recents', undefined, signal);
+    };
+    const sendMutation = async (path, label, method, params) => {
+        const url = getURL(path);
+        for (const [key, value] of Object.entries(params !== null && params !== void 0 ? params : {})) {
+            url.searchParams.set(key, value);
+        }
+        try {
+            const response = await fetchImpl(url, {
+                method,
+                headers: getHeaders(),
+                credentials: 'include',
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => '');
+                logger.error(`EvoSearch API: ${label} failed - ${response.status}: ${errorText}`);
+                throw new Error(`${label} failed - ${response.status}`);
+            }
+        }
+        catch (error) {
+            logger.error(`EvoSearch API: ${label} threw`, error);
+            throw error;
         }
-        return await response.json();
     };
+    const deleteRecent = (value) => sendMutation('/user/recents', 'DeleteRecent', 'DELETE', { value });
+    const clearRecents = () => sendMutation('/user/recents', 'ClearRecents', 'DELETE');
     const search = async (query, limit = 8, signal) => {
-        const url = getURL('/search');
-        url.searchParams.set('q', query);
-        url.searchParams.set('limit', limit.toString());
-        const headers = getHeaders();
         logger.info(`EvoSearch API: Search request - query length: ${query.length}, limit: ${limit}`);
-        const response = await fetchImpl(url, {
-            method: 'GET',
-            headers,
-            credentials: 'include',
-            signal,
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            logger.error(`EvoSearch API: Search failed - ${response.status}: ${errorText}`);
-            throw new Error(`Search failed - ${response.status}`);
-        }
-        const data = (await response.json());
+        const data = await getJSON('/search', 'Search', { q: query, limit: String(limit) }, signal);
         logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
         return data;
     };
@@ -720,6 +766,11 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     return {
         autocomplete,
         trending,
+        user: {
+            recents,
+            deleteRecent,
+            clearRecents,
+        },
         search,
         sendEvent,
     };
@@ -734,11 +785,20 @@ const init = (params) => {
     try {
         (_a = window[registryKey]) !== null && _a !== void 0 ? _a : (window[registryKey] = {});
         logger.info('EvoSearch SDK: Initializing');
+        if (new URLSearchParams(window.location.search).get('evs') === 'preview') {
+            try {
+                sessionStorage.setItem(previewKeyName, '1');
+                logger.info('EvoSearch SDK: Preview mode enabled via ?evs=preview URL param');
+            }
+            catch {
+                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 mode = uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.mode;
         const hasPreview = hasPreviewKey();
         const shouldEnable = enabled || hasPreview;
-        if (!shouldEnable || (mode === 'disabled' && !hasPreview)) {
+        if (!shouldEnable) {
             logger.info('EvoSearch SDK: Mode is disabled, skipping initialization');
             return;
         }
@@ -750,6 +810,7 @@ const init = (params) => {
             userId: params.userId,
             sessionId: (_d = params.session) === null || _d === void 0 ? void 0 : _d.sessionId,
             sendTag: params.sendTag,
+            uiPreferences,
         });
         window[registryKey].api = evoSearchAPI;
         const uiImplementation = window[registryKey].ui;

package/core.js

@@ -512,6 +512,15 @@ var ProvidersEvoSearchSdk = (function () {
         OFFLINE_TOUCH,
     ]);
 
+    const CURRENCY_CODE_PATTERN = /^[A-Z]{3}$/;
+    const parseCurrencyCode = (value) => {
+        if (typeof value !== 'string') {
+            return undefined;
+        }
+        const code = value.trim().toUpperCase();
+        return CURRENCY_CODE_PATTERN.test(code) ? code : undefined;
+    };
+
     const uiActions = new Set([
         'evoSearchProductRecommendationClicked',
         'evoSearchProductClicked',
@@ -602,7 +611,24 @@ var ProvidersEvoSearchSdk = (function () {
         notifySubscribers(registry.subscribers, 'notifyReady');
     };
 
-    const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId, sessionId, sendTag, }) => {
+    // Always defer to what the storefront itself is rendering — same source
+    // shop-gpt reads from. Two widgets on the same page would otherwise drift:
+    // shop-gpt picks Shopify, evo-search would pick its own override and show
+    // the same product in a different currency. `uiPreferences.currency` is
+    // kept as a last-resort fallback for non-Shopify hosts; 'USD' is the
+    // final default to match shop-gpt's behaviour.
+    const readShopifyCurrency = () => {
+        var _a;
+        try {
+            const shopify = window.Shopify;
+            return parseCurrencyCode((_a = shopify === null || shopify === void 0 ? void 0 : shopify.currency) === null || _a === void 0 ? void 0 : _a.active);
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const resolveDisplayCurrency = (uiPreferences) => { var _a, _b; return (_b = (_a = readShopifyCurrency()) !== null && _a !== void 0 ? _a : parseCurrencyCode(uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.currency)) !== null && _b !== void 0 ? _b : 'USD'; };
+    const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId, sessionId, sendTag, uiPreferences, }) => {
         if (!baseURL) {
             throw new Error('baseURL missing');
         }
@@ -619,62 +645,82 @@ var ProvidersEvoSearchSdk = (function () {
             }
             return headers;
         };
+        // Parsing `baseURL` once at API construction avoids re-parsing the host on
+        // every keystroke when `getURL` runs inside the autocomplete hot path.
+        const baseOrigin = new URL(baseURL).origin;
+        const PROVIDER_PATH_PREFIX = '/providers/evoSearch';
         const getURL = (path) => {
-            return new URL(`/providers/evoSearch${path}`, baseURL);
+            const url = new URL(baseOrigin);
+            url.pathname = `${PROVIDER_PATH_PREFIX}${path}`;
+            url.searchParams.set('currency', resolveDisplayCurrency(uiPreferences));
+            return url;
         };
-        const autocomplete = async (query, limit = 8, signal) => {
-            const url = getURL('/autocomplete');
-            url.searchParams.set('q', query);
-            url.searchParams.set('limit', limit.toString());
-            const headers = getHeaders();
-            logger.info(`EvoSearch API: Autocomplete request - query length: ${query.length}, limit: ${limit}`);
+        // 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
+        // (`Allow-Credentials: true` + non-wildcard origin echo) on every
+        // response — so default to `omit` and opt in below.
+        const needsCredentials = (path) => path.startsWith('/user/');
+        const getJSON = async (path, label, params, signal) => {
+            const url = getURL(path);
+            for (const [key, value] of Object.entries(params !== null && params !== void 0 ? params : {})) {
+                url.searchParams.set(key, value);
+            }
             const response = await fetchImpl(url, {
                 method: 'GET',
-                headers,
-                credentials: 'include',
+                headers: getHeaders(),
+                credentials: needsCredentials(path) ? 'include' : 'omit',
                 signal,
             });
             if (!response.ok) {
-                const errorText = await response.text();
-                logger.error(`EvoSearch API: Autocomplete failed - ${response.status}: ${errorText}`);
-                throw new Error(`Autocomplete failed - ${response.status}`);
+                const errorText = await response.text().catch(() => '');
+                logger.error(`EvoSearch API: ${label} failed - ${response.status}: ${errorText}`);
+                throw new Error(`${label} failed - ${response.status}`);
             }
-            const data = (await response.json());
+            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 = async (signal) => {
-            const url = getURL('/trending');
+        const trending = (signal) => {
             logger.info('EvoSearch API: Fetching trending searches');
-            const response = await fetchImpl(url, {
-                method: 'GET',
-                headers: getHeaders(),
-                credentials: 'include',
-                signal,
-            });
-            if (!response.ok) {
-                throw new Error(`Trending failed - ${response.status}`);
+            return getJSON('/trending', 'Trending', undefined, signal);
+        };
+        const recents = (signal) => {
+            logger.info('EvoSearch API: Fetching recent searches');
+            return getJSON('/user/recents', 'Recents', undefined, signal);
+        };
+        const sendMutation = async (path, label, method, params) => {
+            const url = getURL(path);
+            for (const [key, value] of Object.entries(params !== null && params !== void 0 ? params : {})) {
+                url.searchParams.set(key, value);
+            }
+            try {
+                const response = await fetchImpl(url, {
+                    method,
+                    headers: getHeaders(),
+                    credentials: 'include',
+                });
+                if (!response.ok) {
+                    const errorText = await response.text().catch(() => '');
+                    logger.error(`EvoSearch API: ${label} failed - ${response.status}: ${errorText}`);
+                    throw new Error(`${label} failed - ${response.status}`);
+                }
+            }
+            catch (error) {
+                logger.error(`EvoSearch API: ${label} threw`, error);
+                throw error;
             }
-            return await response.json();
         };
+        const deleteRecent = (value) => sendMutation('/user/recents', 'DeleteRecent', 'DELETE', { value });
+        const clearRecents = () => sendMutation('/user/recents', 'ClearRecents', 'DELETE');
         const search = async (query, limit = 8, signal) => {
-            const url = getURL('/search');
-            url.searchParams.set('q', query);
-            url.searchParams.set('limit', limit.toString());
-            const headers = getHeaders();
             logger.info(`EvoSearch API: Search request - query length: ${query.length}, limit: ${limit}`);
-            const response = await fetchImpl(url, {
-                method: 'GET',
-                headers,
-                credentials: 'include',
-                signal,
-            });
-            if (!response.ok) {
-                const errorText = await response.text();
-                logger.error(`EvoSearch API: Search failed - ${response.status}: ${errorText}`);
-                throw new Error(`Search failed - ${response.status}`);
-            }
-            const data = (await response.json());
+            const data = await getJSON('/search', 'Search', { q: query, limit: String(limit) }, signal);
             logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
             return data;
         };
@@ -721,6 +767,11 @@ var ProvidersEvoSearchSdk = (function () {
         return {
             autocomplete,
             trending,
+            user: {
+                recents,
+                deleteRecent,
+                clearRecents,
+            },
             search,
             sendEvent,
         };
@@ -735,11 +786,20 @@ var ProvidersEvoSearchSdk = (function () {
         try {
             (_a = window[registryKey]) !== null && _a !== void 0 ? _a : (window[registryKey] = {});
             logger.info('EvoSearch SDK: Initializing');
+            if (new URLSearchParams(window.location.search).get('evs') === 'preview') {
+                try {
+                    sessionStorage.setItem(previewKeyName, '1');
+                    logger.info('EvoSearch SDK: Preview mode enabled via ?evs=preview URL param');
+                }
+                catch {
+                    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 mode = uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.mode;
             const hasPreview = hasPreviewKey();
             const shouldEnable = enabled || hasPreview;
-            if (!shouldEnable || (mode === 'disabled' && !hasPreview)) {
+            if (!shouldEnable) {
                 logger.info('EvoSearch SDK: Mode is disabled, skipping initialization');
                 return;
             }
@@ -751,6 +811,7 @@ var ProvidersEvoSearchSdk = (function () {
                 userId: params.userId,
                 sessionId: (_d = params.session) === null || _d === void 0 ? void 0 : _d.sessionId,
                 sendTag: params.sendTag,
+                uiPreferences,
             });
             window[registryKey].api = evoSearchAPI;
             const uiImplementation = window[registryKey].ui;

package/core.mjs

@@ -509,6 +509,15 @@ new Set([
     OFFLINE_TOUCH,
 ]);
 
+const CURRENCY_CODE_PATTERN = /^[A-Z]{3}$/;
+const parseCurrencyCode = (value) => {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const code = value.trim().toUpperCase();
+    return CURRENCY_CODE_PATTERN.test(code) ? code : undefined;
+};
+
 const uiActions = new Set([
     'evoSearchProductRecommendationClicked',
     'evoSearchProductClicked',
@@ -599,7 +608,24 @@ const notifyReady = () => {
     notifySubscribers(registry.subscribers, 'notifyReady');
 };
 
-const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId, sessionId, sendTag, }) => {
+// Always defer to what the storefront itself is rendering — same source
+// shop-gpt reads from. Two widgets on the same page would otherwise drift:
+// shop-gpt picks Shopify, evo-search would pick its own override and show
+// the same product in a different currency. `uiPreferences.currency` is
+// kept as a last-resort fallback for non-Shopify hosts; 'USD' is the
+// final default to match shop-gpt's behaviour.
+const readShopifyCurrency = () => {
+    var _a;
+    try {
+        const shopify = window.Shopify;
+        return parseCurrencyCode((_a = shopify === null || shopify === void 0 ? void 0 : shopify.currency) === null || _a === void 0 ? void 0 : _a.active);
+    }
+    catch {
+        return undefined;
+    }
+};
+const resolveDisplayCurrency = (uiPreferences) => { var _a, _b; return (_b = (_a = readShopifyCurrency()) !== null && _a !== void 0 ? _a : parseCurrencyCode(uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.currency)) !== null && _b !== void 0 ? _b : 'USD'; };
+const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId, sessionId, sendTag, uiPreferences, }) => {
     if (!baseURL) {
         throw new Error('baseURL missing');
     }
@@ -616,62 +642,82 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
         }
         return headers;
     };
+    // Parsing `baseURL` once at API construction avoids re-parsing the host on
+    // every keystroke when `getURL` runs inside the autocomplete hot path.
+    const baseOrigin = new URL(baseURL).origin;
+    const PROVIDER_PATH_PREFIX = '/providers/evoSearch';
     const getURL = (path) => {
-        return new URL(`/providers/evoSearch${path}`, baseURL);
+        const url = new URL(baseOrigin);
+        url.pathname = `${PROVIDER_PATH_PREFIX}${path}`;
+        url.searchParams.set('currency', resolveDisplayCurrency(uiPreferences));
+        return url;
     };
-    const autocomplete = async (query, limit = 8, signal) => {
-        const url = getURL('/autocomplete');
-        url.searchParams.set('q', query);
-        url.searchParams.set('limit', limit.toString());
-        const headers = getHeaders();
-        logger.info(`EvoSearch API: Autocomplete request - query length: ${query.length}, limit: ${limit}`);
+    // 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
+    // (`Allow-Credentials: true` + non-wildcard origin echo) on every
+    // response — so default to `omit` and opt in below.
+    const needsCredentials = (path) => path.startsWith('/user/');
+    const getJSON = async (path, label, params, signal) => {
+        const url = getURL(path);
+        for (const [key, value] of Object.entries(params !== null && params !== void 0 ? params : {})) {
+            url.searchParams.set(key, value);
+        }
         const response = await fetchImpl(url, {
             method: 'GET',
-            headers,
-            credentials: 'include',
+            headers: getHeaders(),
+            credentials: needsCredentials(path) ? 'include' : 'omit',
             signal,
         });
         if (!response.ok) {
-            const errorText = await response.text();
-            logger.error(`EvoSearch API: Autocomplete failed - ${response.status}: ${errorText}`);
-            throw new Error(`Autocomplete failed - ${response.status}`);
+            const errorText = await response.text().catch(() => '');
+            logger.error(`EvoSearch API: ${label} failed - ${response.status}: ${errorText}`);
+            throw new Error(`${label} failed - ${response.status}`);
         }
-        const data = (await response.json());
+        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 = async (signal) => {
-        const url = getURL('/trending');
+    const trending = (signal) => {
         logger.info('EvoSearch API: Fetching trending searches');
-        const response = await fetchImpl(url, {
-            method: 'GET',
-            headers: getHeaders(),
-            credentials: 'include',
-            signal,
-        });
-        if (!response.ok) {
-            throw new Error(`Trending failed - ${response.status}`);
+        return getJSON('/trending', 'Trending', undefined, signal);
+    };
+    const recents = (signal) => {
+        logger.info('EvoSearch API: Fetching recent searches');
+        return getJSON('/user/recents', 'Recents', undefined, signal);
+    };
+    const sendMutation = async (path, label, method, params) => {
+        const url = getURL(path);
+        for (const [key, value] of Object.entries(params !== null && params !== void 0 ? params : {})) {
+            url.searchParams.set(key, value);
+        }
+        try {
+            const response = await fetchImpl(url, {
+                method,
+                headers: getHeaders(),
+                credentials: 'include',
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => '');
+                logger.error(`EvoSearch API: ${label} failed - ${response.status}: ${errorText}`);
+                throw new Error(`${label} failed - ${response.status}`);
+            }
+        }
+        catch (error) {
+            logger.error(`EvoSearch API: ${label} threw`, error);
+            throw error;
         }
-        return await response.json();
     };
+    const deleteRecent = (value) => sendMutation('/user/recents', 'DeleteRecent', 'DELETE', { value });
+    const clearRecents = () => sendMutation('/user/recents', 'ClearRecents', 'DELETE');
     const search = async (query, limit = 8, signal) => {
-        const url = getURL('/search');
-        url.searchParams.set('q', query);
-        url.searchParams.set('limit', limit.toString());
-        const headers = getHeaders();
         logger.info(`EvoSearch API: Search request - query length: ${query.length}, limit: ${limit}`);
-        const response = await fetchImpl(url, {
-            method: 'GET',
-            headers,
-            credentials: 'include',
-            signal,
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            logger.error(`EvoSearch API: Search failed - ${response.status}: ${errorText}`);
-            throw new Error(`Search failed - ${response.status}`);
-        }
-        const data = (await response.json());
+        const data = await getJSON('/search', 'Search', { q: query, limit: String(limit) }, signal);
         logger.info(`EvoSearch API: Search success - ${data.results.length} products`);
         return data;
     };
@@ -718,6 +764,11 @@ const createEvoSearchAPI = ({ fetch: fetchImpl = window.fetch, baseURL, userId,
     return {
         autocomplete,
         trending,
+        user: {
+            recents,
+            deleteRecent,
+            clearRecents,
+        },
         search,
         sendEvent,
     };
@@ -732,11 +783,20 @@ const init = (params) => {
     try {
         (_a = window[registryKey]) !== null && _a !== void 0 ? _a : (window[registryKey] = {});
         logger.info('EvoSearch SDK: Initializing');
+        if (new URLSearchParams(window.location.search).get('evs') === 'preview') {
+            try {
+                sessionStorage.setItem(previewKeyName, '1');
+                logger.info('EvoSearch SDK: Preview mode enabled via ?evs=preview URL param');
+            }
+            catch {
+                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 mode = uiPreferences === null || uiPreferences === void 0 ? void 0 : uiPreferences.mode;
         const hasPreview = hasPreviewKey();
         const shouldEnable = enabled || hasPreview;
-        if (!shouldEnable || (mode === 'disabled' && !hasPreview)) {
+        if (!shouldEnable) {
             logger.info('EvoSearch SDK: Mode is disabled, skipping initialization');
             return;
         }
@@ -748,6 +808,7 @@ const init = (params) => {
             userId: params.userId,
             sessionId: (_d = params.session) === null || _d === void 0 ? void 0 : _d.sessionId,
             sendTag: params.sendTag,
+            uiPreferences,
         });
         window[registryKey].api = evoSearchAPI;
         const uiImplementation = window[registryKey].ui;

package/hooks.cjs.js

@@ -635,6 +635,7 @@ const extractHandle = (url, fallback) => {
     }
 };
 const mapAPIProductToSDKProduct = (apiProduct) => {
+    var _a;
     const safeUrl = isHttpURL(apiProduct.url) ? apiProduct.url : '';
     const safeImg = isHttpURL(apiProduct.img) ? apiProduct.img : '';
     const handle = extractHandle(safeUrl, apiProduct.id);
@@ -652,7 +653,7 @@ const mapAPIProductToSDKProduct = (apiProduct) => {
             {
                 price: apiProduct.price,
                 comparedAtPrice: apiProduct.compareAtPrice || null,
-                currencyCode: 'USD', // TODO: Get currency from API or shop config
+                currencyCode: (_a = apiProduct.currencyCode) !== null && _a !== void 0 ? _a : '',
             },
         ],
     };