@cossistant/react 0.0.1

package/hooks/use-conversation-timeline-items.js

@@ -0,0 +1,87 @@
+import { useClientQuery } from "./private/use-client-query.js";
+import { useStoreSelector } from "./private/store/use-store-selector.js";
+import { useSupport } from "../provider.js";
+import { useCallback, useMemo } from "react";
+
+//#region src/hooks/use-conversation-timeline-items.ts
+const EMPTY_STATE = {
+	items: [],
+	hasNextPage: false,
+	nextCursor: void 0
+};
+const DEFAULT_LIMIT = 50;
+const NO_CONVERSATION_ID = "__no_conversation__";
+function useConversationTimelineItems(conversationId, options = {}) {
+	const { client } = useSupport();
+	const store = client.timelineItemsStore;
+	if (!store) throw new Error("Timeline items store is not available on the client instance");
+	const stableConversationId = conversationId ?? NO_CONVERSATION_ID;
+	const selection = useStoreSelector(store, (state) => state.conversations[stableConversationId] ?? EMPTY_STATE);
+	const baseArgs = useMemo(() => ({
+		limit: options.limit ?? DEFAULT_LIMIT,
+		cursor: options.cursor ?? void 0
+	}), [options.cursor, options.limit]);
+	const { refetch: queryRefetch, isLoading: queryLoading, error } = useClientQuery({
+		client,
+		queryFn: (instance, args) => {
+			if (!conversationId) return Promise.resolve({
+				items: [],
+				hasNextPage: false,
+				nextCursor: null
+			});
+			return instance.getConversationTimelineItems({
+				conversationId,
+				limit: args?.limit ?? baseArgs.limit,
+				cursor: args?.cursor ?? baseArgs.cursor ?? void 0
+			});
+		},
+		enabled: Boolean(conversationId) && (options.enabled ?? true),
+		refetchInterval: options.refetchInterval ?? false,
+		refetchOnWindowFocus: options.refetchOnWindowFocus ?? true,
+		refetchOnMount: selection.items.length === 0,
+		initialArgs: baseArgs,
+		dependencies: [
+			stableConversationId,
+			baseArgs.limit,
+			baseArgs.cursor ?? null
+		]
+	});
+	const refetch = useCallback((args) => {
+		if (!conversationId) return Promise.resolve(void 0);
+		return queryRefetch({
+			limit: baseArgs.limit,
+			cursor: baseArgs.cursor,
+			...args
+		});
+	}, [
+		queryRefetch,
+		baseArgs,
+		conversationId
+	]);
+	const fetchNextPage = useCallback(() => {
+		if (!(selection.hasNextPage && selection.nextCursor)) return Promise.resolve(void 0);
+		return refetch({
+			cursor: selection.nextCursor,
+			limit: baseArgs.limit
+		});
+	}, [
+		selection.hasNextPage,
+		selection.nextCursor,
+		refetch,
+		baseArgs.limit
+	]);
+	const isLoading = selection.items.length === 0 ? queryLoading : false;
+	return {
+		items: selection.items,
+		hasNextPage: selection.hasNextPage,
+		nextCursor: selection.nextCursor,
+		isLoading,
+		error,
+		refetch,
+		fetchNextPage
+	};
+}
+
+//#endregion
+export { useConversationTimelineItems };
+//# sourceMappingURL=use-conversation-timeline-items.js.map

package/hooks/use-conversation-timeline-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-timeline-items.js","names":["EMPTY_STATE: ConversationTimelineItemsState"],"sources":["../../src/hooks/use-conversation-timeline-items.ts"],"sourcesContent":["import type { ConversationTimelineItemsState } from \"@cossistant/core\";\nimport type {\n\tGetConversationTimelineItemsRequest,\n\tGetConversationTimelineItemsResponse,\n} from \"@cossistant/types/api/timeline-item\";\nimport { useCallback, useMemo } from \"react\";\nimport { useSupport } from \"../provider\";\nimport { useStoreSelector } from \"./private/store/use-store-selector\";\nimport { useClientQuery } from \"./private/use-client-query\";\n\nconst EMPTY_STATE: ConversationTimelineItemsState = {\n\titems: [],\n\thasNextPage: false,\n\tnextCursor: undefined,\n};\n\nconst DEFAULT_LIMIT = 50;\n\nconst NO_CONVERSATION_ID = \"__no_conversation__\" as const;\n\nexport type UseConversationTimelineItemsOptions = {\n\tlimit?: number;\n\tcursor?: string | null;\n\tenabled?: boolean;\n\trefetchInterval?: number | false;\n\trefetchOnWindowFocus?: boolean;\n};\n\nexport type UseConversationTimelineItemsResult =\n\tConversationTimelineItemsState & {\n\t\tisLoading: boolean;\n\t\terror: Error | null;\n\t\trefetch: (\n\t\t\targs?: Pick<GetConversationTimelineItemsRequest, \"cursor\" | \"limit\">\n\t\t) => Promise<GetConversationTimelineItemsResponse | undefined>;\n\t\tfetchNextPage: () => Promise<\n\t\t\tGetConversationTimelineItemsResponse | undefined\n\t\t>;\n\t};\n\nexport function useConversationTimelineItems(\n\tconversationId: string | null | undefined,\n\toptions: UseConversationTimelineItemsOptions = {}\n): UseConversationTimelineItemsResult {\n\tconst { client } = useSupport();\n\tconst store = client.timelineItemsStore;\n\n\tif (!store) {\n\t\tthrow new Error(\n\t\t\t\"Timeline items store is not available on the client instance\"\n\t\t);\n\t}\n\n\tconst stableConversationId = conversationId ?? NO_CONVERSATION_ID;\n\n\tconst selection = useStoreSelector(\n\t\tstore,\n\t\t(state) => state.conversations[stableConversationId] ?? EMPTY_STATE\n\t);\n\n\tconst baseArgs = useMemo(\n\t\t() =>\n\t\t\t({\n\t\t\t\tlimit: options.limit ?? DEFAULT_LIMIT,\n\t\t\t\tcursor: options.cursor ?? undefined,\n\t\t\t}) satisfies Pick<\n\t\t\t\tGetConversationTimelineItemsRequest,\n\t\t\t\t\"limit\" | \"cursor\"\n\t\t\t>,\n\t\t[options.cursor, options.limit]\n\t);\n\n\tconst {\n\t\trefetch: queryRefetch,\n\t\tisLoading: queryLoading,\n\t\terror,\n\t} = useClientQuery<\n\t\tGetConversationTimelineItemsResponse,\n\t\tPick<GetConversationTimelineItemsRequest, \"cursor\" | \"limit\">\n\t>({\n\t\tclient,\n\t\tqueryFn: (instance, args) => {\n\t\t\tif (!conversationId) {\n\t\t\t\treturn Promise.resolve({\n\t\t\t\t\titems: [],\n\t\t\t\t\thasNextPage: false,\n\t\t\t\t\tnextCursor: null,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\treturn instance.getConversationTimelineItems({\n\t\t\t\tconversationId,\n\t\t\t\tlimit: args?.limit ?? baseArgs.limit,\n\t\t\t\tcursor: args?.cursor ?? baseArgs.cursor ?? undefined,\n\t\t\t});\n\t\t},\n\t\tenabled: Boolean(conversationId) && (options.enabled ?? true),\n\t\trefetchInterval: options.refetchInterval ?? false,\n\t\trefetchOnWindowFocus: options.refetchOnWindowFocus ?? true,\n\t\trefetchOnMount: selection.items.length === 0,\n\t\tinitialArgs: baseArgs,\n\t\tdependencies: [\n\t\t\tstableConversationId,\n\t\t\tbaseArgs.limit,\n\t\t\tbaseArgs.cursor ?? null,\n\t\t],\n\t});\n\n\tconst refetch = useCallback(\n\t\t(args?: Pick<GetConversationTimelineItemsRequest, \"cursor\" | \"limit\">) => {\n\t\t\tif (!conversationId) {\n\t\t\t\treturn Promise.resolve(undefined);\n\t\t\t}\n\n\t\t\treturn queryRefetch({\n\t\t\t\tlimit: baseArgs.limit,\n\t\t\t\tcursor: baseArgs.cursor,\n\t\t\t\t...args,\n\t\t\t});\n\t\t},\n\t\t[queryRefetch, baseArgs, conversationId]\n\t);\n\n\tconst fetchNextPage = useCallback(() => {\n\t\tif (!(selection.hasNextPage && selection.nextCursor)) {\n\t\t\treturn Promise.resolve(undefined);\n\t\t}\n\n\t\treturn refetch({ cursor: selection.nextCursor, limit: baseArgs.limit });\n\t}, [selection.hasNextPage, selection.nextCursor, refetch, baseArgs.limit]);\n\n\tconst isInitialLoad = selection.items.length === 0;\n\tconst isLoading = isInitialLoad ? queryLoading : false;\n\n\treturn {\n\t\titems: selection.items,\n\t\thasNextPage: selection.hasNextPage,\n\t\tnextCursor: selection.nextCursor,\n\t\tisLoading,\n\t\terror,\n\t\trefetch,\n\t\tfetchNextPage,\n\t};\n}\n"],"mappings":";;;;;;AAUA,MAAMA,cAA8C;CACnD,OAAO,EAAE;CACT,aAAa;CACb,YAAY;CACZ;AAED,MAAM,gBAAgB;AAEtB,MAAM,qBAAqB;AAsB3B,SAAgB,6BACf,gBACA,UAA+C,EAAE,EACZ;CACrC,MAAM,EAAE,WAAW,YAAY;CAC/B,MAAM,QAAQ,OAAO;AAErB,KAAI,CAAC,MACJ,OAAM,IAAI,MACT,+DACA;CAGF,MAAM,uBAAuB,kBAAkB;CAE/C,MAAM,YAAY,iBACjB,QACC,UAAU,MAAM,cAAc,yBAAyB,YACxD;CAED,MAAM,WAAW,eAEd;EACA,OAAO,QAAQ,SAAS;EACxB,QAAQ,QAAQ,UAAU;EAC1B,GAIF,CAAC,QAAQ,QAAQ,QAAQ,MAAM,CAC/B;CAED,MAAM,EACL,SAAS,cACT,WAAW,cACX,UACG,eAGF;EACD;EACA,UAAU,UAAU,SAAS;AAC5B,OAAI,CAAC,eACJ,QAAO,QAAQ,QAAQ;IACtB,OAAO,EAAE;IACT,aAAa;IACb,YAAY;IACZ,CAAC;AAGH,UAAO,SAAS,6BAA6B;IAC5C;IACA,OAAO,MAAM,SAAS,SAAS;IAC/B,QAAQ,MAAM,UAAU,SAAS,UAAU;IAC3C,CAAC;;EAEH,SAAS,QAAQ,eAAe,KAAK,QAAQ,WAAW;EACxD,iBAAiB,QAAQ,mBAAmB;EAC5C,sBAAsB,QAAQ,wBAAwB;EACtD,gBAAgB,UAAU,MAAM,WAAW;EAC3C,aAAa;EACb,cAAc;GACb;GACA,SAAS;GACT,SAAS,UAAU;GACnB;EACD,CAAC;CAEF,MAAM,UAAU,aACd,SAAyE;AACzE,MAAI,CAAC,eACJ,QAAO,QAAQ,QAAQ,OAAU;AAGlC,SAAO,aAAa;GACnB,OAAO,SAAS;GAChB,QAAQ,SAAS;GACjB,GAAG;GACH,CAAC;IAEH;EAAC;EAAc;EAAU;EAAe,CACxC;CAED,MAAM,gBAAgB,kBAAkB;AACvC,MAAI,EAAE,UAAU,eAAe,UAAU,YACxC,QAAO,QAAQ,QAAQ,OAAU;AAGlC,SAAO,QAAQ;GAAE,QAAQ,UAAU;GAAY,OAAO,SAAS;GAAO,CAAC;IACrE;EAAC,UAAU;EAAa,UAAU;EAAY;EAAS,SAAS;EAAM,CAAC;CAG1E,MAAM,YADgB,UAAU,MAAM,WAAW,IACf,eAAe;AAEjD,QAAO;EACN,OAAO,UAAU;EACjB,aAAa,UAAU;EACvB,YAAY,UAAU;EACtB;EACA;EACA;EACA;EACA"}

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

