@cossistant/react 0.0.1

package/primitives/window.d.ts

@@ -0,0 +1,31 @@
+import * as React$1 from "react";
+
+//#region src/primitives/window.d.ts
+type WindowRenderProps = {
+  isOpen: boolean;
+  close: () => void;
+};
+type WindowProps = Omit<React$1.HTMLAttributes<HTMLDivElement>, "children"> & {
+  isOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  children?: React$1.ReactNode | ((props: WindowRenderProps) => React$1.ReactNode);
+  asChild?: boolean;
+  closeOnEscape?: boolean;
+  id?: string;
+};
+/**
+ * Host container for the support experience. Handles responsive mode, escape
+ * key dismissal and propagates render props so callers can take over the
+ * layout.
+ */
+declare const SupportWindow: React$1.ForwardRefExoticComponent<Omit<React$1.HTMLAttributes<HTMLDivElement>, "children"> & {
+  isOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  children?: React$1.ReactNode | ((props: WindowRenderProps) => React$1.ReactNode);
+  asChild?: boolean;
+  closeOnEscape?: boolean;
+  id?: string;
+} & React$1.RefAttributes<HTMLDivElement>>;
+//#endregion
+export { SupportWindow, WindowProps, WindowRenderProps };
+//# sourceMappingURL=window.d.ts.map

package/primitives/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","names":[],"sources":["../../src/primitives/window.tsx"],"sourcesContent":[],"mappings":";;;KAIY,iBAAA;;EAAA,KAAA,EAAA,GAAA,GAAA,IAAA;AAKZ,CAAA;AAAuB,KAAX,WAAA,GAAc,IAAH,CACtB,OAAA,CAAM,cADgB,CACD,cADC,CAAA,EAAA,UAAA,CAAA,GAAA;QACD,CAAA,EAAA,OAAA;cAAf,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAA,IAAA;UADmB,CAAA,EAMd,OAAA,CAAM,SANQ,GAAA,CAAA,CAAA,KAAA,EAMa,iBANb,EAAA,GAMmC,OAAA,CAAM,SANzC,CAAA;SAMd,CAAA,EAAA,OAAM;eAAqB,CAAA,EAAA,OAAA;KAAsB,EAAA,MAAM;CAAS;AAW5E;;;;;AAXY,cAWC,aAXK,EAWQ,OAAA,CAAA,yBAXR,CAWQ,IAXR,CAWQ,OAAA,CAAA,cAXR,CAWQ,cAXR,CAAA,EAAA,UAAA,CAAA,GAAA;QAAqB,CAAA,EAAA,OAAA;cAA4B,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAA,IAAA;aAAvD,OAAA,CAAM,qBAAqB,sBAAsB,OAAA,CAAM;;eAWzC,CAAA,EAAA,OAAA;EAAA,EAAA,CAAA,EAAA,MAAA"}

package/primitives/window.js

@@ -0,0 +1,58 @@
+import { useRenderElement } from "../utils/use-render-element.js";
+import { useSupportConfig } from "../support/context/config.js";
+import * as React$1 from "react";
+
+//#region src/primitives/window.tsx
+/**
+* Host container for the support experience. Handles responsive mode, escape
+* key dismissal and propagates render props so callers can take over the
+* layout.
+*/
+const SupportWindow = (() => {
+	const Component = React$1.forwardRef(({ isOpen: isOpenProp, onOpenChange, children, className, asChild = false, closeOnEscape = true, id = "cossistant-window",...props }, ref) => {
+		const { isOpen, close, mode } = useSupportConfig();
+		const open = mode === "responsive" ? true : isOpenProp ?? isOpen ?? false;
+		const closeFn = React$1.useCallback(() => {
+			if (onOpenChange) onOpenChange(false);
+			else if (close) close();
+		}, [onOpenChange, close]);
+		React$1.useEffect(() => {
+			if (!(open && closeOnEscape)) return;
+			const onKey = (e) => {
+				if (e.key === "Escape") close();
+			};
+			window.addEventListener("keydown", onKey);
+			return () => window.removeEventListener("keydown", onKey);
+		}, [
+			open,
+			close,
+			closeOnEscape
+		]);
+		const renderProps = {
+			isOpen: open,
+			close: closeFn
+		};
+		const content = typeof children === "function" ? children(renderProps) : children;
+		return useRenderElement("div", {
+			className,
+			asChild
+		}, {
+			ref,
+			state: renderProps,
+			props: {
+				role: "dialog",
+				"aria-modal": "true",
+				id,
+				...props,
+				children: content
+			},
+			enabled: open
+		});
+	});
+	Component.displayName = "SupportWindow";
+	return Component;
+})();
+
+//#endregion
+export { SupportWindow };
+//# sourceMappingURL=window.js.map

