@cossistant/react 0.0.26 → 0.0.29

package/support/context/events.js

@@ -0,0 +1,139 @@
+"use client";
+
+
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/events.tsx
+const SupportEventsContext = React$1.createContext(null);
+/**
+* Provider for support widget events.
+* Allows listening to lifecycle events like message sent/received,
+* conversation start/end, and errors.
+*
+* @example
+* <Support
+*   onMessageSent={({ message }) => console.log("Sent:", message)}
+*   onMessageReceived={({ message }) => console.log("Received:", message)}
+*   onConversationStart={({ conversationId }) => console.log("Started:", conversationId)}
+*   onError={({ error }) => console.error("Error:", error)}
+* />
+*/
+const SupportEventsProvider = ({ onConversationStart, onConversationEnd, onMessageSent, onMessageReceived, onError, children }) => {
+	const callbacksRef = React$1.useRef({
+		onConversationStart,
+		onConversationEnd,
+		onMessageSent,
+		onMessageReceived,
+		onError
+	});
+	React$1.useEffect(() => {
+		callbacksRef.current = {
+			onConversationStart,
+			onConversationEnd,
+			onMessageSent,
+			onMessageReceived,
+			onError
+		};
+	}, [
+		onConversationStart,
+		onConversationEnd,
+		onMessageSent,
+		onMessageReceived,
+		onError
+	]);
+	const subscribersRef = React$1.useRef(/* @__PURE__ */ new Map());
+	const emit = React$1.useCallback((event) => {
+		switch (event.type) {
+			case "conversationStart":
+				callbacksRef.current.onConversationStart?.(event);
+				break;
+			case "conversationEnd":
+				callbacksRef.current.onConversationEnd?.(event);
+				break;
+			case "messageSent":
+				callbacksRef.current.onMessageSent?.(event);
+				break;
+			case "messageReceived":
+				callbacksRef.current.onMessageReceived?.(event);
+				break;
+			case "error":
+				callbacksRef.current.onError?.(event);
+				break;
+			default: break;
+		}
+		const subscribers = subscribersRef.current.get(event.type);
+		if (subscribers) for (const callback of subscribers) callback(event);
+	}, []);
+	const subscribe = React$1.useCallback((type, callback) => {
+		if (!subscribersRef.current.has(type)) subscribersRef.current.set(type, /* @__PURE__ */ new Set());
+		const subscribers = subscribersRef.current.get(type);
+		subscribers?.add(callback);
+		return () => {
+			subscribers?.delete(callback);
+		};
+	}, []);
+	const value = React$1.useMemo(() => ({
+		emit,
+		subscribe
+	}), [emit, subscribe]);
+	return /* @__PURE__ */ jsx(SupportEventsContext.Provider, {
+		value,
+		children
+	});
+};
+/**
+* Access the events context.
+* Returns null if not inside a SupportEventsProvider.
+*/
+function useSupportEvents() {
+	return React$1.useContext(SupportEventsContext);
+}
+/**
+* Hook to emit events from within the widget.
+* Safe to use outside of provider (will no-op).
+*/
+function useSupportEventEmitter() {
+	const events = useSupportEvents();
+	return React$1.useMemo(() => ({
+		emitConversationStart: (conversationId, conversation) => {
+			events?.emit({
+				type: "conversationStart",
+				conversationId,
+				conversation
+			});
+		},
+		emitConversationEnd: (conversationId, conversation) => {
+			events?.emit({
+				type: "conversationEnd",
+				conversationId,
+				conversation
+			});
+		},
+		emitMessageSent: (conversationId, message) => {
+			events?.emit({
+				type: "messageSent",
+				conversationId,
+				message
+			});
+		},
+		emitMessageReceived: (conversationId, message) => {
+			events?.emit({
+				type: "messageReceived",
+				conversationId,
+				message
+			});
+		},
+		emitError: (error, context) => {
+			events?.emit({
+				type: "error",
+				error,
+				context
+			});
+		}
+	}), [events]);
+}
+
+//#endregion
+export { SupportEventsProvider, useSupportEventEmitter, useSupportEvents };
+//# sourceMappingURL=events.js.map

