@cossistant/react 0.0.1

package/hooks/private/use-rest-client.d.ts

@@ -0,0 +1,17 @@
+import { CossistantClient } from "@cossistant/core";
+
+//#region src/hooks/private/use-rest-client.d.ts
+type UseClientResult = {
+  client: CossistantClient;
+  error: Error | null;
+};
+/**
+ * Creates a memoised `CossistantClient` instance using the provided endpoints
+ * and public key. When no key is passed the hook falls back to environment
+ * variables and surfaces missing configuration errors through the returned
+ * `error` field.
+ */
+declare function useClient(publicKey: string | undefined, apiUrl?: string, wsUrl?: string): UseClientResult;
+//#endregion
+export { UseClientResult, useClient };
+//# sourceMappingURL=use-rest-client.d.ts.map

package/hooks/private/use-rest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-rest-client.d.ts","names":[],"sources":["../../../src/hooks/private/use-rest-client.ts"],"sourcesContent":[],"mappings":";;;KAMY,eAAA;UACH;EADG,KAAA,EAEJ,KAFI,GAAA,IAAe;CAAA;;;;AAW3B;;;iBAAgB,SAAA,kEAIb"}

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

@@ -0,0 +1,41 @@
+"use client";
+
+
+import { useMemo } from "react";
+import { CossistantClient } from "@cossistant/core";
+
+//#region src/hooks/private/use-rest-client.ts
+/**
+* Creates a memoised `CossistantClient` instance using the provided endpoints
+* and public key. When no key is passed the hook falls back to environment
+* variables and surfaces missing configuration errors through the returned
+* `error` field.
+*/
+function useClient(publicKey, apiUrl = "https://api.cossistant.com/v1", wsUrl = "wss://api.cossistant.com/ws") {
+	return {
+		client: useMemo(() => {
+			const keyFromEnv = process.env.NEXT_PUBLIC_COSSISTANT_KEY || process.env.COSSISTANT_PUBLIC_KEY;
+			const keyToUse = publicKey ?? keyFromEnv;
+			if (!keyToUse) throw new Error("Public key is required. Please provide it as a prop or set NEXT_PUBLIC_COSSISTANT_KEY environment variable.");
+			const config = {
+				apiUrl,
+				wsUrl,
+				publicKey: keyToUse
+			};
+			try {
+				return new CossistantClient(config);
+			} catch (err) {
+				throw err instanceof Error ? err : /* @__PURE__ */ new Error("Failed to initialize Cossistant client");
+			}
+		}, [
+			publicKey,
+			apiUrl,
+			wsUrl
+		]),
+		error: null
+	};
+}
+
+//#endregion
+export { useClient };
+//# sourceMappingURL=use-rest-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-rest-client.js","names":["config: CossistantConfig","err: unknown"],"sources":["../../../src/hooks/private/use-rest-client.ts"],"sourcesContent":["\"use client\";\n\nimport { CossistantClient } from \"@cossistant/core\";\nimport type { CossistantConfig } from \"@cossistant/types\";\nimport { useMemo } from \"react\";\n\nexport type UseClientResult = {\n\tclient: CossistantClient;\n\terror: Error | null;\n};\n\n/**\n * Creates a memoised `CossistantClient` instance using the provided endpoints\n * and public key. When no key is passed the hook falls back to environment\n * variables and surfaces missing configuration errors through the returned\n * `error` field.\n */\nexport function useClient(\n\tpublicKey: string | undefined,\n\tapiUrl = \"https://api.cossistant.com/v1\",\n\twsUrl = \"wss://api.cossistant.com/ws\"\n): UseClientResult {\n\tconst client = useMemo(() => {\n\t\tconst keyFromEnv =\n\t\t\tprocess.env.NEXT_PUBLIC_COSSISTANT_KEY ||\n\t\t\tprocess.env.COSSISTANT_PUBLIC_KEY;\n\t\tconst keyToUse = publicKey ?? keyFromEnv;\n\n\t\tif (!keyToUse) {\n\t\t\tthrow new Error(\n\t\t\t\t\"Public key is required. Please provide it as a prop or set NEXT_PUBLIC_COSSISTANT_KEY environment variable.\"\n\t\t\t);\n\t\t}\n\n\t\tconst config: CossistantConfig = {\n\t\t\tapiUrl,\n\t\t\twsUrl,\n\t\t\tpublicKey: keyToUse,\n\t\t};\n\n\t\ttry {\n\t\t\treturn new CossistantClient(config);\n\t\t} catch (err: unknown) {\n\t\t\tthrow err instanceof Error\n\t\t\t\t? err\n\t\t\t\t: new Error(\"Failed to initialize Cossistant client\");\n\t\t}\n\t}, [publicKey, apiUrl, wsUrl]);\n\n\treturn { client, error: null };\n}\n"],"mappings":";;;;;;;;;;;;;AAiBA,SAAgB,UACf,WACA,SAAS,iCACT,QAAQ,+BACU;AA4BlB,QAAO;EAAE,QA3BM,cAAc;GAC5B,MAAM,aACL,QAAQ,IAAI,8BACZ,QAAQ,IAAI;GACb,MAAM,WAAW,aAAa;AAE9B,OAAI,CAAC,SACJ,OAAM,IAAI,MACT,8GACA;GAGF,MAAMA,SAA2B;IAChC;IACA;IACA,WAAW;IACX;AAED,OAAI;AACH,WAAO,IAAI,iBAAiB,OAAO;YAC3BC,KAAc;AACtB,UAAM,eAAe,QAClB,sBACA,IAAI,MAAM,yCAAyC;;KAErD;GAAC;GAAW;GAAQ;GAAM,CAAC;EAEb,OAAO;EAAM"}

