@cossistant/react 0.0.32 → 0.0.33

package/hooks/index.d.ts

@@ -1,6 +1,6 @@
 import { useClientQuery } from "./private/use-client-query.js";
 import { useDefaultMessages } from "./private/use-default-messages.js";
-import { ConversationItem, DaySeparatorItem, GroupedMessage, TimelineEventItem, TimelineToolItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, useGroupedMessages } from "./private/use-grouped-messages.js";
+import { ConversationItem, DaySeparatorItem, GroupedActivity, GroupedMessage, PreparedTimelineItems, TIMELINE_GROUP_WINDOW_MS, TimelineEventItem, TimelineToolItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, buildTimelineReadReceiptData, groupTimelineItems, prepareTimelineItems, useGroupedMessages } from "./private/use-grouped-messages.js";
 import { UseMultimodalInputOptions, UseMultimodalInputReturn, useMultimodalInput } from "./private/use-multimodal-input.js";
 import { ConfigurationError, UseClientResult, useClient } from "./private/use-rest-client.js";
 import { UseComposerRefocusOptions, UseComposerRefocusReturn, useComposerRefocus } from "./use-composer-refocus.js";
@@ -27,4 +27,4 @@ import { UseSoundEffectOptions, UseSoundEffectReturn, useSoundEffect } from "./u
 import { useTypingSound } from "./use-typing-sound.js";
 import { UseVisitorReturn, useVisitor } from "./use-visitor.js";
 import { WindowVisibilityFocusState, useWindowVisibilityFocus } from "./use-window-visibility-focus.js";
-export { CONVERSATION_AUTO_SEEN_DELAY_MS, ConfigurationError, ConversationItem, ConversationLifecycleState, ConversationPreviewAssignedAgent, ConversationPreviewLastMessage, ConversationPreviewTypingParticipant, ConversationPreviewTypingState, ConversationTimelineTypingParticipant, ConversationTypingParticipant, CreateConversationVariables, DaySeparatorItem, FileUploadPart, GroupedMessage, SendMessageOptions, SendMessageResult, TimelineEventItem, TimelineToolItem, UseClientResult, UseComposerRefocusOptions, UseComposerRefocusReturn, UseConversationAutoSeenOptions, UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, UseConversationLifecycleOptions, UseConversationLifecycleReturn, UseConversationOptions, UseConversationPageOptions, UseConversationPageReturn, UseConversationPreviewOptions, UseConversationPreviewReturn, UseConversationResult, UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, UseConversationTimelineOptions, UseConversationTimelineReturn, UseConversationsOptions, UseConversationsResult, UseCreateConversationOptions, UseCreateConversationResult, UseFileUploadOptions, UseFileUploadReturn, UseGroupedMessagesOptions, UseGroupedMessagesProps, UseHomePageOptions, UseHomePageReturn, UseMessageComposerOptions, UseMessageComposerReturn, UseMultimodalInputOptions, UseMultimodalInputReturn, UseRealtimeSupportOptions, UseRealtimeSupportResult, UseScrollMaskOptions, UseScrollMaskReturn, UseSendMessageOptions, UseSendMessageResult, UseSoundEffectOptions, UseSoundEffectReturn, UseVisitorReturn, WindowVisibilityFocusState, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useFileUpload, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useNewMessageSound, useRealtimeSupport, useScrollMask, useSendMessage, useSoundEffect, useTypingSound, useVisitor, useWindowVisibilityFocus };
+export { CONVERSATION_AUTO_SEEN_DELAY_MS, ConfigurationError, ConversationItem, ConversationLifecycleState, ConversationPreviewAssignedAgent, ConversationPreviewLastMessage, ConversationPreviewTypingParticipant, ConversationPreviewTypingState, ConversationTimelineTypingParticipant, ConversationTypingParticipant, CreateConversationVariables, DaySeparatorItem, FileUploadPart, GroupedActivity, GroupedMessage, PreparedTimelineItems, SendMessageOptions, SendMessageResult, TIMELINE_GROUP_WINDOW_MS, TimelineEventItem, TimelineToolItem, UseClientResult, UseComposerRefocusOptions, UseComposerRefocusReturn, UseConversationAutoSeenOptions, UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, UseConversationLifecycleOptions, UseConversationLifecycleReturn, UseConversationOptions, UseConversationPageOptions, UseConversationPageReturn, UseConversationPreviewOptions, UseConversationPreviewReturn, UseConversationResult, UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, UseConversationTimelineOptions, UseConversationTimelineReturn, UseConversationsOptions, UseConversationsResult, UseCreateConversationOptions, UseCreateConversationResult, UseFileUploadOptions, UseFileUploadReturn, UseGroupedMessagesOptions, UseGroupedMessagesProps, UseHomePageOptions, UseHomePageReturn, UseMessageComposerOptions, UseMessageComposerReturn, UseMultimodalInputOptions, UseMultimodalInputReturn, UseRealtimeSupportOptions, UseRealtimeSupportResult, UseScrollMaskOptions, UseScrollMaskReturn, UseSendMessageOptions, UseSendMessageResult, UseSoundEffectOptions, UseSoundEffectReturn, UseVisitorReturn, WindowVisibilityFocusState, buildTimelineReadReceiptData, groupTimelineItems, prepareTimelineItems, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useFileUpload, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useNewMessageSound, useRealtimeSupport, useScrollMask, useSendMessage, useSoundEffect, useTypingSound, useVisitor, useWindowVisibilityFocus };

package/hooks/index.js

@@ -12,7 +12,7 @@ import { useMultimodalInput } from "./private/use-multimodal-input.js";
 import { useSendMessage } from "./use-send-message.js";
 import { useMessageComposer } from "./use-message-composer.js";
 import { useConversationPage } from "./use-conversation-page.js";
-import { useGroupedMessages } from "./private/use-grouped-messages.js";
+import { TIMELINE_GROUP_WINDOW_MS, buildTimelineReadReceiptData, groupTimelineItems, prepareTimelineItems, useGroupedMessages } from "./private/use-grouped-messages.js";
 import { useConversationSeen, useDebouncedConversationSeen } from "./use-conversation-seen.js";
 import { useConversationTyping } from "./use-conversation-typing.js";
 import { useConversationTimeline } from "./use-conversation-timeline.js";
@@ -28,4 +28,4 @@ import { useCreateConversation } from "./use-create-conversation.js";
 import { useFileUpload } from "./use-file-upload.js";
 import { useRealtimeSupport } from "./use-realtime-support.js";
 
-export { CONVERSATION_AUTO_SEEN_DELAY_MS, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useFileUpload, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useNewMessageSound, useRealtimeSupport, useScrollMask, useSendMessage, useSoundEffect, useTypingSound, useVisitor, useWindowVisibilityFocus };
+export { CONVERSATION_AUTO_SEEN_DELAY_MS, TIMELINE_GROUP_WINDOW_MS, buildTimelineReadReceiptData, groupTimelineItems, prepareTimelineItems, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useFileUpload, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useNewMessageSound, useRealtimeSupport, useScrollMask, useSendMessage, useSoundEffect, useTypingSound, useVisitor, useWindowVisibilityFocus };

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

@@ -13,6 +13,18 @@ type GroupedMessage = {
   firstMessageTime: Date;
   lastMessageTime: Date;
 };