package/support/context/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":["React","SupportEventsProvider: React.FC<SupportEventsProviderProps>"],"sources":["../../../src/support/context/events.tsx"],"sourcesContent":["\"use client\";\n\nimport type { Conversation } from \"@cossistant/types\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport * as React from \"react\";\n\n// =============================================================================\n// Event Types\n// =============================================================================\n\nexport type SupportEventType =\n\t| \"conversationStart\"\n\t| \"conversationEnd\"\n\t| \"messageSent\"\n\t| \"messageReceived\"\n\t| \"error\";\n\nexport type ConversationStartEvent = {\n\ttype: \"conversationStart\";\n\tconversationId: string;\n\tconversation?: Conversation;\n};\n\nexport type ConversationEndEvent = {\n\ttype: \"conversationEnd\";\n\tconversationId: string;\n\tconversation?: Conversation;\n};\n\nexport type MessageSentEvent = {\n\ttype: \"messageSent\";\n\tconversationId: string;\n\tmessage: TimelineItem;\n};\n\nexport type MessageReceivedEvent = {\n\ttype: \"messageReceived\";\n\tconversationId: string;\n\tmessage: TimelineItem;\n};\n\nexport type ErrorEvent = {\n\ttype: \"error\";\n\terror: Error;\n\tcontext?: string;\n};\n\nexport type SupportEvent =\n\t| ConversationStartEvent\n\t| ConversationEndEvent\n\t| MessageSentEvent\n\t| MessageReceivedEvent\n\t| ErrorEvent;\n\n// =============================================================================\n// Event Callbacks\n// =============================================================================\n\nexport type SupportEventCallbacks = {\n\t/**\n\t * Called when a new conversation is started.\n\t */\n\tonConversationStart?: (event: ConversationStartEvent) => void;\n\t/**\n\t * Called when a conversation ends (resolved, closed, etc.).\n\t */\n\tonConversationEnd?: (event: ConversationEndEvent) => void;\n\t/**\n\t * Called when the visitor sends a message.\n\t */\n\tonMessageSent?: (event: MessageSentEvent) => void;\n\t/**\n\t * Called when a message is received from an agent (human or AI).\n\t */\n\tonMessageReceived?: (event: MessageReceivedEvent) => void;\n\t/**\n\t * Called when an error occurs.\n\t */\n\tonError?: (event: ErrorEvent) => void;\n};\n\n// =============================================================================\n// Context\n// =============================================================================\n\nexport type SupportEventsContextValue = {\n\t/**\n\t * Emit an event to all registered callbacks.\n\t */\n\temit: <T extends SupportEvent>(event: T) => void;\n\t/**\n\t * Subscribe to a specific event type.\n\t * Returns an unsubscribe function.\n\t */\n\tsubscribe: <T extends SupportEventType>(\n\t\ttype: T,\n\t\tcallback: (event: Extract<SupportEvent, { type: T }>) => void\n\t) => () => void;\n};\n\nconst SupportEventsContext =\n\tReact.createContext<SupportEventsContextValue | null>(null);\n\nexport type SupportEventsProviderProps = SupportEventCallbacks & {\n\tchildren: React.ReactNode;\n};\n\n/**\n * Provider for support widget events.\n * Allows listening to lifecycle events like message sent/received,\n * conversation start/end, and errors.\n *\n * @example\n * <Support\n *   onMessageSent={({ message }) => console.log(\"Sent:\", message)}\n *   onMessageReceived={({ message }) => console.log(\"Received:\", message)}\n *   onConversationStart={({ conversationId }) => console.log(\"Started:\", conversationId)}\n *   onError={({ error }) => console.error(\"Error:\", error)}\n * />\n */\nexport const SupportEventsProvider: React.FC<SupportEventsProviderProps> = ({\n\tonConversationStart,\n\tonConversationEnd,\n\tonMessageSent,\n\tonMessageReceived,\n\tonError,\n\tchildren,\n}) => {\n\t// Store callbacks in refs to avoid stale closures\n\tconst callbacksRef = React.useRef<SupportEventCallbacks>({\n\t\tonConversationStart,\n\t\tonConversationEnd,\n\t\tonMessageSent,\n\t\tonMessageReceived,\n\t\tonError,\n\t});\n\n\t// Update refs when callbacks change\n\tReact.useEffect(() => {\n\t\tcallbacksRef.current = {\n\t\t\tonConversationStart,\n\t\t\tonConversationEnd,\n\t\t\tonMessageSent,\n\t\t\tonMessageReceived,\n\t\t\tonError,\n\t\t};\n\t}, [\n\t\tonConversationStart,\n\t\tonConversationEnd,\n\t\tonMessageSent,\n\t\tonMessageReceived,\n\t\tonError,\n\t]);\n\n\t// Additional subscribers (for internal use)\n\tconst subscribersRef = React.useRef<\n\t\tMap<SupportEventType, Set<(event: SupportEvent) => void>>\n\t>(new Map());\n\n\tconst emit = React.useCallback(<T extends SupportEvent>(event: T) => {\n\t\t// Call the prop callback\n\t\tswitch (event.type) {\n\t\t\tcase \"conversationStart\":\n\t\t\t\tcallbacksRef.current.onConversationStart?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"conversationEnd\":\n\t\t\t\tcallbacksRef.current.onConversationEnd?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"messageSent\":\n\t\t\t\tcallbacksRef.current.onMessageSent?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"messageReceived\":\n\t\t\t\tcallbacksRef.current.onMessageReceived?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"error\":\n\t\t\t\tcallbacksRef.current.onError?.(event);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t// Unknown event type - no callback to call\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// Call any additional subscribers\n\t\tconst subscribers = subscribersRef.current.get(event.type);\n\t\tif (subscribers) {\n\t\t\tfor (const callback of subscribers) {\n\t\t\t\tcallback(event);\n\t\t\t}\n\t\t}\n\t}, []);\n\n\tconst subscribe = React.useCallback(\n\t\t<T extends SupportEventType>(\n\t\t\ttype: T,\n\t\t\tcallback: (event: Extract<SupportEvent, { type: T }>) => void\n\t\t) => {\n\t\t\tif (!subscribersRef.current.has(type)) {\n\t\t\t\tsubscribersRef.current.set(type, new Set());\n\t\t\t}\n\t\t\tconst subscribers = subscribersRef.current.get(type);\n\t\t\tsubscribers?.add(callback as (event: SupportEvent) => void);\n\n\t\t\t// Return unsubscribe function\n\t\t\treturn () => {\n\t\t\t\tsubscribers?.delete(callback as (event: SupportEvent) => void);\n\t\t\t};\n\t\t},\n\t\t[]\n\t);\n\n\tconst value = React.useMemo<SupportEventsContextValue>(\n\t\t() => ({ emit, subscribe }),\n\t\t[emit, subscribe]\n\t);\n\n\treturn (\n\t\t<SupportEventsContext.Provider value={value}>\n\t\t\t{children}\n\t\t</SupportEventsContext.Provider>\n\t);\n};\n\n/**\n * Access the events context.\n * Returns null if not inside a SupportEventsProvider.\n */\nexport function useSupportEvents(): SupportEventsContextValue | null {\n\treturn React.useContext(SupportEventsContext);\n}\n\n/**\n * Hook to emit events from within the widget.\n * Safe to use outside of provider (will no-op).\n */\nexport function useSupportEventEmitter() {\n\tconst events = useSupportEvents();\n\n\treturn React.useMemo(\n\t\t() => ({\n\t\t\temitConversationStart: (\n\t\t\t\tconversationId: string,\n\t\t\t\tconversation?: Conversation\n\t\t\t) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"conversationStart\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tconversation,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitConversationEnd: (\n\t\t\t\tconversationId: string,\n\t\t\t\tconversation?: Conversation\n\t\t\t) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"conversationEnd\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tconversation,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitMessageSent: (conversationId: string, message: TimelineItem) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"messageSent\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tmessage,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitMessageReceived: (conversationId: string, message: TimelineItem) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"messageReceived\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tmessage,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitError: (error: Error, context?: string) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\terror,\n\t\t\t\t\tcontext,\n\t\t\t\t});\n\t\t\t},\n\t\t}),\n\t\t[events]\n\t);\n}\n"],"mappings":";;;;;;;AAoGA,MAAM,uBACLA,QAAM,cAAgD,KAAK;;;;;;;;;;;;;;AAmB5D,MAAaC,yBAA+D,EAC3E,qBACA,mBACA,eACA,mBACA,SACA,eACK;CAEL,MAAM,eAAeD,QAAM,OAA8B;EACxD;EACA;EACA;EACA;EACA;EACA,CAAC;AAGF,SAAM,gBAAgB;AACrB,eAAa,UAAU;GACtB;GACA;GACA;GACA;GACA;GACA;IACC;EACF;EACA;EACA;EACA;EACA;EACA,CAAC;CAGF,MAAM,iBAAiBA,QAAM,uBAE3B,IAAI,KAAK,CAAC;CAEZ,MAAM,OAAOA,QAAM,aAAqC,UAAa;AAEpE,UAAQ,MAAM,MAAd;GACC,KAAK;AACJ,iBAAa,QAAQ,sBAAsB,MAAM;AACjD;GACD,KAAK;AACJ,iBAAa,QAAQ,oBAAoB,MAAM;AAC/C;GACD,KAAK;AACJ,iBAAa,QAAQ,gBAAgB,MAAM;AAC3C;GACD,KAAK;AACJ,iBAAa,QAAQ,oBAAoB,MAAM;AAC/C;GACD,KAAK;AACJ,iBAAa,QAAQ,UAAU,MAAM;AACrC;GACD,QAEC;;EAIF,MAAM,cAAc,eAAe,QAAQ,IAAI,MAAM,KAAK;AAC1D,MAAI,YACH,MAAK,MAAM,YAAY,YACtB,UAAS,MAAM;IAGf,EAAE,CAAC;CAEN,MAAM,YAAYA,QAAM,aAEtB,MACA,aACI;AACJ,MAAI,CAAC,eAAe,QAAQ,IAAI,KAAK,CACpC,gBAAe,QAAQ,IAAI,sBAAM,IAAI,KAAK,CAAC;EAE5C,MAAM,cAAc,eAAe,QAAQ,IAAI,KAAK;AACpD,eAAa,IAAI,SAA0C;AAG3D,eAAa;AACZ,gBAAa,OAAO,SAA0C;;IAGhE,EAAE,CACF;CAED,MAAM,QAAQA,QAAM,eACZ;EAAE;EAAM;EAAW,GAC1B,CAAC,MAAM,UAAU,CACjB;AAED,QACC,oBAAC,qBAAqB;EAAgB;EACpC;GAC8B;;;;;;AAQlC,SAAgB,mBAAqD;AACpE,QAAOA,QAAM,WAAW,qBAAqB;;;;;;AAO9C,SAAgB,yBAAyB;CACxC,MAAM,SAAS,kBAAkB;AAEjC,QAAOA,QAAM,eACL;EACN,wBACC,gBACA,iBACI;AACJ,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,sBACC,gBACA,iBACI;AACJ,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,kBAAkB,gBAAwB,YAA0B;AACnE,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,sBAAsB,gBAAwB,YAA0B;AACvE,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,YAAY,OAAc,YAAqB;AAC9C,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,GACD,CAAC,OAAO,CACR"}

