@cossistant/react 0.0.3 → 0.0.5

package/README.md

@@ -0,0 +1,74 @@
+# Cossistant React SDK
+
+Build fully featured customer support experiences in React with the official `@cossistant/react` package. The SDK wraps the REST and WebSocket APIs, comes with a prebuilt widget, hooks, and UI primitives so you can ship your support quickly and customize later.
+
+> 📚 **New to Cossistant?** Follow the [Quickstart guide](https://cossistant/docs/quickstart) in our official documentation.
+
+## Installation
+
+Pick the command that matches your package manager:
+
+```bash
+bun add @cossistant/react
+# or
+npm install @cossistant/react
+# or
+yarn add @cossistant/react
+```
+
+## Render the widget
+
+```tsx
+import { SupportProvider, Support } from "@cossistant/react";
+
+export function App() {
+  return (
+    <SupportProvider publicKey={process.env.NEXT_PUBLIC_COSSISTANT_KEY}>
+      <Support />
+    </SupportProvider>
+  );
+}
+```
+
+1. Wrap the subtree that should access support data with `SupportProvider` and supply your public key (A Cossistant account is mandatory)
+2. Drop the `Support` component anywhere inside that provider to mount the floating widget.
+3. Optionally pass `defaultOpen`, `quickOptions`, `defaultMessages`, or locale overrides straight into `Support` for instant personalization.
+
+### Identify visitors and seed defaults
+
+Use the helper components to identify a visitor, attach metadata or display different default messages or quick options.
+
+```tsx
+import {
+  IdentifySupportVisitor,
+  Support,
+  SupportConfig,
+  SupportProvider,
+  SenderType,
+} from "@cossistant/react";
+
+export function Dashboard({
+  visitor,
+}: {
+  visitor: { id: string; email: string };
+}) {
+  return (
+    <>
+      <IdentifySupportVisitor externalId={visitor.id} email={visitor.email} />
+      <SupportConfig
+        defaultMessages={[
+          {
+            content:
+              "Welcome in our your dashboard, if you need any help I'm here!",
+            senderType: SenderType.TeamMember,
+          },
+        ]}
+      />
+    </>
+  );
+}
+```
+
+## Need help or spot a typo?
+
+Open an issue in the main repository or start a discussion so we can improve the docs together. Screenshots, reproduction steps, and suggestions are welcome.

package/_virtual/rolldown_runtime.js

@@ -1,5 +1,10 @@
 //#region rolldown:runtime
+var __create = Object.create;
 var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (all) => {
 	let target = {};
 	for (var name in all) __defProp(target, name, {
@@ -8,6 +13,20 @@ var __export = (all) => {
 	});
 	return target;
 };
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
 
 //#endregion
 export { __export };

package/conversation.d.ts

@@ -14,8 +14,10 @@ declare const createConversationResponseSchema: z.ZodObject<{
     type: z.ZodEnum<{
       message: "message";
       event: "event";
+      identification: "identification";
     }>;
     text: z.ZodNullable<z.ZodString>;
+    tool: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
       type: z.ZodLiteral<"text">;
       text: z.ZodString;
@@ -33,6 +35,9 @@ declare const createConversationResponseSchema: z.ZodObject<{
         tag_removed: "tag_removed";
         resolved: "resolved";
         reopened: "reopened";
+        visitor_blocked: "visitor_blocked";
+        visitor_unblocked: "visitor_unblocked";
+        visitor_identified: "visitor_identified";
       }>;
       actorUserId: z.ZodNullable<z.ZodString>;
       actorAiAgentId: z.ZodNullable<z.ZodString>;
@@ -68,10 +73,11 @@ declare const createConversationResponseSchema: z.ZodObject<{
     visitorId: z.ZodString;
     websiteId: z.ZodString;
     status: z.ZodDefault<z.ZodEnum<{
-      resolved: "resolved";
       open: "open";
+      resolved: "resolved";
       spam: "spam";
     }>>;
+    deletedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     lastTimelineItem: z.ZodOptional<z.ZodObject<{
       id: z.ZodOptional<z.ZodString>;
       conversationId: z.ZodString;
@@ -83,8 +89,10 @@ declare const createConversationResponseSchema: z.ZodObject<{
       type: z.ZodEnum<{
         message: "message";
         event: "event";
+        identification: "identification";
       }>;
       text: z.ZodNullable<z.ZodString>;
+      tool: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"text">;
         text: z.ZodString;
@@ -102,6 +110,9 @@ declare const createConversationResponseSchema: z.ZodObject<{
           tag_removed: "tag_removed";
           resolved: "resolved";
           reopened: "reopened";
+          visitor_blocked: "visitor_blocked";
+          visitor_unblocked: "visitor_unblocked";
+          visitor_identified: "visitor_identified";
         }>;
         actorUserId: z.ZodNullable<z.ZodString>;
         actorAiAgentId: z.ZodNullable<z.ZodString>;
@@ -159,10 +170,11 @@ declare const listConversationsResponseSchema: z.ZodObject<{
     visitorId: z.ZodString;
     websiteId: z.ZodString;
     status: z.ZodDefault<z.ZodEnum<{
-      resolved: "resolved";
       open: "open";
+      resolved: "resolved";
       spam: "spam";
     }>>;
+    deletedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     lastTimelineItem: z.ZodOptional<z.ZodObject<{
       id: z.ZodOptional<z.ZodString>;
       conversationId: z.ZodString;
@@ -174,8 +186,10 @@ declare const listConversationsResponseSchema: z.ZodObject<{
       type: z.ZodEnum<{
         message: "message";
         event: "event";
+        identification: "identification";
       }>;
       text: z.ZodNullable<z.ZodString>;
+      tool: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"text">;
         text: z.ZodString;
@@ -193,6 +207,9 @@ declare const listConversationsResponseSchema: z.ZodObject<{
           tag_removed: "tag_removed";
           resolved: "resolved";
           reopened: "reopened";
+          visitor_blocked: "visitor_blocked";
+          visitor_unblocked: "visitor_unblocked";
+          visitor_identified: "visitor_identified";
         }>;
         actorUserId: z.ZodNullable<z.ZodString>;
         actorAiAgentId: z.ZodNullable<z.ZodString>;
@@ -243,10 +260,11 @@ declare const getConversationResponseSchema: z.ZodObject<{
     visitorId: z.ZodString;
     websiteId: z.ZodString;
     status: z.ZodDefault<z.ZodEnum<{
-      resolved: "resolved";
       open: "open";
+      resolved: "resolved";
       spam: "spam";
     }>>;
+    deletedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     lastTimelineItem: z.ZodOptional<z.ZodObject<{
       id: z.ZodOptional<z.ZodString>;
       conversationId: z.ZodString;
@@ -258,8 +276,10 @@ declare const getConversationResponseSchema: z.ZodObject<{
       type: z.ZodEnum<{
         message: "message";
         event: "event";
+        identification: "identification";
       }>;
       text: z.ZodNullable<z.ZodString>;
+      tool: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"text">;
         text: z.ZodString;
@@ -277,6 +297,9 @@ declare const getConversationResponseSchema: z.ZodObject<{
           tag_removed: "tag_removed";
           resolved: "resolved";
           reopened: "reopened";
+          visitor_blocked: "visitor_blocked";
+          visitor_unblocked: "visitor_unblocked";
+          visitor_identified: "visitor_identified";
         }>;
         actorUserId: z.ZodNullable<z.ZodString>;
         actorAiAgentId: z.ZodNullable<z.ZodString>;

package/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","names":[],"sources":["../../types/src/api/conversation.ts"],"sourcesContent":[],"mappings":";;;;cA8Ba,kCAAgC,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAA,CAAA,CAAA;MAAA,IAAA,eAAA,YAAA,CAAA;MASjC,KAAA,YAAA,WAA8B,CAAA,SAAA,YAAA,CAAA;QAAA,IAAA,cAAA,CAAA,MAAA,CAAA;QAClC,IAAA,aAAA;MADuC,CAAA,eAAA,CAAA,aAAA,CAAA;QAAK,IAAA,cAAA,CAAA,OAAA,CAAA;QAIvC,SAAA,WAAA,CA2BV;UAAA,QAAA,EAAA,UAAA;;;;;;;;;;;;;;QA3BwC,YAAA,eAAA,YAAA,CAAA;QAAA,eAAA,eAAA,YAAA,CAAA;QA6B/B,OAAA,eAAwB,cAAA,YAAA,CAAA,CAAA;MAAA,CAAA,eAAA,CAAA,aAAA,CAAA;QAC5B,IAAA,cAAA,CAAA,OAAA,CAAA;QADiC,GAAA,aAAA;QAAK,SAAA,aAAA;QAIjC,QAAA,eAaV,YAAA,CAAA;QAAA,IAAA,eAAA,YAAA,CAAA;;;;;;;;;;;;;;;;;;KAlDS,8BAAA,GAAiC,CAAA,CAAE,aACvC;cAGK,gCAA8B,CAAA,CAAA;;;;;;;;;;;;;;;;;KA6B/B,wBAAA,GAA2B,CAAA,CAAE,aACjC;cAGK,iCAA+B,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAAA,OAAA,eAAA,cAAA,YAAA,CAAA,CAAA;MAAA,CAAA,eAAA,CAAA,aAAA,CAAA;QAehC,IAAA,cAAyB,CAAA,OAAA,CAAA;QAAA,GAAA,aAAA;QAC7B,SAAA,aAAA;QADkC,QAAA,eAAA,YAAA,CAAA;QAAK,IAAA,eAAA,YAAA,CAAA;QAIlC,KAAA,eAQV,YAAA,CAAA;QAAA,MAAA,eAAA,YAAA,CAAA;;;QARsC,GAAA,aAAA;QAAA,SAAA,aAAA;QAU7B,QAAA,eAAsB,YAAA,CAAA;QAAA,IAAA,eAAA,YAAA,CAAA;MAC1B,CAAA,eAAA,CAAA,CAAA,CAAA,CAAA;MAD+B,MAAA,eAAA,YAAA,CAAA;MAAK,SAAA,eAAA,YAAA,CAAA;MAI/B,SAAA,eAMV,YAAA,CAAA;MAAA,SAAA,aAAA;;;;;;;;;;;;KAxBS,yBAAA,GAA4B,CAAA,CAAE,aAClC;cAGK,8BAA4B,CAAA,CAAA;;;KAU7B,sBAAA,GAAyB,CAAA,CAAE,aAC/B;cAGK,+BAA6B,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAAA,SAAA,aAAA;QAAA,QAAA,eAAA,YAAA,CAAA;QAQ9B,IAAA,eAAuB,YAAA,CAAA;MAAA,CAAA,eAAA,CAAA,CAAA,CAAA,CAAA;MAC3B,MAAA,eAAA,YAAA,CAAA;MADgC,SAAA,eAAA,YAAA,CAAA;MAAK,SAAA,eAAA,YAAA,CAAA;;;;;;KAAjC,uBAAA,GAA0B,CAAA,CAAE,aAChC"}
+{"version":3,"file":"conversation.d.ts","names":[],"sources":["../../types/src/api/conversation.ts"],"sourcesContent":[],"mappings":";;;;cA8Ba,kCAAgC,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAA,IAAA,WAAA,CAAA;QAAA,OAAA,EAAA,SAAA;QASjC,KAAA,EAAA,OAAA;QAIC,cAAA,EAAA,gBA2BV;;;;;;;;;;;;;;UA3BwC,gBAAA,EAAA,kBAAA;UAAA,cAAA,EAAA,gBAAA;UA6B/B,gBAAwB,EAAA,kBAC5B;UAGK,SAAA,EAAA,WAaV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAlDS,8BAAA,GAAiC,CAAA,CAAE,aACvC;cAGK,gCAA8B,CAAA,CAAA;;;;;;;;;;;;;;;;;KA6B/B,wBAAA,GAA2B,CAAA,CAAE,aACjC;cAGK,iCAA+B,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAA,UAAA,EAAA,YAAA;UAAA,qBAAA,EAAA,uBAAA;UAehC,kBAAyB,EAAA,oBAC7B;UAGK,gBAQV,EAAA,kBAAA;;;UARsC,SAAA,EAAA,WAAA;UAAA,WAAA,EAAA,aAAA;UAU7B,QAAA,EAAsB,UAAA;UAIrB,QAAA,EAAA,UAMV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAxBS,yBAAA,GAA4B,CAAA,CAAE,aAClC;cAGK,8BAA4B,CAAA,CAAA;;;KAU7B,sBAAA,GAAyB,CAAA,CAAE,aAC/B;cAGK,+BAA6B,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAA,kBAAA,EAAA,oBAAA;UAAA,gBAAA,EAAA,kBAAA;UAQ9B,cAAuB,EAAA,gBAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KADI,uBAAA,GAA0B,CAAA,CAAE,aAChC"}

package/hooks/index.d.ts

@@ -1,6 +1,6 @@
 import { useClientQuery } from "./private/use-client-query.js";
 import { useDefaultMessages } from "./private/use-default-messages.js";
-import { ConversationItem, GroupedMessage, TimelineEventItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, useGroupedMessages } from "./private/use-grouped-messages.js";
+import { ConversationItem, GroupedMessage, TimelineEventItem, TimelineToolItem, UseGroupedMessagesOptions, UseGroupedMessagesProps, useGroupedMessages } from "./private/use-grouped-messages.js";
 import { UseMultimodalInputOptions, UseMultimodalInputReturn, useMultimodalInput } from "./private/use-multimodal-input.js";
 import { UseClientResult, useClient } from "./private/use-rest-client.js";
 import { UseComposerRefocusOptions, UseComposerRefocusReturn, useComposerRefocus } from "./use-composer-refocus.js";
@@ -9,9 +9,11 @@ import { CONVERSATION_AUTO_SEEN_DELAY_MS, UseConversationAutoSeenOptions, useCon
 import { UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, useConversationHistoryPage } from "./use-conversation-history-page.js";
 import { ConversationLifecycleState, UseConversationLifecycleOptions, UseConversationLifecycleReturn, useConversationLifecycle } from "./use-conversation-lifecycle.js";
 import { UseConversationPageOptions, UseConversationPageReturn, useConversationPage } from "./use-conversation-page.js";
-import { useConversationSeen, useDebouncedConversationSeen } from "./use-conversation-seen.js";
 import { UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, useConversationTimelineItems } from "./use-conversation-timeline-items.js";
+import { ConversationPreviewAssignedAgent, ConversationPreviewLastMessage, ConversationPreviewTypingParticipant, ConversationPreviewTypingState, UseConversationPreviewOptions, UseConversationPreviewReturn, useConversationPreview } from "./use-conversation-preview.js";
+import { useConversationSeen, useDebouncedConversationSeen } from "./use-conversation-seen.js";
 import { ConversationTypingParticipant, useConversationTyping } from "./use-conversation-typing.js";
+import { ConversationTimelineTypingParticipant, UseConversationTimelineOptions, UseConversationTimelineReturn, useConversationTimeline } from "./use-conversation-timeline.js";
 import { UseConversationsOptions, UseConversationsResult, useConversations } from "./use-conversations.js";
 import { CreateConversationVariables, UseCreateConversationOptions, UseCreateConversationResult, useCreateConversation } from "./use-create-conversation.js";
 import { UseHomePageOptions, UseHomePageReturn, useHomePage } from "./use-home-page.js";
@@ -20,4 +22,4 @@ import { UseRealtimeSupportOptions, UseRealtimeSupportResult, useRealtimeSupport
 import { SendMessageOptions, SendMessageResult, UseSendMessageOptions, UseSendMessageResult, useSendMessage } from "./use-send-message.js";
 import { UseVisitorReturn, useVisitor } from "./use-visitor.js";
 import { WindowVisibilityFocusState, useWindowVisibilityFocus } from "./use-window-visibility-focus.js";
-export { CONVERSATION_AUTO_SEEN_DELAY_MS, ConversationItem, ConversationLifecycleState, ConversationTypingParticipant, CreateConversationVariables, GroupedMessage, SendMessageOptions, SendMessageResult, TimelineEventItem, UseClientResult, UseComposerRefocusOptions, UseComposerRefocusReturn, UseConversationAutoSeenOptions, UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, UseConversationLifecycleOptions, UseConversationLifecycleReturn, UseConversationOptions, UseConversationPageOptions, UseConversationPageReturn, UseConversationResult, UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, UseConversationsOptions, UseConversationsResult, UseCreateConversationOptions, UseCreateConversationResult, UseGroupedMessagesOptions, UseGroupedMessagesProps, UseHomePageOptions, UseHomePageReturn, UseMessageComposerOptions, UseMessageComposerReturn, UseMultimodalInputOptions, UseMultimodalInputReturn, UseRealtimeSupportOptions, UseRealtimeSupportResult, UseSendMessageOptions, UseSendMessageResult, UseVisitorReturn, WindowVisibilityFocusState, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationSeen, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useRealtimeSupport, useSendMessage, useVisitor, useWindowVisibilityFocus };
+export { CONVERSATION_AUTO_SEEN_DELAY_MS, ConversationItem, ConversationLifecycleState, ConversationPreviewAssignedAgent, ConversationPreviewLastMessage, ConversationPreviewTypingParticipant, ConversationPreviewTypingState, ConversationTimelineTypingParticipant, ConversationTypingParticipant, CreateConversationVariables, GroupedMessage, SendMessageOptions, SendMessageResult, TimelineEventItem, TimelineToolItem, UseClientResult, UseComposerRefocusOptions, UseComposerRefocusReturn, UseConversationAutoSeenOptions, UseConversationHistoryPageOptions, UseConversationHistoryPageReturn, UseConversationLifecycleOptions, UseConversationLifecycleReturn, UseConversationOptions, UseConversationPageOptions, UseConversationPageReturn, UseConversationPreviewOptions, UseConversationPreviewReturn, UseConversationResult, UseConversationTimelineItemsOptions, UseConversationTimelineItemsResult, UseConversationTimelineOptions, UseConversationTimelineReturn, UseConversationsOptions, UseConversationsResult, UseCreateConversationOptions, UseCreateConversationResult, UseGroupedMessagesOptions, UseGroupedMessagesProps, UseHomePageOptions, UseHomePageReturn, UseMessageComposerOptions, UseMessageComposerReturn, UseMultimodalInputOptions, UseMultimodalInputReturn, UseRealtimeSupportOptions, UseRealtimeSupportResult, UseSendMessageOptions, UseSendMessageResult, UseVisitorReturn, WindowVisibilityFocusState, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useRealtimeSupport, useSendMessage, useVisitor, useWindowVisibilityFocus };

package/hooks/index.js

@@ -1,5 +1,6 @@
 import { useClientQuery } from "./private/use-client-query.js";
 import { useClient } from "./private/use-rest-client.js";
+import { useConversation } from "./use-conversation.js";
 import { useWindowVisibilityFocus } from "./use-window-visibility-focus.js";
 import { CONVERSATION_AUTO_SEEN_DELAY_MS, useConversationAutoSeen } from "./use-conversation-auto-seen.js";
 import { useConversationLifecycle } from "./use-conversation-lifecycle.js";
@@ -9,16 +10,17 @@ import { useSendMessage } from "./use-send-message.js";
 import { useMessageComposer } from "./use-message-composer.js";
 import { useConversationPage } from "./use-conversation-page.js";
 import { useGroupedMessages } from "./private/use-grouped-messages.js";
+import { useConversationSeen, useDebouncedConversationSeen } from "./use-conversation-seen.js";
+import { useConversationTyping } from "./use-conversation-typing.js";
+import { useConversationTimeline } from "./use-conversation-timeline.js";
 import { useComposerRefocus } from "./use-composer-refocus.js";
+import { useVisitor } from "./use-visitor.js";
 import { useConversations } from "./use-conversations.js";
 import { useConversationHistoryPage } from "./use-conversation-history-page.js";
+import { useConversationPreview } from "./use-conversation-preview.js";
 import { useHomePage } from "./use-home-page.js";
 import { useDefaultMessages } from "./private/use-default-messages.js";
-import { useConversation } from "./use-conversation.js";
-import { useConversationSeen, useDebouncedConversationSeen } from "./use-conversation-seen.js";
-import { useConversationTyping } from "./use-conversation-typing.js";
 import { useCreateConversation } from "./use-create-conversation.js";
 import { useRealtimeSupport } from "./use-realtime-support.js";
-import { useVisitor } from "./use-visitor.js";
 
-export { CONVERSATION_AUTO_SEEN_DELAY_MS, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationSeen, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useRealtimeSupport, useSendMessage, useVisitor, useWindowVisibilityFocus };
+export { CONVERSATION_AUTO_SEEN_DELAY_MS, useClient, useClientQuery, useComposerRefocus, useConversation, useConversationAutoSeen, useConversationHistoryPage, useConversationLifecycle, useConversationPage, useConversationPreview, useConversationSeen, useConversationTimeline, useConversationTimelineItems, useConversationTyping, useConversations, useCreateConversation, useDebouncedConversationSeen, useDefaultMessages, useGroupedMessages, useHomePage, useMessageComposer, useMultimodalInput, useRealtimeSupport, useSendMessage, useVisitor, useWindowVisibilityFocus };

package/hooks/private/store/use-conversations-store.d.ts

@@ -6,7 +6,15 @@ type ConversationSelection = {
   conversations: Conversation[];
   pagination: ConversationPagination | null;
 };
+/**
+ * Selector hook that exposes the normalized conversations list from the
+ * internal store alongside pagination metadata.
+ */
 declare function useConversationsStore(): ConversationSelection;
+/**
+ * Picks a single conversation entity from the store by id. Returns `null` when
+ * the identifier is missing or the entity has not been fetched yet.
+ */
 declare function useConversationById(conversationId: string | null): Conversation | null;
 //#endregion
 export { useConversationById, useConversationsStore };

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

@@ -1 +1 @@
-{"version":3,"file":"use-conversations-store.d.ts","names":[],"sources":["../../../../src/hooks/private/store/use-conversations-store.ts"],"sourcesContent":[],"mappings":";;;;KAQK,qBAAA;iBACW;EADX,UAAA,EAEQ,sBAFa,GAAA,IAAA;CAAA;AACV,iBAoCA,qBAAA,CAAA,CApCA,EAoCyB,qBApCzB;AACH,iBA2DG,mBAAA,CA3DH,cAAA,EAAA,MAAA,GAAA,IAAA,CAAA,EA6DV,YA7DU,GAAA,IAAA"}
+{"version":3,"file":"use-conversations-store.d.ts","names":[],"sources":["../../../../src/hooks/private/store/use-conversations-store.ts"],"sourcesContent":[],"mappings":";;;;KAQK,qBAAA;iBACW;EADX,UAAA,EAEQ,sBAFa,GACV,IAAA;AAwChB,CAAA;AA4BA;;;;iBA5BgB,qBAAA,CAAA,GAAyB;;;;;iBA4BzB,mBAAA,iCAEb"}

package/hooks/private/store/use-conversations-store.js

@@ -12,6 +12,10 @@ function areSelectionsEqual(a, b) {
 	for (let index = 0; index < a.conversations.length; index += 1) if (a.conversations[index] !== b.conversations[index]) return false;
 	return true;
 }
+/**
+* Selector hook that exposes the normalized conversations list from the
+* internal store alongside pagination metadata.
+*/
 function useConversationsStore() {
 	const { client } = useSupport();
 	if (!client) throw new Error("useConversationsStore requires a configured Cossistant client");
@@ -20,6 +24,10 @@ function useConversationsStore() {
 		pagination: state.pagination
 	}), areSelectionsEqual);
 }
+/**
+* Picks a single conversation entity from the store by id. Returns `null` when
+* the identifier is missing or the entity has not been fetched yet.
+*/
 function useConversationById(conversationId) {
 	const { client } = useSupport();
 	if (!client) throw new Error("useConversationById requires a configured Cossistant client");

package/hooks/private/store/use-conversations-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-conversations-store.js","names":[],"sources":["../../../../src/hooks/private/store/use-conversations-store.ts"],"sourcesContent":["import type {\n\tConversationPagination,\n\tConversationsState,\n} from \"@cossistant/core\";\nimport type { Conversation } from \"@cossistant/types\";\nimport { useSupport } from \"../../../provider\";\nimport { useStoreSelector } from \"./use-store-selector\";\n\ntype ConversationSelection = {\n\tconversations: Conversation[];\n\tpagination: ConversationPagination | null;\n};\n\nfunction areSelectionsEqual(\n\ta: ConversationSelection,\n\tb: ConversationSelection\n): boolean {\n\tif (a === b) {\n\t\treturn true;\n\t}\n\tif (a.pagination !== b.pagination) {\n\t\tif (!(a.pagination && b.pagination)) {\n\t\t\treturn false;\n\t\t}\n\t\tif (\n\t\t\ta.pagination.page !== b.pagination.page ||\n\t\t\ta.pagination.limit !== b.pagination.limit ||\n\t\t\ta.pagination.total !== b.pagination.total ||\n\t\t\ta.pagination.totalPages !== b.pagination.totalPages ||\n\t\t\ta.pagination.hasMore !== b.pagination.hasMore\n\t\t) {\n\t\t\treturn false;\n\t\t}\n\t}\n\tif (a.conversations.length !== b.conversations.length) {\n\t\treturn false;\n\t}\n\tfor (let index = 0; index < a.conversations.length; index += 1) {\n\t\tif (a.conversations[index] !== b.conversations[index]) {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn true;\n}\n\nexport function useConversationsStore(): ConversationSelection {\n\tconst { client } = useSupport();\n\n\tif (!client) {\n\t\tthrow new Error(\n\t\t\t\"useConversationsStore requires a configured Cossistant client\"\n\t\t);\n\t}\n\n\treturn useStoreSelector(\n\t\tclient.conversationsStore,\n\t\t(state: ConversationsState) => ({\n\t\t\tconversations: state.ids\n\t\t\t\t.map((id) => state.byId[id])\n\t\t\t\t.filter(\n\t\t\t\t\t(conversation): conversation is Conversation =>\n\t\t\t\t\t\tconversation !== undefined\n\t\t\t\t),\n\t\t\tpagination: state.pagination,\n\t\t}),\n\t\tareSelectionsEqual\n\t);\n}\n\nexport function useConversationById(\n\tconversationId: string | null\n): Conversation | null {\n\tconst { client } = useSupport();\n\n\tif (!client) {\n\t\tthrow new Error(\n\t\t\t\"useConversationById requires a configured Cossistant client\"\n\t\t);\n\t}\n\n\treturn useStoreSelector(client.conversationsStore, (state) => {\n\t\tif (!conversationId) {\n\t\t\treturn null;\n\t\t}\n\t\treturn state.byId[conversationId] ?? null;\n\t});\n}\n"],"mappings":";;;;AAaA,SAAS,mBACR,GACA,GACU;AACV,KAAI,MAAM,EACT,QAAO;AAER,KAAI,EAAE,eAAe,EAAE,YAAY;AAClC,MAAI,EAAE,EAAE,cAAc,EAAE,YACvB,QAAO;AAER,MACC,EAAE,WAAW,SAAS,EAAE,WAAW,QACnC,EAAE,WAAW,UAAU,EAAE,WAAW,SACpC,EAAE,WAAW,UAAU,EAAE,WAAW,SACpC,EAAE,WAAW,eAAe,EAAE,WAAW,cACzC,EAAE,WAAW,YAAY,EAAE,WAAW,QAEtC,QAAO;;AAGT,KAAI,EAAE,cAAc,WAAW,EAAE,cAAc,OAC9C,QAAO;AAER,MAAK,IAAI,QAAQ,GAAG,QAAQ,EAAE,cAAc,QAAQ,SAAS,EAC5D,KAAI,EAAE,cAAc,WAAW,EAAE,cAAc,OAC9C,QAAO;AAGT,QAAO;;AAGR,SAAgB,wBAA+C;CAC9D,MAAM,EAAE,WAAW,YAAY;AAE/B,KAAI,CAAC,OACJ,OAAM,IAAI,MACT,gEACA;AAGF,QAAO,iBACN,OAAO,qBACN,WAA+B;EAC/B,eAAe,MAAM,IACnB,KAAK,OAAO,MAAM,KAAK,IAAI,CAC3B,QACC,iBACA,iBAAiB,OAClB;EACF,YAAY,MAAM;EAClB,GACD,mBACA;;AAGF,SAAgB,oBACf,gBACsB;CACtB,MAAM,EAAE,WAAW,YAAY;AAE/B,KAAI,CAAC,OACJ,OAAM,IAAI,MACT,8DACA;AAGF,QAAO,iBAAiB,OAAO,qBAAqB,UAAU;AAC7D,MAAI,CAAC,eACJ,QAAO;AAER,SAAO,MAAM,KAAK,mBAAmB;GACpC"}
+{"version":3,"file":"use-conversations-store.js","names":[],"sources":["../../../../src/hooks/private/store/use-conversations-store.ts"],"sourcesContent":["import type {\n\tConversationPagination,\n\tConversationsState,\n} from \"@cossistant/core\";\nimport type { Conversation } from \"@cossistant/types\";\nimport { useSupport } from \"../../../provider\";\nimport { useStoreSelector } from \"./use-store-selector\";\n\ntype ConversationSelection = {\n\tconversations: Conversation[];\n\tpagination: ConversationPagination | null;\n};\n\nfunction areSelectionsEqual(\n\ta: ConversationSelection,\n\tb: ConversationSelection\n): boolean {\n\tif (a === b) {\n\t\treturn true;\n\t}\n\tif (a.pagination !== b.pagination) {\n\t\tif (!(a.pagination && b.pagination)) {\n\t\t\treturn false;\n\t\t}\n\t\tif (\n\t\t\ta.pagination.page !== b.pagination.page ||\n\t\t\ta.pagination.limit !== b.pagination.limit ||\n\t\t\ta.pagination.total !== b.pagination.total ||\n\t\t\ta.pagination.totalPages !== b.pagination.totalPages ||\n\t\t\ta.pagination.hasMore !== b.pagination.hasMore\n\t\t) {\n\t\t\treturn false;\n\t\t}\n\t}\n\tif (a.conversations.length !== b.conversations.length) {\n\t\treturn false;\n\t}\n\tfor (let index = 0; index < a.conversations.length; index += 1) {\n\t\tif (a.conversations[index] !== b.conversations[index]) {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn true;\n}\n\n/**\n * Selector hook that exposes the normalized conversations list from the\n * internal store alongside pagination metadata.\n */\nexport function useConversationsStore(): ConversationSelection {\n\tconst { client } = useSupport();\n\n\tif (!client) {\n\t\tthrow new Error(\n\t\t\t\"useConversationsStore requires a configured Cossistant client\"\n\t\t);\n\t}\n\n\treturn useStoreSelector(\n\t\tclient.conversationsStore,\n\t\t(state: ConversationsState) => ({\n\t\t\tconversations: state.ids\n\t\t\t\t.map((id) => state.byId[id])\n\t\t\t\t.filter(\n\t\t\t\t\t(conversation): conversation is Conversation =>\n\t\t\t\t\t\tconversation !== undefined\n\t\t\t\t),\n\t\t\tpagination: state.pagination,\n\t\t}),\n\t\tareSelectionsEqual\n\t);\n}\n\n/**\n * Picks a single conversation entity from the store by id. Returns `null` when\n * the identifier is missing or the entity has not been fetched yet.\n */\nexport function useConversationById(\n\tconversationId: string | null\n): Conversation | null {\n\tconst { client } = useSupport();\n\n\tif (!client) {\n\t\tthrow new Error(\n\t\t\t\"useConversationById requires a configured Cossistant client\"\n\t\t);\n\t}\n\n\treturn useStoreSelector(client.conversationsStore, (state) => {\n\t\tif (!conversationId) {\n\t\t\treturn null;\n\t\t}\n\t\treturn state.byId[conversationId] ?? null;\n\t});\n}\n"],"mappings":";;;;AAaA,SAAS,mBACR,GACA,GACU;AACV,KAAI,MAAM,EACT,QAAO;AAER,KAAI,EAAE,eAAe,EAAE,YAAY;AAClC,MAAI,EAAE,EAAE,cAAc,EAAE,YACvB,QAAO;AAER,MACC,EAAE,WAAW,SAAS,EAAE,WAAW,QACnC,EAAE,WAAW,UAAU,EAAE,WAAW,SACpC,EAAE,WAAW,UAAU,EAAE,WAAW,SACpC,EAAE,WAAW,eAAe,EAAE,WAAW,cACzC,EAAE,WAAW,YAAY,EAAE,WAAW,QAEtC,QAAO;;AAGT,KAAI,EAAE,cAAc,WAAW,EAAE,cAAc,OAC9C,QAAO;AAER,MAAK,IAAI,QAAQ,GAAG,QAAQ,EAAE,cAAc,QAAQ,SAAS,EAC5D,KAAI,EAAE,cAAc,WAAW,EAAE,cAAc,OAC9C,QAAO;AAGT,QAAO;;;;;;AAOR,SAAgB,wBAA+C;CAC9D,MAAM,EAAE,WAAW,YAAY;AAE/B,KAAI,CAAC,OACJ,OAAM,IAAI,MACT,gEACA;AAGF,QAAO,iBACN,OAAO,qBACN,WAA+B;EAC/B,eAAe,MAAM,IACnB,KAAK,OAAO,MAAM,KAAK,IAAI,CAC3B,QACC,iBACA,iBAAiB,OAClB;EACF,YAAY,MAAM;EAClB,GACD,mBACA;;;;;;AAOF,SAAgB,oBACf,gBACsB;CACtB,MAAM,EAAE,WAAW,YAAY;AAE/B,KAAI,CAAC,OACJ,OAAM,IAAI,MACT,8DACA;AAGF,QAAO,iBAAiB,OAAO,qBAAqB,UAAU;AAC7D,MAAI,CAAC,eACJ,QAAO;AAER,SAAO,MAAM,KAAK,mBAAmB;GACpC"}

package/hooks/private/store/use-store-selector.d.ts

@@ -4,6 +4,10 @@ type BasicStore<TState> = {
   getState(): TState;
   subscribe(listener: Subscription<TState>): () => void;
 };
+/**
+ * React hook that bridges Zustand-like stores with React components by
+ * memoizing selector results and resubscribing when dependencies change.
+ */
 declare function useStoreSelector<TState, TSelected>(store: BasicStore<TState>, selector: (state: TState) => TSelected, isEqual?: (previous: TSelected, next: TSelected) => boolean): TSelected;
 //#endregion
 export { useStoreSelector };

package/hooks/private/store/use-store-selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-store-selector.d.ts","names":[],"sources":["../../../../src/hooks/private/store/use-store-selector.ts"],"sourcesContent":[],"mappings":";KAEK,+BAA+B;KAE/B,UAFA,CAAA,MAAY,CAAA,GAAA;EAEZ,QAAA,EAAA,EACQ,MADE;EAAA,SAAA,CAAA,QAAA,EAEM,YAFN,CAEmB,MAFnB,CAAA,CAAA,EAAA,GAAA,GAAA,IAAA;;AAEmB,iBAGlB,gBAHkB,CAAA,MAAA,EAAA,SAAA,CAAA,CAAA,KAAA,EAI1B,UAJ0B,CAIf,MAJe,CAAA,EAAA,QAAA,EAAA,CAAA,KAAA,EAKf,MALe,EAAA,GAKJ,SALI,EAAA,OAAA,CAAA,EAAA,CAAA,QAAA,EAMb,SANa,EAAA,IAAA,EAMI,SANJ,EAAA,GAAA,OAAA,CAAA,EAO/B,SAP+B"}
+{"version":3,"file":"use-store-selector.d.ts","names":[],"sources":["../../../../src/hooks/private/store/use-store-selector.ts"],"sourcesContent":[],"mappings":";KAEK,+BAA+B;KAE/B,UAFA,CAAA,MAAY,CAAA,GAAA;EAEZ,QAAA,EAAA,EACQ,MADE;EACF,SAAA,CAAA,QAAA,EACQ,YADR,CACqB,MADrB,CAAA,CAAA,EAAA,GAAA,GAAA,IAAA;CACqB;;;AAOlC;;AACQ,iBADQ,gBACR,CAAA,MAAA,EAAA,SAAA,CAAA,CAAA,KAAA,EAAA,UAAA,CAAW,MAAX,CAAA,EAAA,QAAA,EAAA,CAAA,KAAA,EACW,MADX,EAAA,GACsB,SADtB,EAAA,OAAA,CAAA,EAAA,CAAA,QAAA,EAEa,SAFb,EAAA,IAAA,EAE8B,SAF9B,EAAA,GAAA,OAAA,CAAA,EAGL,SAHK"}

package/hooks/private/store/use-store-selector.js

@@ -1,13 +1,16 @@
 import { useRef, useSyncExternalStore } from "react";
 
 //#region src/hooks/private/store/use-store-selector.ts
+/**
+* React hook that bridges Zustand-like stores with React components by
+* memoizing selector results and resubscribing when dependencies change.
+*/
 function useStoreSelector(store, 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);
+	const selected = selector(useSyncExternalStore(subscribe, () => store.getState(), () => store.getState()));
 	if (selectionRef.current === void 0 || !isEqual(selectionRef.current, selected)) selectionRef.current = selected;
 	return selectionRef.current;
 }

package/hooks/private/store/use-store-selector.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-store-selector.js","names":[],"sources":["../../../../src/hooks/private/store/use-store-selector.ts"],"sourcesContent":["import { useRef, useSyncExternalStore } from \"react\";\n\ntype Subscription<TState> = (state: TState) => void;\n\ntype BasicStore<TState> = {\n\tgetState(): TState;\n\tsubscribe(listener: Subscription<TState>): () => void;\n};\n\nexport function useStoreSelector<TState, TSelected>(\n\tstore: BasicStore<TState>,\n\tselector: (state: TState) => TSelected,\n\tisEqual: (previous: TSelected, next: TSelected) => boolean = 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\t() => store.getState(),\n\t\t() => store.getState()\n\t);\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"],"mappings":";;;AASA,SAAgB,iBACf,OACA,UACA,UAA6D,OAAO,IACxD;CACZ,MAAM,eAAe,OAAkB,OAAU;CAEjD,MAAM,aAAa,kBAClB,MAAM,gBAAgB;AACrB,iBAAe;GACd;CAEH,MAAM,WAAW,qBAChB,iBACM,MAAM,UAAU,QAChB,MAAM,UAAU,CACtB;CACD,MAAM,WAAW,SAAS,SAAS;AAEnC,KACC,aAAa,YAAY,UACzB,CAAC,QAAQ,aAAa,SAAS,SAAS,CAExC,cAAa,UAAU;AAGxB,QAAO,aAAa"}
+{"version":3,"file":"use-store-selector.js","names":[],"sources":["../../../../src/hooks/private/store/use-store-selector.ts"],"sourcesContent":["import { useRef, useSyncExternalStore } from \"react\";\n\ntype Subscription<TState> = (state: TState) => void;\n\ntype BasicStore<TState> = {\n\tgetState(): TState;\n\tsubscribe(listener: Subscription<TState>): () => void;\n};\n\n/**\n * React hook that bridges Zustand-like stores with React components by\n * memoizing selector results and resubscribing when dependencies change.\n */\nexport function useStoreSelector<TState, TSelected>(\n\tstore: BasicStore<TState>,\n\tselector: (state: TState) => TSelected,\n\tisEqual: (previous: TSelected, next: TSelected) => boolean = 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\t() => store.getState(),\n\t\t() => store.getState()\n\t);\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"],"mappings":";;;;;;;AAaA,SAAgB,iBACf,OACA,UACA,UAA6D,OAAO,IACxD;CACZ,MAAM,eAAe,OAAkB,OAAU;CAEjD,MAAM,aAAa,kBAClB,MAAM,gBAAgB;AACrB,iBAAe;GACd;CAOH,MAAM,WAAW,SALA,qBAChB,iBACM,MAAM,UAAU,QAChB,MAAM,UAAU,CACtB,CACkC;AAEnC,KACC,aAAa,YAAY,UACzB,CAAC,QAAQ,aAAa,SAAS,SAAS,CAExC,cAAa,UAAU;AAGxB,QAAO,aAAa"}

package/hooks/private/store/use-website-store.d.ts

@@ -12,6 +12,10 @@ type UseWebsiteStoreOptions = {
   refetchInterval?: number | false;
   refetchOnWindowFocus?: boolean;
 };
+/**
+ * Subscribes to the shared website store on the SDK client and exposes
+ * convenient loading/error state plus a manual refresh helper.
+ */
 declare function useWebsiteStore(client: CossistantClient, options?: UseWebsiteStoreOptions): UseWebsiteStoreResult;
 //#endregion
 export { UseWebsiteStoreOptions, UseWebsiteStoreResult, useWebsiteStore };

package/hooks/private/store/use-website-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-website-store.d.ts","names":[],"sources":["../../../../src/hooks/private/store/use-website-store.ts"],"sourcesContent":[],"mappings":";;;KAgBY,qBAAA;WACF;EADE,MAAA,EAEH,YAFG,CAAA,QAAqB,CAAA;EAAA,SAAA,EAAA,OAAA;OACvB,EAGF,KAHE,GAAA,IAAA;SACD,EAAA,GAAA,GAGO,OAHP,CAGe,YAHf,CAAA,SAAA,CAAA,GAAA,IAAA,CAAA;;AAGe,KAGZ,sBAAA,GAHY;iBAAR,CAAA,EAAA,MAAA,GAAA,KAAA;EAAO,oBAAA,CAAA,EAAA,OAAA;AAGvB,CAAA;AAiBgB,iBAAA,eAAA,CAAe,MAAA,EACtB,gBADsB,EAAA,OAAA,CAAA,EAErB,sBAFqB,CAAA,EAG5B,qBAH4B"}
+{"version":3,"file":"use-website-store.d.ts","names":[],"sources":["../../../../src/hooks/private/store/use-website-store.ts"],"sourcesContent":[],"mappings":";;;KAgBY,qBAAA;WACF;EADE,MAAA,EAEH,YAFG,CAAA,QAAqB,CAAA;EACvB,SAAA,EAAA,OAAA;EACD,KAAA,EAED,KAFC,GAAA,IAAA;EAED,OAAA,EAAA,GAAA,GACQ,OADR,CACgB,YADhB,CAAA,SAAA,CAAA,GAAA,IAAA,CAAA;CACgB;AAAR,KAGJ,sBAAA,GAHI;EAAO,eAAA,CAAA,EAAA,MAAA,GAAA,KAAA;EAGX,oBAAA,CAAA,EAAA,OAAsB;AAqBlC,CAAA;;;;;iBAAgB,eAAA,SACP,4BACC,yBACP"}

package/hooks/private/store/use-website-store.js

@@ -8,11 +8,14 @@ function toError(state, fallback) {
 	if (!state.error) return null;
 	return new Error(state.error.message);
 }
+/**
+* Subscribes to the shared website store on the SDK client and exposes
+* convenient loading/error state plus a manual refresh helper.
+*/
 function useWebsiteStore(client, options = {}) {
-	const store = client.websiteStore ?? (() => {
+	const state = useStoreSelector(client.websiteStore ?? (() => {
 		throw new Error("Website store is not available on the client instance");
-	})();
-	const state = useStoreSelector(store, (current) => current);
+	})(), (current) => current);
 	const query = useClientQuery({
 		client,
 		queryFn: (instance, params) => instance.fetchWebsite(params ?? {}),

package/hooks/private/store/use-website-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-website-store.js","names":[],"sources":["../../../../src/hooks/private/store/use-website-store.ts"],"sourcesContent":["import type {\n\tCossistantClient,\n\tWebsiteState,\n\tWebsiteStore,\n} from \"@cossistant/core\";\nimport type { PublicWebsiteResponse } from \"@cossistant/types\";\nimport { useMemo } from \"react\";\nimport { useClientQuery } from \"../use-client-query\";\nimport { useStoreSelector } from \"./use-store-selector\";\n\nconst EMPTY_STATE: WebsiteState = {\n\twebsite: null,\n\tstatus: \"idle\",\n\terror: null,\n};\n\nexport type UseWebsiteStoreResult = {\n\twebsite: WebsiteState[\"website\"];\n\tstatus: WebsiteState[\"status\"];\n\tisLoading: boolean;\n\terror: Error | null;\n\trefresh: () => Promise<WebsiteState[\"website\"] | null>;\n};\n\nexport type UseWebsiteStoreOptions = {\n\trefetchInterval?: number | false;\n\trefetchOnWindowFocus?: boolean;\n};\n\nfunction toError(state: WebsiteState, fallback: Error | null): Error | null {\n\tif (fallback) {\n\t\treturn fallback;\n\t}\n\n\tif (!state.error) {\n\t\treturn null;\n\t}\n\n\treturn new Error(state.error.message);\n}\n\nexport function useWebsiteStore(\n\tclient: CossistantClient,\n\toptions: UseWebsiteStoreOptions = {}\n): UseWebsiteStoreResult {\n\tconst store =\n\t\tclient.websiteStore ??\n\t\t((): WebsiteStore => {\n\t\t\tthrow new Error(\"Website store is not available on the client instance\");\n\t\t})();\n\tconst state = useStoreSelector(store, (current) => current);\n\n\tconst query = useClientQuery<PublicWebsiteResponse, { force?: boolean }>({\n\t\tclient,\n\t\tqueryFn: (instance, params) => instance.fetchWebsite(params ?? {}),\n\t\tenabled: true,\n\t\trefetchInterval: options.refetchInterval ?? false,\n\t\trefetchOnWindowFocus: options.refetchOnWindowFocus ?? true,\n\t\trefetchOnMount: state.status === \"idle\",\n\t\tinitialData: state.website ?? undefined,\n\t});\n\n\tconst error = useMemo(\n\t\t() => toError(state, query.error),\n\t\t[state, query.error]\n\t);\n\tconst isLoading =\n\t\tquery.isLoading || state.status === \"loading\" || state.status === \"idle\";\n\n\tconst refresh = () =>\n\t\tquery\n\t\t\t.refetch({ force: true })\n\t\t\t.then((result) => result ?? client.websiteStore.getState().website)\n\t\t\t.catch(() => client.websiteStore.getState().website)\n\t\t\t.then((website) => website ?? null);\n\n\treturn {\n\t\twebsite: state.website,\n\t\tstatus: state.status,\n\t\tisLoading,\n\t\terror,\n\t\trefresh,\n\t};\n}\n"],"mappings":";;;;;AA6BA,SAAS,QAAQ,OAAqB,UAAsC;AAC3E,KAAI,SACH,QAAO;AAGR,KAAI,CAAC,MAAM,MACV,QAAO;AAGR,QAAO,IAAI,MAAM,MAAM,MAAM,QAAQ;;AAGtC,SAAgB,gBACf,QACA,UAAkC,EAAE,EACZ;CACxB,MAAM,QACL,OAAO,uBACc;AACpB,QAAM,IAAI,MAAM,wDAAwD;KACrE;CACL,MAAM,QAAQ,iBAAiB,QAAQ,YAAY,QAAQ;CAE3D,MAAM,QAAQ,eAA2D;EACxE;EACA,UAAU,UAAU,WAAW,SAAS,aAAa,UAAU,EAAE,CAAC;EAClE,SAAS;EACT,iBAAiB,QAAQ,mBAAmB;EAC5C,sBAAsB,QAAQ,wBAAwB;EACtD,gBAAgB,MAAM,WAAW;EACjC,aAAa,MAAM,WAAW;EAC9B,CAAC;CAEF,MAAM,QAAQ,cACP,QAAQ,OAAO,MAAM,MAAM,EACjC,CAAC,OAAO,MAAM,MAAM,CACpB;CACD,MAAM,YACL,MAAM,aAAa,MAAM,WAAW,aAAa,MAAM,WAAW;CAEnE,MAAM,gBACL,MACE,QAAQ,EAAE,OAAO,MAAM,CAAC,CACxB,MAAM,WAAW,UAAU,OAAO,aAAa,UAAU,CAAC,QAAQ,CAClE,YAAY,OAAO,aAAa,UAAU,CAAC,QAAQ,CACnD,MAAM,YAAY,WAAW,KAAK;AAErC,QAAO;EACN,SAAS,MAAM;EACf,QAAQ,MAAM;EACd;EACA;EACA;EACA"}
+{"version":3,"file":"use-website-store.js","names":[],"sources":["../../../../src/hooks/private/store/use-website-store.ts"],"sourcesContent":["import type {\n\tCossistantClient,\n\tWebsiteState,\n\tWebsiteStore,\n} from \"@cossistant/core\";\nimport type { PublicWebsiteResponse } from \"@cossistant/types\";\nimport { useMemo } from \"react\";\nimport { useClientQuery } from \"../use-client-query\";\nimport { useStoreSelector } from \"./use-store-selector\";\n\nconst EMPTY_STATE: WebsiteState = {\n\twebsite: null,\n\tstatus: \"idle\",\n\terror: null,\n};\n\nexport type UseWebsiteStoreResult = {\n\twebsite: WebsiteState[\"website\"];\n\tstatus: WebsiteState[\"status\"];\n\tisLoading: boolean;\n\terror: Error | null;\n\trefresh: () => Promise<WebsiteState[\"website\"] | null>;\n};\n\nexport type UseWebsiteStoreOptions = {\n\trefetchInterval?: number | false;\n\trefetchOnWindowFocus?: boolean;\n};\n\nfunction toError(state: WebsiteState, fallback: Error | null): Error | null {\n\tif (fallback) {\n\t\treturn fallback;\n\t}\n\n\tif (!state.error) {\n\t\treturn null;\n\t}\n\n\treturn new Error(state.error.message);\n}\n\n/**\n * Subscribes to the shared website store on the SDK client and exposes\n * convenient loading/error state plus a manual refresh helper.\n */\nexport function useWebsiteStore(\n\tclient: CossistantClient,\n\toptions: UseWebsiteStoreOptions = {}\n): UseWebsiteStoreResult {\n\tconst store =\n\t\tclient.websiteStore ??\n\t\t((): WebsiteStore => {\n\t\t\tthrow new Error(\"Website store is not available on the client instance\");\n\t\t})();\n\tconst state = useStoreSelector(store, (current) => current);\n\n\tconst query = useClientQuery<PublicWebsiteResponse, { force?: boolean }>({\n\t\tclient,\n\t\tqueryFn: (instance, params) => instance.fetchWebsite(params ?? {}),\n\t\tenabled: true,\n\t\trefetchInterval: options.refetchInterval ?? false,\n\t\trefetchOnWindowFocus: options.refetchOnWindowFocus ?? true,\n\t\trefetchOnMount: state.status === \"idle\",\n\t\tinitialData: state.website ?? undefined,\n\t});\n\n\tconst error = useMemo(\n\t\t() => toError(state, query.error),\n\t\t[state, query.error]\n\t);\n\tconst isLoading =\n\t\tquery.isLoading || state.status === \"loading\" || state.status === \"idle\";\n\n\tconst refresh = () =>\n\t\tquery\n\t\t\t.refetch({ force: true })\n\t\t\t.then((result) => result ?? client.websiteStore.getState().website)\n\t\t\t.catch(() => client.websiteStore.getState().website)\n\t\t\t.then((website) => website ?? null);\n\n\treturn {\n\t\twebsite: state.website,\n\t\tstatus: state.status,\n\t\tisLoading,\n\t\terror,\n\t\trefresh,\n\t};\n}\n"],"mappings":";;;;;AA6BA,SAAS,QAAQ,OAAqB,UAAsC;AAC3E,KAAI,SACH,QAAO;AAGR,KAAI,CAAC,MAAM,MACV,QAAO;AAGR,QAAO,IAAI,MAAM,MAAM,MAAM,QAAQ;;;;;;AAOtC,SAAgB,gBACf,QACA,UAAkC,EAAE,EACZ;CAMxB,MAAM,QAAQ,iBAJb,OAAO,uBACc;AACpB,QAAM,IAAI,MAAM,wDAAwD;KACrE,GACkC,YAAY,QAAQ;CAE3D,MAAM,QAAQ,eAA2D;EACxE;EACA,UAAU,UAAU,WAAW,SAAS,aAAa,UAAU,EAAE,CAAC;EAClE,SAAS;EACT,iBAAiB,QAAQ,mBAAmB;EAC5C,sBAAsB,QAAQ,wBAAwB;EACtD,gBAAgB,MAAM,WAAW;EACjC,aAAa,MAAM,WAAW;EAC9B,CAAC;CAEF,MAAM,QAAQ,cACP,QAAQ,OAAO,MAAM,MAAM,EACjC,CAAC,OAAO,MAAM,MAAM,CACpB;CACD,MAAM,YACL,MAAM,aAAa,MAAM,WAAW,aAAa,MAAM,WAAW;CAEnE,MAAM,gBACL,MACE,QAAQ,EAAE,OAAO,MAAM,CAAC,CACxB,MAAM,WAAW,UAAU,OAAO,aAAa,UAAU,CAAC,QAAQ,CAClE,YAAY,OAAO,aAAa,UAAU,CAAC,QAAQ,CACnD,MAAM,YAAY,WAAW,KAAK;AAErC,QAAO;EACN,SAAS,MAAM;EACf,QAAQ,MAAM;EACd;EACA;EACA;EACA"}

package/hooks/private/typing.d.ts

@@ -0,0 +1,35 @@
+import { SupportTextResolvedFormatter } from "../../support/text/locales/keys.js";
+import { TypingEntry } from "@cossistant/core";
+import { AvailableAIAgent, AvailableHumanAgent } from "@cossistant/types";
+
+//#region src/hooks/private/typing.d.ts
+type TimelineTypingParticipant = {
+  id: string;
+  type: "team_member" | "ai";
+};
+type PreviewTypingParticipant = TimelineTypingParticipant & {
+  name: string;
+  image: string | null;
+};
+type MapTypingEntriesToPreviewParticipantsOptions = {
+  availableHumanAgents: AvailableHumanAgent[];
+  availableAIAgents: AvailableAIAgent[];
+  text: SupportTextResolvedFormatter;
+};
+/**
+ * Converts raw typing events into participants understood by the timeline
+ * renderer.
+ */
+declare function mapTypingEntriesToParticipants(entries: TypingEntry[]): TimelineTypingParticipant[];
+/**
+ * Resolves typing events into fully hydrated preview participants with display
+ * names and avatars ready for UI consumption.
+ */
+declare function mapTypingEntriesToPreviewParticipants(entries: TypingEntry[], {
+  availableHumanAgents,
+  availableAIAgents,
+  text
+}: MapTypingEntriesToPreviewParticipantsOptions): PreviewTypingParticipant[];
+//#endregion
+export { MapTypingEntriesToPreviewParticipantsOptions, PreviewTypingParticipant, TimelineTypingParticipant, mapTypingEntriesToParticipants, mapTypingEntriesToPreviewParticipants };
+//# sourceMappingURL=typing.d.ts.map

package/hooks/private/typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.d.ts","names":[],"sources":["../../../src/hooks/private/typing.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,yBAAA;;EAAA,IAAA,EAAA,aAAA,GAAA,IAAA;AAKZ,CAAA;AAKY,KALA,wBAAA,GAA2B,yBAKiB,GAAA;EACjC,IAAA,EAAA,MAAA;EACH,KAAA,EAAA,MAAA,GAAA,IAAA;CACb;AAA4B,KAHvB,4CAAA,GAGuB;EAOnB,oBAAA,EATO,mBASuB,EAAA;EA+B9B,iBAAA,EAvCI,gBAuCJ,EAAA;EACN,IAAA,EAvCH,4BAuCG;CAER;;;;;AAIyB,iBAtCX,8BAAA,CAsCW,OAAA,EArCjB,WAqCiB,EAAA,CAAA,EApCxB,yBAoCwB,EAAA;;;;;iBAPX,qCAAA,UACN;;;;GAKN,+CACD"}

package/hooks/private/typing.js

@@ -0,0 +1,49 @@
+//#region src/hooks/private/typing.ts
+/**
+* Converts raw typing events into participants understood by the timeline
+* renderer.
+*/
+function mapTypingEntriesToParticipants(entries) {
+	return entries.map((entry) => {
+		if (entry.actorType === "user") return {
+			id: entry.actorId,
+			type: "team_member"
+		};
+		if (entry.actorType === "ai_agent") return {
+			id: entry.actorId,
+			type: "ai"
+		};
+		return null;
+	}).filter((participant) => participant !== null);
+}
+/**
+* Resolves typing events into fully hydrated preview participants with display
+* names and avatars ready for UI consumption.
+*/
+function mapTypingEntriesToPreviewParticipants(entries, { availableHumanAgents, availableAIAgents, text }) {
+	return entries.map((entry) => {
+		if (entry.actorType === "user") {
+			const human = availableHumanAgents.find((agent) => agent.id === entry.actorId);
+			return {
+				id: entry.actorId,
+				type: "team_member",
+				name: human?.name || text("common.fallbacks.supportTeam"),
+				image: human?.image ?? null
+			};
+		}
+		if (entry.actorType === "ai_agent") {
+			const ai = availableAIAgents.find((agent) => agent.id === entry.actorId);
+			return {
+				id: entry.actorId,
+				type: "ai",
+				name: ai?.name || text("common.fallbacks.aiAssistant"),
+				image: ai?.image ?? null
+			};
+		}
+		return null;
+	}).filter((participant) => participant !== null);
+}
+
+//#endregion
+export { mapTypingEntriesToParticipants, mapTypingEntriesToPreviewParticipants };
+//# sourceMappingURL=typing.js.map

package/hooks/private/typing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.js","names":[],"sources":["../../../src/hooks/private/typing.ts"],"sourcesContent":["import type { TypingEntry } from \"@cossistant/core\";\nimport type { AvailableAIAgent, AvailableHumanAgent } from \"@cossistant/types\";\nimport type { SupportTextResolvedFormatter } from \"../../support/text/locales/keys\";\n\nexport type TimelineTypingParticipant = {\n\tid: string;\n\ttype: \"team_member\" | \"ai\";\n};\n\nexport type PreviewTypingParticipant = TimelineTypingParticipant & {\n\tname: string;\n\timage: string | null;\n};\n\nexport type MapTypingEntriesToPreviewParticipantsOptions = {\n\tavailableHumanAgents: AvailableHumanAgent[];\n\tavailableAIAgents: AvailableAIAgent[];\n\ttext: SupportTextResolvedFormatter;\n};\n\n/**\n * Converts raw typing events into participants understood by the timeline\n * renderer.\n */\nexport function mapTypingEntriesToParticipants(\n\tentries: TypingEntry[]\n): TimelineTypingParticipant[] {\n\treturn entries\n\t\t.map<TimelineTypingParticipant | null>((entry) => {\n\t\t\tif (entry.actorType === \"user\") {\n\t\t\t\treturn {\n\t\t\t\t\tid: entry.actorId,\n\t\t\t\t\ttype: \"team_member\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (entry.actorType === \"ai_agent\") {\n\t\t\t\treturn {\n\t\t\t\t\tid: entry.actorId,\n\t\t\t\t\ttype: \"ai\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn null;\n\t\t})\n\t\t.filter(\n\t\t\t(participant): participant is TimelineTypingParticipant =>\n\t\t\t\tparticipant !== null\n\t\t);\n}\n\n/**\n * Resolves typing events into fully hydrated preview participants with display\n * names and avatars ready for UI consumption.\n */\nexport function mapTypingEntriesToPreviewParticipants(\n\tentries: TypingEntry[],\n\t{\n\t\tavailableHumanAgents,\n\t\tavailableAIAgents,\n\t\ttext,\n\t}: MapTypingEntriesToPreviewParticipantsOptions\n): PreviewTypingParticipant[] {\n\treturn entries\n\t\t.map<PreviewTypingParticipant | null>((entry) => {\n\t\t\tif (entry.actorType === \"user\") {\n\t\t\t\tconst human = availableHumanAgents.find(\n\t\t\t\t\t(agent) => agent.id === entry.actorId\n\t\t\t\t);\n\n\t\t\t\treturn {\n\t\t\t\t\tid: entry.actorId,\n\t\t\t\t\ttype: \"team_member\",\n\t\t\t\t\tname: human?.name || text(\"common.fallbacks.supportTeam\"),\n\t\t\t\t\timage: human?.image ?? null,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (entry.actorType === \"ai_agent\") {\n\t\t\t\tconst ai = availableAIAgents.find(\n\t\t\t\t\t(agent) => agent.id === entry.actorId\n\t\t\t\t);\n\n\t\t\t\treturn {\n\t\t\t\t\tid: entry.actorId,\n\t\t\t\t\ttype: \"ai\",\n\t\t\t\t\tname: ai?.name || text(\"common.fallbacks.aiAssistant\"),\n\t\t\t\t\timage: ai?.image ?? null,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn null;\n\t\t})\n\t\t.filter(\n\t\t\t(participant): participant is PreviewTypingParticipant =>\n\t\t\t\tparticipant !== null\n\t\t);\n}\n"],"mappings":";;;;;AAwBA,SAAgB,+BACf,SAC8B;AAC9B,QAAO,QACL,KAAuC,UAAU;AACjD,MAAI,MAAM,cAAc,OACvB,QAAO;GACN,IAAI,MAAM;GACV,MAAM;GACN;AAGF,MAAI,MAAM,cAAc,WACvB,QAAO;GACN,IAAI,MAAM;GACV,MAAM;GACN;AAGF,SAAO;GACN,CACD,QACC,gBACA,gBAAgB,KACjB;;;;;;AAOH,SAAgB,sCACf,SACA,EACC,sBACA,mBACA,QAE4B;AAC7B,QAAO,QACL,KAAsC,UAAU;AAChD,MAAI,MAAM,cAAc,QAAQ;GAC/B,MAAM,QAAQ,qBAAqB,MACjC,UAAU,MAAM,OAAO,MAAM,QAC9B;AAED,UAAO;IACN,IAAI,MAAM;IACV,MAAM;IACN,MAAM,OAAO,QAAQ,KAAK,+BAA+B;IACzD,OAAO,OAAO,SAAS;IACvB;;AAGF,MAAI,MAAM,cAAc,YAAY;GACnC,MAAM,KAAK,kBAAkB,MAC3B,UAAU,MAAM,OAAO,MAAM,QAC9B;AAED,UAAO;IACN,IAAI,MAAM;IACV,MAAM;IACN,MAAM,IAAI,QAAQ,KAAK,+BAA+B;IACtD,OAAO,IAAI,SAAS;IACpB;;AAGF,SAAO;GACN,CACD,QACC,gBACA,gBAAgB,KACjB"}

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

@@ -19,6 +19,11 @@ type UseClientQueryResult<TData, TArgs> = {
   isLoading: boolean;
   refetch: (args?: TArgs) => Promise<TData | undefined>;
 };
+/**
+ * Lightweight data-fetching abstraction that plugs into the SDK client instead
+ * of React Query. It tracks loading/error state, supports polling, window
+ * focus refetching and exposes a typed refetch helper.
+ */
 declare function useClientQuery<TData, TArgs = void>(options: UseClientQueryOptions<TData, TArgs>): UseClientQueryResult<TData, TArgs>;
 //#endregion
 export { useClientQuery };

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

@@ -1 +1 @@
-{"version":3,"file":"use-client-query.d.ts","names":[],"sources":["../../../src/hooks/private/use-client-query.ts"],"sourcesContent":[],"mappings":";;;KAGK,iCACI,yBACD,sBACH,QAAQ;KAER;EALA,MAAA,EAMI,gBANG;EAAA,OAAA,EAOF,OAPE,CAOM,KAPN,EAOa,KAPb,CAAA;SACH,CAAA,EAAA,OAAA;iBACD,CAAA,EAAA,MAAA,GAAA,KAAA;sBACK,CAAA,EAAA,OAAA;gBAAR,CAAA,EAAA,OAAA;EAAO,WAAA,CAAA,EASG,KATH;EAEP,WAAA,CAAA,EAQU,KARV;EAAqB,YAAA,CAAA,EAAA,SAAA,OAAA,EAAA;;KAYrB,oBAVa,CAAA,KAAA,EAAA,KAAA,CAAA,GAAA;MAAO,EAWlB,KAXkB,GAAA,SAAA;OAAf,EAYF,KAZE,GAAA,IAAA;WAKK,EAAA,OAAA;SACA,EAAA,CAAA,IAAA,CAAA,EAQG,KARH,EAAA,GAQa,OARb,CAQqB,KARrB,GAAA,SAAA,CAAA;CAAK;AAIf,iBAiBW,cAjBS,CAAA,KAAA,EAAA,QAAA,IAAA,CAAA,CAAA,OAAA,EAkBf,qBAlBe,CAkBO,KAlBP,EAkBc,KAlBd,CAAA,CAAA,EAmBtB,oBAnBsB,CAmBD,KAnBC,EAmBM,KAnBN,CAAA"}
+{"version":3,"file":"use-client-query.d.ts","names":[],"sources":["../../../src/hooks/private/use-client-query.ts"],"sourcesContent":[],"mappings":";;;KAGK,iCACI,yBACD,sBACH,QAAQ;KAER;EALA,MAAA,EAMI,gBANG;EACH,OAAA,EAMC,OAND,CAMS,KANT,EAMgB,KANhB,CAAA;EACD,OAAA,CAAA,EAAA,OAAA;EACK,eAAA,CAAA,EAAA,MAAA,GAAA,KAAA;EAAR,oBAAA,CAAA,EAAA,OAAA;EAAO,cAAA,CAAA,EAAA,OAAA;EAEP,WAAA,CAAA,EAOU,KAPV;EACI,WAAA,CAAA,EAOM,KAPN;EACS,YAAA,CAAA,EAAA,SAAA,OAAA,EAAA;CAAO;KAUpB,oBAVK,CAAA,KAAA,EAAA,KAAA,CAAA,GAAA;EAKK,IAAA,EAMR,KANQ,GAAA,SAAA;EACA,KAAA,EAMP,KANO,GAAA,IAAA;EAAK,SAAA,EAAA,OAAA;EAIf,OAAA,EAAA,CAAA,IAAA,CAAA,EAIa,KAJb,EAAoB,GAIG,OAJH,CAIW,KAJX,GAAA,SAAA,CAAA;CAClB;;;;;;AAqBS,iBAAA,cAAc,CAAA,KAAA,EAAA,QAAA,IAAA,CAAA,CAAA,OAAA,EACpB,qBADoB,CACE,KADF,EACS,KADT,CAAA,CAAA,EAE3B,oBAF2B,CAEN,KAFM,EAEC,KAFD,CAAA"}

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

@@ -6,6 +6,11 @@ function toError(error) {
 	return new Error(typeof error === "string" ? error : "Unknown error");
 }
 const EMPTY_DEPENDENCIES = [];
+/**
+* Lightweight data-fetching abstraction that plugs into the SDK client instead
+* of React Query. It tracks loading/error state, supports polling, window
+* focus refetching and exposes a typed refetch helper.
+*/
 function useClientQuery(options) {
 	const { client, queryFn, enabled = true, refetchInterval = false, refetchOnWindowFocus = true, refetchOnMount = true, initialData, initialArgs, dependencies = EMPTY_DEPENDENCIES } = options;
 	const [data, setData] = useState(initialData);