@cossistant/react 0.0.1

package/realtime/provider.js

@@ -0,0 +1,351 @@
+"use client";
+
+
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+import { isValidEventType, validateRealtimeEvent } from "@cossistant/types/realtime-events";
+import useWebSocket, { ReadyState } from "react-use-websocket";
+
+//#region src/realtime/provider.tsx
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 15e3;
+const DEFAULT_HEARTBEAT_TIMEOUT_MS = 45e3;
+const DEFAULT_WS_URL = "wss://api.cossistant.com/ws";
+const RealtimeContext = createContext(null);
+/**
+* Decodes WebSocket message data into a string.
+* Handles string, ArrayBuffer, and ArrayBufferView formats.
+*/
+function decodeMessageData(data) {
+	if (typeof data === "string") return {
+		type: "raw-text",
+		data
+	};
+	if (data instanceof ArrayBuffer) try {
+		return {
+			type: "raw-text",
+			data: new TextDecoder().decode(data)
+		};
+	} catch {
+		return { type: "unsupported" };
+	}
+	if (ArrayBuffer.isView(data)) try {
+		return {
+			type: "raw-text",
+			data: new TextDecoder().decode(data.buffer)
+		};
+	} catch {
+		return { type: "unsupported" };
+	}
+	return { type: "unsupported" };
+}
+/**
+* Safely parses JSON string, returning null if invalid.
+*/
+function parseJson(raw) {
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+}
+/**
+* Extracts a string field from an unknown object, with optional validation.
+*/
+function extractStringField(obj, field, required = false) {
+	if (!obj || typeof obj !== "object" || !(field in obj)) return required ? null : null;
+	const value = obj[field];
+	if (typeof value === "string" && value.length > 0) return value;
+	return required ? null : null;
+}
+/**
+* Parses a WebSocket message and determines its type and content.
+*/
+function parseWebSocketMessage(rawText) {
+	if (rawText === "pong") return { type: "pong" };
+	const parsed = parseJson(rawText);
+	if (!parsed || typeof parsed !== "object") return { type: "invalid" };
+	const messageType = extractStringField(parsed, "type");
+	if (messageType === "CONNECTION_ESTABLISHED") {
+		const payload = parsed.payload;
+		return {
+			type: "connection-established",
+			connectionId: extractStringField(payload, "connectionId")
+		};
+	}
+	if ("error" in parsed && "message" in parsed) return {
+		type: "error",
+		message: extractStringField(parsed, "message") || "Realtime connection error"
+	};
+	if (messageType && isValidEventType(messageType)) try {
+		const event = constructRealtimeEvent(parsed);
+		if (!event) return { type: "invalid" };
+		return {
+			type: "event",
+			event
+		};
+	} catch (error) {
+		console.error("[Realtime] Failed to construct event", error);
+		return { type: "invalid" };
+	}
+	return { type: "invalid" };
+}
+/**
+* Constructs a RealtimeEvent from parsed JSON data.
+* Returns null if required fields are missing or validation fails.
+*/
+function constructRealtimeEvent(parsed) {
+	if (!parsed || typeof parsed !== "object" || !("type" in parsed)) return null;
+	const type = parsed.type;
+	if (!isValidEventType(type)) return null;
+	const eventType = type;
+	const payloadSource = parsed.payload;
+	let payload;
+	try {
+		payload = validateRealtimeEvent(eventType, payloadSource);
+	} catch (error) {
+		console.error("[Realtime] Received invalid event payload", error);
+		return null;
+	}
+	const organizationId = extractStringField(payloadSource, "organizationId", true);
+	const websiteId = extractStringField(payloadSource, "websiteId", true);
+	if (!organizationId) {
+		console.error("[Realtime] Received event without organizationId", parsed);
+		return null;
+	}
+	if (!websiteId) {
+		console.error("[Realtime] Received event without websiteId", parsed);
+		return null;
+	}
+	const visitorId = extractStringField(parsed, "visitorId");
+	return {
+		type: eventType,
+		payload,
+		organizationId,
+		websiteId,
+		visitorId
+	};
+}
+/**
+* Checks if heartbeat has timed out.
+*/
+function isHeartbeatTimedOut(lastHeartbeat, timeoutMs) {
+	return Date.now() - lastHeartbeat > timeoutMs;
+}
+function resolvePublicKey(explicit) {
+	const trimmed = explicit?.trim();
+	if (trimmed) return trimmed;
+	const normalized = (process.env.NEXT_PUBLIC_COSSISTANT_KEY || process.env.COSSISTANT_PUBLIC_KEY || null)?.trim();
+	return normalized && normalized.length > 0 ? normalized : null;
+}
+function normalizeAuth(auth) {
+	if (!auth) return null;
+	if (auth.kind === "visitor") {
+		const visitorId = auth.visitorId?.trim() || null;
+		if (!visitorId) return null;
+		return {
+			type: "visitor",
+			visitorId,
+			websiteId: auth.websiteId?.trim() || null,
+			userId: null,
+			sessionToken: null,
+			publicKey: resolvePublicKey(auth.publicKey ?? null)
+		};
+	}
+	const sessionToken = auth.sessionToken?.trim() || null;
+	if (!sessionToken) return null;
+	return {
+		type: "session",
+		visitorId: null,
+		websiteId: auth.websiteId?.trim() || null,
+		userId: auth.userId?.trim() || null,
+		sessionToken,
+		publicKey: null
+	};
+}
+function buildSocketUrl(baseUrl, auth) {
+	if (!auth) return null;
+	try {
+		const url = new URL(baseUrl);
+		if (auth.type === "visitor") {
+			url.searchParams.set("visitorId", auth.visitorId ?? "");
+			const publicKey = auth.publicKey;
+			if (publicKey) url.searchParams.set("publicKey", publicKey);
+		} else {
+			url.searchParams.set("sessionToken", auth.sessionToken ?? "");
+			if (auth.websiteId) url.searchParams.set("websiteId", auth.websiteId);
+		}
+		return url.toString();
+	} catch (error) {
+		console.error("[Realtime] Failed to build WebSocket URL", error);
+		return null;
+	}
+}
+function RealtimeProvider({ children, wsUrl = DEFAULT_WS_URL, auth, autoConnect = true, onConnect, onDisconnect, onError }) {
+	const normalizedAuth = normalizeAuth(auth);
+	const socketUrl = buildSocketUrl(wsUrl, normalizedAuth);
+	const eventHandlersRef = useRef(/* @__PURE__ */ new Set());
+	const lastHeartbeatRef = useRef(Date.now());
+	const [connectionError, setConnectionError] = useState(null);
+	const [lastEvent, setLastEvent] = useState(null);
+	const [connectionId, setConnectionId] = useState(null);
+	const heartbeatIntervalMs = DEFAULT_HEARTBEAT_INTERVAL_MS;
+	const heartbeatTimeoutMs = DEFAULT_HEARTBEAT_TIMEOUT_MS;
+	const canConnect = Boolean(autoConnect && socketUrl);
+	const connectionUrl = canConnect ? socketUrl : null;
+	const { sendMessage, sendJsonMessage, lastMessage, readyState, getWebSocket } = useWebSocket(connectionUrl, {
+		shouldReconnect: (closeEvent) => {
+			if (!canConnect) return false;
+			if (closeEvent.code === 1008 || closeEvent.code === 1011) {
+				const err = new Error(closeEvent.reason || "Realtime connection closed by server. Please check your credentials.");
+				setConnectionError(err);
+				onError?.(err);
+				return false;
+			}
+			return true;
+		},
+		reconnectAttempts: autoConnect ? void 0 : 0,
+		reconnectInterval: (attempt) => {
+			const base = 500 * 2 ** attempt;
+			return Math.min(base, 3e4);
+		},
+		retryOnError: false,
+		onOpen: () => {
+			setConnectionError(null);
+			lastHeartbeatRef.current = Date.now();
+			onConnect?.();
+		},
+		onClose: () => {
+			setConnectionId(null);
+			onDisconnect?.();
+		},
+		onError: (event) => {
+			const err = /* @__PURE__ */ new Error(`WebSocket error: ${event.type}`);
+			setConnectionError(err);
+			onError?.(err);
+		}
+	}, canConnect);
+	useEffect(() => {
+		if (!lastMessage) return;
+		const decoded = decodeMessageData(lastMessage.data);
+		if (decoded.type === "unsupported") return;
+		const message = parseWebSocketMessage(decoded.data);
+		switch (message.type) {
+			case "pong":
+				lastHeartbeatRef.current = Date.now();
+				break;
+			case "connection-established":
+				setConnectionId(message.connectionId);
+				lastHeartbeatRef.current = Date.now();
+				break;
+			case "error": {
+				const err = new Error(message.message);
+				setConnectionError(err);
+				onError?.(err);
+				break;
+			}
+			case "event":
+				lastHeartbeatRef.current = Date.now();
+				setLastEvent(message.event);
+				for (const handler of eventHandlersRef.current) Promise.resolve(handler(message.event)).catch((error) => {
+					const err = error instanceof Error ? error : /* @__PURE__ */ new Error(`Subscriber threw an exception: ${String(error)}`);
+					onError?.(err);
+				});
+				break;
+			default: break;
+		}
+	}, [lastMessage, onError]);
+	useEffect(() => {
+		if (!canConnect) return;
+		const interval = window.setInterval(() => {
+			if (readyState !== ReadyState.OPEN) return;
+			if (isHeartbeatTimedOut(lastHeartbeatRef.current, heartbeatTimeoutMs)) {
+				getWebSocket()?.close(4e3, "Heartbeat timeout");
+				return;
+			}
+			try {
+				sendMessage("ping");
+			} catch {}
+		}, heartbeatIntervalMs);
+		return () => {
+			window.clearInterval(interval);
+		};
+	}, [
+		canConnect,
+		heartbeatIntervalMs,
+		heartbeatTimeoutMs,
+		readyState,
+		sendMessage,
+		getWebSocket
+	]);
+	const send = useCallback((event) => {
+		if (!connectionUrl) throw new Error("Realtime connection is disabled");
+		if (readyState !== ReadyState.OPEN) throw new Error("Realtime connection is not established");
+		sendJsonMessage(event);
+	}, [
+		connectionUrl,
+		readyState,
+		sendJsonMessage
+	]);
+	const sendRaw = useCallback((data) => {
+		if (!connectionUrl) throw new Error("Realtime connection is disabled");
+		if (readyState !== ReadyState.OPEN) throw new Error("Realtime connection is not established");
+		sendMessage(data);
+	}, [
+		connectionUrl,
+		readyState,
+		sendMessage
+	]);
+	const subscribe = useCallback((handler) => {
+		eventHandlersRef.current.add(handler);
+		return () => {
+			eventHandlersRef.current.delete(handler);
+		};
+	}, []);
+	const reconnect = useCallback(() => {
+		getWebSocket()?.close();
+	}, [getWebSocket]);
+	const connection = useMemo(() => ({
+		isConnected: readyState === ReadyState.OPEN,
+		isConnecting: readyState === ReadyState.CONNECTING,
+		error: connectionError,
+		send,
+		sendRaw,
+		subscribe,
+		lastEvent,
+		connectionId,
+		reconnect
+	}), [
+		readyState,
+		connectionError,
+		send,
+		sendRaw,
+		subscribe,
+		lastEvent,
+		connectionId,
+		reconnect
+	]);
+	const value = useMemo(() => ({
+		...connection,
+		visitorId: normalizedAuth?.visitorId ?? null,
+		websiteId: normalizedAuth?.websiteId ?? null,
+		userId: normalizedAuth?.userId ?? null
+	}), [
+		connection,
+		normalizedAuth?.visitorId,
+		normalizedAuth?.websiteId,
+		normalizedAuth?.userId
+	]);
+	return /* @__PURE__ */ jsx(RealtimeContext.Provider, {
+		value,
+		children
+	});
+}
+function useRealtimeConnection() {
+	const context = useContext(RealtimeContext);
+	if (!context) throw new Error("useRealtimeConnection must be used within RealtimeProvider");
+	return context;
+}
+
+//#endregion
+export { RealtimeProvider, useRealtimeConnection };
+//# sourceMappingURL=provider.js.map