package/hooks/private/use-visitor-typing-reporter.d.ts

@@ -0,0 +1,19 @@
+import { CossistantClient } from "@cossistant/core";
+
+//#region src/hooks/private/use-visitor-typing-reporter.d.ts
+type UseVisitorTypingReporterOptions = {
+  client: CossistantClient | null;
+  conversationId: string | null;
+};
+type UseVisitorTypingReporterResult = {
+  handleInputChange: (value: string) => void;
+  handleSubmit: () => void;
+  stop: () => void;
+};
+declare function useVisitorTypingReporter({
+  client,
+  conversationId
+}: UseVisitorTypingReporterOptions): UseVisitorTypingReporterResult;
+//#endregion
+export { useVisitorTypingReporter };
+//# sourceMappingURL=use-visitor-typing-reporter.d.ts.map

package/hooks/private/use-visitor-typing-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visitor-typing-reporter.d.ts","names":[],"sources":["../../../src/hooks/private/use-visitor-typing-reporter.ts"],"sourcesContent":[],"mappings":";;;KAQK,+BAAA;UACI;EADJ,cAAA,EAAA,MAAA,GAAA,IAAA;AACoB,CAAA;AAUzB,KANK,8BAAA,GAMmC;EAAA,iBAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,IAAA;cACvC,EAAA,GAAA,GAAA,IAAA;MACA,EAAA,GAAA,GAAA,IAAA;;AACoC,iBAHrB,wBAAA,CAGqB;EAAA,MAAA;EAAA;AAAA,CAAA,EAAlC,+BAAkC,CAAA,EAAA,8BAAA"}

package/hooks/private/use-visitor-typing-reporter.js

@@ -0,0 +1,140 @@
+import { useCallback, useEffect, useRef } from "react";
+
+//#region src/hooks/private/use-visitor-typing-reporter.ts
+const PREVIEW_MAX_LENGTH = 2e3;
+const SEND_INTERVAL_MS = 800;
+const KEEP_ALIVE_MS = 4e3;
+const STOP_TYPING_DELAY_MS = 2e3;
+function useVisitorTypingReporter({ client, conversationId }) {
+	const typingActiveRef = useRef(false);
+	const lastSentAtRef = useRef(0);
+	const latestPreviewRef = useRef("");
+	const keepAliveTimeoutRef = useRef(null);
+	const stopTypingTimeoutRef = useRef(null);
+	const clearKeepAlive = useCallback(() => {
+		if (keepAliveTimeoutRef.current) {
+			clearTimeout(keepAliveTimeoutRef.current);
+			keepAliveTimeoutRef.current = null;
+		}
+	}, []);
+	const clearStopTypingTimeout = useCallback(() => {
+		if (stopTypingTimeoutRef.current) {
+			clearTimeout(stopTypingTimeoutRef.current);
+			stopTypingTimeoutRef.current = null;
+		}
+	}, []);
+	const sendTyping = useCallback(async (isTyping, preview) => {
+		if (!(client && conversationId)) return;
+		try {
+			await client.setVisitorTyping({
+				conversationId,
+				isTyping,
+				visitorPreview: preview ?? void 0
+			});
+		} catch (error) {
+			console.error("[Support] Failed to send typing event", error);
+		}
+	}, [client, conversationId]);
+	const scheduleKeepAlive = useCallback(() => {
+		clearKeepAlive();
+		keepAliveTimeoutRef.current = setTimeout(() => {
+			if (typingActiveRef.current) {
+				sendTyping(true, latestPreviewRef.current);
+				scheduleKeepAlive();
+			}
+		}, KEEP_ALIVE_MS);
+	}, [clearKeepAlive, sendTyping]);
+	const scheduleStopTyping = useCallback(() => {
+		clearStopTypingTimeout();
+		stopTypingTimeoutRef.current = setTimeout(() => {
+			if (typingActiveRef.current) {
+				typingActiveRef.current = false;
+				clearKeepAlive();
+				sendTyping(false);
+			}
+		}, STOP_TYPING_DELAY_MS);
+	}, [
+		clearStopTypingTimeout,
+		clearKeepAlive,
+		sendTyping
+	]);
+	const handleInputChange = useCallback((value) => {
+		if (!(client && conversationId)) return;
+		const trimmed = value.trim();
+		latestPreviewRef.current = trimmed.slice(0, PREVIEW_MAX_LENGTH);
+		const now = Date.now();
+		if (trimmed.length === 0) {
+			if (typingActiveRef.current) {
+				typingActiveRef.current = false;
+				lastSentAtRef.current = now;
+				clearKeepAlive();
+				clearStopTypingTimeout();
+				sendTyping(false);
+			}
+			return;
+		}
+		scheduleStopTyping();
+		if (!typingActiveRef.current) {
+			typingActiveRef.current = true;
+			lastSentAtRef.current = now;
+			sendTyping(true, latestPreviewRef.current);
+			scheduleKeepAlive();
+			return;
+		}
+		if (now - lastSentAtRef.current >= SEND_INTERVAL_MS) {
+			lastSentAtRef.current = now;
+			sendTyping(true, latestPreviewRef.current);
+			scheduleKeepAlive();
+		}
+	}, [
+		client,
+		conversationId,
+		sendTyping,
+		scheduleKeepAlive,
+		scheduleStopTyping,
+		clearKeepAlive,
+		clearStopTypingTimeout
+	]);
+	const handleSubmit = useCallback(() => {
+		if (!typingActiveRef.current) return;
+		typingActiveRef.current = false;
+		lastSentAtRef.current = Date.now();
+		clearKeepAlive();
+		clearStopTypingTimeout();
+		sendTyping(false);
+	}, [
+		clearKeepAlive,
+		clearStopTypingTimeout,
+		sendTyping
+	]);
+	const stop = useCallback(() => {
+		if (!typingActiveRef.current) return;
+		typingActiveRef.current = false;
+		lastSentAtRef.current = Date.now();
+		clearKeepAlive();
+		clearStopTypingTimeout();
+		sendTyping(false);
+	}, [
+		clearKeepAlive,
+		clearStopTypingTimeout,
+		sendTyping
+	]);
+	useEffect(() => () => {
+		if (typingActiveRef.current) sendTyping(false);
+		clearKeepAlive();
+		clearStopTypingTimeout();
+	}, [
+		clearKeepAlive,
+		clearStopTypingTimeout,
+		sendTyping
+	]);
+	return {
+		handleInputChange,
+		handleSubmit,
+		stop
+	};
+}
+
+//#endregion
+export { useVisitorTypingReporter };
+//# sourceMappingURL=use-visitor-typing-reporter.js.map

