@cossistant/react 0.0.1

package/hooks/use-conversation-history-page.js

@@ -0,0 +1,97 @@
+import { useConversations } from "./use-conversations.js";
+import { useCallback, useMemo, useState } from "react";
+
+//#region src/hooks/use-conversation-history-page.ts
+/**
+* Main hook for the conversation history page.
+*
+* This hook:
+* - Fetches all conversations
+* - Manages pagination/visible count
+* - Provides navigation actions
+*
+* It encapsulates all conversation history logic, making the component
+* purely presentational.
+*
+* @example
+* ```tsx
+* export function ConversationHistoryPage() {
+*   const history = useConversationHistoryPage({
+*     initialVisibleCount: 4,
+*     onOpenConversation: (id) => {
+*       navigate('conversation', { conversationId: id });
+*     },
+*     onStartConversation: (msg) => {
+*       navigate('conversation', { conversationId: PENDING_CONVERSATION_ID, initialMessage: msg });
+*     },
+*   });
+*
+*   return (
+*     <>
+*       <h1>Conversation History</h1>
+*
+*       {history.hasMore && (
+*         <button onClick={history.showAll}>
+*           +{history.remainingCount} more
+*         </button>
+*       )}
+*
+*       <ul>
+*         {history.visibleConversations.map(conv => (
+*           <li key={conv.id} onClick={() => history.openConversation(conv.id)}>
+*             {conv.title}
+*           </li>
+*         ))}
+*       </ul>
+*     </>
+*   );
+* }
+* ```
+*/
+function useConversationHistoryPage(options = {}) {
+	const { initialVisibleCount = 4, enabled = true, onOpenConversation, onStartConversation } = options;
+	const { conversations, isLoading, error } = useConversations({
+		enabled,
+		orderBy: "updatedAt",
+		order: "desc"
+	});
+	const [visibleCount, setVisibleCount] = useState(initialVisibleCount);
+	const { visibleConversations, hasMore, remainingCount } = useMemo(() => {
+		const visible = conversations.slice(0, visibleCount);
+		const remaining = Math.max(conversations.length - visibleCount, 0);
+		return {
+			visibleConversations: visible,
+			hasMore: remaining > 0,
+			remainingCount: remaining
+		};
+	}, [conversations, visibleCount]);
+	const showMore = useCallback(() => {
+		setVisibleCount((current) => current + initialVisibleCount);
+	}, [initialVisibleCount]);
+	const showAll = useCallback(() => {
+		setVisibleCount(conversations.length);
+	}, [conversations.length]);
+	const openConversation = useCallback((conversationId) => {
+		onOpenConversation?.(conversationId);
+	}, [onOpenConversation]);
+	const startConversation = useCallback((initialMessage) => {
+		onStartConversation?.(initialMessage);
+	}, [onStartConversation]);
+	return {
+		conversations,
+		isLoading,
+		error,
+		visibleConversations,
+		visibleCount,
+		hasMore,
+		remainingCount,
+		showMore,
+		showAll,
+		openConversation,
+		startConversation
+	};
+}
+
+//#endregion
+export { useConversationHistoryPage };
+//# sourceMappingURL=use-conversation-history-page.js.map

package/hooks/use-conversation-history-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-history-page.js","names":[],"sources":["../../src/hooks/use-conversation-history-page.ts"],"sourcesContent":["import type { Conversation } from \"@cossistant/types\";\nimport { useCallback, useMemo, useState } from \"react\";\nimport { useConversations } from \"./use-conversations\";\n\nexport type UseConversationHistoryPageOptions = {\n\t/**\n\t * Initial number of conversations to display.\n\t * Default: 4\n\t */\n\tinitialVisibleCount?: number;\n\n\t/**\n\t * Whether to enable conversations fetching.\n\t * Default: true\n\t */\n\tenabled?: boolean;\n\n\t/**\n\t * Callback when user wants to open a conversation.\n\t */\n\tonOpenConversation?: (conversationId: string) => void;\n\n\t/**\n\t * Callback when user wants to start a new conversation.\n\t */\n\tonStartConversation?: (initialMessage?: string) => void;\n};\n\nexport type UseConversationHistoryPageReturn = {\n\t// Conversations data\n\tconversations: Conversation[];\n\tisLoading: boolean;\n\terror: Error | null;\n\n\t// Pagination state\n\tvisibleConversations: Conversation[];\n\tvisibleCount: number;\n\thasMore: boolean;\n\tremainingCount: number;\n\n\t// Actions\n\tshowMore: () => void;\n\tshowAll: () => void;\n\topenConversation: (conversationId: string) => void;\n\tstartConversation: (initialMessage?: string) => void;\n};\n\n/**\n * Main hook for the conversation history page.\n *\n * This hook:\n * - Fetches all conversations\n * - Manages pagination/visible count\n * - Provides navigation actions\n *\n * It encapsulates all conversation history logic, making the component\n * purely presentational.\n *\n * @example\n * ```tsx\n * export function ConversationHistoryPage() {\n *   const history = useConversationHistoryPage({\n *     initialVisibleCount: 4,\n *     onOpenConversation: (id) => {\n *       navigate('conversation', { conversationId: id });\n *     },\n *     onStartConversation: (msg) => {\n *       navigate('conversation', { conversationId: PENDING_CONVERSATION_ID, initialMessage: msg });\n *     },\n *   });\n *\n *   return (\n *     <>\n *       <h1>Conversation History</h1>\n *\n *       {history.hasMore && (\n *         <button onClick={history.showAll}>\n *           +{history.remainingCount} more\n *         </button>\n *       )}\n *\n *       <ul>\n *         {history.visibleConversations.map(conv => (\n *           <li key={conv.id} onClick={() => history.openConversation(conv.id)}>\n *             {conv.title}\n *           </li>\n *         ))}\n *       </ul>\n *     </>\n *   );\n * }\n * ```\n */\nexport function useConversationHistoryPage(\n\toptions: UseConversationHistoryPageOptions = {}\n): UseConversationHistoryPageReturn {\n\tconst {\n\t\tinitialVisibleCount = 4,\n\t\tenabled = true,\n\t\tonOpenConversation,\n\t\tonStartConversation,\n\t} = options;\n\n\t// Fetch conversations\n\tconst { conversations, isLoading, error } = useConversations({\n\t\tenabled,\n\t\t// Most recent first\n\t\torderBy: \"updatedAt\",\n\t\torder: \"desc\",\n\t});\n\n\t// Manage visible count for pagination\n\tconst [visibleCount, setVisibleCount] = useState(initialVisibleCount);\n\n\t// Compute visible conversations and pagination state\n\tconst { visibleConversations, hasMore, remainingCount } = useMemo(() => {\n\t\tconst visible = conversations.slice(0, visibleCount);\n\t\tconst remaining = Math.max(conversations.length - visibleCount, 0);\n\n\t\treturn {\n\t\t\tvisibleConversations: visible,\n\t\t\thasMore: remaining > 0,\n\t\t\tremainingCount: remaining,\n\t\t};\n\t}, [conversations, visibleCount]);\n\n\t// Actions\n\tconst showMore = useCallback(() => {\n\t\tsetVisibleCount((current) => current + initialVisibleCount);\n\t}, [initialVisibleCount]);\n\n\tconst showAll = useCallback(() => {\n\t\tsetVisibleCount(conversations.length);\n\t}, [conversations.length]);\n\n\tconst openConversation = useCallback(\n\t\t(conversationId: string) => {\n\t\t\tonOpenConversation?.(conversationId);\n\t\t},\n\t\t[onOpenConversation]\n\t);\n\n\tconst startConversation = useCallback(\n\t\t(initialMessage?: string) => {\n\t\t\tonStartConversation?.(initialMessage);\n\t\t},\n\t\t[onStartConversation]\n\t);\n\n\treturn {\n\t\tconversations,\n\t\tisLoading,\n\t\terror,\n\t\tvisibleConversations,\n\t\tvisibleCount,\n\t\thasMore,\n\t\tremainingCount,\n\t\tshowMore,\n\t\tshowAll,\n\t\topenConversation,\n\t\tstartConversation,\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6FA,SAAgB,2BACf,UAA6C,EAAE,EACZ;CACnC,MAAM,EACL,sBAAsB,GACtB,UAAU,MACV,oBACA,wBACG;CAGJ,MAAM,EAAE,eAAe,WAAW,UAAU,iBAAiB;EAC5D;EAEA,SAAS;EACT,OAAO;EACP,CAAC;CAGF,MAAM,CAAC,cAAc,mBAAmB,SAAS,oBAAoB;CAGrE,MAAM,EAAE,sBAAsB,SAAS,mBAAmB,cAAc;EACvE,MAAM,UAAU,cAAc,MAAM,GAAG,aAAa;EACpD,MAAM,YAAY,KAAK,IAAI,cAAc,SAAS,cAAc,EAAE;AAElE,SAAO;GACN,sBAAsB;GACtB,SAAS,YAAY;GACrB,gBAAgB;GAChB;IACC,CAAC,eAAe,aAAa,CAAC;CAGjC,MAAM,WAAW,kBAAkB;AAClC,mBAAiB,YAAY,UAAU,oBAAoB;IACzD,CAAC,oBAAoB,CAAC;CAEzB,MAAM,UAAU,kBAAkB;AACjC,kBAAgB,cAAc,OAAO;IACnC,CAAC,cAAc,OAAO,CAAC;CAE1B,MAAM,mBAAmB,aACvB,mBAA2B;AAC3B,uBAAqB,eAAe;IAErC,CAAC,mBAAmB,CACpB;CAED,MAAM,oBAAoB,aACxB,mBAA4B;AAC5B,wBAAsB,eAAe;IAEtC,CAAC,oBAAoB,CACrB;AAED,QAAO;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA"}