package/primitives/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","names":["React","renderProps: WindowRenderProps"],"sources":["../../src/primitives/window.tsx"],"sourcesContent":["import * as React from \"react\";\nimport { useSupportConfig } from \"../support/context/config\";\nimport { useRenderElement } from \"../utils/use-render-element\";\n\nexport type WindowRenderProps = {\n\tisOpen: boolean;\n\tclose: () => void;\n};\n\nexport type WindowProps = Omit<\n\tReact.HTMLAttributes<HTMLDivElement>,\n\t\"children\"\n> & {\n\tisOpen?: boolean;\n\tonOpenChange?: (open: boolean) => void;\n\tchildren?: React.ReactNode | ((props: WindowRenderProps) => React.ReactNode);\n\tasChild?: boolean;\n\tcloseOnEscape?: boolean;\n\tid?: string;\n};\n\n/**\n * Host container for the support experience. Handles responsive mode, escape\n * key dismissal and propagates render props so callers can take over the\n * layout.\n */\nexport const SupportWindow = (() => {\n\tconst Component = React.forwardRef<HTMLDivElement, WindowProps>(\n\t\t(\n\t\t\t{\n\t\t\t\tisOpen: isOpenProp,\n\t\t\t\tonOpenChange,\n\t\t\t\tchildren,\n\t\t\t\tclassName,\n\t\t\t\tasChild = false,\n\t\t\t\tcloseOnEscape = true,\n\t\t\t\tid = \"cossistant-window\",\n\t\t\t\t...props\n\t\t\t},\n\t\t\tref\n\t\t) => {\n\t\t\tconst { isOpen, close, mode } = useSupportConfig();\n\n\t\t\t// In responsive mode, window is always open\n\t\t\t// Otherwise use normal open/close logic\n\t\t\tconst open =\n\t\t\t\tmode === \"responsive\" ? true : (isOpenProp ?? isOpen ?? false);\n\n\t\t\tconst closeFn = React.useCallback(() => {\n\t\t\t\tif (onOpenChange) {\n\t\t\t\t\tonOpenChange(false);\n\t\t\t\t} else if (close) {\n\t\t\t\t\tclose();\n\t\t\t\t}\n\t\t\t}, [onOpenChange, close]);\n\n\t\t\t// Close on Escape\n\t\t\tReact.useEffect(() => {\n\t\t\t\tif (!(open && closeOnEscape)) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst onKey = (e: KeyboardEvent) => {\n\t\t\t\t\tif (e.key === \"Escape\") {\n\t\t\t\t\t\tclose();\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\twindow.addEventListener(\"keydown\", onKey);\n\t\t\t\treturn () => window.removeEventListener(\"keydown\", onKey);\n\t\t\t}, [open, close, closeOnEscape]);\n\n\t\t\tconst renderProps: WindowRenderProps = { isOpen: open, close: closeFn };\n\n\t\t\tconst content =\n\t\t\t\ttypeof children === \"function\" ? children(renderProps) : children;\n\n\t\t\treturn useRenderElement(\n\t\t\t\t\"div\",\n\t\t\t\t{\n\t\t\t\t\tclassName,\n\t\t\t\t\tasChild,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tref,\n\t\t\t\t\tstate: renderProps,\n\t\t\t\t\tprops: {\n\t\t\t\t\t\trole: \"dialog\",\n\t\t\t\t\t\t\"aria-modal\": \"true\",\n\t\t\t\t\t\tid,\n\t\t\t\t\t\t...props,\n\t\t\t\t\t\tchildren: content,\n\t\t\t\t\t},\n\t\t\t\t\tenabled: open,\n\t\t\t\t}\n\t\t\t);\n\t\t}\n\t);\n\n\tComponent.displayName = \"SupportWindow\";\n\treturn Component;\n})();\n"],"mappings":";;;;;;;;;;AA0BA,MAAa,uBAAuB;CACnC,MAAM,YAAYA,QAAM,YAEtB,EACC,QAAQ,YACR,cACA,UACA,WACA,UAAU,OACV,gBAAgB,MAChB,KAAK,oBACL,GAAG,SAEJ,QACI;EACJ,MAAM,EAAE,QAAQ,OAAO,SAAS,kBAAkB;EAIlD,MAAM,OACL,SAAS,eAAe,OAAQ,cAAc,UAAU;EAEzD,MAAM,UAAUA,QAAM,kBAAkB;AACvC,OAAI,aACH,cAAa,MAAM;YACT,MACV,QAAO;KAEN,CAAC,cAAc,MAAM,CAAC;AAGzB,UAAM,gBAAgB;AACrB,OAAI,EAAE,QAAQ,eACb;GAED,MAAM,SAAS,MAAqB;AACnC,QAAI,EAAE,QAAQ,SACb,QAAO;;AAGT,UAAO,iBAAiB,WAAW,MAAM;AACzC,gBAAa,OAAO,oBAAoB,WAAW,MAAM;KACvD;GAAC;GAAM;GAAO;GAAc,CAAC;EAEhC,MAAMC,cAAiC;GAAE,QAAQ;GAAM,OAAO;GAAS;EAEvE,MAAM,UACL,OAAO,aAAa,aAAa,SAAS,YAAY,GAAG;AAE1D,SAAO,iBACN,OACA;GACC;GACA;GACA,EACD;GACC;GACA,OAAO;GACP,OAAO;IACN,MAAM;IACN,cAAc;IACd;IACA,GAAG;IACH,UAAU;IACV;GACD,SAAS;GACT,CACD;GAEF;AAED,WAAU,cAAc;AACxB,QAAO;IACJ"}

package/provider.d.ts