package/hooks/private/use-visitor-typing-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visitor-typing-reporter.js","names":[],"sources":["../../../src/hooks/private/use-visitor-typing-reporter.ts"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport { useCallback, useEffect, useRef } from \"react\";\n\nconst PREVIEW_MAX_LENGTH = 2000;\nconst SEND_INTERVAL_MS = 800;\nconst KEEP_ALIVE_MS = 4000;\nconst STOP_TYPING_DELAY_MS = 2000; // Send isTyping: false after 2 seconds of inactivity\n\ntype UseVisitorTypingReporterOptions = {\n\tclient: CossistantClient | null;\n\tconversationId: string | null;\n};\n\ntype UseVisitorTypingReporterResult = {\n\thandleInputChange: (value: string) => void;\n\thandleSubmit: () => void;\n\tstop: () => void;\n};\n\nexport function useVisitorTypingReporter({\n\tclient,\n\tconversationId,\n}: UseVisitorTypingReporterOptions): UseVisitorTypingReporterResult {\n\tconst typingActiveRef = useRef(false);\n\tconst lastSentAtRef = useRef(0);\n\tconst latestPreviewRef = useRef<string>(\"\");\n\tconst keepAliveTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(\n\t\tnull\n\t);\n\tconst stopTypingTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(\n\t\tnull\n\t);\n\n\tconst clearKeepAlive = useCallback(() => {\n\t\tif (keepAliveTimeoutRef.current) {\n\t\t\tclearTimeout(keepAliveTimeoutRef.current);\n\t\t\tkeepAliveTimeoutRef.current = null;\n\t\t}\n\t}, []);\n\n\tconst clearStopTypingTimeout = useCallback(() => {\n\t\tif (stopTypingTimeoutRef.current) {\n\t\t\tclearTimeout(stopTypingTimeoutRef.current);\n\t\t\tstopTypingTimeoutRef.current = null;\n\t\t}\n\t}, []);\n\n\tconst sendTyping = useCallback(\n\t\tasync (isTyping: boolean, preview?: string | null) => {\n\t\t\tif (!(client && conversationId)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tawait client.setVisitorTyping({\n\t\t\t\t\tconversationId,\n\t\t\t\t\tisTyping,\n\t\t\t\t\tvisitorPreview: preview ?? undefined,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"[Support] Failed to send typing event\", error);\n\t\t\t}\n\t\t},\n\t\t[client, conversationId]\n\t);\n\n\tconst scheduleKeepAlive = useCallback(() => {\n\t\tclearKeepAlive();\n\t\tkeepAliveTimeoutRef.current = setTimeout(() => {\n\t\t\tif (typingActiveRef.current) {\n\t\t\t\tvoid sendTyping(true, latestPreviewRef.current);\n\t\t\t\tscheduleKeepAlive();\n\t\t\t}\n\t\t}, KEEP_ALIVE_MS);\n\t}, [clearKeepAlive, sendTyping]);\n\n\tconst scheduleStopTyping = useCallback(() => {\n\t\tclearStopTypingTimeout();\n\t\tstopTypingTimeoutRef.current = setTimeout(() => {\n\t\t\tif (typingActiveRef.current) {\n\t\t\t\ttypingActiveRef.current = false;\n\t\t\t\tclearKeepAlive();\n\t\t\t\tvoid sendTyping(false);\n\t\t\t}\n\t\t}, STOP_TYPING_DELAY_MS);\n\t}, [clearStopTypingTimeout, clearKeepAlive, sendTyping]);\n\n\tconst handleInputChange = useCallback(\n\t\t(value: string) => {\n\t\t\tif (!(client && conversationId)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst trimmed = value.trim();\n\t\t\tlatestPreviewRef.current = trimmed.slice(0, PREVIEW_MAX_LENGTH);\n\t\t\tconst now = Date.now();\n\n\t\t\tif (trimmed.length === 0) {\n\t\t\t\tif (typingActiveRef.current) {\n\t\t\t\t\ttypingActiveRef.current = false;\n\t\t\t\t\tlastSentAtRef.current = now;\n\t\t\t\t\tclearKeepAlive();\n\t\t\t\t\tclearStopTypingTimeout();\n\t\t\t\t\tvoid sendTyping(false);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Schedule auto-stop after inactivity\n\t\t\tscheduleStopTyping();\n\n\t\t\tif (!typingActiveRef.current) {\n\t\t\t\ttypingActiveRef.current = true;\n\t\t\t\tlastSentAtRef.current = now;\n\t\t\t\tvoid sendTyping(true, latestPreviewRef.current);\n\t\t\t\tscheduleKeepAlive();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif (now - lastSentAtRef.current >= SEND_INTERVAL_MS) {\n\t\t\t\tlastSentAtRef.current = now;\n\t\t\t\tvoid sendTyping(true, latestPreviewRef.current);\n\t\t\t\tscheduleKeepAlive();\n\t\t\t}\n\t\t},\n\t\t[\n\t\t\tclient,\n\t\t\tconversationId,\n\t\t\tsendTyping,\n\t\t\tscheduleKeepAlive,\n\t\t\tscheduleStopTyping,\n\t\t\tclearKeepAlive,\n\t\t\tclearStopTypingTimeout,\n\t\t]\n\t);\n\n\tconst handleSubmit = useCallback(() => {\n\t\tif (!typingActiveRef.current) {\n\t\t\treturn;\n\t\t}\n\n\t\ttypingActiveRef.current = false;\n\t\tlastSentAtRef.current = Date.now();\n\t\tclearKeepAlive();\n\t\tclearStopTypingTimeout();\n\t\tvoid sendTyping(false);\n\t}, [clearKeepAlive, clearStopTypingTimeout, sendTyping]);\n\n\tconst stop = useCallback(() => {\n\t\tif (!typingActiveRef.current) {\n\t\t\treturn;\n\t\t}\n\n\t\ttypingActiveRef.current = false;\n\t\tlastSentAtRef.current = Date.now();\n\t\tclearKeepAlive();\n\t\tclearStopTypingTimeout();\n\t\tvoid sendTyping(false);\n\t}, [clearKeepAlive, clearStopTypingTimeout, sendTyping]);\n\n\tuseEffect(\n\t\t() => () => {\n\t\t\tif (typingActiveRef.current) {\n\t\t\t\tvoid sendTyping(false);\n\t\t\t}\n\t\t\tclearKeepAlive();\n\t\t\tclearStopTypingTimeout();\n\t\t},\n\t\t[clearKeepAlive, clearStopTypingTimeout, sendTyping]\n\t);\n\n\treturn {\n\t\thandleInputChange,\n\t\thandleSubmit,\n\t\tstop,\n\t};\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import { MutableRefObject } from "react";
+
+//#region src/hooks/use-composer-refocus.d.ts
+type UseComposerRefocusOptions = {
+  disabled: boolean;
+  hasContent: boolean;
+  isSubmitting: boolean;
+};
+type UseComposerRefocusReturn = {
+  focusComposer: () => void;
+  inputRef: MutableRefObject<HTMLTextAreaElement | null>;
+};
+declare const useComposerRefocus: ({
+  disabled,
+  hasContent,
+  isSubmitting
+}: UseComposerRefocusOptions) => UseComposerRefocusReturn;
+//#endregion
+export { UseComposerRefocusOptions, UseComposerRefocusReturn, useComposerRefocus };
+//# sourceMappingURL=use-composer-refocus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-composer-refocus.d.ts","names":[],"sources":["../../src/hooks/use-composer-refocus.ts"],"sourcesContent":[],"mappings":";;;KAGY,yBAAA;;EAAA,UAAA,EAAA,OAAA;EAMA,YAAA,EAAA,OAAA;CAAwB;AAER,KAFhB,wBAAA,GAEgB;eAAjB,EAAA,GAAA,GAAA,IAAA;EAAgB,QAAA,EAAhB,gBAAgB,CAAC,mBAAD,GAAA,IAAA,CAAA;AAG3B,CAAA;AAmCC,cAnCY,kBAmCZ,EAAA,CAAA;EAAA,QAAA;EAAA,UAAA;EAAA;AAAA,CAAA,EA/BE,yBA+BF,EAAA,GA/B8B,wBA+B9B"}

