react-instantsearch-core 7.33.1 → 7.35.0

package/dist/umd/ReactInstantSearchCore.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch Core 7.33.1 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! React InstantSearch Core 7.35.0 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react')) :
     typeof define === 'function' && define.amd ? define(['exports', 'react'], factory) :
@@ -24,7 +24,7 @@
 
     var React__namespace = /*#__PURE__*/_interopNamespaceDefault(React);
 
-    var version$2 = '7.33.1';
+    var version$2 = '7.35.0';
 
     function _define_property(obj, key, value) {
         if (key in obj) {
@@ -5980,7 +5980,7 @@
         }
     }
 
-    var withUsage$u = createDocumentationMessageGenerator({
+    var withUsage$v = createDocumentationMessageGenerator({
         name: 'configure',
         connector: true
     });
@@ -5996,7 +5996,7 @@
         var renderFn = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : noop, unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
         return function(widgetParams) {
             if (!widgetParams || !isPlainObject(widgetParams.searchParameters)) {
-                throw new Error(withUsage$u('The `searchParameters` option expects an object.'));
+                throw new Error(withUsage$v('The `searchParameters` option expects an object.'));
             }
             var connectorState = {};
             function refine(helper) {
@@ -7651,13 +7651,13 @@
         return null;
     }
 
-    var withUsage$t = createDocumentationMessageGenerator({
+    var withUsage$u = createDocumentationMessageGenerator({
         name: 'dynamic-widgets',
         connector: true
     });
     var connectDynamicWidgets = function connectDynamicWidgets(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$t());
+        checkRendering(renderFn, withUsage$u());
         return function(widgetParams) {
             var widgets = widgetParams.widgets, _widgetParams_maxValuesPerFacet = widgetParams.maxValuesPerFacet, maxValuesPerFacet = _widgetParams_maxValuesPerFacet === void 0 ? 20 : _widgetParams_maxValuesPerFacet, _widgetParams_facets = widgetParams.facets, facets = _widgetParams_facets === void 0 ? [
                 '*'
@@ -7667,10 +7667,10 @@
             if (!(widgets && Array.isArray(widgets) && widgets.every(function(widget) {
                 return (typeof widget === "undefined" ? "undefined" : _type_of(widget)) === 'object';
             }))) {
-                throw new Error(withUsage$t('The `widgets` option expects an array of widgets.'));
+                throw new Error(withUsage$u('The `widgets` option expects an array of widgets.'));
             }
             if (!Array.isArray(facets)) {
-                throw new Error(withUsage$t("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
+                throw new Error(withUsage$u("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
             }
             var localWidgets = new Map();
             return {
@@ -7772,7 +7772,7 @@
                         results: results
                     });
                     if (!Array.isArray(attributesToRender)) {
-                        throw new Error(withUsage$t('The `transformItems` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$u('The `transformItems` option expects a function that returns an Array.'));
                     }
                     return {
                         attributesToRender: attributesToRender,
@@ -8094,19 +8094,19 @@
             return toFeedSearchResults(lastResults._state, raw);
         });
     }
-    var withUsage$s = createDocumentationMessageGenerator({
+    var withUsage$t = createDocumentationMessageGenerator({
         name: 'feeds',
         connector: true
     });
     var connectFeeds = function connectFeeds(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$s());
+        checkRendering(renderFn, withUsage$t());
         return function(widgetParams) {
             var isolated = widgetParams.isolated, _widgetParams_transformFeeds = widgetParams.transformFeeds, transformFeeds = _widgetParams_transformFeeds === void 0 ? function(feeds) {
                 return feeds;
             } : _widgetParams_transformFeeds;
             if (isolated !== false) {
-                throw new Error(withUsage$s('The `isolated` option currently only supports `false`.'));
+                throw new Error(withUsage$t('The `isolated` option currently only supports `false`.'));
             }
             return {
                 $$type: 'ais.feeds',
@@ -8114,7 +8114,7 @@
                 init: function init(initOptions) {
                     var instantSearchInstance = initOptions.instantSearchInstance;
                     if (!instantSearchInstance.compositionID) {
-                        throw new Error(withUsage$s('The `feeds` widget requires a composition-based InstantSearch instance (compositionID must be set).'));
+                        throw new Error(withUsage$t('The `feeds` widget requires a composition-based InstantSearch instance (compositionID must be set).'));
                     }
                     hydrateFeedsFromInitialResultsIfNeeded(instantSearchInstance, initOptions.parent);
                     renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(initOptions)), {
@@ -8160,12 +8160,12 @@
                     ];
                     feedIDs = transformFeeds(feedIDs);
                     if (!Array.isArray(feedIDs)) {
-                        throw new Error(withUsage$s('The `transformFeeds` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$t('The `transformFeeds` option expects a function that returns an Array.'));
                     }
                     if (!feedIDs.every(function(feedID) {
                         return typeof feedID === 'string';
                     })) {
-                        throw new Error(withUsage$s('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
+                        throw new Error(withUsage$t('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
                     }
                     return {
                         feedIDs: feedIDs,
@@ -8276,7 +8276,7 @@
         }));
     }
 
-    var withUsage$r = createDocumentationMessageGenerator({
+    var withUsage$s = createDocumentationMessageGenerator({
         name: 'index-widget'
     });
     /**
@@ -8370,7 +8370,7 @@
     }
     var index = function index(widgetParams) {
         if (widgetParams === undefined || widgetParams.indexName === undefined && !widgetParams.EXPERIMENTAL_isolated) {
-            throw new Error(withUsage$r('The `indexName` option is required.'));
+            throw new Error(withUsage$s('The `indexName` option is required.'));
         }
         // When isolated=true, we use an empty string as the default indexName.
         // This is intentional: isolated indices do not require a real index name.
@@ -8460,7 +8460,7 @@
             addWidgets: function addWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$r('The `addWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$s('The `addWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8470,7 +8470,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.init !== 'function' && typeof widget.render !== 'function';
                 })) {
-                    throw new Error(withUsage$r('The widget definition expects a `render` and/or an `init` method.'));
+                    throw new Error(withUsage$s('The widget definition expects a `render` and/or an `init` method.'));
                 }
                 flatWidgets.forEach(function(widget) {
                     widget.parent = _this;
@@ -8530,7 +8530,7 @@
             removeWidgets: function removeWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$r('The `removeWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$s('The `removeWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8540,7 +8540,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.dispose !== 'function';
                 })) {
-                    throw new Error(withUsage$r('The widget definition expects a `dispose` method.'));
+                    throw new Error(withUsage$s('The widget definition expects a `dispose` method.'));
                 }
                 localWidgets = localWidgets.filter(function(widget) {
                     return flatWidgets.indexOf(widget) === -1;
@@ -10853,9 +10853,9 @@
         };
     }
 
-    var version = '4.99.0';
+    var version = '4.101.0';
 
-    var withUsage$q = createDocumentationMessageGenerator({
+    var withUsage$r = createDocumentationMessageGenerator({
         name: 'instantsearch'
     });
     function defaultCreateURL() {
@@ -10911,7 +10911,7 @@
             _this.setMaxListeners(100);
             var _options_indexName = options.indexName, indexName = _options_indexName === void 0 ? '' : _options_indexName, compositionID = options.compositionID, numberLocale = options.numberLocale, _options_initialUiState = options.initialUiState, initialUiState = _options_initialUiState === void 0 ? {} : _options_initialUiState, _options_routing = options.routing, routing = _options_routing === void 0 ? null : _options_routing, _options_insights = options.insights, insights = _options_insights === void 0 ? undefined : _options_insights, searchFunction = options.searchFunction, _options_stalledSearchDelay = options.stalledSearchDelay, stalledSearchDelay = _options_stalledSearchDelay === void 0 ? 200 : _options_stalledSearchDelay, _options_searchClient = options.searchClient, searchClient = _options_searchClient === void 0 ? null : _options_searchClient, _options_insightsClient = options.insightsClient, insightsClient = _options_insightsClient === void 0 ? null : _options_insightsClient, _options_onStateChange = options.onStateChange, onStateChange = _options_onStateChange === void 0 ? null : _options_onStateChange, _options_future1 = options.future, future = _options_future1 === void 0 ? _object_spread({}, INSTANTSEARCH_FUTURE_DEFAULTS, options.future || {}) : _options_future1;
             if (searchClient === null) {
-                throw new Error(withUsage$q('The `searchClient` option is required.'));
+                throw new Error(withUsage$r('The `searchClient` option is required.'));
             }
             if (typeof searchClient.search !== 'function') {
                 throw new Error("The `searchClient` must implement a `search` method.\n\nSee: https://www.algolia.com/doc/guides/building-search-ui/going-further/backend-search/in-depth/backend-instantsearch/js/");
@@ -10920,7 +10920,7 @@
                 searchClient.addAlgoliaAgent("instantsearch.js (".concat(version, ")"));
             }
             if (insightsClient && typeof insightsClient !== 'function') {
-                throw new Error(withUsage$q('The `insightsClient` option should be a function.'));
+                throw new Error(withUsage$r('The `insightsClient` option should be a function.'));
             }
             _this.client = searchClient;
             _this.future = future;
@@ -11068,12 +11068,12 @@
        * @param widgets The array of widgets to add to InstantSearch.
        */ function addWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$q('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
+                        throw new Error(withUsage$r('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
                     }
                     if (this.compositionID && widgets.some(function(w) {
                         return !Array.isArray(w) && isIndexWidget(w) && !w._isolated;
                     })) {
-                        throw new Error(withUsage$q('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
+                        throw new Error(withUsage$r('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
                     }
                     this.mainIndex.addWidgets(widgets);
                     return this;
@@ -11102,7 +11102,7 @@
        * The widgets must implement a `dispose()` method to clear their states.
        */ function removeWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$q('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
+                        throw new Error(withUsage$r('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
                     }
                     this.mainIndex.removeWidgets(widgets);
                     return this;
@@ -11116,7 +11116,7 @@
        */ function start() {
                     var _this = this;
                     if (this.started) {
-                        throw new Error(withUsage$q('The `start` method has already been called once.'));
+                        throw new Error(withUsage$r('The `start` method has already been called once.'));
                     }
                     // This Helper is used for the queries, we don't care about its state. The
                     // states are managed at the `index` level. We use this Helper to create
@@ -11318,7 +11318,7 @@
                     var _this = this;
                     var callOnStateChange = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$q('The `start` method needs to be called before `setUiState`.'));
+                        throw new Error(withUsage$r('The `start` method needs to be called before `setUiState`.'));
                     }
                     // We refresh the index UI state to update the local UI state that the
                     // main index passes to the function form of `setUiState`.
@@ -11355,7 +11355,7 @@
                 value: function createURL() {
                     var nextState = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
                     if (!this.started) {
-                        throw new Error(withUsage$q('The `start` method needs to be called before `createURL`.'));
+                        throw new Error(withUsage$r('The `start` method needs to be called before `createURL`.'));
                     }
                     return this._createURL(nextState);
                 }
@@ -11364,7 +11364,7 @@
                 key: "refresh",
                 value: function refresh() {
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$q('The `start` method needs to be called before `refresh`.'));
+                        throw new Error(withUsage$r('The `start` method needs to be called before `refresh`.'));
                     }
                     this.mainHelper.clearCache().search();
                 }
@@ -11890,13 +11890,13 @@
         }, children);
     }
 
-    var withUsage$p = createDocumentationMessageGenerator({
+    var withUsage$q = createDocumentationMessageGenerator({
         name: 'autocomplete',
         connector: true
     });
     var connectAutocomplete = function connectAutocomplete(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$p());
+        checkRendering(renderFn, withUsage$q());
         return function(widgetParams) {
             var _ref = widgetParams || {}, _ref_escapeHTML = _ref.escapeHTML, escapeHTML = _ref_escapeHTML === void 0 ? true : _ref_escapeHTML, _ref_transformItems = _ref.transformItems, transformItems = _ref_transformItems === void 0 ? function(indices) {
                 return indices;
@@ -12005,20 +12005,20 @@
         return useConnector(connectAutocomplete, props, additionalWidgetProperties);
     }
 
-    var withUsage$o = createDocumentationMessageGenerator({
+    var withUsage$p = createDocumentationMessageGenerator({
         name: 'breadcrumb',
         connector: true
     });
     var connectBreadcrumb = function connectBreadcrumb(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$o());
+        checkRendering(renderFn, withUsage$p());
         var connectorState = {};
         return function(widgetParams) {
             var _ref = widgetParams || {}, attributes = _ref.attributes, _ref_separator = _ref.separator, separator = _ref_separator === void 0 ? ' > ' : _ref_separator, _ref_rootPath = _ref.rootPath, rootPath = _ref_rootPath === void 0 ? null : _ref_rootPath, _ref_transformItems = _ref.transformItems, transformItems = _ref_transformItems === void 0 ? function(items) {
                 return items;
             } : _ref_transformItems;
             if (!attributes || !Array.isArray(attributes) || attributes.length === 0) {
-                throw new Error(withUsage$o('The `attributes` option expects an array of strings.'));
+                throw new Error(withUsage$p('The `attributes` option expects an array of strings.'));
             }
             var _attributes = _sliced_to_array(attributes, 1), hierarchicalFacetName = _attributes[0];
             function getRefinedState(state, facetValue) {
@@ -12262,16 +12262,21 @@
                     onDone();
                     return;
                 }
-                var result = onChunk(value);
-                if (result && typeof result.then === 'function') {
-                    result.then(function() {
-                        return read();
-                    }, function(error) {
-                        reader.releaseLock();
-                        onError(error);
-                    });
-                } else {
-                    read();
+                try {
+                    var result = onChunk(value);
+                    if (result && typeof result.then === 'function') {
+                        result.then(function() {
+                            return read();
+                        }, function(error) {
+                            reader.releaseLock();
+                            onError(error);
+                        });
+                    } else {
+                        read();
+                    }
+                } catch (error) {
+                    reader.releaseLock();
+                    onError(error);
                 }
             }, function(error) {
                 reader.releaseLock();
@@ -12281,6 +12286,49 @@
         read();
     }
 
+    function _construct(Parent, args, Class) {
+        if (_is_native_reflect_construct()) _construct = Reflect.construct;
+        else {
+            _construct = function construct(Parent, args, Class) {
+                var a = [null];
+                a.push.apply(a, args);
+                var Constructor = Function.bind.apply(Parent, a);
+                var instance = new Constructor();
+
+                if (Class) _set_prototype_of(instance, Class.prototype);
+
+                return instance;
+            };
+        }
+
+        return _construct.apply(null, arguments);
+    }
+
+    function _is_native_function(fn) {
+        return Function.toString.call(fn).indexOf("[native code]") !== -1;
+    }
+
+    function _wrap_native_super(Class) {
+        var _cache = typeof Map === "function" ? new Map() : undefined;
+        _wrap_native_super = function(Class) {
+            if (Class === null || !_is_native_function(Class)) return Class;
+            if (typeof Class !== "function") throw new TypeError("Super expression must either be null or a function");
+            if (typeof _cache !== "undefined") {
+                if (_cache.has(Class)) return _cache.get(Class);
+                _cache.set(Class, Wrapper);
+            }
+
+            function Wrapper() {
+                return _construct(Class, arguments, _get_prototype_of(this).constructor);
+            }
+            Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } });
+
+            return _set_prototype_of(Wrapper, Class);
+        };
+
+        return _wrap_native_super(Class);
+    }
+
     function generateId() {
         return Math.random().toString(36).substring(2, 9);
     }
@@ -12353,6 +12401,49 @@
         }
         return Promise.resolve(value);
     }
+    /**
+     * Error raised when the upstream stream emits a `data-guardrail-violation`
+     * chunk. The `message` carries the service-provided `fallbackResponse`, which
+     * is intentionally surfaced verbatim through the chat error UI (unlike
+     * generic cost-control / 4xx errors, where the raw API message is hidden
+     * behind a friendly default).
+     *
+     * Detection across package boundaries should rely on `error.name` rather than
+     * `instanceof` to avoid issues with mixed module copies in bundled apps.
+     */ var GuardrailViolationError = /*#__PURE__*/ function(Error1) {
+        _inherits(GuardrailViolationError, Error1);
+        function GuardrailViolationError(message) {
+            _class_call_check(this, GuardrailViolationError);
+            var _this;
+            _this = _call_super(this, GuardrailViolationError, [
+                message
+            ]);
+            _this.name = 'GuardrailViolationError';
+            return _this;
+        }
+        return GuardrailViolationError;
+    }(_wrap_native_super(Error));
+    /**
+     * Reads a non-empty `message` field off a JSON-serialized error envelope.
+     *
+     * Both transports backing `AbstractChat` (stream `error` chunks and HTTP error
+     * responses) serialize errors as `{"message": "...", ...}` — the same shape as
+     * the shared `ErrorResponse` on the API side. Returns the trimmed message if
+     * the input is such a JSON object, otherwise `undefined`.
+     */ function tryParseErrorMessage(text) {
+        try {
+            var parsed = JSON.parse(text);
+            if (parsed && (typeof parsed === "undefined" ? "undefined" : _type_of(parsed)) === 'object' && !Array.isArray(parsed) && typeof parsed.message === 'string') {
+                var message = parsed.message.trim();
+                if (message) {
+                    return message;
+                }
+            }
+        } catch (unused) {
+        // Not JSON — caller falls back to its own default.
+        }
+        return undefined;
+    }
 
     var tryParseJson = function tryParseJson(value) {
         try {
@@ -12431,7 +12522,7 @@
             var _param_generateId = param.generateId, generateId$1 = _param_generateId === void 0 ? generateId : _param_generateId, _param_id = param.id, id = _param_id === void 0 ? generateId$1() : _param_id, transport = param.transport, state = param.state, onError = param.onError, onToolCall = param.onToolCall, onFinish = param.onFinish, onData = param.onData, sendAutomaticallyWhen = param.sendAutomaticallyWhen, shouldRepairToolInput = param.shouldRepairToolInput;
             var _this1 = this;
             _class_call_check(this, AbstractChat);
-            _define_property(this, "id", void 0);
+            _define_property(this, "conversationId", void 0);
             _define_property(this, "generateId", void 0);
             _define_property(this, "state", void 0);
             _define_property(this, "transport", void 0);
@@ -12587,12 +12678,6 @@
                 }
             });
             /**
-       * Regenerate the chat id. Use this to start a fresh conversation on the
-       * server while keeping the same Chat instance and its registered listeners.
-       */ _define_property(this, "regenerateId", function() {
-                _this.id = _this.generateId();
-            });
-            /**
        * Add a tool result for a tool call.
        */ _define_property(this, "addToolResult", function(param) {
                 var tool = param.tool, toolCallId = param.toolCallId, output = param.output;
@@ -12647,7 +12732,7 @@
                 });
                 return Promise.resolve();
             });
-            this.id = id;
+            this.conversationId = id;
             this.generateId = generateId$1;
             this.state = state;
             this.transport = transport;
@@ -12659,6 +12744,12 @@
             this.shouldRepairToolInput = shouldRepairToolInput;
         }
         _create_class(AbstractChat, [
+            {
+                key: "id",
+                get: function get() {
+                    return this.conversationId;
+                }
+            },
             {
                 key: "status",
                 get: /**
@@ -12688,6 +12779,17 @@
                     return this.state.error;
                 }
             },
+            {
+                /**
+       * Starts a new server-side conversation thread by rotating the id sent as
+       * `chatId` / `id` on the next request. The InstantSearch connector calls this
+       * after the user clears the transcript so completions are not tied to prior
+       * context.
+       */ key: "resetConversationId",
+                value: function resetConversationId() {
+                    this.conversationId = this.generateId();
+                }
+            },
             {
                 key: "messages",
                 get: function get() {
@@ -13056,8 +13158,7 @@
                                             var updatedParts7 = _to_consumable_array(currentMessage.parts);
                                             var existingPart2 = updatedParts7[toolIndex2];
                                             // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
-                                            existingPart2.rawOutput;
-                                            var rest = _object_without_properties(existingPart2, [
+                                            var _ignored = existingPart2.rawOutput, rest = _object_without_properties(existingPart2, [
                                                 "rawOutput"
                                             ]);
                                             updatedParts7[toolIndex2] = _object_spread_props(_object_spread({}, rest), {
@@ -13085,10 +13186,7 @@
                                             delete toolRawOutputByCallId[chunk.toolCallId];
                                             var updatedParts8 = _to_consumable_array(currentMessage.parts);
                                             var existingPart3 = updatedParts8[toolIndex3];
-                                            // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
-                                            existingPart3.rawOutput; // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
-                                            existingPart3.preliminary;
-                                            var rest1 = _object_without_properties(existingPart3, [
+                                            var _ignoredRawOutput = existingPart3.rawOutput, _ignoredPreliminary = existingPart3.preliminary, rest1 = _object_without_properties(existingPart3, [
                                                 "rawOutput",
                                                 "preliminary"
                                             ]);
@@ -13183,7 +13281,8 @@
                                 case 'error':
                                     {
                                         isError = true;
-                                        throw new Error(chunk.errorText);
+                                        var text = chunk.errorText.trim();
+                                        throw new Error(tryParseErrorMessage(text) || text || 'Unknown error');
                                     }
                                 case 'abort':
                                     {
@@ -13200,9 +13299,32 @@
                                         }
                                         break;
                                     }
+                                // Surface guardrail violations through the error state, but
+                                // distinct from generic cost-control / 4xx errors: throw a
+                                // `GuardrailViolationError` so the UI can render the
+                                // service-provided `fallbackResponse` verbatim (it's authored for
+                                // end-user display) instead of the friendly default used for
+                                // opaque transport errors. Also discard any in-progress assistant
+                                // message so no partial text lingers above the fallback, and
+                                // clear the local cursor so the `onFinish` callback doesn't
+                                // receive a `currentMessage` that no longer exists in state.
+                                case 'data-guardrail-violation':
+                                    {
+                                        isError = true;
+                                        if (currentMessageIndex >= 0) {
+                                            _this.state.messages = _this.state.messages.slice(0, currentMessageIndex);
+                                            currentMessage = undefined;
+                                            currentMessageIndex = -1;
+                                        }
+                                        // `chunk.data` widens to `unknown` here: the chunk union also
+                                        // carries a generic `data-${string}` member, and the literal
+                                        // matches both, so narrowing can't pick the specific shape.
+                                        var fallbackResponse = chunk.data.fallbackResponse;
+                                        throw new GuardrailViolationError(fallbackResponse || 'Sorry, we are not able to generate a response at the moment.');
+                                    }
                                 default:
                                     {
-                                        // Handle data parts (data-*)
+                                        // Handle generic data parts (data-*)
                                         var chunkType = chunk.type;
                                         if ((chunkType === null || chunkType === void 0 ? void 0 : chunkType.startsWith('data-')) && currentMessage) {
                                             var dataPart = {
@@ -13469,6 +13591,41 @@
         return Chat;
     }(AbstractChat);
 
+    // Centralizes the "open the chat from an entry point" behavior shared by the
+    // SearchBox AI button, the Autocomplete AI button, prompt suggestions, and any
+    // future entry point. The chat is always opened; the message is only sent when
+    // it is non-empty and the chat is not already processing a message.
+    // Returns true when a message was submitted, so callers can clear their input.
+    function openChat(chatRenderState) {
+        var _ref = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}, message = _ref.message, referer = _ref.referer;
+        var _ref1;
+        var _chatRenderState_setOpen;
+        if (!chatRenderState) {
+            return false;
+        }
+        (_chatRenderState_setOpen = chatRenderState.setOpen) === null || _chatRenderState_setOpen === void 0 ? void 0 : _chatRenderState_setOpen.call(chatRenderState, true);
+        var trimmed = (_ref1 = message === null || message === void 0 ? void 0 : message.trim()) !== null && _ref1 !== void 0 ? _ref1 : '';
+        if (!trimmed) {
+            var _chatRenderState_focusInput;
+            (_chatRenderState_focusInput = chatRenderState.focusInput) === null || _chatRenderState_focusInput === void 0 ? void 0 : _chatRenderState_focusInput.call(chatRenderState);
+            return false;
+        }
+        if (isChatBusy(chatRenderState) || !chatRenderState.sendMessage) {
+            return false;
+        }
+        chatRenderState.sendMessage({
+            text: trimmed
+        }, referer ? {
+            headers: {
+                'x-algolia-referer': referer
+            }
+        } : undefined);
+        return true;
+    }
+    function isChatBusy(chatRenderState) {
+        return (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'submitted' || (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'streaming';
+    }
+
     var SearchIndexToolType = 'algolia_search_index';
 
     function flat(arr) {
@@ -13477,6 +13634,20 @@
         }, []);
     }
 
+    /**
+     * Reads a human-readable message from a failed HTTP response body when the
+     * server returns JSON such as `{ "message": "..." }` (the shared
+     * `ErrorResponse` shape used by every status code), falling back to the HTTP
+     * status line when the body is empty or not parseable.
+     */ function getHttpErrorMessage(response) {
+        var fallback = "HTTP error: ".concat(response.status, " ").concat(response.statusText);
+        return response.text().then(function(text) {
+            var _tryParseErrorMessage;
+            return (_tryParseErrorMessage = tryParseErrorMessage(text)) !== null && _tryParseErrorMessage !== void 0 ? _tryParseErrorMessage : fallback;
+        }).catch(function() {
+            return fallback;
+        });
+    }
     /**
      * Abstract base class for HTTP-based chat transports.
      */ var HttpChatTransport = /*#__PURE__*/ function() {
@@ -13555,7 +13726,9 @@
                                 credentials: credentials
                             }).then(function(response) {
                                 if (!response.ok) {
-                                    throw new Error("HTTP error: ".concat(response.status, " ").concat(response.statusText));
+                                    return getHttpErrorMessage(response).then(function(message) {
+                                        throw new Error(message);
+                                    });
                                 }
                                 if (!response.body) {
                                     throw new Error('Response body is empty');
@@ -13613,7 +13786,9 @@
                                     if (response.status === 404) {
                                         return null;
                                     }
-                                    throw new Error("HTTP error: ".concat(response.status, " ").concat(response.statusText));
+                                    return getHttpErrorMessage(response).then(function(message) {
+                                        throw new Error(message);
+                                    });
                                 }
                                 if (!response.body) {
                                     return null;
@@ -13649,7 +13824,7 @@
         return DefaultChatTransport;
     }(HttpChatTransport);
 
-    var withUsage$n = createDocumentationMessageGenerator({
+    var withUsage$o = createDocumentationMessageGenerator({
         name: 'chat',
         connector: true
     });
@@ -13700,15 +13875,16 @@
     }
     var connectChat = function connectChat(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$n());
+        checkRendering(renderFn, withUsage$o());
         return function(widgetParams) {
-            var _ref = widgetParams || {}, _ref_resume = _ref.resume, 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, context = _ref.context, initialUserMessage = _ref.initialUserMessage, initialMessages = _ref.initialMessages, options = _object_without_properties(_ref, [
+            var _ref = widgetParams || {}, _ref_resume = _ref.resume, 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, context = _ref.context, initialUserMessage = _ref.initialUserMessage, initialMessages = _ref.initialMessages, _ref_disableTriggerValidation = _ref.disableTriggerValidation, disableTriggerValidation = _ref_disableTriggerValidation === void 0 ? false : _ref_disableTriggerValidation, options = _object_without_properties(_ref, [
                 "resume",
                 "tools",
                 "type",
                 "context",
                 "initialUserMessage",
-                "initialMessages"
+                "initialMessages",
+                "disableTriggerValidation"
             ]);
             var _chatInstance;
             var input = '';
@@ -13720,6 +13896,7 @@
             var focusInput;
             var setIsClearing;
             var setFeedbackState;
+            var hasValidatedEntryPoints = false;
             var agentId = 'agentId' in options ? options.agentId : undefined;
             var feedbackState = {};
             var _sendChatMessageFeedback;
@@ -13759,10 +13936,26 @@
             var onClearTransitionEnd = function onClearTransitionEnd() {
                 setMessages([]);
                 _chatInstance.clearError();
-                _chatInstance.regenerateId();
+                _chatInstance.resetConversationId();
                 feedbackState = {};
                 setIsClearing(false);
             };
+            var validateEntryPoints = function validateEntryPoints(instantSearchInstance) {
+                if (disableTriggerValidation || hasValidatedEntryPoints) {
+                    return;
+                }
+                // warning only relevant once mounted
+                if (!instantSearchInstance.mainIndex) {
+                    return;
+                }
+                walkIndex(instantSearchInstance.mainIndex, function(indexWidget) {
+                    var widgets = indexWidget.getWidgets();
+                    if (widgets.some(function(w) {
+                        return w.opensChat === true;
+                    })) ;
+                });
+                hasValidatedEntryPoints = true;
+            };
             var makeChatInstance = function makeChatInstance(instantSearchInstance) {
                 var transport;
                 var client = instantSearchInstance.client;
@@ -13812,7 +14005,7 @@
                 }
                 if ('agentId' in options && options.agentId) {
                     if (!appId || !apiKey) {
-                        throw new Error(withUsage$n('Could not extract Algolia credentials from the search client.'));
+                        throw new Error(withUsage$o('Could not extract Algolia credentials from the search client.'));
                     }
                     var baseApi = "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/completions?compatibilityMode=ai-sdk-5");
                     transport = new DefaultChatTransport({
@@ -13837,7 +14030,7 @@
                     });
                 }
                 if (!transport) {
-                    throw new Error(withUsage$n('You need to provide either an `agentId` or a `transport`.'));
+                    throw new Error(withUsage$o('You need to provide either an `agentId` or a `transport`.'));
                 }
                 if ('chat' in options) {
                     return options.chat;
@@ -13889,6 +14082,7 @@
                 init: function init(initOptions) {
                     var _this = this;
                     var instantSearchInstance = initOptions.instantSearchInstance;
+                    validateEntryPoints(instantSearchInstance);
                     _chatInstance = makeChatInstance(instantSearchInstance);
                     var render = function render() {
                         renderFn(_object_spread_props(_object_spread({}, _this.getWidgetRenderState(initOptions)), {
@@ -13898,6 +14092,10 @@
                     setOpen = function setOpen(o) {
                         open = o;
                         render();
+                        // `open` is read by sibling widgets (e.g. `chatTrigger`) via the
+                        // shared `renderState`. Schedule a full re-render so they pick up
+                        // the new value instead of staying frozen on their initial state.
+                        initOptions.instantSearchInstance.scheduleRender();
                     };
                     focusInput = function focusInput() {
                         setOpen(true);
@@ -13918,7 +14116,7 @@
                     if (agentId && feedback) {
                         var _getAppIdAndApiKey = _sliced_to_array(getAppIdAndApiKey(initOptions.instantSearchInstance.client), 2), appId = _getAppIdAndApiKey[0], apiKey = _getAppIdAndApiKey[1];
                         if (!appId || !apiKey) {
-                            throw new Error(withUsage$n('Could not extract Algolia credentials from the search client.'));
+                            throw new Error(withUsage$o('Could not extract Algolia credentials from the search client.'));
                         }
                         feedbackAbortController = new AbortController();
                         _sendChatMessageFeedback = function _sendChatMessageFeedback(messageId, vote) {
@@ -13959,6 +14157,7 @@
                     }), true);
                 },
                 render: function render(renderOptions) {
+                    validateEntryPoints(renderOptions.instantSearchInstance);
                     renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(renderOptions)), {
                         instantSearchInstance: renderOptions.instantSearchInstance
                     }), false);
@@ -14065,6 +14264,77 @@
         return useConnector(connectChat, props, additionalWidgetProperties);
     }
 
+    var withUsage$n = createDocumentationMessageGenerator({
+        name: 'chatTrigger',
+        connector: true
+    });
+    // Reads the sibling chat widget's render state from the live cross-index
+    // `instantSearchInstance.renderState` map. We resolve at call time so that
+    // `toggleOpen` always sees the latest `open`/`setOpen` values.
+    function getChatRenderState(options) {
+        var _options_parent, _options_instantSearchInstance_renderState_indexId;
+        var indexId = (_options_parent = options.parent) === null || _options_parent === void 0 ? void 0 : _options_parent.getIndexId();
+        if (!indexId) return undefined;
+        return (_options_instantSearchInstance_renderState_indexId = options.instantSearchInstance.renderState[indexId]) === null || _options_instantSearchInstance_renderState_indexId === void 0 ? void 0 : _options_instantSearchInstance_renderState_indexId.chat;
+    }
+    var connectChatTrigger = function connectChatTrigger(renderFn) {
+        var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
+        checkRendering(renderFn, withUsage$n());
+        return function(widgetParams) {
+            var params = widgetParams !== null && widgetParams !== void 0 ? widgetParams : {};
+            var lastOptions = null;
+            function toggleOpen() {
+                if (!lastOptions) return;
+                var chatState = getChatRenderState(lastOptions);
+                if (!chatState) return;
+                if (chatState.open) {
+                    var _chatState_setOpen;
+                    (_chatState_setOpen = chatState.setOpen) === null || _chatState_setOpen === void 0 ? void 0 : _chatState_setOpen.call(chatState, false);
+                } else {
+                    openChat(chatState);
+                }
+            }
+            return {
+                $$type: 'ais.chatTrigger',
+                opensChat: true,
+                init: function init(initOptions) {
+                    lastOptions = initOptions;
+                    renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(initOptions)), {
+                        instantSearchInstance: initOptions.instantSearchInstance
+                    }), true);
+                },
+                render: function render(renderOptions) {
+                    lastOptions = renderOptions;
+                    renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(renderOptions)), {
+                        instantSearchInstance: renderOptions.instantSearchInstance
+                    }), false);
+                },
+                dispose: function dispose() {
+                    unmountFn();
+                },
+                getWidgetRenderState: function getWidgetRenderState(renderOptions) {
+                    var _ref;
+                    var chatState = getChatRenderState(renderOptions);
+                    return {
+                        open: (_ref = chatState === null || chatState === void 0 ? void 0 : chatState.open) !== null && _ref !== void 0 ? _ref : false,
+                        toggleOpen: toggleOpen,
+                        widgetParams: params
+                    };
+                },
+                getRenderState: function getRenderState(renderState, renderOptions) {
+                    return _object_spread_props(_object_spread({}, renderState), {
+                        chatTrigger: this.getWidgetRenderState(renderOptions)
+                    });
+                }
+            };
+        };
+    };
+
+    function useChatTrigger() {
+        var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, additionalWidgetProperties = arguments.length > 1 ? arguments[1] : void 0;
+        return useConnector(connectChatTrigger, props, additionalWidgetProperties);
+    }
+
     var withUsage$m = createDocumentationMessageGenerator({
         name: 'clear-refinements',
         connector: true
@@ -18190,6 +18460,7 @@
     exports.useAutocomplete = useAutocomplete;
     exports.useBreadcrumb = useBreadcrumb;
     exports.useChat = useChat;
+    exports.useChatTrigger = useChatTrigger;
     exports.useClearRefinements = useClearRefinements;
     exports.useConfigure = useConfigure;
     exports.useConnector = useConnector;