@cossistant/react 0.0.1

package/hooks/private/use-client-query.js

@@ -0,0 +1,122 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+//#region src/hooks/private/use-client-query.ts
+function toError(error) {
+	if (error instanceof Error) return error;
+	return new Error(typeof error === "string" ? error : "Unknown error");
+}
+const EMPTY_DEPENDENCIES = [];
+function useClientQuery(options) {
+	const { client, queryFn, enabled = true, refetchInterval = false, refetchOnWindowFocus = true, refetchOnMount = true, initialData, initialArgs, dependencies = EMPTY_DEPENDENCIES } = options;
+	const [data, setData] = useState(initialData);
+	const [error, setError] = useState(null);
+	const [isLoading, setIsLoading] = useState(initialData === void 0 && Boolean(enabled));
+	const dataRef = useRef(data);
+	dataRef.current = data;
+	const argsRef = useRef(initialArgs);
+	const fetchIdRef = useRef(0);
+	const hasMountedRef = useRef(false);
+	const hasFetchedRef = useRef(initialData !== void 0);
+	const isMountedRef = useRef(true);
+	const queryFnRef = useRef(queryFn);
+	queryFnRef.current = queryFn;
+	useEffect(() => () => {
+		isMountedRef.current = false;
+	}, []);
+	useEffect(() => {
+		argsRef.current = initialArgs;
+	}, [initialArgs]);
+	const execute = useCallback(async (args, ignoreEnabled = false) => {
+		if (!(enabled || ignoreEnabled)) return dataRef.current;
+		const nextArgs = args ?? argsRef.current;
+		argsRef.current = nextArgs;
+		const fetchId = fetchIdRef.current + 1;
+		fetchIdRef.current = fetchId;
+		setIsLoading(true);
+		setError(null);
+		try {
+			const result = await queryFnRef.current(client, nextArgs);
+			if (!isMountedRef.current || fetchId !== fetchIdRef.current) return dataRef.current;
+			dataRef.current = result;
+			setData(result);
+			setError(null);
+			setIsLoading(false);
+			hasFetchedRef.current = true;
+			return result;
+		} catch (raw) {
+			if (!isMountedRef.current || fetchId !== fetchIdRef.current) return dataRef.current;
+			const normalized = toError(raw);
+			setError(normalized);
+			setIsLoading(false);
+			throw normalized;
+		}
+	}, [client, enabled]);
+	useEffect(() => {
+		if (!enabled) {
+			setIsLoading(false);
+			return;
+		}
+		const shouldFetchInitially = hasMountedRef.current ? true : refetchOnMount || !hasFetchedRef.current;
+		hasMountedRef.current = true;
+		if (!shouldFetchInitially) return;
+		execute(argsRef.current);
+	}, [
+		enabled,
+		execute,
+		refetchOnMount,
+		...dependencies
+	]);
+	useEffect(() => {
+		if (!enabled) return;
+		if (refetchInterval === false || refetchInterval === null || refetchInterval <= 0 || typeof window === "undefined") return;
+		const timer = window.setInterval(() => {
+			execute(argsRef.current);
+		}, refetchInterval);
+		return () => {
+			window.clearInterval(timer);
+		};
+	}, [
+		enabled,
+		execute,
+		refetchInterval
+	]);
+	useEffect(() => {
+		if (!refetchOnWindowFocus || typeof window === "undefined" || typeof document === "undefined") return;
+		const handleRefetch = () => {
+			if (!enabled) return;
+			execute(argsRef.current);
+		};
+		const onFocus = () => {
+			handleRefetch();
+		};
+		const onVisibilityChange = () => {
+			if (document.visibilityState === "visible") handleRefetch();
+		};
+		window.addEventListener("focus", onFocus);
+		document.addEventListener("visibilitychange", onVisibilityChange);
+		return () => {
+			window.removeEventListener("focus", onFocus);
+			document.removeEventListener("visibilitychange", onVisibilityChange);
+		};
+	}, [
+		enabled,
+		execute,
+		refetchOnWindowFocus
+	]);
+	const refetch = useCallback(async (args) => execute(args, true), [execute]);
+	return useMemo(() => ({
+		data,
+		error,
+		isLoading,
+		refetch
+	}), [
+		data,
+		error,
+		isLoading,
+		refetch
+	]);
+}
+
+//#endregion
+export { useClientQuery };
+//# sourceMappingURL=use-client-query.js.map