package/realtime/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","names":["payload: unknown"],"sources":["../../src/realtime/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n\ttype AnyRealtimeEvent,\n\tisValidEventType,\n\ttype RealtimeEvent,\n\tvalidateRealtimeEvent,\n} from \"@cossistant/types/realtime-events\";\nimport type React from \"react\";\nimport {\n\tcreateContext,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseMemo,\n\tuseRef,\n\tuseState,\n} from \"react\";\nimport useWebSocket, { ReadyState } from \"react-use-websocket\";\n\nconst DEFAULT_HEARTBEAT_INTERVAL_MS = 15_000;\nconst DEFAULT_HEARTBEAT_TIMEOUT_MS = 45_000;\n\ntype SubscribeHandler = (event: AnyRealtimeEvent) => void;\n\ntype MessageDecodeResult =\n\t| {\n\t\t\ttype: \"raw-text\";\n\t\t\tdata: string;\n\t  }\n\t| {\n\t\t\ttype: \"unsupported\";\n\t  };\n\ntype ParsedMessage =\n\t| {\n\t\t\ttype: \"pong\";\n\t  }\n\t| {\n\t\t\ttype: \"connection-established\";\n\t\t\tconnectionId: string | null;\n\t  }\n\t| {\n\t\t\ttype: \"error\";\n\t\t\tmessage: string;\n\t  }\n\t| {\n\t\t\ttype: \"event\";\n\t\t\tevent: AnyRealtimeEvent;\n\t  }\n\t| {\n\t\t\ttype: \"invalid\";\n\t  };\n\ntype VisitorAuthConfig = {\n\tkind: \"visitor\";\n\tvisitorId: string | null;\n\twebsiteId?: string | null;\n\tpublicKey?: string | null;\n};\n\ntype SessionAuthConfig = {\n\tkind: \"session\";\n\tsessionToken: string | null;\n\twebsiteId?: string | null;\n\tuserId?: string | null;\n};\n\ntype RealtimeAuthConfig = VisitorAuthConfig | SessionAuthConfig;\n\ntype ResolvedAuthConfig = {\n\ttype: \"visitor\" | \"session\";\n\tvisitorId: string | null;\n\twebsiteId: string | null;\n\tuserId: string | null;\n\tsessionToken: string | null;\n\tpublicKey: string | null;\n};\n\ntype RealtimeProviderProps = {\n\tchildren: React.ReactNode;\n\twsUrl?: string;\n\tauth: RealtimeAuthConfig | null;\n\tautoConnect?: boolean;\n\tonConnect?: () => void;\n\tonDisconnect?: () => void;\n\tonError?: (error: Error) => void;\n};\n\ntype RealtimeConnectionState = {\n\tisConnected: boolean;\n\tisConnecting: boolean;\n\terror: Error | null;\n\tsend: (event: AnyRealtimeEvent) => void;\n\tsendRaw: (data: string) => void;\n\tsubscribe: (handler: SubscribeHandler) => () => void;\n\tlastEvent: AnyRealtimeEvent | null;\n\tconnectionId: string | null;\n\treconnect: () => void;\n};\n\ntype RealtimeContextValue = RealtimeConnectionState & {\n\tvisitorId: string | null;\n\twebsiteId: string | null;\n\tuserId: string | null;\n};\n\nconst DEFAULT_WS_URL = \"wss://api.cossistant.com/ws\";\n\nconst RealtimeContext = createContext<RealtimeContextValue | null>(null);\n\n/**\n * Decodes WebSocket message data into a string.\n * Handles string, ArrayBuffer, and ArrayBufferView formats.\n */\nfunction decodeMessageData(data: unknown): MessageDecodeResult {\n\tif (typeof data === \"string\") {\n\t\treturn { type: \"raw-text\", data };\n\t}\n\n\tif (data instanceof ArrayBuffer) {\n\t\ttry {\n\t\t\treturn { type: \"raw-text\", data: new TextDecoder().decode(data) };\n\t\t} catch {\n\t\t\treturn { type: \"unsupported\" };\n\t\t}\n\t}\n\n\tif (ArrayBuffer.isView(data)) {\n\t\ttry {\n\t\t\treturn { type: \"raw-text\", data: new TextDecoder().decode(data.buffer) };\n\t\t} catch {\n\t\t\treturn { type: \"unsupported\" };\n\t\t}\n\t}\n\n\treturn { type: \"unsupported\" };\n}\n\n/**\n * Safely parses JSON string, returning null if invalid.\n */\nfunction parseJson(raw: string): unknown {\n\ttry {\n\t\treturn JSON.parse(raw);\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Extracts a string field from an unknown object, with optional validation.\n */\nfunction extractStringField(\n\tobj: unknown,\n\tfield: string,\n\trequired = false\n): string | null {\n\tif (!obj || typeof obj !== \"object\" || !(field in obj)) {\n\t\treturn required ? null : null;\n\t}\n\tconst value = (obj as Record<string, unknown>)[field];\n\tif (typeof value === \"string\" && value.length > 0) {\n\t\treturn value;\n\t}\n\treturn required ? null : null;\n}\n\n/**\n * Parses a WebSocket message and determines its type and content.\n */\nfunction parseWebSocketMessage(rawText: string): ParsedMessage {\n\t// Handle pong heartbeat\n\tif (rawText === \"pong\") {\n\t\treturn { type: \"pong\" };\n\t}\n\n\t// Try to parse as JSON\n\tconst parsed = parseJson(rawText);\n\tif (!parsed || typeof parsed !== \"object\") {\n\t\treturn { type: \"invalid\" };\n\t}\n\n\tconst messageType = extractStringField(parsed, \"type\");\n\n\t// Handle CONNECTION_ESTABLISHED\n\tif (messageType === \"CONNECTION_ESTABLISHED\") {\n\t\tconst payload = (parsed as { payload?: unknown }).payload;\n\t\tconst connectionId = extractStringField(payload, \"connectionId\");\n\t\treturn { type: \"connection-established\", connectionId };\n\t}\n\n\t// Handle error messages\n\tif (\"error\" in parsed && \"message\" in parsed) {\n\t\tconst message =\n\t\t\textractStringField(parsed, \"message\") || \"Realtime connection error\";\n\t\treturn { type: \"error\", message };\n\t}\n\n\t// Handle realtime events\n\tif (messageType && isValidEventType(messageType)) {\n\t\ttry {\n\t\t\tconst event = constructRealtimeEvent(parsed);\n\t\t\tif (!event) {\n\t\t\t\treturn { type: \"invalid\" };\n\t\t\t}\n\t\t\treturn { type: \"event\", event };\n\t\t} catch (error) {\n\t\t\tconsole.error(\"[Realtime] Failed to construct event\", error);\n\t\t\treturn { type: \"invalid\" };\n\t\t}\n\t}\n\n\treturn { type: \"invalid\" };\n}\n\n/**\n * Constructs a RealtimeEvent from parsed JSON data.\n * Returns null if required fields are missing or validation fails.\n */\nfunction constructRealtimeEvent(parsed: unknown): AnyRealtimeEvent | null {\n\tif (!parsed || typeof parsed !== \"object\" || !(\"type\" in parsed)) {\n\t\treturn null;\n\t}\n\n\tconst type = (parsed as { type: unknown }).type;\n\tif (!isValidEventType(type)) {\n\t\treturn null;\n\t}\n\n\tconst eventType = type;\n\n\t// Extract payload directly\n\tconst payloadSource = (parsed as { payload?: unknown }).payload;\n\n\tlet payload: unknown;\n\ttry {\n\t\tpayload = validateRealtimeEvent(eventType, payloadSource);\n\t} catch (error) {\n\t\tconsole.error(\"[Realtime] Received invalid event payload\", error);\n\t\treturn null;\n\t}\n\n\tconst organizationId = extractStringField(\n\t\tpayloadSource,\n\t\t\"organizationId\",\n\t\ttrue\n\t);\n\tconst websiteId = extractStringField(payloadSource, \"websiteId\", true);\n\n\tif (!organizationId) {\n\t\tconsole.error(\"[Realtime] Received event without organizationId\", parsed);\n\t\treturn null;\n\t}\n\n\tif (!websiteId) {\n\t\tconsole.error(\"[Realtime] Received event without websiteId\", parsed);\n\t\treturn null;\n\t}\n\n\tconst visitorId = extractStringField(parsed, \"visitorId\");\n\n\treturn {\n\t\ttype: eventType,\n\t\tpayload,\n\t\torganizationId,\n\t\twebsiteId,\n\t\tvisitorId,\n\t} as AnyRealtimeEvent;\n}\n\n/**\n * Checks if heartbeat has timed out.\n */\nfunction isHeartbeatTimedOut(\n\tlastHeartbeat: number,\n\ttimeoutMs: number\n): boolean {\n\tconst elapsed = Date.now() - lastHeartbeat;\n\treturn elapsed > timeoutMs;\n}\n\nfunction resolvePublicKey(explicit?: string | null): string | null {\n\tconst trimmed = explicit?.trim();\n\tif (trimmed) {\n\t\treturn trimmed;\n\t}\n\n\tconst fromEnv =\n\t\tprocess.env.NEXT_PUBLIC_COSSISTANT_KEY ||\n\t\tprocess.env.COSSISTANT_PUBLIC_KEY ||\n\t\tnull;\n\n\tconst normalized = fromEnv?.trim();\n\treturn normalized && normalized.length > 0 ? normalized : null;\n}\n\nfunction normalizeAuth(\n\tauth: RealtimeAuthConfig | null\n): ResolvedAuthConfig | null {\n\tif (!auth) {\n\t\treturn null;\n\t}\n\n\tif (auth.kind === \"visitor\") {\n\t\tconst visitorId = auth.visitorId?.trim() || null;\n\n\t\tif (!visitorId) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn {\n\t\t\ttype: \"visitor\",\n\t\t\tvisitorId,\n\t\t\twebsiteId: auth.websiteId?.trim() || null,\n\t\t\tuserId: null,\n\t\t\tsessionToken: null,\n\t\t\tpublicKey: resolvePublicKey(auth.publicKey ?? null),\n\t\t} satisfies ResolvedAuthConfig;\n\t}\n\n\tconst sessionToken = auth.sessionToken?.trim() || null;\n\n\tif (!sessionToken) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\ttype: \"session\",\n\t\tvisitorId: null,\n\t\twebsiteId: auth.websiteId?.trim() || null,\n\t\tuserId: auth.userId?.trim() || null,\n\t\tsessionToken,\n\t\tpublicKey: null,\n\t} satisfies ResolvedAuthConfig;\n}\n\nfunction buildSocketUrl(\n\tbaseUrl: string,\n\tauth: ResolvedAuthConfig | null\n): string | null {\n\tif (!auth) {\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tconst url = new URL(baseUrl);\n\n\t\tif (auth.type === \"visitor\") {\n\t\t\turl.searchParams.set(\"visitorId\", auth.visitorId ?? \"\");\n\t\t\tconst publicKey = auth.publicKey;\n\t\t\tif (publicKey) {\n\t\t\t\turl.searchParams.set(\"publicKey\", publicKey);\n\t\t\t}\n\t\t} else {\n\t\t\turl.searchParams.set(\"sessionToken\", auth.sessionToken ?? \"\");\n\t\t\tif (auth.websiteId) {\n\t\t\t\turl.searchParams.set(\"websiteId\", auth.websiteId);\n\t\t\t}\n\t\t}\n\n\t\treturn url.toString();\n\t} catch (error) {\n\t\tconsole.error(\"[Realtime] Failed to build WebSocket URL\", error);\n\t\treturn null;\n\t}\n}\n\nexport function RealtimeProvider({\n\tchildren,\n\twsUrl = DEFAULT_WS_URL,\n\tauth,\n\tautoConnect = true,\n\tonConnect,\n\tonDisconnect,\n\tonError,\n}: RealtimeProviderProps) {\n\tconst normalizedAuth = normalizeAuth(auth);\n\n\tconst socketUrl = buildSocketUrl(wsUrl, normalizedAuth);\n\tconst eventHandlersRef = useRef<Set<SubscribeHandler>>(new Set());\n\tconst lastHeartbeatRef = useRef<number>(Date.now());\n\tconst [connectionError, setConnectionError] = useState<Error | null>(null);\n\tconst [lastEvent, setLastEvent] = useState<AnyRealtimeEvent | null>(null);\n\tconst [connectionId, setConnectionId] = useState<string | null>(null);\n\n\tconst heartbeatIntervalMs = DEFAULT_HEARTBEAT_INTERVAL_MS;\n\tconst heartbeatTimeoutMs = DEFAULT_HEARTBEAT_TIMEOUT_MS;\n\n\tconst canConnect = Boolean(autoConnect && socketUrl);\n\tconst connectionUrl = canConnect ? socketUrl : null;\n\n\tconst {\n\t\tsendMessage,\n\t\tsendJsonMessage,\n\t\tlastMessage,\n\t\treadyState,\n\t\tgetWebSocket,\n\t} = useWebSocket(\n\t\tconnectionUrl,\n\t\t{\n\t\t\tshouldReconnect: (closeEvent) => {\n\t\t\t\tif (!canConnect) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\n\t\t\t\tif (closeEvent.code === 1008 || closeEvent.code === 1011) {\n\t\t\t\t\tconst err = new Error(\n\t\t\t\t\t\tcloseEvent.reason ||\n\t\t\t\t\t\t\t\"Realtime connection closed by server. Please check your credentials.\"\n\t\t\t\t\t);\n\t\t\t\t\tsetConnectionError(err);\n\t\t\t\t\tonError?.(err);\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\n\t\t\t\treturn true;\n\t\t\t},\n\t\t\treconnectAttempts: autoConnect ? undefined : 0,\n\t\t\treconnectInterval: (attempt) => {\n\t\t\t\tconst base = 500 * 2 ** attempt;\n\t\t\t\treturn Math.min(base, 30_000);\n\t\t\t},\n\t\t\tretryOnError: false,\n\t\t\tonOpen: () => {\n\t\t\t\tsetConnectionError(null);\n\t\t\t\tlastHeartbeatRef.current = Date.now();\n\t\t\t\tonConnect?.();\n\t\t\t},\n\t\t\tonClose: () => {\n\t\t\t\tsetConnectionId(null);\n\t\t\t\tonDisconnect?.();\n\t\t\t},\n\t\t\tonError: (event) => {\n\t\t\t\tconst err = new Error(`WebSocket error: ${event.type}`);\n\t\t\t\tsetConnectionError(err);\n\t\t\t\tonError?.(err);\n\t\t\t},\n\t\t},\n\t\tcanConnect\n\t);\n\n\tuseEffect(() => {\n\t\tif (!lastMessage) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Decode message data from various formats\n\t\tconst decoded = decodeMessageData(lastMessage.data);\n\t\tif (decoded.type === \"unsupported\") {\n\t\t\treturn;\n\t\t}\n\n\t\t// Parse the message and determine its type\n\t\tconst message = parseWebSocketMessage(decoded.data);\n\n\t\t// Handle different message types\n\t\tswitch (message.type) {\n\t\t\tcase \"pong\":\n\t\t\t\tlastHeartbeatRef.current = Date.now();\n\t\t\t\tbreak;\n\n\t\t\tcase \"connection-established\":\n\t\t\t\tsetConnectionId(message.connectionId);\n\t\t\t\tlastHeartbeatRef.current = Date.now();\n\t\t\t\tbreak;\n\n\t\t\tcase \"error\": {\n\t\t\t\tconst err = new Error(message.message);\n\t\t\t\tsetConnectionError(err);\n\t\t\t\tonError?.(err);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"event\":\n\t\t\t\tlastHeartbeatRef.current = Date.now();\n\t\t\t\tsetLastEvent(message.event);\n\t\t\t\tfor (const handler of eventHandlersRef.current) {\n\t\t\t\t\tPromise.resolve(handler(message.event)).catch((error) => {\n\t\t\t\t\t\tconst err =\n\t\t\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t\t\t? error\n\t\t\t\t\t\t\t\t: new Error(`Subscriber threw an exception: ${String(error)}`);\n\t\t\t\t\t\tonError?.(err);\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tdefault:\n\t\t\t\t// Silently ignore invalid or unknown messages\n\t\t\t\tbreak;\n\t\t}\n\t}, [lastMessage, onError]);\n\n\tuseEffect(() => {\n\t\tif (!canConnect) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst interval = window.setInterval(() => {\n\t\t\tif (readyState !== ReadyState.OPEN) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Check if heartbeat has timed out\n\t\t\tif (isHeartbeatTimedOut(lastHeartbeatRef.current, heartbeatTimeoutMs)) {\n\t\t\t\tconst socket = getWebSocket();\n\t\t\t\tsocket?.close(4000, \"Heartbeat timeout\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Send ping to keep connection alive\n\t\t\ttry {\n\t\t\t\tsendMessage(\"ping\");\n\t\t\t} catch {\n\t\t\t\t// Ignore send failures; reconnect logic will handle it\n\t\t\t}\n\t\t}, heartbeatIntervalMs);\n\n\t\treturn () => {\n\t\t\twindow.clearInterval(interval);\n\t\t};\n\t}, [\n\t\tcanConnect,\n\t\theartbeatIntervalMs,\n\t\theartbeatTimeoutMs,\n\t\treadyState,\n\t\tsendMessage,\n\t\tgetWebSocket,\n\t]);\n\n\tconst send = useCallback(\n\t\t(event: AnyRealtimeEvent) => {\n\t\t\tif (!connectionUrl) {\n\t\t\t\tthrow new Error(\"Realtime connection is disabled\");\n\t\t\t}\n\n\t\t\tif (readyState !== ReadyState.OPEN) {\n\t\t\t\tthrow new Error(\"Realtime connection is not established\");\n\t\t\t}\n\n\t\t\tsendJsonMessage(event);\n\t\t},\n\t\t[connectionUrl, readyState, sendJsonMessage]\n\t);\n\n\tconst sendRaw = useCallback(\n\t\t(data: string) => {\n\t\t\tif (!connectionUrl) {\n\t\t\t\tthrow new Error(\"Realtime connection is disabled\");\n\t\t\t}\n\n\t\t\tif (readyState !== ReadyState.OPEN) {\n\t\t\t\tthrow new Error(\"Realtime connection is not established\");\n\t\t\t}\n\n\t\t\tsendMessage(data);\n\t\t},\n\t\t[connectionUrl, readyState, sendMessage]\n\t);\n\n\tconst subscribe = useCallback((handler: SubscribeHandler) => {\n\t\teventHandlersRef.current.add(handler);\n\t\treturn () => {\n\t\t\teventHandlersRef.current.delete(handler);\n\t\t};\n\t}, []);\n\n\tconst reconnect = useCallback(() => {\n\t\tconst socket = getWebSocket();\n\t\tsocket?.close();\n\t}, [getWebSocket]);\n\n\tconst connection = useMemo<RealtimeConnectionState>(\n\t\t() => ({\n\t\t\tisConnected: readyState === ReadyState.OPEN,\n\t\t\tisConnecting: readyState === ReadyState.CONNECTING,\n\t\t\terror: connectionError,\n\t\t\tsend,\n\t\t\tsendRaw,\n\t\t\tsubscribe,\n\t\t\tlastEvent,\n\t\t\tconnectionId,\n\t\t\treconnect,\n\t\t}),\n\t\t[\n\t\t\treadyState,\n\t\t\tconnectionError,\n\t\t\tsend,\n\t\t\tsendRaw,\n\t\t\tsubscribe,\n\t\t\tlastEvent,\n\t\t\tconnectionId,\n\t\t\treconnect,\n\t\t]\n\t);\n\n\tconst value = useMemo<RealtimeContextValue>(\n\t\t() => ({\n\t\t\t...connection,\n\t\t\tvisitorId: normalizedAuth?.visitorId ?? null,\n\t\t\twebsiteId: normalizedAuth?.websiteId ?? null,\n\t\t\tuserId: normalizedAuth?.userId ?? null,\n\t\t}),\n\t\t[\n\t\t\tconnection,\n\t\t\tnormalizedAuth?.visitorId,\n\t\t\tnormalizedAuth?.websiteId,\n\t\t\tnormalizedAuth?.userId,\n\t\t]\n\t);\n\n\treturn (\n\t\t<RealtimeContext.Provider value={value}>\n\t\t\t{children}\n\t\t</RealtimeContext.Provider>\n\t);\n}\n\nexport function useRealtimeConnection(): RealtimeContextValue {\n\tconst context = useContext(RealtimeContext);\n\tif (!context) {\n\t\tthrow new Error(\n\t\t\t\"useRealtimeConnection must be used within RealtimeProvider\"\n\t\t);\n\t}\n\n\treturn context;\n}\n\nexport type { RealtimeContextValue };\nexport type { RealtimeAuthConfig };\nexport type { RealtimeProviderProps };\nexport type { RealtimeEvent } from \"@cossistant/types/realtime-events\";\n"],"mappings":";;;;;;;;;AAoBA,MAAM,gCAAgC;AACtC,MAAM,+BAA+B;AAsFrC,MAAM,iBAAiB;AAEvB,MAAM,kBAAkB,cAA2C,KAAK;;;;;AAMxE,SAAS,kBAAkB,MAAoC;AAC9D,KAAI,OAAO,SAAS,SACnB,QAAO;EAAE,MAAM;EAAY;EAAM;AAGlC,KAAI,gBAAgB,YACnB,KAAI;AACH,SAAO;GAAE,MAAM;GAAY,MAAM,IAAI,aAAa,CAAC,OAAO,KAAK;GAAE;SAC1D;AACP,SAAO,EAAE,MAAM,eAAe;;AAIhC,KAAI,YAAY,OAAO,KAAK,CAC3B,KAAI;AACH,SAAO;GAAE,MAAM;GAAY,MAAM,IAAI,aAAa,CAAC,OAAO,KAAK,OAAO;GAAE;SACjE;AACP,SAAO,EAAE,MAAM,eAAe;;AAIhC,QAAO,EAAE,MAAM,eAAe;;;;;AAM/B,SAAS,UAAU,KAAsB;AACxC,KAAI;AACH,SAAO,KAAK,MAAM,IAAI;SACf;AACP,SAAO;;;;;;AAOT,SAAS,mBACR,KACA,OACA,WAAW,OACK;AAChB,KAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,EAAE,SAAS,KACjD,QAAO,WAAW,OAAO;CAE1B,MAAM,QAAS,IAAgC;AAC/C,KAAI,OAAO,UAAU,YAAY,MAAM,SAAS,EAC/C,QAAO;AAER,QAAO,WAAW,OAAO;;;;;AAM1B,SAAS,sBAAsB,SAAgC;AAE9D,KAAI,YAAY,OACf,QAAO,EAAE,MAAM,QAAQ;CAIxB,MAAM,SAAS,UAAU,QAAQ;AACjC,KAAI,CAAC,UAAU,OAAO,WAAW,SAChC,QAAO,EAAE,MAAM,WAAW;CAG3B,MAAM,cAAc,mBAAmB,QAAQ,OAAO;AAGtD,KAAI,gBAAgB,0BAA0B;EAC7C,MAAM,UAAW,OAAiC;AAElD,SAAO;GAAE,MAAM;GAA0B,cADpB,mBAAmB,SAAS,eAAe;GACT;;AAIxD,KAAI,WAAW,UAAU,aAAa,OAGrC,QAAO;EAAE,MAAM;EAAS,SADvB,mBAAmB,QAAQ,UAAU,IAAI;EACT;AAIlC,KAAI,eAAe,iBAAiB,YAAY,CAC/C,KAAI;EACH,MAAM,QAAQ,uBAAuB,OAAO;AAC5C,MAAI,CAAC,MACJ,QAAO,EAAE,MAAM,WAAW;AAE3B,SAAO;GAAE,MAAM;GAAS;GAAO;UACvB,OAAO;AACf,UAAQ,MAAM,wCAAwC,MAAM;AAC5D,SAAO,EAAE,MAAM,WAAW;;AAI5B,QAAO,EAAE,MAAM,WAAW;;;;;;AAO3B,SAAS,uBAAuB,QAA0C;AACzE,KAAI,CAAC,UAAU,OAAO,WAAW,YAAY,EAAE,UAAU,QACxD,QAAO;CAGR,MAAM,OAAQ,OAA6B;AAC3C,KAAI,CAAC,iBAAiB,KAAK,CAC1B,QAAO;CAGR,MAAM,YAAY;CAGlB,MAAM,gBAAiB,OAAiC;CAExD,IAAIA;AACJ,KAAI;AACH,YAAU,sBAAsB,WAAW,cAAc;UACjD,OAAO;AACf,UAAQ,MAAM,6CAA6C,MAAM;AACjE,SAAO;;CAGR,MAAM,iBAAiB,mBACtB,eACA,kBACA,KACA;CACD,MAAM,YAAY,mBAAmB,eAAe,aAAa,KAAK;AAEtE,KAAI,CAAC,gBAAgB;AACpB,UAAQ,MAAM,oDAAoD,OAAO;AACzE,SAAO;;AAGR,KAAI,CAAC,WAAW;AACf,UAAQ,MAAM,+CAA+C,OAAO;AACpE,SAAO;;CAGR,MAAM,YAAY,mBAAmB,QAAQ,YAAY;AAEzD,QAAO;EACN,MAAM;EACN;EACA;EACA;EACA;EACA;;;;;AAMF,SAAS,oBACR,eACA,WACU;AAEV,QADgB,KAAK,KAAK,GAAG,gBACZ;;AAGlB,SAAS,iBAAiB,UAAyC;CAClE,MAAM,UAAU,UAAU,MAAM;AAChC,KAAI,QACH,QAAO;CAQR,MAAM,cAJL,QAAQ,IAAI,8BACZ,QAAQ,IAAI,yBACZ,OAE2B,MAAM;AAClC,QAAO,cAAc,WAAW,SAAS,IAAI,aAAa;;AAG3D,SAAS,cACR,MAC4B;AAC5B,KAAI,CAAC,KACJ,QAAO;AAGR,KAAI,KAAK,SAAS,WAAW;EAC5B,MAAM,YAAY,KAAK,WAAW,MAAM,IAAI;AAE5C,MAAI,CAAC,UACJ,QAAO;AAGR,SAAO;GACN,MAAM;GACN;GACA,WAAW,KAAK,WAAW,MAAM,IAAI;GACrC,QAAQ;GACR,cAAc;GACd,WAAW,iBAAiB,KAAK,aAAa,KAAK;GACnD;;CAGF,MAAM,eAAe,KAAK,cAAc,MAAM,IAAI;AAElD,KAAI,CAAC,aACJ,QAAO;AAGR,QAAO;EACN,MAAM;EACN,WAAW;EACX,WAAW,KAAK,WAAW,MAAM,IAAI;EACrC,QAAQ,KAAK,QAAQ,MAAM,IAAI;EAC/B;EACA,WAAW;EACX;;AAGF,SAAS,eACR,SACA,MACgB;AAChB,KAAI,CAAC,KACJ,QAAO;AAGR,KAAI;EACH,MAAM,MAAM,IAAI,IAAI,QAAQ;AAE5B,MAAI,KAAK,SAAS,WAAW;AAC5B,OAAI,aAAa,IAAI,aAAa,KAAK,aAAa,GAAG;GACvD,MAAM,YAAY,KAAK;AACvB,OAAI,UACH,KAAI,aAAa,IAAI,aAAa,UAAU;SAEvC;AACN,OAAI,aAAa,IAAI,gBAAgB,KAAK,gBAAgB,GAAG;AAC7D,OAAI,KAAK,UACR,KAAI,aAAa,IAAI,aAAa,KAAK,UAAU;;AAInD,SAAO,IAAI,UAAU;UACb,OAAO;AACf,UAAQ,MAAM,4CAA4C,MAAM;AAChE,SAAO;;;AAIT,SAAgB,iBAAiB,EAChC,UACA,QAAQ,gBACR,MACA,cAAc,MACd,WACA,cACA,WACyB;CACzB,MAAM,iBAAiB,cAAc,KAAK;CAE1C,MAAM,YAAY,eAAe,OAAO,eAAe;CACvD,MAAM,mBAAmB,uBAA8B,IAAI,KAAK,CAAC;CACjE,MAAM,mBAAmB,OAAe,KAAK,KAAK,CAAC;CACnD,MAAM,CAAC,iBAAiB,sBAAsB,SAAuB,KAAK;CAC1E,MAAM,CAAC,WAAW,gBAAgB,SAAkC,KAAK;CACzE,MAAM,CAAC,cAAc,mBAAmB,SAAwB,KAAK;CAErE,MAAM,sBAAsB;CAC5B,MAAM,qBAAqB;CAE3B,MAAM,aAAa,QAAQ,eAAe,UAAU;CACpD,MAAM,gBAAgB,aAAa,YAAY;CAE/C,MAAM,EACL,aACA,iBACA,aACA,YACA,iBACG,aACH,eACA;EACC,kBAAkB,eAAe;AAChC,OAAI,CAAC,WACJ,QAAO;AAGR,OAAI,WAAW,SAAS,QAAQ,WAAW,SAAS,MAAM;IACzD,MAAM,MAAM,IAAI,MACf,WAAW,UACV,uEACD;AACD,uBAAmB,IAAI;AACvB,cAAU,IAAI;AACd,WAAO;;AAGR,UAAO;;EAER,mBAAmB,cAAc,SAAY;EAC7C,oBAAoB,YAAY;GAC/B,MAAM,OAAO,MAAM,KAAK;AACxB,UAAO,KAAK,IAAI,MAAM,IAAO;;EAE9B,cAAc;EACd,cAAc;AACb,sBAAmB,KAAK;AACxB,oBAAiB,UAAU,KAAK,KAAK;AACrC,gBAAa;;EAEd,eAAe;AACd,mBAAgB,KAAK;AACrB,mBAAgB;;EAEjB,UAAU,UAAU;GACnB,MAAM,sBAAM,IAAI,MAAM,oBAAoB,MAAM,OAAO;AACvD,sBAAmB,IAAI;AACvB,aAAU,IAAI;;EAEf,EACD,WACA;AAED,iBAAgB;AACf,MAAI,CAAC,YACJ;EAID,MAAM,UAAU,kBAAkB,YAAY,KAAK;AACnD,MAAI,QAAQ,SAAS,cACpB;EAID,MAAM,UAAU,sBAAsB,QAAQ,KAAK;AAGnD,UAAQ,QAAQ,MAAhB;GACC,KAAK;AACJ,qBAAiB,UAAU,KAAK,KAAK;AACrC;GAED,KAAK;AACJ,oBAAgB,QAAQ,aAAa;AACrC,qBAAiB,UAAU,KAAK,KAAK;AACrC;GAED,KAAK,SAAS;IACb,MAAM,MAAM,IAAI,MAAM,QAAQ,QAAQ;AACtC,uBAAmB,IAAI;AACvB,cAAU,IAAI;AACd;;GAGD,KAAK;AACJ,qBAAiB,UAAU,KAAK,KAAK;AACrC,iBAAa,QAAQ,MAAM;AAC3B,SAAK,MAAM,WAAW,iBAAiB,QACtC,SAAQ,QAAQ,QAAQ,QAAQ,MAAM,CAAC,CAAC,OAAO,UAAU;KACxD,MAAM,MACL,iBAAiB,QACd,wBACA,IAAI,MAAM,kCAAkC,OAAO,MAAM,GAAG;AAChE,eAAU,IAAI;MACb;AAEH;GAED,QAEC;;IAEA,CAAC,aAAa,QAAQ,CAAC;AAE1B,iBAAgB;AACf,MAAI,CAAC,WACJ;EAGD,MAAM,WAAW,OAAO,kBAAkB;AACzC,OAAI,eAAe,WAAW,KAC7B;AAID,OAAI,oBAAoB,iBAAiB,SAAS,mBAAmB,EAAE;AAEtE,IADe,cAAc,EACrB,MAAM,KAAM,oBAAoB;AACxC;;AAID,OAAI;AACH,gBAAY,OAAO;WACZ;KAGN,oBAAoB;AAEvB,eAAa;AACZ,UAAO,cAAc,SAAS;;IAE7B;EACF;EACA;EACA;EACA;EACA;EACA;EACA,CAAC;CAEF,MAAM,OAAO,aACX,UAA4B;AAC5B,MAAI,CAAC,cACJ,OAAM,IAAI,MAAM,kCAAkC;AAGnD,MAAI,eAAe,WAAW,KAC7B,OAAM,IAAI,MAAM,yCAAyC;AAG1D,kBAAgB,MAAM;IAEvB;EAAC;EAAe;EAAY;EAAgB,CAC5C;CAED,MAAM,UAAU,aACd,SAAiB;AACjB,MAAI,CAAC,cACJ,OAAM,IAAI,MAAM,kCAAkC;AAGnD,MAAI,eAAe,WAAW,KAC7B,OAAM,IAAI,MAAM,yCAAyC;AAG1D,cAAY,KAAK;IAElB;EAAC;EAAe;EAAY;EAAY,CACxC;CAED,MAAM,YAAY,aAAa,YAA8B;AAC5D,mBAAiB,QAAQ,IAAI,QAAQ;AACrC,eAAa;AACZ,oBAAiB,QAAQ,OAAO,QAAQ;;IAEvC,EAAE,CAAC;CAEN,MAAM,YAAY,kBAAkB;AAEnC,EADe,cAAc,EACrB,OAAO;IACb,CAAC,aAAa,CAAC;CAElB,MAAM,aAAa,eACX;EACN,aAAa,eAAe,WAAW;EACvC,cAAc,eAAe,WAAW;EACxC,OAAO;EACP;EACA;EACA;EACA;EACA;EACA;EACA,GACD;EACC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,CACD;CAED,MAAM,QAAQ,eACN;EACN,GAAG;EACH,WAAW,gBAAgB,aAAa;EACxC,WAAW,gBAAgB,aAAa;EACxC,QAAQ,gBAAgB,UAAU;EAClC,GACD;EACC;EACA,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,CACD;AAED,QACC,oBAAC,gBAAgB;EAAgB;EAC/B;GACyB;;AAI7B,SAAgB,wBAA8C;CAC7D,MAAM,UAAU,WAAW,gBAAgB;AAC3C,KAAI,CAAC,QACJ,OAAM,IAAI,MACT,6DACA;AAGF,QAAO"}