package/hooks/use-conversation-lifecycle.d.ts

@@ -0,0 +1,80 @@
+//#region src/hooks/use-conversation-lifecycle.d.ts
+type ConversationLifecycleState = {
+  /**
+   * The current conversation ID. Always a string, never null.
+   * Will be PENDING_CONVERSATION_ID if no real conversation exists yet.
+   */
+  conversationId: string;
+  /**
+   * Whether this is a pending (not yet created) conversation.
+   * True = showing default messages, no backend conversation yet.
+   * False = real conversation exists on backend.
+   */
+  isPending: boolean;
+  /**
+   * The real conversation ID if one exists, otherwise null.
+   * Use this when you need to pass to API calls that require an existing conversation.
+   */
+  realConversationId: string | null;
+};
+type UseConversationLifecycleOptions = {
+  /**
+   * Initial conversation ID from URL or navigation state.
+   * Can be PENDING_CONVERSATION_ID or a real conversation ID.
+   */
+  initialConversationId?: string;
+  /**
+   * Whether to automatically create a conversation on mount.
+   * If false, conversation will only be created when user sends first message.
+   * Default: false (lazy creation)
+   */
+  autoCreate?: boolean;
+  /**
+   * Visitor ID to associate with the conversation.
+   */
+  visitorId?: string;
+  /**
+   * Website ID to associate with the conversation.
+   */
+  websiteId?: string | null;
+  /**
+   * Callback when conversation is created.
+   */
+  onConversationCreated?: (conversationId: string) => void;
+};
+type UseConversationLifecycleReturn = ConversationLifecycleState & {
+  /**
+   * Update the conversation ID (e.g., after creation or navigation).
+   */
+  setConversationId: (conversationId: string) => void;
+  /**
+   * Check if this is a new/pending conversation.
+   */
+  isNewConversation: () => boolean;
+};
+/**
+ * Manages the lifecycle of a conversation, handling the transition from
+ * a pending state (showing default messages) to a real conversation
+ * (with backend persistence).
+ *
+ * This hook simplifies the logic of:
+ * - Starting with default/welcome messages
+ * - Creating the conversation only when user sends first message
+ * - Transitioning from pending → real conversation ID
+ *
+ * @example
+ * ```tsx
+ * const { conversationId, isPending, realConversationId } = useConversationLifecycle({
+ *   initialConversationId: params.conversationId,
+ *   visitorId: visitor?.id,
+ * });
+ *
+ * // conversationId is always a string (never null)
+ * // isPending tells you if it's a real conversation or not
+ * // realConversationId is null when isPending=true, otherwise it's the real ID
+ * ```
+ */
+declare function useConversationLifecycle(options?: UseConversationLifecycleOptions): UseConversationLifecycleReturn;
+//#endregion
+export { ConversationLifecycleState, UseConversationLifecycleOptions, UseConversationLifecycleReturn, useConversationLifecycle };
+//# sourceMappingURL=use-conversation-lifecycle.d.ts.map

package/hooks/use-conversation-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-lifecycle.d.ts","names":[],"sources":["../../src/hooks/use-conversation-lifecycle.ts"],"sourcesContent":[],"mappings":";KAGY,0BAAA;EAAA;AAqBZ;AA8BA;AAkCA;EAAwC,cAAA,EAAA,MAAA;;;;;;;;;;;;;KAhE5B,+BAAA;;;;;;;;;;;;;;;;;;;;;;;;;KA8BA,8BAAA,GAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkC7B,wBAAA,WACN,kCACP"}

package/hooks/use-conversation-lifecycle.js