+type GroupedActivity = {
+  type: "activity_group";
+  senderId: string;
+  senderType: SenderType;
+  items: TimelineItem[];
+  firstItemId: string;
+  lastItemId: string;
+  firstItemTime: Date;
+  lastItemTime: Date;
+  hasEvent: boolean;
+  hasTool: boolean;
+};
 type TimelineEventItem = {
   type: "timeline_event";
   item: TimelineItem;
@@ -29,13 +41,26 @@ type DaySeparatorItem = {
   date: Date;
   dateString: string;
 };
-type ConversationItem = GroupedMessage | TimelineEventItem | TimelineToolItem | DaySeparatorItem;
+type ConversationItem = GroupedMessage | GroupedActivity | TimelineEventItem | TimelineToolItem | DaySeparatorItem;
 type UseGroupedMessagesOptions = {
   items: TimelineItem[];
   seenData?: ConversationSeen[];
   currentViewerId?: string;
 };
 type UseGroupedMessagesProps = UseGroupedMessagesOptions;
+type PreparedTimelineItems = {
+  items: TimelineItem[];
+  times: number[];
+  didSort: boolean;
+};
+declare const TIMELINE_GROUP_WINDOW_MS: number;
+declare const prepareTimelineItems: (items: TimelineItem[]) => PreparedTimelineItems;
+declare const groupTimelineItems: (items: TimelineItem[], itemTimes: number[]) => ConversationItem[];
+declare const buildTimelineReadReceiptData: (seenData: ConversationSeen[], sortedMessageItems: TimelineItem[], sortedMessageTimes: number[]) => {
+  seenByMap: Map<string, Set<string>>;
+  lastReadMessageMap: Map<string, string>;
+  unreadCountMap: Map<string, number>;
+};
 /**
  * Batches sequential timeline items from the same sender into groups and enriches
  * them with read-receipt helpers so UIs can render conversation timelines with
@@ -59,5 +84,5 @@ declare const useGroupedMessages: ({
   hasUnreadAfter: (messageId: string, userId: string) => boolean;
 };
 //#endregion
-export { ConversationItem, DaySeparatorItem, GroupedMessage, TimelineEventItem, TimelineToolItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, useGroupedMessages };
+export { ConversationItem, DaySeparatorItem, GroupedActivity, GroupedMessage, PreparedTimelineItems, TIMELINE_GROUP_WINDOW_MS, TimelineEventItem, TimelineToolItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, buildTimelineReadReceiptData, groupTimelineItems, prepareTimelineItems, useGroupedMessages };
 //# sourceMappingURL=use-grouped-messages.d.ts.map

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

@@ -1 +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;EAGC,UAAA,EAAA,UAAA;EACL,KAAA,EAAA,YAAA,EAAA;EAGW,cAAA,EAAA,MAAA;EACD,aAAA,EAAA,MAAA;EAAI,gBAAA,EADH,IACG;EAGV,eAAA,EAHM,IAGW;AAM7B,CAAA;AAOY,KAbA,iBAAA,GAagB;EAMhB,IAAA,EAAA,gBAAgB;EACzB,IAAA,EAlBI,YAkBJ;EACA,SAAA,EAlBS,IAkBT;CACA;AACA,KAjBS,gBAAA,GAiBT;EAAgB,IAAA,EAAA,eAAA;EAEP,IAAA,EAjBL,YAiBK;EAMA,IAAA,EAAA,MAAA,GAAA,IAAA;EAmQC,SAAA,EAxRD,IAwRC;CAAsB;AAAA,KArRvB,gBAAA,GAqRuB;EAAA,IAAA,EAAA,eAAA;EAIhC,IAAA,EAvRI,IAuRJ;;;KAnRS,gBAAA,GACT,iBACA,oBACA,mBACA;KAES,yBAAA;SACJ;aACI;;;KAIA,uBAAA,GAA0B;;;;;;;cAmQzB;;;;GAIV"}
+{"version":3,"file":"use-grouped-messages.d.ts","names":[],"sources":["../../../src/hooks/private/use-grouped-messages.ts"],"sourcesContent":[],"mappings":";;;;;KAMY,cAAA;;EAAA,QAAA,EAAA,MAAA;EAGC,UAAA,EAAA,UAAA;EACL,KAAA,EAAA,YAAA,EAAA;EAGW,cAAA,EAAA,MAAA;EACD,aAAA,EAAA,MAAA;EAAI,gBAAA,EADH,IACG;EAGV,eAAA,EAHM,IAGS;CAGd;AACL,KAJI,eAAA,GAIJ;EAGQ,IAAA,EAAA,gBAAA;EACD,QAAA,EAAA,MAAA;EAAI,UAAA,EALN,UAKM;EAKP,KAAA,EATJ,YASI,EAAiB;EAMjB,WAAA,EAAA,MAAgB;EAOhB,UAAA,EAAA,MAAA;EAMA,aAAA,EAzBI,IAyBY;EACzB,YAAA,EAzBY,IAyBZ;EACA,QAAA,EAAA,OAAA;EACA,OAAA,EAAA,OAAA;CACA;AACA,KAxBS,iBAAA,GAwBT;EAAgB,IAAA,EAAA,gBAAA;EAEP,IAAA,EAxBL,YAwBK;EAMA,SAAA,EA7BA,IA6BA;AAEZ,CAAA;AAMa,KAlCD,gBAAA,GAkCyC;EA2ExC,IAAA,EAAA,eAAA;EAmEA,IAAA,EA9KN,YA8KM;EAiKA,IAAA,EAAA,MAAA,GAAA,IAAA;EACF,SAAA,EA9UC,IA8UD;CACU;KA5UT,gBAAA;;QAEL;;;AA0YM,KAtYD,gBAAA,GACT,cAyeF,GAxeE,eAweF,GAveE,iBAueF,GAteE,gBAseF,GAreE,gBAqeF;AApGkC,KA/XvB,yBAAA,GA+XuB;EAAA,KAAA,EA9X3B,YA8X2B,EAAA;EAAA,QAAA,CAAA,EA7XvB,gBA6XuB,EAAA;EAIhC,eAAA,CAAA,EAAA,MAAA;;KA7XS,uBAAA,GAA0B;KAE1B,qBAAA;SACJ;;;;cAKK;cA2EA,8BACL,mBACL;cAiEU,4BACL,wCAEL;cA8JU,yCACF,wCACU;;;;;;;;;;;cAgER;;;;GAIV"}

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

@@ -1,17 +1,13 @@
+import { getTimelineItemSender } from "../../utils/timeline-item-sender.js";
 import { useMemo } from "react";
-import { SenderType } from "@cossistant/types";
 
 //#region src/hooks/private/use-grouped-messages.ts
+const TIMELINE_GROUP_WINDOW_MS = 300 * 1e3;
 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 typeof window !== "undefined" ? /* @__PURE__ */ new Date() : /* @__PURE__ */ new Date(0);
-	if (typeof date === "string") return new Date(date);
-	return date;
-};
 const getDateString = (date) => {
 	return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
 };
@@ -19,69 +15,144 @@ const createDayDate = (dateString) => {
 	const [year, month, day] = dateString.split("-").map(Number);
 	return new Date(year ?? 0, (month ?? 1) - 1, day ?? 1, 0, 0, 0, 0);
 };
-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 getToolNameFromTimelineItem = (item) => {
 	if (item.tool) return item.tool;
 	for (const part of item.parts) if (typeof part === "object" && part !== null && "type" in part && "toolName" in part && typeof part.type === "string" && part.type.startsWith("tool-") && typeof part.toolName === "string") return part.toolName;
 	return null;
 };
 const EMPTY_STRING_ARRAY = Object.freeze([]);