package/hooks/private/use-client-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-client-query.js","names":["EMPTY_DEPENDENCIES: readonly unknown[]","raw: unknown"],"sources":["../../../src/hooks/private/use-client-query.ts"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\n\ntype QueryFn<TData, TArgs> = (\n\tclient: CossistantClient,\n\targs?: TArgs | undefined\n) => Promise<TData>;\n\ntype UseClientQueryOptions<TData, TArgs> = {\n\tclient: CossistantClient;\n\tqueryFn: QueryFn<TData, TArgs>;\n\tenabled?: boolean;\n\trefetchInterval?: number | false;\n\trefetchOnWindowFocus?: boolean;\n\trefetchOnMount?: boolean;\n\tinitialData?: TData;\n\tinitialArgs?: TArgs;\n\tdependencies?: readonly unknown[];\n};\n\ntype UseClientQueryResult<TData, TArgs> = {\n\tdata: TData | undefined;\n\terror: Error | null;\n\tisLoading: boolean;\n\trefetch: (args?: TArgs) => Promise<TData | undefined>;\n};\n\nfunction toError(error: unknown): Error {\n\tif (error instanceof Error) {\n\t\treturn error;\n\t}\n\n\treturn new Error(typeof error === \"string\" ? error : \"Unknown error\");\n}\n\nconst EMPTY_DEPENDENCIES: readonly unknown[] = [];\n\nexport function useClientQuery<TData, TArgs = void>(\n\toptions: UseClientQueryOptions<TData, TArgs>\n): UseClientQueryResult<TData, TArgs> {\n\tconst {\n\t\tclient,\n\t\tqueryFn,\n\t\tenabled = true,\n\t\trefetchInterval = false,\n\t\trefetchOnWindowFocus = true,\n\t\trefetchOnMount = true,\n\t\tinitialData,\n\t\tinitialArgs,\n\t\tdependencies = EMPTY_DEPENDENCIES,\n\t} = options;\n\n\tconst [data, setData] = useState<TData | undefined>(initialData);\n\tconst [error, setError] = useState<Error | null>(null);\n\tconst [isLoading, setIsLoading] = useState(\n\t\tinitialData === undefined && Boolean(enabled)\n\t);\n\n\tconst dataRef = useRef(data);\n\tdataRef.current = data;\n\n\tconst argsRef = useRef<TArgs | undefined>(initialArgs);\n\tconst fetchIdRef = useRef(0);\n\tconst hasMountedRef = useRef(false);\n\tconst hasFetchedRef = useRef(initialData !== undefined);\n\tconst isMountedRef = useRef(true);\n\tconst queryFnRef = useRef(queryFn);\n\n\tqueryFnRef.current = queryFn;\n\n\tuseEffect(\n\t\t() => () => {\n\t\t\tisMountedRef.current = false;\n\t\t},\n\t\t[]\n\t);\n\n\tuseEffect(() => {\n\t\targsRef.current = initialArgs;\n\t}, [initialArgs]);\n\n\tconst execute = useCallback(\n\t\tasync (args?: TArgs, ignoreEnabled = false): Promise<TData | undefined> => {\n\t\t\tif (!(enabled || ignoreEnabled)) {\n\t\t\t\treturn dataRef.current;\n\t\t\t}\n\n\t\t\tconst nextArgs = args ?? argsRef.current;\n\t\t\targsRef.current = nextArgs;\n\n\t\t\tconst fetchId = fetchIdRef.current + 1;\n\t\t\tfetchIdRef.current = fetchId;\n\n\t\t\tsetIsLoading(true);\n\t\t\tsetError(null);\n\n\t\t\ttry {\n\t\t\t\tconst result = await queryFnRef.current(client, nextArgs);\n\n\t\t\t\tif (!isMountedRef.current || fetchId !== fetchIdRef.current) {\n\t\t\t\t\treturn dataRef.current;\n\t\t\t\t}\n\n\t\t\t\tdataRef.current = result;\n\t\t\t\tsetData(result);\n\t\t\t\tsetError(null);\n\t\t\t\tsetIsLoading(false);\n\t\t\t\thasFetchedRef.current = true;\n\n\t\t\t\treturn result;\n\t\t\t} catch (raw: unknown) {\n\t\t\t\tif (!isMountedRef.current || fetchId !== fetchIdRef.current) {\n\t\t\t\t\treturn dataRef.current;\n\t\t\t\t}\n\n\t\t\t\tconst normalized = toError(raw);\n\t\t\t\tsetError(normalized);\n\t\t\t\tsetIsLoading(false);\n\n\t\t\t\tthrow normalized;\n\t\t\t}\n\t\t},\n\t\t[client, enabled]\n\t);\n\n\tuseEffect(() => {\n\t\tif (!enabled) {\n\t\t\tsetIsLoading(false);\n\t\t\treturn;\n\t\t}\n\n\t\tconst shouldFetchInitially = hasMountedRef.current\n\t\t\t? true\n\t\t\t: refetchOnMount || !hasFetchedRef.current;\n\n\t\thasMountedRef.current = true;\n\n\t\tif (!shouldFetchInitially) {\n\t\t\treturn;\n\t\t}\n\n\t\tvoid execute(argsRef.current);\n\t}, [enabled, execute, refetchOnMount, ...dependencies]);\n\n\tuseEffect(() => {\n\t\tif (!enabled) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (\n\t\t\trefetchInterval === false ||\n\t\t\trefetchInterval === null ||\n\t\t\trefetchInterval <= 0 ||\n\t\t\ttypeof window === \"undefined\"\n\t\t) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst timer = window.setInterval(() => {\n\t\t\tvoid execute(argsRef.current);\n\t\t}, refetchInterval);\n\n\t\treturn () => {\n\t\t\twindow.clearInterval(timer);\n\t\t};\n\t}, [enabled, execute, refetchInterval]);\n\n\tuseEffect(() => {\n\t\tif (\n\t\t\t!refetchOnWindowFocus ||\n\t\t\ttypeof window === \"undefined\" ||\n\t\t\ttypeof document === \"undefined\"\n\t\t) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst handleRefetch = () => {\n\t\t\tif (!enabled) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tvoid execute(argsRef.current);\n\t\t};\n\n\t\tconst onFocus = () => {\n\t\t\tvoid handleRefetch();\n\t\t};\n\n\t\tconst onVisibilityChange = () => {\n\t\t\tif (document.visibilityState === \"visible\") {\n\t\t\t\tvoid handleRefetch();\n\t\t\t}\n\t\t};\n\n\t\twindow.addEventListener(\"focus\", onFocus);\n\t\tdocument.addEventListener(\"visibilitychange\", onVisibilityChange);\n\n\t\treturn () => {\n\t\t\twindow.removeEventListener(\"focus\", onFocus);\n\t\t\tdocument.removeEventListener(\"visibilitychange\", onVisibilityChange);\n\t\t};\n\t}, [enabled, execute, refetchOnWindowFocus]);\n\n\tconst refetch = useCallback(\n\t\tasync (args?: TArgs) => execute(args, true),\n\t\t[execute]\n\t);\n\n\treturn useMemo(\n\t\t() => ({\n\t\t\tdata,\n\t\t\terror,\n\t\t\tisLoading,\n\t\t\trefetch,\n\t\t}),\n\t\t[data, error, isLoading, refetch]\n\t);\n}\n"],"mappings":"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"}

package/hooks/private/use-default-messages.d.ts

@@ -0,0 +1,18 @@
+import { TimelineItem } from "../../timeline-item.js";
+
+//#region src/hooks/private/use-default-messages.d.ts
+type UseDefaultMessagesParams = {
+  conversationId: string;
+};
+/**
+ * Mirrors the provider-configured default messages into timeline items so
+ * that welcome content renders immediately while the backend conversation is
+ * still being created. Agent fallbacks are resolved against available humans
+ * and AI agents exposed by the provider context.
+ */
+declare function useDefaultMessages({
+  conversationId
+}: UseDefaultMessagesParams): TimelineItem[];
+//#endregion
+export { useDefaultMessages };
+//# sourceMappingURL=use-default-messages.d.ts.map

package/hooks/private/use-default-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-default-messages.d.ts","names":[],"sources":["../../../src/hooks/private/use-default-messages.ts"],"sourcesContent":[],"mappings":";;;KAMK,wBAAA;;AAJmE,CAAA;AAcxE;;;;;;iBAAgB,kBAAA;;GAEb,2BAA2B"}

package/hooks/private/use-default-messages.js

