@cossistant/react 0.0.1

package/hooks/use-message-composer.d.ts

@@ -0,0 +1,88 @@
+import { TimelineItem } from "../timeline-item.js";
+import { UseMultimodalInputOptions } from "./private/use-multimodal-input.js";
+import { CossistantClient } from "@cossistant/core";
+
+//#region src/hooks/use-message-composer.d.ts
+type UseMessageComposerOptions = {
+  /**
+   * The Cossistant client instance.
+   */
+  client: CossistantClient;
+  /**
+   * Current conversation ID. Can be null if no real conversation exists yet.
+   * Pass null when showing default timeline items before user sends first message.
+   */
+  conversationId: string | null;
+  /**
+   * Default timeline items to include when creating a new conversation.
+   */
+  defaultTimelineItems?: TimelineItem[];
+  /**
+   * Visitor ID to associate with messages.
+   */
+  visitorId?: string;
+  /**
+   * Callback when a message is successfully sent.
+   * @param conversationId - The conversation ID (may be newly created)
+   * @param messageId - The sent message ID
+   */
+  onMessageSent?: (conversationId: string, messageId: string) => void;
+  /**
+   * Callback when message sending fails.
+   */
+  onError?: (error: Error) => void;
+  /**
+   * File upload options (max size, allowed types, etc.)
+   */
+  fileOptions?: Pick<UseMultimodalInputOptions, "maxFileSize" | "maxFiles" | "allowedFileTypes">;
+};
+type UseMessageComposerReturn = {
+  message: string;
+  files: File[];
+  error: Error | null;
+  isSubmitting: boolean;
+  canSubmit: boolean;
+  setMessage: (message: string) => void;
+  addFiles: (files: File[]) => void;
+  removeFile: (index: number) => void;
+  clearFiles: () => void;
+  submit: () => void;
+  reset: () => void;
+};
+/**
+ * Combines message input, typing indicators, and message sending into
+ * a single, cohesive hook for building message composers.
+ *
+ * This hook:
+ * - Manages text input and file attachments via useMultimodalInput
+ * - Sends typing indicators while user is composing
+ * - Handles message submission with proper error handling
+ * - Automatically resets input after successful send
+ * - Works with both pending and real conversations
+ *
+ * @example
+ * ```tsx
+ * const composer = useMessageComposer({
+ *   client,
+ *   conversationId: realConversationId, // null if pending
+ *   defaultMessages,
+ *   visitorId: visitor?.id,
+ *   onMessageSent: (convId) => {
+ *     // Update conversation ID if it was created
+ *   },
+ * });
+ *
+ * return (
+ *   <MessageInput
+ *     value={composer.message}
+ *     onChange={composer.setMessage}
+ *     onSubmit={composer.submit}
+ *     disabled={composer.isSubmitting}
+ *   />
+ * );
+ * ```
+ */
+declare function useMessageComposer(options: UseMessageComposerOptions): UseMessageComposerReturn;
+//#endregion
+export { UseMessageComposerOptions, UseMessageComposerReturn, useMessageComposer };
+//# sourceMappingURL=use-message-composer.d.ts.map

package/hooks/use-message-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-message-composer.d.ts","names":[],"sources":["../../src/hooks/use-message-composer.ts"],"sourcesContent":[],"mappings":";;;;;KAUY,yBAAA;;AAAZ;;QAIS,EAAA,gBAAA;;;;;EAiCU,cAAA,EAAA,MAAA,GAAA,IAAA;EAMP;;;sBAIJ,CAAA,EAhCgB,YAgChB,EAAA;;;AAgDR;EAAkC,SAAA,CAAA,EAAA,MAAA;;;;;;;;;;oBA/Df;;;;gBAKJ,KACb;;KAKU,wBAAA;;SAGJ;SACA;;;;oBAQW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwCH,kBAAA,UACN,4BACP"}

package/hooks/use-message-composer.js

@@ -0,0 +1,94 @@
+import { useMultimodalInput } from "./private/use-multimodal-input.js";
+import { useVisitorTypingReporter } from "./private/use-visitor-typing-reporter.js";
+import { useSendMessage } from "./use-send-message.js";
+import { useCallback, useEffect } from "react";
+
+//#region src/hooks/use-message-composer.ts
+/**
+* Combines message input, typing indicators, and message sending into
+* a single, cohesive hook for building message composers.
+*
+* This hook:
+* - Manages text input and file attachments via useMultimodalInput
+* - Sends typing indicators while user is composing
+* - Handles message submission with proper error handling
+* - Automatically resets input after successful send
+* - Works with both pending and real conversations
+*
+* @example
+* ```tsx
+* const composer = useMessageComposer({
+*   client,
+*   conversationId: realConversationId, // null if pending
+*   defaultMessages,
+*   visitorId: visitor?.id,
+*   onMessageSent: (convId) => {
+*     // Update conversation ID if it was created
+*   },
+* });
+*
+* return (
+*   <MessageInput
+*     value={composer.message}
+*     onChange={composer.setMessage}
+*     onSubmit={composer.submit}
+*     disabled={composer.isSubmitting}
+*   />
+* );
+* ```
+*/
+function useMessageComposer(options) {
+	const { client, conversationId, defaultTimelineItems = [], visitorId, onMessageSent, onError, fileOptions } = options;
+	const sendMessage = useSendMessage({ client });
+	const { handleInputChange: reportTyping, handleSubmit: stopTyping, stop: forceStopTyping } = useVisitorTypingReporter({
+		client,
+		conversationId
+	});
+	const multimodalInput = useMultimodalInput({
+		onSubmit: async ({ message: messageText, files }) => {
+			stopTyping();
+			sendMessage.mutate({
+				conversationId,
+				message: messageText,
+				files,
+				defaultTimelineItems,
+				visitorId,
+				onSuccess: (resultConversationId, messageId) => {
+					onMessageSent?.(resultConversationId, messageId);
+				},
+				onError: (err) => {
+					onError?.(err);
+				}
+			});
+		},
+		onError,
+		...fileOptions
+	});
+	useEffect(() => () => {
+		forceStopTyping();
+	}, [forceStopTyping]);
+	const setMessage = useCallback((value) => {
+		multimodalInput.setMessage(value);
+		reportTyping(value);
+	}, [multimodalInput, reportTyping]);
+	const isSubmitting = multimodalInput.isSubmitting || sendMessage.isPending;
+	const error = multimodalInput.error || sendMessage.error;
+	const canSubmit = multimodalInput.canSubmit && !sendMessage.isPending;
+	return {
+		message: multimodalInput.message,
+		files: multimodalInput.files,
+		error,
+		isSubmitting,
+		canSubmit,
+		setMessage,
+		addFiles: multimodalInput.addFiles,
+		removeFile: multimodalInput.removeFile,
+		clearFiles: multimodalInput.clearFiles,
+		submit: multimodalInput.submit,
+		reset: multimodalInput.reset
+	};
+}
+
+//#endregion
+export { useMessageComposer };
+//# sourceMappingURL=use-message-composer.js.map