package/support/context/handle.d.ts

@@ -0,0 +1,90 @@
+import * as React$1 from "react";
+import { RouteRegistry } from "@cossistant/core";
+
+//#region src/support/context/handle.d.ts
+
+/**
+ * Imperative handle for programmatic control of the Support widget.
+ * Access via ref on the Support component or via useSupportHandle hook.
+ *
+ * @example
+ * const supportRef = useRef<SupportHandle>(null);
+ *
+ * // Open the widget
+ * supportRef.current?.open();
+ *
+ * // Navigate to a conversation
+ * supportRef.current?.openConversation("conv_123");
+ *
+ * // Start a new conversation with a message
+ * supportRef.current?.startConversation("I need help with...");
+ *
+ * <Support ref={supportRef} />
+ */
+type SupportHandle = {
+  /**
+   * Open the support widget.
+   */
+  open: () => void;
+  /**
+   * Close the support widget.
+   */
+  close: () => void;
+  /**
+   * Toggle the support widget open/closed.
+   */
+  toggle: () => void;
+  /**
+   * Navigate to a specific page with optional params.
+   */
+  navigate: <K extends keyof RouteRegistry>(options: {
+    page: K;
+    params?: RouteRegistry[K];
+  }) => void;
+  /**
+   * Go back to the previous page.
+   */
+  goBack: () => void;
+  /**
+   * Open a specific conversation.
+   */
+  openConversation: (conversationId: string) => void;
+  /**
+   * Start a new conversation, optionally with an initial message.
+   */
+  startConversation: (initialMessage?: string) => void;
+  /**
+   * Navigate to the home page.
+   */
+  goHome: () => void;
+};
+type SupportHandleProviderProps = {
+  /**
+   * Ref to expose the handle to parent components.
+   */
+  forwardedRef?: React$1.Ref<SupportHandle>;
+  children: React$1.ReactNode;
+};
+/**
+ * Provider that creates and exposes the imperative handle.
+ */
+declare const SupportHandleProvider: React$1.FC<SupportHandleProviderProps>;
+/**
+ * Hook to access the imperative handle from within the widget.
+ * Returns null if not inside Support component.
+ *
+ * @example
+ * function MyComponent() {
+ *   const support = useSupportHandle();
+ *
+ *   return (
+ *     <button onClick={() => support?.startConversation("Hello!")}>
+ *       Get Help
+ *     </button>
+ *   );
+ * }
+ */
+declare function useSupportHandle(): SupportHandle | null;
+//#endregion
+export { SupportHandle, SupportHandleProvider, SupportHandleProviderProps, useSupportHandle };
+//# sourceMappingURL=handle.d.ts.map

package/support/context/handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","names":[],"sources":["../../../src/support/context/handle.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA6BA;;;;;;AA4CA;;;;;AAWA;AA2EA;;;;KAlIY,aAAA;;;;;;;;;;;;;;;;6BAgBgB;UACpB;aACG,cAAc;;;;;;;;;;;;;;;;;;;KA0Bb,0BAAA;;;;iBAII,OAAA,CAAM,IAAI;YACf,OAAA,CAAM;;;;;cAMJ,uBAAuB,OAAA,CAAM,GAAG;;;;;;;;;;;;;;;;iBA2E7B,gBAAA,CAAA,GAAoB"}

package/support/context/handle.js