package/realtime/seen-store.d.ts

@@ -0,0 +1,23 @@
+import { ConversationSeen } from "../schemas.js";
+import { RealtimeEvent } from "../realtime-events.js";
+import { SeenActorType, SeenState } from "@cossistant/core";
+
+//#region src/realtime/seen-store.d.ts
+type Selector<T> = (state: SeenState) => T;
+type EqualityChecker<T> = (previous: T, next: T) => boolean;
+declare function useSeenStore<TSelected>(selector: Selector<TSelected>, isEqual?: EqualityChecker<TSelected>): TSelected;
+declare function hydrateConversationSeen(conversationId: string, entries: ConversationSeen[]): void;
+declare function upsertConversationSeen(options: {
+  conversationId: string;
+  actorType: SeenActorType;
+  actorId: string;
+  lastSeenAt: Date;
+}): void;
+declare function applyConversationSeenEvent(event: RealtimeEvent<"conversationSeen">, options?: {
+  ignoreVisitorId?: string | null;
+  ignoreUserId?: string | null;
+  ignoreAiAgentId?: string | null;
+}): void;
+//#endregion
+export { applyConversationSeenEvent, hydrateConversationSeen, upsertConversationSeen, useSeenStore };
+//# sourceMappingURL=seen-store.d.ts.map