package/hooks/use-message-composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-message-composer.js","names":[],"sources":["../../src/hooks/use-message-composer.ts"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport { useCallback, useEffect } from \"react\";\nimport {\n\ttype UseMultimodalInputOptions,\n\tuseMultimodalInput,\n} from \"./private/use-multimodal-input\";\nimport { useVisitorTypingReporter } from \"./private/use-visitor-typing-reporter\";\nimport { useSendMessage } from \"./use-send-message\";\n\nexport type UseMessageComposerOptions = {\n\t/**\n\t * The Cossistant client instance.\n\t */\n\tclient: CossistantClient;\n\n\t/**\n\t * Current conversation ID. Can be null if no real conversation exists yet.\n\t * Pass null when showing default timeline items before user sends first message.\n\t */\n\tconversationId: string | null;\n\n\t/**\n\t * Default timeline items to include when creating a new conversation.\n\t */\n\tdefaultTimelineItems?: TimelineItem[];\n\n\t/**\n\t * Visitor ID to associate with messages.\n\t */\n\tvisitorId?: string;\n\n\t/**\n\t * Callback when a message is successfully sent.\n\t * @param conversationId - The conversation ID (may be newly created)\n\t * @param messageId - The sent message ID\n\t */\n\tonMessageSent?: (conversationId: string, messageId: string) => void;\n\n\t/**\n\t * Callback when message sending fails.\n\t */\n\tonError?: (error: Error) => void;\n\n\t/**\n\t * File upload options (max size, allowed types, etc.)\n\t */\n\tfileOptions?: Pick<\n\t\tUseMultimodalInputOptions,\n\t\t\"maxFileSize\" | \"maxFiles\" | \"allowedFileTypes\"\n\t>;\n};\n\nexport type UseMessageComposerReturn = {\n\t// Input state\n\tmessage: string;\n\tfiles: File[];\n\terror: Error | null;\n\n\t// Status\n\tisSubmitting: boolean;\n\tcanSubmit: boolean;\n\n\t// Actions\n\tsetMessage: (message: string) => void;\n\taddFiles: (files: File[]) => void;\n\tremoveFile: (index: number) => void;\n\tclearFiles: () => void;\n\tsubmit: () => void;\n\treset: () => void;\n};\n\n/**\n * Combines message input, typing indicators, and message sending into\n * a single, cohesive hook for building message composers.\n *\n * This hook:\n * - Manages text input and file attachments via useMultimodalInput\n * - Sends typing indicators while user is composing\n * - Handles message submission with proper error handling\n * - Automatically resets input after successful send\n * - Works with both pending and real conversations\n *\n * @example\n * ```tsx\n * const composer = useMessageComposer({\n *   client,\n *   conversationId: realConversationId, // null if pending\n *   defaultMessages,\n *   visitorId: visitor?.id,\n *   onMessageSent: (convId) => {\n *     // Update conversation ID if it was created\n *   },\n * });\n *\n * return (\n *   <MessageInput\n *     value={composer.message}\n *     onChange={composer.setMessage}\n *     onSubmit={composer.submit}\n *     disabled={composer.isSubmitting}\n *   />\n * );\n * ```\n */\nexport function useMessageComposer(\n\toptions: UseMessageComposerOptions\n): UseMessageComposerReturn {\n\tconst {\n\t\tclient,\n\t\tconversationId,\n\t\tdefaultTimelineItems = [],\n\t\tvisitorId,\n\t\tonMessageSent,\n\t\tonError,\n\t\tfileOptions,\n\t} = options;\n\n\tconst sendMessage = useSendMessage({ client });\n\n\tconst {\n\t\thandleInputChange: reportTyping,\n\t\thandleSubmit: stopTyping,\n\t\tstop: forceStopTyping,\n\t} = useVisitorTypingReporter({\n\t\tclient,\n\t\tconversationId,\n\t});\n\n\tconst multimodalInput = useMultimodalInput({\n\t\tonSubmit: async ({ message: messageText, files }) => {\n\t\t\t// Stop typing indicator\n\t\t\tstopTyping();\n\n\t\t\t// Send the message\n\t\t\tsendMessage.mutate({\n\t\t\t\tconversationId,\n\t\t\t\tmessage: messageText,\n\t\t\t\tfiles,\n\t\t\t\tdefaultTimelineItems,\n\t\t\t\tvisitorId,\n\t\t\t\tonSuccess: (resultConversationId, messageId) => {\n\t\t\t\t\tonMessageSent?.(resultConversationId, messageId);\n\t\t\t\t},\n\t\t\t\tonError: (err) => {\n\t\t\t\t\tonError?.(err);\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t\tonError,\n\t\t...fileOptions,\n\t});\n\n\t// Clean up typing indicator on unmount\n\tuseEffect(\n\t\t() => () => {\n\t\t\tforceStopTyping();\n\t\t},\n\t\t[forceStopTyping]\n\t);\n\n\t// Wrap setMessage to also report typing\n\tconst setMessage = useCallback(\n\t\t(value: string) => {\n\t\t\tmultimodalInput.setMessage(value);\n\t\t\treportTyping(value);\n\t\t},\n\t\t[multimodalInput, reportTyping]\n\t);\n\n\t// Combine submission states\n\tconst isSubmitting = multimodalInput.isSubmitting || sendMessage.isPending;\n\tconst error = multimodalInput.error || sendMessage.error;\n\tconst canSubmit = multimodalInput.canSubmit && !sendMessage.isPending;\n\n\treturn {\n\t\tmessage: multimodalInput.message,\n\t\tfiles: multimodalInput.files,\n\t\terror,\n\t\tisSubmitting,\n\t\tcanSubmit,\n\t\tsetMessage,\n\t\taddFiles: multimodalInput.addFiles,\n\t\tremoveFile: multimodalInput.removeFile,\n\t\tclearFiles: multimodalInput.clearFiles,\n\t\tsubmit: multimodalInput.submit,\n\t\treset: multimodalInput.reset,\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGA,SAAgB,mBACf,SAC2B;CAC3B,MAAM,EACL,QACA,gBACA,uBAAuB,EAAE,EACzB,WACA,eACA,SACA,gBACG;CAEJ,MAAM,cAAc,eAAe,EAAE,QAAQ,CAAC;CAE9C,MAAM,EACL,mBAAmB,cACnB,cAAc,YACd,MAAM,oBACH,yBAAyB;EAC5B;EACA;EACA,CAAC;CAEF,MAAM,kBAAkB,mBAAmB;EAC1C,UAAU,OAAO,EAAE,SAAS,aAAa,YAAY;AAEpD,eAAY;AAGZ,eAAY,OAAO;IAClB;IACA,SAAS;IACT;IACA;IACA;IACA,YAAY,sBAAsB,cAAc;AAC/C,qBAAgB,sBAAsB,UAAU;;IAEjD,UAAU,QAAQ;AACjB,eAAU,IAAI;;IAEf,CAAC;;EAEH;EACA,GAAG;EACH,CAAC;AAGF,uBACa;AACX,mBAAiB;IAElB,CAAC,gBAAgB,CACjB;CAGD,MAAM,aAAa,aACjB,UAAkB;AAClB,kBAAgB,WAAW,MAAM;AACjC,eAAa,MAAM;IAEpB,CAAC,iBAAiB,aAAa,CAC/B;CAGD,MAAM,eAAe,gBAAgB,gBAAgB,YAAY;CACjE,MAAM,QAAQ,gBAAgB,SAAS,YAAY;CACnD,MAAM,YAAY,gBAAgB,aAAa,CAAC,YAAY;AAE5D,QAAO;EACN,SAAS,gBAAgB;EACzB,OAAO,gBAAgB;EACvB;EACA;EACA;EACA;EACA,UAAU,gBAAgB;EAC1B,YAAY,gBAAgB;EAC5B,YAAY,gBAAgB;EAC5B,QAAQ,gBAAgB;EACxB,OAAO,gBAAgB;EACvB"}