package/hooks/use-composer-refocus.js

@@ -0,0 +1,32 @@
+import { useCallback, useEffect, useRef } from "react";
+
+//#region src/hooks/use-composer-refocus.ts
+const useComposerRefocus = ({ disabled, hasContent, isSubmitting }) => {
+	const inputRef = useRef(null);
+	const previousStateRef = useRef({
+		isSubmitting,
+		hadContent: hasContent
+	});
+	useEffect(() => {
+		const previous = previousStateRef.current;
+		if (!(disabled || isSubmitting || hasContent) && (previous.isSubmitting || previous.hadContent)) inputRef.current?.focus();
+		previousStateRef.current = {
+			isSubmitting,
+			hadContent: hasContent
+		};
+	}, [
+		disabled,
+		hasContent,
+		isSubmitting
+	]);
+	return {
+		focusComposer: useCallback(() => {
+			inputRef.current?.focus();
+		}, []),
+		inputRef
+	};
+};
+
+//#endregion
+export { useComposerRefocus };
+//# sourceMappingURL=use-composer-refocus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-composer-refocus.js","names":[],"sources":["../../src/hooks/use-composer-refocus.ts"],"sourcesContent":["import type { MutableRefObject } from \"react\";\nimport { useCallback, useEffect, useRef } from \"react\";\n\nexport type UseComposerRefocusOptions = {\n\tdisabled: boolean;\n\thasContent: boolean;\n\tisSubmitting: boolean;\n};\n\nexport type UseComposerRefocusReturn = {\n\tfocusComposer: () => void;\n\tinputRef: MutableRefObject<HTMLTextAreaElement | null>;\n};\n\nexport const useComposerRefocus = ({\n\tdisabled,\n\thasContent,\n\tisSubmitting,\n}: UseComposerRefocusOptions): UseComposerRefocusReturn => {\n\tconst inputRef = useRef<HTMLTextAreaElement | null>(null);\n\tconst previousStateRef = useRef({\n\t\tisSubmitting,\n\t\thadContent: hasContent,\n\t});\n\n\tuseEffect(() => {\n\t\tconst previous = previousStateRef.current;\n\n\t\tif (\n\t\t\t!(disabled || isSubmitting || hasContent) &&\n\t\t\t(previous.isSubmitting || previous.hadContent)\n\t\t) {\n\t\t\tinputRef.current?.focus();\n\t\t}\n\n\t\tpreviousStateRef.current = {\n\t\t\tisSubmitting,\n\t\t\thadContent: hasContent,\n\t\t};\n\t}, [disabled, hasContent, isSubmitting]);\n\n\tconst focusComposer = useCallback(() => {\n\t\tinputRef.current?.focus();\n\t}, []);\n\n\treturn {\n\t\tfocusComposer,\n\t\tinputRef,\n\t};\n};\n"],"mappings":";;;AAcA,MAAa,sBAAsB,EAClC,UACA,YACA,mBAC0D;CAC1D,MAAM,WAAW,OAAmC,KAAK;CACzD,MAAM,mBAAmB,OAAO;EAC/B;EACA,YAAY;EACZ,CAAC;AAEF,iBAAgB;EACf,MAAM,WAAW,iBAAiB;AAElC,MACC,EAAE,YAAY,gBAAgB,gBAC7B,SAAS,gBAAgB,SAAS,YAEnC,UAAS,SAAS,OAAO;AAG1B,mBAAiB,UAAU;GAC1B;GACA,YAAY;GACZ;IACC;EAAC;EAAU;EAAY;EAAa,CAAC;AAMxC,QAAO;EACN,eALqB,kBAAkB;AACvC,YAAS,SAAS,OAAO;KACvB,EAAE,CAAC;EAIL;EACA"}

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