package/realtime/seen-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seen-store.d.ts","names":[],"sources":["../../src/realtime/seen-store.ts"],"sourcesContent":[],"mappings":";;;;;KAeK,sBAAsB,cAAc;KAEpC,gCAAgC,SAAS;AAFzC,iBAiCW,YAjCH,CAAA,SAAA,CAAA,CAAA,QAAA,EAkCF,QAlCE,CAkCO,SAlCP,CAAA,EAAA,OAAA,CAAA,EAmCF,eAnCE,CAmCc,SAnCd,CAAA,CAAA,EAoCV,SApCU;AAAA,iBAwCG,uBAAA,CAxCH,cAAA,EAAA,MAAA,EAAA,OAAA,EA0CH,gBA1CG,EAAA,CAAA,EAAA,IAAA;AAAc,iBA+CX,sBAAA,CA/CW,OAAA,EAAA;gBAAc,EAAA,MAAA;EAAC,SAAA,EAiD9B,aAjD8B;EAErC,OAAA,EAAA,MAAA;EAAe,UAAA,EAiDP,IAjDO;QAAiB;AAAS,iBAyD9B,0BAAA,CAzD8B,KAAA,EA0DtC,aA1DsC,CAAA,kBAAA,CAAA,EAAA,QAAA,EAAA;EAAC,eAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EA+B/B,YAAA,CAAA,EAAY,MAAA,GAAA,IAAA;EAAA,eAAA,CAAA,EAAA,MAAA,GAAA,IAAA;QACR"}