@@ -0,0 +1,79 @@
+"use client";
+
+
+import { useSupportConfig, useSupportNavigation } from "../store/support-store.js";
+import { PENDING_CONVERSATION_ID } from "../../utils/id.js";
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/handle.tsx
+const SupportHandleContext = React$1.createContext(null);
+/**
+* Provider that creates and exposes the imperative handle.
+*/
+const SupportHandleProvider = ({ forwardedRef, children }) => {
+	const { open, close, toggle } = useSupportConfig();
+	const { navigate, goBack } = useSupportNavigation();
+	const handle = React$1.useMemo(() => ({
+		open,
+		close,
+		toggle,
+		navigate: (options) => {
+			navigate(options);
+		},
+		goBack,
+		openConversation: (conversationId) => {
+			navigate({
+				page: "CONVERSATION",
+				params: { conversationId }
+			});
+			open();
+		},
+		startConversation: (initialMessage) => {
+			navigate({
+				page: "CONVERSATION",
+				params: {
+					conversationId: PENDING_CONVERSATION_ID,
+					initialMessage
+				}
+			});
+			open();
+		},
+		goHome: () => {
+			navigate({ page: "HOME" });
+		}
+	}), [
+		open,
+		close,
+		toggle,
+		navigate,
+		goBack
+	]);
+	React$1.useImperativeHandle(forwardedRef, () => handle, [handle]);
+	return /* @__PURE__ */ jsx(SupportHandleContext.Provider, {
+		value: handle,
+		children
+	});
+};
+/**
+* Hook to access the imperative handle from within the widget.
+* Returns null if not inside Support component.
+*
+* @example
+* function MyComponent() {
+*   const support = useSupportHandle();
+*
+*   return (
+*     <button onClick={() => support?.startConversation("Hello!")}>
+*       Get Help
+*     </button>
+*   );
+* }
+*/
+function useSupportHandle() {
+	return React$1.useContext(SupportHandleContext);
+}
+
+//#endregion
+export { SupportHandleProvider, useSupportHandle };
+//# sourceMappingURL=handle.js.map

package/support/context/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","names":["React","SupportHandleProvider: React.FC<SupportHandleProviderProps>"],"sources":["../../../src/support/context/handle.tsx"],"sourcesContent":["\"use client\";\n\nimport type { RouteRegistry } from \"@cossistant/core\";\nimport * as React from \"react\";\nimport { PENDING_CONVERSATION_ID } from \"../../utils/id\";\nimport { useSupportConfig, useSupportNavigation } from \"../store/support-store\";\n\n// =============================================================================\n// Handle Type\n// =============================================================================\n\n/**\n * Imperative handle for programmatic control of the Support widget.\n * Access via ref on the Support component or via useSupportHandle hook.\n *\n * @example\n * const supportRef = useRef<SupportHandle>(null);\n *\n * // Open the widget\n * supportRef.current?.open();\n *\n * // Navigate to a conversation\n * supportRef.current?.openConversation(\"conv_123\");\n *\n * // Start a new conversation with a message\n * supportRef.current?.startConversation(\"I need help with...\");\n *\n * <Support ref={supportRef} />\n */\nexport type SupportHandle = {\n\t/**\n\t * Open the support widget.\n\t */\n\topen: () => void;\n\t/**\n\t * Close the support widget.\n\t */\n\tclose: () => void;\n\t/**\n\t * Toggle the support widget open/closed.\n\t */\n\ttoggle: () => void;\n\t/**\n\t * Navigate to a specific page with optional params.\n\t */\n\tnavigate: <K extends keyof RouteRegistry>(options: {\n\t\tpage: K;\n\t\tparams?: RouteRegistry[K];\n\t}) => void;\n\t/**\n\t * Go back to the previous page.\n\t */\n\tgoBack: () => void;\n\t/**\n\t * Open a specific conversation.\n\t */\n\topenConversation: (conversationId: string) => void;\n\t/**\n\t * Start a new conversation, optionally with an initial message.\n\t */\n\tstartConversation: (initialMessage?: string) => void;\n\t/**\n\t * Navigate to the home page.\n\t */\n\tgoHome: () => void;\n};\n\n// =============================================================================\n// Context\n// =============================================================================\n\nconst SupportHandleContext = React.createContext<SupportHandle | null>(null);\n\nexport type SupportHandleProviderProps = {\n\t/**\n\t * Ref to expose the handle to parent components.\n\t */\n\tforwardedRef?: React.Ref<SupportHandle>;\n\tchildren: React.ReactNode;\n};\n\n/**\n * Provider that creates and exposes the imperative handle.\n */\nexport const SupportHandleProvider: React.FC<SupportHandleProviderProps> = ({\n\tforwardedRef,\n\tchildren,\n}) => {\n\tconst { open, close, toggle } = useSupportConfig();\n\tconst { navigate, goBack } = useSupportNavigation();\n\n\tconst handle = React.useMemo<SupportHandle>(\n\t\t() => ({\n\t\t\topen,\n\t\t\tclose,\n\t\t\ttoggle,\n\t\t\tnavigate: <K extends keyof RouteRegistry>(options: {\n\t\t\t\tpage: K;\n\t\t\t\tparams?: RouteRegistry[K];\n\t\t\t}) => {\n\t\t\t\t// Use type assertion since we know the navigate function accepts these types\n\t\t\t\tnavigate(options as Parameters<typeof navigate>[0]);\n\t\t\t},\n\t\t\tgoBack,\n\t\t\topenConversation: (conversationId: string) => {\n\t\t\t\tnavigate({\n\t\t\t\t\tpage: \"CONVERSATION\",\n\t\t\t\t\tparams: { conversationId },\n\t\t\t\t});\n\t\t\t\t// Also open the widget if closed\n\t\t\t\topen();\n\t\t\t},\n\t\t\tstartConversation: (initialMessage?: string) => {\n\t\t\t\tnavigate({\n\t\t\t\t\tpage: \"CONVERSATION\",\n\t\t\t\t\tparams: {\n\t\t\t\t\t\tconversationId: PENDING_CONVERSATION_ID,\n\t\t\t\t\t\tinitialMessage,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\t// Also open the widget if closed\n\t\t\t\topen();\n\t\t\t},\n\t\t\tgoHome: () => {\n\t\t\t\tnavigate({ page: \"HOME\" });\n\t\t\t},\n\t\t}),\n\t\t[open, close, toggle, navigate, goBack]\n\t);\n\n\t// Expose handle via ref\n\tReact.useImperativeHandle(forwardedRef, () => handle, [handle]);\n\n\treturn (\n\t\t<SupportHandleContext.Provider value={handle}>\n\t\t\t{children}\n\t\t</SupportHandleContext.Provider>\n\t);\n};\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * Hook to access the imperative handle from within the widget.\n * Returns null if not inside Support component.\n *\n * @example\n * function MyComponent() {\n *   const support = useSupportHandle();\n *\n *   return (\n *     <button onClick={() => support?.startConversation(\"Hello!\")}>\n *       Get Help\n *     </button>\n *   );\n * }\n */\nexport function useSupportHandle(): SupportHandle | null {\n\treturn React.useContext(SupportHandleContext);\n}\n"],"mappings":";;;;;;;;;AAuEA,MAAM,uBAAuBA,QAAM,cAAoC,KAAK;;;;AAa5E,MAAaC,yBAA+D,EAC3E,cACA,eACK;CACL,MAAM,EAAE,MAAM,OAAO,WAAW,kBAAkB;CAClD,MAAM,EAAE,UAAU,WAAW,sBAAsB;CAEnD,MAAM,SAASD,QAAM,eACb;EACN;EACA;EACA;EACA,WAA0C,YAGpC;AAEL,YAAS,QAA0C;;EAEpD;EACA,mBAAmB,mBAA2B;AAC7C,YAAS;IACR,MAAM;IACN,QAAQ,EAAE,gBAAgB;IAC1B,CAAC;AAEF,SAAM;;EAEP,oBAAoB,mBAA4B;AAC/C,YAAS;IACR,MAAM;IACN,QAAQ;KACP,gBAAgB;KAChB;KACA;IACD,CAAC;AAEF,SAAM;;EAEP,cAAc;AACb,YAAS,EAAE,MAAM,QAAQ,CAAC;;EAE3B,GACD;EAAC;EAAM;EAAO;EAAQ;EAAU;EAAO,CACvC;AAGD,SAAM,oBAAoB,oBAAoB,QAAQ,CAAC,OAAO,CAAC;AAE/D,QACC,oBAAC,qBAAqB;EAAS,OAAO;EACpC;GAC8B;;;;;;;;;;;;;;;;;AAuBlC,SAAgB,mBAAyC;AACxD,QAAOA,QAAM,WAAW,qBAAqB"}