package/hooks/use-realtime-support.d.ts

@@ -0,0 +1,25 @@
+import { AnyRealtimeEvent } from "../realtime-events.js";
+
+//#region src/hooks/use-realtime-support.d.ts
+type UseRealtimeSupportOptions = {
+  onEvent?: (event: AnyRealtimeEvent) => void;
+};
+type UseRealtimeSupportResult = {
+  isConnected: boolean;
+  isConnecting: boolean;
+  error: Error | null;
+  send: (event: AnyRealtimeEvent) => void;
+  lastEvent: AnyRealtimeEvent | null;
+  /** @deprecated Use `lastEvent` instead. */
+  lastMessage: AnyRealtimeEvent | null;
+  subscribe: (handler: (event: AnyRealtimeEvent) => void) => () => void;
+};
+/**
+ * Subscribes to websocket updates pushed by the provider-level
+ * `WebSocketProvider`. Delegates low-level connection state while optionally
+ * invoking the consumer supplied `onEvent` handler for every realtime event.
+ */
+declare function useRealtimeSupport(options?: UseRealtimeSupportOptions): UseRealtimeSupportResult;
+//#endregion
+export { UseRealtimeSupportOptions, UseRealtimeSupportResult, useRealtimeSupport };
+//# sourceMappingURL=use-realtime-support.d.ts.map

package/hooks/use-realtime-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-realtime-support.d.ts","names":[],"sources":["../../src/hooks/use-realtime-support.ts"],"sourcesContent":[],"mappings":";;;KAIY,yBAAA;oBACO;AADnB,CAAA;AAIY,KAAA,wBAAA,GAAwB;EAAA,WAAA,EAAA,OAAA;cAG5B,EAAA,OAAA;OACO,EADP,KACO,GAAA,IAAA;MACH,EAAA,CAAA,KAAA,EADG,gBACH,EAAA,GAAA,IAAA;WAEE,EAFF,gBAEE,GAAA,IAAA;;EACgC,WAAA,EADhC,gBACgC,GAAA,IAAA;EAQ9B,SAAA,EAAA,CAAA,OAAA,EAAkB,CAAA,KAAA,EARJ,gBAQI,EAAA,GAAA,IAAA,EAAA,GAAA,GAAA,GAAA,IAAA;CAAA;;;;;;iBAAlB,kBAAA,WACN,4BACP"}

package/hooks/use-realtime-support.js

@@ -0,0 +1,29 @@
+import { useWebSocket } from "../support/context/websocket.js";
+import { useEffect } from "react";
+
+//#region src/hooks/use-realtime-support.ts
+/**
+* Subscribes to websocket updates pushed by the provider-level
+* `WebSocketProvider`. Delegates low-level connection state while optionally
+* invoking the consumer supplied `onEvent` handler for every realtime event.
+*/
+function useRealtimeSupport(options = {}) {
+	const { onEvent } = options;
+	const { isConnected, isConnecting, error, send, subscribe, lastEvent } = useWebSocket();
+	useEffect(() => {
+		if (onEvent) return subscribe(onEvent);
+	}, [onEvent, subscribe]);
+	return {
+		isConnected,
+		isConnecting,
+		error,
+		send,
+		subscribe,
+		lastEvent,
+		lastMessage: lastEvent
+	};
+}
+
+//#endregion
+export { useRealtimeSupport };
+//# sourceMappingURL=use-realtime-support.js.map

package/hooks/use-realtime-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-realtime-support.js","names":[],"sources":["../../src/hooks/use-realtime-support.ts"],"sourcesContent":["import type { AnyRealtimeEvent } from \"@cossistant/types/realtime-events\";\nimport { useEffect } from \"react\";\nimport { useWebSocket } from \"../support/context/websocket\";\n\nexport type UseRealtimeSupportOptions = {\n\tonEvent?: (event: AnyRealtimeEvent) => void;\n};\n\nexport type UseRealtimeSupportResult = {\n\tisConnected: boolean;\n\tisConnecting: boolean;\n\terror: Error | null;\n\tsend: (event: AnyRealtimeEvent) => void;\n\tlastEvent: AnyRealtimeEvent | null;\n\t/** @deprecated Use `lastEvent` instead. */\n\tlastMessage: AnyRealtimeEvent | null;\n\tsubscribe: (handler: (event: AnyRealtimeEvent) => void) => () => void;\n};\n\n/**\n * Subscribes to websocket updates pushed by the provider-level\n * `WebSocketProvider`. Delegates low-level connection state while optionally\n * invoking the consumer supplied `onEvent` handler for every realtime event.\n */\nexport function useRealtimeSupport(\n\toptions: UseRealtimeSupportOptions = {}\n): UseRealtimeSupportResult {\n\tconst { onEvent } = options;\n\tconst { isConnected, isConnecting, error, send, subscribe, lastEvent } =\n\t\tuseWebSocket();\n\n\t// Subscribe to WebSocket events\n\tuseEffect(() => {\n\t\tif (onEvent) {\n\t\t\tconst unsubscribe = subscribe(onEvent);\n\n\t\t\treturn unsubscribe;\n\t\t}\n\t}, [onEvent, subscribe]);\n\n\treturn {\n\t\tisConnected,\n\t\tisConnecting,\n\t\terror,\n\t\tsend,\n\t\tsubscribe,\n\t\tlastEvent,\n\t\tlastMessage: lastEvent,\n\t};\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,mBACf,UAAqC,EAAE,EACZ;CAC3B,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,aAAa,cAAc,OAAO,MAAM,WAAW,cAC1D,cAAc;AAGf,iBAAgB;AACf,MAAI,QAGH,QAFoB,UAAU,QAAQ;IAIrC,CAAC,SAAS,UAAU,CAAC;AAExB,QAAO;EACN;EACA;EACA;EACA;EACA;EACA;EACA,aAAa;EACb"}

package/hooks/use-send-message.d.ts

@@ -0,0 +1,34 @@
+import { TimelineItem } from "../timeline-item.js";
+import { CreateConversationResponseBody } from "../conversation.js";
+import { CossistantClient } from "@cossistant/core";
+
+//#region src/hooks/use-send-message.d.ts
+type SendMessageOptions = {
+  conversationId?: string | null;
+  message: string;
+  files?: File[];
+  defaultTimelineItems?: TimelineItem[];
+  visitorId?: string;
+  onSuccess?: (conversationId: string, messageId: string) => void;
+  onError?: (error: Error) => void;
+};
+type SendMessageResult = {
+  conversationId: string;
+  messageId: string;
+  conversation?: CreateConversationResponseBody["conversation"];
+  initialTimelineItems?: CreateConversationResponseBody["initialTimelineItems"];
+};
+type UseSendMessageResult = {
+  mutate: (options: SendMessageOptions) => void;
+  mutateAsync: (options: SendMessageOptions) => Promise<SendMessageResult | null>;
+  isPending: boolean;
+  error: Error | null;
+  reset: () => void;
+};
+type UseSendMessageOptions = {
+  client?: CossistantClient;
+};
+declare function useSendMessage(options?: UseSendMessageOptions): UseSendMessageResult;
+//#endregion
+export { SendMessageOptions, SendMessageResult, UseSendMessageOptions, UseSendMessageResult, useSendMessage };
+//# sourceMappingURL=use-send-message.d.ts.map