@@ -0,0 +1,54 @@
+import { PENDING_CONVERSATION_ID } from "../utils/id.js";
+import { useCallback, useEffect, useRef, useState } from "react";
+
+//#region src/hooks/use-conversation-lifecycle.ts
+/**
+* Manages the lifecycle of a conversation, handling the transition from
+* a pending state (showing default messages) to a real conversation
+* (with backend persistence).
+*
+* This hook simplifies the logic of:
+* - Starting with default/welcome messages
+* - Creating the conversation only when user sends first message
+* - Transitioning from pending → real conversation ID
+*
+* @example
+* ```tsx
+* const { conversationId, isPending, realConversationId } = useConversationLifecycle({
+*   initialConversationId: params.conversationId,
+*   visitorId: visitor?.id,
+* });
+*
+* // conversationId is always a string (never null)
+* // isPending tells you if it's a real conversation or not
+* // realConversationId is null when isPending=true, otherwise it's the real ID
+* ```
+*/
+function useConversationLifecycle(options = {}) {
+	const { initialConversationId = PENDING_CONVERSATION_ID, onConversationCreated } = options;
+	const [conversationId, setConversationIdState] = useState(initialConversationId);
+	const onConversationCreatedRef = useRef(onConversationCreated);
+	useEffect(() => {
+		onConversationCreatedRef.current = onConversationCreated;
+	}, [onConversationCreated]);
+	const setConversationId = useCallback((newId) => {
+		setConversationIdState((current) => {
+			if (current === PENDING_CONVERSATION_ID && newId !== PENDING_CONVERSATION_ID) onConversationCreatedRef.current?.(newId);
+			return newId;
+		});
+	}, []);
+	const isPending = conversationId === PENDING_CONVERSATION_ID;
+	const realConversationId = isPending ? null : conversationId;
+	const isNewConversation = useCallback(() => conversationId === PENDING_CONVERSATION_ID, [conversationId]);
+	return {
+		conversationId,
+		isPending,
+		realConversationId,
+		setConversationId,
+		isNewConversation
+	};
+}
+
+//#endregion
+export { useConversationLifecycle };
+//# sourceMappingURL=use-conversation-lifecycle.js.map

package/hooks/use-conversation-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-lifecycle.js","names":[],"sources":["../../src/hooks/use-conversation-lifecycle.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { PENDING_CONVERSATION_ID } from \"../utils/id\";\n\nexport type ConversationLifecycleState = {\n\t/**\n\t * The current conversation ID. Always a string, never null.\n\t * Will be PENDING_CONVERSATION_ID if no real conversation exists yet.\n\t */\n\tconversationId: string;\n\n\t/**\n\t * Whether this is a pending (not yet created) conversation.\n\t * True = showing default messages, no backend conversation yet.\n\t * False = real conversation exists on backend.\n\t */\n\tisPending: boolean;\n\n\t/**\n\t * The real conversation ID if one exists, otherwise null.\n\t * Use this when you need to pass to API calls that require an existing conversation.\n\t */\n\trealConversationId: string | null;\n};\n\nexport type UseConversationLifecycleOptions = {\n\t/**\n\t * Initial conversation ID from URL or navigation state.\n\t * Can be PENDING_CONVERSATION_ID or a real conversation ID.\n\t */\n\tinitialConversationId?: string;\n\n\t/**\n\t * Whether to automatically create a conversation on mount.\n\t * If false, conversation will only be created when user sends first message.\n\t * Default: false (lazy creation)\n\t */\n\tautoCreate?: boolean;\n\n\t/**\n\t * Visitor ID to associate with the conversation.\n\t */\n\tvisitorId?: string;\n\n\t/**\n\t * Website ID to associate with the conversation.\n\t */\n\twebsiteId?: string | null;\n\n\t/**\n\t * Callback when conversation is created.\n\t */\n\tonConversationCreated?: (conversationId: string) => void;\n};\n\nexport type UseConversationLifecycleReturn = ConversationLifecycleState & {\n\t/**\n\t * Update the conversation ID (e.g., after creation or navigation).\n\t */\n\tsetConversationId: (conversationId: string) => void;\n\n\t/**\n\t * Check if this is a new/pending conversation.\n\t */\n\tisNewConversation: () => boolean;\n};\n\n/**\n * Manages the lifecycle of a conversation, handling the transition from\n * a pending state (showing default messages) to a real conversation\n * (with backend persistence).\n *\n * This hook simplifies the logic of:\n * - Starting with default/welcome messages\n * - Creating the conversation only when user sends first message\n * - Transitioning from pending → real conversation ID\n *\n * @example\n * ```tsx\n * const { conversationId, isPending, realConversationId } = useConversationLifecycle({\n *   initialConversationId: params.conversationId,\n *   visitorId: visitor?.id,\n * });\n *\n * // conversationId is always a string (never null)\n * // isPending tells you if it's a real conversation or not\n * // realConversationId is null when isPending=true, otherwise it's the real ID\n * ```\n */\nexport function useConversationLifecycle(\n\toptions: UseConversationLifecycleOptions = {}\n): UseConversationLifecycleReturn {\n\tconst {\n\t\tinitialConversationId = PENDING_CONVERSATION_ID,\n\t\tonConversationCreated,\n\t} = options;\n\n\tconst [conversationId, setConversationIdState] = useState(\n\t\tinitialConversationId\n\t);\n\tconst onConversationCreatedRef = useRef(onConversationCreated);\n\n\t// Keep callback ref up to date\n\tuseEffect(() => {\n\t\tonConversationCreatedRef.current = onConversationCreated;\n\t}, [onConversationCreated]);\n\n\tconst setConversationId = useCallback((newId: string) => {\n\t\tsetConversationIdState((current) => {\n\t\t\t// Only trigger callback if transitioning from pending to real\n\t\t\tif (\n\t\t\t\tcurrent === PENDING_CONVERSATION_ID &&\n\t\t\t\tnewId !== PENDING_CONVERSATION_ID\n\t\t\t) {\n\t\t\t\tonConversationCreatedRef.current?.(newId);\n\t\t\t}\n\t\t\treturn newId;\n\t\t});\n\t}, []);\n\n\tconst isPending = conversationId === PENDING_CONVERSATION_ID;\n\tconst realConversationId = isPending ? null : conversationId;\n\n\tconst isNewConversation = useCallback(\n\t\t() => conversationId === PENDING_CONVERSATION_ID,\n\t\t[conversationId]\n\t);\n\n\treturn {\n\t\tconversationId,\n\t\tisPending,\n\t\trealConversationId,\n\t\tsetConversationId,\n\t\tisNewConversation,\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwFA,SAAgB,yBACf,UAA2C,EAAE,EACZ;CACjC,MAAM,EACL,wBAAwB,yBACxB,0BACG;CAEJ,MAAM,CAAC,gBAAgB,0BAA0B,SAChD,sBACA;CACD,MAAM,2BAA2B,OAAO,sBAAsB;AAG9D,iBAAgB;AACf,2BAAyB,UAAU;IACjC,CAAC,sBAAsB,CAAC;CAE3B,MAAM,oBAAoB,aAAa,UAAkB;AACxD,0BAAwB,YAAY;AAEnC,OACC,YAAY,2BACZ,UAAU,wBAEV,0BAAyB,UAAU,MAAM;AAE1C,UAAO;IACN;IACA,EAAE,CAAC;CAEN,MAAM,YAAY,mBAAmB;CACrC,MAAM,qBAAqB,YAAY,OAAO;CAE9C,MAAM,oBAAoB,kBACnB,mBAAmB,yBACzB,CAAC,eAAe,CAChB;AAED,QAAO;EACN;EACA;EACA;EACA;EACA;EACA"}

