@blotoutio/providers-evo-search-sdk 1.68.2 → 1.69.0

package/core.cjs.js

@@ -1481,7 +1481,7 @@ const init = (params) => {
 const tag = ({ data }) => {
     try {
         return {
-            sdkVersion: "1.68.2" || '',
+            sdkVersion: "1.69.0" || '',
             searchQuery: data['searchQuery'],
             searchResults: data['searchResults'],
             timestamp: Date.now(),
@@ -1490,7 +1490,7 @@ const tag = ({ data }) => {
     catch (err) {
         console.error(`EvoSearch SDK: Tagging failed - ${err}`);
         return {
-            sdkVersion: "1.68.2" ,
+            sdkVersion: "1.69.0" ,
             timestamp: Date.now(),
         };
     }

package/core.js

@@ -1482,7 +1482,7 @@ var ProvidersEvoSearchSdk = (function () {
     const tag = ({ data }) => {
         try {
             return {
-                sdkVersion: "1.68.2" || '',
+                sdkVersion: "1.69.0" || '',
                 searchQuery: data['searchQuery'],
                 searchResults: data['searchResults'],
                 timestamp: Date.now(),
@@ -1491,7 +1491,7 @@ var ProvidersEvoSearchSdk = (function () {
         catch (err) {
             console.error(`EvoSearch SDK: Tagging failed - ${err}`);
             return {
-                sdkVersion: "1.68.2" ,
+                sdkVersion: "1.69.0" ,
                 timestamp: Date.now(),
             };
         }

package/core.mjs

@@ -1479,7 +1479,7 @@ const init = (params) => {
 const tag = ({ data }) => {
     try {
         return {
-            sdkVersion: "1.68.2" || '',
+            sdkVersion: "1.69.0" || '',
             searchQuery: data['searchQuery'],
             searchResults: data['searchResults'],
             timestamp: Date.now(),
@@ -1488,7 +1488,7 @@ const tag = ({ data }) => {
     catch (err) {
         console.error(`EvoSearch SDK: Tagging failed - ${err}`);
         return {
-            sdkVersion: "1.68.2" ,
+            sdkVersion: "1.69.0" ,
             timestamp: Date.now(),
         };
     }

package/hooks.cjs.js

@@ -935,7 +935,19 @@ const useEvoSearch = (options = {}) => {
     }, [query, ready, api, mode, retryNonce]);
     // Widget parity: report a settled query as one real search after SEARCH_SETTLE_MS.
     const lastFinalizedRef = react.useRef('');
+    // The query whose rendered results are waiting out the settle pause. Held in
+    // a ref so the teardown flush below can reach it: on a headless storefront a
+    // product click is a full navigation, so a shopper who clicks within the
+    // settle window unmounts this hook before the timer fires — and losing that
+    // event deletes exactly the successful searches from the finalized count.
+    // Measured on a real store at ~2x scale (zox, solutions#9987).
+    const pendingFinalizeRef = react.useRef(null);
     react.useEffect(() => {
+        // Re-evaluated on every dependency change, so anything short of an armed
+        // timer means nothing is pending: a superseded query's results left the
+        // screen with it, and flushing them from teardown would count a search the
+        // shopper abandoned.
+        pendingFinalizeRef.current = null;
         if (!api || mode === 'autocomplete' || loading || error) {
             return;
         }
@@ -948,16 +960,51 @@ const useEvoSearch = (options = {}) => {
         if (cleaned.toLowerCase() === lastFinalizedRef.current) {
             return;
         }
+        const actionData = {
+            query: cleaned,
+            resultCount: results.length,
+        };
+        pendingFinalizeRef.current = { api, actionData };
         const timer = setTimeout(() => {
+            pendingFinalizeRef.current = null;
+            // Re-checked at fire time, not only at arm time: a pagehide flush may
+            // have counted this query while the timer was pending (a bfcache return
+            // resumes it), and firing again would double the search.
+            if (cleaned.toLowerCase() === lastFinalizedRef.current) {
+                return;
+            }
             lastFinalizedRef.current = cleaned.toLowerCase();
-            const actionData = {
-                query: cleaned,
-                resultCount: results.length,
-            };
             api.sendEvent('evoSearchSearchIssued', undefined, actionData);
         }, SEARCH_SETTLE_MS);
+        // Only the timer: the pending marker survives this cleanup so a teardown
+        // that never re-runs the effect (unmount, navigation) can still flush it.
+        // A dependency change that IS a re-run nulls it at the top first.
         return () => clearTimeout(timer);
     }, [api, mode, query, results, loading, error]);
+    // The teardown flush. A shopper who clicks a result inside the settle window
+    // performed the most successful search there is; `sendEvent` posts with
+    // keepalive, so firing it from pagehide/unmount survives the navigation.
+    // Marking `lastFinalizedRef` keeps a bfcache return from settling the same
+    // query into a second event.
+    react.useEffect(() => {
+        if (typeof window === 'undefined') {
+            return;
+        }
+        const flush = () => {
+            const pending = pendingFinalizeRef.current;
+            if (!pending) {
+                return;
+            }
+            pendingFinalizeRef.current = null;
+            lastFinalizedRef.current = pending.actionData.query.trim().toLowerCase();
+            pending.api.sendEvent('evoSearchSearchIssued', undefined, pending.actionData);
+        };
+        window.addEventListener('pagehide', flush);
+        return () => {
+            window.removeEventListener('pagehide', flush);
+            flush();
+        };
+    }, []);
     // Image (or image+text) search, imperative because it is driven by a file
     // picker rather than the query state. Deliberately NOT given the retrying
     // resilience defaults: each attempt costs a multimodal embed, so we take the
@@ -982,6 +1029,22 @@ const useEvoSearch = (options = {}) => {
             setResults(res.products.map(mapAPIProductToSDKProduct));
             // Suggestions are a text-search artifact; an image query has none.
             setSuggestions([]);
+            // A typed refinement over a photo is a query with text, and the server
+            // counts it off this event exactly as it counts a settled keyword
+            // search — nothing else counts it, because an `image+text` request row
+            // is neither a keyword row nor a per-action submit. Per action rather
+            // than settled: this is an imperative submit, so there is no typing
+            // pause to wait out and no `query` state for the settle effect to see.
+            // A pure image search is counted server-side from its own request row
+            // and must not be double-reported here.
+            const refinement = text === null || text === void 0 ? void 0 : text.trim();
+            if (refinement) {
+                const imageActionData = {
+                    query: refinement,
+                    resultCount: res.products.length,
+                };
+                api.sendEvent('evoSearchSearchIssued', undefined, imageActionData);
+            }
         }
         catch (err) {
             if (err instanceof DOMException && err.name === 'AbortError') {

package/hooks.mjs

@@ -933,7 +933,19 @@ const useEvoSearch = (options = {}) => {
     }, [query, ready, api, mode, retryNonce]);
     // Widget parity: report a settled query as one real search after SEARCH_SETTLE_MS.
     const lastFinalizedRef = useRef('');
+    // The query whose rendered results are waiting out the settle pause. Held in
+    // a ref so the teardown flush below can reach it: on a headless storefront a
+    // product click is a full navigation, so a shopper who clicks within the
+    // settle window unmounts this hook before the timer fires — and losing that
+    // event deletes exactly the successful searches from the finalized count.
+    // Measured on a real store at ~2x scale (zox, solutions#9987).
+    const pendingFinalizeRef = useRef(null);
     useEffect(() => {
+        // Re-evaluated on every dependency change, so anything short of an armed
+        // timer means nothing is pending: a superseded query's results left the
+        // screen with it, and flushing them from teardown would count a search the
+        // shopper abandoned.
+        pendingFinalizeRef.current = null;
         if (!api || mode === 'autocomplete' || loading || error) {
             return;
         }
@@ -946,16 +958,51 @@ const useEvoSearch = (options = {}) => {
         if (cleaned.toLowerCase() === lastFinalizedRef.current) {
             return;
         }
+        const actionData = {
+            query: cleaned,
+            resultCount: results.length,
+        };
+        pendingFinalizeRef.current = { api, actionData };
         const timer = setTimeout(() => {
+            pendingFinalizeRef.current = null;
+            // Re-checked at fire time, not only at arm time: a pagehide flush may
+            // have counted this query while the timer was pending (a bfcache return
+            // resumes it), and firing again would double the search.
+            if (cleaned.toLowerCase() === lastFinalizedRef.current) {
+                return;
+            }
             lastFinalizedRef.current = cleaned.toLowerCase();
-            const actionData = {
-                query: cleaned,
-                resultCount: results.length,
-            };
             api.sendEvent('evoSearchSearchIssued', undefined, actionData);
         }, SEARCH_SETTLE_MS);
+        // Only the timer: the pending marker survives this cleanup so a teardown
+        // that never re-runs the effect (unmount, navigation) can still flush it.
+        // A dependency change that IS a re-run nulls it at the top first.
         return () => clearTimeout(timer);
     }, [api, mode, query, results, loading, error]);
+    // The teardown flush. A shopper who clicks a result inside the settle window
+    // performed the most successful search there is; `sendEvent` posts with
+    // keepalive, so firing it from pagehide/unmount survives the navigation.
+    // Marking `lastFinalizedRef` keeps a bfcache return from settling the same
+    // query into a second event.
+    useEffect(() => {
+        if (typeof window === 'undefined') {
+            return;
+        }
+        const flush = () => {
+            const pending = pendingFinalizeRef.current;
+            if (!pending) {
+                return;
+            }
+            pendingFinalizeRef.current = null;
+            lastFinalizedRef.current = pending.actionData.query.trim().toLowerCase();
+            pending.api.sendEvent('evoSearchSearchIssued', undefined, pending.actionData);
+        };
+        window.addEventListener('pagehide', flush);
+        return () => {
+            window.removeEventListener('pagehide', flush);
+            flush();
+        };
+    }, []);
     // Image (or image+text) search, imperative because it is driven by a file
     // picker rather than the query state. Deliberately NOT given the retrying
     // resilience defaults: each attempt costs a multimodal embed, so we take the
@@ -980,6 +1027,22 @@ const useEvoSearch = (options = {}) => {
             setResults(res.products.map(mapAPIProductToSDKProduct));
             // Suggestions are a text-search artifact; an image query has none.
             setSuggestions([]);
+            // A typed refinement over a photo is a query with text, and the server
+            // counts it off this event exactly as it counts a settled keyword
+            // search — nothing else counts it, because an `image+text` request row
+            // is neither a keyword row nor a per-action submit. Per action rather
+            // than settled: this is an imperative submit, so there is no typing
+            // pause to wait out and no `query` state for the settle effect to see.
+            // A pure image search is counted server-side from its own request row
+            // and must not be double-reported here.
+            const refinement = text === null || text === void 0 ? void 0 : text.trim();
+            if (refinement) {
+                const imageActionData = {
+                    query: refinement,
+                    resultCount: res.products.length,
+                };
+                api.sendEvent('evoSearchSearchIssued', undefined, imageActionData);
+            }
         }
         catch (err) {
             if (err instanceof DOMException && err.name === 'AbortError') {

package/index.cjs.js

@@ -2096,7 +2096,7 @@ const init = (params) => {
 const tag = ({ data }) => {
     try {
         return {
-            sdkVersion: "1.68.2" || '',
+            sdkVersion: "1.69.0" || '',
             searchQuery: data['searchQuery'],
             searchResults: data['searchResults'],
             timestamp: Date.now(),
@@ -2105,7 +2105,7 @@ const tag = ({ data }) => {
     catch (err) {
         console.error(`EvoSearch SDK: Tagging failed - ${err}`);
         return {
-            sdkVersion: "1.68.2" ,
+            sdkVersion: "1.69.0" ,
             timestamp: Date.now(),
         };
     }
@@ -9870,6 +9870,8 @@ class SearchWidget extends ElementWithStylesheet {
         };
         this.isHandlingSuggestionClick = false;
         this.cachedRailSections = [];
+        // Bound once so connected/disconnected add and remove the SAME reference.
+        this.finalizeFlushListener = () => this.flushSettledQuery();
         // Last finalized query (lowercased) — consecutive duplicates (settle
         // followed by Enter on the same query) collapse into one search.
         this.lastFinalizedQuery = '';
@@ -10035,6 +10037,12 @@ class SearchWidget extends ElementWithStylesheet {
         this.mobileMediaQuery.addEventListener('change', this.mobileMediaListener);
         window.addEventListener('online', this.rewarmListener);
         document.addEventListener('visibilitychange', this.rewarmListener);
+        // A product card is a plain anchor, so a click inside the settle window is
+        // a full navigation that would otherwise kill the pending finalize — and
+        // a fast click-through is the most successful search there is. sendEvent
+        // posts with keepalive, so flushing from pagehide survives the unload;
+        // markQueryFinalized's dedupe keeps a bfcache return from doubling it.
+        window.addEventListener('pagehide', this.finalizeFlushListener);
         // Restart keep-warm when the same instance re-attaches (a host re-append
         // moves the subtree and fires disconnected→connected without a fresh
         // firstUpdated). On the very first connect `api` may not be bound yet —
@@ -10072,8 +10080,11 @@ class SearchWidget extends ElementWithStylesheet {
     }
     disconnectedCallback() {
         var _a, _b, _c, _d, _e;
-        // Closing the widget settles whatever query was on screen.
-        this.finalizeSettledQuery();
+        // Closing the widget — and a host-driven teardown that removes the overlay
+        // mid-settle — settles whatever query was waiting out its pause, the same
+        // way a navigation does. Guarded, so a query the shopper already typed past
+        // is not counted.
+        this.flushSettledQuery();
         clearTimeout(this.autocompleteTimer);
         clearInterval(this.keepWarmTimer);
         this.keepWarmTimer = undefined;
@@ -10093,6 +10104,7 @@ class SearchWidget extends ElementWithStylesheet {
         (_e = this.mobileMediaQuery) === null || _e === void 0 ? void 0 : _e.removeEventListener('change', this.mobileMediaListener);
         window.removeEventListener('online', this.rewarmListener);
         document.removeEventListener('visibilitychange', this.rewarmListener);
+        window.removeEventListener('pagehide', this.finalizeFlushListener);
         super.disconnectedCallback();
     }
     willUpdate(changed) {
@@ -10417,6 +10429,13 @@ class SearchWidget extends ElementWithStylesheet {
         };
         (_b = (_a = this.api) === null || _a === void 0 ? void 0 : _a.sendEvent) === null || _b === void 0 ? void 0 : _b.call(_a, 'evoSearchSearchIssued', undefined, actionData);
     }
+    // Disarms the settle without counting: whatever was on screen has been
+    // superseded (a new query, a refinement, a failed fetch), so a later teardown
+    // flush must not report it.
+    cancelSettle() {
+        clearTimeout(this.settleTimer);
+        this.settleTimer = undefined;
+    }
     // Finalizes the query whose results are currently on screen. No-op when
     // nothing rendered yet, the last fetch errored (an error count of 0 would
     // mislabel the query as zero-result in the metrics), or the search pane
@@ -10424,7 +10443,7 @@ class SearchWidget extends ElementWithStylesheet {
     // the Ask pane is on screen, and finalizing it from there would double-count
     // a query that was already finalized when the shopper switched tabs.
     finalizeSettledQuery() {
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         if (this.hasError || !this.debouncedQuery || this.mode !== 'search') {
             return;
         }
@@ -10435,9 +10454,20 @@ class SearchWidget extends ElementWithStylesheet {
         this.markQueryFinalized(this.debouncedQuery, this.searchProducts.length + this.searchCollections.length);
     }
     startSettleTimer() {
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         this.settleTimer = setTimeout(() => this.finalizeSettledQuery(), SEARCH_SETTLE_MS);
     }
+    // Teardown/navigation flush. Only an ARMED settle counts: a shopper who
+    // clicked a result inside the pause performed the search, but one who had
+    // already typed past it (the timer was disarmed and a newer fetch is in
+    // flight) did not, and `debouncedQuery` still holds the old text. The hook
+    // refuses the same case by dropping its pending record on supersession.
+    flushSettledQuery() {
+        if (this.settleTimer === undefined) {
+            return;
+        }
+        this.finalizeSettledQuery();
+    }
     handleSearchInput(e) {
         var _a, _b, _c;
         const { query } = e.detail;
@@ -10463,7 +10493,7 @@ class SearchWidget extends ElementWithStylesheet {
         if (this.attachedImage) {
             this.loading = true;
             // The refinement supersedes whatever the previous query was settling.
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
             this.finalizeOnRender = false;
             clearTimeout(this.autocompleteTimer);
             this.requestGeneration += 1;
@@ -10504,7 +10534,7 @@ class SearchWidget extends ElementWithStylesheet {
             return;
         }
         // The query changed — whatever was settling is no longer settled.
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         this.finalizeOnRender = false;
         if (trimmed.length >= MIN_QUERY_LENGTH) {
             if (!this.hasWarmedForInput) {
@@ -10598,7 +10628,7 @@ class SearchWidget extends ElementWithStylesheet {
             this.debouncedQuery = query;
             this.loading = false;
             this.finalizeOnRender = false;
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
         }
     }
     // Ask-mode completions are navigation hints only: populate suggestions
@@ -11272,7 +11302,7 @@ class SearchWidget extends ElementWithStylesheet {
         // The applied query supersedes whatever was settling; without this the
         // old query's settle timer races the new fetch and finalizes
         // nondeterministically.
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         this.finalizeOnRender = false;
         this.isHandlingSuggestionClick = true;
         this.searchQuery = value;

package/index.js

@@ -2097,7 +2097,7 @@ var ProvidersEvoSearchSdk = (function () {
     const tag = ({ data }) => {
         try {
             return {
-                sdkVersion: "1.68.2" || '',
+                sdkVersion: "1.69.0" || '',
                 searchQuery: data['searchQuery'],
                 searchResults: data['searchResults'],
                 timestamp: Date.now(),
@@ -2106,7 +2106,7 @@ var ProvidersEvoSearchSdk = (function () {
         catch (err) {
             console.error(`EvoSearch SDK: Tagging failed - ${err}`);
             return {
-                sdkVersion: "1.68.2" ,
+                sdkVersion: "1.69.0" ,
                 timestamp: Date.now(),
             };
         }
@@ -9871,6 +9871,8 @@ var ProvidersEvoSearchSdk = (function () {
             };
             this.isHandlingSuggestionClick = false;
             this.cachedRailSections = [];
+            // Bound once so connected/disconnected add and remove the SAME reference.
+            this.finalizeFlushListener = () => this.flushSettledQuery();
             // Last finalized query (lowercased) — consecutive duplicates (settle
             // followed by Enter on the same query) collapse into one search.
             this.lastFinalizedQuery = '';
@@ -10036,6 +10038,12 @@ var ProvidersEvoSearchSdk = (function () {
             this.mobileMediaQuery.addEventListener('change', this.mobileMediaListener);
             window.addEventListener('online', this.rewarmListener);
             document.addEventListener('visibilitychange', this.rewarmListener);
+            // A product card is a plain anchor, so a click inside the settle window is
+            // a full navigation that would otherwise kill the pending finalize — and
+            // a fast click-through is the most successful search there is. sendEvent
+            // posts with keepalive, so flushing from pagehide survives the unload;
+            // markQueryFinalized's dedupe keeps a bfcache return from doubling it.
+            window.addEventListener('pagehide', this.finalizeFlushListener);
             // Restart keep-warm when the same instance re-attaches (a host re-append
             // moves the subtree and fires disconnected→connected without a fresh
             // firstUpdated). On the very first connect `api` may not be bound yet —
@@ -10073,8 +10081,11 @@ var ProvidersEvoSearchSdk = (function () {
         }
         disconnectedCallback() {
             var _a, _b, _c, _d, _e;
-            // Closing the widget settles whatever query was on screen.
-            this.finalizeSettledQuery();
+            // Closing the widget — and a host-driven teardown that removes the overlay
+            // mid-settle — settles whatever query was waiting out its pause, the same
+            // way a navigation does. Guarded, so a query the shopper already typed past
+            // is not counted.
+            this.flushSettledQuery();
             clearTimeout(this.autocompleteTimer);
             clearInterval(this.keepWarmTimer);
             this.keepWarmTimer = undefined;
@@ -10094,6 +10105,7 @@ var ProvidersEvoSearchSdk = (function () {
             (_e = this.mobileMediaQuery) === null || _e === void 0 ? void 0 : _e.removeEventListener('change', this.mobileMediaListener);
             window.removeEventListener('online', this.rewarmListener);
             document.removeEventListener('visibilitychange', this.rewarmListener);
+            window.removeEventListener('pagehide', this.finalizeFlushListener);
             super.disconnectedCallback();
         }
         willUpdate(changed) {
@@ -10418,6 +10430,13 @@ var ProvidersEvoSearchSdk = (function () {
             };
             (_b = (_a = this.api) === null || _a === void 0 ? void 0 : _a.sendEvent) === null || _b === void 0 ? void 0 : _b.call(_a, 'evoSearchSearchIssued', undefined, actionData);
         }
+        // Disarms the settle without counting: whatever was on screen has been
+        // superseded (a new query, a refinement, a failed fetch), so a later teardown
+        // flush must not report it.
+        cancelSettle() {
+            clearTimeout(this.settleTimer);
+            this.settleTimer = undefined;
+        }
         // Finalizes the query whose results are currently on screen. No-op when
         // nothing rendered yet, the last fetch errored (an error count of 0 would
         // mislabel the query as zero-result in the metrics), or the search pane
@@ -10425,7 +10444,7 @@ var ProvidersEvoSearchSdk = (function () {
         // the Ask pane is on screen, and finalizing it from there would double-count
         // a query that was already finalized when the shopper switched tabs.
         finalizeSettledQuery() {
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
             if (this.hasError || !this.debouncedQuery || this.mode !== 'search') {
                 return;
             }
@@ -10436,9 +10455,20 @@ var ProvidersEvoSearchSdk = (function () {
             this.markQueryFinalized(this.debouncedQuery, this.searchProducts.length + this.searchCollections.length);
         }
         startSettleTimer() {
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
             this.settleTimer = setTimeout(() => this.finalizeSettledQuery(), SEARCH_SETTLE_MS);
         }
+        // Teardown/navigation flush. Only an ARMED settle counts: a shopper who
+        // clicked a result inside the pause performed the search, but one who had
+        // already typed past it (the timer was disarmed and a newer fetch is in
+        // flight) did not, and `debouncedQuery` still holds the old text. The hook
+        // refuses the same case by dropping its pending record on supersession.
+        flushSettledQuery() {
+            if (this.settleTimer === undefined) {
+                return;
+            }
+            this.finalizeSettledQuery();
+        }
         handleSearchInput(e) {
             var _a, _b, _c;
             const { query } = e.detail;
@@ -10464,7 +10494,7 @@ var ProvidersEvoSearchSdk = (function () {
             if (this.attachedImage) {
                 this.loading = true;
                 // The refinement supersedes whatever the previous query was settling.
-                clearTimeout(this.settleTimer);
+                this.cancelSettle();
                 this.finalizeOnRender = false;
                 clearTimeout(this.autocompleteTimer);
                 this.requestGeneration += 1;
@@ -10505,7 +10535,7 @@ var ProvidersEvoSearchSdk = (function () {
                 return;
             }
             // The query changed — whatever was settling is no longer settled.
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
             this.finalizeOnRender = false;
             if (trimmed.length >= MIN_QUERY_LENGTH) {
                 if (!this.hasWarmedForInput) {
@@ -10599,7 +10629,7 @@ var ProvidersEvoSearchSdk = (function () {
                 this.debouncedQuery = query;
                 this.loading = false;
                 this.finalizeOnRender = false;
-                clearTimeout(this.settleTimer);
+                this.cancelSettle();
             }
         }
         // Ask-mode completions are navigation hints only: populate suggestions
@@ -11273,7 +11303,7 @@ var ProvidersEvoSearchSdk = (function () {
             // The applied query supersedes whatever was settling; without this the
             // old query's settle timer races the new fetch and finalizes
             // nondeterministically.
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
             this.finalizeOnRender = false;
             this.isHandlingSuggestionClick = true;
             this.searchQuery = value;

package/index.mjs

@@ -2094,7 +2094,7 @@ const init = (params) => {
 const tag = ({ data }) => {
     try {
         return {
-            sdkVersion: "1.68.2" || '',
+            sdkVersion: "1.69.0" || '',
             searchQuery: data['searchQuery'],
             searchResults: data['searchResults'],
             timestamp: Date.now(),
@@ -2103,7 +2103,7 @@ const tag = ({ data }) => {
     catch (err) {
         console.error(`EvoSearch SDK: Tagging failed - ${err}`);
         return {
-            sdkVersion: "1.68.2" ,
+            sdkVersion: "1.69.0" ,
             timestamp: Date.now(),
         };
     }
@@ -9868,6 +9868,8 @@ class SearchWidget extends ElementWithStylesheet {
         };
         this.isHandlingSuggestionClick = false;
         this.cachedRailSections = [];
+        // Bound once so connected/disconnected add and remove the SAME reference.
+        this.finalizeFlushListener = () => this.flushSettledQuery();
         // Last finalized query (lowercased) — consecutive duplicates (settle
         // followed by Enter on the same query) collapse into one search.
         this.lastFinalizedQuery = '';
@@ -10033,6 +10035,12 @@ class SearchWidget extends ElementWithStylesheet {
         this.mobileMediaQuery.addEventListener('change', this.mobileMediaListener);
         window.addEventListener('online', this.rewarmListener);
         document.addEventListener('visibilitychange', this.rewarmListener);
+        // A product card is a plain anchor, so a click inside the settle window is
+        // a full navigation that would otherwise kill the pending finalize — and
+        // a fast click-through is the most successful search there is. sendEvent
+        // posts with keepalive, so flushing from pagehide survives the unload;
+        // markQueryFinalized's dedupe keeps a bfcache return from doubling it.
+        window.addEventListener('pagehide', this.finalizeFlushListener);
         // Restart keep-warm when the same instance re-attaches (a host re-append
         // moves the subtree and fires disconnected→connected without a fresh
         // firstUpdated). On the very first connect `api` may not be bound yet —
@@ -10070,8 +10078,11 @@ class SearchWidget extends ElementWithStylesheet {
     }
     disconnectedCallback() {
         var _a, _b, _c, _d, _e;
-        // Closing the widget settles whatever query was on screen.
-        this.finalizeSettledQuery();
+        // Closing the widget — and a host-driven teardown that removes the overlay
+        // mid-settle — settles whatever query was waiting out its pause, the same
+        // way a navigation does. Guarded, so a query the shopper already typed past
+        // is not counted.
+        this.flushSettledQuery();
         clearTimeout(this.autocompleteTimer);
         clearInterval(this.keepWarmTimer);
         this.keepWarmTimer = undefined;
@@ -10091,6 +10102,7 @@ class SearchWidget extends ElementWithStylesheet {
         (_e = this.mobileMediaQuery) === null || _e === void 0 ? void 0 : _e.removeEventListener('change', this.mobileMediaListener);
         window.removeEventListener('online', this.rewarmListener);
         document.removeEventListener('visibilitychange', this.rewarmListener);
+        window.removeEventListener('pagehide', this.finalizeFlushListener);
         super.disconnectedCallback();
     }
     willUpdate(changed) {
@@ -10415,6 +10427,13 @@ class SearchWidget extends ElementWithStylesheet {
         };
         (_b = (_a = this.api) === null || _a === void 0 ? void 0 : _a.sendEvent) === null || _b === void 0 ? void 0 : _b.call(_a, 'evoSearchSearchIssued', undefined, actionData);
     }
+    // Disarms the settle without counting: whatever was on screen has been
+    // superseded (a new query, a refinement, a failed fetch), so a later teardown
+    // flush must not report it.
+    cancelSettle() {
+        clearTimeout(this.settleTimer);
+        this.settleTimer = undefined;
+    }
     // Finalizes the query whose results are currently on screen. No-op when
     // nothing rendered yet, the last fetch errored (an error count of 0 would
     // mislabel the query as zero-result in the metrics), or the search pane
@@ -10422,7 +10441,7 @@ class SearchWidget extends ElementWithStylesheet {
     // the Ask pane is on screen, and finalizing it from there would double-count
     // a query that was already finalized when the shopper switched tabs.
     finalizeSettledQuery() {
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         if (this.hasError || !this.debouncedQuery || this.mode !== 'search') {
             return;
         }
@@ -10433,9 +10452,20 @@ class SearchWidget extends ElementWithStylesheet {
         this.markQueryFinalized(this.debouncedQuery, this.searchProducts.length + this.searchCollections.length);
     }
     startSettleTimer() {
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         this.settleTimer = setTimeout(() => this.finalizeSettledQuery(), SEARCH_SETTLE_MS);
     }
+    // Teardown/navigation flush. Only an ARMED settle counts: a shopper who
+    // clicked a result inside the pause performed the search, but one who had
+    // already typed past it (the timer was disarmed and a newer fetch is in
+    // flight) did not, and `debouncedQuery` still holds the old text. The hook
+    // refuses the same case by dropping its pending record on supersession.
+    flushSettledQuery() {
+        if (this.settleTimer === undefined) {
+            return;
+        }
+        this.finalizeSettledQuery();
+    }
     handleSearchInput(e) {
         var _a, _b, _c;
         const { query } = e.detail;
@@ -10461,7 +10491,7 @@ class SearchWidget extends ElementWithStylesheet {
         if (this.attachedImage) {
             this.loading = true;
             // The refinement supersedes whatever the previous query was settling.
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
             this.finalizeOnRender = false;
             clearTimeout(this.autocompleteTimer);
             this.requestGeneration += 1;
@@ -10502,7 +10532,7 @@ class SearchWidget extends ElementWithStylesheet {
             return;
         }
         // The query changed — whatever was settling is no longer settled.
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         this.finalizeOnRender = false;
         if (trimmed.length >= MIN_QUERY_LENGTH) {
             if (!this.hasWarmedForInput) {
@@ -10596,7 +10626,7 @@ class SearchWidget extends ElementWithStylesheet {
             this.debouncedQuery = query;
             this.loading = false;
             this.finalizeOnRender = false;
-            clearTimeout(this.settleTimer);
+            this.cancelSettle();
         }
     }
     // Ask-mode completions are navigation hints only: populate suggestions
@@ -11270,7 +11300,7 @@ class SearchWidget extends ElementWithStylesheet {
         // The applied query supersedes whatever was settling; without this the
         // old query's settle timer races the new fetch and finalizes
         // nondeterministically.
-        clearTimeout(this.settleTimer);
+        this.cancelSettle();
         this.finalizeOnRender = false;
         this.isHandlingSuggestionClick = true;
         this.searchQuery = value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blotoutio/providers-evo-search-sdk",
-  "version": "1.68.2",
+  "version": "1.69.0",
   "description": "Evo Search SDK for EdgeTag",
   "author": "Blotout",
   "license": "MIT",