package/hooks/use-send-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-send-message.d.ts","names":[],"sources":["../../src/hooks/use-send-message.ts"],"sourcesContent":[],"mappings":";;;;;KAQY,kBAAA;;EAAA,OAAA,EAAA,MAAA;EAAkB,KAAA,CAAA,EAGrB,IAHqB,EAAA;sBAGrB,CAAA,EACe,YADf,EAAA;WACe,CAAA,EAAA,MAAA;WAGL,CAAA,EAAA,CAAA,cAAA,EAAA,MAAA,EAAA,SAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAAK,OAAA,CAAA,EAAA,CAAA,KAAA,EAAL,KAAK,EAAA,GAAA,IAAA;AAGxB,CAAA;AAA6B,KAAjB,iBAAA,GAAiB;gBAGb,EAAA,MAAA;WACQ,EAAA,MAAA;EAA8B,YAAA,CAAA,EADtC,8BACsC,CAAA,cAAA,CAAA;EAG1C,oBAAA,CAAA,EAHY,8BAGQ,CAAA,sBAAA,CAAA;CAAA;AACb,KADP,oBAAA,GACO;QAER,EAAA,CAAA,OAAA,EAFQ,kBAER,EAAA,GAAA,IAAA;aACG,EAAA,CAAA,OAAA,EADH,kBACG,EAAA,GAAR,OAAQ,CAAA,iBAAA,GAAA,IAAA,CAAA;WAAR,EAAA,OAAA;OAEE,EAAA,KAAA,GAAA,IAAA;EAAK,KAAA,EAAA,GAAA,GAAA,IAAA;AAIb,CAAA;AAuCgB,KAvCJ,qBAAA,GAuCkB;EAAA,MAAA,CAAA,EAtCpB,gBAsCoB;;AAE3B,iBAFa,cAAA,CAEb,OAAA,CAAA,EADO,qBACP,CAAA,EAAA,oBAAA"}

package/hooks/use-send-message.js

@@ -0,0 +1,118 @@
+import { useSupport } from "../provider.js";
+import { useCallback, useState } from "react";
+import { generateMessageId } from "@cossistant/core";
+
+//#region src/hooks/use-send-message.ts
+function toError(error) {
+	if (error instanceof Error) return error;
+	if (typeof error === "string") return new Error(error);
+	return /* @__PURE__ */ new Error("Unknown error");
+}
+function buildTimelineItemPayload(body, conversationId, visitorId) {
+	const nowIso = (/* @__PURE__ */ new Date()).toISOString();
+	return {
+		id: generateMessageId(),
+		conversationId,
+		organizationId: "",
+		type: "message",
+		text: body,
+		parts: [{
+			type: "text",
+			text: body
+		}],
+		visibility: "public",
+		userId: null,
+		aiAgentId: null,
+		visitorId: visitorId ?? null,
+		createdAt: nowIso,
+		deletedAt: null
+	};
+}
+function useSendMessage(options = {}) {
+	const { client: contextClient } = useSupport();
+	const client = options.client ?? contextClient;
+	const [isPending, setIsPending] = useState(false);
+	const [error, setError] = useState(null);
+	const mutateAsync = useCallback(async (payload) => {
+		const { conversationId: providedConversationId, message, defaultTimelineItems = [], visitorId, onSuccess, onError } = payload;
+		if (!message.trim()) {
+			const emptyMessageError = /* @__PURE__ */ new Error("Message cannot be empty");
+			setError(emptyMessageError);
+			onError?.(emptyMessageError);
+			return null;
+		}
+		setIsPending(true);
+		setError(null);
+		try {
+			let conversationId = providedConversationId ?? void 0;
+			let preparedDefaultTimelineItems = defaultTimelineItems;
+			let initialConversation;
+			if (!conversationId) {
+				const initiated = client.initiateConversation({
+					defaultTimelineItems,
+					visitorId: visitorId ?? void 0
+				});
+				conversationId = initiated.conversationId;
+				preparedDefaultTimelineItems = initiated.defaultTimelineItems;
+				initialConversation = initiated.conversation;
+			}
+			const timelineItemPayload = buildTimelineItemPayload(message, conversationId, visitorId ?? null);
+			const response = await client.sendMessage({
+				conversationId,
+				item: {
+					id: timelineItemPayload.id,
+					text: timelineItemPayload.text ?? "",
+					type: timelineItemPayload.type,
+					visibility: timelineItemPayload.visibility,
+					userId: timelineItemPayload.userId,
+					aiAgentId: timelineItemPayload.aiAgentId,
+					visitorId: timelineItemPayload.visitorId,
+					createdAt: timelineItemPayload.createdAt,
+					parts: timelineItemPayload.parts
+				},
+				createIfPending: true
+			});
+			const messageId = response.item.id;
+			if (!messageId) throw new Error("SendMessage response missing item.id");
+			const result = {
+				conversationId,
+				messageId
+			};
+			if ("conversation" in response && response.conversation) {
+				result.conversation = response.conversation;
+				result.initialTimelineItems = response.initialTimelineItems;
+			} else if (initialConversation) {
+				result.conversation = initialConversation;
+				result.initialTimelineItems = preparedDefaultTimelineItems;
+			}
+			setIsPending(false);
+			setError(null);
+			onSuccess?.(result.conversationId, result.messageId);
+			return result;
+		} catch (raw) {
+			const normalised = toError(raw);
+			setIsPending(false);
+			setError(normalised);
+			onError?.(normalised);
+			throw normalised;
+		}
+	}, [client]);
+	const mutate = useCallback((opts) => {
+		mutateAsync(opts).catch(() => {});
+	}, [mutateAsync]);
+	const reset = useCallback(() => {
+		setError(null);
+		setIsPending(false);
+	}, []);
+	return {
+		mutate,
+		mutateAsync,
+		isPending,
+		error,
+		reset
+	};
+}
+
+//#endregion
+export { useSendMessage };
+//# sourceMappingURL=use-send-message.js.map