@@ -0,0 +1,13 @@
+import { TypingEntry } from "@cossistant/core";
+
+//#region src/hooks/use-conversation-typing.d.ts
+type ConversationTypingParticipant = TypingEntry;
+type UseConversationTypingOptions = {
+  excludeVisitorId?: string | null;
+  excludeUserId?: string | null;
+  excludeAiAgentId?: string | null;
+};
+declare function useConversationTyping(conversationId: string | null | undefined, options?: UseConversationTypingOptions): ConversationTypingParticipant[];
+//#endregion
+export { ConversationTypingParticipant, useConversationTyping };
+//# sourceMappingURL=use-conversation-typing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-typing.d.ts","names":[],"sources":["../../src/hooks/use-conversation-typing.ts"],"sourcesContent":[],"mappings":";;;KAIY,6BAAA,GAAgC;KAEvC,4BAAA;EAFO,gBAAA,CAAA,EAAA,MAAA,GAAA,IAA6B;EAEpC,aAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAyBW,gBAAA,CAAA,EAAA,MAAqB,GAAA,IAAA;CAAA;AAE3B,iBAFM,qBAAA,CAEN,cAAA,EAAA,MAAA,GAAA,IAAA,GAAA,SAAA,EAAA,OAAA,CAAA,EAAA,4BAAA,CAAA,EACP,6BADO,EAAA"}

package/hooks/use-conversation-typing.js