@@ -0,0 +1,95 @@
+import * as React$1 from "react";
+import { CossistantClient } from "@cossistant/core";
+import { DefaultMessage, PublicWebsiteResponse } from "@cossistant/types";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
+import { QueryClient } from "@tanstack/react-query";
+
+//#region src/provider.d.ts
+type SupportProviderProps = {
+  children: React$1.ReactNode;
+  defaultOpen?: boolean;
+  apiUrl?: string;
+  wsUrl?: string;
+  publicKey?: string;
+  defaultMessages?: DefaultMessage[];
+  quickOptions?: string[];
+  autoConnect?: boolean;
+  onWsConnect?: () => void;
+  onWsDisconnect?: () => void;
+  onWsError?: (error: Error) => void;
+  queryClient?: QueryClient;
+};
+type CossistantProviderProps = SupportProviderProps;
+type CossistantContextValue = {
+  website: PublicWebsiteResponse | null;
+  defaultMessages: DefaultMessage[];
+  quickOptions: string[];
+  setDefaultMessages: (messages: DefaultMessage[]) => void;
+  setQuickOptions: (options: string[]) => void;
+  unreadCount: number;
+  setUnreadCount: (count: number) => void;
+  isLoading: boolean;
+  error: Error | null;
+  client: CossistantClient;
+};
+/**
+ * Hosts the entire customer support widget ecosystem by handing out context
+ * about the current website, visitor, unread counts, realtime subscriptions
+ * and the REST client. Provide your Cossistant public key plus optional
+ * defaults to configure the widget behaviour.
+ */
+declare function SupportProvider({
+  children,
+  apiUrl,
+  wsUrl,
+  publicKey,
+  defaultMessages,
+  quickOptions,
+  autoConnect,
+  onWsConnect,
+  onWsDisconnect,
+  onWsError,
+  queryClient
+}: SupportProviderProps): react_jsx_runtime2.JSX.Element;
+/**
+ * Convenience hook that exposes the aggregated support context. Throws when it
+ * is consumed outside of `SupportProvider` to catch integration mistakes.
+ */
+declare function useSupport(): {
+  availableHumanAgents: {
+    id: string;
+    name: string;
+    image: string | null;
+    lastSeenAt: string | null;
+  }[];
+  availableAIAgents: {
+    id: string;
+    name: string;
+    image: string | null;
+  }[];
+  visitor: {
+    locale: string | null;
+    id: string;
+    isBlocked: boolean;
+    language: string | null;
+    contact: {
+      id: string;
+      name: string | null;
+      email: string | null;
+      image: string | null;
+    } | null;
+  } | undefined;
+  website: PublicWebsiteResponse | null;
+  defaultMessages: DefaultMessage[];
+  quickOptions: string[];
+  setDefaultMessages: (messages: DefaultMessage[]) => void;
+  setQuickOptions: (options: string[]) => void;
+  unreadCount: number;
+  setUnreadCount: (count: number) => void;
+  isLoading: boolean;
+  error: Error | null;
+  client: CossistantClient;
+};
+//#endregion
+export { CossistantContextValue, CossistantProviderProps, SupportProvider, SupportProviderProps, useSupport };
+//# sourceMappingURL=provider.d.ts.map

package/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","names":[],"sources":["../src/provider.tsx"],"sourcesContent":[],"mappings":";;;;;;;KASY,oBAAA;YACD,OAAA,CAAM;;EADL,MAAA,CAAA,EAAA,MAAA;EAAoB,KAAA,CAAA,EAAA,MAAA;WACrB,CAAA,EAAM,MAAA;iBAKE,CAAA,EAAA,cAAA,EAAA;cAKE,CAAA,EAAA,MAAA,EAAA;aACN,CAAA,EAAA,OAAA;EAAW,WAAA,CAAA,EAAA,GAAA,GAAA,IAAA;EAGd,cAAA,CAAA,EAAA,GAAA,GAAA,IAAuB;EAEvB,SAAA,CAAA,EAAA,CAAA,KAAA,EANS,KAMa,EAAA,GAAA,IAAA;EAAA,WAAA,CAAA,EALnB,WAKmB;;AAEhB,KAJN,uBAAA,GAA0B,oBAIpB;AAEc,KAJpB,sBAAA,GAIoB;SAKxB,EARE,qBAQF,GAAA,IAAA;iBACC,EARS,cAQT,EAAA;EAAgB,YAAA,EAAA,MAAA,EAAA;EA+HT,kBAAe,EAAA,CAAA,QAAA,EArIC,cAqID,EAAA,EAAA,GAAA,IAAA;EAAA,eAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,EAAA,GAAA,IAAA;aAC9B,EAAA,MAAA;gBACA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,IAAA;WACA,EAAA,OAAA;OACA,EApIO,KAoIP,GAAA,IAAA;QACA,EApIQ,gBAoIR;;;;;;;;AAOsB,iBAZP,eAAA,CAYO;EAAA,QAAA;EAAA,MAAA;EAAA,KAAA;EAAA,SAAA;EAAA,eAAA;EAAA,YAAA;EAAA,WAAA;EAAA,WAAA;EAAA,cAAA;EAAA,SAAA;EAAA;AAAA,CAAA,EAApB,oBAAoB,CAAA,EAAA,kBAAA,CAAA,GAAA,CAAA,OAAA;;AAuCvB;;;AA1LkB,iBA0LF,UAAA,CAAA,CA1LE,EAAA;sBAEc,EAAA;IAKxB,EAAA,EAAA,MAAA;IACC,IAAA,EAAA,MAAA;IAAgB,KAAA,EAAA,MAAA,GAAA,IAAA;;;;;;;;;;;;;;;;;;;;WATf;mBACQ;;iCAEc;;;;;SAKxB;UACC"}

package/provider.js