@@ -0,0 +1,45 @@
+import { useSupport } from "../../provider.js";
+import { useMemo } from "react";
+import { generateMessageId } from "@cossistant/core";
+import { SenderType } from "@cossistant/types";
+
+//#region src/hooks/private/use-default-messages.ts
+/**
+* Mirrors the provider-configured default messages into timeline items so
+* that welcome content renders immediately while the backend conversation is
+* still being created. Agent fallbacks are resolved against available humans
+* and AI agents exposed by the provider context.
+*/
+function useDefaultMessages({ conversationId }) {
+	const { defaultMessages, availableAIAgents, availableHumanAgents } = useSupport();
+	return useMemo(() => defaultMessages.map((message, index) => {
+		const messageId = generateMessageId();
+		const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+		return {
+			id: messageId,
+			conversationId,
+			organizationId: "",
+			type: "message",
+			text: message.content,
+			parts: [{
+				type: "text",
+				text: message.content
+			}],
+			visibility: "public",
+			userId: message.senderType === SenderType.TEAM_MEMBER ? message.senderId || availableHumanAgents[0]?.id || null : null,
+			aiAgentId: message.senderType === SenderType.AI ? message.senderId || availableAIAgents[0]?.id || null : null,
+			visitorId: message.senderType === SenderType.VISITOR ? message.senderId || null : null,
+			createdAt: timestamp,
+			deletedAt: null
+		};
+	}), [
+		defaultMessages,
+		availableHumanAgents[0]?.id,
+		availableAIAgents[0]?.id,
+		conversationId
+	]);
+}
+
+//#endregion
+export { useDefaultMessages };
+//# sourceMappingURL=use-default-messages.js.map

package/hooks/private/use-default-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-default-messages.js","names":[],"sources":["../../../src/hooks/private/use-default-messages.ts"],"sourcesContent":["import { generateMessageId } from \"@cossistant/core\";\nimport { SenderType } from \"@cossistant/types\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport { useMemo } from \"react\";\nimport { useSupport } from \"../../provider\";\n\ntype UseDefaultMessagesParams = {\n\tconversationId: string;\n};\n\n/**\n * Mirrors the provider-configured default messages into timeline items so\n * that welcome content renders immediately while the backend conversation is\n * still being created. Agent fallbacks are resolved against available humans\n * and AI agents exposed by the provider context.\n */\nexport function useDefaultMessages({\n\tconversationId,\n}: UseDefaultMessagesParams): TimelineItem[] {\n\tconst { defaultMessages, availableAIAgents, availableHumanAgents } =\n\t\tuseSupport();\n\n\tconst memoisedDefaultTimelineItems = useMemo(\n\t\t() =>\n\t\t\tdefaultMessages.map((message, index) => {\n\t\t\t\tconst messageId = generateMessageId();\n\t\t\t\tconst timestamp = new Date().toISOString();\n\n\t\t\t\treturn {\n\t\t\t\t\tid: messageId,\n\t\t\t\t\tconversationId,\n\t\t\t\t\torganizationId: \"\", // Not available for default messages\n\t\t\t\t\ttype: \"message\" as const,\n\t\t\t\t\ttext: message.content,\n\t\t\t\t\tparts: [{ type: \"text\" as const, text: message.content }],\n\t\t\t\t\tvisibility: \"public\" as const,\n\t\t\t\t\tuserId:\n\t\t\t\t\t\tmessage.senderType === SenderType.TEAM_MEMBER\n\t\t\t\t\t\t\t? message.senderId || availableHumanAgents[0]?.id || null\n\t\t\t\t\t\t\t: null,\n\t\t\t\t\taiAgentId:\n\t\t\t\t\t\tmessage.senderType === SenderType.AI\n\t\t\t\t\t\t\t? message.senderId || availableAIAgents[0]?.id || null\n\t\t\t\t\t\t\t: null,\n\t\t\t\t\tvisitorId:\n\t\t\t\t\t\tmessage.senderType === SenderType.VISITOR\n\t\t\t\t\t\t\t? message.senderId || null\n\t\t\t\t\t\t\t: null,\n\t\t\t\t\tcreatedAt: timestamp,\n\t\t\t\t\tdeletedAt: null,\n\t\t\t\t} satisfies TimelineItem;\n\t\t\t}),\n\t\t[\n\t\t\tdefaultMessages,\n\t\t\tavailableHumanAgents[0]?.id,\n\t\t\tavailableAIAgents[0]?.id,\n\t\t\tconversationId,\n\t\t]\n\t);\n\n\treturn memoisedDefaultTimelineItems;\n}\n"],"mappings":";;;;;;;;;;;;AAgBA,SAAgB,mBAAmB,EAClC,kBAC4C;CAC5C,MAAM,EAAE,iBAAiB,mBAAmB,yBAC3C,YAAY;AAwCb,QAtCqC,cAEnC,gBAAgB,KAAK,SAAS,UAAU;EACvC,MAAM,YAAY,mBAAmB;EACrC,MAAM,6BAAY,IAAI,MAAM,EAAC,aAAa;AAE1C,SAAO;GACN,IAAI;GACJ;GACA,gBAAgB;GAChB,MAAM;GACN,MAAM,QAAQ;GACd,OAAO,CAAC;IAAE,MAAM;IAAiB,MAAM,QAAQ;IAAS,CAAC;GACzD,YAAY;GACZ,QACC,QAAQ,eAAe,WAAW,cAC/B,QAAQ,YAAY,qBAAqB,IAAI,MAAM,OACnD;GACJ,WACC,QAAQ,eAAe,WAAW,KAC/B,QAAQ,YAAY,kBAAkB,IAAI,MAAM,OAChD;GACJ,WACC,QAAQ,eAAe,WAAW,UAC/B,QAAQ,YAAY,OACpB;GACJ,WAAW;GACX,WAAW;GACX;GACA,EACH;EACC;EACA,qBAAqB,IAAI;EACzB,kBAAkB,IAAI;EACtB;EACA,CACD"}

package/hooks/private/use-grouped-messages.d.ts

@@ -0,0 +1,54 @@
+import { TimelineItem } from "../../timeline-item.js";
+import { ConversationSeen } from "../../schemas.js";
+import { SenderType } from "@cossistant/types";
+
+//#region src/hooks/private/use-grouped-messages.d.ts
+type GroupedMessage = {
+  type: "message_group";
+  senderId: string;
+  senderType: SenderType;
+  items: TimelineItem[];
+  firstMessageId: string;
+  lastMessageId: string;
+  firstMessageTime: Date;
+  lastMessageTime: Date;
+};
+type TimelineEventItem = {
+  type: "timeline_event";
+  item: TimelineItem;
+  timestamp: Date;
+};
+type ConversationItem = GroupedMessage | TimelineEventItem;
+type UseGroupedMessagesOptions = {
+  items: TimelineItem[];
+  seenData?: ConversationSeen[];
+  currentViewerId?: string;
+  viewerType?: SenderType;
+};
+type UseGroupedMessagesProps = UseGroupedMessagesOptions;
+/**
+ * Batches sequential timeline items from the same sender into groups and enriches
+ * them with read-receipt helpers so UIs can render conversation timelines with
+ * minimal effort. Seen data is normalised into quick lookup maps for unread
+ * indicators.
+ */
+declare const useGroupedMessages: ({
+  items,
+  seenData,
+  currentViewerId,
+  viewerType
+}: UseGroupedMessagesOptions) => {
+  items: (GroupedMessage | TimelineEventItem)[];
+  seenByMap: Map<string, Set<string>>;
+  lastReadMessageMap: Map<string, string>;
+  unreadCountMap: Map<string, number>;
+  isMessageSeenByViewer: (messageId: string) => boolean;
+  getMessageSeenBy: (messageId: string) => string[];
+  getLastReadMessageId: (userId: string) => string | undefined;
+  isLastReadMessage: (messageId: string, userId: string) => boolean;
+  getUnreadCount: (userId: string) => number;
+  hasUnreadAfter: (messageId: string, userId: string) => boolean;
+};
+//#endregion
+export { ConversationItem, GroupedMessage, TimelineEventItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, useGroupedMessages };
+//# sourceMappingURL=use-grouped-messages.d.ts.map