package/hooks/use-conversation-page.d.ts

@@ -0,0 +1,82 @@
+import { TimelineItem } from "../timeline-item.js";
+
+//#region src/hooks/use-conversation-page.d.ts
+type UseConversationPageOptions = {
+  /**
+   * Initial conversation ID (from URL params, navigation state, etc.)
+   * Can be PENDING_CONVERSATION_ID or a real ID.
+   */
+  conversationId: string;
+  /**
+   * Optional initial message to send when the conversation opens.
+   */
+  initialMessage?: string;
+  /**
+   * Callback when conversation ID changes (e.g., after creation).
+   * Use this to update navigation state or URL.
+   */
+  onConversationIdChange?: (conversationId: string) => void;
+  /**
+   * Optional timeline items to pass through (e.g., optimistic updates).
+   */
+  items?: TimelineItem[];
+};
+type UseConversationPageReturn = {
+  conversationId: string;
+  isPending: boolean;
+  items: TimelineItem[];
+  isLoading: boolean;
+  error: Error | null;
+  composer: {
+    message: string;
+    files: File[];
+    isSubmitting: boolean;
+    canSubmit: boolean;
+    setMessage: (message: string) => void;
+    addFiles: (files: File[]) => void;
+    removeFile: (index: number) => void;
+    submit: () => void;
+  };
+  hasItems: boolean;
+  lastTimelineItem: TimelineItem | null;
+};
+/**
+ * Main orchestrator hook for the conversation page.
+ *
+ * This hook combines all conversation-related logic:
+ * - Lifecycle management (pending → real conversation)
+ * - Message fetching and display
+ * - Message composition and sending
+ * - Automatic seen tracking
+ * - Default/welcome messages before conversation is created
+ *
+ * It provides a clean, simple API for building conversation UIs.
+ *
+ * @example
+ * ```tsx
+ * export function ConversationPage({ conversationId: initialId }) {
+ *   const conversation = useConversationPage({
+ *     conversationId: initialId,
+ *     onConversationIdChange: (newId) => {
+ *       // Update URL or navigation state
+ *       navigate(`/conversation/${newId}`);
+ *     },
+ *   });
+ *
+ *   return (
+ *     <>
+ *       <MessageList messages={conversation.messages} />
+ *       <MessageInput
+ *         value={conversation.composer.message}
+ *         onChange={conversation.composer.setMessage}
+ *         onSubmit={conversation.composer.submit}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function useConversationPage(options: UseConversationPageOptions): UseConversationPageReturn;
+//#endregion
+export { UseConversationPageOptions, UseConversationPageReturn, useConversationPage };
+//# sourceMappingURL=use-conversation-page.d.ts.map

package/hooks/use-conversation-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-page.d.ts","names":[],"sources":["../../src/hooks/use-conversation-page.ts"],"sourcesContent":[],"mappings":";;;KASY,0BAAA;;AAAZ;AAwBA;;gBAIQ,EAAA,MAAA;;;;gBAkBW,CAAA,EAAA,MAAA;EAAY;AAuC/B;;;wBAEG,CAAA,EAAA,CAAA,cAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAAyB;;;UAlEnB;;KAGG,yBAAA;;;SAIJ;;SAEA;;;WAKC;;;;sBAIW;;;;;oBAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCH,mBAAA,UACN,6BACP"}

package/hooks/use-conversation-page.js

@@ -0,0 +1,138 @@
+import { useConversationAutoSeen } from "./use-conversation-auto-seen.js";
+import { useConversationLifecycle } from "./use-conversation-lifecycle.js";
+import { useConversationTimelineItems } from "./use-conversation-timeline-items.js";
+import { useMessageComposer } from "./use-message-composer.js";
+import { useSupport } from "../provider.js";
+import { useDefaultMessages } from "./private/use-default-messages.js";
+import { useEffect, useMemo, useRef } from "react";
+
+//#region src/hooks/use-conversation-page.ts
+/**
+* Main orchestrator hook for the conversation page.
+*
+* This hook combines all conversation-related logic:
+* - Lifecycle management (pending → real conversation)
+* - Message fetching and display
+* - Message composition and sending
+* - Automatic seen tracking
+* - Default/welcome messages before conversation is created
+*
+* It provides a clean, simple API for building conversation UIs.
+*
+* @example
+* ```tsx
+* export function ConversationPage({ conversationId: initialId }) {
+*   const conversation = useConversationPage({
+*     conversationId: initialId,
+*     onConversationIdChange: (newId) => {
+*       // Update URL or navigation state
+*       navigate(`/conversation/${newId}`);
+*     },
+*   });
+*
+*   return (
+*     <>
+*       <MessageList messages={conversation.messages} />
+*       <MessageInput
+*         value={conversation.composer.message}
+*         onChange={conversation.composer.setMessage}
+*         onSubmit={conversation.composer.submit}
+*       />
+*     </>
+*   );
+* }
+* ```
+*/
+function useConversationPage(options) {
+	const { conversationId: initialConversationId, initialMessage, onConversationIdChange, items: passedItems = [] } = options;
+	const { client, visitor } = useSupport();
+	const trimmedInitialMessage = initialMessage?.trim() ?? "";
+	const hasInitialMessage = trimmedInitialMessage.length > 0;
+	const lifecycle = useConversationLifecycle({
+		initialConversationId,
+		onConversationCreated: onConversationIdChange
+	});
+	const defaultTimelineItems = useDefaultMessages({ conversationId: lifecycle.conversationId });
+	const effectiveDefaultTimelineItems = hasInitialMessage ? [] : defaultTimelineItems;
+	const timelineQuery = useConversationTimelineItems(lifecycle.conversationId, { enabled: !lifecycle.isPending });
+	const displayItems = useMemo(() => {
+		if (timelineQuery.items.length > 0) return timelineQuery.items;
+		if (lifecycle.isPending && effectiveDefaultTimelineItems.length > 0) return effectiveDefaultTimelineItems;
+		if (passedItems.length > 0) return passedItems;
+		return [];
+	}, [
+		timelineQuery.items,
+		lifecycle.isPending,
+		effectiveDefaultTimelineItems,
+		passedItems
+	]);
+	const lastTimelineItem = useMemo(() => displayItems.at(-1) ?? null, [displayItems]);
+	const composer = useMessageComposer({
+		client,
+		conversationId: lifecycle.realConversationId,
+		defaultTimelineItems: effectiveDefaultTimelineItems,
+		visitorId: visitor?.id,
+		onMessageSent: (newConversationId) => {
+			if (lifecycle.isPending) lifecycle.setConversationId(newConversationId);
+		}
+	});
+	const initialMessageSubmittedRef = useRef(false);
+	const lastInitialMessageRef = useRef(null);
+	useEffect(() => {
+		if (!hasInitialMessage) {
+			initialMessageSubmittedRef.current = false;
+			lastInitialMessageRef.current = null;
+			return;
+		}
+		if (lastInitialMessageRef.current !== trimmedInitialMessage) {
+			initialMessageSubmittedRef.current = false;
+			lastInitialMessageRef.current = trimmedInitialMessage;
+		}
+		if (!lifecycle.isPending) return;
+		if (composer.message !== trimmedInitialMessage) {
+			composer.setMessage(trimmedInitialMessage);
+			return;
+		}
+		if (initialMessageSubmittedRef.current || composer.isSubmitting || !composer.canSubmit) return;
+		initialMessageSubmittedRef.current = true;
+		composer.submit();
+	}, [
+		hasInitialMessage,
+		lifecycle.isPending,
+		composer.message,
+		composer.setMessage,
+		composer.isSubmitting,
+		composer.canSubmit,
+		composer.submit,
+		trimmedInitialMessage
+	]);
+	useConversationAutoSeen({
+		client,
+		conversationId: lifecycle.realConversationId,
+		visitorId: visitor?.id,
+		lastTimelineItem
+	});
+	return {
+		conversationId: lifecycle.conversationId,
+		isPending: lifecycle.isPending,
+		items: displayItems,
+		isLoading: timelineQuery.isLoading,
+		error: timelineQuery.error || composer.error,
+		composer: {
+			message: composer.message,
+			files: composer.files,
+			isSubmitting: composer.isSubmitting,
+			canSubmit: composer.canSubmit,
+			setMessage: composer.setMessage,
+			addFiles: composer.addFiles,
+			removeFile: composer.removeFile,
+			submit: composer.submit
+		},
+		hasItems: displayItems.length > 0,
+		lastTimelineItem
+	};
+}
+
+//#endregion
+export { useConversationPage };
+//# sourceMappingURL=use-conversation-page.js.map