@@ -0,0 +1,54 @@
+import { TimelineItem } from "../timeline-item.js";
+import { CossistantClient } from "@cossistant/core";
+
+//#region src/hooks/use-conversation-auto-seen.d.ts
+declare const CONVERSATION_AUTO_SEEN_DELAY_MS = 2000;
+type UseConversationAutoSeenOptions = {
+  /**
+   * The Cossistant client instance.
+   */
+  client: CossistantClient | null;
+  /**
+   * The real conversation ID. Pass null if no conversation exists yet.
+   */
+  conversationId: string | null;
+  /**
+   * Current visitor ID.
+   */
+  visitorId?: string;
+  /**
+   * The last timeline item in the conversation.
+   * Used to determine if we should mark as seen.
+   */
+  lastTimelineItem: TimelineItem | null;
+  /**
+   * Whether to enable auto-seen tracking.
+   * Default: true
+   */
+  enabled?: boolean;
+};
+/**
+ * Automatically marks timeline items as seen when:
+ * - A new timeline item arrives from someone else
+ * - The page is visible/focused
+ * - The visitor is the current user
+ *
+ * Also handles:
+ * - Fetching and hydrating initial seen data
+ * - Preventing duplicate API calls
+ * - Page visibility tracking
+ *
+ * @example
+ * ```tsx
+ * useConversationAutoSeen({
+ *   client,
+ *   conversationId: realConversationId,
+ *   visitorId: visitor?.id,
+ *   lastTimelineItem: items[items.length - 1] ?? null,
+ * });
+ * ```
+ */
+declare function useConversationAutoSeen(options: UseConversationAutoSeenOptions): void;
+//#endregion
+export { CONVERSATION_AUTO_SEEN_DELAY_MS, UseConversationAutoSeenOptions, useConversationAutoSeen };
+//# sourceMappingURL=use-conversation-auto-seen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-auto-seen.d.ts","names":[],"sources":["../../src/hooks/use-conversation-auto-seen.ts"],"sourcesContent":[],"mappings":";;;;cASa,+BAAA;KAED,8BAAA;EAFC;AAEb;;QAIS,EAAA,gBAAA,GAAA,IAAA;;;AA8CT;;;;;;;;;;oBA9BmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BH,uBAAA,UACN"}

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