package/hooks/private/use-grouped-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-grouped-messages.d.ts","names":[],"sources":["../../../src/hooks/private/use-grouped-messages.ts"],"sourcesContent":[],"mappings":";;;;;KAKY,cAAA;;EAAA,QAAA,EAAA,MAAA;EAAc,UAAA,EAGb,UAHa;OAGb,EACL,YADK,EAAA;gBACL,EAAA,MAAA;eAGW,EAAA,MAAA;kBACD,EADC,IACD;EAAI,eAAA,EAAJ,IAAI;AAGtB,CAAA;AAA6B,KAAjB,iBAAA,GAAiB;MAEtB,EAAA,gBAAA;MACK,EADL,YACK;EAAI,SAAA,EAAJ,IAAI;AAGhB,CAAA;AAA4B,KAAhB,gBAAA,GAAmB,cAAH,GAAoB,iBAApB;AAAG,KAEnB,yBAAA,GAFmB;OAAiB,EAGxC,YAHwC,EAAA;EAAiB,QAAA,CAAA,EAIrD,gBAJqD,EAAA;EAErD,eAAA,CAAA,EAAA,MAAA;EAAyB,UAAA,CAAA,EAIvB,UAJuB;;AAEzB,KAKA,uBAAA,GAA0B,yBAL1B;;;AAKZ;AAuMA;;;AAAmC,cAAtB,kBAAsB,EAAA,CAAA;EAAA,KAAA;EAAA,QAAA;EAAA,eAAA;EAAA;AAAA,CAAA,EAKhC,yBALgC,EAAA,GAAA;OAAA,EAAA,eAAA,oBAAA,CAAA,EAAA;WAAA,KAAA,CAAA,MAAA,KAAA,CAAA,MAAA,CAAA,CAAA;oBAKhC,KAAA,CAAA,MAAA,EAAA,MAAA,CAAA"}

package/hooks/private/use-grouped-messages.js

@@ -0,0 +1,157 @@
+import { useMemo } from "react";
+import { SenderType } from "@cossistant/types";
+
+//#region src/hooks/private/use-grouped-messages.ts
+const getTimestamp = (date) => {
+	if (!date) return 0;
+	if (typeof date === "string") return new Date(date).getTime();
+	return date.getTime();
+};
+const toDate = (date) => {
+	if (!date) return /* @__PURE__ */ new Date();
+	if (typeof date === "string") return new Date(date);
+	return date;
+};
+const getSenderIdAndTypeFromTimelineItem = (item) => {
+	if (item.visitorId) return {
+		senderId: item.visitorId,
+		senderType: SenderType.VISITOR
+	};
+	if (item.aiAgentId) return {
+		senderId: item.aiAgentId,
+		senderType: SenderType.AI
+	};
+	if (item.userId) return {
+		senderId: item.userId,
+		senderType: SenderType.TEAM_MEMBER
+	};
+	return {
+		senderId: item.id || "default-sender",
+		senderType: SenderType.TEAM_MEMBER
+	};
+};
+const groupTimelineItems = (items) => {
+	const result = [];
+	let currentGroup = null;
+	for (const item of items) {
+		if (item.type === "event") {
+			if (currentGroup) {
+				result.push(currentGroup);
+				currentGroup = null;
+			}
+			result.push({
+				type: "timeline_event",
+				item,
+				timestamp: toDate(item.createdAt)
+			});
+			continue;
+		}
+		const { senderId, senderType } = getSenderIdAndTypeFromTimelineItem(item);
+		if (currentGroup && currentGroup.senderId === senderId) {
+			currentGroup.items.push(item);
+			currentGroup.lastMessageId = item.id || currentGroup.lastMessageId;
+			currentGroup.lastMessageTime = toDate(item.createdAt);
+		} else {
+			if (currentGroup) result.push(currentGroup);
+			currentGroup = {
+				type: "message_group",
+				senderId,
+				senderType,
+				items: [item],
+				firstMessageId: item.id || "",
+				lastMessageId: item.id || "",
+				firstMessageTime: toDate(item.createdAt),
+				lastMessageTime: toDate(item.createdAt)
+			};
+		}
+	}
+	if (currentGroup) result.push(currentGroup);
+	return result;
+};
+const buildTimelineReadReceiptData = (seenData, items) => {
+	const seenByMap = /* @__PURE__ */ new Map();
+	const lastReadMessageMap = /* @__PURE__ */ new Map();
+	const unreadCountMap = /* @__PURE__ */ new Map();
+	for (const item of items) if (item.type === "message" && item.id) seenByMap.set(item.id, /* @__PURE__ */ new Set());
+	const sortedItems = [...items].filter((item) => item.type === "message").sort((a, b) => getTimestamp(a.createdAt) - getTimestamp(b.createdAt));
+	for (const seen of seenData) {
+		let seenTime = getTimestamp(seen.updatedAt);
+		const viewerId = seen.userId || seen.visitorId || seen.aiAgentId;
+		if (!viewerId) continue;
+		const lastItemByViewer = sortedItems.filter((item) => {
+			if (seen.userId) return item.userId === viewerId;
+			if (seen.visitorId) return item.visitorId === viewerId;
+			if (seen.aiAgentId) return item.aiAgentId === viewerId;
+			return false;
+		}).at(-1);
+		if (lastItemByViewer) {
+			const lastItemTime = getTimestamp(lastItemByViewer.createdAt);
+			if (lastItemTime > seenTime) seenTime = lastItemTime;
+		}
+		let lastReadItem = null;
+		let unreadCount = 0;
+		let hasPassedLastSeen = false;
+		for (const item of sortedItems) if (getTimestamp(item.createdAt) <= seenTime && !hasPassedLastSeen) {
+			if (item.id) {
+				const seenBy = seenByMap.get(item.id);
+				if (seenBy) seenBy.add(viewerId);
+			}
+			lastReadItem = item;
+		} else {
+			hasPassedLastSeen = true;
+			unreadCount++;
+		}
+		if (lastReadItem?.id) lastReadMessageMap.set(viewerId, lastReadItem.id);
+		unreadCountMap.set(viewerId, unreadCount);
+	}
+	return {
+		seenByMap,
+		lastReadMessageMap,
+		unreadCountMap
+	};
+};
+/**
+* Batches sequential timeline items from the same sender into groups and enriches
+* them with read-receipt helpers so UIs can render conversation timelines with
+* minimal effort. Seen data is normalised into quick lookup maps for unread
+* indicators.
+*/
+const useGroupedMessages = ({ items, seenData = [], currentViewerId, viewerType }) => {
+	return useMemo(() => {
+		const groupedItems = groupTimelineItems(items);
+		const { seenByMap, lastReadMessageMap, unreadCountMap } = buildTimelineReadReceiptData(seenData, items);
+		return {
+			items: groupedItems,
+			seenByMap,
+			lastReadMessageMap,
+			unreadCountMap,
+			isMessageSeenByViewer: (messageId) => {
+				if (!currentViewerId) return false;
+				const seenBy = seenByMap.get(messageId);
+				return seenBy ? seenBy.has(currentViewerId) : false;
+			},
+			getMessageSeenBy: (messageId) => {
+				const seenBy = seenByMap.get(messageId);
+				return seenBy ? Array.from(seenBy) : [];
+			},
+			getLastReadMessageId: (userId) => lastReadMessageMap.get(userId),
+			isLastReadMessage: (messageId, userId) => lastReadMessageMap.get(userId) === messageId,
+			getUnreadCount: (userId) => unreadCountMap.get(userId) || 0,
+			hasUnreadAfter: (messageId, userId) => {
+				const lastRead = lastReadMessageMap.get(userId);
+				if (!lastRead) return true;
+				const messageIndex = items.findIndex((item) => item.id === messageId);
+				const lastReadIndex = items.findIndex((item) => item.id === lastRead);
+				return messageIndex < lastReadIndex;
+			}
+		};
+	}, [
+		items,
+		seenData,
+		currentViewerId
+	]);
+};
+
+//#endregion
+export { useGroupedMessages };
+//# sourceMappingURL=use-grouped-messages.js.map