package/hooks/use-conversation-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-page.js","names":[],"sources":["../../src/hooks/use-conversation-page.ts"],"sourcesContent":["import type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport { useSupport } from \"../provider\";\nimport { useDefaultMessages } from \"./private/use-default-messages\";\nimport { useConversationAutoSeen } from \"./use-conversation-auto-seen\";\nimport { useConversationLifecycle } from \"./use-conversation-lifecycle\";\nimport { useConversationTimelineItems } from \"./use-conversation-timeline-items\";\nimport { useMessageComposer } from \"./use-message-composer\";\n\nexport type UseConversationPageOptions = {\n\t/**\n\t * Initial conversation ID (from URL params, navigation state, etc.)\n\t * Can be PENDING_CONVERSATION_ID or a real ID.\n\t */\n\tconversationId: string;\n\n\t/**\n\t * Optional initial message to send when the conversation opens.\n\t */\n\tinitialMessage?: string;\n\n\t/**\n\t * Callback when conversation ID changes (e.g., after creation).\n\t * Use this to update navigation state or URL.\n\t */\n\tonConversationIdChange?: (conversationId: string) => void;\n\n\t/**\n\t * Optional timeline items to pass through (e.g., optimistic updates).\n\t */\n\titems?: TimelineItem[];\n};\n\nexport type UseConversationPageReturn = {\n\t// Conversation state\n\tconversationId: string;\n\tisPending: boolean;\n\titems: TimelineItem[];\n\tisLoading: boolean;\n\terror: Error | null;\n\n\t// Message composer\n\tcomposer: {\n\t\tmessage: string;\n\t\tfiles: File[];\n\t\tisSubmitting: boolean;\n\t\tcanSubmit: boolean;\n\t\tsetMessage: (message: string) => void;\n\t\taddFiles: (files: File[]) => void;\n\t\tremoveFile: (index: number) => void;\n\t\tsubmit: () => void;\n\t};\n\n\t// UI helpers\n\thasItems: boolean;\n\tlastTimelineItem: TimelineItem | null;\n};\n\n/**\n * Main orchestrator hook for the conversation page.\n *\n * This hook combines all conversation-related logic:\n * - Lifecycle management (pending → real conversation)\n * - Message fetching and display\n * - Message composition and sending\n * - Automatic seen tracking\n * - Default/welcome messages before conversation is created\n *\n * It provides a clean, simple API for building conversation UIs.\n *\n * @example\n * ```tsx\n * export function ConversationPage({ conversationId: initialId }) {\n *   const conversation = useConversationPage({\n *     conversationId: initialId,\n *     onConversationIdChange: (newId) => {\n *       // Update URL or navigation state\n *       navigate(`/conversation/${newId}`);\n *     },\n *   });\n *\n *   return (\n *     <>\n *       <MessageList messages={conversation.messages} />\n *       <MessageInput\n *         value={conversation.composer.message}\n *         onChange={conversation.composer.setMessage}\n *         onSubmit={conversation.composer.submit}\n *       />\n *     </>\n *   );\n * }\n * ```\n */\nexport function useConversationPage(\n\toptions: UseConversationPageOptions\n): UseConversationPageReturn {\n\tconst {\n\t\tconversationId: initialConversationId,\n\t\tinitialMessage,\n\t\tonConversationIdChange,\n\t\titems: passedItems = [],\n\t} = options;\n\n\tconst { client, visitor } = useSupport();\n\n\tconst trimmedInitialMessage = initialMessage?.trim() ?? \"\";\n\tconst hasInitialMessage = trimmedInitialMessage.length > 0;\n\n\t// 1. Manage conversation lifecycle (pending vs real)\n\tconst lifecycle = useConversationLifecycle({\n\t\tinitialConversationId,\n\t\tonConversationCreated: onConversationIdChange,\n\t});\n\n\t// 2. Get default timeline items for pending state\n\tconst defaultTimelineItems = useDefaultMessages({\n\t\tconversationId: lifecycle.conversationId,\n\t});\n\n\tconst effectiveDefaultTimelineItems = hasInitialMessage\n\t\t? []\n\t\t: defaultTimelineItems;\n\n\t// 3. Fetch timeline items from backend if real conversation exists\n\tconst timelineQuery = useConversationTimelineItems(lifecycle.conversationId, {\n\t\tenabled: !lifecycle.isPending,\n\t});\n\n\t// 4. Determine which items to display\n\tconst displayItems = useMemo(() => {\n\t\t// If we have fetched timeline items, use them\n\t\tif (timelineQuery.items.length > 0) {\n\t\t\treturn timelineQuery.items;\n\t\t}\n\n\t\t// If pending, use default timeline items\n\t\tif (lifecycle.isPending && effectiveDefaultTimelineItems.length > 0) {\n\t\t\treturn effectiveDefaultTimelineItems;\n\t\t}\n\n\t\t// Use passed items as fallback\n\t\tif (passedItems.length > 0) {\n\t\t\treturn passedItems;\n\t\t}\n\n\t\treturn [];\n\t}, [\n\t\ttimelineQuery.items,\n\t\tlifecycle.isPending,\n\t\teffectiveDefaultTimelineItems,\n\t\tpassedItems,\n\t]);\n\n\tconst lastTimelineItem = useMemo(\n\t\t() => displayItems.at(-1) ?? null,\n\t\t[displayItems]\n\t);\n\n\t// 5. Set up message composer\n\tconst composer = useMessageComposer({\n\t\tclient,\n\t\tconversationId: lifecycle.realConversationId,\n\t\tdefaultTimelineItems: effectiveDefaultTimelineItems,\n\t\tvisitorId: visitor?.id,\n\t\tonMessageSent: (newConversationId) => {\n\t\t\t// Transition from pending to real conversation\n\t\t\tif (lifecycle.isPending) {\n\t\t\t\tlifecycle.setConversationId(newConversationId);\n\t\t\t}\n\t\t},\n\t});\n\n\tconst initialMessageSubmittedRef = useRef(false);\n\tconst lastInitialMessageRef = useRef<string | null>(null);\n\n\tuseEffect(() => {\n\t\tif (!hasInitialMessage) {\n\t\t\tinitialMessageSubmittedRef.current = false;\n\t\t\tlastInitialMessageRef.current = null;\n\t\t\treturn;\n\t\t}\n\n\t\tif (lastInitialMessageRef.current !== trimmedInitialMessage) {\n\t\t\tinitialMessageSubmittedRef.current = false;\n\t\t\tlastInitialMessageRef.current = trimmedInitialMessage;\n\t\t}\n\n\t\tif (!lifecycle.isPending) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (composer.message !== trimmedInitialMessage) {\n\t\t\tcomposer.setMessage(trimmedInitialMessage);\n\t\t\treturn;\n\t\t}\n\n\t\tif (\n\t\t\tinitialMessageSubmittedRef.current ||\n\t\t\tcomposer.isSubmitting ||\n\t\t\t!composer.canSubmit\n\t\t) {\n\t\t\treturn;\n\t\t}\n\n\t\tinitialMessageSubmittedRef.current = true;\n\t\tcomposer.submit();\n\t}, [\n\t\thasInitialMessage,\n\t\tlifecycle.isPending,\n\t\tcomposer.message,\n\t\tcomposer.setMessage,\n\t\tcomposer.isSubmitting,\n\t\tcomposer.canSubmit,\n\t\tcomposer.submit,\n\t\ttrimmedInitialMessage,\n\t]);\n\n\t// 6. Auto-mark messages as seen\n\tuseConversationAutoSeen({\n\t\tclient,\n\t\tconversationId: lifecycle.realConversationId,\n\t\tvisitorId: visitor?.id,\n\t\tlastTimelineItem,\n\t});\n\n\treturn {\n\t\tconversationId: lifecycle.conversationId,\n\t\tisPending: lifecycle.isPending,\n\t\titems: displayItems,\n\t\tisLoading: timelineQuery.isLoading,\n\t\terror: timelineQuery.error || composer.error,\n\t\tcomposer: {\n\t\t\tmessage: composer.message,\n\t\t\tfiles: composer.files,\n\t\t\tisSubmitting: composer.isSubmitting,\n\t\t\tcanSubmit: composer.canSubmit,\n\t\t\tsetMessage: composer.setMessage,\n\t\t\taddFiles: composer.addFiles,\n\t\t\tremoveFile: composer.removeFile,\n\t\t\tsubmit: composer.submit,\n\t\t},\n\t\thasItems: displayItems.length > 0,\n\t\tlastTimelineItem,\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8FA,SAAgB,oBACf,SAC4B;CAC5B,MAAM,EACL,gBAAgB,uBAChB,gBACA,wBACA,OAAO,cAAc,EAAE,KACpB;CAEJ,MAAM,EAAE,QAAQ,YAAY,YAAY;CAExC,MAAM,wBAAwB,gBAAgB,MAAM,IAAI;CACxD,MAAM,oBAAoB,sBAAsB,SAAS;CAGzD,MAAM,YAAY,yBAAyB;EAC1C;EACA,uBAAuB;EACvB,CAAC;CAGF,MAAM,uBAAuB,mBAAmB,EAC/C,gBAAgB,UAAU,gBAC1B,CAAC;CAEF,MAAM,gCAAgC,oBACnC,EAAE,GACF;CAGH,MAAM,gBAAgB,6BAA6B,UAAU,gBAAgB,EAC5E,SAAS,CAAC,UAAU,WACpB,CAAC;CAGF,MAAM,eAAe,cAAc;AAElC,MAAI,cAAc,MAAM,SAAS,EAChC,QAAO,cAAc;AAItB,MAAI,UAAU,aAAa,8BAA8B,SAAS,EACjE,QAAO;AAIR,MAAI,YAAY,SAAS,EACxB,QAAO;AAGR,SAAO,EAAE;IACP;EACF,cAAc;EACd,UAAU;EACV;EACA;EACA,CAAC;CAEF,MAAM,mBAAmB,cAClB,aAAa,GAAG,GAAG,IAAI,MAC7B,CAAC,aAAa,CACd;CAGD,MAAM,WAAW,mBAAmB;EACnC;EACA,gBAAgB,UAAU;EAC1B,sBAAsB;EACtB,WAAW,SAAS;EACpB,gBAAgB,sBAAsB;AAErC,OAAI,UAAU,UACb,WAAU,kBAAkB,kBAAkB;;EAGhD,CAAC;CAEF,MAAM,6BAA6B,OAAO,MAAM;CAChD,MAAM,wBAAwB,OAAsB,KAAK;AAEzD,iBAAgB;AACf,MAAI,CAAC,mBAAmB;AACvB,8BAA2B,UAAU;AACrC,yBAAsB,UAAU;AAChC;;AAGD,MAAI,sBAAsB,YAAY,uBAAuB;AAC5D,8BAA2B,UAAU;AACrC,yBAAsB,UAAU;;AAGjC,MAAI,CAAC,UAAU,UACd;AAGD,MAAI,SAAS,YAAY,uBAAuB;AAC/C,YAAS,WAAW,sBAAsB;AAC1C;;AAGD,MACC,2BAA2B,WAC3B,SAAS,gBACT,CAAC,SAAS,UAEV;AAGD,6BAA2B,UAAU;AACrC,WAAS,QAAQ;IACf;EACF;EACA,UAAU;EACV,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT;EACA,CAAC;AAGF,yBAAwB;EACvB;EACA,gBAAgB,UAAU;EAC1B,WAAW,SAAS;EACpB;EACA,CAAC;AAEF,QAAO;EACN,gBAAgB,UAAU;EAC1B,WAAW,UAAU;EACrB,OAAO;EACP,WAAW,cAAc;EACzB,OAAO,cAAc,SAAS,SAAS;EACvC,UAAU;GACT,SAAS,SAAS;GAClB,OAAO,SAAS;GAChB,cAAc,SAAS;GACvB,WAAW,SAAS;GACpB,YAAY,SAAS;GACrB,UAAU,SAAS;GACnB,YAAY,SAAS;GACrB,QAAQ,SAAS;GACjB;EACD,UAAU,aAAa,SAAS;EAChC;EACA"}