@@ -0,0 +1,124 @@
+import { QueryClient } from "./node_modules/@tanstack/query-core/build/modern/queryClient.js";
+import { QueryClientProvider } from "./node_modules/@tanstack/react-query/build/modern/QueryClientProvider.js";
+import { useWebsiteStore } from "./hooks/private/store/use-website-store.js";
+import { useClient } from "./hooks/private/use-rest-client.js";
+import { WebSocketProvider } from "./support/context/websocket.js";
+import * as React$1 from "react";
+import { normalizeLocale } from "@cossistant/core";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/provider.tsx
+const SupportContext = React$1.createContext(void 0);
+/**
+* Internal implementation that wires the React Query cache, REST client and
+* websocket provider together before exposing the combined context.
+*/
+function SupportProviderInner({ children, apiUrl, wsUrl, publicKey, defaultMessages, quickOptions, autoConnect, onWsConnect, onWsDisconnect, onWsError }) {
+	const [unreadCount, setUnreadCount] = React$1.useState(0);
+	const [_defaultMessages, _setDefaultMessages] = React$1.useState(defaultMessages || []);
+	const [_quickOptions, _setQuickOptions] = React$1.useState(quickOptions || []);
+	React$1.useEffect(() => {
+		if (defaultMessages && defaultMessages.length > 0) _setDefaultMessages(defaultMessages);
+	}, [defaultMessages]);
+	React$1.useEffect(() => {
+		if (quickOptions && quickOptions.length > 0) _setQuickOptions(quickOptions);
+	}, [quickOptions]);
+	const { client } = useClient(publicKey, apiUrl, wsUrl);
+	const { website, isLoading, error: websiteError } = useWebsiteStore(client);
+	const error = websiteError;
+	React$1.useEffect(() => {
+		if (website) client.restClient?.setWebsiteContext?.(website.id, website.visitor?.id);
+	}, [client, website]);
+	const setDefaultMessages = React$1.useCallback((messages) => _setDefaultMessages(messages), []);
+	const setQuickOptions = React$1.useCallback((options) => _setQuickOptions(options), []);
+	const setUnreadCountStable = React$1.useCallback((count) => setUnreadCount(count), []);
+	const value = React$1.useMemo(() => ({
+		website,
+		unreadCount,
+		setUnreadCount: setUnreadCountStable,
+		isLoading,
+		error,
+		client,
+		defaultMessages: _defaultMessages,
+		setDefaultMessages,
+		quickOptions: _quickOptions,
+		setQuickOptions
+	}), [
+		website,
+		unreadCount,
+		isLoading,
+		error,
+		client,
+		_defaultMessages,
+		_quickOptions,
+		setDefaultMessages,
+		setQuickOptions,
+		setUnreadCountStable
+	]);
+	return /* @__PURE__ */ jsx(SupportContext.Provider, {
+		value,
+		children: /* @__PURE__ */ jsx(WebSocketProvider, {
+			autoConnect,
+			onConnect: onWsConnect,
+			onDisconnect: onWsDisconnect,
+			onError: onWsError,
+			publicKey,
+			visitorId: website?.visitor?.id,
+			websiteId: website?.id,
+			wsUrl,
+			children
+		})
+	});
+}
+/**
+* Hosts the entire customer support widget ecosystem by handing out context
+* about the current website, visitor, unread counts, realtime subscriptions
+* and the REST client. Provide your Cossistant public key plus optional
+* defaults to configure the widget behaviour.
+*/
+function SupportProvider({ children, apiUrl = "https://api.cossistant.com/v1", wsUrl = "wss://api.cossistant.com/ws", publicKey, defaultMessages, quickOptions, autoConnect = true, onWsConnect, onWsDisconnect, onWsError, queryClient }) {
+	const [defaultQueryClient] = React$1.useState(() => new QueryClient({ defaultOptions: { queries: {
+		staleTime: 300 * 1e3,
+		gcTime: 600 * 1e3
+	} } }));
+	return /* @__PURE__ */ jsx(QueryClientProvider, {
+		client: queryClient || defaultQueryClient,
+		children: /* @__PURE__ */ jsx(SupportProviderInner, {
+			apiUrl,
+			autoConnect,
+			defaultMessages,
+			onWsConnect,
+			onWsDisconnect,
+			onWsError,
+			publicKey,
+			quickOptions,
+			wsUrl,
+			children
+		})
+	});
+}
+/**
+* Convenience hook that exposes the aggregated support context. Throws when it
+* is consumed outside of `SupportProvider` to catch integration mistakes.
+*/
+function useSupport() {
+	const context = React$1.useContext(SupportContext);
+	if (!context) throw new Error("useSupport must be used within a cossistant SupportProvider");
+	const availableHumanAgents = context.website?.availableHumanAgents || [];
+	const availableAIAgents = context.website?.availableAIAgents || [];
+	const visitorLanguage = context.website?.visitor?.language || null;
+	const visitor = context.website?.visitor ? {
+		...context.website.visitor,
+		locale: normalizeLocale(visitorLanguage)
+	} : void 0;
+	return {
+		...context,
+		availableHumanAgents,
+		availableAIAgents,
+		visitor
+	};
+}
+
+//#endregion
+export { SupportProvider, useSupport };
+//# sourceMappingURL=provider.js.map