package/support/context/positioning.d.ts

@@ -0,0 +1,17 @@
+import * as React$1 from "react";
+
+//#region src/support/context/positioning.d.ts
+type TriggerRefContextValue = {
+  /** The trigger element (state-based for reactivity) */
+  triggerElement: HTMLElement | null;
+  /** Set the trigger element - triggers re-render when called */
+  setTriggerElement: (element: HTMLElement | null) => void;
+};
+type TriggerRefProviderProps = {
+  children: React$1.ReactNode;
+};
+declare const TriggerRefProvider: React$1.FC<TriggerRefProviderProps>;
+declare function useTriggerRef(): TriggerRefContextValue | null;
+//#endregion
+export { TriggerRefContextValue, TriggerRefProvider, TriggerRefProviderProps, useTriggerRef };
+//# sourceMappingURL=positioning.d.ts.map

package/support/context/positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.d.ts","names":[],"sources":["../../../src/support/context/positioning.tsx"],"sourcesContent":[],"mappings":";;;KAQY,sBAAA;;EAAA,cAAA,EAEK,WAFiB,GAAA,IAAA;EAmBtB;EAIC,iBAAA,EAAA,CAAA,OAqBZ,EAxC6B,WAmBY,GAAA,IAAA,EAAA,GAAA,IAAA;AA2B1C,CAAA;KA/BY,uBAAA;YACD,OAAA,CAAM;;cAGJ,oBAAoB,OAAA,CAAM,GAAG;iBA2B1B,aAAA,CAAA,GAAiB"}

package/support/context/positioning.js

@@ -0,0 +1,26 @@
+"use client";
+
+
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/positioning.tsx
+const TriggerRefContext = React$1.createContext(null);
+const TriggerRefProvider = ({ children }) => {
+	const [triggerElement, setTriggerElement] = React$1.useState(null);
+	const value = React$1.useMemo(() => ({
+		triggerElement,
+		setTriggerElement
+	}), [triggerElement]);
+	return /* @__PURE__ */ jsx(TriggerRefContext.Provider, {
+		value,
+		children
+	});
+};
+function useTriggerRef() {
+	return React$1.useContext(TriggerRefContext);
+}
+
+//#endregion
+export { TriggerRefProvider, useTriggerRef };
+//# sourceMappingURL=positioning.js.map

package/support/context/positioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.js","names":["React","TriggerRefProvider: React.FC<TriggerRefProviderProps>"],"sources":["../../../src/support/context/positioning.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type TriggerRefContextValue = {\n\t/** The trigger element (state-based for reactivity) */\n\ttriggerElement: HTMLElement | null;\n\t/** Set the trigger element - triggers re-render when called */\n\tsetTriggerElement: (element: HTMLElement | null) => void;\n};\n\n// =============================================================================\n// Context\n// =============================================================================\n\nconst TriggerRefContext = React.createContext<TriggerRefContextValue | null>(\n\tnull\n);\n\n// =============================================================================\n// Provider\n// =============================================================================\n\nexport type TriggerRefProviderProps = {\n\tchildren: React.ReactNode;\n};\n\nexport const TriggerRefProvider: React.FC<TriggerRefProviderProps> = ({\n\tchildren,\n}) => {\n\t// Using state instead of ref to trigger re-renders when trigger mounts\n\t// This ensures Floating UI receives the reference element\n\tconst [triggerElement, setTriggerElement] =\n\t\tReact.useState<HTMLElement | null>(null);\n\n\tconst value = React.useMemo<TriggerRefContextValue>(\n\t\t() => ({\n\t\t\ttriggerElement,\n\t\t\tsetTriggerElement,\n\t\t}),\n\t\t[triggerElement]\n\t);\n\n\treturn (\n\t\t<TriggerRefContext.Provider value={value}>\n\t\t\t{children}\n\t\t</TriggerRefContext.Provider>\n\t);\n};\n\n// =============================================================================\n// Hook\n// =============================================================================\n\nexport function useTriggerRef(): TriggerRefContextValue | null {\n\treturn React.useContext(TriggerRefContext);\n}\n"],"mappings":";;;;;;;AAmBA,MAAM,oBAAoBA,QAAM,cAC/B,KACA;AAUD,MAAaC,sBAAyD,EACrE,eACK;CAGL,MAAM,CAAC,gBAAgB,qBACtBD,QAAM,SAA6B,KAAK;CAEzC,MAAM,QAAQA,QAAM,eACZ;EACN;EACA;EACA,GACD,CAAC,eAAe,CAChB;AAED,QACC,oBAAC,kBAAkB;EAAgB;EACjC;GAC2B;;AAQ/B,SAAgB,gBAA+C;AAC9D,QAAOA,QAAM,WAAW,kBAAkB"}