package/hooks/use-conversation-seen.d.ts

@@ -0,0 +1,17 @@
+import { ConversationSeen } from "../schemas.js";
+
+//#region src/hooks/use-conversation-seen.d.ts
+type UseConversationSeenOptions = {
+  initialData?: ConversationSeen[];
+};
+declare function useConversationSeen(conversationId: string | null | undefined, options?: UseConversationSeenOptions): ConversationSeen[];
+/**
+ * Debounced version of useConversationSeen that delays updates by 500ms
+ * to prevent animation conflicts when messages are sent and immediately seen.
+ *
+ * Use this in UI components where smooth animations are critical.
+ */
+declare function useDebouncedConversationSeen(conversationId: string | null | undefined, options?: UseConversationSeenOptions, delay?: number): ConversationSeen[];
+//#endregion
+export { useConversationSeen, useDebouncedConversationSeen };
+//# sourceMappingURL=use-conversation-seen.d.ts.map

package/hooks/use-conversation-seen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-seen.d.ts","names":[],"sources":["../../src/hooks/use-conversation-seen.ts"],"sourcesContent":[],"mappings":";;;KAIK,0BAAA;gBACU;AALmD,CAAA;AAgBlD,iBAAA,mBAAA,CAAmB,cAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EAEzB,0BAFyB,CAAA,EAGhC,gBAHgC,EAAA;;;;;AAwDnC;;AAEU,iBAFM,4BAAA,CAEN,cAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EAAA,0BAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EAEP,gBAFO,EAAA"}