package/hooks/use-send-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-send-message.js","names":["initialConversation:\n\t\t\t\t\t| CreateConversationResponseBody[\"conversation\"]\n\t\t\t\t\t| undefined","result: SendMessageResult"],"sources":["../../src/hooks/use-send-message.ts"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport { generateMessageId } from \"@cossistant/core\";\nimport type { CreateConversationResponseBody } from \"@cossistant/types/api/conversation\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport { useCallback, useState } from \"react\";\n\nimport { useSupport } from \"../provider\";\n\nexport type SendMessageOptions = {\n\tconversationId?: string | null;\n\tmessage: string;\n\tfiles?: File[];\n\tdefaultTimelineItems?: TimelineItem[];\n\tvisitorId?: string;\n\tonSuccess?: (conversationId: string, messageId: string) => void;\n\tonError?: (error: Error) => void;\n};\n\nexport type SendMessageResult = {\n\tconversationId: string;\n\tmessageId: string;\n\tconversation?: CreateConversationResponseBody[\"conversation\"];\n\tinitialTimelineItems?: CreateConversationResponseBody[\"initialTimelineItems\"];\n};\n\nexport type UseSendMessageResult = {\n\tmutate: (options: SendMessageOptions) => void;\n\tmutateAsync: (\n\t\toptions: SendMessageOptions\n\t) => Promise<SendMessageResult | null>;\n\tisPending: boolean;\n\terror: Error | null;\n\treset: () => void;\n};\n\nexport type UseSendMessageOptions = {\n\tclient?: CossistantClient;\n};\n\nfunction toError(error: unknown): Error {\n\tif (error instanceof Error) {\n\t\treturn error;\n\t}\n\n\tif (typeof error === \"string\") {\n\t\treturn new Error(error);\n\t}\n\n\treturn new Error(\"Unknown error\");\n}\n\nfunction buildTimelineItemPayload(\n\tbody: string,\n\tconversationId: string,\n\tvisitorId?: string | null\n): TimelineItem {\n\tconst nowIso = new Date().toISOString();\n\n\treturn {\n\t\tid: generateMessageId(),\n\t\tconversationId,\n\t\torganizationId: \"\", // Will be set by backend\n\t\ttype: \"message\" as const,\n\t\ttext: body,\n\t\tparts: [{ type: \"text\" as const, text: body }],\n\t\tvisibility: \"public\" as const,\n\t\tuserId: null,\n\t\taiAgentId: null,\n\t\tvisitorId: visitorId ?? null,\n\t\tcreatedAt: nowIso,\n\t\tdeletedAt: null,\n\t} satisfies TimelineItem;\n}\n\nexport function useSendMessage(\n\toptions: UseSendMessageOptions = {}\n): UseSendMessageResult {\n\tconst { client: contextClient } = useSupport();\n\tconst client = options.client ?? contextClient;\n\n\tconst [isPending, setIsPending] = useState(false);\n\tconst [error, setError] = useState<Error | null>(null);\n\n\tconst mutateAsync = useCallback(\n\t\tasync (payload: SendMessageOptions): Promise<SendMessageResult | null> => {\n\t\t\tconst {\n\t\t\t\tconversationId: providedConversationId,\n\t\t\t\tmessage,\n\t\t\t\tdefaultTimelineItems = [],\n\t\t\t\tvisitorId,\n\t\t\t\tonSuccess,\n\t\t\t\tonError,\n\t\t\t} = payload;\n\n\t\t\tif (!message.trim()) {\n\t\t\t\tconst emptyMessageError = new Error(\"Message cannot be empty\");\n\t\t\t\tsetError(emptyMessageError);\n\t\t\t\tonError?.(emptyMessageError);\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\tsetIsPending(true);\n\t\t\tsetError(null);\n\n\t\t\ttry {\n\t\t\t\tlet conversationId = providedConversationId ?? undefined;\n\t\t\t\tlet preparedDefaultTimelineItems = defaultTimelineItems;\n\t\t\t\tlet initialConversation:\n\t\t\t\t\t| CreateConversationResponseBody[\"conversation\"]\n\t\t\t\t\t| undefined;\n\n\t\t\t\tif (!conversationId) {\n\t\t\t\t\tconst initiated = client.initiateConversation({\n\t\t\t\t\t\tdefaultTimelineItems,\n\t\t\t\t\t\tvisitorId: visitorId ?? undefined,\n\t\t\t\t\t});\n\t\t\t\t\tconversationId = initiated.conversationId;\n\t\t\t\t\tpreparedDefaultTimelineItems = initiated.defaultTimelineItems;\n\t\t\t\t\tinitialConversation = initiated.conversation;\n\t\t\t\t}\n\n\t\t\t\tconst timelineItemPayload = buildTimelineItemPayload(\n\t\t\t\t\tmessage,\n\t\t\t\t\tconversationId,\n\t\t\t\t\tvisitorId ?? null\n\t\t\t\t);\n\n\t\t\t\tconst response = await client.sendMessage({\n\t\t\t\t\tconversationId,\n\t\t\t\t\titem: {\n\t\t\t\t\t\tid: timelineItemPayload.id,\n\t\t\t\t\t\ttext: timelineItemPayload.text ?? \"\",\n\t\t\t\t\t\ttype: timelineItemPayload.type,\n\t\t\t\t\t\tvisibility: timelineItemPayload.visibility,\n\t\t\t\t\t\tuserId: timelineItemPayload.userId,\n\t\t\t\t\t\taiAgentId: timelineItemPayload.aiAgentId,\n\t\t\t\t\t\tvisitorId: timelineItemPayload.visitorId,\n\t\t\t\t\t\tcreatedAt: timelineItemPayload.createdAt,\n\t\t\t\t\t\tparts: timelineItemPayload.parts,\n\t\t\t\t\t},\n\t\t\t\t\tcreateIfPending: true,\n\t\t\t\t});\n\n\t\t\t\tconst messageId = response.item.id;\n\n\t\t\t\tif (!messageId) {\n\t\t\t\t\tthrow new Error(\"SendMessage response missing item.id\");\n\t\t\t\t}\n\n\t\t\t\tconst result: SendMessageResult = {\n\t\t\t\t\tconversationId,\n\t\t\t\t\tmessageId,\n\t\t\t\t};\n\n\t\t\t\tif (\"conversation\" in response && response.conversation) {\n\t\t\t\t\tresult.conversation = response.conversation;\n\t\t\t\t\tresult.initialTimelineItems = response.initialTimelineItems;\n\t\t\t\t} else if (initialConversation) {\n\t\t\t\t\tresult.conversation = initialConversation;\n\t\t\t\t\tresult.initialTimelineItems = preparedDefaultTimelineItems;\n\t\t\t\t}\n\n\t\t\t\tsetIsPending(false);\n\t\t\t\tsetError(null);\n\t\t\t\tonSuccess?.(result.conversationId, result.messageId);\n\t\t\t\treturn result;\n\t\t\t} catch (raw) {\n\t\t\t\tconst normalised = toError(raw);\n\t\t\t\tsetIsPending(false);\n\t\t\t\tsetError(normalised);\n\t\t\t\tonError?.(normalised);\n\t\t\t\tthrow normalised;\n\t\t\t}\n\t\t},\n\t\t[client]\n\t);\n\n\tconst mutate = useCallback(\n\t\t(opts: SendMessageOptions) => {\n\t\t\tvoid mutateAsync(opts).catch(() => {\n\t\t\t\t// Swallow errors to mimic react-query behaviour for mutate\n\t\t\t});\n\t\t},\n\t\t[mutateAsync]\n\t);\n\n\tconst reset = useCallback(() => {\n\t\tsetError(null);\n\t\tsetIsPending(false);\n\t}, []);\n\n\treturn {\n\t\tmutate,\n\t\tmutateAsync,\n\t\tisPending,\n\t\terror,\n\t\treset,\n\t};\n}\n"],"mappings":";;;;;AAuCA,SAAS,QAAQ,OAAuB;AACvC,KAAI,iBAAiB,MACpB,QAAO;AAGR,KAAI,OAAO,UAAU,SACpB,QAAO,IAAI,MAAM,MAAM;AAGxB,wBAAO,IAAI,MAAM,gBAAgB;;AAGlC,SAAS,yBACR,MACA,gBACA,WACe;CACf,MAAM,0BAAS,IAAI,MAAM,EAAC,aAAa;AAEvC,QAAO;EACN,IAAI,mBAAmB;EACvB;EACA,gBAAgB;EAChB,MAAM;EACN,MAAM;EACN,OAAO,CAAC;GAAE,MAAM;GAAiB,MAAM;GAAM,CAAC;EAC9C,YAAY;EACZ,QAAQ;EACR,WAAW;EACX,WAAW,aAAa;EACxB,WAAW;EACX,WAAW;EACX;;AAGF,SAAgB,eACf,UAAiC,EAAE,EACZ;CACvB,MAAM,EAAE,QAAQ,kBAAkB,YAAY;CAC9C,MAAM,SAAS,QAAQ,UAAU;CAEjC,MAAM,CAAC,WAAW,gBAAgB,SAAS,MAAM;CACjD,MAAM,CAAC,OAAO,YAAY,SAAuB,KAAK;CAEtD,MAAM,cAAc,YACnB,OAAO,YAAmE;EACzE,MAAM,EACL,gBAAgB,wBAChB,SACA,uBAAuB,EAAE,EACzB,WACA,WACA,YACG;AAEJ,MAAI,CAAC,QAAQ,MAAM,EAAE;GACpB,MAAM,oCAAoB,IAAI,MAAM,0BAA0B;AAC9D,YAAS,kBAAkB;AAC3B,aAAU,kBAAkB;AAC5B,UAAO;;AAGR,eAAa,KAAK;AAClB,WAAS,KAAK;AAEd,MAAI;GACH,IAAI,iBAAiB,0BAA0B;GAC/C,IAAI,+BAA+B;GACnC,IAAIA;AAIJ,OAAI,CAAC,gBAAgB;IACpB,MAAM,YAAY,OAAO,qBAAqB;KAC7C;KACA,WAAW,aAAa;KACxB,CAAC;AACF,qBAAiB,UAAU;AAC3B,mCAA+B,UAAU;AACzC,0BAAsB,UAAU;;GAGjC,MAAM,sBAAsB,yBAC3B,SACA,gBACA,aAAa,KACb;GAED,MAAM,WAAW,MAAM,OAAO,YAAY;IACzC;IACA,MAAM;KACL,IAAI,oBAAoB;KACxB,MAAM,oBAAoB,QAAQ;KAClC,MAAM,oBAAoB;KAC1B,YAAY,oBAAoB;KAChC,QAAQ,oBAAoB;KAC5B,WAAW,oBAAoB;KAC/B,WAAW,oBAAoB;KAC/B,WAAW,oBAAoB;KAC/B,OAAO,oBAAoB;KAC3B;IACD,iBAAiB;IACjB,CAAC;GAEF,MAAM,YAAY,SAAS,KAAK;AAEhC,OAAI,CAAC,UACJ,OAAM,IAAI,MAAM,uCAAuC;GAGxD,MAAMC,SAA4B;IACjC;IACA;IACA;AAED,OAAI,kBAAkB,YAAY,SAAS,cAAc;AACxD,WAAO,eAAe,SAAS;AAC/B,WAAO,uBAAuB,SAAS;cAC7B,qBAAqB;AAC/B,WAAO,eAAe;AACtB,WAAO,uBAAuB;;AAG/B,gBAAa,MAAM;AACnB,YAAS,KAAK;AACd,eAAY,OAAO,gBAAgB,OAAO,UAAU;AACpD,UAAO;WACC,KAAK;GACb,MAAM,aAAa,QAAQ,IAAI;AAC/B,gBAAa,MAAM;AACnB,YAAS,WAAW;AACpB,aAAU,WAAW;AACrB,SAAM;;IAGR,CAAC,OAAO,CACR;CAED,MAAM,SAAS,aACb,SAA6B;AAC7B,EAAK,YAAY,KAAK,CAAC,YAAY,GAEjC;IAEH,CAAC,YAAY,CACb;CAED,MAAM,QAAQ,kBAAkB;AAC/B,WAAS,KAAK;AACd,eAAa,MAAM;IACjB,EAAE,CAAC;AAEN,QAAO;EACN;EACA;EACA;EACA;EACA;EACA"}