package/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","names":["React"],"sources":["../src/provider.tsx"],"sourcesContent":["import type { CossistantClient } from \"@cossistant/core\";\nimport { normalizeLocale } from \"@cossistant/core\";\nimport type { DefaultMessage, PublicWebsiteResponse } from \"@cossistant/types\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport * as React from \"react\";\nimport { useWebsiteStore } from \"./hooks/private/store/use-website-store\";\nimport { useClient } from \"./hooks/private/use-rest-client\";\nimport { WebSocketProvider } from \"./support\";\n\nexport type SupportProviderProps = {\n\tchildren: React.ReactNode;\n\tdefaultOpen?: boolean;\n\tapiUrl?: string;\n\twsUrl?: string;\n\tpublicKey?: string;\n\tdefaultMessages?: DefaultMessage[];\n\tquickOptions?: string[];\n\tautoConnect?: boolean;\n\tonWsConnect?: () => void;\n\tonWsDisconnect?: () => void;\n\tonWsError?: (error: Error) => void;\n\tqueryClient?: QueryClient;\n};\n\nexport type CossistantProviderProps = SupportProviderProps;\n\nexport type CossistantContextValue = {\n\twebsite: PublicWebsiteResponse | null;\n\tdefaultMessages: DefaultMessage[];\n\tquickOptions: string[];\n\tsetDefaultMessages: (messages: DefaultMessage[]) => void;\n\tsetQuickOptions: (options: string[]) => void;\n\tunreadCount: number;\n\tsetUnreadCount: (count: number) => void;\n\tisLoading: boolean;\n\terror: Error | null;\n\tclient: CossistantClient;\n};\n\nconst SupportContext = React.createContext<CossistantContextValue | undefined>(\n\tundefined\n);\n\n/**\n * Internal implementation that wires the React Query cache, REST client and\n * websocket provider together before exposing the combined context.\n */\nfunction SupportProviderInner({\n\tchildren,\n\tapiUrl,\n\twsUrl,\n\tpublicKey,\n\tdefaultMessages,\n\tquickOptions,\n\tautoConnect,\n\tonWsConnect,\n\tonWsDisconnect,\n\tonWsError,\n}: SupportProviderProps) {\n\tconst [unreadCount, setUnreadCount] = React.useState(0);\n\tconst [_defaultMessages, _setDefaultMessages] = React.useState<\n\t\tDefaultMessage[]\n\t>(defaultMessages || []);\n\tconst [_quickOptions, _setQuickOptions] = React.useState<string[]>(\n\t\tquickOptions || []\n\t);\n\t// Update state when props change (for initial values from provider)\n\tReact.useEffect(() => {\n\t\tif (defaultMessages && defaultMessages.length > 0) {\n\t\t\t_setDefaultMessages(defaultMessages);\n\t\t}\n\t}, [defaultMessages]);\n\n\tReact.useEffect(() => {\n\t\tif (quickOptions && quickOptions.length > 0) {\n\t\t\t_setQuickOptions(quickOptions);\n\t\t}\n\t}, [quickOptions]);\n\n\tconst { client } = useClient(publicKey, apiUrl, wsUrl);\n\tconst { website, isLoading, error: websiteError } = useWebsiteStore(client);\n\n\t// Prefetch conversations\n\t// useConversations(client, {\n\t//   enabled: !!website && !!website.visitor && isClientPrimed,\n\t// });\n\n\tconst error = websiteError;\n\n\t// Prime REST client with website/visitor context so headers are sent reliably\n\tReact.useEffect(() => {\n\t\tif (website) {\n\t\t\t// @ts-expect-error internal priming: safe in our library context\n\t\t\tclient.restClient?.setWebsiteContext?.(website.id, website.visitor?.id);\n\t\t}\n\t}, [client, website]);\n\n\tconst setDefaultMessages = React.useCallback(\n\t\t(messages: DefaultMessage[]) => _setDefaultMessages(messages),\n\t\t[]\n\t);\n\n\tconst setQuickOptions = React.useCallback(\n\t\t(options: string[]) => _setQuickOptions(options),\n\t\t[]\n\t);\n\n\tconst setUnreadCountStable = React.useCallback(\n\t\t(count: number) => setUnreadCount(count),\n\t\t[]\n\t);\n\n\tconst value = React.useMemo<CossistantContextValue>(\n\t\t() => ({\n\t\t\twebsite,\n\t\t\tunreadCount,\n\t\t\tsetUnreadCount: setUnreadCountStable,\n\t\t\tisLoading,\n\t\t\terror,\n\t\t\tclient,\n\t\t\tdefaultMessages: _defaultMessages,\n\t\t\tsetDefaultMessages,\n\t\t\tquickOptions: _quickOptions,\n\t\t\tsetQuickOptions,\n\t\t}),\n\t\t[\n\t\t\twebsite,\n\t\t\tunreadCount,\n\t\t\tisLoading,\n\t\t\terror,\n\t\t\tclient,\n\t\t\t_defaultMessages,\n\t\t\t_quickOptions,\n\t\t\tsetDefaultMessages,\n\t\t\tsetQuickOptions,\n\t\t\tsetUnreadCountStable,\n\t\t]\n\t);\n\n\treturn (\n\t\t<SupportContext.Provider value={value}>\n\t\t\t<WebSocketProvider\n\t\t\t\tautoConnect={autoConnect}\n\t\t\t\tonConnect={onWsConnect}\n\t\t\t\tonDisconnect={onWsDisconnect}\n\t\t\t\tonError={onWsError}\n\t\t\t\tpublicKey={publicKey}\n\t\t\t\tvisitorId={website?.visitor?.id}\n\t\t\t\twebsiteId={website?.id}\n\t\t\t\twsUrl={wsUrl}\n\t\t\t>\n\t\t\t\t{children}\n\t\t\t</WebSocketProvider>\n\t\t</SupportContext.Provider>\n\t);\n}\n\n/**\n * Hosts the entire customer support widget ecosystem by handing out context\n * about the current website, visitor, unread counts, realtime subscriptions\n * and the REST client. Provide your Cossistant public key plus optional\n * defaults to configure the widget behaviour.\n */\nexport function SupportProvider({\n\tchildren,\n\tapiUrl = \"https://api.cossistant.com/v1\",\n\twsUrl = \"wss://api.cossistant.com/ws\",\n\tpublicKey,\n\tdefaultMessages,\n\tquickOptions,\n\tautoConnect = true,\n\tonWsConnect,\n\tonWsDisconnect,\n\tonWsError,\n\tqueryClient,\n}: SupportProviderProps) {\n\t// Create a default QueryClient if none provided\n\tconst [defaultQueryClient] = React.useState(\n\t\t() =>\n\t\t\tnew QueryClient({\n\t\t\t\tdefaultOptions: {\n\t\t\t\t\tqueries: {\n\t\t\t\t\t\tstaleTime: 5 * 60 * 1000, // 5 minutes\n\t\t\t\t\t\tgcTime: 10 * 60 * 1000, // 10 minutes\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t})\n\t);\n\n\tconst activeQueryClient = queryClient || defaultQueryClient;\n\n\treturn (\n\t\t<QueryClientProvider client={activeQueryClient}>\n\t\t\t<SupportProviderInner\n\t\t\t\tapiUrl={apiUrl}\n\t\t\t\tautoConnect={autoConnect}\n\t\t\t\tdefaultMessages={defaultMessages}\n\t\t\t\tonWsConnect={onWsConnect}\n\t\t\t\tonWsDisconnect={onWsDisconnect}\n\t\t\t\tonWsError={onWsError}\n\t\t\t\tpublicKey={publicKey}\n\t\t\t\tquickOptions={quickOptions}\n\t\t\t\twsUrl={wsUrl}\n\t\t\t>\n\t\t\t\t{children}\n\t\t\t</SupportProviderInner>\n\t\t</QueryClientProvider>\n\t);\n}\n\n/**\n * Convenience hook that exposes the aggregated support context. Throws when it\n * is consumed outside of `SupportProvider` to catch integration mistakes.\n */\nexport function useSupport() {\n\tconst context = React.useContext(SupportContext);\n\tif (!context) {\n\t\tthrow new Error(\n\t\t\t\"useSupport must be used within a cossistant SupportProvider\"\n\t\t);\n\t}\n\n\tconst availableHumanAgents = context.website?.availableHumanAgents || [];\n\tconst availableAIAgents = context.website?.availableAIAgents || [];\n\tconst visitorLanguage = context.website?.visitor?.language || null;\n\n\t// Create visitor object with normalized locale\n\tconst visitor = context.website?.visitor\n\t\t? {\n\t\t\t\t...context.website.visitor,\n\t\t\t\tlocale: normalizeLocale(visitorLanguage),\n\t\t\t}\n\t\t: undefined;\n\n\treturn {\n\t\t...context,\n\t\tavailableHumanAgents,\n\t\tavailableAIAgents,\n\t\tvisitor,\n\t};\n}\n"],"mappings":";;;;;;;;;;AAuCA,MAAM,iBAAiBA,QAAM,cAC5B,OACA;;;;;AAMD,SAAS,qBAAqB,EAC7B,UACA,QACA,OACA,WACA,iBACA,cACA,aACA,aACA,gBACA,aACwB;CACxB,MAAM,CAAC,aAAa,kBAAkBA,QAAM,SAAS,EAAE;CACvD,MAAM,CAAC,kBAAkB,uBAAuBA,QAAM,SAEpD,mBAAmB,EAAE,CAAC;CACxB,MAAM,CAAC,eAAe,oBAAoBA,QAAM,SAC/C,gBAAgB,EAAE,CAClB;AAED,SAAM,gBAAgB;AACrB,MAAI,mBAAmB,gBAAgB,SAAS,EAC/C,qBAAoB,gBAAgB;IAEnC,CAAC,gBAAgB,CAAC;AAErB,SAAM,gBAAgB;AACrB,MAAI,gBAAgB,aAAa,SAAS,EACzC,kBAAiB,aAAa;IAE7B,CAAC,aAAa,CAAC;CAElB,MAAM,EAAE,WAAW,UAAU,WAAW,QAAQ,MAAM;CACtD,MAAM,EAAE,SAAS,WAAW,OAAO,iBAAiB,gBAAgB,OAAO;CAO3E,MAAM,QAAQ;AAGd,SAAM,gBAAgB;AACrB,MAAI,QAEH,QAAO,YAAY,oBAAoB,QAAQ,IAAI,QAAQ,SAAS,GAAG;IAEtE,CAAC,QAAQ,QAAQ,CAAC;CAErB,MAAM,qBAAqBA,QAAM,aAC/B,aAA+B,oBAAoB,SAAS,EAC7D,EAAE,CACF;CAED,MAAM,kBAAkBA,QAAM,aAC5B,YAAsB,iBAAiB,QAAQ,EAChD,EAAE,CACF;CAED,MAAM,uBAAuBA,QAAM,aACjC,UAAkB,eAAe,MAAM,EACxC,EAAE,CACF;CAED,MAAM,QAAQA,QAAM,eACZ;EACN;EACA;EACA,gBAAgB;EAChB;EACA;EACA;EACA,iBAAiB;EACjB;EACA,cAAc;EACd;EACA,GACD;EACC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,CACD;AAED,QACC,oBAAC,eAAe;EAAgB;YAC/B,oBAAC;GACa;GACb,WAAW;GACX,cAAc;GACd,SAAS;GACE;GACX,WAAW,SAAS,SAAS;GAC7B,WAAW,SAAS;GACb;GAEN;IACkB;GACK;;;;;;;;AAU5B,SAAgB,gBAAgB,EAC/B,UACA,SAAS,iCACT,QAAQ,+BACR,WACA,iBACA,cACA,cAAc,MACd,aACA,gBACA,WACA,eACwB;CAExB,MAAM,CAAC,sBAAsBA,QAAM,eAEjC,IAAI,YAAY,EACf,gBAAgB,EACf,SAAS;EACR,WAAW,MAAS;EACpB,QAAQ,MAAU;EAClB,EACD,EACD,CAAC,CACH;AAID,QACC,oBAAC;EAAoB,QAHI,eAAe;YAIvC,oBAAC;GACQ;GACK;GACI;GACJ;GACG;GACL;GACA;GACG;GACP;GAEN;IACqB;GACF;;;;;;AAQxB,SAAgB,aAAa;CAC5B,MAAM,UAAUA,QAAM,WAAW,eAAe;AAChD,KAAI,CAAC,QACJ,OAAM,IAAI,MACT,8DACA;CAGF,MAAM,uBAAuB,QAAQ,SAAS,wBAAwB,EAAE;CACxE,MAAM,oBAAoB,QAAQ,SAAS,qBAAqB,EAAE;CAClE,MAAM,kBAAkB,QAAQ,SAAS,SAAS,YAAY;CAG9D,MAAM,UAAU,QAAQ,SAAS,UAC9B;EACA,GAAG,QAAQ,QAAQ;EACnB,QAAQ,gBAAgB,gBAAgB;EACxC,GACA;AAEH,QAAO;EACN,GAAG;EACH;EACA;EACA;EACA"}