package/hooks/use-conversation-seen.js

@@ -0,0 +1,58 @@
+import { hydrateConversationSeen, useSeenStore } from "../realtime/seen-store.js";
+import { useEffect, useMemo, useRef, useState } from "react";
+
+//#region src/hooks/use-conversation-seen.ts
+function buildSeenId(conversationId, actorType, actorId) {
+	return `${conversationId}-${actorType}-${actorId}`;
+}
+function useConversationSeen(conversationId, options = {}) {
+	const { initialData } = options;
+	const hydratedKeyRef = useRef(null);
+	useEffect(() => {
+		if (!(conversationId && initialData) || initialData.length === 0) return;
+		const hydrationKey = `${conversationId}:${initialData.map((entry) => `${entry.id}:${new Date(entry.updatedAt).getTime()}`).join("|")}`;
+		if (hydratedKeyRef.current === hydrationKey) return;
+		hydrateConversationSeen(conversationId, initialData);
+		hydratedKeyRef.current = hydrationKey;
+	}, [conversationId, initialData]);
+	const conversationSeen = useSeenStore((state) => conversationId ? state.conversations[conversationId] ?? null : null);
+	return useMemo(() => {
+		if (!(conversationId && conversationSeen)) return [];
+		return Object.values(conversationSeen).map((entry) => ({
+			id: buildSeenId(conversationId, entry.actorType, entry.actorId),
+			conversationId,
+			userId: entry.actorType === "user" ? entry.actorId : null,
+			visitorId: entry.actorType === "visitor" ? entry.actorId : null,
+			aiAgentId: entry.actorType === "ai_agent" ? entry.actorId : null,
+			lastSeenAt: entry.lastSeenAt,
+			createdAt: entry.lastSeenAt,
+			updatedAt: entry.lastSeenAt,
+			deletedAt: null
+		}));
+	}, [conversationId, conversationSeen]);
+}
+/**
+* Debounced version of useConversationSeen that delays updates by 500ms
+* to prevent animation conflicts when messages are sent and immediately seen.
+*
+* Use this in UI components where smooth animations are critical.
+*/
+function useDebouncedConversationSeen(conversationId, options = {}, delay = 500) {
+	const seenData = useConversationSeen(conversationId, options);
+	const [debouncedSeenData, setDebouncedSeenData] = useState(seenData);
+	const timeoutRef = useRef(null);
+	useEffect(() => {
+		if (timeoutRef.current) clearTimeout(timeoutRef.current);
+		timeoutRef.current = setTimeout(() => {
+			setDebouncedSeenData(seenData);
+		}, delay);
+		return () => {
+			if (timeoutRef.current) clearTimeout(timeoutRef.current);
+		};
+	}, [seenData, delay]);
+	return debouncedSeenData;
+}
+
+//#endregion
+export { useConversationSeen, useDebouncedConversationSeen };
+//# sourceMappingURL=use-conversation-seen.js.map