@@ -0,0 +1,34 @@
+import { useTypingStore } from "../realtime/typing-store.js";
+import { useMemo } from "react";
+
+//#region src/hooks/use-conversation-typing.ts
+function shouldExclude(entry, options) {
+	if (entry.actorType === "visitor" && options.excludeVisitorId) return entry.actorId === options.excludeVisitorId;
+	if (entry.actorType === "user" && options.excludeUserId) return entry.actorId === options.excludeUserId;
+	if (entry.actorType === "ai_agent" && options.excludeAiAgentId) return entry.actorId === options.excludeAiAgentId;
+	return false;
+}
+function useConversationTyping(conversationId, options = {}) {
+	const conversationTyping = useTypingStore((state) => conversationId ? state.conversations[conversationId] ?? null : null);
+	return useMemo(() => {
+		if (!(conversationId && conversationTyping)) return [];
+		const excludeOptions = {
+			excludeVisitorId: options.excludeVisitorId ?? null,
+			excludeUserId: options.excludeUserId ?? null,
+			excludeAiAgentId: options.excludeAiAgentId ?? null
+		};
+		const entries = Object.values(conversationTyping).filter((entry) => !shouldExclude(entry, excludeOptions));
+		entries.sort((a, b) => a.updatedAt - b.updatedAt);
+		return entries;
+	}, [
+		conversationId,
+		conversationTyping,
+		options.excludeVisitorId,
+		options.excludeUserId,
+		options.excludeAiAgentId
+	]);
+}
+
+//#endregion
+export { useConversationTyping };
+//# sourceMappingURL=use-conversation-typing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-typing.js","names":["excludeOptions: Required<UseConversationTypingOptions>"],"sources":["../../src/hooks/use-conversation-typing.ts"],"sourcesContent":["import type { TypingEntry } from \"@cossistant/core\";\nimport { useMemo } from \"react\";\nimport { useTypingStore } from \"../realtime/typing-store\";\n\nexport type ConversationTypingParticipant = TypingEntry;\n\ntype UseConversationTypingOptions = {\n\texcludeVisitorId?: string | null;\n\texcludeUserId?: string | null;\n\texcludeAiAgentId?: string | null;\n};\n\nfunction shouldExclude(\n\tentry: TypingEntry,\n\toptions: Required<UseConversationTypingOptions>\n) {\n\tif (entry.actorType === \"visitor\" && options.excludeVisitorId) {\n\t\treturn entry.actorId === options.excludeVisitorId;\n\t}\n\n\tif (entry.actorType === \"user\" && options.excludeUserId) {\n\t\treturn entry.actorId === options.excludeUserId;\n\t}\n\n\tif (entry.actorType === \"ai_agent\" && options.excludeAiAgentId) {\n\t\treturn entry.actorId === options.excludeAiAgentId;\n\t}\n\n\treturn false;\n}\n\nexport function useConversationTyping(\n\tconversationId: string | null | undefined,\n\toptions: UseConversationTypingOptions = {}\n): ConversationTypingParticipant[] {\n\tconst conversationTyping = useTypingStore((state) =>\n\t\tconversationId ? (state.conversations[conversationId] ?? null) : null\n\t);\n\n\treturn useMemo(() => {\n\t\tif (!(conversationId && conversationTyping)) {\n\t\t\treturn [];\n\t\t}\n\n\t\tconst excludeOptions: Required<UseConversationTypingOptions> = {\n\t\t\texcludeVisitorId: options.excludeVisitorId ?? null,\n\t\t\texcludeUserId: options.excludeUserId ?? null,\n\t\t\texcludeAiAgentId: options.excludeAiAgentId ?? null,\n\t\t};\n\n\t\tconst entries = Object.values(conversationTyping).filter(\n\t\t\t(entry) => !shouldExclude(entry, excludeOptions)\n\t\t);\n\n\t\tentries.sort((a, b) => a.updatedAt - b.updatedAt);\n\n\t\treturn entries;\n\t}, [\n\t\tconversationId,\n\t\tconversationTyping,\n\t\toptions.excludeVisitorId,\n\t\toptions.excludeUserId,\n\t\toptions.excludeAiAgentId,\n\t]);\n}\n"],"mappings":";;;;AAYA,SAAS,cACR,OACA,SACC;AACD,KAAI,MAAM,cAAc,aAAa,QAAQ,iBAC5C,QAAO,MAAM,YAAY,QAAQ;AAGlC,KAAI,MAAM,cAAc,UAAU,QAAQ,cACzC,QAAO,MAAM,YAAY,QAAQ;AAGlC,KAAI,MAAM,cAAc,cAAc,QAAQ,iBAC7C,QAAO,MAAM,YAAY,QAAQ;AAGlC,QAAO;;AAGR,SAAgB,sBACf,gBACA,UAAwC,EAAE,EACR;CAClC,MAAM,qBAAqB,gBAAgB,UAC1C,iBAAkB,MAAM,cAAc,mBAAmB,OAAQ,KACjE;AAED,QAAO,cAAc;AACpB,MAAI,EAAE,kBAAkB,oBACvB,QAAO,EAAE;EAGV,MAAMA,iBAAyD;GAC9D,kBAAkB,QAAQ,oBAAoB;GAC9C,eAAe,QAAQ,iBAAiB;GACxC,kBAAkB,QAAQ,oBAAoB;GAC9C;EAED,MAAM,UAAU,OAAO,OAAO,mBAAmB,CAAC,QAChD,UAAU,CAAC,cAAc,OAAO,eAAe,CAChD;AAED,UAAQ,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,UAAU;AAEjD,SAAO;IACL;EACF;EACA;EACA,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,CAAC"}

package/hooks/use-conversation.d.ts

@@ -0,0 +1,18 @@
+import { GetConversationRequest, GetConversationResponse } from "../conversation.js";
+
+//#region src/hooks/use-conversation.d.ts
+type UseConversationOptions = {
+  enabled?: boolean;
+  refetchInterval?: number | false;
+  refetchOnWindowFocus?: boolean;
+};
+type UseConversationResult = {
+  conversation: GetConversationResponse["conversation"] | null;
+  isLoading: boolean;
+  error: Error | null;
+  refetch: (args?: GetConversationRequest) => Promise<GetConversationResponse | undefined>;
+};
+declare function useConversation(conversationId: string | null, options?: UseConversationOptions): UseConversationResult;
+//#endregion
+export { UseConversationOptions, UseConversationResult, useConversation };
+//# sourceMappingURL=use-conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation.d.ts","names":[],"sources":["../../src/hooks/use-conversation.ts"],"sourcesContent":[],"mappings":";;;KAQY,sBAAA;;EAAA,eAAA,CAAA,EAAA,MAAA,GAAsB,KAAA;EAMtB,oBAAA,CAAA,EAAA,OAAqB;CAAA;AAClB,KADH,qBAAA,GACG;cAEP,EAFO,uBAEP,CAAA,cAAA,CAAA,GAAA,IAAA;WAEC,EAAA,OAAA;OACK,EAHN,KAGM,GAAA,IAAA;SAAR,EAAA,CAAA,IAAA,CAAA,EADG,sBACH,EAAA,GAAA,OAAA,CAAQ,uBAAR,GAAA,SAAA,CAAA;CAAO;AAGG,iBAAA,eAAA,CAAe,cAAA,EAAA,MAAA,GAAA,IAAA,EAAA,OAAA,CAAA,EAErB,sBAFqB,CAAA,EAG5B,qBAH4B"}

package/hooks/use-conversation.js

@@ -0,0 +1,44 @@
+import { useClientQuery } from "./private/use-client-query.js";
+import { useStoreSelector } from "./private/store/use-store-selector.js";
+import { useSupport } from "../provider.js";
+
+//#region src/hooks/use-conversation.ts
+function useConversation(conversationId, options = {}) {
+	const { client } = useSupport();
+	const store = client.conversationsStore;
+	const conversation = useStoreSelector(store, (state) => {
+		if (!conversationId) return null;
+		return state.byId[conversationId] ?? null;
+	});
+	const request = conversationId ? { conversationId } : void 0;
+	const { refetch: queryRefetch, isLoading: queryLoading, error } = useClientQuery({
+		client,
+		queryFn: (instance) => {
+			if (!request) throw new Error("Conversation ID is required");
+			return instance.getConversation(request);
+		},
+		enabled: Boolean(conversationId && (options.enabled ?? true)),
+		refetchInterval: options.refetchInterval ?? false,
+		refetchOnWindowFocus: options.refetchOnWindowFocus ?? true,
+		refetchOnMount: !conversation,
+		initialArgs: request,
+		dependencies: [conversationId ?? "null"]
+	});
+	const refetch = (args) => {
+		if (!conversationId) return Promise.resolve(void 0);
+		return queryRefetch({
+			conversationId,
+			...args
+		});
+	};
+	return {
+		conversation,
+		isLoading: conversation ? false : queryLoading,
+		error,
+		refetch
+	};
+}
+
+//#endregion
+export { useConversation };
+//# sourceMappingURL=use-conversation.js.map