package/realtime/event-filter.d.ts

@@ -0,0 +1,8 @@
+import { AnyRealtimeEvent } from "../realtime-events.js";
+
+//#region src/realtime/event-filter.d.ts
+declare function getTargetVisitorId(event: AnyRealtimeEvent): string | null;
+declare function shouldDeliverEvent(event: AnyRealtimeEvent, websiteId: string | null, visitorId: string | null): boolean;
+//#endregion
+export { getTargetVisitorId, shouldDeliverEvent };
+//# sourceMappingURL=event-filter.d.ts.map

package/realtime/event-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-filter.d.ts","names":[],"sources":["../../src/realtime/event-filter.ts"],"sourcesContent":[],"mappings":";;;iBAES,kBAAA,QAA0B;iBAkBnB,kBAAA,QACR"}

package/realtime/event-filter.js

@@ -0,0 +1,21 @@
+//#region src/realtime/event-filter.ts
+function getTargetVisitorId(event) {
+	const payloadVisitorId = event.payload.visitorId;
+	if (typeof payloadVisitorId === "string" && payloadVisitorId.length > 0) return payloadVisitorId;
+	if (event.type === "timelineItemCreated") {
+		const itemVisitorId = event.payload.item.visitorId;
+		if (typeof itemVisitorId === "string" && itemVisitorId.length > 0) return itemVisitorId;
+	}
+	return null;
+}
+function shouldDeliverEvent(event, websiteId, visitorId) {
+	if (websiteId && event.payload.websiteId !== websiteId) return false;
+	if (!visitorId) return true;
+	const targetVisitorId = getTargetVisitorId(event);
+	if (targetVisitorId && targetVisitorId !== visitorId) return false;
+	return true;
+}
+
+//#endregion
+export { getTargetVisitorId, shouldDeliverEvent };
+//# sourceMappingURL=event-filter.js.map