package/hooks/use-conversation-seen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-seen.js","names":[],"sources":["../../src/hooks/use-conversation-seen.ts"],"sourcesContent":["import type { ConversationSeen } from \"@cossistant/types/schemas\";\nimport { useEffect, useMemo, useRef, useState } from \"react\";\nimport { hydrateConversationSeen, useSeenStore } from \"../realtime/seen-store\";\n\ntype UseConversationSeenOptions = {\n\tinitialData?: ConversationSeen[];\n};\n\nfunction buildSeenId(\n\tconversationId: string,\n\tactorType: string,\n\tactorId: string\n) {\n\treturn `${conversationId}-${actorType}-${actorId}`;\n}\n\nexport function useConversationSeen(\n\tconversationId: string | null | undefined,\n\toptions: UseConversationSeenOptions = {}\n): ConversationSeen[] {\n\tconst { initialData } = options;\n\tconst hydratedKeyRef = useRef<string | null>(null);\n\n\tuseEffect(() => {\n\t\tif (!(conversationId && initialData) || initialData.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst hydrationKey = `${conversationId}:${initialData\n\t\t\t.map((entry) => `${entry.id}:${new Date(entry.updatedAt).getTime()}`)\n\t\t\t.join(\"|\")}`;\n\n\t\tif (hydratedKeyRef.current === hydrationKey) {\n\t\t\treturn;\n\t\t}\n\n\t\thydrateConversationSeen(conversationId, initialData);\n\t\thydratedKeyRef.current = hydrationKey;\n\t}, [conversationId, initialData]);\n\n\tconst conversationSeen = useSeenStore((state) =>\n\t\tconversationId ? (state.conversations[conversationId] ?? null) : null\n\t);\n\n\treturn useMemo(() => {\n\t\tif (!(conversationId && conversationSeen)) {\n\t\t\treturn [];\n\t\t}\n\n\t\treturn Object.values(conversationSeen).map(\n\t\t\t(entry) =>\n\t\t\t\t({\n\t\t\t\t\tid: buildSeenId(conversationId, entry.actorType, entry.actorId),\n\t\t\t\t\tconversationId,\n\t\t\t\t\tuserId: entry.actorType === \"user\" ? entry.actorId : null,\n\t\t\t\t\tvisitorId: entry.actorType === \"visitor\" ? entry.actorId : null,\n\t\t\t\t\taiAgentId: entry.actorType === \"ai_agent\" ? entry.actorId : null,\n\t\t\t\t\tlastSeenAt: entry.lastSeenAt,\n\t\t\t\t\tcreatedAt: entry.lastSeenAt,\n\t\t\t\t\tupdatedAt: entry.lastSeenAt,\n\t\t\t\t\tdeletedAt: null,\n\t\t\t\t}) satisfies ConversationSeen\n\t\t);\n\t}, [conversationId, conversationSeen]);\n}\n\n/**\n * Debounced version of useConversationSeen that delays updates by 500ms\n * to prevent animation conflicts when messages are sent and immediately seen.\n *\n * Use this in UI components where smooth animations are critical.\n */\nexport function useDebouncedConversationSeen(\n\tconversationId: string | null | undefined,\n\toptions: UseConversationSeenOptions = {},\n\tdelay = 500\n): ConversationSeen[] {\n\tconst seenData = useConversationSeen(conversationId, options);\n\tconst [debouncedSeenData, setDebouncedSeenData] =\n\t\tuseState<ConversationSeen[]>(seenData);\n\tconst timeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n\tuseEffect(() => {\n\t\t// Clear any pending timeout\n\t\tif (timeoutRef.current) {\n\t\t\tclearTimeout(timeoutRef.current);\n\t\t}\n\n\t\t// Set new timeout to update after delay\n\t\ttimeoutRef.current = setTimeout(() => {\n\t\t\tsetDebouncedSeenData(seenData);\n\t\t}, delay);\n\n\t\t// Cleanup on unmount or when seenData changes\n\t\treturn () => {\n\t\t\tif (timeoutRef.current) {\n\t\t\t\tclearTimeout(timeoutRef.current);\n\t\t\t}\n\t\t};\n\t}, [seenData, delay]);\n\n\treturn debouncedSeenData;\n}\n"],"mappings":";;;;AAQA,SAAS,YACR,gBACA,WACA,SACC;AACD,QAAO,GAAG,eAAe,GAAG,UAAU,GAAG;;AAG1C,SAAgB,oBACf,gBACA,UAAsC,EAAE,EACnB;CACrB,MAAM,EAAE,gBAAgB;CACxB,MAAM,iBAAiB,OAAsB,KAAK;AAElD,iBAAgB;AACf,MAAI,EAAE,kBAAkB,gBAAgB,YAAY,WAAW,EAC9D;EAGD,MAAM,eAAe,GAAG,eAAe,GAAG,YACxC,KAAK,UAAU,GAAG,MAAM,GAAG,GAAG,IAAI,KAAK,MAAM,UAAU,CAAC,SAAS,GAAG,CACpE,KAAK,IAAI;AAEX,MAAI,eAAe,YAAY,aAC9B;AAGD,0BAAwB,gBAAgB,YAAY;AACpD,iBAAe,UAAU;IACvB,CAAC,gBAAgB,YAAY,CAAC;CAEjC,MAAM,mBAAmB,cAAc,UACtC,iBAAkB,MAAM,cAAc,mBAAmB,OAAQ,KACjE;AAED,QAAO,cAAc;AACpB,MAAI,EAAE,kBAAkB,kBACvB,QAAO,EAAE;AAGV,SAAO,OAAO,OAAO,iBAAiB,CAAC,KACrC,WACC;GACA,IAAI,YAAY,gBAAgB,MAAM,WAAW,MAAM,QAAQ;GAC/D;GACA,QAAQ,MAAM,cAAc,SAAS,MAAM,UAAU;GACrD,WAAW,MAAM,cAAc,YAAY,MAAM,UAAU;GAC3D,WAAW,MAAM,cAAc,aAAa,MAAM,UAAU;GAC5D,YAAY,MAAM;GAClB,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,WAAW;GACX,EACF;IACC,CAAC,gBAAgB,iBAAiB,CAAC;;;;;;;;AASvC,SAAgB,6BACf,gBACA,UAAsC,EAAE,EACxC,QAAQ,KACa;CACrB,MAAM,WAAW,oBAAoB,gBAAgB,QAAQ;CAC7D,MAAM,CAAC,mBAAmB,wBACzB,SAA6B,SAAS;CACvC,MAAM,aAAa,OAA8B,KAAK;AAEtD,iBAAgB;AAEf,MAAI,WAAW,QACd,cAAa,WAAW,QAAQ;AAIjC,aAAW,UAAU,iBAAiB;AACrC,wBAAqB,SAAS;KAC5B,MAAM;AAGT,eAAa;AACZ,OAAI,WAAW,QACd,cAAa,WAAW,QAAQ;;IAGhC,CAAC,UAAU,MAAM,CAAC;AAErB,QAAO"}

package/hooks/use-conversation-timeline-items.d.ts

@@ -0,0 +1,21 @@
+import { GetConversationTimelineItemsRequest, GetConversationTimelineItemsResponse } from "../timeline-item.js";
+import { ConversationTimelineItemsState } from "@cossistant/core";
+
+//#region src/hooks/use-conversation-timeline-items.d.ts
+type UseConversationTimelineItemsOptions = {
+  limit?: number;
+  cursor?: string | null;
+  enabled?: boolean;
+  refetchInterval?: number | false;
+  refetchOnWindowFocus?: boolean;
+};
+type UseConversationTimelineItemsResult = ConversationTimelineItemsState & {
+  isLoading: boolean;
+  error: Error | null;
+  refetch: (args?: Pick<GetConversationTimelineItemsRequest, "cursor" | "limit">) => Promise<GetConversationTimelineItemsResponse | undefined>;
+  fetchNextPage: () => Promise<GetConversationTimelineItemsResponse | undefined>;
+};
+declare function useConversationTimelineItems(conversationId: string | null | undefined, options?: UseConversationTimelineItemsOptions): UseConversationTimelineItemsResult;
+//#endregion
+export { UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, useConversationTimelineItems };
+//# sourceMappingURL=use-conversation-timeline-items.d.ts.map

package/hooks/use-conversation-timeline-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-timeline-items.d.ts","names":[],"sources":["../../src/hooks/use-conversation-timeline-items.ts"],"sourcesContent":[],"mappings":";;;;KAoBY,mCAAA;;EAAA,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAQA,OAAA,CAAA,EAAA,OAAA;EAAkC,eAAA,CAAA,EAAA,MAAA,GAAA,KAAA;sBAC7C,CAAA,EAAA,OAAA;;AAIc,KALH,kCAAA,GACX,8BAIc,GAAA;WAAL,EAAA,OAAA;OACK,EAHN,KAGM,GAAA,IAAA;SAAR,EAAA,CAAA,IAAA,CAAA,EADG,IACH,CADQ,mCACR,EAAA,QAAA,GAAA,OAAA,CAAA,EAAA,GAAA,OAAA,CAAQ,oCAAR,GAAA,SAAA,CAAA;eAEJ,EAAA,GAAA,GADoB,OACpB,CAAA,oCAAA,GAAA,SAAA,CAAA;;AAD2B,iBAKd,4BAAA,CALc,cAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EAOpB,mCAPoB,CAAA,EAQ3B,kCAR2B"}