@@ -0,0 +1,106 @@
+import { hydrateConversationSeen, upsertConversationSeen } from "../realtime/seen-store.js";
+import { useWindowVisibilityFocus } from "./use-window-visibility-focus.js";
+import { useEffect, useRef } from "react";
+
+//#region src/hooks/use-conversation-auto-seen.ts
+const CONVERSATION_AUTO_SEEN_DELAY_MS = 2e3;
+/**
+* Automatically marks timeline items as seen when:
+* - A new timeline item arrives from someone else
+* - The page is visible/focused
+* - The visitor is the current user
+*
+* Also handles:
+* - Fetching and hydrating initial seen data
+* - Preventing duplicate API calls
+* - Page visibility tracking
+*
+* @example
+* ```tsx
+* useConversationAutoSeen({
+*   client,
+*   conversationId: realConversationId,
+*   visitorId: visitor?.id,
+*   lastTimelineItem: items[items.length - 1] ?? null,
+* });
+* ```
+*/
+function useConversationAutoSeen(options) {
+	const { client, conversationId, visitorId, lastTimelineItem, enabled = true } = options;
+	const lastSeenItemIdRef = useRef(null);
+	const markSeenInFlightRef = useRef(false);
+	const markSeenTimeoutRef = useRef(null);
+	const { isPageVisible, hasWindowFocus } = useWindowVisibilityFocus();
+	useEffect(() => {
+		lastSeenItemIdRef.current = null;
+		markSeenInFlightRef.current = false;
+		if (markSeenTimeoutRef.current) {
+			clearTimeout(markSeenTimeoutRef.current);
+			markSeenTimeoutRef.current = null;
+		}
+	}, [conversationId]);
+	useEffect(() => {
+		if (enabled && client && conversationId) client.getConversationSeenData({ conversationId }).then((response) => {
+			if (response.seenData.length > 0) hydrateConversationSeen(conversationId, response.seenData);
+		}).catch((err) => {
+			console.error("Failed to fetch conversation seen data:", err);
+		});
+	}, [
+		enabled,
+		client,
+		conversationId
+	]);
+	useEffect(() => {
+		if (markSeenTimeoutRef.current) {
+			clearTimeout(markSeenTimeoutRef.current);
+			markSeenTimeoutRef.current = null;
+		}
+		if (!(enabled && client && conversationId && visitorId && lastTimelineItem && isPageVisible && hasWindowFocus)) return;
+		if (lastTimelineItem.visitorId === visitorId) {
+			lastSeenItemIdRef.current = lastTimelineItem.id || null;
+			return;
+		}
+		if (lastSeenItemIdRef.current === lastTimelineItem.id) return;
+		if (markSeenInFlightRef.current) return;
+		const pendingItemId = lastTimelineItem.id || null;
+		markSeenTimeoutRef.current = setTimeout(() => {
+			if (!client || !conversationId) {
+				markSeenTimeoutRef.current = null;
+				return;
+			}
+			markSeenInFlightRef.current = true;
+			client.markConversationSeen({ conversationId }).then((response) => {
+				lastSeenItemIdRef.current = pendingItemId;
+				upsertConversationSeen({
+					conversationId,
+					actorType: "visitor",
+					actorId: visitorId,
+					lastSeenAt: new Date(response.lastSeenAt)
+				});
+			}).catch((err) => {
+				console.error("Failed to mark conversation as seen:", err);
+			}).finally(() => {
+				markSeenInFlightRef.current = false;
+				markSeenTimeoutRef.current = null;
+			});
+		}, CONVERSATION_AUTO_SEEN_DELAY_MS);
+		return () => {
+			if (markSeenTimeoutRef.current) {
+				clearTimeout(markSeenTimeoutRef.current);
+				markSeenTimeoutRef.current = null;
+			}
+		};
+	}, [
+		enabled,
+		client,
+		conversationId,
+		visitorId,
+		lastTimelineItem,
+		isPageVisible,
+		hasWindowFocus
+	]);
+}
+
+//#endregion
+export { CONVERSATION_AUTO_SEEN_DELAY_MS, useConversationAutoSeen };
+//# sourceMappingURL=use-conversation-auto-seen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-auto-seen.js","names":[],"sources":["../../src/hooks/use-conversation-auto-seen.ts"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport { useEffect, useRef } from \"react\";\nimport {\n        hydrateConversationSeen,\n        upsertConversationSeen,\n} from \"../realtime/seen-store\";\nimport { useWindowVisibilityFocus } from \"./use-window-visibility-focus\";\n\nexport const CONVERSATION_AUTO_SEEN_DELAY_MS = 2000;\n\nexport type UseConversationAutoSeenOptions = {\n\t/**\n\t * The Cossistant client instance.\n\t */\n\tclient: CossistantClient | null;\n\n\t/**\n\t * The real conversation ID. Pass null if no conversation exists yet.\n\t */\n\tconversationId: string | null;\n\n\t/**\n\t * Current visitor ID.\n\t */\n\tvisitorId?: string;\n\n\t/**\n\t * The last timeline item in the conversation.\n\t * Used to determine if we should mark as seen.\n\t */\n\tlastTimelineItem: TimelineItem | null;\n\n\t/**\n\t * Whether to enable auto-seen tracking.\n\t * Default: true\n\t */\n\tenabled?: boolean;\n};\n\n/**\n * Automatically marks timeline items as seen when:\n * - A new timeline item arrives from someone else\n * - The page is visible/focused\n * - The visitor is the current user\n *\n * Also handles:\n * - Fetching and hydrating initial seen data\n * - Preventing duplicate API calls\n * - Page visibility tracking\n *\n * @example\n * ```tsx\n * useConversationAutoSeen({\n *   client,\n *   conversationId: realConversationId,\n *   visitorId: visitor?.id,\n *   lastTimelineItem: items[items.length - 1] ?? null,\n * });\n * ```\n */\nexport function useConversationAutoSeen(\n\toptions: UseConversationAutoSeenOptions\n): void {\n\tconst {\n\t\tclient,\n\t\tconversationId,\n\t\tvisitorId,\n\t\tlastTimelineItem,\n\t\tenabled = true,\n\t} = options;\n\n        const lastSeenItemIdRef = useRef<string | null>(null);\n        const markSeenInFlightRef = useRef(false);\n        const markSeenTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n        const { isPageVisible, hasWindowFocus } = useWindowVisibilityFocus();\n\n        // Reset seen tracking when conversation changes\n        useEffect(() => {\n                lastSeenItemIdRef.current = null;\n                markSeenInFlightRef.current = false;\n                if (markSeenTimeoutRef.current) {\n                        clearTimeout(markSeenTimeoutRef.current);\n                        markSeenTimeoutRef.current = null;\n                }\n        }, [conversationId]);\n\n\t// Fetch and hydrate initial seen data when conversation loads\n\tuseEffect(() => {\n\t\tif (enabled && client && conversationId) {\n\t\t\tvoid client\n\t\t\t\t.getConversationSeenData({ conversationId })\n\t\t\t\t.then((response) => {\n\t\t\t\t\tif (response.seenData.length > 0) {\n\t\t\t\t\t\thydrateConversationSeen(conversationId, response.seenData);\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t\t.catch((err) => {\n\t\t\t\t\tconsole.error(\"Failed to fetch conversation seen data:\", err);\n\t\t\t\t});\n\t\t}\n\t}, [enabled, client, conversationId]);\n\n        // Auto-mark timeline items as seen\n        useEffect(() => {\n                if (markSeenTimeoutRef.current) {\n                        clearTimeout(markSeenTimeoutRef.current);\n                        markSeenTimeoutRef.current = null;\n                }\n\n                const shouldMark =\n                        enabled &&\n                        client &&\n                        conversationId &&\n                        visitorId &&\n                        lastTimelineItem &&\n                        isPageVisible &&\n                        hasWindowFocus;\n\n                if (!shouldMark) {\n                        return;\n                }\n\n                // Don't mark our own timeline items as seen via API (we already know we saw them)\n                if (lastTimelineItem.visitorId === visitorId) {\n                        lastSeenItemIdRef.current = lastTimelineItem.id || null;\n                        return;\n                }\n\n                // Already marked this item\n                if (lastSeenItemIdRef.current === lastTimelineItem.id) {\n                        return;\n                }\n\n                // Already in flight\n                if (markSeenInFlightRef.current) {\n                        return;\n                }\n\n                const pendingItemId = lastTimelineItem.id || null;\n\n                markSeenTimeoutRef.current = setTimeout(() => {\n                        if (!client || !conversationId) {\n                                markSeenTimeoutRef.current = null;\n                                return;\n                        }\n\n                        markSeenInFlightRef.current = true;\n\n                        client\n                                .markConversationSeen({ conversationId })\n                                .then((response) => {\n                                        lastSeenItemIdRef.current = pendingItemId;\n\n                                        // Optimistically update local seen store\n                                        upsertConversationSeen({\n                                                conversationId,\n                                                actorType: \"visitor\",\n                                                actorId: visitorId,\n                                                lastSeenAt: new Date(response.lastSeenAt),\n                                        });\n                                })\n                                .catch((err) => {\n                                        console.error(\"Failed to mark conversation as seen:\", err);\n                                })\n                                .finally(() => {\n                                        markSeenInFlightRef.current = false;\n                                        markSeenTimeoutRef.current = null;\n                                });\n                }, CONVERSATION_AUTO_SEEN_DELAY_MS);\n\n                return () => {\n                        if (markSeenTimeoutRef.current) {\n                                clearTimeout(markSeenTimeoutRef.current);\n                                markSeenTimeoutRef.current = null;\n                        }\n                };\n        }, [\n                enabled,\n                client,\n                conversationId,\n                visitorId,\n                lastTimelineItem,\n                isPageVisible,\n                hasWindowFocus,\n        ]);\n}\n"],"mappings":";;;;;AASA,MAAa,kCAAkC;;;;;;;;;;;;;;;;;;;;;;AAoD/C,SAAgB,wBACf,SACO;CACP,MAAM,EACL,QACA,gBACA,WACA,kBACA,UAAU,SACP;CAEG,MAAM,oBAAoB,OAAsB,KAAK;CACrD,MAAM,sBAAsB,OAAO,MAAM;CACzC,MAAM,qBAAqB,OAA6C,KAAK;CAC7E,MAAM,EAAE,eAAe,mBAAmB,0BAA0B;AAGpE,iBAAgB;AACR,oBAAkB,UAAU;AAC5B,sBAAoB,UAAU;AAC9B,MAAI,mBAAmB,SAAS;AACxB,gBAAa,mBAAmB,QAAQ;AACxC,sBAAmB,UAAU;;IAE1C,CAAC,eAAe,CAAC;AAG3B,iBAAgB;AACf,MAAI,WAAW,UAAU,eACxB,CAAK,OACH,wBAAwB,EAAE,gBAAgB,CAAC,CAC3C,MAAM,aAAa;AACnB,OAAI,SAAS,SAAS,SAAS,EAC9B,yBAAwB,gBAAgB,SAAS,SAAS;IAE1D,CACD,OAAO,QAAQ;AACf,WAAQ,MAAM,2CAA2C,IAAI;IAC5D;IAEF;EAAC;EAAS;EAAQ;EAAe,CAAC;AAG9B,iBAAgB;AACR,MAAI,mBAAmB,SAAS;AACxB,gBAAa,mBAAmB,QAAQ;AACxC,sBAAmB,UAAU;;AAYrC,MAAI,EARI,WACA,UACA,kBACA,aACA,oBACA,iBACA,gBAGA;AAIR,MAAI,iBAAiB,cAAc,WAAW;AACtC,qBAAkB,UAAU,iBAAiB,MAAM;AACnD;;AAIR,MAAI,kBAAkB,YAAY,iBAAiB,GAC3C;AAIR,MAAI,oBAAoB,QAChB;EAGR,MAAM,gBAAgB,iBAAiB,MAAM;AAE7C,qBAAmB,UAAU,iBAAiB;AACtC,OAAI,CAAC,UAAU,CAAC,gBAAgB;AACxB,uBAAmB,UAAU;AAC7B;;AAGR,uBAAoB,UAAU;AAE9B,UACS,qBAAqB,EAAE,gBAAgB,CAAC,CACxC,MAAM,aAAa;AACZ,sBAAkB,UAAU;AAG5B,2BAAuB;KACf;KACA,WAAW;KACX,SAAS;KACT,YAAY,IAAI,KAAK,SAAS,WAAW;KAChD,CAAC;KACR,CACD,OAAO,QAAQ;AACR,YAAQ,MAAM,wCAAwC,IAAI;KAChE,CACD,cAAc;AACP,wBAAoB,UAAU;AAC9B,uBAAmB,UAAU;KACnC;KACf,gCAAgC;AAEnC,eAAa;AACL,OAAI,mBAAmB,SAAS;AACxB,iBAAa,mBAAmB,QAAQ;AACxC,uBAAmB,UAAU;;;IAGlD;EACK;EACA;EACA;EACA;EACA;EACA;EACA;EACP,CAAC"}

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