package/realtime/seen-store.js

@@ -0,0 +1,34 @@
+import { useRef, useSyncExternalStore } from "react";
+import { applyConversationSeenEvent as applyConversationSeenEvent$1, createSeenStore, hydrateConversationSeen as hydrateConversationSeen$1, upsertConversationSeen as upsertConversationSeen$1 } from "@cossistant/core";
+
+//#region src/realtime/seen-store.ts
+const store = createSeenStore();
+function useSelector(selector, isEqual = Object.is) {
+	const selectionRef = useRef(void 0);
+	const subscribe = (onStoreChange) => store.subscribe(() => {
+		onStoreChange();
+	});
+	const snapshot = useSyncExternalStore(subscribe, store.getState, store.getState);
+	const selected = selector(snapshot);
+	if (selectionRef.current === void 0 || !isEqual(selectionRef.current, selected)) selectionRef.current = selected;
+	return selectionRef.current;
+}
+function useSeenStore(selector, isEqual) {
+	return useSelector(selector, isEqual);
+}
+function hydrateConversationSeen(conversationId, entries) {
+	hydrateConversationSeen$1(store, conversationId, entries);
+}
+function upsertConversationSeen(options) {
+	upsertConversationSeen$1(store, {
+		...options,
+		lastSeenAt: options.lastSeenAt.toISOString()
+	});
+}
+function applyConversationSeenEvent(event, options) {
+	applyConversationSeenEvent$1(store, event, options);
+}
+
+//#endregion
+export { applyConversationSeenEvent, hydrateConversationSeen, upsertConversationSeen, useSeenStore };
+//# sourceMappingURL=seen-store.js.map