package/hooks/use-conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation.js","names":["request: GetConversationRequest | undefined"],"sources":["../../src/hooks/use-conversation.ts"],"sourcesContent":["import type {\n\tGetConversationRequest,\n\tGetConversationResponse,\n} from \"@cossistant/types/api/conversation\";\nimport { useSupport } from \"../provider\";\nimport { useStoreSelector } from \"./private/store/use-store-selector\";\nimport { useClientQuery } from \"./private/use-client-query\";\n\nexport type UseConversationOptions = {\n\tenabled?: boolean;\n\trefetchInterval?: number | false;\n\trefetchOnWindowFocus?: boolean;\n};\n\nexport type UseConversationResult = {\n\tconversation: GetConversationResponse[\"conversation\"] | null;\n\tisLoading: boolean;\n\terror: Error | null;\n\trefetch: (\n\t\targs?: GetConversationRequest\n\t) => Promise<GetConversationResponse | undefined>;\n};\n\nexport function useConversation(\n\tconversationId: string | null,\n\toptions: UseConversationOptions = {}\n): UseConversationResult {\n\tconst { client } = useSupport();\n\tconst store = client.conversationsStore;\n\n\tconst conversation = useStoreSelector(store, (state) => {\n\t\tif (!conversationId) {\n\t\t\treturn null;\n\t\t}\n\t\treturn state.byId[conversationId] ?? null;\n\t});\n\n\tconst request: GetConversationRequest | undefined = conversationId\n\t\t? { conversationId }\n\t\t: undefined;\n\n\tconst {\n\t\trefetch: queryRefetch,\n\t\tisLoading: queryLoading,\n\t\terror,\n\t} = useClientQuery<GetConversationResponse, GetConversationRequest>({\n\t\tclient,\n\t\tqueryFn: (instance) => {\n\t\t\tif (!request) {\n\t\t\t\tthrow new Error(\"Conversation ID is required\");\n\t\t\t}\n\t\t\treturn instance.getConversation(request);\n\t\t},\n\t\tenabled: Boolean(conversationId && (options.enabled ?? true)),\n\t\trefetchInterval: options.refetchInterval ?? false,\n\t\trefetchOnWindowFocus: options.refetchOnWindowFocus ?? true,\n\t\trefetchOnMount: !conversation,\n\t\tinitialArgs: request,\n\t\tdependencies: [conversationId ?? \"null\"],\n\t});\n\n\tconst refetch = (args?: GetConversationRequest) => {\n\t\tif (!conversationId) {\n\t\t\treturn Promise.resolve(undefined);\n\t\t}\n\n\t\treturn queryRefetch({\n\t\t\tconversationId,\n\t\t\t...args,\n\t\t});\n\t};\n\n\tconst isLoading = conversation ? false : queryLoading;\n\n\treturn {\n\t\tconversation,\n\t\tisLoading,\n\t\terror,\n\t\trefetch,\n\t};\n}\n"],"mappings":";;;;;AAuBA,SAAgB,gBACf,gBACA,UAAkC,EAAE,EACZ;CACxB,MAAM,EAAE,WAAW,YAAY;CAC/B,MAAM,QAAQ,OAAO;CAErB,MAAM,eAAe,iBAAiB,QAAQ,UAAU;AACvD,MAAI,CAAC,eACJ,QAAO;AAER,SAAO,MAAM,KAAK,mBAAmB;GACpC;CAEF,MAAMA,UAA8C,iBACjD,EAAE,gBAAgB,GAClB;CAEH,MAAM,EACL,SAAS,cACT,WAAW,cACX,UACG,eAAgE;EACnE;EACA,UAAU,aAAa;AACtB,OAAI,CAAC,QACJ,OAAM,IAAI,MAAM,8BAA8B;AAE/C,UAAO,SAAS,gBAAgB,QAAQ;;EAEzC,SAAS,QAAQ,mBAAmB,QAAQ,WAAW,MAAM;EAC7D,iBAAiB,QAAQ,mBAAmB;EAC5C,sBAAsB,QAAQ,wBAAwB;EACtD,gBAAgB,CAAC;EACjB,aAAa;EACb,cAAc,CAAC,kBAAkB,OAAO;EACxC,CAAC;CAEF,MAAM,WAAW,SAAkC;AAClD,MAAI,CAAC,eACJ,QAAO,QAAQ,QAAQ,OAAU;AAGlC,SAAO,aAAa;GACnB;GACA,GAAG;GACH,CAAC;;AAKH,QAAO;EACN;EACA,WAJiB,eAAe,QAAQ;EAKxC;EACA;EACA"}

package/hooks/use-conversations.d.ts

@@ -0,0 +1,20 @@
+import { ListConversationsRequest, ListConversationsResponse } from "../conversation.js";
+import { ConversationPagination } from "@cossistant/core";
+
+//#region src/hooks/use-conversations.d.ts
+type UseConversationsOptions = Partial<Omit<ListConversationsRequest, "visitorId">> & {
+  enabled?: boolean;
+  refetchInterval?: number | false;
+  refetchOnWindowFocus?: boolean;
+};
+type UseConversationsResult = {
+  conversations: ListConversationsResponse["conversations"];
+  pagination: ConversationPagination | null;
+  isLoading: boolean;
+  error: Error | null;
+  refetch: (args?: Partial<ListConversationsRequest>) => Promise<ListConversationsResponse | undefined>;
+};
+declare function useConversations(options?: UseConversationsOptions): UseConversationsResult;
+//#endregion
+export { UseConversationsOptions, UseConversationsResult, useConversations };
+//# sourceMappingURL=use-conversations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversations.d.ts","names":[],"sources":["../../src/hooks/use-conversations.ts"],"sourcesContent":[],"mappings":";;;;KA0CY,uBAAA,GAA0B,QACrC,KAAK;;EADM,eAAA,CAAA,EAAA,MAAA,GAAuB,KAAA;EAAA,oBAAA,CAAA,EAAA,OAAA;;AAClC,KAOW,sBAAA,GAPX;eADqC,EAStB,yBATsB,CAAA,eAAA,CAAA;EAAO,UAAA,EAUhC,sBAVgC,GAAA,IAAA;EAQjC,SAAA,EAAA,OAAA;EAAsB,KAAA,EAI1B,KAJ0B,GAAA,IAAA;SAClB,EAAA,CAAA,IAAA,CAAA,EAKP,OALO,CAKC,wBALD,CAAA,EAAA,GAMV,OANU,CAMF,yBANE,GAAA,SAAA,CAAA;;AAGR,iBAMQ,gBAAA,CANR,OAAA,CAAA,EAOE,uBAPF,CAAA,EAQL,sBARK"}

package/hooks/use-conversations.js

@@ -0,0 +1,68 @@
+import { useClientQuery } from "./private/use-client-query.js";
+import { useStoreSelector } from "./private/store/use-store-selector.js";
+import { useSupport } from "../provider.js";
+import { useCallback, useMemo } from "react";
+
+//#region src/hooks/use-conversations.ts
+function areSelectionsEqual(a, b) {
+	if (!(a.pagination === b.pagination || Boolean(a.pagination) && Boolean(b.pagination) && a.pagination?.page === b.pagination?.page && a.pagination?.limit === b.pagination?.limit && a.pagination?.total === b.pagination?.total && a.pagination?.totalPages === b.pagination?.totalPages && a.pagination?.hasMore === b.pagination?.hasMore)) return false;
+	if (a.conversations.length !== b.conversations.length) return false;
+	return a.conversations.every((conversation, index) => conversation === b.conversations[index]);
+}
+function useConversations(options = {}) {
+	const { client } = useSupport();
+	const { limit, page, order, orderBy, status, enabled = true, refetchInterval = false, refetchOnWindowFocus = true } = options;
+	const requestDefaults = useMemo(() => ({
+		limit,
+		page,
+		status,
+		orderBy,
+		order
+	}), [
+		limit,
+		page,
+		status,
+		orderBy,
+		order
+	]);
+	const store = client.conversationsStore;
+	const selection = useStoreSelector(store, (state) => ({
+		conversations: state.ids.map((id) => state.byId[id]).filter((conversation) => Boolean(conversation)),
+		pagination: state.pagination
+	}), areSelectionsEqual);
+	const { refetch: queryRefetch, isLoading: queryLoading, error } = useClientQuery({
+		client,
+		queryFn: (instance, args) => instance.listConversations({
+			...requestDefaults,
+			...args
+		}),
+		enabled,
+		refetchInterval,
+		refetchOnWindowFocus,
+		refetchOnMount: selection.conversations.length === 0,
+		initialArgs: requestDefaults,
+		dependencies: [
+			limit,
+			page,
+			status,
+			orderBy,
+			order
+		]
+	});
+	const refetch = useCallback((args) => queryRefetch({
+		...requestDefaults,
+		...args
+	}), [queryRefetch, requestDefaults]);
+	const isLoading = selection.conversations.length === 0 ? queryLoading : false;
+	return {
+		conversations: selection.conversations,
+		pagination: selection.pagination,
+		isLoading,
+		error,
+		refetch
+	};
+}
+
+//#endregion
+export { useConversations };
+//# sourceMappingURL=use-conversations.js.map