package/hooks/private/use-grouped-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-grouped-messages.js","names":["result: Array<GroupedMessage | TimelineEventItem>","currentGroup: GroupedMessage | null","lastReadItem: TimelineItem | null"],"sources":["../../../src/hooks/private/use-grouped-messages.ts"],"sourcesContent":["import { SenderType } from \"@cossistant/types\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport type { ConversationSeen } from \"@cossistant/types/schemas\";\nimport { useMemo } from \"react\";\n\nexport type GroupedMessage = {\n\ttype: \"message_group\";\n\tsenderId: string;\n\tsenderType: SenderType;\n\titems: TimelineItem[];\n\tfirstMessageId: string;\n\tlastMessageId: string;\n\tfirstMessageTime: Date;\n\tlastMessageTime: Date;\n};\n\nexport type TimelineEventItem = {\n\ttype: \"timeline_event\";\n\titem: TimelineItem;\n\ttimestamp: Date;\n};\n\nexport type ConversationItem = GroupedMessage | TimelineEventItem;\n\nexport type UseGroupedMessagesOptions = {\n\titems: TimelineItem[];\n\tseenData?: ConversationSeen[];\n\tcurrentViewerId?: string; // The ID of the current viewer (visitor, user, or AI agent)\n\tviewerType?: SenderType; // Type of the current viewer\n};\n\nexport type UseGroupedMessagesProps = UseGroupedMessagesOptions;\n\n// Helper function to safely get timestamp from Date or string\nconst getTimestamp = (date: Date | string | null | undefined): number => {\n\tif (!date) {\n\t\treturn 0;\n\t}\n\tif (typeof date === \"string\") {\n\t\treturn new Date(date).getTime();\n\t}\n\treturn date.getTime();\n};\n\n// Helper function to safely convert to Date\nconst toDate = (date: Date | string | null | undefined): Date => {\n\tif (!date) {\n\t\treturn new Date();\n\t}\n\tif (typeof date === \"string\") {\n\t\treturn new Date(date);\n\t}\n\treturn date;\n};\n\n// Helper to determine sender ID and type from a timeline item\nconst getSenderIdAndTypeFromTimelineItem = (\n\titem: TimelineItem\n): { senderId: string; senderType: SenderType } => {\n\tif (item.visitorId) {\n\t\treturn { senderId: item.visitorId, senderType: SenderType.VISITOR };\n\t}\n\tif (item.aiAgentId) {\n\t\treturn { senderId: item.aiAgentId, senderType: SenderType.AI };\n\t}\n\tif (item.userId) {\n\t\treturn { senderId: item.userId, senderType: SenderType.TEAM_MEMBER };\n\t}\n\n\t// Fallback\n\treturn {\n\t\tsenderId: item.id || \"default-sender\",\n\t\tsenderType: SenderType.TEAM_MEMBER,\n\t};\n};\n\n// Helper function to group timeline items (messages only, events stay separate)\nconst groupTimelineItems = (\n\titems: TimelineItem[]\n): Array<GroupedMessage | TimelineEventItem> => {\n\tconst result: Array<GroupedMessage | TimelineEventItem> = [];\n\tlet currentGroup: GroupedMessage | null = null;\n\n\tfor (const item of items) {\n\t\t// Events don't get grouped\n\t\tif (item.type === \"event\") {\n\t\t\t// Finalize any existing group\n\t\t\tif (currentGroup) {\n\t\t\t\tresult.push(currentGroup);\n\t\t\t\tcurrentGroup = null;\n\t\t\t}\n\n\t\t\t// Add event as standalone item\n\t\t\tresult.push({\n\t\t\t\ttype: \"timeline_event\",\n\t\t\t\titem,\n\t\t\t\ttimestamp: toDate(item.createdAt),\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Group messages by sender\n\t\tconst { senderId, senderType } = getSenderIdAndTypeFromTimelineItem(item);\n\n\t\tif (currentGroup && currentGroup.senderId === senderId) {\n\t\t\t// Add to existing group\n\t\t\tcurrentGroup.items.push(item);\n\t\t\tcurrentGroup.lastMessageId = item.id || currentGroup.lastMessageId;\n\t\t\tcurrentGroup.lastMessageTime = toDate(item.createdAt);\n\t\t} else {\n\t\t\t// Finalize previous group if exists\n\t\t\tif (currentGroup) {\n\t\t\t\tresult.push(currentGroup);\n\t\t\t}\n\n\t\t\t// Start new group\n\t\t\tcurrentGroup = {\n\t\t\t\ttype: \"message_group\",\n\t\t\t\tsenderId,\n\t\t\t\tsenderType,\n\t\t\t\titems: [item],\n\t\t\t\tfirstMessageId: item.id || \"\",\n\t\t\t\tlastMessageId: item.id || \"\",\n\t\t\t\tfirstMessageTime: toDate(item.createdAt),\n\t\t\t\tlastMessageTime: toDate(item.createdAt),\n\t\t\t};\n\t\t}\n\t}\n\n\tif (currentGroup) {\n\t\tresult.push(currentGroup);\n\t}\n\n\treturn result;\n};\n\n// Build read receipt data for timeline items\nconst buildTimelineReadReceiptData = (\n\tseenData: ConversationSeen[],\n\titems: TimelineItem[]\n) => {\n\tconst seenByMap = new Map<string, Set<string>>();\n\tconst lastReadMessageMap = new Map<string, string>();\n\tconst unreadCountMap = new Map<string, number>();\n\n\t// Initialize map for all message-type timeline items\n\tfor (const item of items) {\n\t\tif (item.type === \"message\" && item.id) {\n\t\t\tseenByMap.set(item.id, new Set());\n\t\t}\n\t}\n\n\t// Sort items by time to process in order\n\tconst sortedItems = [...items]\n\t\t.filter((item) => item.type === \"message\")\n\t\t.sort((a, b) => getTimestamp(a.createdAt) - getTimestamp(b.createdAt));\n\n\t// Process seen data for each viewer\n\tfor (const seen of seenData) {\n\t\tlet seenTime = getTimestamp(seen.updatedAt);\n\t\tconst viewerId = seen.userId || seen.visitorId || seen.aiAgentId;\n\t\tif (!viewerId) {\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Find the last message sent by this viewer\n\t\tconst lastItemByViewer = sortedItems\n\t\t\t.filter((item) => {\n\t\t\t\tif (seen.userId) {\n\t\t\t\t\treturn item.userId === viewerId;\n\t\t\t\t}\n\t\t\t\tif (seen.visitorId) {\n\t\t\t\t\treturn item.visitorId === viewerId;\n\t\t\t\t}\n\t\t\t\tif (seen.aiAgentId) {\n\t\t\t\t\treturn item.aiAgentId === viewerId;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t})\n\t\t\t.at(-1);\n\n\t\tif (lastItemByViewer) {\n\t\t\tconst lastItemTime = getTimestamp(lastItemByViewer.createdAt);\n\t\t\tif (lastItemTime > seenTime) {\n\t\t\t\tseenTime = lastItemTime;\n\t\t\t}\n\t\t}\n\n\t\tlet lastReadItem: TimelineItem | null = null;\n\t\tlet unreadCount = 0;\n\t\tlet hasPassedLastSeen = false;\n\n\t\t// Process items in chronological order\n\t\tfor (const item of sortedItems) {\n\t\t\tconst itemTime = getTimestamp(item.createdAt);\n\n\t\t\tif (itemTime <= seenTime && !hasPassedLastSeen) {\n\t\t\t\t// This item has been seen\n\t\t\t\tif (item.id) {\n\t\t\t\t\tconst seenBy = seenByMap.get(item.id);\n\t\t\t\t\tif (seenBy) {\n\t\t\t\t\t\tseenBy.add(viewerId);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tlastReadItem = item;\n\t\t\t} else {\n\t\t\t\t// This item is unread\n\t\t\t\thasPassedLastSeen = true;\n\t\t\t\tunreadCount++;\n\t\t\t}\n\t\t}\n\n\t\t// Store the last read item for this viewer\n\t\tif (lastReadItem?.id) {\n\t\t\tlastReadMessageMap.set(viewerId, lastReadItem.id);\n\t\t}\n\n\t\t// Store unread count\n\t\tunreadCountMap.set(viewerId, unreadCount);\n\t}\n\n\treturn { seenByMap, lastReadMessageMap, unreadCountMap };\n};\n\n/**\n * Batches sequential timeline items from the same sender into groups and enriches\n * them with read-receipt helpers so UIs can render conversation timelines with\n * minimal effort. Seen data is normalised into quick lookup maps for unread\n * indicators.\n */\nexport const useGroupedMessages = ({\n\titems,\n\tseenData = [],\n\tcurrentViewerId,\n\tviewerType,\n}: UseGroupedMessagesOptions) => {\n\treturn useMemo(() => {\n\t\tconst groupedItems = groupTimelineItems(items);\n\n\t\t// Build read receipt data\n\t\tconst { seenByMap, lastReadMessageMap, unreadCountMap } =\n\t\t\tbuildTimelineReadReceiptData(seenData, items);\n\n\t\treturn {\n\t\t\titems: groupedItems,\n\t\t\tseenByMap,\n\t\t\tlastReadMessageMap,\n\t\t\tunreadCountMap,\n\n\t\t\tisMessageSeenByViewer: (messageId: string): boolean => {\n\t\t\t\tif (!currentViewerId) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tconst seenBy = seenByMap.get(messageId);\n\t\t\t\treturn seenBy ? seenBy.has(currentViewerId) : false;\n\t\t\t},\n\n\t\t\tgetMessageSeenBy: (messageId: string): string[] => {\n\t\t\t\tconst seenBy = seenByMap.get(messageId);\n\t\t\t\treturn seenBy ? Array.from(seenBy) : [];\n\t\t\t},\n\n\t\t\tgetLastReadMessageId: (userId: string): string | undefined =>\n\t\t\t\tlastReadMessageMap.get(userId),\n\n\t\t\tisLastReadMessage: (messageId: string, userId: string): boolean =>\n\t\t\t\tlastReadMessageMap.get(userId) === messageId,\n\n\t\t\tgetUnreadCount: (userId: string): number =>\n\t\t\t\tunreadCountMap.get(userId) || 0,\n\n\t\t\thasUnreadAfter: (messageId: string, userId: string): boolean => {\n\t\t\t\tconst lastRead = lastReadMessageMap.get(userId);\n\t\t\t\tif (!lastRead) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tconst messageIndex = items.findIndex((item) => item.id === messageId);\n\t\t\t\tconst lastReadIndex = items.findIndex((item) => item.id === lastRead);\n\n\t\t\t\treturn messageIndex < lastReadIndex;\n\t\t\t},\n\t\t};\n\t}, [items, seenData, currentViewerId]);\n};\n"],"mappings":"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"}