-const groupTimelineItems = (items) => {
+function getGroupableTimelineItemType(item) {
+	if (item.type === "message") return "message";
+	if (item.type === "event" || item.type === "tool") return "activity";
+	if (item.type === "identification") return "standalone_tool";
+	return "standalone_event";
+}
+const prepareTimelineItems = (items) => {
+	if (items.length <= 1) return {
+		items,
+		times: items.map((item) => getTimestamp(item.createdAt)),
+		didSort: false
+	};
+	const times = new Array(items.length);
+	let isSorted = true;
+	for (let index = 0; index < items.length; index++) {
+		const item = items[index];
+		const time = getTimestamp(item?.createdAt);
+		times[index] = time;
+		if (index === 0) continue;
+		const previousTime = times[index - 1];
+		if (previousTime !== void 0 && time !== void 0 && time < previousTime) isSorted = false;
+	}
+	if (isSorted) return {
+		items,
+		times,
+		didSort: false
+	};
+	const entries = items.map((item, index) => ({
+		item,
+		time: times[index] ?? 0,
+		index
+	}));
+	entries.sort((a, b) => {
+		if (a.time === b.time) return a.index - b.index;
+		return a.time - b.time;
+	});
+	return {
+		items: entries.map((entry) => entry.item),
+		times: entries.map((entry) => entry.time),
+		didSort: true
+	};
+};
+const isWithinGroupingWindow = (previousTimestamp, currentTimestamp) => currentTimestamp - previousTimestamp <= TIMELINE_GROUP_WINDOW_MS;
+const groupTimelineItems = (items, itemTimes) => {
 	const result = [];
-	let currentGroup = null;
+	let currentMessageGroup = null;
+	let currentActivityGroup = null;
 	let currentDayString = null;
+	const flushMessageGroup = () => {
+		if (!currentMessageGroup) return;
+		result.push(currentMessageGroup);
+		currentMessageGroup = null;
+	};
+	const flushActivityGroup = () => {
+		if (!currentActivityGroup) return;
+		result.push(currentActivityGroup);
+		currentActivityGroup = null;
+	};
+	const flushAllGroups = () => {
+		flushMessageGroup();
+		flushActivityGroup();
+	};
 	const maybeInsertDaySeparator = (itemDate) => {
 		const itemDayString = getDateString(itemDate);
-		if (currentDayString !== itemDayString) {
-			if (currentGroup) {
-				result.push(currentGroup);
-				currentGroup = null;
-			}
-			result.push({
-				type: "day_separator",
-				date: createDayDate(itemDayString),
-				dateString: itemDayString
-			});
-			currentDayString = itemDayString;
-		}
+		if (currentDayString === itemDayString) return;
+		flushAllGroups();
+		result.push({
+			type: "day_separator",
+			date: createDayDate(itemDayString),
+			dateString: itemDayString
+		});
+		currentDayString = itemDayString;
 	};
-	for (const item of items) {
-		const itemDate = toDate(item.createdAt);
+	for (let index = 0; index < items.length; index++) {
+		const item = items[index];
+		if (!item) continue;
+		const itemTimestamp = itemTimes[index] ?? getTimestamp(item.createdAt);
+		const itemDate = new Date(itemTimestamp);
 		maybeInsertDaySeparator(itemDate);
-		if (item.type === "event") {
-			if (currentGroup) {
-				result.push(currentGroup);
-				currentGroup = null;
+		const groupableType = getGroupableTimelineItemType(item);
+		if (groupableType === "message") {
+			flushActivityGroup();
+			const { senderId, senderType } = getTimelineItemSender(item);
+			const previousTimestamp = currentMessageGroup?.lastMessageTime.getTime();
+			if (Boolean(currentMessageGroup && currentMessageGroup.senderId === senderId && previousTimestamp !== void 0 && isWithinGroupingWindow(previousTimestamp, itemTimestamp)) && currentMessageGroup) {
+				currentMessageGroup.items.push(item);
+				currentMessageGroup.lastMessageId = item.id || currentMessageGroup.lastMessageId;
+				currentMessageGroup.lastMessageTime = itemDate;
+				continue;
 			}
-			result.push({
-				type: "timeline_event",
-				item,
-				timestamp: itemDate
-			});
+			flushMessageGroup();
+			currentMessageGroup = {
+				type: "message_group",
+				senderId,
+				senderType,
+				items: [item],
+				firstMessageId: item.id || "",
+				lastMessageId: item.id || "",
+				firstMessageTime: itemDate,
+				lastMessageTime: itemDate
+			};
 			continue;
 		}
-		if (item.type === "identification" || item.type === "tool") {
-			if (currentGroup) {
-				result.push(currentGroup);
-				currentGroup = null;
+		if (groupableType === "activity") {
+			flushMessageGroup();
+			const { senderId, senderType } = getTimelineItemSender(item);
+			const previousTimestamp = currentActivityGroup?.lastItemTime.getTime();
+			if (Boolean(currentActivityGroup && currentActivityGroup.senderId === senderId && previousTimestamp !== void 0 && isWithinGroupingWindow(previousTimestamp, itemTimestamp)) && currentActivityGroup) {
+				currentActivityGroup.items.push(item);
+				currentActivityGroup.lastItemId = item.id || currentActivityGroup.lastItemId;
+				currentActivityGroup.lastItemTime = itemDate;
+				currentActivityGroup.hasEvent = currentActivityGroup.hasEvent || item.type === "event";
+				currentActivityGroup.hasTool = currentActivityGroup.hasTool || item.type === "tool";
+				continue;
 			}
+			flushActivityGroup();
+			currentActivityGroup = {
+				type: "activity_group",
+				senderId,
+				senderType,
+				items: [item],
+				firstItemId: item.id || "",
+				lastItemId: item.id || "",
+				firstItemTime: itemDate,
+				lastItemTime: itemDate,
+				hasEvent: item.type === "event",
+				hasTool: item.type === "tool"
+			};
+			continue;
+		}
+		flushAllGroups();
+		if (groupableType === "standalone_tool") {
 			result.push({
 				type: "timeline_tool",
 				item,
@@ -90,33 +161,25 @@ const groupTimelineItems = (items) => {
 			});
 			continue;
 		}
-		const { senderId, senderType } = getSenderIdAndTypeFromTimelineItem(item);
-		if (currentGroup && currentGroup.senderId === senderId) {
-			currentGroup.items.push(item);
-			currentGroup.lastMessageId = item.id || currentGroup.lastMessageId;
-			currentGroup.lastMessageTime = itemDate;
-		} else {
-			if (currentGroup) result.push(currentGroup);
-			currentGroup = {
-				type: "message_group",
-				senderId,
-				senderType,
-				items: [item],
-				firstMessageId: item.id || "",
-				lastMessageId: item.id || "",
-				firstMessageTime: itemDate,
-				lastMessageTime: itemDate
-			};
-		}
+		result.push({
+			type: "timeline_event",
+			item,
+			timestamp: itemDate
+		});
 	}
-	if (currentGroup) result.push(currentGroup);
+	flushAllGroups();
 	return result;
 };
-const buildTimelineReadReceiptData = (seenData, items, sortedMessageItems, sortedMessageTimes) => {
+const buildTimelineReadReceiptData = (seenData, sortedMessageItems, sortedMessageTimes) => {
 	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());
+	for (const item of sortedMessageItems) if (item.id) seenByMap.set(item.id, /* @__PURE__ */ new Set());
+	if (seenData.length === 0 || sortedMessageItems.length === 0) return {
+		seenByMap,
+		lastReadMessageMap,
+		unreadCountMap
+	};
 	for (const seen of seenData) {
 		const seenTime = getTimestamp(seen.lastSeenAt);
 		const viewerId = seen.userId || seen.visitorId || seen.aiAgentId;
@@ -127,12 +190,11 @@ const buildTimelineReadReceiptData = (seenData, items, sortedMessageItems, sorte
 			const item = sortedMessageItems[index];
 			if (!item) continue;
 			if ((sortedMessageTimes[index] ?? getTimestamp(item.createdAt)) <= seenTime) {
-				if (item.id) {
-					const seenBy = seenByMap.get(item.id);
-					if (seenBy) seenBy.add(viewerId);
-				}
+				if (item.id) seenByMap.get(item.id)?.add(viewerId);
 				lastReadItem = item;
-			} else unreadCount++;
+				continue;
+			}
+			unreadCount++;
 		}
 		if (lastReadItem?.id) lastReadMessageMap.set(viewerId, lastReadItem.id);
 		unreadCountMap.set(viewerId, unreadCount);
@@ -151,34 +213,20 @@ const buildTimelineReadReceiptData = (seenData, items, sortedMessageItems, sorte
 */
 const useGroupedMessages = ({ items, seenData = [], currentViewerId }) => {
 	return useMemo(() => {
-		const groupedItems = groupTimelineItems(items);
-		const messageItems = items.filter((item) => item.type === "message");
-		let sortedMessageItems = messageItems;
-		let sortedMessageTimes = messageItems.map((item) => getTimestamp(item.createdAt));
-		let isSorted = true;
-		for (let index = 1; index < sortedMessageTimes.length; index++) {
-			const currentTime = sortedMessageTimes[index];
-			const previousTime = sortedMessageTimes[index - 1];
-			if (currentTime !== void 0 && previousTime !== void 0 && currentTime < previousTime) {
-				isSorted = false;
-				break;
-			}
-		}
-		if (!isSorted) {
-			const itemsWithTimes = messageItems.map((item, index) => ({
-				item,
-				time: sortedMessageTimes[index] ?? 0
-			}));
-			itemsWithTimes.sort((a, b) => a.time - b.time);
-			sortedMessageItems = itemsWithTimes.map((entry) => entry.item);
-			sortedMessageTimes = itemsWithTimes.map((entry) => entry.time);
-		}
+		const preparedItems = prepareTimelineItems(items);
+		const groupedItems = groupTimelineItems(preparedItems.items, preparedItems.times);
+		const sortedMessageItems = [];
+		const sortedMessageTimes = [];
 		const messageIndexMap = /* @__PURE__ */ new Map();
-		for (let i = 0; i < sortedMessageItems.length; i++) {
-			const item = sortedMessageItems[i];
-			if (item?.id) messageIndexMap.set(item.id, i);
+		for (let index = 0; index < preparedItems.items.length; index++) {
+			const item = preparedItems.items[index];
+			if (item?.type !== "message") continue;
+			const messageIndex = sortedMessageItems.length;
+			sortedMessageItems.push(item);
+			sortedMessageTimes.push(preparedItems.times[index] ?? getTimestamp(item.createdAt));
+			if (item.id) messageIndexMap.set(item.id, messageIndex);
 		}
-		const { seenByMap, lastReadMessageMap, unreadCountMap } = buildTimelineReadReceiptData(seenData, items, sortedMessageItems, sortedMessageTimes);
+		const { seenByMap, lastReadMessageMap, unreadCountMap } = buildTimelineReadReceiptData(seenData, sortedMessageItems, sortedMessageTimes);
 		const seenByArrayCache = /* @__PURE__ */ new Map();
 		return {
 			items: groupedItems,
@@ -221,5 +269,5 @@ const useGroupedMessages = ({ items, seenData = [], currentViewerId }) => {
 };
 
 //#endregion
-export { useGroupedMessages };
+export { TIMELINE_GROUP_WINDOW_MS, buildTimelineReadReceiptData, groupTimelineItems, prepareTimelineItems, useGroupedMessages };
 //# sourceMappingURL=use-grouped-messages.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-grouped-messages.js","names":["EMPTY_STRING_ARRAY: readonly string[]","result: ConversationItem[]","currentGroup: GroupedMessage | null","currentDayString: string | 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 TimelineToolItem = {\n\ttype: \"timeline_tool\";\n\titem: TimelineItem;\n\ttool: string | null;\n\ttimestamp: Date;\n};\n\nexport type DaySeparatorItem = {\n\ttype: \"day_separator\";\n\tdate: Date;\n\tdateString: string; // ISO date string (YYYY-MM-DD) for stable keys\n};\n\nexport type ConversationItem =\n\t| GroupedMessage\n\t| TimelineEventItem\n\t| TimelineToolItem\n\t| DaySeparatorItem;\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};\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 typeof window !== \"undefined\" ? new Date() : new Date(0);\n\t}\n\tif (typeof date === \"string\") {\n\t\treturn new Date(date);\n\t}\n\treturn date;\n};\n\n// Helper to extract the date string (YYYY-MM-DD) from a Date for day comparison\nconst getDateString = (date: Date): string => {\n\tconst year = date.getFullYear();\n\tconst month = String(date.getMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getDate()).padStart(2, \"0\");\n\treturn `${year}-${month}-${day}`;\n};\n\n// Helper to create a Date at midnight for a given date string\nconst createDayDate = (dateString: string): Date => {\n\tconst [year, month, day] = dateString.split(\"-\").map(Number);\n\treturn new Date(year ?? 0, (month ?? 1) - 1, day ?? 1, 0, 0, 0, 0);\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\nconst getToolNameFromTimelineItem = (item: TimelineItem): string | null => {\n\tif (item.tool) {\n\t\treturn item.tool;\n\t}\n\n\tfor (const part of item.parts) {\n\t\tif (\n\t\t\ttypeof part === \"object\" &&\n\t\t\tpart !== null &&\n\t\t\t\"type\" in part &&\n\t\t\t\"toolName\" in part &&\n\t\t\ttypeof part.type === \"string\" &&\n\t\t\tpart.type.startsWith(\"tool-\") &&\n\t\t\ttypeof part.toolName === \"string\"\n\t\t) {\n\t\t\treturn part.toolName;\n\t\t}\n\t}\n\n\treturn null;\n};\n\nconst EMPTY_STRING_ARRAY: readonly string[] = Object.freeze([]);\n\n// Helper function to group timeline items (messages only, events stay separate)\n// Also inserts day separators when the day changes between items\nconst groupTimelineItems = (items: TimelineItem[]): ConversationItem[] => {\n\tconst result: ConversationItem[] = [];\n\tlet currentGroup: GroupedMessage | null = null;\n\tlet currentDayString: string | null = null;\n\n\tconst maybeInsertDaySeparator = (itemDate: Date): void => {\n\t\tconst itemDayString = getDateString(itemDate);\n\n\t\tif (currentDayString !== itemDayString) {\n\t\t\t// Finalize any existing group before inserting day separator\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// Insert day separator\n\t\t\tresult.push({\n\t\t\t\ttype: \"day_separator\",\n\t\t\t\tdate: createDayDate(itemDayString),\n\t\t\t\tdateString: itemDayString,\n\t\t\t});\n\n\t\t\tcurrentDayString = itemDayString;\n\t\t}\n\t};\n\n\tfor (const item of items) {\n\t\tconst itemDate = toDate(item.createdAt);\n\n\t\t// Check for day boundary before processing any item\n\t\tmaybeInsertDaySeparator(itemDate);\n\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: itemDate,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (item.type === \"identification\" || item.type === \"tool\") {\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 tool item as standalone entry\n\t\t\tresult.push({\n\t\t\t\ttype: \"timeline_tool\",\n\t\t\t\titem,\n\t\t\t\ttool: getToolNameFromTimelineItem(item),\n\t\t\t\ttimestamp: itemDate,\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 (day boundary already handled above)\n\t\t\tcurrentGroup.items.push(item);\n\t\t\tcurrentGroup.lastMessageId = item.id || currentGroup.lastMessageId;\n\t\t\tcurrentGroup.lastMessageTime = itemDate;\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: itemDate,\n\t\t\t\tlastMessageTime: itemDate,\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\n// Accepts pre-sorted message items for performance\nconst buildTimelineReadReceiptData = (\n\tseenData: ConversationSeen[],\n\titems: TimelineItem[],\n\tsortedMessageItems: TimelineItem[],\n\tsortedMessageTimes: number[]\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// Process seen data for each viewer\n\tfor (const seen of seenData) {\n\t\tconst seenTime = getTimestamp(seen.lastSeenAt);\n\t\tconst viewerId = seen.userId || seen.visitorId || seen.aiAgentId;\n\t\tif (!viewerId) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet lastReadItem: TimelineItem | null = null;\n\t\tlet unreadCount = 0;\n\n\t\t// Process items in chronological order (using pre-sorted array)\n\t\tfor (let index = 0; index < sortedMessageItems.length; index++) {\n\t\t\tconst item = sortedMessageItems[index];\n\t\t\tif (!item) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst itemTime =\n\t\t\t\tsortedMessageTimes[index] ?? getTimestamp(item.createdAt);\n\n\t\t\tif (itemTime <= seenTime) {\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\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}: UseGroupedMessagesOptions) => {\n\treturn useMemo(() => {\n\t\tconst groupedItems = groupTimelineItems(items);\n\n\t\t// Pre-compute message items and timestamps once for reuse\n\t\tconst messageItems = items.filter((item) => item.type === \"message\");\n\t\tlet sortedMessageItems = messageItems;\n\t\tlet sortedMessageTimes = messageItems.map((item) =>\n\t\t\tgetTimestamp(item.createdAt)\n\t\t);\n\n\t\t// Avoid sorting if items are already in chronological order\n\t\tlet isSorted = true;\n\t\tfor (let index = 1; index < sortedMessageTimes.length; index++) {\n\t\t\tconst currentTime = sortedMessageTimes[index];\n\t\t\tconst previousTime = sortedMessageTimes[index - 1];\n\t\t\tif (\n\t\t\t\tcurrentTime !== undefined &&\n\t\t\t\tpreviousTime !== undefined &&\n\t\t\t\tcurrentTime < previousTime\n\t\t\t) {\n\t\t\t\tisSorted = false;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tif (!isSorted) {\n\t\t\tconst itemsWithTimes = messageItems.map((item, index) => ({\n\t\t\t\titem,\n\t\t\t\ttime: sortedMessageTimes[index] ?? 0,\n\t\t\t}));\n\n\t\t\titemsWithTimes.sort((a, b) => a.time - b.time);\n\n\t\t\tsortedMessageItems = itemsWithTimes.map((entry) => entry.item);\n\t\t\tsortedMessageTimes = itemsWithTimes.map((entry) => entry.time);\n\t\t}\n\n\t\t// Build index map from sorted items for O(1) chronological lookups\n\t\t// Must use sortedMessageItems (not raw items) to ensure indices reflect time order\n\t\tconst messageIndexMap = new Map<string, number>();\n\t\tfor (let i = 0; i < sortedMessageItems.length; i++) {\n\t\t\tconst item = sortedMessageItems[i];\n\t\t\tif (item?.id) {\n\t\t\t\tmessageIndexMap.set(item.id, i);\n\t\t\t}\n\t\t}\n\n\t\t// Build read receipt data with pre-sorted items\n\t\tconst { seenByMap, lastReadMessageMap, unreadCountMap } =\n\t\t\tbuildTimelineReadReceiptData(\n\t\t\t\tseenData,\n\t\t\t\titems,\n\t\t\t\tsortedMessageItems,\n\t\t\t\tsortedMessageTimes\n\t\t\t);\n\n\t\t// Cache for turning seen sets into stable arrays across renders\n\t\tconst seenByArrayCache = new Map<string, readonly string[]>();\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): readonly string[] => {\n\t\t\t\tif (seenByArrayCache.has(messageId)) {\n\t\t\t\t\treturn seenByArrayCache.get(messageId) ?? EMPTY_STRING_ARRAY;\n\t\t\t\t}\n\n\t\t\t\tconst seenBy = seenByMap.get(messageId);\n\t\t\t\tif (!seenBy || seenBy.size === 0) {\n\t\t\t\t\tseenByArrayCache.set(messageId, EMPTY_STRING_ARRAY);\n\t\t\t\t\treturn EMPTY_STRING_ARRAY;\n\t\t\t\t}\n\n\t\t\t\tconst result = Object.freeze(Array.from(seenBy)) as readonly string[];\n\t\t\t\tseenByArrayCache.set(messageId, result);\n\t\t\t\treturn result;\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\t// Use index map for O(1) lookups instead of findIndex O(n)\n\t\t\t\tconst messageIndex = messageIndexMap.get(messageId);\n\t\t\t\tconst lastReadIndex = messageIndexMap.get(lastRead);\n\n\t\t\t\tif (messageIndex === undefined || lastReadIndex === undefined) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\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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"}
+{"version":3,"file":"use-grouped-messages.js","names":["EMPTY_STRING_ARRAY: readonly string[]","result: ConversationItem[]","currentMessageGroup: GroupedMessage | null","currentActivityGroup: GroupedActivity | null","currentDayString: string | null","lastReadItem: TimelineItem | null","sortedMessageItems: TimelineItem[]","sortedMessageTimes: number[]"],"sources":["../../../src/hooks/private/use-grouped-messages.ts"],"sourcesContent":["import type { SenderType } from \"@cossistant/types\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport type { ConversationSeen } from \"@cossistant/types/schemas\";\nimport { useMemo } from \"react\";\nimport { getTimelineItemSender } from \"../../utils/timeline-item-sender\";\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 GroupedActivity = {\n\ttype: \"activity_group\";\n\tsenderId: string;\n\tsenderType: SenderType;\n\titems: TimelineItem[];\n\tfirstItemId: string;\n\tlastItemId: string;\n\tfirstItemTime: Date;\n\tlastItemTime: Date;\n\thasEvent: boolean;\n\thasTool: boolean;\n};\n\nexport type TimelineEventItem = {\n\ttype: \"timeline_event\";\n\titem: TimelineItem;\n\ttimestamp: Date;\n};\n\nexport type TimelineToolItem = {\n\ttype: \"timeline_tool\";\n\titem: TimelineItem;\n\ttool: string | null;\n\ttimestamp: Date;\n};\n\nexport type DaySeparatorItem = {\n\ttype: \"day_separator\";\n\tdate: Date;\n\tdateString: string; // ISO date string (YYYY-MM-DD) for stable keys\n};\n\nexport type ConversationItem =\n\t| GroupedMessage\n\t| GroupedActivity\n\t| TimelineEventItem\n\t| TimelineToolItem\n\t| DaySeparatorItem;\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};\n\nexport type UseGroupedMessagesProps = UseGroupedMessagesOptions;\n\nexport type PreparedTimelineItems = {\n\titems: TimelineItem[];\n\ttimes: number[];\n\tdidSort: boolean;\n};\n\nexport const TIMELINE_GROUP_WINDOW_MS = 5 * 60 * 1000;\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 to extract the date string (YYYY-MM-DD) from a Date for day comparison\nconst getDateString = (date: Date): string => {\n\tconst year = date.getFullYear();\n\tconst month = String(date.getMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getDate()).padStart(2, \"0\");\n\treturn `${year}-${month}-${day}`;\n};\n\n// Helper to create a Date at midnight for a given date string\nconst createDayDate = (dateString: string): Date => {\n\tconst [year, month, day] = dateString.split(\"-\").map(Number);\n\treturn new Date(year ?? 0, (month ?? 1) - 1, day ?? 1, 0, 0, 0, 0);\n};\n\nconst getToolNameFromTimelineItem = (item: TimelineItem): string | null => {\n\tif (item.tool) {\n\t\treturn item.tool;\n\t}\n\n\tfor (const part of item.parts) {\n\t\tif (\n\t\t\ttypeof part === \"object\" &&\n\t\t\tpart !== null &&\n\t\t\t\"type\" in part &&\n\t\t\t\"toolName\" in part &&\n\t\t\ttypeof part.type === \"string\" &&\n\t\t\tpart.type.startsWith(\"tool-\") &&\n\t\t\ttypeof part.toolName === \"string\"\n\t\t) {\n\t\t\treturn part.toolName;\n\t\t}\n\t}\n\n\treturn null;\n};\n\nconst EMPTY_STRING_ARRAY: readonly string[] = Object.freeze([]);\n\ntype GroupableTimelineItemType =\n\t| \"message\"\n\t| \"activity\"\n\t| \"standalone_tool\"\n\t| \"standalone_event\";\n\nfunction getGroupableTimelineItemType(\n\titem: TimelineItem\n): GroupableTimelineItemType {\n\tif (item.type === \"message\") {\n\t\treturn \"message\";\n\t}\n\n\tif (item.type === \"event\" || item.type === \"tool\") {\n\t\treturn \"activity\";\n\t}\n\n\tif (item.type === \"identification\") {\n\t\treturn \"standalone_tool\";\n\t}\n\n\treturn \"standalone_event\";\n}\n\nexport const prepareTimelineItems = (\n\titems: TimelineItem[]\n): PreparedTimelineItems => {\n\tif (items.length <= 1) {\n\t\treturn {\n\t\t\titems,\n\t\t\ttimes: items.map((item) => getTimestamp(item.createdAt)),\n\t\t\tdidSort: false,\n\t\t};\n\t}\n\n\tconst times = new Array<number>(items.length);\n\tlet isSorted = true;\n\n\tfor (let index = 0; index < items.length; index++) {\n\t\tconst item = items[index];\n\t\tconst time = getTimestamp(item?.createdAt);\n\t\ttimes[index] = time;\n\n\t\tif (index === 0) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst previousTime = times[index - 1];\n\t\tif (\n\t\t\tpreviousTime !== undefined &&\n\t\t\ttime !== undefined &&\n\t\t\ttime < previousTime\n\t\t) {\n\t\t\tisSorted = false;\n\t\t}\n\t}\n\n\tif (isSorted) {\n\t\treturn { items, times, didSort: false };\n\t}\n\n\tconst entries = items.map((item, index) => ({\n\t\titem,\n\t\ttime: times[index] ?? 0,\n\t\tindex,\n\t}));\n\n\tentries.sort((a, b) => {\n\t\tif (a.time === b.time) {\n\t\t\treturn a.index - b.index;\n\t\t}\n\t\treturn a.time - b.time;\n\t});\n\n\treturn {\n\t\titems: entries.map((entry) => entry.item),\n\t\ttimes: entries.map((entry) => entry.time),\n\t\tdidSort: true,\n\t};\n};\n\nconst isWithinGroupingWindow = (\n\tpreviousTimestamp: number,\n\tcurrentTimestamp: number\n): boolean => currentTimestamp - previousTimestamp <= TIMELINE_GROUP_WINDOW_MS;\n\n// Helper function to group timeline items with a sender + time window policy.\n// - message items group with messages only\n// - event + tool items group together\n// - identification remains standalone to preserve the interactive identification form\n// Also inserts day separators when the day changes between items.\nexport const groupTimelineItems = (\n\titems: TimelineItem[],\n\titemTimes: number[]\n): ConversationItem[] => {\n\tconst result: ConversationItem[] = [];\n\tlet currentMessageGroup: GroupedMessage | null = null;\n\tlet currentActivityGroup: GroupedActivity | null = null;\n\tlet currentDayString: string | null = null;\n\n\tconst flushMessageGroup = () => {\n\t\tif (!currentMessageGroup) {\n\t\t\treturn;\n\t\t}\n\n\t\tresult.push(currentMessageGroup);\n\t\tcurrentMessageGroup = null;\n\t};\n\n\tconst flushActivityGroup = () => {\n\t\tif (!currentActivityGroup) {\n\t\t\treturn;\n\t\t}\n\n\t\tresult.push(currentActivityGroup);\n\t\tcurrentActivityGroup = null;\n\t};\n\n\tconst flushAllGroups = () => {\n\t\tflushMessageGroup();\n\t\tflushActivityGroup();\n\t};\n\n\tconst maybeInsertDaySeparator = (itemDate: Date): void => {\n\t\tconst itemDayString = getDateString(itemDate);\n\n\t\tif (currentDayString === itemDayString) {\n\t\t\treturn;\n\t\t}\n\n\t\tflushAllGroups();\n\t\tresult.push({\n\t\t\ttype: \"day_separator\",\n\t\t\tdate: createDayDate(itemDayString),\n\t\t\tdateString: itemDayString,\n\t\t});\n\t\tcurrentDayString = itemDayString;\n\t};\n\n\tfor (let index = 0; index < items.length; index++) {\n\t\tconst item = items[index];\n\t\tif (!item) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst itemTimestamp = itemTimes[index] ?? getTimestamp(item.createdAt);\n\t\tconst itemDate = new Date(itemTimestamp);\n\n\t\tmaybeInsertDaySeparator(itemDate);\n\n\t\tconst groupableType = getGroupableTimelineItemType(item);\n\n\t\tif (groupableType === \"message\") {\n\t\t\tflushActivityGroup();\n\n\t\t\tconst { senderId, senderType } = getTimelineItemSender(item);\n\t\t\tconst previousTimestamp = currentMessageGroup?.lastMessageTime.getTime();\n\t\t\tconst canAppendToCurrentGroup = Boolean(\n\t\t\t\tcurrentMessageGroup &&\n\t\t\t\t\tcurrentMessageGroup.senderId === senderId &&\n\t\t\t\t\tpreviousTimestamp !== undefined &&\n\t\t\t\t\tisWithinGroupingWindow(previousTimestamp, itemTimestamp)\n\t\t\t);\n\n\t\t\tif (canAppendToCurrentGroup && currentMessageGroup) {\n\t\t\t\tcurrentMessageGroup.items.push(item);\n\t\t\t\tcurrentMessageGroup.lastMessageId =\n\t\t\t\t\titem.id || currentMessageGroup.lastMessageId;\n\t\t\t\tcurrentMessageGroup.lastMessageTime = itemDate;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tflushMessageGroup();\n\t\t\tcurrentMessageGroup = {\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: itemDate,\n\t\t\t\tlastMessageTime: itemDate,\n\t\t\t};\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (groupableType === \"activity\") {\n\t\t\tflushMessageGroup();\n\n\t\t\tconst { senderId, senderType } = getTimelineItemSender(item);\n\t\t\tconst previousTimestamp = currentActivityGroup?.lastItemTime.getTime();\n\t\t\tconst canAppendToCurrentGroup = Boolean(\n\t\t\t\tcurrentActivityGroup &&\n\t\t\t\t\tcurrentActivityGroup.senderId === senderId &&\n\t\t\t\t\tpreviousTimestamp !== undefined &&\n\t\t\t\t\tisWithinGroupingWindow(previousTimestamp, itemTimestamp)\n\t\t\t);\n\n\t\t\tif (canAppendToCurrentGroup && currentActivityGroup) {\n\t\t\t\tcurrentActivityGroup.items.push(item);\n\t\t\t\tcurrentActivityGroup.lastItemId =\n\t\t\t\t\titem.id || currentActivityGroup.lastItemId;\n\t\t\t\tcurrentActivityGroup.lastItemTime = itemDate;\n\t\t\t\tcurrentActivityGroup.hasEvent =\n\t\t\t\t\tcurrentActivityGroup.hasEvent || item.type === \"event\";\n\t\t\t\tcurrentActivityGroup.hasTool =\n\t\t\t\t\tcurrentActivityGroup.hasTool || item.type === \"tool\";\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tflushActivityGroup();\n\t\t\tcurrentActivityGroup = {\n\t\t\t\ttype: \"activity_group\",\n\t\t\t\tsenderId,\n\t\t\t\tsenderType,\n\t\t\t\titems: [item],\n\t\t\t\tfirstItemId: item.id || \"\",\n\t\t\t\tlastItemId: item.id || \"\",\n\t\t\t\tfirstItemTime: itemDate,\n\t\t\t\tlastItemTime: itemDate,\n\t\t\t\thasEvent: item.type === \"event\",\n\t\t\t\thasTool: item.type === \"tool\",\n\t\t\t};\n\t\t\tcontinue;\n\t\t}\n\n\t\tflushAllGroups();\n\n\t\tif (groupableType === \"standalone_tool\") {\n\t\t\tresult.push({\n\t\t\t\ttype: \"timeline_tool\",\n\t\t\t\titem,\n\t\t\t\ttool: getToolNameFromTimelineItem(item),\n\t\t\t\ttimestamp: itemDate,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tresult.push({\n\t\t\ttype: \"timeline_event\",\n\t\t\titem,\n\t\t\ttimestamp: itemDate,\n\t\t});\n\t}\n\n\tflushAllGroups();\n\n\treturn result;\n};\n\n// Build read receipt data for timeline items.\n// Accepts pre-sorted message items and timestamps for performance.\nexport const buildTimelineReadReceiptData = (\n\tseenData: ConversationSeen[],\n\tsortedMessageItems: TimelineItem[],\n\tsortedMessageTimes: number[]\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\tfor (const item of sortedMessageItems) {\n\t\tif (item.id) {\n\t\t\tseenByMap.set(item.id, new Set());\n\t\t}\n\t}\n\n\tif (seenData.length === 0 || sortedMessageItems.length === 0) {\n\t\treturn { seenByMap, lastReadMessageMap, unreadCountMap };\n\t}\n\n\tfor (const seen of seenData) {\n\t\tconst seenTime = getTimestamp(seen.lastSeenAt);\n\t\tconst viewerId = seen.userId || seen.visitorId || seen.aiAgentId;\n\t\tif (!viewerId) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet lastReadItem: TimelineItem | null = null;\n\t\tlet unreadCount = 0;\n\n\t\tfor (let index = 0; index < sortedMessageItems.length; index++) {\n\t\t\tconst item = sortedMessageItems[index];\n\t\t\tif (!item) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst itemTime =\n\t\t\t\tsortedMessageTimes[index] ?? getTimestamp(item.createdAt);\n\n\t\t\tif (itemTime <= seenTime) {\n\t\t\t\tif (item.id) {\n\t\t\t\t\tconst seenBy = seenByMap.get(item.id);\n\t\t\t\t\tseenBy?.add(viewerId);\n\t\t\t\t}\n\t\t\t\tlastReadItem = item;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tunreadCount++;\n\t\t}\n\n\t\tif (lastReadItem?.id) {\n\t\t\tlastReadMessageMap.set(viewerId, lastReadItem.id);\n\t\t}\n\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}: UseGroupedMessagesOptions) => {\n\treturn useMemo(() => {\n\t\tconst preparedItems = prepareTimelineItems(items);\n\t\tconst groupedItems = groupTimelineItems(\n\t\t\tpreparedItems.items,\n\t\t\tpreparedItems.times\n\t\t);\n\n\t\tconst sortedMessageItems: TimelineItem[] = [];\n\t\tconst sortedMessageTimes: number[] = [];\n\t\tconst messageIndexMap = new Map<string, number>();\n\n\t\tfor (let index = 0; index < preparedItems.items.length; index++) {\n\t\t\tconst item = preparedItems.items[index];\n\t\t\tif (item?.type !== \"message\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst messageIndex = sortedMessageItems.length;\n\t\t\tsortedMessageItems.push(item);\n\t\t\tsortedMessageTimes.push(\n\t\t\t\tpreparedItems.times[index] ?? getTimestamp(item.createdAt)\n\t\t\t);\n\n\t\t\tif (item.id) {\n\t\t\t\tmessageIndexMap.set(item.id, messageIndex);\n\t\t\t}\n\t\t}\n\n\t\tconst { seenByMap, lastReadMessageMap, unreadCountMap } =\n\t\t\tbuildTimelineReadReceiptData(\n\t\t\t\tseenData,\n\t\t\t\tsortedMessageItems,\n\t\t\t\tsortedMessageTimes\n\t\t\t);\n\n\t\t// Cache for turning seen sets into stable arrays across renders\n\t\tconst seenByArrayCache = new Map<string, readonly string[]>();\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): readonly string[] => {\n\t\t\t\tif (seenByArrayCache.has(messageId)) {\n\t\t\t\t\treturn seenByArrayCache.get(messageId) ?? EMPTY_STRING_ARRAY;\n\t\t\t\t}\n\n\t\t\t\tconst seenBy = seenByMap.get(messageId);\n\t\t\t\tif (!seenBy || seenBy.size === 0) {\n\t\t\t\t\tseenByArrayCache.set(messageId, EMPTY_STRING_ARRAY);\n\t\t\t\t\treturn EMPTY_STRING_ARRAY;\n\t\t\t\t}\n\n\t\t\t\tconst result = Object.freeze(Array.from(seenBy)) as readonly string[];\n\t\t\t\tseenByArrayCache.set(messageId, result);\n\t\t\t\treturn result;\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\t// Use index map for O(1) lookups instead of findIndex O(n)\n\t\t\t\tconst messageIndex = messageIndexMap.get(messageId);\n\t\t\t\tconst lastReadIndex = messageIndexMap.get(lastRead);\n\n\t\t\t\tif (messageIndex === undefined || lastReadIndex === undefined) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\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/use-new-message-sound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-new-message-sound.d.ts","names":[],"sources":["../../src/hooks/use-new-message-sound.ts"],"sourcesContent":[],"mappings":";;AAqBA;;;;;;;;;;;;;;iBAAgB,kBAAA"}
+{"version":3,"file":"use-new-message-sound.d.ts","names":[],"sources":["../../src/hooks/use-new-message-sound.ts"],"sourcesContent":[],"mappings":";;AAmBA;;;;;;;;;;;;;;iBAAgB,kBAAA"}

package/hooks/use-new-message-sound.js

@@ -1,8 +1,8 @@
+import { NEW_MESSAGE_SOUND_DATA_URL } from "../sounds/sound-data.js";
 import { useSoundEffect } from "./use-sound-effect.js";
 import { useCallback } from "react";
 
 //#region src/hooks/use-new-message-sound.ts
-const NEW_MESSAGE_SOUND_PATH = "/sounds/new-message.wav";
 /**
 * Hook to play a sound when a new message arrives.
 *
@@ -19,7 +19,7 @@ const NEW_MESSAGE_SOUND_PATH = "/sounds/new-message.wav";
 * }, [hasNewMessage]);
 */
 function useNewMessageSound(options) {
-	const { play } = useSoundEffect(NEW_MESSAGE_SOUND_PATH, {
+	const { play } = useSoundEffect(NEW_MESSAGE_SOUND_DATA_URL, {
 		loop: false,
 		volume: options?.volume ?? .7,
 		playbackRate: options?.playbackRate ?? 1

package/hooks/use-new-message-sound.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-new-message-sound.js","names":[],"sources":["../../src/hooks/use-new-message-sound.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useSoundEffect } from \"./use-sound-effect\";\n\n// Use a path that can be served from public directory\nconst NEW_MESSAGE_SOUND_PATH = \"/sounds/new-message.wav\";\n\n/**\n * Hook to play a sound when a new message arrives.\n *\n * @param options - Optional configuration for volume and playback speed\n * @returns Function to play the new message sound\n *\n * @example\n * const playNewMessageSound = useNewMessageSound({ volume: 0.8, playbackRate: 1.1 });\n *\n * useEffect(() => {\n *   if (hasNewMessage) {\n *     playNewMessageSound();\n *   }\n * }, [hasNewMessage]);\n */\nexport function useNewMessageSound(options?: {\n\tvolume?: number;\n\tplaybackRate?: number;\n}): () => void {\n\tconst { play } = useSoundEffect(NEW_MESSAGE_SOUND_PATH, {\n\t\tloop: false,\n\t\tvolume: options?.volume ?? 0.7,\n\t\tplaybackRate: options?.playbackRate ?? 1.0,\n\t});\n\n\treturn useCallback(() => {\n\t\tplay();\n\t}, [play]);\n}\n"],"mappings":";;;;AAIA,MAAM,yBAAyB;;;;;;;;;;;;;;;;AAiB/B,SAAgB,mBAAmB,SAGpB;CACd,MAAM,EAAE,SAAS,eAAe,wBAAwB;EACvD,MAAM;EACN,QAAQ,SAAS,UAAU;EAC3B,cAAc,SAAS,gBAAgB;EACvC,CAAC;AAEF,QAAO,kBAAkB;AACxB,QAAM;IACJ,CAAC,KAAK,CAAC"}
+{"version":3,"file":"use-new-message-sound.js","names":[],"sources":["../../src/hooks/use-new-message-sound.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { NEW_MESSAGE_SOUND_DATA_URL } from \"../sounds/sound-data\";\nimport { useSoundEffect } from \"./use-sound-effect\";\n\n/**\n * Hook to play a sound when a new message arrives.\n *\n * @param options - Optional configuration for volume and playback speed\n * @returns Function to play the new message sound\n *\n * @example\n * const playNewMessageSound = useNewMessageSound({ volume: 0.8, playbackRate: 1.1 });\n *\n * useEffect(() => {\n *   if (hasNewMessage) {\n *     playNewMessageSound();\n *   }\n * }, [hasNewMessage]);\n */\nexport function useNewMessageSound(options?: {\n\tvolume?: number;\n\tplaybackRate?: number;\n}): () => void {\n\tconst { play } = useSoundEffect(NEW_MESSAGE_SOUND_DATA_URL, {\n\t\tloop: false,\n\t\tvolume: options?.volume ?? 0.7,\n\t\tplaybackRate: options?.playbackRate ?? 1.0,\n\t});\n\n\treturn useCallback(() => {\n\t\tplay();\n\t}, [play]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,mBAAmB,SAGpB;CACd,MAAM,EAAE,SAAS,eAAe,4BAA4B;EAC3D,MAAM;EACN,QAAQ,SAAS,UAAU;EAC3B,cAAc,SAAS,gBAAgB;EACvC,CAAC;AAEF,QAAO,kBAAkB;AACxB,QAAM;IACJ,CAAC,KAAK,CAAC"}

package/hooks/use-typing-sound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-typing-sound.d.ts","names":[],"sources":["../../src/hooks/use-typing-sound.ts"],"sourcesContent":[],"mappings":";;AAiBA;;;;;;;;;iBAAgB,cAAA"}
+{"version":3,"file":"use-typing-sound.d.ts","names":[],"sources":["../../src/hooks/use-typing-sound.ts"],"sourcesContent":[],"mappings":";;AAcA;;;;;;;;;iBAAgB,cAAA"}

package/hooks/use-typing-sound.js

@@ -1,8 +1,8 @@
+import { TYPING_LOOP_SOUND_DATA_URL } from "../sounds/sound-data.js";
 import { useSoundEffect } from "./use-sound-effect.js";
 import { useEffect } from "react";
 
 //#region src/hooks/use-typing-sound.ts
-const TYPING_SOUND_PATH = "/sounds/typing-loop.wav";
 /**
 * Hook to play a looping typing sound while someone is typing.
 *
@@ -14,7 +14,7 @@ const TYPING_SOUND_PATH = "/sounds/typing-loop.wav";
 * useTypingSound(isTyping, { volume: 1.0, playbackRate: 1.2 });
 */
 function useTypingSound(isTyping, options) {
-	const { play, stop, isPlaying } = useSoundEffect(TYPING_SOUND_PATH, {
+	const { play, stop, isPlaying } = useSoundEffect(TYPING_LOOP_SOUND_DATA_URL, {
 		loop: true,
 		volume: options?.volume ?? 1.2,
 		playbackRate: options?.playbackRate ?? 1

package/hooks/use-typing-sound.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-typing-sound.js","names":[],"sources":["../../src/hooks/use-typing-sound.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useSoundEffect } from \"./use-sound-effect\";\n\n// Use a data URL or base64 encoded sound, or a CDN URL\n// For now, we'll use a path that can be served from public directory\nconst TYPING_SOUND_PATH = \"/sounds/typing-loop.wav\";\n\n/**\n * Hook to play a looping typing sound while someone is typing.\n *\n * @param isTyping - Whether someone is currently typing\n * @param options - Optional configuration for volume and playback speed\n *\n * @example\n * const { isTyping } = useTypingIndicator();\n * useTypingSound(isTyping, { volume: 1.0, playbackRate: 1.2 });\n */\nexport function useTypingSound(\n\tisTyping: boolean,\n\toptions?: { volume?: number; playbackRate?: number }\n): void {\n\tconst { play, stop, isPlaying } = useSoundEffect(TYPING_SOUND_PATH, {\n\t\tloop: true,\n\t\tvolume: options?.volume ?? 1.2,\n\t\tplaybackRate: options?.playbackRate ?? 1.0,\n\t});\n\n\tuseEffect(() => {\n\t\tif (isTyping && !isPlaying) {\n\t\t\tplay();\n\t\t} else if (!isTyping && isPlaying) {\n\t\t\tstop();\n\t\t}\n\t}, [isTyping, isPlaying, play, stop]);\n\n\t// Cleanup on unmount\n\tuseEffect(\n\t\t() => () => {\n\t\t\tstop();\n\t\t},\n\t\t[stop]\n\t);\n}\n"],"mappings":";;;;AAKA,MAAM,oBAAoB;;;;;;;;;;;AAY1B,SAAgB,eACf,UACA,SACO;CACP,MAAM,EAAE,MAAM,MAAM,cAAc,eAAe,mBAAmB;EACnE,MAAM;EACN,QAAQ,SAAS,UAAU;EAC3B,cAAc,SAAS,gBAAgB;EACvC,CAAC;AAEF,iBAAgB;AACf,MAAI,YAAY,CAAC,UAChB,OAAM;WACI,CAAC,YAAY,UACvB,OAAM;IAEL;EAAC;EAAU;EAAW;EAAM;EAAK,CAAC;AAGrC,uBACa;AACX,QAAM;IAEP,CAAC,KAAK,CACN"}
+{"version":3,"file":"use-typing-sound.js","names":[],"sources":["../../src/hooks/use-typing-sound.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { TYPING_LOOP_SOUND_DATA_URL } from \"../sounds/sound-data\";\nimport { useSoundEffect } from \"./use-sound-effect\";\n\n/**\n * Hook to play a looping typing sound while someone is typing.\n *\n * @param isTyping - Whether someone is currently typing\n * @param options - Optional configuration for volume and playback speed\n *\n * @example\n * const { isTyping } = useTypingIndicator();\n * useTypingSound(isTyping, { volume: 1.0, playbackRate: 1.2 });\n */\nexport function useTypingSound(\n\tisTyping: boolean,\n\toptions?: { volume?: number; playbackRate?: number }\n): void {\n\tconst { play, stop, isPlaying } = useSoundEffect(TYPING_LOOP_SOUND_DATA_URL, {\n\t\tloop: true,\n\t\tvolume: options?.volume ?? 1.2,\n\t\tplaybackRate: options?.playbackRate ?? 1.0,\n\t});\n\n\tuseEffect(() => {\n\t\tif (isTyping && !isPlaying) {\n\t\t\tplay();\n\t\t} else if (!isTyping && isPlaying) {\n\t\t\tstop();\n\t\t}\n\t}, [isTyping, isPlaying, play, stop]);\n\n\t// Cleanup on unmount\n\tuseEffect(\n\t\t() => () => {\n\t\t\tstop();\n\t\t},\n\t\t[stop]\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,eACf,UACA,SACO;CACP,MAAM,EAAE,MAAM,MAAM,cAAc,eAAe,4BAA4B;EAC5E,MAAM;EACN,QAAQ,SAAS,UAAU;EAC3B,cAAc,SAAS,gBAAgB;EACvC,CAAC;AAEF,iBAAgB;AACf,MAAI,YAAY,CAAC,UAChB,OAAM;WACI,CAAC,YAAY,UACvB,OAAM;IAEL;EAAC;EAAU;EAAW;EAAM;EAAK,CAAC;AAGrC,uBACa;AACX,QAAM;IAEP,CAAC,KAAK,CACN"}

package/index.d.ts

@@ -1,6 +1,6 @@
 import { useClientQuery } from "./hooks/private/use-client-query.js";
 import { useDefaultMessages } from "./hooks/private/use-default-messages.js";
-import { ConversationItem, DaySeparatorItem, GroupedMessage, TimelineEventItem, TimelineToolItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, useGroupedMessages } from "./hooks/private/use-grouped-messages.js";
+import { ConversationItem, DaySeparatorItem, GroupedActivity, GroupedMessage, PreparedTimelineItems, TIMELINE_GROUP_WINDOW_MS, TimelineEventItem, TimelineToolItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, buildTimelineReadReceiptData, groupTimelineItems, prepareTimelineItems, useGroupedMessages } from "./hooks/private/use-grouped-messages.js";
 import { UseMultimodalInputOptions, UseMultimodalInputReturn, useMultimodalInput } from "./hooks/private/use-multimodal-input.js";
 import { ConfigurationError, UseClientResult, useClient } from "./hooks/private/use-rest-client.js";
 import { UseComposerRefocusOptions, UseComposerRefocusReturn, useComposerRefocus } from "./hooks/use-composer-refocus.js";
@@ -49,4 +49,4 @@ import { Header } from "./support/components/header.js";
 import { WebSocketContextValue, WebSocketProvider, useWebSocket } from "./support/context/websocket.js";
 import { useSupportConfig, useSupportNavigation, useSupportStore } from "./support/store/support-store.js";
 import { DefaultRoutes, NavigationState, RouteRegistry, Support, SupportContentProps, SupportPageProps, SupportPageType, SupportProps, SupportRootProps, SupportRouterProps, SupportTriggerProps } from "./support/index.js";
-export { Align, CoButton as Button, CONVERSATION_AUTO_SEEN_DELAY_MS, CollisionPadding, ConfigurationError, ContentProps, ConversationEndEvent, ConversationItem, ConversationLifecycleState, ConversationPreviewAssignedAgent, ConversationPreviewLastMessage, ConversationPreviewTypingParticipant, ConversationPreviewTypingState, ConversationStartEvent, ConversationTimelineTypingParticipant, ConversationTypingParticipant, CossistantContextValue, CossistantProviderProps, CreateConversationVariables, CustomPage, DaySeparatorItem, DefaultRoutes, ErrorEvent, FileUploadPart, GroupedMessage, Header, IdentifySupportVisitor, IdentifySupportVisitorProps, MessageReceivedEvent, MessageSentEvent, NavigationState, index_d_exports as Primitives, RealtimeAuthConfig, RealtimeContextValue, RealtimeEventHandler, RealtimeEventHandlerEntry, RealtimeEventHandlersMap, RealtimeEventMeta, RealtimeProvider, RealtimeProviderProps, RootProps, RouteRegistry, SendMessageOptions, SendMessageResult, Side, Support, SupportConfig, SupportConfigProps, SupportContentProps, SupportContext, SupportEvent, SupportEventCallbacks, SupportEventType, SupportHandle, SupportLocale, SupportPageProps, SupportPageType, SupportProps, SupportProvider, SupportProviderProps, SupportRealtimeProvider, SupportRootProps, SupportRouterProps, SupportTextContentOverrides, SupportTriggerProps, Text, TimelineEventItem, TimelineToolItem, TriggerRenderProps, UseClientResult, UseComposerRefocusOptions, UseComposerRefocusReturn, UseConversationAutoSeenOptions, UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, UseConversationLifecycleOptions, UseConversationLifecycleReturn, UseConversationOptions, UseConversationPageOptions, UseConversationPageReturn, UseConversationPreviewOptions, UseConversationPreviewReturn, UseConversationResult, UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, UseConversationTimelineOptions, UseConversationTimelineReturn, UseConversationsOptions, UseConversationsResult, UseCreateConversationOptions, UseCreateConversationResult, UseFileUploadOptions, UseFileUploadReturn, UseGroupedMessagesOptions, UseGroupedMessagesProps, UseHomePageOptions, UseHomePageReturn, UseMessageComposerOptions, UseMessageComposerReturn, UseMultimodalInputOptions, UseMultimodalInputReturn, UseRealtimeSupportOptions, UseRealtimeSupportResult, UseScrollMaskOptions, UseScrollMaskReturn, UseSendMessageOptions, UseSendMessageResult, UseSoundEffectOptions, UseSoundEffectReturn, UseSupportValue, UseVisitorReturn, WebSocketContextValue, WebSocketProvider, WindowVisibilityFocusState, applyConversationSeenEvent, applyConversationTypingEvent, clearTypingFromTimelineItem, clearTypingState, hydrateConversationSeen, setTypingState, upsertConversationSeen, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useFileUpload, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useNewMessageSound, useRealtime, useRealtimeConnection, useRealtimeSupport, useScrollMask, useSendMessage, useSoundEffect, useSupport, useSupportConfig, useSupportEventEmitter, useSupportEvents, useSupportHandle, useSupportNavigation, useSupportStore, useSupportText, useTypingSound, useVisitor, useWebSocket, useWindowVisibilityFocus };
+export { Align, CoButton as Button, CONVERSATION_AUTO_SEEN_DELAY_MS, CollisionPadding, ConfigurationError, ContentProps, ConversationEndEvent, ConversationItem, ConversationLifecycleState, ConversationPreviewAssignedAgent, ConversationPreviewLastMessage, ConversationPreviewTypingParticipant, ConversationPreviewTypingState, ConversationStartEvent, ConversationTimelineTypingParticipant, ConversationTypingParticipant, CossistantContextValue, CossistantProviderProps, CreateConversationVariables, CustomPage, DaySeparatorItem, DefaultRoutes, ErrorEvent, FileUploadPart, GroupedActivity, GroupedMessage, Header, IdentifySupportVisitor, IdentifySupportVisitorProps, MessageReceivedEvent, MessageSentEvent, NavigationState, PreparedTimelineItems, index_d_exports as Primitives, RealtimeAuthConfig, RealtimeContextValue, RealtimeEventHandler, RealtimeEventHandlerEntry, RealtimeEventHandlersMap, RealtimeEventMeta, RealtimeProvider, RealtimeProviderProps, RootProps, RouteRegistry, SendMessageOptions, SendMessageResult, Side, Support, SupportConfig, SupportConfigProps, SupportContentProps, SupportContext, SupportEvent, SupportEventCallbacks, SupportEventType, SupportHandle, SupportLocale, SupportPageProps, SupportPageType, SupportProps, SupportProvider, SupportProviderProps, SupportRealtimeProvider, SupportRootProps, SupportRouterProps, SupportTextContentOverrides, SupportTriggerProps, TIMELINE_GROUP_WINDOW_MS, Text, TimelineEventItem, TimelineToolItem, TriggerRenderProps, UseClientResult, UseComposerRefocusOptions, UseComposerRefocusReturn, UseConversationAutoSeenOptions, UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, UseConversationLifecycleOptions, UseConversationLifecycleReturn, UseConversationOptions, UseConversationPageOptions, UseConversationPageReturn, UseConversationPreviewOptions, UseConversationPreviewReturn, UseConversationResult, UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, UseConversationTimelineOptions, UseConversationTimelineReturn, UseConversationsOptions, UseConversationsResult, UseCreateConversationOptions, UseCreateConversationResult, UseFileUploadOptions, UseFileUploadReturn, UseGroupedMessagesOptions, UseGroupedMessagesProps, UseHomePageOptions, UseHomePageReturn, UseMessageComposerOptions, UseMessageComposerReturn, UseMultimodalInputOptions, UseMultimodalInputReturn, UseRealtimeSupportOptions, UseRealtimeSupportResult, UseScrollMaskOptions, UseScrollMaskReturn, UseSendMessageOptions, UseSendMessageResult, UseSoundEffectOptions, UseSoundEffectReturn, UseSupportValue, UseVisitorReturn, WebSocketContextValue, WebSocketProvider, WindowVisibilityFocusState, applyConversationSeenEvent, applyConversationTypingEvent, buildTimelineReadReceiptData, clearTypingFromTimelineItem, clearTypingState, groupTimelineItems, hydrateConversationSeen, prepareTimelineItems, setTypingState, upsertConversationSeen, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useFileUpload, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useNewMessageSound, useRealtime, useRealtimeConnection, useRealtimeSupport, useScrollMask, useSendMessage, useSoundEffect, useSupport, useSupportConfig, useSupportEventEmitter, useSupportEvents, useSupportHandle, useSupportNavigation, useSupportStore, useSupportText, useTypingSound, useVisitor, useWebSocket, useWindowVisibilityFocus };