package/hooks/use-conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversations.js","names":[],"sources":["../../src/hooks/use-conversations.ts"],"sourcesContent":["import type { ConversationPagination } from \"@cossistant/core\";\nimport type {\n\tListConversationsRequest,\n\tListConversationsResponse,\n} from \"@cossistant/types/api/conversation\";\nimport { useCallback, useMemo } from \"react\";\nimport { useSupport } from \"../provider\";\nimport { useStoreSelector } from \"./private/store/use-store-selector\";\nimport { useClientQuery } from \"./private/use-client-query\";\n\ntype ConversationsSelection = {\n\tconversations: ListConversationsResponse[\"conversations\"];\n\tpagination: ConversationPagination | null;\n};\n\nfunction areSelectionsEqual(\n\ta: ConversationsSelection,\n\tb: ConversationsSelection\n): boolean {\n\tconst samePagination =\n\t\ta.pagination === b.pagination ||\n\t\t(Boolean(a.pagination) &&\n\t\t\tBoolean(b.pagination) &&\n\t\t\ta.pagination?.page === b.pagination?.page &&\n\t\t\ta.pagination?.limit === b.pagination?.limit &&\n\t\t\ta.pagination?.total === b.pagination?.total &&\n\t\t\ta.pagination?.totalPages === b.pagination?.totalPages &&\n\t\t\ta.pagination?.hasMore === b.pagination?.hasMore);\n\n\tif (!samePagination) {\n\t\treturn false;\n\t}\n\n\tif (a.conversations.length !== b.conversations.length) {\n\t\treturn false;\n\t}\n\n\treturn a.conversations.every(\n\t\t(conversation, index) => conversation === b.conversations[index]\n\t);\n}\n\nexport type UseConversationsOptions = Partial<\n\tOmit<ListConversationsRequest, \"visitorId\">\n> & {\n\tenabled?: boolean;\n\trefetchInterval?: number | false;\n\trefetchOnWindowFocus?: boolean;\n};\n\nexport type UseConversationsResult = {\n\tconversations: ListConversationsResponse[\"conversations\"];\n\tpagination: ConversationPagination | null;\n\tisLoading: boolean;\n\terror: Error | null;\n\trefetch: (\n\t\targs?: Partial<ListConversationsRequest>\n\t) => Promise<ListConversationsResponse | undefined>;\n};\n\nexport function useConversations(\n\toptions: UseConversationsOptions = {}\n): UseConversationsResult {\n\tconst { client } = useSupport();\n\n\tconst {\n\t\tlimit,\n\t\tpage,\n\t\torder,\n\t\torderBy,\n\t\tstatus,\n\t\tenabled = true,\n\t\trefetchInterval = false,\n\t\trefetchOnWindowFocus = true,\n\t} = options;\n\n\tconst requestDefaults = useMemo(\n\t\t() => ({ limit, page, status, orderBy, order }),\n\t\t[limit, page, status, orderBy, order]\n\t);\n\n\tconst store = client.conversationsStore;\n\n\tconst selection = useStoreSelector(\n\t\tstore,\n\t\t(state): ConversationsSelection => ({\n\t\t\tconversations: state.ids\n\t\t\t\t.map((id) => state.byId[id])\n\t\t\t\t.filter(\n\t\t\t\t\t(\n\t\t\t\t\t\tconversation\n\t\t\t\t\t): conversation is ListConversationsResponse[\"conversations\"][number] =>\n\t\t\t\t\t\tBoolean(conversation)\n\t\t\t\t),\n\t\t\tpagination: state.pagination,\n\t\t}),\n\t\tareSelectionsEqual\n\t);\n\n\tconst {\n\t\trefetch: queryRefetch,\n\t\tisLoading: queryLoading,\n\t\terror,\n\t} = useClientQuery<\n\t\tListConversationsResponse,\n\t\tPartial<ListConversationsRequest>\n\t>({\n\t\tclient,\n\t\tqueryFn: (instance, args) =>\n\t\t\tinstance.listConversations({\n\t\t\t\t...requestDefaults,\n\t\t\t\t...args,\n\t\t\t}),\n\t\tenabled,\n\t\trefetchInterval,\n\t\trefetchOnWindowFocus,\n\t\trefetchOnMount: selection.conversations.length === 0,\n\t\tinitialArgs: requestDefaults,\n\t\tdependencies: [limit, page, status, orderBy, order],\n\t});\n\n\tconst refetch = useCallback(\n\t\t(args?: Partial<ListConversationsRequest>) =>\n\t\t\tqueryRefetch({\n\t\t\t\t...requestDefaults,\n\t\t\t\t...args,\n\t\t\t}),\n\t\t[queryRefetch, requestDefaults]\n\t);\n\n\tconst isInitialLoad = selection.conversations.length === 0;\n\tconst isLoading = isInitialLoad ? queryLoading : false;\n\n\treturn {\n\t\tconversations: selection.conversations,\n\t\tpagination: selection.pagination,\n\t\tisLoading,\n\t\terror,\n\t\trefetch,\n\t};\n}\n"],"mappings":";;;;;;AAeA,SAAS,mBACR,GACA,GACU;AAWV,KAAI,EATH,EAAE,eAAe,EAAE,cAClB,QAAQ,EAAE,WAAW,IACrB,QAAQ,EAAE,WAAW,IACrB,EAAE,YAAY,SAAS,EAAE,YAAY,QACrC,EAAE,YAAY,UAAU,EAAE,YAAY,SACtC,EAAE,YAAY,UAAU,EAAE,YAAY,SACtC,EAAE,YAAY,eAAe,EAAE,YAAY,cAC3C,EAAE,YAAY,YAAY,EAAE,YAAY,SAGzC,QAAO;AAGR,KAAI,EAAE,cAAc,WAAW,EAAE,cAAc,OAC9C,QAAO;AAGR,QAAO,EAAE,cAAc,OACrB,cAAc,UAAU,iBAAiB,EAAE,cAAc,OAC1D;;AAqBF,SAAgB,iBACf,UAAmC,EAAE,EACZ;CACzB,MAAM,EAAE,WAAW,YAAY;CAE/B,MAAM,EACL,OACA,MACA,OACA,SACA,QACA,UAAU,MACV,kBAAkB,OAClB,uBAAuB,SACpB;CAEJ,MAAM,kBAAkB,eAChB;EAAE;EAAO;EAAM;EAAQ;EAAS;EAAO,GAC9C;EAAC;EAAO;EAAM;EAAQ;EAAS;EAAM,CACrC;CAED,MAAM,QAAQ,OAAO;CAErB,MAAM,YAAY,iBACjB,QACC,WAAmC;EACnC,eAAe,MAAM,IACnB,KAAK,OAAO,MAAM,KAAK,IAAI,CAC3B,QAEC,iBAEA,QAAQ,aAAa,CACtB;EACF,YAAY,MAAM;EAClB,GACD,mBACA;CAED,MAAM,EACL,SAAS,cACT,WAAW,cACX,UACG,eAGF;EACD;EACA,UAAU,UAAU,SACnB,SAAS,kBAAkB;GAC1B,GAAG;GACH,GAAG;GACH,CAAC;EACH;EACA;EACA;EACA,gBAAgB,UAAU,cAAc,WAAW;EACnD,aAAa;EACb,cAAc;GAAC;GAAO;GAAM;GAAQ;GAAS;GAAM;EACnD,CAAC;CAEF,MAAM,UAAU,aACd,SACA,aAAa;EACZ,GAAG;EACH,GAAG;EACH,CAAC,EACH,CAAC,cAAc,gBAAgB,CAC/B;CAGD,MAAM,YADgB,UAAU,cAAc,WAAW,IACvB,eAAe;AAEjD,QAAO;EACN,eAAe,UAAU;EACzB,YAAY,UAAU;EACtB;EACA;EACA;EACA"}

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