package/hooks/private/use-multimodal-input.d.ts

@@ -0,0 +1,40 @@
+//#region src/hooks/private/use-multimodal-input.d.ts
+type UseMultimodalInputOptions = {
+  onSubmit?: (data: {
+    message: string;
+    files: File[];
+  }) => void | Promise<void>;
+  onError?: (error: Error) => void;
+  maxFileSize?: number;
+  maxFiles?: number;
+  allowedFileTypes?: string[];
+};
+type UseMultimodalInputReturn = {
+  message: string;
+  files: File[];
+  isSubmitting: boolean;
+  error: Error | null;
+  setMessage: (message: string) => void;
+  addFiles: (files: File[]) => void;
+  removeFile: (index: number) => void;
+  clearFiles: () => void;
+  submit: () => Promise<void>;
+  reset: () => void;
+  isValid: boolean;
+  canSubmit: boolean;
+};
+/**
+ * Manages message text, file attachments and validation for the multimodal
+ * composer component. Provides ergonomic helpers for submit flows and error
+ * reporting.
+ */
+declare const useMultimodalInput: ({
+  onSubmit,
+  onError,
+  maxFileSize,
+  maxFiles,
+  allowedFileTypes
+}?: UseMultimodalInputOptions) => UseMultimodalInputReturn;
+//#endregion
+export { UseMultimodalInputOptions, UseMultimodalInputReturn, useMultimodalInput };
+//# sourceMappingURL=use-multimodal-input.d.ts.map