package/hooks/use-visitor.d.ts

@@ -0,0 +1,28 @@
+import { PublicVisitor, VisitorMetadata, VisitorResponse } from "@cossistant/types";
+
+//#region src/hooks/use-visitor.d.ts
+type UseVisitorReturn = {
+  visitor: PublicVisitor | null;
+  setVisitorMetadata: (metadata: VisitorMetadata) => Promise<VisitorResponse | null>;
+  identify: (params: {
+    externalId?: string;
+    email?: string;
+    name?: string;
+    image?: string;
+    metadata?: Record<string, unknown>;
+  }) => Promise<{
+    contactId: string;
+    visitorId: string;
+  } | null>;
+};
+/**
+ * Exposes the current visitor plus helpers to identify and update metadata.
+ *
+ * Note: Metadata is stored on contacts, not visitors. When you call
+ * setVisitorMetadata, it will update the contact metadata if the visitor
+ * has been identified. If not, you must call identify() first.
+ */
+declare function useVisitor(): UseVisitorReturn;
+//#endregion
+export { UseVisitorReturn, useVisitor };
+//# sourceMappingURL=use-visitor.d.ts.map

package/hooks/use-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visitor.d.ts","names":[],"sources":["../../src/hooks/use-visitor.ts"],"sourcesContent":[],"mappings":";;;KAQY,gBAAA;WACF;EADE,kBAAA,EAAgB,CAAA,QAAA,EAGhB,eAHgB,EAAA,GAItB,OAJsB,CAId,eAJc,GAAA,IAAA,CAAA;EAAA,QAAA,EAAA,CAAA,MAAA,EAAA;IAClB,UAAA,CAAA,EAAA,MAAA;IAEE,KAAA,CAAA,EAAA,MAAA;IACE,IAAA,CAAA,EAAA,MAAA;IAAR,KAAA,CAAA,EAAA,MAAA;IAMO,QAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAA,OAAA,CAAA;KACN,GAAA,OAAA,CAAA;IAAO,SAAA,EAAA,MAAA;IAsBE,SAAU,EAAA,MAAA;;;;;;;;;;iBAAV,UAAA,CAAA,GAAc"}

package/hooks/use-visitor.js

