react-instantsearch-core 7.33.1 → 7.34.0

package/dist/cjs/connectors/useChatTrigger.js

@@ -0,0 +1,18 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "useChatTrigger", {
+    enumerable: true,
+    get: function() {
+        return useChatTrigger;
+    }
+});
+var _interop_require_default = require("@swc/helpers/_/_interop_require_default");
+var _connectChatTrigger = /*#__PURE__*/ _interop_require_default._(require("instantsearch.js/cjs/connectors/chat/connectChatTrigger"));
+var _useConnector = require("../hooks/useConnector");
+function useChatTrigger() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, additionalWidgetProperties = arguments.length > 1 ? arguments[1] : void 0;
+    return (0, _useConnector.useConnector)(_connectChatTrigger.default, props, additionalWidgetProperties);
+}

package/dist/cjs/index.js

@@ -22,6 +22,7 @@ _export_star._(require("./components/InstantSearchSSRProvider"), exports);
 _export_star._(require("./connectors/useAutocomplete"), exports);
 _export_star._(require("./connectors/useBreadcrumb"), exports);
 _export_star._(require("./connectors/useChat"), exports);
+_export_star._(require("./connectors/useChatTrigger"), exports);
 _export_star._(require("./connectors/useClearRefinements"), exports);
 _export_star._(require("./connectors/useConfigure"), exports);
 _export_star._(require("./connectors/useCurrentRefinements"), exports);

package/dist/cjs/version.js

@@ -9,4 +9,4 @@ Object.defineProperty(exports, "default", {
         return _default;
     }
 });
-var _default = '7.33.1';
+var _default = '7.34.0';

package/dist/es/connectors/useChatTrigger.d.ts

@@ -0,0 +1,4 @@
+import type { AdditionalWidgetProperties } from '../hooks/useConnector';
+import type { ChatTriggerConnectorParams } from 'instantsearch.js/es/connectors/chat/connectChatTrigger';
+export type UseChatTriggerProps = ChatTriggerConnectorParams;
+export declare function useChatTrigger(props?: UseChatTriggerProps, additionalWidgetProperties?: AdditionalWidgetProperties): import("instantsearch.js/es/connectors/chat/connectChatTrigger").ChatTriggerRenderState;

package/dist/es/connectors/useChatTrigger.js

@@ -0,0 +1,9 @@
+import connectChatTrigger from 'instantsearch.js/es/connectors/chat/connectChatTrigger.js';
+import { useConnector } from '../hooks/useConnector.js';
+
+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);
+}
+
+export { useChatTrigger };

package/dist/es/hooks/useConnector.d.ts

@@ -1,5 +1,6 @@
 import type { Connector, Widget, WidgetDescription } from 'instantsearch.js';
 export type AdditionalWidgetProperties = Partial<Widget<WidgetDescription>> & {
     skipSuspense?: boolean;
+    opensChat?: boolean;
 };
 export declare function useConnector<TProps extends Record<string, unknown>, TDescription extends WidgetDescription>(connector: Connector<TDescription, TProps>, props?: TProps, { skipSuspense, ...additionalWidgetProperties }?: AdditionalWidgetProperties): TDescription['renderState'];

package/dist/es/index.d.ts

@@ -9,6 +9,7 @@ export * from './components/InstantSearchSSRProvider';
 export * from './connectors/useAutocomplete';
 export * from './connectors/useBreadcrumb';
 export * from './connectors/useChat';
+export * from './connectors/useChatTrigger';
 export * from './connectors/useClearRefinements';
 export * from './connectors/useConfigure';
 export * from './connectors/useCurrentRefinements';

package/dist/es/index.js

@@ -9,6 +9,7 @@ export { InstantSearchSSRProvider } from './components/InstantSearchSSRProvider.
 export { useAutocomplete } from './connectors/useAutocomplete.js';
 export { useBreadcrumb } from './connectors/useBreadcrumb.js';
 export { useChat } from './connectors/useChat.js';
+export { useChatTrigger } from './connectors/useChatTrigger.js';
 export { useClearRefinements } from './connectors/useClearRefinements.js';
 export { useConfigure } from './connectors/useConfigure.js';
 export { useCurrentRefinements } from './connectors/useCurrentRefinements.js';

package/dist/es/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "7.33.1";
+declare const _default: "7.34.0";
 export default _default;

package/dist/es/version.js

@@ -1,3 +1,3 @@
-var version = '7.33.1';
+var version = '7.34.0';
 
 export { version as default };

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.34.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.34.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.100.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) {
@@ -13469,6 +13469,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) {
@@ -13649,7 +13684,7 @@
         return DefaultChatTransport;
     }(HttpChatTransport);
 
-    var withUsage$n = createDocumentationMessageGenerator({
+    var withUsage$o = createDocumentationMessageGenerator({
         name: 'chat',
         connector: true
     });
@@ -13700,15 +13735,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 +13756,7 @@
             var focusInput;
             var setIsClearing;
             var setFeedbackState;
+            var hasValidatedEntryPoints = false;
             var agentId = 'agentId' in options ? options.agentId : undefined;
             var feedbackState = {};
             var _sendChatMessageFeedback;
@@ -13763,6 +13800,22 @@
                 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 +13865,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 +13890,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 +13942,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 +13952,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 +13976,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 +14017,7 @@
                     }), true);
                 },
                 render: function render(renderOptions) {
+                    validateEntryPoints(renderOptions.instantSearchInstance);
                     renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(renderOptions)), {
                         instantSearchInstance: renderOptions.instantSearchInstance
                     }), false);
@@ -14065,6 +14124,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 +18320,7 @@
     exports.useAutocomplete = useAutocomplete;
     exports.useBreadcrumb = useBreadcrumb;
     exports.useChat = useChat;
+    exports.useChatTrigger = useChatTrigger;
     exports.useClearRefinements = useClearRefinements;
     exports.useConfigure = useConfigure;
     exports.useConnector = useConnector;