package/realtime/seen-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seen-store.js","names":[],"sources":["../../src/realtime/seen-store.ts"],"sourcesContent":["import {\n\tapplyConversationSeenEvent as applyEvent,\n\tcreateSeenStore,\n\thydrateConversationSeen as hydrateStore,\n\ttype SeenActorType,\n\ttype SeenEntry,\n\ttype SeenState,\n\tupsertConversationSeen as upsertStore,\n} from \"@cossistant/core\";\nimport type { RealtimeEvent } from \"@cossistant/types/realtime-events\";\nimport type { ConversationSeen } from \"@cossistant/types/schemas\";\nimport { useRef, useSyncExternalStore } from \"react\";\n\nconst store = createSeenStore();\n\ntype Selector<T> = (state: SeenState) => T;\n\ntype EqualityChecker<T> = (previous: T, next: T) => boolean;\n\nfunction useSelector<TSelected>(\n\tselector: Selector<TSelected>,\n\tisEqual: EqualityChecker<TSelected> = Object.is\n): TSelected {\n\tconst selectionRef = useRef<TSelected>(undefined);\n\n\tconst subscribe = (onStoreChange: () => void) =>\n\t\tstore.subscribe(() => {\n\t\t\tonStoreChange();\n\t\t});\n\n\tconst snapshot = useSyncExternalStore(\n\t\tsubscribe,\n\t\tstore.getState,\n\t\tstore.getState\n\t);\n\n\tconst selected = selector(snapshot);\n\n\tif (\n\t\tselectionRef.current === undefined ||\n\t\t!isEqual(selectionRef.current, selected)\n\t) {\n\t\tselectionRef.current = selected;\n\t}\n\n\treturn selectionRef.current as TSelected;\n}\n\nexport function useSeenStore<TSelected>(\n\tselector: Selector<TSelected>,\n\tisEqual?: EqualityChecker<TSelected>\n): TSelected {\n\treturn useSelector(selector, isEqual);\n}\n\nexport function hydrateConversationSeen(\n\tconversationId: string,\n\tentries: ConversationSeen[]\n) {\n\thydrateStore(store, conversationId, entries);\n}\n\nexport function upsertConversationSeen(options: {\n\tconversationId: string;\n\tactorType: SeenActorType;\n\tactorId: string;\n\tlastSeenAt: Date;\n}) {\n\tupsertStore(store, {\n\t\t...options,\n\t\tlastSeenAt: options.lastSeenAt.toISOString(),\n\t});\n}\n\nexport function applyConversationSeenEvent(\n\tevent: RealtimeEvent<\"conversationSeen\">,\n\toptions?: {\n\t\tignoreVisitorId?: string | null;\n\t\tignoreUserId?: string | null;\n\t\tignoreAiAgentId?: string | null;\n\t}\n) {\n\tapplyEvent(store, event, options);\n}\n"],"mappings":";;;;AAaA,MAAM,QAAQ,iBAAiB;AAM/B,SAAS,YACR,UACA,UAAsC,OAAO,IACjC;CACZ,MAAM,eAAe,OAAkB,OAAU;CAEjD,MAAM,aAAa,kBAClB,MAAM,gBAAgB;AACrB,iBAAe;GACd;CAEH,MAAM,WAAW,qBAChB,WACA,MAAM,UACN,MAAM,SACN;CAED,MAAM,WAAW,SAAS,SAAS;AAEnC,KACC,aAAa,YAAY,UACzB,CAAC,QAAQ,aAAa,SAAS,SAAS,CAExC,cAAa,UAAU;AAGxB,QAAO,aAAa;;AAGrB,SAAgB,aACf,UACA,SACY;AACZ,QAAO,YAAY,UAAU,QAAQ;;AAGtC,SAAgB,wBACf,gBACA,SACC;AACD,2BAAa,OAAO,gBAAgB,QAAQ;;AAG7C,SAAgB,uBAAuB,SAKpC;AACF,0BAAY,OAAO;EAClB,GAAG;EACH,YAAY,QAAQ,WAAW,aAAa;EAC5C,CAAC;;AAGH,SAAgB,2BACf,OACA,SAKC;AACD,8BAAW,OAAO,OAAO,QAAQ"}

package/realtime/support-provider.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/realtime/support-provider.d.ts
+type SupportRealtimeProviderProps = {
+  children: React.ReactNode;
+};
+/**
+ * Bridges websocket events into the core client stores so support hooks stay
+ * in sync without forcing refetches.
+ */
+declare function SupportRealtimeProvider({
+  children
+}: SupportRealtimeProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SupportRealtimeProvider };
+//# sourceMappingURL=support-provider.d.ts.map