@@ -0,0 +1,30 @@
+import { TimelineItem } from "../timeline-item.js";
+import { Conversation } from "../schemas.js";
+import { CreateConversationResponseBody } from "../conversation.js";
+import { CossistantClient } from "@cossistant/core";
+
+//#region src/hooks/use-create-conversation.d.ts
+type UseCreateConversationOptions = {
+  client?: CossistantClient;
+  onSuccess?: (data: CreateConversationResponseBody) => void;
+  onError?: (error: Error) => void;
+};
+type CreateConversationVariables = {
+  conversationId?: string;
+  defaultTimelineItems?: TimelineItem[];
+  visitorId?: string;
+  websiteId?: string | null;
+  status?: Conversation["status"];
+  title?: string | null;
+};
+type UseCreateConversationResult = {
+  mutate: (variables?: CreateConversationVariables) => void;
+  mutateAsync: (variables?: CreateConversationVariables) => Promise<CreateConversationResponseBody | null>;
+  isPending: boolean;
+  error: Error | null;
+  reset: () => void;
+};
+declare function useCreateConversation(options?: UseCreateConversationOptions): UseCreateConversationResult;
+//#endregion
+export { CreateConversationVariables, UseCreateConversationOptions, UseCreateConversationResult, useCreateConversation };
+//# sourceMappingURL=use-create-conversation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-create-conversation.d.ts","names":[],"sources":["../../src/hooks/use-create-conversation.ts"],"sourcesContent":[],"mappings":";;;;;;KAOY,4BAAA;WACF;EADE,SAAA,CAAA,EAAA,CAAA,IAAA,EAEQ,8BAFoB,EAAA,GAAA,IAAA;EAAA,OAAA,CAAA,EAAA,CAAA,KAAA,EAGrB,KAHqB,EAAA,GAAA,IAAA;;AAEpB,KAIR,2BAAA,GAJQ;gBACD,CAAA,EAAA,MAAA;EAAK,oBAAA,CAAA,EAKA,YALA,EAAA;EAGZ,SAAA,CAAA,EAAA,MAAA;EAA2B,SAAA,CAAA,EAAA,MAAA,GAAA,IAAA;QAEf,CAAA,EAGd,YAHc,CAAA,QAAA,CAAA;OAGd,CAAA,EAAA,MAAA,GAAA,IAAA;CAAY;AAIV,KAAA,2BAAA,GAA2B;EAAA,MAAA,EAAA,CAAA,SAAA,CAAA,EACjB,2BADiB,EAAA,GAAA,IAAA;aACjB,EAAA,CAAA,SAAA,CAAA,EAER,2BAFQ,EAAA,GAGhB,OAHgB,CAGR,8BAHQ,GAAA,IAAA,CAAA;WAER,EAAA,OAAA;OACA,EAEN,KAFM,GAAA,IAAA;OAAR,EAAA,GAAA,GAAA,IAAA;;AAEO,iBAgBG,qBAAA,CAhBH,OAAA,CAAA,EAiBH,4BAjBG,CAAA,EAkBV,2BAlBU"}

package/hooks/use-create-conversation.js

@@ -0,0 +1,67 @@
+import { useSupport } from "../provider.js";
+import { useCallback, useState } from "react";
+
+//#region src/hooks/use-create-conversation.ts
+function toError(error) {
+	if (error instanceof Error) return error;
+	if (typeof error === "string") return new Error(error);
+	return /* @__PURE__ */ new Error("Unknown error");
+}
+function useCreateConversation(options = {}) {
+	const { client: contextClient } = useSupport();
+	const { client: overrideClient, onError, onSuccess } = options;
+	const client = overrideClient ?? contextClient;
+	const [isPending, setIsPending] = useState(false);
+	const [error, setError] = useState(null);
+	const mutateAsync = useCallback(async (variables = {}) => {
+		setIsPending(true);
+		setError(null);
+		try {
+			const { websiteId, status, title, conversationId: providedConversationId, defaultTimelineItems = [], visitorId } = variables;
+			const initiated = client.initiateConversation({
+				conversationId: providedConversationId ?? void 0,
+				defaultTimelineItems,
+				visitorId: visitorId ?? void 0,
+				websiteId: websiteId ?? void 0,
+				status: status ?? void 0,
+				title: title ?? void 0
+			});
+			const response = {
+				conversation: initiated.conversation,
+				initialTimelineItems: initiated.defaultTimelineItems
+			};
+			setIsPending(false);
+			setError(null);
+			onSuccess?.(response);
+			return response;
+		} catch (raw) {
+			const normalised = toError(raw);
+			setIsPending(false);
+			setError(normalised);
+			onError?.(normalised);
+			throw normalised;
+		}
+	}, [
+		client,
+		onError,
+		onSuccess
+	]);
+	const mutate = useCallback((variables) => {
+		mutateAsync(variables).catch(() => {});
+	}, [mutateAsync]);
+	const reset = useCallback(() => {
+		setError(null);
+		setIsPending(false);
+	}, []);
+	return {
+		mutate,
+		mutateAsync,
+		isPending,
+		error,
+		reset
+	};
+}
+
+//#endregion
+export { useCreateConversation };
+//# sourceMappingURL=use-create-conversation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-create-conversation.js","names":["response: CreateConversationResponseBody"],"sources":["../../src/hooks/use-create-conversation.ts"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport type { CreateConversationResponseBody } from \"@cossistant/types/api/conversation\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport type { Conversation } from \"@cossistant/types/schemas\";\nimport { useCallback, useState } from \"react\";\nimport { useSupport } from \"../provider\";\n\nexport type UseCreateConversationOptions = {\n\tclient?: CossistantClient;\n\tonSuccess?: (data: CreateConversationResponseBody) => void;\n\tonError?: (error: Error) => void;\n};\n\nexport type CreateConversationVariables = {\n\tconversationId?: string;\n\tdefaultTimelineItems?: TimelineItem[];\n\tvisitorId?: string;\n\twebsiteId?: string | null;\n\tstatus?: Conversation[\"status\"];\n\ttitle?: string | null;\n};\n\nexport type UseCreateConversationResult = {\n\tmutate: (variables?: CreateConversationVariables) => void;\n\tmutateAsync: (\n\t\tvariables?: CreateConversationVariables\n\t) => Promise<CreateConversationResponseBody | null>;\n\tisPending: boolean;\n\terror: Error | null;\n\treset: () => void;\n};\n\nfunction toError(error: unknown): Error {\n\tif (error instanceof Error) {\n\t\treturn error;\n\t}\n\n\tif (typeof error === \"string\") {\n\t\treturn new Error(error);\n\t}\n\n\treturn new Error(\"Unknown error\");\n}\n\nexport function useCreateConversation(\n\toptions: UseCreateConversationOptions = {}\n): UseCreateConversationResult {\n\tconst { client: contextClient } = useSupport();\n\tconst { client: overrideClient, onError, onSuccess } = options;\n\tconst client = overrideClient ?? contextClient;\n\n\tconst [isPending, setIsPending] = useState(false);\n\tconst [error, setError] = useState<Error | null>(null);\n\n\tconst mutateAsync = useCallback(\n\t\tasync (\n\t\t\tvariables: CreateConversationVariables = {}\n\t\t): Promise<CreateConversationResponseBody | null> => {\n\t\t\tsetIsPending(true);\n\t\t\tsetError(null);\n\n\t\t\ttry {\n\t\t\t\tconst {\n\t\t\t\t\twebsiteId,\n\t\t\t\t\tstatus,\n\t\t\t\t\ttitle,\n\t\t\t\t\tconversationId: providedConversationId,\n\t\t\t\t\tdefaultTimelineItems = [],\n\t\t\t\t\tvisitorId,\n\t\t\t\t} = variables;\n\n\t\t\t\tconst initiated = client.initiateConversation({\n\t\t\t\t\tconversationId: providedConversationId ?? undefined,\n\t\t\t\t\tdefaultTimelineItems,\n\t\t\t\t\tvisitorId: visitorId ?? undefined,\n\t\t\t\t\twebsiteId: websiteId ?? undefined,\n\t\t\t\t\tstatus: status ?? undefined,\n\t\t\t\t\ttitle: title ?? undefined,\n\t\t\t\t});\n\n\t\t\t\tconst response: CreateConversationResponseBody = {\n\t\t\t\t\tconversation: initiated.conversation,\n\t\t\t\t\tinitialTimelineItems: initiated.defaultTimelineItems,\n\t\t\t\t};\n\n\t\t\t\tsetIsPending(false);\n\t\t\t\tsetError(null);\n\t\t\t\tonSuccess?.(response);\n\t\t\t\treturn response;\n\t\t\t} catch (raw) {\n\t\t\t\tconst normalised = toError(raw);\n\t\t\t\tsetIsPending(false);\n\t\t\t\tsetError(normalised);\n\t\t\t\tonError?.(normalised);\n\t\t\t\tthrow normalised;\n\t\t\t}\n\t\t},\n\t\t[client, onError, onSuccess]\n\t);\n\n\tconst mutate = useCallback(\n\t\t(variables?: CreateConversationVariables) => {\n\t\t\tvoid mutateAsync(variables).catch(() => {\n\t\t\t\t// Intentionally swallow to match react-query semantics\n\t\t\t});\n\t\t},\n\t\t[mutateAsync]\n\t);\n\n\tconst reset = useCallback(() => {\n\t\tsetError(null);\n\t\tsetIsPending(false);\n\t}, []);\n\n\treturn {\n\t\tmutate,\n\t\tmutateAsync,\n\t\tisPending,\n\t\terror,\n\t\treset,\n\t};\n}\n"],"mappings":";;;;AAgCA,SAAS,QAAQ,OAAuB;AACvC,KAAI,iBAAiB,MACpB,QAAO;AAGR,KAAI,OAAO,UAAU,SACpB,QAAO,IAAI,MAAM,MAAM;AAGxB,wBAAO,IAAI,MAAM,gBAAgB;;AAGlC,SAAgB,sBACf,UAAwC,EAAE,EACZ;CAC9B,MAAM,EAAE,QAAQ,kBAAkB,YAAY;CAC9C,MAAM,EAAE,QAAQ,gBAAgB,SAAS,cAAc;CACvD,MAAM,SAAS,kBAAkB;CAEjC,MAAM,CAAC,WAAW,gBAAgB,SAAS,MAAM;CACjD,MAAM,CAAC,OAAO,YAAY,SAAuB,KAAK;CAEtD,MAAM,cAAc,YACnB,OACC,YAAyC,EAAE,KACS;AACpD,eAAa,KAAK;AAClB,WAAS,KAAK;AAEd,MAAI;GACH,MAAM,EACL,WACA,QACA,OACA,gBAAgB,wBAChB,uBAAuB,EAAE,EACzB,cACG;GAEJ,MAAM,YAAY,OAAO,qBAAqB;IAC7C,gBAAgB,0BAA0B;IAC1C;IACA,WAAW,aAAa;IACxB,WAAW,aAAa;IACxB,QAAQ,UAAU;IAClB,OAAO,SAAS;IAChB,CAAC;GAEF,MAAMA,WAA2C;IAChD,cAAc,UAAU;IACxB,sBAAsB,UAAU;IAChC;AAED,gBAAa,MAAM;AACnB,YAAS,KAAK;AACd,eAAY,SAAS;AACrB,UAAO;WACC,KAAK;GACb,MAAM,aAAa,QAAQ,IAAI;AAC/B,gBAAa,MAAM;AACnB,YAAS,WAAW;AACpB,aAAU,WAAW;AACrB,SAAM;;IAGR;EAAC;EAAQ;EAAS;EAAU,CAC5B;CAED,MAAM,SAAS,aACb,cAA4C;AAC5C,EAAK,YAAY,UAAU,CAAC,YAAY,GAEtC;IAEH,CAAC,YAAY,CACb;CAED,MAAM,QAAQ,kBAAkB;AAC/B,WAAS,KAAK;AACd,eAAa,MAAM;IACjB,EAAE,CAAC;AAEN,QAAO;EACN;EACA;EACA;EACA;EACA;EACA"}

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