@@ -0,0 +1,86 @@
+import { Conversation } from "@cossistant/types";
+
+//#region src/hooks/use-conversation-history-page.d.ts
+type UseConversationHistoryPageOptions = {
+  /**
+   * Initial number of conversations to display.
+   * Default: 4
+   */
+  initialVisibleCount?: number;
+  /**
+   * Whether to enable conversations fetching.
+   * Default: true
+   */
+  enabled?: boolean;
+  /**
+   * Callback when user wants to open a conversation.
+   */
+  onOpenConversation?: (conversationId: string) => void;
+  /**
+   * Callback when user wants to start a new conversation.
+   */
+  onStartConversation?: (initialMessage?: string) => void;
+};
+type UseConversationHistoryPageReturn = {
+  conversations: Conversation[];
+  isLoading: boolean;
+  error: Error | null;
+  visibleConversations: Conversation[];
+  visibleCount: number;
+  hasMore: boolean;
+  remainingCount: number;
+  showMore: () => void;
+  showAll: () => void;
+  openConversation: (conversationId: string) => void;
+  startConversation: (initialMessage?: string) => void;
+};
+/**
+ * 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>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function useConversationHistoryPage(options?: UseConversationHistoryPageOptions): UseConversationHistoryPageReturn;
+//#endregion
+export { UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, useConversationHistoryPage };
+//# sourceMappingURL=use-conversation-history-page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-conversation-history-page.d.ts","names":[],"sources":["../../src/hooks/use-conversation-history-page.ts"],"sourcesContent":[],"mappings":";;;KAIY,iCAAA;;AAAZ;AAwBA;;qBAEgB,CAAA,EAAA,MAAA;;;;AA+DhB;EAA0C,OAAA,CAAA,EAAA,OAAA;;;;;;;;;;KAjE9B,gCAAA;iBAEI;;SAER;wBAGe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0DP,0BAAA,WACN,oCACP"}