package/realtime/support-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-provider.d.ts","names":[],"sources":["../../src/realtime/support-provider.tsx"],"sourcesContent":[],"mappings":";;;;KAkBK,4BAAA;YACM,KAAA,CAAM;;AAjBc;AAwB/B;;;AAEG,iBAFa,uBAAA,CAEb;EAAA;AAAA,CAAA,EAAA,4BAAA,CAAA,EAA4B,kBAAA,CAAA,GAAA,CAAA,OAA5B"}

package/realtime/support-provider.js

@@ -0,0 +1,54 @@
+import { applyConversationSeenEvent } from "./seen-store.js";
+import { applyConversationTypingEvent, clearTypingFromTimelineItem } from "./typing-store.js";
+import { useRealtime } from "./use-realtime.js";
+import { useSupport } from "../provider.js";
+import { useMemo } from "react";
+import { Fragment, jsx } from "react/jsx-runtime";
+
+//#region src/realtime/support-provider.tsx
+/**
+* Bridges websocket events into the core client stores so support hooks stay
+* in sync without forcing refetches.
+*/
+function SupportRealtimeProvider({ children }) {
+	const { website, client, visitor } = useSupport();
+	const realtimeContext = useMemo(() => ({
+		websiteId: website?.id ?? null,
+		visitorId: visitor?.id ?? null,
+		client
+	}), [
+		website?.id,
+		visitor?.id,
+		client
+	]);
+	const events = useMemo(() => ({
+		timelineItemCreated: (_data, { event, context }) => {
+			if (context.websiteId && event.payload.websiteId !== context.websiteId) return;
+			clearTypingFromTimelineItem(event);
+			context.client.handleRealtimeEvent(event);
+		},
+		conversationSeen: (_data, { event, context }) => {
+			if (context.websiteId && event.payload.websiteId !== context.websiteId) return;
+			applyConversationSeenEvent(event);
+		},
+		conversationTyping: (_data, { event, context }) => {
+			if (context.websiteId && event.payload.websiteId !== context.websiteId) return;
+			applyConversationTypingEvent(event, { ignoreVisitorId: context.visitorId });
+		},
+		conversationEventCreated: (_data, { event, context }) => {
+			if (context.websiteId && event.payload.websiteId !== context.websiteId) return;
+			context.client.handleRealtimeEvent(event);
+		}
+	}), []);
+	useRealtime({
+		context: realtimeContext,
+		events,
+		websiteId: realtimeContext.websiteId,
+		visitorId: realtimeContext.visitorId
+	});
+	return /* @__PURE__ */ jsx(Fragment, { children });
+}
+
+//#endregion
+export { SupportRealtimeProvider };
+//# sourceMappingURL=support-provider.js.map

package/realtime/support-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-provider.js","names":[],"sources":["../../src/realtime/support-provider.tsx"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport type { RealtimeEvent } from \"@cossistant/types/realtime-events\";\nimport type React from \"react\";\nimport { useMemo } from \"react\";\nimport { useSupport } from \"../provider\";\nimport { applyConversationSeenEvent } from \"./seen-store\";\nimport {\n\tapplyConversationTypingEvent,\n\tclearTypingFromTimelineItem,\n} from \"./typing-store\";\nimport { useRealtime } from \"./use-realtime\";\n\ntype SupportRealtimeContext = {\n\twebsiteId: string | null;\n\tvisitorId: string | null;\n\tclient: CossistantClient;\n};\n\ntype SupportRealtimeProviderProps = {\n\tchildren: React.ReactNode;\n};\n\n/**\n * Bridges websocket events into the core client stores so support hooks stay\n * in sync without forcing refetches.\n */\nexport function SupportRealtimeProvider({\n\tchildren,\n}: SupportRealtimeProviderProps) {\n\tconst { website, client, visitor } = useSupport();\n\n\tconst realtimeContext = useMemo<SupportRealtimeContext>(\n\t\t() => ({\n\t\t\twebsiteId: website?.id ?? null,\n\t\t\tvisitorId: visitor?.id ?? null,\n\t\t\tclient,\n\t\t}),\n\t\t[website?.id, visitor?.id, client]\n\t);\n\n\tconst events = useMemo(\n\t\t() => ({\n\t\t\ttimelineItemCreated: (\n\t\t\t\t_data: unknown,\n\t\t\t\t{\n\t\t\t\t\tevent,\n\t\t\t\t\tcontext,\n\t\t\t\t}: {\n\t\t\t\t\tevent: RealtimeEvent<\"timelineItemCreated\">;\n\t\t\t\t\tcontext: SupportRealtimeContext;\n\t\t\t\t}\n\t\t\t) => {\n\t\t\t\tif (\n\t\t\t\t\tcontext.websiteId &&\n\t\t\t\t\tevent.payload.websiteId !== context.websiteId\n\t\t\t\t) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Clear typing state when a timeline item is created\n\t\t\t\tclearTypingFromTimelineItem(event);\n\n\t\t\t\tcontext.client.handleRealtimeEvent(event);\n\t\t\t},\n\t\t\tconversationSeen: (\n\t\t\t\t_data: unknown,\n\t\t\t\t{\n\t\t\t\t\tevent,\n\t\t\t\t\tcontext,\n\t\t\t\t}: {\n\t\t\t\t\tevent: RealtimeEvent<\"conversationSeen\">;\n\t\t\t\t\tcontext: SupportRealtimeContext;\n\t\t\t\t}\n\t\t\t) => {\n\t\t\t\tif (\n\t\t\t\t\tcontext.websiteId &&\n\t\t\t\t\tevent.payload.websiteId !== context.websiteId\n\t\t\t\t) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Update the seen store so the UI reflects who has seen messages\n\t\t\t\tapplyConversationSeenEvent(event);\n\t\t\t},\n\t\t\tconversationTyping: (\n\t\t\t\t_data: unknown,\n\t\t\t\t{\n\t\t\t\t\tevent,\n\t\t\t\t\tcontext,\n\t\t\t\t}: {\n\t\t\t\t\tevent: RealtimeEvent<\"conversationTyping\">;\n\t\t\t\t\tcontext: SupportRealtimeContext;\n\t\t\t\t}\n\t\t\t) => {\n\t\t\t\tif (\n\t\t\t\t\tcontext.websiteId &&\n\t\t\t\t\tevent.payload.websiteId !== context.websiteId\n\t\t\t\t) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Update typing store, but ignore events from the current visitor (their own typing)\n\t\t\t\t// Note: We use context.visitorId which is fresh from the context object\n\t\t\t\tapplyConversationTypingEvent(event, {\n\t\t\t\t\tignoreVisitorId: context.visitorId,\n\t\t\t\t});\n\t\t\t},\n\t\t\tconversationEventCreated: (\n\t\t\t\t_data: unknown,\n\t\t\t\t{\n\t\t\t\t\tevent,\n\t\t\t\t\tcontext,\n\t\t\t\t}: {\n\t\t\t\t\tevent: RealtimeEvent<\"conversationEventCreated\">;\n\t\t\t\t\tcontext: SupportRealtimeContext;\n\t\t\t\t}\n\t\t\t) => {\n\t\t\t\tif (\n\t\t\t\t\tcontext.websiteId &&\n\t\t\t\t\tevent.payload.websiteId !== context.websiteId\n\t\t\t\t) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tcontext.client.handleRealtimeEvent(event);\n\t\t\t},\n\t\t}),\n\t\t// Empty dependencies is fine here since we use the context parameter\n\t\t// which always has fresh data from the memoized realtimeContext\n\t\t[]\n\t);\n\n\tuseRealtime<SupportRealtimeContext>({\n\t\tcontext: realtimeContext,\n\t\tevents,\n\t\twebsiteId: realtimeContext.websiteId,\n\t\tvisitorId: realtimeContext.visitorId,\n\t});\n\n\treturn <>{children}</>;\n}\n"],"mappings":";;;;;;;;;;;;AA0BA,SAAgB,wBAAwB,EACvC,YACgC;CAChC,MAAM,EAAE,SAAS,QAAQ,YAAY,YAAY;CAEjD,MAAM,kBAAkB,eAChB;EACN,WAAW,SAAS,MAAM;EAC1B,WAAW,SAAS,MAAM;EAC1B;EACA,GACD;EAAC,SAAS;EAAI,SAAS;EAAI;EAAO,CAClC;CAED,MAAM,SAAS,eACP;EACN,sBACC,OACA,EACC,OACA,cAKG;AACJ,OACC,QAAQ,aACR,MAAM,QAAQ,cAAc,QAAQ,UAEpC;AAID,+BAA4B,MAAM;AAElC,WAAQ,OAAO,oBAAoB,MAAM;;EAE1C,mBACC,OACA,EACC,OACA,cAKG;AACJ,OACC,QAAQ,aACR,MAAM,QAAQ,cAAc,QAAQ,UAEpC;AAID,8BAA2B,MAAM;;EAElC,qBACC,OACA,EACC,OACA,cAKG;AACJ,OACC,QAAQ,aACR,MAAM,QAAQ,cAAc,QAAQ,UAEpC;AAKD,gCAA6B,OAAO,EACnC,iBAAiB,QAAQ,WACzB,CAAC;;EAEH,2BACC,OACA,EACC,OACA,cAKG;AACJ,OACC,QAAQ,aACR,MAAM,QAAQ,cAAc,QAAQ,UAEpC;AAGD,WAAQ,OAAO,oBAAoB,MAAM;;EAE1C,GAGD,EAAE,CACF;AAED,aAAoC;EACnC,SAAS;EACT;EACA,WAAW,gBAAgB;EAC3B,WAAW,gBAAgB;EAC3B,CAAC;AAEF,QAAO,gCAAG,WAAY"}