package/realtime/event-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-filter.js","names":[],"sources":["../../src/realtime/event-filter.ts"],"sourcesContent":["import type { AnyRealtimeEvent } from \"@cossistant/types/realtime-events\";\n\nfunction getTargetVisitorId(event: AnyRealtimeEvent): string | null {\n\tconst payloadVisitorId = event.payload.visitorId;\n\n\tif (typeof payloadVisitorId === \"string\" && payloadVisitorId.length > 0) {\n\t\treturn payloadVisitorId;\n\t}\n\n\tif (event.type === \"timelineItemCreated\") {\n\t\tconst itemVisitorId = event.payload.item.visitorId;\n\n\t\tif (typeof itemVisitorId === \"string\" && itemVisitorId.length > 0) {\n\t\t\treturn itemVisitorId;\n\t\t}\n\t}\n\n\treturn null;\n}\n\nexport function shouldDeliverEvent(\n\tevent: AnyRealtimeEvent,\n\twebsiteId: string | null,\n\tvisitorId: string | null\n): boolean {\n\tif (websiteId && event.payload.websiteId !== websiteId) {\n\t\treturn false;\n\t}\n\n\tif (!visitorId) {\n\t\treturn true;\n\t}\n\n\tconst targetVisitorId = getTargetVisitorId(event);\n\n\tif (targetVisitorId && targetVisitorId !== visitorId) {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\nexport { getTargetVisitorId };\n"],"mappings":";AAEA,SAAS,mBAAmB,OAAwC;CACnE,MAAM,mBAAmB,MAAM,QAAQ;AAEvC,KAAI,OAAO,qBAAqB,YAAY,iBAAiB,SAAS,EACrE,QAAO;AAGR,KAAI,MAAM,SAAS,uBAAuB;EACzC,MAAM,gBAAgB,MAAM,QAAQ,KAAK;AAEzC,MAAI,OAAO,kBAAkB,YAAY,cAAc,SAAS,EAC/D,QAAO;;AAIT,QAAO;;AAGR,SAAgB,mBACf,OACA,WACA,WACU;AACV,KAAI,aAAa,MAAM,QAAQ,cAAc,UAC5C,QAAO;AAGR,KAAI,CAAC,UACJ,QAAO;CAGR,MAAM,kBAAkB,mBAAmB,MAAM;AAEjD,KAAI,mBAAmB,oBAAoB,UAC1C,QAAO;AAGR,QAAO"}

package/realtime/index.d.ts

@@ -0,0 +1,6 @@
+import { RealtimeAuthConfig, RealtimeContextValue, RealtimeProvider, RealtimeProviderProps, useRealtimeConnection } from "./provider.js";
+import { applyConversationSeenEvent, hydrateConversationSeen, upsertConversationSeen } from "./seen-store.js";
+import { SupportRealtimeProvider } from "./support-provider.js";
+import { applyConversationTypingEvent, clearTypingFromTimelineItem, clearTypingState, setTypingState } from "./typing-store.js";
+import { RealtimeEventHandler, RealtimeEventHandlerEntry, RealtimeEventHandlersMap, RealtimeEventMeta, useRealtime } from "./use-realtime.js";
+export { type RealtimeAuthConfig, type RealtimeContextValue, type RealtimeEventHandler, type RealtimeEventHandlerEntry, type RealtimeEventHandlersMap, type RealtimeEventMeta, RealtimeProvider, type RealtimeProviderProps, SupportRealtimeProvider, applyConversationSeenEvent, applyConversationTypingEvent, clearTypingFromTimelineItem, clearTypingState, hydrateConversationSeen, setTypingState, upsertConversationSeen, useRealtime, useRealtimeConnection };