package/hooks/private/use-multimodal-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-multimodal-input.d.ts","names":[],"sources":["../../../src/hooks/private/use-multimodal-input.ts"],"sourcesContent":[],"mappings":";KAEY,yBAAA;EAAA,QAAA,CAAA,EAAA,CAAA,IAAA,EAAA;IAAyB,OAAA,EAAA,MAAA;IACQ,KAAA,EAAA,IAAA,EAAA;KAAoB,GAAA,IAAA,GAAA,OAAA,CAAA,IAAA,CAAA;SAC9C,CAAA,EAAA,CAAA,KAAA,EAAA,KAAA,EAAA,GAAA,IAAA;EAAK,WAAA,CAAA,EAAA,MAAA;EAMZ,QAAA,CAAA,EAAA,MAAA;EAAwB,gBAAA,CAAA,EAAA,MAAA,EAAA;;AAK5B,KALI,wBAAA,GAKJ;SAIW,EAAA,MAAA;OAGJ,EATP,IASO,EAAA;EAAO,YAAA,EAAA,OAAA;EAaT,KAAA,EApBL,KAoBK,GAAA,IAAA;EA4JZ,UAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAAA,IAAA;UA5JkC,EAAA,CAAA,KAAA,EAhBhB,IAgBgB,EAAA,EAAA,GAAA,IAAA;YAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,IAAA;YAAA,EAAA,GAAA,GAAA,IAAA;QAAA,EAAA,GAAA,GAbpB,OAaoB,CAAA,IAAA,CAAA;OAAA,EAAA,GAAA,GAAA,IAAA;SAMhC,EAAA,OAAA;WAAiC,EAAA,OAAA;CAsJnC;;;;;;cA5JY;;;;;;IAMV,8BAAiC"}

package/hooks/private/use-multimodal-input.js

@@ -0,0 +1,129 @@
+import { useCallback, useRef, useState } from "react";
+
+//#region src/hooks/private/use-multimodal-input.ts
+/**
+* Manages message text, file attachments and validation for the multimodal
+* composer component. Provides ergonomic helpers for submit flows and error
+* reporting.
+*/
+const useMultimodalInput = ({ onSubmit, onError, maxFileSize = 10 * 1024 * 1024, maxFiles = 5, allowedFileTypes = [
+	"image/*",
+	"application/pdf",
+	"text/*"
+] } = {}) => {
+	const [message, setMessage] = useState("");
+	const [files, setFiles] = useState([]);
+	const [isSubmitting, setIsSubmitting] = useState(false);
+	const [error, setError] = useState(null);
+	const fileUrlsRef = useRef([]);
+	const validateFile = useCallback((file) => {
+		if (file.size > maxFileSize) return `File "${file.name}" exceeds maximum size of ${maxFileSize / 1024 / 1024}MB`;
+		if (allowedFileTypes.length > 0) {
+			if (!allowedFileTypes.some((type) => {
+				if (type.endsWith("/*")) {
+					const baseType = type.slice(0, -2);
+					return file.type.startsWith(baseType);
+				}
+				return file.type === type;
+			})) return `File type "${file.type}" is not allowed`;
+		}
+		return null;
+	}, [maxFileSize, allowedFileTypes]);
+	const addFiles = useCallback((newFiles) => {
+		setError(null);
+		if (files.length + newFiles.length > maxFiles) {
+			const err = /* @__PURE__ */ new Error(`Cannot add files: maximum ${maxFiles} files allowed`);
+			setError(err);
+			onError?.(err);
+			return;
+		}
+		for (const file of newFiles) {
+			const validationError = validateFile(file);
+			if (validationError) {
+				const err = new Error(validationError);
+				setError(err);
+				onError?.(err);
+				return;
+			}
+		}
+		setFiles((prev) => [...prev, ...newFiles]);
+	}, [
+		files.length,
+		maxFiles,
+		validateFile,
+		onError
+	]);
+	const removeFile = useCallback((index) => {
+		setFiles((prev) => {
+			const newFiles = [...prev];
+			newFiles.splice(index, 1);
+			if (fileUrlsRef.current[index]) {
+				URL.revokeObjectURL(fileUrlsRef.current[index]);
+				fileUrlsRef.current.splice(index, 1);
+			}
+			return newFiles;
+		});
+		setError(null);
+	}, []);
+	const clearFiles = useCallback(() => {
+		for (const url of fileUrlsRef.current) URL.revokeObjectURL(url);
+		fileUrlsRef.current = [];
+		setFiles([]);
+		setError(null);
+	}, []);
+	const reset = useCallback(() => {
+		setMessage("");
+		clearFiles();
+		setError(null);
+		setIsSubmitting(false);
+	}, [clearFiles]);
+	const submit = useCallback(async () => {
+		if (!onSubmit) return;
+		if (!message.trim() && files.length === 0) {
+			const err = /* @__PURE__ */ new Error("Please provide a message or attach files");
+			setError(err);
+			onError?.(err);
+			return;
+		}
+		setIsSubmitting(true);
+		setError(null);
+		try {
+			await onSubmit({
+				message: message.trim(),
+				files
+			});
+			reset();
+		} catch (err) {
+			const _error = err instanceof Error ? err : /* @__PURE__ */ new Error("Failed to submit");
+			setError(_error);
+			onError?.(_error);
+		} finally {
+			setIsSubmitting(false);
+		}
+	}, [
+		message,
+		files,
+		onSubmit,
+		onError,
+		reset
+	]);
+	const isValid = message.trim().length > 0 || files.length > 0;
+	return {
+		message,
+		files,
+		isSubmitting,
+		error,
+		setMessage,
+		addFiles,
+		removeFile,
+		clearFiles,
+		submit,
+		reset,
+		isValid,
+		canSubmit: isValid && !isSubmitting && !error
+	};
+};
+
+//#endregion
+export { useMultimodalInput };
+//# sourceMappingURL=use-multimodal-input.js.map