package/support/context/slots.d.ts

@@ -0,0 +1,85 @@
+import * as React$1 from "react";
+
+//#region src/support/context/slots.d.ts
+type SlotContextValue = {
+  /**
+   * Custom header slot content
+   */
+  header: React$1.ReactNode | null;
+  /**
+   * Custom footer slot content
+   */
+  footer: React$1.ReactNode | null;
+  /**
+   * Whether to use the custom header
+   */
+  hasCustomHeader: boolean;
+  /**
+   * Whether to use the custom footer
+   */
+  hasCustomFooter: boolean;
+};
+type SlotProviderProps = {
+  children: React$1.ReactNode;
+};
+/**
+ * Provider for slot-based customization.
+ * Allows children to register custom header/footer content.
+ */
+declare const SlotProvider: React$1.FC<SlotProviderProps>;
+/**
+ * Access slot values (for content component)
+ */
+declare function useSlots(): SlotContextValue;
+type SlotProps = {
+  /**
+   * Content to render in the slot.
+   */
+  children: React$1.ReactNode;
+  /**
+   * When true, renders children directly without a wrapper.
+   * Useful when you want your component to receive all props.
+   */
+  asChild?: boolean;
+};
+/**
+ * Header slot component.
+ * Use inside Support.Content to replace the default header.
+ *
+ * @example
+ * <Support.Content>
+ *   <Support.Header>
+ *     <MyCustomHeader />
+ *   </Support.Header>
+ *   <Support.Router />
+ * </Support.Content>
+ *
+ * @example
+ * // With asChild pattern
+ * <Support.Header asChild>
+ *   <MyCustomHeader showBackButton />
+ * </Support.Header>
+ */
+declare const HeaderSlot: React$1.FC<SlotProps>;
+/**
+ * Footer slot component.
+ * Use inside Support.Content to replace the default footer.
+ *
+ * @example
+ * <Support.Content>
+ *   <Support.Router />
+ *   <Support.Footer>
+ *     <MyCustomFooter />
+ *   </Support.Footer>
+ * </Support.Content>
+ *
+ * @example
+ * // With asChild pattern
+ * <Support.Footer asChild>
+ *   <MyCustomFooter showBranding={false} />
+ * </Support.Footer>
+ */
+declare const FooterSlot: React$1.FC<SlotProps>;
+//#endregion
+export { FooterSlot, HeaderSlot, SlotContextValue, SlotProps, SlotProvider, SlotProviderProps, useSlots };
+//# sourceMappingURL=slots.d.ts.map

package/support/context/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","names":[],"sources":["../../../src/support/context/slots.tsx"],"sourcesContent":[],"mappings":";;;KAQY,gBAAA;;AAAZ;AAyCA;EAQa,MAAA,EA7CJ,OAAA,CAAM,SA0Ed,GAAA,IA7BmC;EAsCpB;AAehB;AA8BA;EAoCa,MAAA,EAhKJ,OAAA,CAAM,SA6Kd,GAbiC,IAAA;;;;;;;;;;KA/HtB,iBAAA;YACD,OAAA,CAAM;;;;;;cAOJ,cAAc,OAAA,CAAM,GAAG;;;;iBAsCpB,QAAA,CAAA,GAAY;KAehB,SAAA;;;;YAID,OAAA,CAAM;;;;;;;;;;;;;;;;;;;;;;;;;cA0BJ,YAAY,OAAA,CAAM,GAAG;;;;;;;;;;;;;;;;;;;cAoCrB,YAAY,OAAA,CAAM,GAAG"}

package/support/context/slots.js

@@ -0,0 +1,115 @@
+"use client";
+
+
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/slots.tsx
+const SlotContext = React$1.createContext({
+	header: null,
+	footer: null,
+	hasCustomHeader: false,
+	hasCustomFooter: false
+});
+const SlotRegistrationContext = React$1.createContext(null);
+/**
+* Provider for slot-based customization.
+* Allows children to register custom header/footer content.
+*/
+const SlotProvider = ({ children }) => {
+	const [header, setHeader] = React$1.useState(null);
+	const [footer, setFooter] = React$1.useState(null);
+	const registration = React$1.useMemo(() => ({
+		registerHeader: (content) => setHeader(content),
+		registerFooter: (content) => setFooter(content),
+		unregisterHeader: () => setHeader(null),
+		unregisterFooter: () => setFooter(null)
+	}), []);
+	const value = React$1.useMemo(() => ({
+		header,
+		footer,
+		hasCustomHeader: header !== null,
+		hasCustomFooter: footer !== null
+	}), [header, footer]);
+	return /* @__PURE__ */ jsx(SlotRegistrationContext.Provider, {
+		value: registration,
+		children: /* @__PURE__ */ jsx(SlotContext.Provider, {
+			value,
+			children
+		})
+	});
+};
+/**
+* Access slot values (for content component)
+*/
+function useSlots() {
+	return React$1.useContext(SlotContext);
+}
+/**
+* Access slot registration (for slot components)
+*/
+function useSlotRegistration() {
+	return React$1.useContext(SlotRegistrationContext);
+}
+/**
+* Header slot component.
+* Use inside Support.Content to replace the default header.
+*
+* @example
+* <Support.Content>
+*   <Support.Header>
+*     <MyCustomHeader />
+*   </Support.Header>
+*   <Support.Router />
+* </Support.Content>
+*
+* @example
+* // With asChild pattern
+* <Support.Header asChild>
+*   <MyCustomHeader showBackButton />
+* </Support.Header>
+*/
+const HeaderSlot = ({ children, asChild }) => {
+	const registration = useSlotRegistration();
+	React$1.useEffect(() => {
+		if (registration) {
+			registration.registerHeader(children);
+			return () => registration.unregisterHeader();
+		}
+	}, [registration, children]);
+	return null;
+};
+HeaderSlot.displayName = "Support.Header";
+/**
+* Footer slot component.
+* Use inside Support.Content to replace the default footer.
+*
+* @example
+* <Support.Content>
+*   <Support.Router />
+*   <Support.Footer>
+*     <MyCustomFooter />
+*   </Support.Footer>
+* </Support.Content>
+*
+* @example
+* // With asChild pattern
+* <Support.Footer asChild>
+*   <MyCustomFooter showBranding={false} />
+* </Support.Footer>
+*/
+const FooterSlot = ({ children, asChild }) => {
+	const registration = useSlotRegistration();
+	React$1.useEffect(() => {
+		if (registration) {
+			registration.registerFooter(children);
+			return () => registration.unregisterFooter();
+		}
+	}, [registration, children]);
+	return null;
+};
+FooterSlot.displayName = "Support.Footer";
+
+//#endregion
+export { FooterSlot, HeaderSlot, SlotProvider, useSlots };
+//# sourceMappingURL=slots.js.map

