instantsearch.js 4.86.1 → 4.87.1

package/cjs/connectors/autocomplete/connectAutocomplete.js

@@ -21,7 +21,11 @@ var connectAutocomplete = function connectAutocomplete(renderFn) {
   return function (widgetParams) {
     var _ref = widgetParams || {},
       _ref$escapeHTML = _ref.escapeHTML,
-      escapeHTML = _ref$escapeHTML === void 0 ? true : _ref$escapeHTML;
+      escapeHTML = _ref$escapeHTML === void 0 ? true : _ref$escapeHTML,
+      _ref$transformItems = _ref.transformItems,
+      transformItems = _ref$transformItems === void 0 ? function (indices) {
+        return indices;
+      } : _ref$transformItems;
     process.env.NODE_ENV === 'development' ? (0, _utils.warning)(!widgetParams.indices, "\nThe option `indices` has been removed from the Autocomplete connector.\n\nThe indices to target are now inferred from the widgets tree.\n".concat(Array.isArray(widgetParams.indices) ? "\nAn alternative would be:\n\nconst autocomplete = connectAutocomplete(renderer);\n\nsearch.addWidgets([\n  ".concat(widgetParams.indices.map(function (_ref2) {
       var value = _ref2.value;
       return "index({ indexName: '".concat(value, "' }),");
@@ -63,6 +67,7 @@ var connectAutocomplete = function connectAutocomplete(renderFn) {
             helper.setQuery(query).search();
           };
         }
+        var sendEventMap = {};
         var indices = scopedResults.map(function (scopedResult) {
           var _scopedResult$results, _scopedResult$results2;
           // We need to escape the hits because highlighting
@@ -70,7 +75,7 @@ var connectAutocomplete = function connectAutocomplete(renderFn) {
           if (scopedResult.results) {
             scopedResult.results.hits = escapeHTML ? (0, _utils.escapeHits)(scopedResult.results.hits) : scopedResult.results.hits;
           }
-          var sendEvent = (0, _utils.createSendEventForHits)({
+          sendEventMap[scopedResult.indexId] = (0, _utils.createSendEventForHits)({
             instantSearchInstance: instantSearchInstance,
             helper: scopedResult.helper,
             widgetType: _this.$$type
@@ -79,13 +84,16 @@ var connectAutocomplete = function connectAutocomplete(renderFn) {
             indexId: scopedResult.indexId,
             indexName: ((_scopedResult$results = scopedResult.results) === null || _scopedResult$results === void 0 ? void 0 : _scopedResult$results.index) || '',
             hits: ((_scopedResult$results2 = scopedResult.results) === null || _scopedResult$results2 === void 0 ? void 0 : _scopedResult$results2.hits) || [],
-            results: scopedResult.results || {},
-            sendEvent: sendEvent
+            results: scopedResult.results || {}
           };
         });
         return {
           currentRefinement: state.query || '',
-          indices: indices,
+          indices: transformItems(indices).map(function (transformedIndex) {
+            return _objectSpread(_objectSpread({}, transformedIndex), {}, {
+              sendEvent: sendEventMap[transformedIndex.indexId]
+            });
+          }),
           refine: connectorState.refine,
           widgetParams: widgetParams
         };

package/cjs/connectors/chat/connectChat.js

@@ -5,10 +5,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _ai = require("ai");
+var _aiLite = require("../../lib/ai-lite");
 var _chat = require("../../lib/chat");
 var _utils = require("../../lib/utils");
-var _excluded = ["resume", "tools"];
+var _excluded = ["resume", "tools", "type"],
+  _excluded2 = ["messages", "trigger"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
@@ -16,10 +17,14 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
-function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
 var withUsage = (0, _utils.createDocumentationMessageGenerator)({
@@ -36,6 +41,8 @@ var connectChat = exports.default = function connectChat(renderFn) {
       resume = _ref$resume === void 0 ? false : _ref$resume,
       _ref$tools = _ref.tools,
       tools = _ref$tools === void 0 ? {} : _ref$tools,
+      _ref$type = _ref.type,
+      type = _ref$type === void 0 ? 'chat' : _ref$type,
       options = _objectWithoutProperties(_ref, _excluded);
     var _chatInstance;
     var input = '';
@@ -45,6 +52,25 @@ var connectChat = exports.default = function connectChat(renderFn) {
     var setInput;
     var setOpen;
     var setIsClearing;
+    var agentId = 'agentId' in options ? options.agentId : undefined;
+
+    // Extract suggestions from the last assistant message's data-suggestions part
+    var getSuggestionsFromMessages = function getSuggestionsFromMessages(messages) {
+      // Find the last assistant message (iterate from end)
+      var lastAssistantMessage = _toConsumableArray(messages).reverse().find(function (message) {
+        return message.role === 'assistant' && message.parts;
+      });
+      if (!(lastAssistantMessage !== null && lastAssistantMessage !== void 0 && lastAssistantMessage.parts)) {
+        return undefined;
+      }
+
+      // Find the data-suggestions part
+      var suggestionsPart = lastAssistantMessage.parts.find(function (part) {
+        var _data;
+        return 'type' in part && part.type === 'data-suggestions' && 'data' in part && Array.isArray((_data = part.data) === null || _data === void 0 ? void 0 : _data.suggestions);
+      });
+      return suggestionsPart === null || suggestionsPart === void 0 ? void 0 : suggestionsPart.data.suggestions;
+    };
     var setMessages = function setMessages(messagesParam) {
       if (typeof messagesParam === 'function') {
         messagesParam = messagesParam(_chatInstance.messages);
@@ -68,20 +94,67 @@ var connectChat = exports.default = function connectChat(renderFn) {
         _getAppIdAndApiKey2 = _slicedToArray(_getAppIdAndApiKey, 2),
         appId = _getAppIdAndApiKey2[0],
         apiKey = _getAppIdAndApiKey2[1];
+
+      // Filter out custom data parts (like data-suggestions) that the backend doesn't accept
+      var filterDataParts = function filterDataParts(messages) {
+        return messages.map(function (message) {
+          var _message$parts;
+          return _objectSpread(_objectSpread({}, message), {}, {
+            parts: (_message$parts = message.parts) === null || _message$parts === void 0 ? void 0 : _message$parts.filter(function (part) {
+              return !('type' in part && part.type.startsWith('data-'));
+            })
+          });
+        });
+      };
       if ('transport' in options && options.transport) {
-        transport = new _ai.DefaultChatTransport(options.transport);
+        var originalPrepare = options.transport.prepareSendMessagesRequest;
+        transport = new _aiLite.DefaultChatTransport(_objectSpread(_objectSpread({}, options.transport), {}, {
+          prepareSendMessagesRequest: function prepareSendMessagesRequest(params) {
+            // Call the original prepareSendMessagesRequest if it exists,
+            // otherwise construct the default body
+            var preparedOrPromise = originalPrepare ? originalPrepare(params) : {
+              body: _objectSpread({}, params)
+            };
+            // Then filter out data-* parts
+            var applyFilter = function applyFilter(prepared) {
+              return _objectSpread(_objectSpread({}, prepared), {}, {
+                body: _objectSpread(_objectSpread({}, prepared.body), {}, {
+                  messages: filterDataParts(prepared.body.messages)
+                })
+              });
+            };
+
+            // Handle both sync and async cases
+            if (preparedOrPromise && 'then' in preparedOrPromise) {
+              return preparedOrPromise.then(applyFilter);
+            }
+            return applyFilter(preparedOrPromise);
+          }
+        }));
       }
       if ('agentId' in options && options.agentId) {
-        var agentId = options.agentId;
         if (!appId || !apiKey) {
           throw new Error(withUsage('Could not extract Algolia credentials from the search client.'));
         }
-        transport = new _ai.DefaultChatTransport({
-          api: "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/completions?compatibilityMode=ai-sdk-5"),
+        var baseApi = "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/completions?compatibilityMode=ai-sdk-5");
+        transport = new _aiLite.DefaultChatTransport({
+          api: baseApi,
           headers: {
             'x-algolia-application-id': appId,
             'x-algolia-api-Key': apiKey,
             'x-algolia-agent': (0, _utils.getAlgoliaAgent)(instantSearchInstance.client)
+          },
+          prepareSendMessagesRequest: function prepareSendMessagesRequest(_ref2) {
+            var messages = _ref2.messages,
+              trigger = _ref2.trigger,
+              rest = _objectWithoutProperties(_ref2, _excluded2);
+            return {
+              // Bypass cache when regenerating to ensure fresh responses
+              api: trigger === 'regenerate-message' ? "".concat(baseApi, "&cache=false") : baseApi,
+              body: _objectSpread(_objectSpread({}, rest), {}, {
+                messages: filterDataParts(messages)
+              })
+            };
           }
         });
       }
@@ -93,9 +166,9 @@ var connectChat = exports.default = function connectChat(renderFn) {
       }
       return new _chat.Chat(_objectSpread(_objectSpread({}, options), {}, {
         transport: transport,
-        sendAutomaticallyWhen: _ai.lastAssistantMessageIsCompleteWithToolCalls,
-        onToolCall: function onToolCall(_ref2) {
-          var toolCall = _ref2.toolCall;
+        sendAutomaticallyWhen: _aiLite.lastAssistantMessageIsCompleteWithToolCalls,
+        onToolCall: function onToolCall(_ref3) {
+          var toolCall = _ref3.toolCall;
           var tool = tools[toolCall.toolName];
           if (!tool) {
             if (process.env.NODE_ENV === 'development') {
@@ -108,8 +181,8 @@ var connectChat = exports.default = function connectChat(renderFn) {
             });
           }
           if (tool.onToolCall) {
-            var addToolResult = function addToolResult(_ref3) {
-              var output = _ref3.output;
+            var addToolResult = function addToolResult(_ref4) {
+              var output = _ref4.output;
               return _chatInstance.addToolResult({
                 output: output,
                 tool: toolCall.toolName,
@@ -165,9 +238,7 @@ var connectChat = exports.default = function connectChat(renderFn) {
       getRenderState: function getRenderState(renderState, renderOptions
       // Type is explicitly redefined, to avoid having the TWidgetParams type in the definition
       ) {
-        return _objectSpread(_objectSpread({}, renderState), {}, {
-          chat: this.getWidgetRenderState(renderOptions)
-        });
+        return _objectSpread(_objectSpread({}, renderState), {}, _defineProperty({}, type, this.getWidgetRenderState(renderOptions)));
       },
       getWidgetRenderState: function getWidgetRenderState(renderOptions) {
         var instantSearchInstance = renderOptions.instantSearchInstance,
@@ -186,10 +257,10 @@ var connectChat = exports.default = function connectChat(renderFn) {
           });
         }
         var toolsWithAddToolResult = {};
-        Object.entries(tools).forEach(function (_ref4) {
-          var _ref5 = _slicedToArray(_ref4, 2),
-            key = _ref5[0],
-            tool = _ref5[1];
+        Object.entries(tools).forEach(function (_ref5) {
+          var _ref6 = _slicedToArray(_ref5, 2),
+            key = _ref6[0],
+            tool = _ref6[1];
           var toolWithAddToolResult = _objectSpread(_objectSpread({}, tool), {}, {
             addToolResult: _chatInstance.addToolResult
           });
@@ -204,6 +275,7 @@ var connectChat = exports.default = function connectChat(renderFn) {
           setInput: setInput,
           setOpen: setOpen,
           setMessages: setMessages,
+          suggestions: getSuggestionsFromMessages(_chatInstance.messages),
           isClearing: isClearing,
           clearMessages: clearMessages,
           onClearTransitionEnd: onClearTransitionEnd,

package/cjs/connectors/filter-suggestions/connectFilterSuggestions.js

@@ -0,0 +1,255 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _utils = require("../../lib/utils");
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var withUsage = (0, _utils.createDocumentationMessageGenerator)({
+  name: 'filter-suggestions',
+  connector: true
+});
+var connectFilterSuggestions = function connectFilterSuggestions(renderFn) {
+  var unmountFn = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _utils.noop;
+  (0, _utils.checkRendering)(renderFn, withUsage());
+  return function (widgetParams) {
+    var agentId = widgetParams.agentId,
+      attributes = widgetParams.attributes,
+      _widgetParams$maxSugg = widgetParams.maxSuggestions,
+      maxSuggestions = _widgetParams$maxSugg === void 0 ? 3 : _widgetParams$maxSugg,
+      _widgetParams$debounc = widgetParams.debounceMs,
+      debounceMs = _widgetParams$debounc === void 0 ? 300 : _widgetParams$debounc,
+      _widgetParams$hitsToS = widgetParams.hitsToSample,
+      hitsToSample = _widgetParams$hitsToS === void 0 ? 5 : _widgetParams$hitsToS,
+      _widgetParams$transfo = widgetParams.transformItems,
+      transformItems = _widgetParams$transfo === void 0 ? function (items) {
+        return items;
+      } : _widgetParams$transfo,
+      transport = widgetParams.transport;
+    if (!agentId && !transport) {
+      throw new Error(withUsage('The `agentId` option is required unless a custom `transport` is provided.'));
+    }
+    var endpoint;
+    var headers;
+    var suggestions = [];
+    var isLoading = false;
+    var debounceTimer;
+    var lastStateSignature = null; // null means never fetched
+    var refine;
+    var searchHelper = null;
+    var latestRenderOptions = null;
+
+    // Create a signature of the current search state (query + refinements)
+    var getStateSignature = function getStateSignature(results) {
+      var query = results.query || '';
+      var refinements = searchHelper ? JSON.stringify(searchHelper.state.facetsRefinements) + JSON.stringify(searchHelper.state.disjunctiveFacetsRefinements) + JSON.stringify(searchHelper.state.hierarchicalFacetsRefinements) : '';
+      return "".concat(query, "|").concat(refinements);
+    };
+    var _getWidgetRenderState = function getWidgetRenderState(renderOptions) {
+      var results = 'results' in renderOptions ? renderOptions.results : undefined;
+      var transformedSuggestions = transformItems(suggestions, {
+        results: results
+      });
+      return {
+        suggestions: transformedSuggestions,
+        isLoading: isLoading,
+        refine: refine,
+        widgetParams: widgetParams
+      };
+    };
+
+    // Minimum duration to show skeleton to avoid flash when results are cached
+    var MIN_SKELETON_DURATION_MS = 300;
+    var fetchSuggestions = function fetchSuggestions(results, renderOptions) {
+      var _results$hits, _rawResults$;
+      if (!(results !== null && results !== void 0 && (_results$hits = results.hits) !== null && _results$hits !== void 0 && _results$hits.length)) {
+        suggestions = [];
+        isLoading = false;
+        renderFn(_objectSpread(_objectSpread({}, _getWidgetRenderState(renderOptions)), {}, {
+          instantSearchInstance: renderOptions.instantSearchInstance
+        }), false);
+        return;
+      }
+      var loadingStartTime = Date.now();
+      isLoading = true;
+      renderFn(_objectSpread(_objectSpread({}, _getWidgetRenderState(renderOptions)), {}, {
+        instantSearchInstance: renderOptions.instantSearchInstance
+      }), false);
+
+      // Get facets from raw results (results.facets is processed differently)
+      var rawResults = results._rawResults;
+      var rawFacets = (rawResults === null || rawResults === void 0 ? void 0 : (_rawResults$ = rawResults[0]) === null || _rawResults$ === void 0 ? void 0 : _rawResults$.facets) || {};
+      var facetsToSend = attributes ? Object.fromEntries(Object.entries(rawFacets).filter(function (_ref) {
+        var _ref2 = _slicedToArray(_ref, 1),
+          key = _ref2[0];
+        return attributes.includes(key);
+      })) : rawFacets;
+
+      // Collect current refinements to exclude from suggestions
+      var currentRefinements = searchHelper ? (0, _utils.getRefinements)(results, searchHelper.state).map(function (refinement) {
+        return {
+          attribute: refinement.attribute,
+          value: refinement.name
+        };
+      }) : [];
+      var messageText = JSON.stringify({
+        query: results.query,
+        facets: facetsToSend,
+        hitsSample: results.hits.slice(0, hitsToSample),
+        currentRefinements: currentRefinements,
+        maxSuggestions: maxSuggestions
+      });
+      var payload = {
+        messages: [{
+          id: "sr-".concat(Date.now()),
+          createdAt: new Date().toISOString(),
+          role: 'user',
+          parts: [{
+            type: 'text',
+            text: messageText
+          }]
+        }]
+      };
+
+      // Apply custom body transformation if provided
+      var finalPayload = transport !== null && transport !== void 0 && transport.prepareSendMessagesRequest ? transport.prepareSendMessagesRequest(payload).body : payload;
+      fetch(endpoint, {
+        method: 'POST',
+        headers: _objectSpread(_objectSpread({}, headers), {}, {
+          'Content-Type': 'application/json'
+        }),
+        body: JSON.stringify(finalPayload)
+      }).then(function (response) {
+        if (!response.ok) {
+          throw new Error("HTTP error ".concat(response.status));
+        }
+        return response.json();
+      }).then(function (data) {
+        var parsedSuggestions = JSON.parse(data.parts[1].text);
+        var validSuggestions = (Array.isArray(parsedSuggestions) ? parsedSuggestions : []).filter(function (suggestion) {
+          if (!(suggestion !== null && suggestion !== void 0 && suggestion.attribute) || !(suggestion !== null && suggestion !== void 0 && suggestion.value) || !(suggestion !== null && suggestion !== void 0 && suggestion.label)) {
+            return false;
+          }
+          // If attributes filter is specified, only allow suggestions for those attributes
+          if (attributes && !attributes.includes(suggestion.attribute)) {
+            return false;
+          }
+          return true;
+        }).slice(0, maxSuggestions);
+        suggestions = validSuggestions;
+      }).catch(function () {
+        suggestions = [];
+      }).finally(function () {
+        var elapsed = Date.now() - loadingStartTime;
+        var remainingDelay = Math.max(0, MIN_SKELETON_DURATION_MS - elapsed);
+        var finishLoading = function finishLoading() {
+          isLoading = false;
+          renderFn(_objectSpread(_objectSpread({}, _getWidgetRenderState(renderOptions)), {}, {
+            instantSearchInstance: renderOptions.instantSearchInstance
+          }), false);
+        };
+        if (remainingDelay > 0) {
+          setTimeout(finishLoading, remainingDelay);
+        } else {
+          finishLoading();
+        }
+      });
+    };
+    return {
+      $$type: 'ais.filterSuggestions',
+      init: function init(initOptions) {
+        var instantSearchInstance = initOptions.instantSearchInstance,
+          helper = initOptions.helper;
+        searchHelper = helper;
+        if (transport) {
+          // Use custom transport configuration
+          endpoint = transport.api;
+          headers = transport.headers || {};
+        } else {
+          // Use default Algolia agent endpoint
+          var _getAppIdAndApiKey = (0, _utils.getAppIdAndApiKey)(instantSearchInstance.client),
+            _getAppIdAndApiKey2 = _slicedToArray(_getAppIdAndApiKey, 2),
+            appId = _getAppIdAndApiKey2[0],
+            apiKey = _getAppIdAndApiKey2[1];
+          if (!appId || !apiKey) {
+            throw new Error(withUsage('Could not extract Algolia credentials from the search client.'));
+          }
+          endpoint = "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/completions?compatibilityMode=ai-sdk-5&stream=false");
+          headers = {
+            'x-algolia-application-id': appId,
+            'x-algolia-api-key': apiKey,
+            'x-algolia-agent': (0, _utils.getAlgoliaAgent)(instantSearchInstance.client)
+          };
+        }
+        refine = function refine(attribute, value) {
+          var _helper$state$hierarc;
+          // Check if the attribute belongs to a hierarchical facet
+          // by finding a hierarchical facet that includes this attribute
+          var attr = ((_helper$state$hierarc = helper.state.hierarchicalFacets.find(function (facet) {
+            return facet.attributes.includes(attribute);
+          })) === null || _helper$state$hierarc === void 0 ? void 0 : _helper$state$hierarc.name) || attribute;
+          helper.toggleFacetRefinement(attr, value);
+          helper.search();
+        };
+        renderFn(_objectSpread(_objectSpread({}, _getWidgetRenderState(initOptions)), {}, {
+          instantSearchInstance: instantSearchInstance
+        }), true);
+      },
+      render: function render(renderOptions) {
+        var results = renderOptions.results,
+          instantSearchInstance = renderOptions.instantSearchInstance;
+
+        // Always store the latest render options
+        latestRenderOptions = renderOptions;
+        if (!results) {
+          renderFn(_objectSpread(_objectSpread({}, _getWidgetRenderState(renderOptions)), {}, {
+            instantSearchInstance: instantSearchInstance
+          }), false);
+          return;
+        }
+
+        // Debounce: only fetch if search state changed (query or refinements) and after delay
+        var stateSignature = getStateSignature(results);
+        if (stateSignature !== lastStateSignature) {
+          lastStateSignature = stateSignature;
+          clearTimeout(debounceTimer);
+          debounceTimer = setTimeout(function () {
+            var _latestRenderOptions;
+            // Use the latest render options when the timeout fires
+            if ((_latestRenderOptions = latestRenderOptions) !== null && _latestRenderOptions !== void 0 && _latestRenderOptions.results) {
+              fetchSuggestions(latestRenderOptions.results, latestRenderOptions);
+            }
+          }, debounceMs);
+        }
+        renderFn(_objectSpread(_objectSpread({}, _getWidgetRenderState(renderOptions)), {}, {
+          instantSearchInstance: instantSearchInstance
+        }), false);
+      },
+      dispose: function dispose() {
+        clearTimeout(debounceTimer);
+        unmountFn();
+      },
+      getRenderState: function getRenderState(renderState, renderOptions) {
+        return _objectSpread(_objectSpread({}, renderState), {}, {
+          filterSuggestions: this.getWidgetRenderState(renderOptions)
+        });
+      },
+      getWidgetRenderState: function getWidgetRenderState(renderOptions) {
+        return _getWidgetRenderState(renderOptions);
+      }
+    };
+  };
+};
+var _default = exports.default = connectFilterSuggestions;

package/cjs/connectors/index.js

@@ -46,6 +46,12 @@ Object.defineProperty(exports, "connectDynamicWidgets", {
     return _connectDynamicWidgets.default;
   }
 });
+Object.defineProperty(exports, "connectFilterSuggestions", {
+  enumerable: true,
+  get: function get() {
+    return _connectFilterSuggestions.default;
+  }
+});
 Object.defineProperty(exports, "connectFrequentlyBoughtTogether", {
   enumerable: true,
   get: function get() {
@@ -231,6 +237,7 @@ var _connectRelevantSort = _interopRequireDefault(require("./relevant-sort/conne
 var _connectFrequentlyBoughtTogether = _interopRequireDefault(require("./frequently-bought-together/connectFrequentlyBoughtTogether"));
 var _connectLookingSimilar = _interopRequireDefault(require("./looking-similar/connectLookingSimilar"));
 var _connectChat = _interopRequireDefault(require("./chat/connectChat"));
+var _connectFilterSuggestions = _interopRequireDefault(require("./filter-suggestions/connectFilterSuggestions"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /** @deprecated answers is no longer supported */
 var EXPERIMENTAL_connectAnswers = exports.EXPERIMENTAL_connectAnswers = (0, _utils.deprecate)(_connectAnswers.default, 'answers is no longer supported');

package/cjs/connectors/index.umd.js

@@ -41,6 +41,12 @@ Object.defineProperty(exports, "connectDynamicWidgets", {
     return _connectDynamicWidgets.default;
   }
 });
+Object.defineProperty(exports, "connectFilterSuggestions", {
+  enumerable: true,
+  get: function get() {
+    return _connectFilterSuggestions.default;
+  }
+});
 Object.defineProperty(exports, "connectFrequentlyBoughtTogether", {
   enumerable: true,
   get: function get() {
@@ -225,6 +231,7 @@ var _connectVoiceSearch = _interopRequireDefault(require("./voice-search/connect
 var _connectRelevantSort = _interopRequireDefault(require("./relevant-sort/connectRelevantSort"));
 var _connectFrequentlyBoughtTogether = _interopRequireDefault(require("./frequently-bought-together/connectFrequentlyBoughtTogether"));
 var _connectLookingSimilar = _interopRequireDefault(require("./looking-similar/connectLookingSimilar"));
+var _connectFilterSuggestions = _interopRequireDefault(require("./filter-suggestions/connectFilterSuggestions"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /** @deprecated answers is no longer supported */
 var EXPERIMENTAL_connectAnswers = exports.EXPERIMENTAL_connectAnswers = (0, _utils.deprecate)(_connectAnswers.default, 'answers is no longer supported');

package/cjs/index.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var connectors = _interopRequireWildcard(require("./connectors/index.umd"));
+var connectors = _interopRequireWildcard(require("./connectors/index"));
 var helpers = _interopRequireWildcard(require("./helpers/index"));
 var _index3 = require("./lib/infiniteHitsCache/index");
 var _InstantSearch = _interopRequireDefault(require("./lib/InstantSearch"));
@@ -14,7 +14,7 @@ var stateMappings = _interopRequireWildcard(require("./lib/stateMappings/index")
 var _version = _interopRequireDefault(require("./lib/version"));
 var middlewares = _interopRequireWildcard(require("./middlewares/index"));
 var templates = _interopRequireWildcard(require("./templates/index"));
-var widgets = _interopRequireWildcard(require("./widgets/index.umd"));
+var widgets = _interopRequireWildcard(require("./widgets/index"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 /**