@@ -0,0 +1,59 @@
+import { useSupport } from "../provider.js";
+import { useCallback } from "react";
+
+//#region src/hooks/use-visitor.ts
+function safeWarn(message) {
+	if (typeof console !== "undefined" && typeof console.warn === "function") console.warn(message);
+}
+function safeError(message, error) {
+	if (typeof console !== "undefined" && typeof console.error === "function") console.error(message, error);
+}
+/**
+* Exposes the current visitor plus helpers to identify and update metadata.
+*
+* Note: Metadata is stored on contacts, not visitors. When you call
+* setVisitorMetadata, it will update the contact metadata if the visitor
+* has been identified. If not, you must call identify() first.
+*/
+function useVisitor() {
+	const { website, client } = useSupport();
+	const visitor = website?.visitor || null;
+	const visitorId = visitor?.id ?? null;
+	const setVisitorMetadata = useCallback(async (metadata) => {
+		if (!visitorId) {
+			safeWarn("No visitor is associated with this session; metadata update skipped");
+			return null;
+		}
+		try {
+			return await client.updateVisitorMetadata(metadata);
+		} catch (error) {
+			safeError("Failed to update visitor metadata", error);
+			return null;
+		}
+	}, [client, visitorId]);
+	const identify = useCallback(async (params) => {
+		if (!visitorId) {
+			safeWarn("No visitor is associated with this session; identify skipped");
+			return null;
+		}
+		try {
+			const result = await client.identify(params);
+			return {
+				contactId: result.contact.id,
+				visitorId: result.visitorId
+			};
+		} catch (error) {
+			safeError("Failed to identify visitor", error);
+			return null;
+		}
+	}, [client, visitorId]);
+	return {
+		visitor,
+		setVisitorMetadata,
+		identify
+	};
+}
+
+//#endregion
+export { useVisitor };
+//# sourceMappingURL=use-visitor.js.map

package/hooks/use-visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visitor.js","names":[],"sources":["../../src/hooks/use-visitor.ts"],"sourcesContent":["import type {\n\tPublicVisitor,\n\tVisitorMetadata,\n\tVisitorResponse,\n} from \"@cossistant/types\";\nimport { useCallback } from \"react\";\nimport { useSupport } from \"../provider\";\n\nexport type UseVisitorReturn = {\n\tvisitor: PublicVisitor | null;\n\tsetVisitorMetadata: (\n\t\tmetadata: VisitorMetadata\n\t) => Promise<VisitorResponse | null>;\n\tidentify: (params: {\n\t\texternalId?: string;\n\t\temail?: string;\n\t\tname?: string;\n\t\timage?: string;\n\t\tmetadata?: Record<string, unknown>;\n\t}) => Promise<{ contactId: string; visitorId: string } | null>;\n};\n\nfunction safeWarn(message: string): void {\n\tif (typeof console !== \"undefined\" && typeof console.warn === \"function\") {\n\t\tconsole.warn(message);\n\t}\n}\n\nfunction safeError(message: string, error: unknown): void {\n\tif (typeof console !== \"undefined\" && typeof console.error === \"function\") {\n\t\tconsole.error(message, error);\n\t}\n}\n\n/**\n * Exposes the current visitor plus helpers to identify and update metadata.\n *\n * Note: Metadata is stored on contacts, not visitors. When you call\n * setVisitorMetadata, it will update the contact metadata if the visitor\n * has been identified. If not, you must call identify() first.\n */\nexport function useVisitor(): UseVisitorReturn {\n\tconst { website, client } = useSupport();\n\tconst visitor = website?.visitor || null;\n\tconst visitorId = visitor?.id ?? null;\n\n\tconst setVisitorMetadata = useCallback<\n\t\t(metadata: VisitorMetadata) => Promise<VisitorResponse | null>\n\t>(\n\t\tasync (metadata) => {\n\t\t\tif (!visitorId) {\n\t\t\t\tsafeWarn(\n\t\t\t\t\t\"No visitor is associated with this session; metadata update skipped\"\n\t\t\t\t);\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\treturn await client.updateVisitorMetadata(metadata);\n\t\t\t} catch (error) {\n\t\t\t\tsafeError(\"Failed to update visitor metadata\", error);\n\t\t\t\treturn null;\n\t\t\t}\n\t\t},\n\t\t[client, visitorId]\n\t);\n\n\tconst identify = useCallback<\n\t\t(params: {\n\t\t\texternalId?: string;\n\t\t\temail?: string;\n\t\t\tname?: string;\n\t\t\timage?: string;\n\t\t\tmetadata?: Record<string, unknown>;\n\t\t}) => Promise<{ contactId: string; visitorId: string } | null>\n\t>(\n\t\tasync (params) => {\n\t\t\tif (!visitorId) {\n\t\t\t\tsafeWarn(\n\t\t\t\t\t\"No visitor is associated with this session; identify skipped\"\n\t\t\t\t);\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst result = await client.identify(params);\n\n\t\t\t\treturn {\n\t\t\t\t\tcontactId: result.contact.id,\n\t\t\t\t\tvisitorId: result.visitorId,\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\tsafeError(\"Failed to identify visitor\", error);\n\t\t\t\treturn null;\n\t\t\t}\n\t\t},\n\t\t[client, visitorId]\n\t);\n\n\treturn {\n\t\tvisitor,\n\t\tsetVisitorMetadata,\n\t\tidentify,\n\t};\n}\n"],"mappings":";;;;AAsBA,SAAS,SAAS,SAAuB;AACxC,KAAI,OAAO,YAAY,eAAe,OAAO,QAAQ,SAAS,WAC7D,SAAQ,KAAK,QAAQ;;AAIvB,SAAS,UAAU,SAAiB,OAAsB;AACzD,KAAI,OAAO,YAAY,eAAe,OAAO,QAAQ,UAAU,WAC9D,SAAQ,MAAM,SAAS,MAAM;;;;;;;;;AAW/B,SAAgB,aAA+B;CAC9C,MAAM,EAAE,SAAS,WAAW,YAAY;CACxC,MAAM,UAAU,SAAS,WAAW;CACpC,MAAM,YAAY,SAAS,MAAM;CAEjC,MAAM,qBAAqB,YAG1B,OAAO,aAAa;AACnB,MAAI,CAAC,WAAW;AACf,YACC,sEACA;AACD,UAAO;;AAGR,MAAI;AACH,UAAO,MAAM,OAAO,sBAAsB,SAAS;WAC3C,OAAO;AACf,aAAU,qCAAqC,MAAM;AACrD,UAAO;;IAGT,CAAC,QAAQ,UAAU,CACnB;CAED,MAAM,WAAW,YAShB,OAAO,WAAW;AACjB,MAAI,CAAC,WAAW;AACf,YACC,+DACA;AACD,UAAO;;AAGR,MAAI;GACH,MAAM,SAAS,MAAM,OAAO,SAAS,OAAO;AAE5C,UAAO;IACN,WAAW,OAAO,QAAQ;IAC1B,WAAW,OAAO;IAClB;WACO,OAAO;AACf,aAAU,8BAA8B,MAAM;AAC9C,UAAO;;IAGT,CAAC,QAAQ,UAAU,CACnB;AAED,QAAO;EACN;EACA;EACA;EACA"}

package/hooks/use-window-visibility-focus.d.ts

@@ -0,0 +1,9 @@
+//#region src/hooks/use-window-visibility-focus.d.ts
+type WindowVisibilityFocusState = {
+  isPageVisible: boolean;
+  hasWindowFocus: boolean;
+};
+declare function useWindowVisibilityFocus(): WindowVisibilityFocusState;
+//#endregion
+export { WindowVisibilityFocusState, useWindowVisibilityFocus };
+//# sourceMappingURL=use-window-visibility-focus.d.ts.map