package/support/context/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","names":["React","SlotProvider: React.FC<SlotProviderProps>","HeaderSlot: React.FC<SlotProps>","FooterSlot: React.FC<SlotProps>"],"sources":["../../../src/support/context/slots.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\n\n// =============================================================================\n// Slot Types\n// =============================================================================\n\nexport type SlotContextValue = {\n\t/**\n\t * Custom header slot content\n\t */\n\theader: React.ReactNode | null;\n\t/**\n\t * Custom footer slot content\n\t */\n\tfooter: React.ReactNode | null;\n\t/**\n\t * Whether to use the custom header\n\t */\n\thasCustomHeader: boolean;\n\t/**\n\t * Whether to use the custom footer\n\t */\n\thasCustomFooter: boolean;\n};\n\ntype SlotRegistration = {\n\tregisterHeader: (content: React.ReactNode) => void;\n\tregisterFooter: (content: React.ReactNode) => void;\n\tunregisterHeader: () => void;\n\tunregisterFooter: () => void;\n};\n\nconst SlotContext = React.createContext<SlotContextValue>({\n\theader: null,\n\tfooter: null,\n\thasCustomHeader: false,\n\thasCustomFooter: false,\n});\n\nconst SlotRegistrationContext = React.createContext<SlotRegistration | null>(\n\tnull\n);\n\n// =============================================================================\n// Provider\n// =============================================================================\n\nexport type SlotProviderProps = {\n\tchildren: React.ReactNode;\n};\n\n/**\n * Provider for slot-based customization.\n * Allows children to register custom header/footer content.\n */\nexport const SlotProvider: React.FC<SlotProviderProps> = ({ children }) => {\n\tconst [header, setHeader] = React.useState<React.ReactNode | null>(null);\n\tconst [footer, setFooter] = React.useState<React.ReactNode | null>(null);\n\n\tconst registration = React.useMemo<SlotRegistration>(\n\t\t() => ({\n\t\t\tregisterHeader: (content) => setHeader(content),\n\t\t\tregisterFooter: (content) => setFooter(content),\n\t\t\tunregisterHeader: () => setHeader(null),\n\t\t\tunregisterFooter: () => setFooter(null),\n\t\t}),\n\t\t[]\n\t);\n\n\tconst value = React.useMemo<SlotContextValue>(\n\t\t() => ({\n\t\t\theader,\n\t\t\tfooter,\n\t\t\thasCustomHeader: header !== null,\n\t\t\thasCustomFooter: footer !== null,\n\t\t}),\n\t\t[header, footer]\n\t);\n\n\treturn (\n\t\t<SlotRegistrationContext.Provider value={registration}>\n\t\t\t<SlotContext.Provider value={value}>{children}</SlotContext.Provider>\n\t\t</SlotRegistrationContext.Provider>\n\t);\n};\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\n/**\n * Access slot values (for content component)\n */\nexport function useSlots(): SlotContextValue {\n\treturn React.useContext(SlotContext);\n}\n\n/**\n * Access slot registration (for slot components)\n */\nfunction useSlotRegistration(): SlotRegistration | null {\n\treturn React.useContext(SlotRegistrationContext);\n}\n\n// =============================================================================\n// Slot Components\n// =============================================================================\n\nexport type SlotProps = {\n\t/**\n\t * Content to render in the slot.\n\t */\n\tchildren: React.ReactNode;\n\t/**\n\t * When true, renders children directly without a wrapper.\n\t * Useful when you want your component to receive all props.\n\t */\n\tasChild?: boolean;\n};\n\n/**\n * Header slot component.\n * Use inside Support.Content to replace the default header.\n *\n * @example\n * <Support.Content>\n *   <Support.Header>\n *     <MyCustomHeader />\n *   </Support.Header>\n *   <Support.Router />\n * </Support.Content>\n *\n * @example\n * // With asChild pattern\n * <Support.Header asChild>\n *   <MyCustomHeader showBackButton />\n * </Support.Header>\n */\nexport const HeaderSlot: React.FC<SlotProps> = ({ children, asChild }) => {\n\tconst registration = useSlotRegistration();\n\n\tReact.useEffect(() => {\n\t\tif (registration) {\n\t\t\tregistration.registerHeader(children);\n\t\t\treturn () => registration.unregisterHeader();\n\t\t}\n\t}, [registration, children]);\n\n\t// This component doesn't render anything directly\n\t// It registers its children as the header slot\n\treturn null;\n};\n\n(HeaderSlot as React.FC & { displayName?: string }).displayName =\n\t\"Support.Header\";\n\n/**\n * Footer slot component.\n * Use inside Support.Content to replace the default footer.\n *\n * @example\n * <Support.Content>\n *   <Support.Router />\n *   <Support.Footer>\n *     <MyCustomFooter />\n *   </Support.Footer>\n * </Support.Content>\n *\n * @example\n * // With asChild pattern\n * <Support.Footer asChild>\n *   <MyCustomFooter showBranding={false} />\n * </Support.Footer>\n */\nexport const FooterSlot: React.FC<SlotProps> = ({ children, asChild }) => {\n\tconst registration = useSlotRegistration();\n\n\tReact.useEffect(() => {\n\t\tif (registration) {\n\t\t\tregistration.registerFooter(children);\n\t\t\treturn () => registration.unregisterFooter();\n\t\t}\n\t}, [registration, children]);\n\n\t// This component doesn't render anything directly\n\t// It registers its children as the footer slot\n\treturn null;\n};\n\n(FooterSlot as React.FC & { displayName?: string }).displayName =\n\t\"Support.Footer\";\n"],"mappings":";;;;;;;AAkCA,MAAM,cAAcA,QAAM,cAAgC;CACzD,QAAQ;CACR,QAAQ;CACR,iBAAiB;CACjB,iBAAiB;CACjB,CAAC;AAEF,MAAM,0BAA0BA,QAAM,cACrC,KACA;;;;;AAcD,MAAaC,gBAA6C,EAAE,eAAe;CAC1E,MAAM,CAAC,QAAQ,aAAaD,QAAM,SAAiC,KAAK;CACxE,MAAM,CAAC,QAAQ,aAAaA,QAAM,SAAiC,KAAK;CAExE,MAAM,eAAeA,QAAM,eACnB;EACN,iBAAiB,YAAY,UAAU,QAAQ;EAC/C,iBAAiB,YAAY,UAAU,QAAQ;EAC/C,wBAAwB,UAAU,KAAK;EACvC,wBAAwB,UAAU,KAAK;EACvC,GACD,EAAE,CACF;CAED,MAAM,QAAQA,QAAM,eACZ;EACN;EACA;EACA,iBAAiB,WAAW;EAC5B,iBAAiB,WAAW;EAC5B,GACD,CAAC,QAAQ,OAAO,CAChB;AAED,QACC,oBAAC,wBAAwB;EAAS,OAAO;YACxC,oBAAC,YAAY;GAAgB;GAAQ;IAAgC;GACnC;;;;;AAWrC,SAAgB,WAA6B;AAC5C,QAAOA,QAAM,WAAW,YAAY;;;;;AAMrC,SAAS,sBAA+C;AACvD,QAAOA,QAAM,WAAW,wBAAwB;;;;;;;;;;;;;;;;;;;;AAqCjD,MAAaE,cAAmC,EAAE,UAAU,cAAc;CACzE,MAAM,eAAe,qBAAqB;AAE1C,SAAM,gBAAgB;AACrB,MAAI,cAAc;AACjB,gBAAa,eAAe,SAAS;AACrC,gBAAa,aAAa,kBAAkB;;IAE3C,CAAC,cAAc,SAAS,CAAC;AAI5B,QAAO;;AAGR,AAAC,WAAmD,cACnD;;;;;;;;;;;;;;;;;;;AAoBD,MAAaC,cAAmC,EAAE,UAAU,cAAc;CACzE,MAAM,eAAe,qBAAqB;AAE1C,SAAM,gBAAgB;AACrB,MAAI,cAAc;AACjB,gBAAa,eAAe,SAAS;AACrC,gBAAa,aAAa,kBAAkB;;IAE3C,CAAC,cAAc,SAAS,CAAC;AAI5B,QAAO;;AAGR,AAAC,WAAmD,cACnD"}