package/realtime/typing-store.d.ts

@@ -0,0 +1,30 @@
+import { RealtimeEvent } from "../realtime-events.js";
+import { TypingActorType, TypingState } from "@cossistant/core";
+
+//#region src/realtime/typing-store.d.ts
+type Selector<T> = (state: TypingState) => T;
+type EqualityChecker<T> = (previous: T, next: T) => boolean;
+declare function useTypingStore<TSelected>(selector: Selector<TSelected>, isEqual?: EqualityChecker<TSelected>): TSelected;
+declare function setTypingState(options: {
+  conversationId: string;
+  actorType: TypingActorType;
+  actorId: string;
+  isTyping: boolean;
+  preview?: string | null;
+  ttlMs?: number;
+}): void;
+declare function clearTypingState(options: {
+  conversationId: string;
+  actorType: TypingActorType;
+  actorId: string;
+}): void;
+declare function applyConversationTypingEvent(event: RealtimeEvent<"conversationTyping">, options?: {
+  ignoreVisitorId?: string | null;
+  ignoreUserId?: string | null;
+  ignoreAiAgentId?: string | null;
+  ttlMs?: number;
+}): void;
+declare function clearTypingFromTimelineItem(event: RealtimeEvent<"timelineItemCreated">): void;
+//#endregion
+export { applyConversationTypingEvent, clearTypingFromTimelineItem, clearTypingState, setTypingState, useTypingStore };
+//# sourceMappingURL=typing-store.d.ts.map

package/realtime/typing-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-store.d.ts","names":[],"sources":["../../src/realtime/typing-store.ts"],"sourcesContent":[],"mappings":";;;;KAgBK,sBAAsB,gBAAgB;KAEtC,gCAAgC,SAAS;AAFzC,iBAiCW,cAjCH,CAAA,SAAA,CAAA,CAAA,QAAA,EAkCF,QAlCE,CAkCO,SAlCP,CAAA,EAAA,OAAA,CAAA,EAmCF,eAnCE,CAmCc,SAnCd,CAAA,CAAA,EAoCV,SApCU;AAAA,iBAwCG,cAAA,CAxCH,OAAA,EAAA;gBAAc,EAAA,MAAA;WAAgB,EA0C/B,eA1C+B;EAAC,OAAA,EAAA,MAAA;EAEvC,QAAA,EAAA,OAAA;EAAe,OAAA,CAAA,EAAA,MAAA,GAAA,IAAA;OAAiB,CAAA,EAAA,MAAA;QAAS;AAAC,iBAiD/B,gBAAA,CAjD+B,OAAA,EAAA;EA+B/B,cAAA,EAAA,MAAc;EAAA,SAAA,EAoBlB,eApBkB;SACV,EAAA,MAAA;QAAT;AACgB,iBAwBX,4BAAA,CAxBW,KAAA,EAyBnB,aAzBmB,CAAA,oBAAA,CAAA,EAAA,OAgB3B,CAhB2B,EAAA;iBAAhB,CAAA,EAAA,MAAA,GAAA,IAAA;cACR,CAAA,EAAA,MAAA,GAAA,IAAA;EAAS,eAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAII,KAAA,CAAA,EAAA,MAAA;AAWhB,CAAA,CAAA,EAAgB,IAAA;AAQA,iBAYA,2BAAA,CAXR,KAAA,EAYA,aAZa,CAAA,qBAAA,CAAA,CAAA,EAAA,IAAA"}

package/realtime/typing-store.js

@@ -0,0 +1,34 @@
+import { useRef, useSyncExternalStore } from "react";
+import { applyConversationTypingEvent as applyConversationTypingEvent$1, clearTypingFromTimelineItem as clearTypingFromTimelineItem$1, clearTypingState as clearTypingState$1, createTypingStore, setTypingState as setTypingState$1 } from "@cossistant/core";
+
+//#region src/realtime/typing-store.ts
+const store = createTypingStore();
+function useSelector(selector, isEqual = Object.is) {
+	const selectionRef = useRef(void 0);
+	const subscribe = (onStoreChange) => store.subscribe(() => {
+		onStoreChange();
+	});
+	const snapshot = useSyncExternalStore(subscribe, store.getState, store.getState);
+	const selected = selector(snapshot);
+	if (selectionRef.current === void 0 || !isEqual(selectionRef.current, selected)) selectionRef.current = selected;
+	return selectionRef.current;
+}
+function useTypingStore(selector, isEqual) {
+	return useSelector(selector, isEqual);
+}
+function setTypingState(options) {
+	setTypingState$1(store, options);
+}
+function clearTypingState(options) {
+	clearTypingState$1(store, options);
+}
+function applyConversationTypingEvent(event, options) {
+	applyConversationTypingEvent$1(store, event, options);
+}
+function clearTypingFromTimelineItem(event) {
+	clearTypingFromTimelineItem$1(store, event);
+}
+
+//#endregion
+export { applyConversationTypingEvent, clearTypingFromTimelineItem, clearTypingState, setTypingState, useTypingStore };
+//# sourceMappingURL=typing-store.js.map

package/realtime/typing-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-store.js","names":[],"sources":["../../src/realtime/typing-store.ts"],"sourcesContent":["import {\n\tapplyConversationTypingEvent as applyEvent,\n\ttype ConversationTypingState,\n\tclearTypingFromTimelineItem as clearFromTimelineItem,\n\tclearTypingState as clearState,\n\tcreateTypingStore,\n\tsetTypingState as setState,\n\ttype TypingActorType,\n\ttype TypingEntry,\n\ttype TypingState,\n} from \"@cossistant/core\";\nimport type { RealtimeEvent } from \"@cossistant/types/realtime-events\";\nimport { useRef, useSyncExternalStore } from \"react\";\n\nconst store = createTypingStore();\n\ntype Selector<T> = (state: TypingState) => T;\n\ntype EqualityChecker<T> = (previous: T, next: T) => boolean;\n\nfunction useSelector<TSelected>(\n\tselector: Selector<TSelected>,\n\tisEqual: EqualityChecker<TSelected> = Object.is\n): TSelected {\n\tconst selectionRef = useRef<TSelected>(undefined);\n\n\tconst subscribe = (onStoreChange: () => void) =>\n\t\tstore.subscribe(() => {\n\t\t\tonStoreChange();\n\t\t});\n\n\tconst snapshot = useSyncExternalStore(\n\t\tsubscribe,\n\t\tstore.getState,\n\t\tstore.getState\n\t);\n\n\tconst selected = selector(snapshot);\n\n\tif (\n\t\tselectionRef.current === undefined ||\n\t\t!isEqual(selectionRef.current, selected)\n\t) {\n\t\tselectionRef.current = selected;\n\t}\n\n\treturn selectionRef.current as TSelected;\n}\n\nexport function useTypingStore<TSelected>(\n\tselector: Selector<TSelected>,\n\tisEqual?: EqualityChecker<TSelected>\n): TSelected {\n\treturn useSelector(selector, isEqual);\n}\n\nexport function setTypingState(options: {\n\tconversationId: string;\n\tactorType: TypingActorType;\n\tactorId: string;\n\tisTyping: boolean;\n\tpreview?: string | null;\n\tttlMs?: number;\n}) {\n\tsetState(store, options);\n}\n\nexport function clearTypingState(options: {\n\tconversationId: string;\n\tactorType: TypingActorType;\n\tactorId: string;\n}) {\n\tclearState(store, options);\n}\n\nexport function applyConversationTypingEvent(\n\tevent: RealtimeEvent<\"conversationTyping\">,\n\toptions?: {\n\t\tignoreVisitorId?: string | null;\n\t\tignoreUserId?: string | null;\n\t\tignoreAiAgentId?: string | null;\n\t\tttlMs?: number;\n\t}\n) {\n\tapplyEvent(store, event, options);\n}\n\nexport function clearTypingFromTimelineItem(\n\tevent: RealtimeEvent<\"timelineItemCreated\">\n) {\n\tclearFromTimelineItem(store, event);\n}\n"],"mappings":";;;;AAcA,MAAM,QAAQ,mBAAmB;AAMjC,SAAS,YACR,UACA,UAAsC,OAAO,IACjC;CACZ,MAAM,eAAe,OAAkB,OAAU;CAEjD,MAAM,aAAa,kBAClB,MAAM,gBAAgB;AACrB,iBAAe;GACd;CAEH,MAAM,WAAW,qBAChB,WACA,MAAM,UACN,MAAM,SACN;CAED,MAAM,WAAW,SAAS,SAAS;AAEnC,KACC,aAAa,YAAY,UACzB,CAAC,QAAQ,aAAa,SAAS,SAAS,CAExC,cAAa,UAAU;AAGxB,QAAO,aAAa;;AAGrB,SAAgB,eACf,UACA,SACY;AACZ,QAAO,YAAY,UAAU,QAAQ;;AAGtC,SAAgB,eAAe,SAO5B;AACF,kBAAS,OAAO,QAAQ;;AAGzB,SAAgB,iBAAiB,SAI9B;AACF,oBAAW,OAAO,QAAQ;;AAG3B,SAAgB,6BACf,OACA,SAMC;AACD,gCAAW,OAAO,OAAO,QAAQ;;AAGlC,SAAgB,4BACf,OACC;AACD,+BAAsB,OAAO,MAAM"}