package/hooks/private/use-multimodal-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-multimodal-input.js","names":[],"sources":["../../../src/hooks/private/use-multimodal-input.ts"],"sourcesContent":["import { useCallback, useRef, useState } from \"react\";\n\nexport type UseMultimodalInputOptions = {\n\tonSubmit?: (data: { message: string; files: File[] }) => void | Promise<void>;\n\tonError?: (error: Error) => void;\n\tmaxFileSize?: number; // in bytes\n\tmaxFiles?: number;\n\tallowedFileTypes?: string[]; // MIME types\n};\n\nexport type UseMultimodalInputReturn = {\n\t// State\n\tmessage: string;\n\tfiles: File[];\n\tisSubmitting: boolean;\n\terror: Error | null;\n\n\t// Actions\n\tsetMessage: (message: string) => void;\n\taddFiles: (files: File[]) => void;\n\tremoveFile: (index: number) => void;\n\tclearFiles: () => void;\n\tsubmit: () => Promise<void>;\n\treset: () => void;\n\n\t// Validation\n\tisValid: boolean;\n\tcanSubmit: boolean;\n};\n\n/**\n * Manages message text, file attachments and validation for the multimodal\n * composer component. Provides ergonomic helpers for submit flows and error\n * reporting.\n */\nexport const useMultimodalInput = ({\n\tonSubmit,\n\tonError,\n\tmaxFileSize = 10 * 1024 * 1024, // 10MB default\n\tmaxFiles = 5,\n\tallowedFileTypes = [\"image/*\", \"application/pdf\", \"text/*\"],\n}: UseMultimodalInputOptions = {}): UseMultimodalInputReturn => {\n\tconst [message, setMessage] = useState(\"\");\n\tconst [files, setFiles] = useState<File[]>([]);\n\tconst [isSubmitting, setIsSubmitting] = useState(false);\n\tconst [error, setError] = useState<Error | null>(null);\n\n\t// Use ref to prevent re-renders when tracking file URLs\n\tconst fileUrlsRef = useRef<string[]>([]);\n\n\t// Validation helpers\n\tconst validateFile = useCallback(\n\t\t(file: File): string | null => {\n\t\t\tif (file.size > maxFileSize) {\n\t\t\t\treturn `File \"${file.name}\" exceeds maximum size of ${maxFileSize / 1024 / 1024}MB`;\n\t\t\t}\n\n\t\t\tif (allowedFileTypes.length > 0) {\n\t\t\t\tconst isAllowed = allowedFileTypes.some((type) => {\n\t\t\t\t\tif (type.endsWith(\"/*\")) {\n\t\t\t\t\t\tconst baseType = type.slice(0, -2);\n\t\t\t\t\t\treturn file.type.startsWith(baseType);\n\t\t\t\t\t}\n\t\t\t\t\treturn file.type === type;\n\t\t\t\t});\n\n\t\t\t\tif (!isAllowed) {\n\t\t\t\t\treturn `File type \"${file.type}\" is not allowed`;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn null;\n\t\t},\n\t\t[maxFileSize, allowedFileTypes]\n\t);\n\n\t// Actions\n\tconst addFiles = useCallback(\n\t\t(newFiles: File[]) => {\n\t\t\tsetError(null);\n\n\t\t\t// Check max files limit\n\t\t\tif (files.length + newFiles.length > maxFiles) {\n\t\t\t\tconst err = new Error(\n\t\t\t\t\t`Cannot add files: maximum ${maxFiles} files allowed`\n\t\t\t\t);\n\t\t\t\tsetError(err);\n\t\t\t\tonError?.(err);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Validate each file\n\t\t\tfor (const file of newFiles) {\n\t\t\t\tconst validationError = validateFile(file);\n\t\t\t\tif (validationError) {\n\t\t\t\t\tconst err = new Error(validationError);\n\t\t\t\t\tsetError(err);\n\t\t\t\t\tonError?.(err);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tsetFiles((prev) => [...prev, ...newFiles]);\n\t\t},\n\t\t[files.length, maxFiles, validateFile, onError]\n\t);\n\n\tconst removeFile = useCallback((index: number) => {\n\t\tsetFiles((prev) => {\n\t\t\tconst newFiles = [...prev];\n\t\t\tnewFiles.splice(index, 1);\n\n\t\t\t// Clean up object URL if it exists\n\t\t\tif (fileUrlsRef.current[index]) {\n\t\t\t\tURL.revokeObjectURL(fileUrlsRef.current[index]);\n\t\t\t\tfileUrlsRef.current.splice(index, 1);\n\t\t\t}\n\n\t\t\treturn newFiles;\n\t\t});\n\t\tsetError(null);\n\t}, []);\n\n\tconst clearFiles = useCallback(() => {\n\t\t// Clean up all object URLs\n\t\tfor (const url of fileUrlsRef.current) {\n\t\t\tURL.revokeObjectURL(url);\n\t\t}\n\t\tfileUrlsRef.current = [];\n\n\t\tsetFiles([]);\n\t\tsetError(null);\n\t}, []);\n\n\tconst reset = useCallback(() => {\n\t\tsetMessage(\"\");\n\t\tclearFiles();\n\t\tsetError(null);\n\t\tsetIsSubmitting(false);\n\t}, [clearFiles]);\n\n\tconst submit = useCallback(async () => {\n\t\tif (!onSubmit) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (!message.trim() && files.length === 0) {\n\t\t\tconst err = new Error(\"Please provide a message or attach files\");\n\t\t\tsetError(err);\n\t\t\tonError?.(err);\n\t\t\treturn;\n\t\t}\n\n\t\tsetIsSubmitting(true);\n\t\tsetError(null);\n\n\t\ttry {\n\t\t\tawait onSubmit({ message: message.trim(), files });\n\t\t\treset();\n\t\t} catch (err) {\n\t\t\tconst _error = err instanceof Error ? err : new Error(\"Failed to submit\");\n\t\t\tsetError(_error);\n\t\t\tonError?.(_error);\n\t\t} finally {\n\t\t\tsetIsSubmitting(false);\n\t\t}\n\t}, [message, files, onSubmit, onError, reset]);\n\n\t// Computed values\n\tconst isValid = message.trim().length > 0 || files.length > 0;\n\tconst canSubmit = isValid && !isSubmitting && !error;\n\n\treturn {\n\t\t// State\n\t\tmessage,\n\t\tfiles,\n\t\tisSubmitting,\n\t\terror,\n\n\t\t// Actions\n\t\tsetMessage,\n\t\taddFiles,\n\t\tremoveFile,\n\t\tclearFiles,\n\t\tsubmit,\n\t\treset,\n\n\t\t// Validation\n\t\tisValid,\n\t\tcanSubmit,\n\t};\n};\n"],"mappings":"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"}