package/realtime/index.js

@@ -0,0 +1,7 @@
+import { RealtimeProvider, useRealtimeConnection } from "./provider.js";
+import { applyConversationSeenEvent, hydrateConversationSeen, upsertConversationSeen } from "./seen-store.js";
+import { applyConversationTypingEvent, clearTypingFromTimelineItem, clearTypingState, setTypingState } from "./typing-store.js";
+import { useRealtime } from "./use-realtime.js";
+import { SupportRealtimeProvider } from "./support-provider.js";
+
+export { RealtimeProvider, SupportRealtimeProvider, applyConversationSeenEvent, applyConversationTypingEvent, clearTypingFromTimelineItem, clearTypingState, hydrateConversationSeen, setTypingState, upsertConversationSeen, useRealtime, useRealtimeConnection };

package/realtime/provider.d.ts

@@ -0,0 +1,57 @@
+import { AnyRealtimeEvent, RealtimeEvent } from "../realtime-events.js";
+import React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/realtime/provider.d.ts
+type SubscribeHandler = (event: AnyRealtimeEvent) => void;
+type VisitorAuthConfig = {
+  kind: "visitor";
+  visitorId: string | null;
+  websiteId?: string | null;
+  publicKey?: string | null;
+};
+type SessionAuthConfig = {
+  kind: "session";
+  sessionToken: string | null;
+  websiteId?: string | null;
+  userId?: string | null;
+};
+type RealtimeAuthConfig = VisitorAuthConfig | SessionAuthConfig;
+type RealtimeProviderProps = {
+  children: React.ReactNode;
+  wsUrl?: string;
+  auth: RealtimeAuthConfig | null;
+  autoConnect?: boolean;
+  onConnect?: () => void;
+  onDisconnect?: () => void;
+  onError?: (error: Error) => void;
+};
+type RealtimeConnectionState = {
+  isConnected: boolean;
+  isConnecting: boolean;
+  error: Error | null;
+  send: (event: AnyRealtimeEvent) => void;
+  sendRaw: (data: string) => void;
+  subscribe: (handler: SubscribeHandler) => () => void;
+  lastEvent: AnyRealtimeEvent | null;
+  connectionId: string | null;
+  reconnect: () => void;
+};
+type RealtimeContextValue = RealtimeConnectionState & {
+  visitorId: string | null;
+  websiteId: string | null;
+  userId: string | null;
+};
+declare function RealtimeProvider({
+  children,
+  wsUrl,
+  auth,
+  autoConnect,
+  onConnect,
+  onDisconnect,
+  onError
+}: RealtimeProviderProps): react_jsx_runtime0.JSX.Element;
+declare function useRealtimeConnection(): RealtimeContextValue;
+//#endregion
+export { type RealtimeAuthConfig, type RealtimeContextValue, type RealtimeEvent, RealtimeProvider, type RealtimeProviderProps, useRealtimeConnection };
+//# sourceMappingURL=provider.d.ts.map

package/realtime/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","names":[],"sources":["../../src/realtime/provider.tsx"],"sourcesContent":[],"mappings":";;;;;KAuBK,gBAAA,WAA2B;KA+B3B,iBAAA;;EA/BA,SAAA,EAAA,MAAA,GAAgB,IAAA;EA+BhB,SAAA,CAAA,EAAA,MAAA,GAAiB,IAAA;EAOjB,SAAA,CAAA,EAAA,MAAA,GAAiB,IAAA;AAAA,CAAA;KAAjB,iBAAA,GAOkB;MAAG,EAAA,SAAA;cAAoB,EAAA,MAAA,GAAA,IAAA;EAAiB,SAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAW1D,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;CAAqB;KAXrB,kBAAA,GAAqB,iBAYT,GAZ6B,iBAY7B;KADZ,qBAAA,GAGE;UAIY,EANR,KAAA,CAAM,SAME;EAAK,KAAA,CAAA,EAAA,MAAA;EAGnB,IAAA,EAPE,kBAOF,GAAuB,IAAA;EAAA,WAAA,CAAA,EAAA,OAAA;WAGpB,CAAA,EAAA,GAAA,GAAA,IAAA;cACO,CAAA,EAAA,GAAA,GAAA,IAAA;SAEO,CAAA,EAAA,CAAA,KAAA,EATH,KASG,EAAA,GAAA,IAAA;;KANjB,uBAAA,GAOuB;EAKvB,WAAA,EAAA,OAAA;EA2QW,YAAA,EAAA,OAAgB;EAAA,KAAA,EApRxB,KAoRwB,GAAA,IAAA;MAC/B,EAAA,CAAA,KAAA,EApRc,gBAoRd,EAAA,GAAA,IAAA;SACA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA,IAAA;WACA,EAAA,CAAA,OAAA,EApRqB,gBAoRrB,EAAA,GAAA,GAAA,GAAA,IAAA;WACA,EApRW,gBAoRX,GAAA,IAAA;cACA,EAAA,MAAA,GAAA,IAAA;WACA,EAAA,GAAA,GAAA,IAAA;;KAjRI,oBAAA,GAAuB,uBAmRzB,GAAA;WAAqB,EAAA,MAAA,GAAA,IAAA;EAAA,SAAA,EAAA,MAAA,GAAA,IAAA;EAmPR,MAAA,EAAA,MAAA,GAAA,IAAA;;iBA3PA,gBAAA;;;;;;;;GAQb,wBAAqB,kBAAA,CAAA,GAAA,CAAA;iBAmPR,qBAAA,CAAA,GAAyB"}