package/hooks/use-window-visibility-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-window-visibility-focus.d.ts","names":[],"sources":["../../src/hooks/use-window-visibility-focus.ts"],"sourcesContent":[],"mappings":";KAEY,0BAAA;EAAA,aAAA,EAAA,OAAA;EAkBI,cAAA,EAAA,OAAA;;iBAAA,wBAAA,CAAA,GAA4B"}

package/hooks/use-window-visibility-focus.js

@@ -0,0 +1,53 @@
+import { useEffect, useState } from "react";
+
+//#region src/hooks/use-window-visibility-focus.ts
+const getVisibilityFocusState = () => {
+	if (typeof document === "undefined") return {
+		isPageVisible: true,
+		hasWindowFocus: true
+	};
+	const isPageVisible = !document.hidden;
+	const hasWindowFocus = isPageVisible && (typeof document.hasFocus === "function" ? document.hasFocus() : true);
+	return {
+		isPageVisible,
+		hasWindowFocus
+	};
+};
+function useWindowVisibilityFocus() {
+	const [state, setState] = useState(() => getVisibilityFocusState());
+	useEffect(() => {
+		if (typeof document === "undefined") return;
+		const handleVisibilityChange = () => {
+			setState(getVisibilityFocusState());
+		};
+		document.addEventListener("visibilitychange", handleVisibilityChange);
+		handleVisibilityChange();
+		return () => {
+			document.removeEventListener("visibilitychange", handleVisibilityChange);
+		};
+	}, []);
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		const syncVisibilityFocus = () => {
+			setState(getVisibilityFocusState());
+		};
+		const handleFocus = () => {
+			syncVisibilityFocus();
+		};
+		const handleBlur = () => {
+			syncVisibilityFocus();
+		};
+		window.addEventListener("focus", handleFocus);
+		window.addEventListener("blur", handleBlur);
+		syncVisibilityFocus();
+		return () => {
+			window.removeEventListener("focus", handleFocus);
+			window.removeEventListener("blur", handleBlur);
+		};
+	}, []);
+	return state;
+}
+
+//#endregion
+export { useWindowVisibilityFocus };
+//# sourceMappingURL=use-window-visibility-focus.js.map

package/hooks/use-window-visibility-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-window-visibility-focus.js","names":[],"sources":["../../src/hooks/use-window-visibility-focus.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport type WindowVisibilityFocusState = {\n        isPageVisible: boolean;\n        hasWindowFocus: boolean;\n};\n\nconst getVisibilityFocusState = (): WindowVisibilityFocusState => {\n        if (typeof document === \"undefined\") {\n                return { isPageVisible: true, hasWindowFocus: true };\n        }\n\n        const isPageVisible = !document.hidden;\n        const hasWindowFocus =\n                isPageVisible &&\n                (typeof document.hasFocus === \"function\" ? document.hasFocus() : true);\n\n        return { isPageVisible, hasWindowFocus };\n};\n\nexport function useWindowVisibilityFocus(): WindowVisibilityFocusState {\n        const [state, setState] = useState<WindowVisibilityFocusState>(\n                () => getVisibilityFocusState()\n        );\n\n        useEffect(() => {\n                if (typeof document === \"undefined\") {\n                        return;\n                }\n\n                const handleVisibilityChange = () => {\n                        setState(getVisibilityFocusState());\n                };\n\n                document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n                handleVisibilityChange();\n                return () => {\n                        document.removeEventListener(\n                                \"visibilitychange\",\n                                handleVisibilityChange\n                        );\n                };\n        }, []);\n\n        useEffect(() => {\n                if (typeof window === \"undefined\") {\n                        return;\n                }\n\n                const syncVisibilityFocus = () => {\n                        setState(getVisibilityFocusState());\n                };\n\n                const handleFocus = () => {\n                        syncVisibilityFocus();\n                };\n                const handleBlur = () => {\n                        syncVisibilityFocus();\n                };\n\n                window.addEventListener(\"focus\", handleFocus);\n                window.addEventListener(\"blur\", handleBlur);\n\n                syncVisibilityFocus();\n\n                return () => {\n                        window.removeEventListener(\"focus\", handleFocus);\n                        window.removeEventListener(\"blur\", handleBlur);\n                };\n        }, []);\n\n        return state;\n}\n"],"mappings":";;;AAOA,MAAM,gCAA4D;AAC1D,KAAI,OAAO,aAAa,YAChB,QAAO;EAAE,eAAe;EAAM,gBAAgB;EAAM;CAG5D,MAAM,gBAAgB,CAAC,SAAS;CAChC,MAAM,iBACE,kBACC,OAAO,SAAS,aAAa,aAAa,SAAS,UAAU,GAAG;AAEzE,QAAO;EAAE;EAAe;EAAgB;;AAGhD,SAAgB,2BAAuD;CAC/D,MAAM,CAAC,OAAO,YAAY,eACZ,yBAAyB,CACtC;AAED,iBAAgB;AACR,MAAI,OAAO,aAAa,YAChB;EAGR,MAAM,+BAA+B;AAC7B,YAAS,yBAAyB,CAAC;;AAG3C,WAAS,iBAAiB,oBAAoB,uBAAuB;AACrE,0BAAwB;AACxB,eAAa;AACL,YAAS,oBACD,oBACA,uBACP;;IAEd,EAAE,CAAC;AAEN,iBAAgB;AACR,MAAI,OAAO,WAAW,YACd;EAGR,MAAM,4BAA4B;AAC1B,YAAS,yBAAyB,CAAC;;EAG3C,MAAM,oBAAoB;AAClB,wBAAqB;;EAE7B,MAAM,mBAAmB;AACjB,wBAAqB;;AAG7B,SAAO,iBAAiB,SAAS,YAAY;AAC7C,SAAO,iBAAiB,QAAQ,WAAW;AAE3C,uBAAqB;AAErB,eAAa;AACL,UAAO,oBAAoB,SAAS,YAAY;AAChD,UAAO,oBAAoB,QAAQ,WAAW;;IAE3D,EAAE,CAAC;AAEN,QAAO"}

package/identify-visitor.d.ts

@@ -0,0 +1,18 @@
+//#region src/identify-visitor.d.ts
+type IdentifySupportVisitorProps = {
+  externalId?: string;
+  email?: string;
+};
+/**
+ * Component exposed by Cossistant allowing you to identify a visitor whenever rendered with either an `externalId` or `email`.
+ */
+declare const IdentifySupportVisitor: {
+  ({
+    externalId,
+    email
+  }: IdentifySupportVisitorProps): null;
+  displayName: string;
+};
+//#endregion
+export { IdentifySupportVisitor, IdentifySupportVisitorProps };
+//# sourceMappingURL=identify-visitor.d.ts.map

package/identify-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify-visitor.d.ts","names":[],"sources":["../src/identify-visitor.tsx"],"sourcesContent":[],"mappings":";KAIY,2BAAA;EAAA,UAAA,CAAA,EAAA,MAAA;EAQC,KAAA,CAAA,EAAA,MAAA;CAcZ;;;;AAX6B,cAHjB,sBAGiB,EAAA;;;;KAA3B"}