@@ -0,0 +1,82 @@
+import { Conversation } from "@cossistant/types";
+
+//#region src/hooks/use-home-page.d.ts
+type UseHomePageOptions = {
+  /**
+   * Whether to enable conversations fetching.
+   * Default: true
+   */
+  enabled?: boolean;
+  /**
+   * Callback when user wants to start a new conversation.
+   */
+  onStartConversation?: (initialMessage?: string) => void;
+  /**
+   * Callback when user wants to open an existing conversation.
+   */
+  onOpenConversation?: (conversationId: string) => void;
+  /**
+   * Callback when user wants to view conversation history.
+   */
+  onOpenConversationHistory?: () => void;
+};
+type UseHomePageReturn = {
+  conversations: Conversation[];
+  isLoading: boolean;
+  error: Error | null;
+  lastOpenConversation: Conversation | undefined;
+  availableConversationsCount: number;
+  hasConversations: boolean;
+  startConversation: (initialMessage?: string) => void;
+  openConversation: (conversationId: string) => void;
+  openConversationHistory: () => void;
+};
+/**
+ * Main hook for the home page of the support widget.
+ *
+ * This hook:
+ * - Fetches and manages conversations list
+ * - Derives useful state (last open conversation, conversation counts)
+ * - Provides navigation actions for the home page
+ *
+ * It encapsulates all home page logic, making the component
+ * purely presentational.
+ *
+ * @example
+ * ```tsx
+ * export function HomePage() {
+ *   const home = useHomePage({
+ *     onStartConversation: (msg) => {
+ *       navigate('conversation', { conversationId: PENDING_CONVERSATION_ID, initialMessage: msg });
+ *     },
+ *     onOpenConversation: (id) => {
+ *       navigate('conversation', { conversationId: id });
+ *     },
+ *     onOpenConversationHistory: () => {
+ *       navigate('conversation-history');
+ *     },
+ *   });
+ *
+ *   return (
+ *     <>
+ *       <h1>How can we help?</h1>
+ *
+ *       {home.lastOpenConversation && (
+ *         <ConversationCard
+ *           conversation={home.lastOpenConversation}
+ *           onClick={() => home.openConversation(home.lastOpenConversation.id)}
+ *         />
+ *       )}
+ *
+ *       <Button onClick={() => home.startConversation()}>
+ *         Ask a question
+ *       </Button>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function useHomePage(options?: UseHomePageOptions): UseHomePageReturn;
+//#endregion
+export { UseHomePageOptions, UseHomePageReturn, useHomePage };
+//# sourceMappingURL=use-home-page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-home-page.d.ts","names":[],"sources":["../../src/hooks/use-home-page.ts"],"sourcesContent":[],"mappings":";;;KAKY,kBAAA;;AAAZ;AAuBA;;SAEgB,CAAA,EAAA,OAAA;;;;EA4DA,mBAAW,CAAA,EAAA,CAAA,cAAA,CAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAAA;;;EAEP,kBAAA,CAAA,EAAA,CAAA,cAAA,EAAA,MAAA,EAAA,GAAA,IAAA;;;;;;KAhER,iBAAA;iBAEI;;SAER;wBAGe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuDP,WAAA,WACN,qBACP"}

package/hooks/use-home-page.js

@@ -0,0 +1,89 @@
+import { useConversations } from "./use-conversations.js";
+import { useCallback, useMemo } from "react";
+
+//#region src/hooks/use-home-page.ts
+/**
+* Main hook for the home page of the support widget.
+*
+* This hook:
+* - Fetches and manages conversations list
+* - Derives useful state (last open conversation, conversation counts)
+* - Provides navigation actions for the home page
+*
+* It encapsulates all home page logic, making the component
+* purely presentational.
+*
+* @example
+* ```tsx
+* export function HomePage() {
+*   const home = useHomePage({
+*     onStartConversation: (msg) => {
+*       navigate('conversation', { conversationId: PENDING_CONVERSATION_ID, initialMessage: msg });
+*     },
+*     onOpenConversation: (id) => {
+*       navigate('conversation', { conversationId: id });
+*     },
+*     onOpenConversationHistory: () => {
+*       navigate('conversation-history');
+*     },
+*   });
+*
+*   return (
+*     <>
+*       <h1>How can we help?</h1>
+*
+*       {home.lastOpenConversation && (
+*         <ConversationCard
+*           conversation={home.lastOpenConversation}
+*           onClick={() => home.openConversation(home.lastOpenConversation.id)}
+*         />
+*       )}
+*
+*       <Button onClick={() => home.startConversation()}>
+*         Ask a question
+*       </Button>
+*     </>
+*   );
+* }
+* ```
+*/
+function useHomePage(options = {}) {
+	const { enabled = true, onStartConversation, onOpenConversation, onOpenConversationHistory } = options;
+	const { conversations, isLoading, error } = useConversations({
+		enabled,
+		orderBy: "updatedAt",
+		order: "desc"
+	});
+	const { lastOpenConversation, availableConversationsCount } = useMemo(() => {
+		const openConversation$1 = conversations.find((conv) => conv.status === "open");
+		const otherCount = Math.max((conversations.length || 0) - 1, 0);
+		return {
+			lastOpenConversation: openConversation$1,
+			availableConversationsCount: otherCount
+		};
+	}, [conversations]);
+	const startConversation = useCallback((initialMessage) => {
+		onStartConversation?.(initialMessage);
+	}, [onStartConversation]);
+	const openConversation = useCallback((conversationId) => {
+		onOpenConversation?.(conversationId);
+	}, [onOpenConversation]);
+	const openConversationHistory = useCallback(() => {
+		onOpenConversationHistory?.();
+	}, [onOpenConversationHistory]);
+	return {
+		conversations,
+		isLoading,
+		error,
+		lastOpenConversation,
+		availableConversationsCount,
+		hasConversations: conversations.length > 0,
+		startConversation,
+		openConversation,
+		openConversationHistory
+	};
+}
+
+//#endregion
+export { useHomePage };
+//# sourceMappingURL=use-home-page.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-home-page.js","names":["openConversation"],"sources":["../../src/hooks/use-home-page.ts"],"sourcesContent":["import type { Conversation } from \"@cossistant/types\";\nimport { useCallback, useMemo } from \"react\";\nimport { PENDING_CONVERSATION_ID } from \"../utils/id\";\nimport { useConversations } from \"./use-conversations\";\n\nexport type UseHomePageOptions = {\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 start a new conversation.\n\t */\n\tonStartConversation?: (initialMessage?: string) => void;\n\n\t/**\n\t * Callback when user wants to open an existing conversation.\n\t */\n\tonOpenConversation?: (conversationId: string) => void;\n\n\t/**\n\t * Callback when user wants to view conversation history.\n\t */\n\tonOpenConversationHistory?: () => void;\n};\n\nexport type UseHomePageReturn = {\n\t// Conversations data\n\tconversations: Conversation[];\n\tisLoading: boolean;\n\terror: Error | null;\n\n\t// Derived state\n\tlastOpenConversation: Conversation | undefined;\n\tavailableConversationsCount: number;\n\thasConversations: boolean;\n\n\t// Actions\n\tstartConversation: (initialMessage?: string) => void;\n\topenConversation: (conversationId: string) => void;\n\topenConversationHistory: () => void;\n};\n\n/**\n * Main hook for the home page of the support widget.\n *\n * This hook:\n * - Fetches and manages conversations list\n * - Derives useful state (last open conversation, conversation counts)\n * - Provides navigation actions for the home page\n *\n * It encapsulates all home page logic, making the component\n * purely presentational.\n *\n * @example\n * ```tsx\n * export function HomePage() {\n *   const home = useHomePage({\n *     onStartConversation: (msg) => {\n *       navigate('conversation', { conversationId: PENDING_CONVERSATION_ID, initialMessage: msg });\n *     },\n *     onOpenConversation: (id) => {\n *       navigate('conversation', { conversationId: id });\n *     },\n *     onOpenConversationHistory: () => {\n *       navigate('conversation-history');\n *     },\n *   });\n *\n *   return (\n *     <>\n *       <h1>How can we help?</h1>\n *\n *       {home.lastOpenConversation && (\n *         <ConversationCard\n *           conversation={home.lastOpenConversation}\n *           onClick={() => home.openConversation(home.lastOpenConversation.id)}\n *         />\n *       )}\n *\n *       <Button onClick={() => home.startConversation()}>\n *         Ask a question\n *       </Button>\n *     </>\n *   );\n * }\n * ```\n */\nexport function useHomePage(\n\toptions: UseHomePageOptions = {}\n): UseHomePageReturn {\n\tconst {\n\t\tenabled = true,\n\t\tonStartConversation,\n\t\tonOpenConversation,\n\t\tonOpenConversationHistory,\n\t} = options;\n\n\t// Fetch conversations\n\tconst { conversations, isLoading, error } = useConversations({\n\t\tenabled,\n\t\t// Fetch most recent conversations first\n\t\torderBy: \"updatedAt\",\n\t\torder: \"desc\",\n\t});\n\n\t// Derive useful state from conversations\n\tconst { lastOpenConversation, availableConversationsCount } = useMemo(() => {\n\t\t// Find the most recent open conversation\n\t\tconst openConversation = conversations.find(\n\t\t\t(conv) => conv.status === \"open\"\n\t\t);\n\n\t\t// Count other conversations (excluding the one we're showing)\n\t\tconst otherCount = Math.max((conversations.length || 0) - 1, 0);\n\n\t\treturn {\n\t\t\tlastOpenConversation: openConversation,\n\t\t\tavailableConversationsCount: otherCount,\n\t\t};\n\t}, [conversations]);\n\n\t// Navigation actions\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\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 openConversationHistory = useCallback(() => {\n\t\tonOpenConversationHistory?.();\n\t}, [onOpenConversationHistory]);\n\n\treturn {\n\t\tconversations,\n\t\tisLoading,\n\t\terror,\n\t\tlastOpenConversation,\n\t\tavailableConversationsCount,\n\t\thasConversations: conversations.length > 0,\n\t\tstartConversation,\n\t\topenConversation,\n\t\topenConversationHistory,\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0FA,SAAgB,YACf,UAA8B,EAAE,EACZ;CACpB,MAAM,EACL,UAAU,MACV,qBACA,oBACA,8BACG;CAGJ,MAAM,EAAE,eAAe,WAAW,UAAU,iBAAiB;EAC5D;EAEA,SAAS;EACT,OAAO;EACP,CAAC;CAGF,MAAM,EAAE,sBAAsB,gCAAgC,cAAc;EAE3E,MAAMA,qBAAmB,cAAc,MACrC,SAAS,KAAK,WAAW,OAC1B;EAGD,MAAM,aAAa,KAAK,KAAK,cAAc,UAAU,KAAK,GAAG,EAAE;AAE/D,SAAO;GACN,sBAAsBA;GACtB,6BAA6B;GAC7B;IACC,CAAC,cAAc,CAAC;CAGnB,MAAM,oBAAoB,aACxB,mBAA4B;AAC5B,wBAAsB,eAAe;IAEtC,CAAC,oBAAoB,CACrB;CAED,MAAM,mBAAmB,aACvB,mBAA2B;AAC3B,uBAAqB,eAAe;IAErC,CAAC,mBAAmB,CACpB;CAED,MAAM,0BAA0B,kBAAkB;AACjD,+BAA6B;IAC3B,CAAC,0BAA0B,CAAC;AAE/B,QAAO;EACN;EACA;EACA;EACA;EACA;EACA,kBAAkB,cAAc,SAAS;EACzC;EACA;EACA;EACA"}