package/support/context/websocket.d.ts

@@ -23,8 +23,15 @@ type WebSocketProviderProps = {
 declare const WebSocketProvider: React.FC<WebSocketProviderProps>;
 /**
  * Accessor for the support websocket context.
+ * Throws if used outside WebSocketProvider.
  */
 declare const useWebSocket: () => WebSocketContextValue;
+/**
+ * Safe accessor for the support websocket context.
+ * Returns null if used outside WebSocketProvider instead of throwing.
+ * Useful for optional WebSocket usage in hooks that may or may not have the provider.
+ */
+declare const useWebSocketSafe: () => WebSocketContextValue | null;
 //#endregion
-export { type RealtimeEvent, type WebSocketContextValue, WebSocketProvider, type WebSocketProviderProps, useWebSocket };
+export { type RealtimeEvent, type WebSocketContextValue, WebSocketProvider, type WebSocketProviderProps, useWebSocket, useWebSocketSafe };
 //# sourceMappingURL=websocket.d.ts.map

package/support/context/websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","names":[],"sources":["../../../src/support/context/websocket.tsx"],"sourcesContent":[],"mappings":";;;;;;KAYK,qBAAA,GAAwB;KAExB,sBAAA;YACM,KAAA,CAAM;;EAHZ,SAAA,CAAA,EAAA,MAAA;EAEA,SAAA,CAAA,EAAA,MAAA;EAsJQ,KAAA,CAAA,EAAA,MAAA;EA8BA,WAAA,CAAA,EAAA,OAMZ;;;oBAjLkB;;;;;;cA6IN,mBAAmB,KAAA,CAAM,GAAG;;;;cA8B5B,oBAAmB"}
+{"version":3,"file":"websocket.d.ts","names":[],"sources":["../../../src/support/context/websocket.tsx"],"sourcesContent":[],"mappings":";;;;;;KAYK,qBAAA,GAAwB;KAExB,sBAAA;YACM,KAAA,CAAM;;EAHZ,SAAA,CAAA,EAAA,MAAA;EAEA,SAAA,CAAA,EAAA,MAAA;EAsJQ,KAAA,CAAA,EAAA,MAAA;EA+BA,WAAA,CAAA,EAAA,OAMZ;EAOY,SAAA,CAAA,EAAA,GAAA,GAAA,IACgB;;oBA1LV;;;;;;cA6IN,mBAAmB,KAAA,CAAM,GAAG;;;;;cA+B5B,oBAAmB;;;;;;cAanB,wBAAuB"}

package/support/context/websocket.js

@@ -107,13 +107,20 @@ const WebSocketProvider = ({ children, publicKey, websiteId, visitorId, wsUrl, a
 };
 /**
 * Accessor for the support websocket context.
+* Throws if used outside WebSocketProvider.
 */
 const useWebSocket = () => {
 	const context = useContext(WebSocketContext);
 	if (!context) throw new Error("useWebSocket must be used within WebSocketProvider");
 	return context;
 };
+/**
+* Safe accessor for the support websocket context.
+* Returns null if used outside WebSocketProvider instead of throwing.
+* Useful for optional WebSocket usage in hooks that may or may not have the provider.
+*/
+const useWebSocketSafe = () => useContext(WebSocketContext);
 
 //#endregion
-export { WebSocketProvider, useWebSocket };
+export { WebSocketProvider, useWebSocket, useWebSocketSafe };
 //# sourceMappingURL=websocket.js.map