@cossistant/react 0.0.26 → 0.0.28

package/support/components/typing-indicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typing-indicator.d.ts","names":[],"sources":["../../../src/support/components/typing-indicator.tsx"],"sourcesContent":[],"mappings":";;;;KAKY,qBAAA;KAEA,iBAAA;EAFA,EAAA,EAAA,MAAA;EAEA,IAAA,EAEL,qBAFsB;AAK7B,CAAA;AAAwD,KAA5C,oBAAA,GAAuB,OAAA,CAAM,cAAe,CAAA,cAAA,CAAA,GAAA;EAArB,YAAM,EAC1B,iBAD0B,EAAA;EAC1B,iBAAA,CAAA,EACM,gBADN,EAAA;EACM,oBAAA,CAAA,EACG,mBADH,EAAA;EACG,WAAA,CAAA,EAAA,OAAA;CAAmB;AAI9B,cAAA,YAAgB,EAAA,CAAA;EAAA;CAIzB,EAAM;EAuBG,SAAA,CAAA,EAAA,MAuDZ;CAvD2B,EAAA,GAvBxB,OAAA,CAAM,YAuBkB;AAAA,cAAf,eAAe,EAAA,OAAA,CAAA,yBAAA,CAAA,OAAA,CAAA,cAAA,CAAA,cAAA,CAAA,GAAA;EAjCb,YAAA,EAAA,iBAAA,EAAA;EACM,iBAAA,CAAA,EAAA,gBAAA,EAAA;EACG,oBAAA,CAAA,EAAA,mBAAA,EAAA"}
+{"version":3,"file":"typing-indicator.d.ts","names":[],"sources":["../../../src/support/components/typing-indicator.tsx"],"sourcesContent":[],"mappings":";;;;KAKY,qBAAA;KAEA,iBAAA;EAFA,EAAA,EAAA,MAAA;EAEA,IAAA,EAEL,qBAFsB;AAK7B,CAAA;AAAwD,KAA5C,oBAAA,GAAuB,OAAA,CAAM,cAAe,CAAA,cAAA,CAAA,GAAA;EAArB,YAAM,EAC1B,iBAD0B,EAAA;EAC1B,iBAAA,CAAA,EACM,gBADN,EAAA;EACM,oBAAA,CAAA,EACG,mBADH,EAAA;EACG,WAAA,CAAA,EAAA,OAAA;CAAmB;AAI9B,cAAA,YAAgB,EAAA,CAAA;EAAA;CAIzB,EAAM;EAuBG,SAAA,CAAA,EAAA,MAwDZ;CAxD2B,EAAA,GAvBxB,OAAA,CAAM,YAuBkB;AAAA,cAAf,eAAe,EAAA,OAAA,CAAA,yBAAA,CAAA,OAAA,CAAA,cAAA,CAAA,cAAA,CAAA,GAAA;EAjCb,YAAA,EAAA,iBAAA,EAAA;EACM,iBAAA,CAAA,EAAA,gBAAA,EAAA;EACG,oBAAA,CAAA,EAAA,mBAAA,EAAA"}

package/support/components/typing-indicator.js

@@ -24,6 +24,7 @@ const TypingIndicator = React$1.forwardRef(({ participants, availableAIAgents =
 		...props,
 		children: [withAvatars && /* @__PURE__ */ jsx(AvatarStack, {
 			aiAgents: typingAIAgents,
+			hideDefaultAIAgent: typingAIAgents.length === 0,
 			humanAgents: typingHumanAgents,
 			size: 24,
 			spacing: 16

package/support/components/typing-indicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"typing-indicator.js","names":["React"],"sources":["../../../src/support/components/typing-indicator.tsx"],"sourcesContent":["import type { AvailableAIAgent, AvailableHumanAgent } from \"@cossistant/types\";\nimport * as React from \"react\";\nimport { cn } from \"../utils\";\nimport { AvatarStack } from \"./avatar-stack\";\n\nexport type TypingParticipantType = \"visitor\" | \"team_member\" | \"ai\";\n\nexport type TypingParticipant = {\n\tid: string;\n\ttype: TypingParticipantType;\n};\n\nexport type TypingIndicatorProps = React.HTMLAttributes<HTMLDivElement> & {\n\tparticipants: TypingParticipant[];\n\tavailableAIAgents?: AvailableAIAgent[];\n\tavailableHumanAgents?: AvailableHumanAgent[];\n\twithAvatars?: boolean;\n};\n\nexport const BouncingDots = ({\n\tclassName,\n}: {\n\tclassName?: string;\n}): React.ReactElement => (\n\t<div className=\"flex gap-1\">\n\t\t<span\n\t\t\tclassName={cn(\n\t\t\t\t\"dot-bounce-1 size-1 rounded-full bg-co-primary\",\n\t\t\t\tclassName\n\t\t\t)}\n\t\t/>\n\t\t<span\n\t\t\tclassName={cn(\n\t\t\t\t\"dot-bounce-2 size-1 rounded-full bg-co-primary\",\n\t\t\t\tclassName\n\t\t\t)}\n\t\t/>\n\t\t<span\n\t\t\tclassName={cn(\n\t\t\t\t\"dot-bounce-3 size-1 rounded-full bg-co-primary\",\n\t\t\t\tclassName\n\t\t\t)}\n\t\t/>\n\t</div>\n);\n\nexport const TypingIndicator = React.forwardRef<\n\tHTMLDivElement,\n\tTypingIndicatorProps\n>(\n\t(\n\t\t{\n\t\t\tparticipants,\n\t\t\tavailableAIAgents = [],\n\t\t\tavailableHumanAgents = [],\n\t\t\twithAvatars = true,\n\t\t\tclassName,\n\t\t\t...props\n\t\t},\n\t\tref\n\t) => {\n\t\tif (!participants || participants.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\t// Separate AI and human participants\n\t\tconst humanParticipantIds = participants\n\t\t\t.filter((p) => p.type === \"team_member\")\n\t\t\t.map((p) => p.id);\n\n\t\tconst aiParticipantIds = participants\n\t\t\t.filter((p) => p.type === \"ai\")\n\t\t\t.map((p) => p.id);\n\n\t\t// Get matching agents\n\t\tconst typingHumanAgents = availableHumanAgents.filter((agent) =>\n\t\t\thumanParticipantIds.includes(agent.id)\n\t\t);\n\n\t\tconst typingAIAgents = availableAIAgents.filter((agent) =>\n\t\t\taiParticipantIds.includes(agent.id)\n\t\t);\n\n\t\treturn (\n\t\t\t<div\n\t\t\t\tclassName={cn(\"flex items-center gap-6\", className)}\n\t\t\t\tref={ref}\n\t\t\t\t{...props}\n\t\t\t>\n\t\t\t\t{withAvatars && (\n\t\t\t\t\t<AvatarStack\n\t\t\t\t\t\taiAgents={typingAIAgents}\n\t\t\t\t\t\thumanAgents={typingHumanAgents}\n\t\t\t\t\t\tsize={24}\n\t\t\t\t\t\tspacing={16}\n\t\t\t\t\t/>\n\t\t\t\t)}\n\t\t\t\t<BouncingDots />\n\t\t\t</div>\n\t\t);\n\t}\n);\n\nTypingIndicator.displayName = \"TypingIndicator\";\n"],"mappings":";;;;;;AAmBA,MAAa,gBAAgB,EAC5B,gBAIA,qBAAC;CAAI,WAAU;;EACd,oBAAC,UACA,WAAW,GACV,kDACA,UACA,GACA;EACF,oBAAC,UACA,WAAW,GACV,kDACA,UACA,GACA;EACF,oBAAC,UACA,WAAW,GACV,kDACA,UACA,GACA;;EACG;AAGP,MAAa,kBAAkBA,QAAM,YAKnC,EACC,cACA,oBAAoB,EAAE,EACtB,uBAAuB,EAAE,EACzB,cAAc,MACd,UACA,GAAG,SAEJ,QACI;AACJ,KAAI,CAAC,gBAAgB,aAAa,WAAW,EAC5C,QAAO;CAIR,MAAM,sBAAsB,aAC1B,QAAQ,MAAM,EAAE,SAAS,cAAc,CACvC,KAAK,MAAM,EAAE,GAAG;CAElB,MAAM,mBAAmB,aACvB,QAAQ,MAAM,EAAE,SAAS,KAAK,CAC9B,KAAK,MAAM,EAAE,GAAG;CAGlB,MAAM,oBAAoB,qBAAqB,QAAQ,UACtD,oBAAoB,SAAS,MAAM,GAAG,CACtC;CAED,MAAM,iBAAiB,kBAAkB,QAAQ,UAChD,iBAAiB,SAAS,MAAM,GAAG,CACnC;AAED,QACC,qBAAC;EACA,WAAW,GAAG,2BAA2B,UAAU;EAC9C;EACL,GAAI;aAEH,eACA,oBAAC;GACA,UAAU;GACV,aAAa;GACb,MAAM;GACN,SAAS;IACR,EAEH,oBAAC,iBAAe;GACX;EAGR;AAED,gBAAgB,cAAc"}
+{"version":3,"file":"typing-indicator.js","names":["React"],"sources":["../../../src/support/components/typing-indicator.tsx"],"sourcesContent":["import type { AvailableAIAgent, AvailableHumanAgent } from \"@cossistant/types\";\nimport * as React from \"react\";\nimport { cn } from \"../utils\";\nimport { AvatarStack } from \"./avatar-stack\";\n\nexport type TypingParticipantType = \"visitor\" | \"team_member\" | \"ai\";\n\nexport type TypingParticipant = {\n\tid: string;\n\ttype: TypingParticipantType;\n};\n\nexport type TypingIndicatorProps = React.HTMLAttributes<HTMLDivElement> & {\n\tparticipants: TypingParticipant[];\n\tavailableAIAgents?: AvailableAIAgent[];\n\tavailableHumanAgents?: AvailableHumanAgent[];\n\twithAvatars?: boolean;\n};\n\nexport const BouncingDots = ({\n\tclassName,\n}: {\n\tclassName?: string;\n}): React.ReactElement => (\n\t<div className=\"flex gap-1\">\n\t\t<span\n\t\t\tclassName={cn(\n\t\t\t\t\"dot-bounce-1 size-1 rounded-full bg-co-primary\",\n\t\t\t\tclassName\n\t\t\t)}\n\t\t/>\n\t\t<span\n\t\t\tclassName={cn(\n\t\t\t\t\"dot-bounce-2 size-1 rounded-full bg-co-primary\",\n\t\t\t\tclassName\n\t\t\t)}\n\t\t/>\n\t\t<span\n\t\t\tclassName={cn(\n\t\t\t\t\"dot-bounce-3 size-1 rounded-full bg-co-primary\",\n\t\t\t\tclassName\n\t\t\t)}\n\t\t/>\n\t</div>\n);\n\nexport const TypingIndicator = React.forwardRef<\n\tHTMLDivElement,\n\tTypingIndicatorProps\n>(\n\t(\n\t\t{\n\t\t\tparticipants,\n\t\t\tavailableAIAgents = [],\n\t\t\tavailableHumanAgents = [],\n\t\t\twithAvatars = true,\n\t\t\tclassName,\n\t\t\t...props\n\t\t},\n\t\tref\n\t) => {\n\t\tif (!participants || participants.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\t// Separate AI and human participants\n\t\tconst humanParticipantIds = participants\n\t\t\t.filter((p) => p.type === \"team_member\")\n\t\t\t.map((p) => p.id);\n\n\t\tconst aiParticipantIds = participants\n\t\t\t.filter((p) => p.type === \"ai\")\n\t\t\t.map((p) => p.id);\n\n\t\t// Get matching agents\n\t\tconst typingHumanAgents = availableHumanAgents.filter((agent) =>\n\t\t\thumanParticipantIds.includes(agent.id)\n\t\t);\n\n\t\tconst typingAIAgents = availableAIAgents.filter((agent) =>\n\t\t\taiParticipantIds.includes(agent.id)\n\t\t);\n\n\t\treturn (\n\t\t\t<div\n\t\t\t\tclassName={cn(\"flex items-center gap-6\", className)}\n\t\t\t\tref={ref}\n\t\t\t\t{...props}\n\t\t\t>\n\t\t\t\t{withAvatars && (\n\t\t\t\t\t<AvatarStack\n\t\t\t\t\t\taiAgents={typingAIAgents}\n\t\t\t\t\t\thideDefaultAIAgent={typingAIAgents.length === 0}\n\t\t\t\t\t\thumanAgents={typingHumanAgents}\n\t\t\t\t\t\tsize={24}\n\t\t\t\t\t\tspacing={16}\n\t\t\t\t\t/>\n\t\t\t\t)}\n\t\t\t\t<BouncingDots />\n\t\t\t</div>\n\t\t);\n\t}\n);\n\nTypingIndicator.displayName = \"TypingIndicator\";\n"],"mappings":";;;;;;AAmBA,MAAa,gBAAgB,EAC5B,gBAIA,qBAAC;CAAI,WAAU;;EACd,oBAAC,UACA,WAAW,GACV,kDACA,UACA,GACA;EACF,oBAAC,UACA,WAAW,GACV,kDACA,UACA,GACA;EACF,oBAAC,UACA,WAAW,GACV,kDACA,UACA,GACA;;EACG;AAGP,MAAa,kBAAkBA,QAAM,YAKnC,EACC,cACA,oBAAoB,EAAE,EACtB,uBAAuB,EAAE,EACzB,cAAc,MACd,UACA,GAAG,SAEJ,QACI;AACJ,KAAI,CAAC,gBAAgB,aAAa,WAAW,EAC5C,QAAO;CAIR,MAAM,sBAAsB,aAC1B,QAAQ,MAAM,EAAE,SAAS,cAAc,CACvC,KAAK,MAAM,EAAE,GAAG;CAElB,MAAM,mBAAmB,aACvB,QAAQ,MAAM,EAAE,SAAS,KAAK,CAC9B,KAAK,MAAM,EAAE,GAAG;CAGlB,MAAM,oBAAoB,qBAAqB,QAAQ,UACtD,oBAAoB,SAAS,MAAM,GAAG,CACtC;CAED,MAAM,iBAAiB,kBAAkB,QAAQ,UAChD,iBAAiB,SAAS,MAAM,GAAG,CACnC;AAED,QACC,qBAAC;EACA,WAAW,GAAG,2BAA2B,UAAU;EAC9C;EACL,GAAI;aAEH,eACA,oBAAC;GACA,UAAU;GACV,oBAAoB,eAAe,WAAW;GAC9C,aAAa;GACb,MAAM;GACN,SAAS;IACR,EAEH,oBAAC,iBAAe;GACX;EAGR;AAED,gBAAgB,cAAc"}

package/support/context/controlled-state.d.ts

@@ -0,0 +1,46 @@
+import * as React$1 from "react";
+
+//#region src/support/context/controlled-state.d.ts
+
+/**
+ * Controlled state context for the Support widget.
+ * Allows external control of widget open/close state.
+ */
+type ControlledStateContextValue = {
+  /**
+   * Controlled open state (undefined = uncontrolled)
+   */
+  open: boolean | undefined;
+  /**
+   * Callback when open state should change
+   */
+  onOpenChange: ((open: boolean) => void) | undefined;
+  /**
+   * Whether the component is in controlled mode
+   */
+  isControlled: boolean;
+};
+type ControlledStateProviderProps = {
+  /**
+   * Controlled open state
+   */
+  open?: boolean;
+  /**
+   * Callback when open state changes
+   */
+  onOpenChange?: (open: boolean) => void;
+  children: React$1.ReactNode;
+};
+/**
+ * Provider for controlled widget state.
+ * Wraps the Support component to enable controlled mode.
+ */
+declare const ControlledStateProvider: React$1.FC<ControlledStateProviderProps>;
+/**
+ * Access controlled state context.
+ * Returns null if not inside a ControlledStateProvider.
+ */
+declare function useControlledState(): ControlledStateContextValue | null;
+//#endregion
+export { ControlledStateContextValue, ControlledStateProvider, ControlledStateProviderProps, useControlledState };
+//# sourceMappingURL=controlled-state.d.ts.map

package/support/context/controlled-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlled-state.d.ts","names":[],"sources":["../../../src/support/context/controlled-state.tsx"],"sourcesContent":[],"mappings":";;;;;;AAQA;AAkBA;AAgBa,KAlCD,2BAAA,GAmDX;EAMe;;;;;;;;;;;;;KAvCJ,4BAAA;;;;;;;;;YASD,OAAA,CAAM;;;;;;cAOJ,yBAAyB,OAAA,CAAM,GAC3C;;;;;iBAsBe,kBAAA,CAAA,GAAsB"}

package/support/context/controlled-state.js

@@ -0,0 +1,34 @@
+"use client";
+
+
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/controlled-state.tsx
+const ControlledStateContext = React$1.createContext(null);
+/**
+* Provider for controlled widget state.
+* Wraps the Support component to enable controlled mode.
+*/
+const ControlledStateProvider = ({ open, onOpenChange, children }) => {
+	const value = React$1.useMemo(() => ({
+		open,
+		onOpenChange,
+		isControlled: open !== void 0
+	}), [open, onOpenChange]);
+	return /* @__PURE__ */ jsx(ControlledStateContext.Provider, {
+		value,
+		children
+	});
+};
+/**
+* Access controlled state context.
+* Returns null if not inside a ControlledStateProvider.
+*/
+function useControlledState() {
+	return React$1.useContext(ControlledStateContext);
+}
+
+//#endregion
+export { ControlledStateProvider, useControlledState };
+//# sourceMappingURL=controlled-state.js.map

package/support/context/controlled-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlled-state.js","names":["React","ControlledStateProvider: React.FC<\n\tControlledStateProviderProps\n>"],"sources":["../../../src/support/context/controlled-state.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\n\n/**\n * Controlled state context for the Support widget.\n * Allows external control of widget open/close state.\n */\nexport type ControlledStateContextValue = {\n\t/**\n\t * Controlled open state (undefined = uncontrolled)\n\t */\n\topen: boolean | undefined;\n\t/**\n\t * Callback when open state should change\n\t */\n\tonOpenChange: ((open: boolean) => void) | undefined;\n\t/**\n\t * Whether the component is in controlled mode\n\t */\n\tisControlled: boolean;\n};\n\nconst ControlledStateContext =\n\tReact.createContext<ControlledStateContextValue | null>(null);\n\nexport type ControlledStateProviderProps = {\n\t/**\n\t * Controlled open state\n\t */\n\topen?: boolean;\n\t/**\n\t * Callback when open state changes\n\t */\n\tonOpenChange?: (open: boolean) => void;\n\tchildren: React.ReactNode;\n};\n\n/**\n * Provider for controlled widget state.\n * Wraps the Support component to enable controlled mode.\n */\nexport const ControlledStateProvider: React.FC<\n\tControlledStateProviderProps\n> = ({ open, onOpenChange, children }) => {\n\tconst value = React.useMemo<ControlledStateContextValue>(\n\t\t() => ({\n\t\t\topen,\n\t\t\tonOpenChange,\n\t\t\tisControlled: open !== undefined,\n\t\t}),\n\t\t[open, onOpenChange]\n\t);\n\n\treturn (\n\t\t<ControlledStateContext.Provider value={value}>\n\t\t\t{children}\n\t\t</ControlledStateContext.Provider>\n\t);\n};\n\n/**\n * Access controlled state context.\n * Returns null if not inside a ControlledStateProvider.\n */\nexport function useControlledState(): ControlledStateContextValue | null {\n\treturn React.useContext(ControlledStateContext);\n}\n"],"mappings":";;;;;;;AAuBA,MAAM,yBACLA,QAAM,cAAkD,KAAK;;;;;AAkB9D,MAAaC,2BAER,EAAE,MAAM,cAAc,eAAe;CACzC,MAAM,QAAQD,QAAM,eACZ;EACN;EACA;EACA,cAAc,SAAS;EACvB,GACD,CAAC,MAAM,aAAa,CACpB;AAED,QACC,oBAAC,uBAAuB;EAAgB;EACtC;GACgC;;;;;;AAQpC,SAAgB,qBAAyD;AACxE,QAAOA,QAAM,WAAW,uBAAuB"}

package/support/context/events.d.ts

@@ -0,0 +1,103 @@
+import { TimelineItem } from "../../timeline-item.js";
+import * as React$1 from "react";
+import { Conversation } from "@cossistant/types";
+
+//#region src/support/context/events.d.ts
+type SupportEventType = "conversationStart" | "conversationEnd" | "messageSent" | "messageReceived" | "error";
+type ConversationStartEvent = {
+  type: "conversationStart";
+  conversationId: string;
+  conversation?: Conversation;
+};
+type ConversationEndEvent = {
+  type: "conversationEnd";
+  conversationId: string;
+  conversation?: Conversation;
+};
+type MessageSentEvent = {
+  type: "messageSent";
+  conversationId: string;
+  message: TimelineItem;
+};
+type MessageReceivedEvent = {
+  type: "messageReceived";
+  conversationId: string;
+  message: TimelineItem;
+};
+type ErrorEvent = {
+  type: "error";
+  error: Error;
+  context?: string;
+};
+type SupportEvent = ConversationStartEvent | ConversationEndEvent | MessageSentEvent | MessageReceivedEvent | ErrorEvent;
+type SupportEventCallbacks = {
+  /**
+   * Called when a new conversation is started.
+   */
+  onConversationStart?: (event: ConversationStartEvent) => void;
+  /**
+   * Called when a conversation ends (resolved, closed, etc.).
+   */
+  onConversationEnd?: (event: ConversationEndEvent) => void;
+  /**
+   * Called when the visitor sends a message.
+   */
+  onMessageSent?: (event: MessageSentEvent) => void;
+  /**
+   * Called when a message is received from an agent (human or AI).
+   */
+  onMessageReceived?: (event: MessageReceivedEvent) => void;
+  /**
+   * Called when an error occurs.
+   */
+  onError?: (event: ErrorEvent) => void;
+};
+type SupportEventsContextValue = {
+  /**
+   * Emit an event to all registered callbacks.
+   */
+  emit: <T extends SupportEvent>(event: T) => void;
+  /**
+   * Subscribe to a specific event type.
+   * Returns an unsubscribe function.
+   */
+  subscribe: <T extends SupportEventType>(type: T, callback: (event: Extract<SupportEvent, {
+    type: T;
+  }>) => void) => () => void;
+};
+type SupportEventsProviderProps = SupportEventCallbacks & {
+  children: React$1.ReactNode;
+};
+/**
+ * Provider for support widget events.
+ * Allows listening to lifecycle events like message sent/received,
+ * conversation start/end, and errors.
+ *
+ * @example
+ * <Support
+ *   onMessageSent={({ message }) => console.log("Sent:", message)}
+ *   onMessageReceived={({ message }) => console.log("Received:", message)}
+ *   onConversationStart={({ conversationId }) => console.log("Started:", conversationId)}
+ *   onError={({ error }) => console.error("Error:", error)}
+ * />
+ */
+declare const SupportEventsProvider: React$1.FC<SupportEventsProviderProps>;
+/**
+ * Access the events context.
+ * Returns null if not inside a SupportEventsProvider.
+ */
+declare function useSupportEvents(): SupportEventsContextValue | null;
+/**
+ * Hook to emit events from within the widget.
+ * Safe to use outside of provider (will no-op).
+ */
+declare function useSupportEventEmitter(): {
+  emitConversationStart: (conversationId: string, conversation?: Conversation) => void;
+  emitConversationEnd: (conversationId: string, conversation?: Conversation) => void;
+  emitMessageSent: (conversationId: string, message: TimelineItem) => void;
+  emitMessageReceived: (conversationId: string, message: TimelineItem) => void;
+  emitError: (error: Error, context?: string) => void;
+};
+//#endregion
+export { ConversationEndEvent, ConversationStartEvent, ErrorEvent, MessageReceivedEvent, MessageSentEvent, SupportEvent, SupportEventCallbacks, SupportEventType, SupportEventsContextValue, SupportEventsProvider, SupportEventsProviderProps, useSupportEventEmitter, useSupportEvents };
+//# sourceMappingURL=events.d.ts.map

package/support/context/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../../../src/support/context/events.tsx"],"sourcesContent":[],"mappings":";;;;;KAUY,gBAAA;KAOA,sBAAA;EAPA,IAAA,EAAA,mBAAgB;EAOhB,cAAA,EAAA,MAAA;EAMA,YAAA,CAAA,EAHI,YAGgB;AAMhC,CAAA;AAMY,KAZA,oBAAA,GAYoB;EAMpB,IAAA,EAAA,iBAAU;EAMV,cAAA,EAAY,MAAA;EACrB,YAAA,CAAA,EAtBa,YAsBb;CACA;AACA,KArBS,gBAAA,GAqBT;EACA,IAAA,EAAA,aAAA;EACA,cAAA,EAAA,MAAA;EAAU,OAAA,EApBH,YAoBG;AAMb,CAAA;AAI+B,KA3BnB,oBAAA,GA2BmB;EAIF,IAAA,EAAA,iBAAA;EAIJ,cAAA,EAAA,MAAA;EAII,OAAA,EApCnB,YAoCmB;CAIV;AAAU,KArCjB,UAAA,GAqCiB;EAOjB,IAAA,EAAA,OAAA;EAIM,KAAA,EA9CV,KA8CU;EAAqB,OAAA,CAAA,EAAA,MAAA;CAKhB;AACf,KAhDI,YAAA,GACT,sBA+CK,GA9CL,oBA8CK,GA7CL,gBA6CK,GA5CL,oBA4CK,GA3CL,UA2CK;AACoB,KAtChB,qBAAA,GAsCgB;EAAsB;;;EAOtC,mBAAA,CAAA,EAAA,CAAA,KAAA,EAzCmB,sBAyCU,EAAA,GAAA,IAAA;EAiB5B;AA0Gb;AAQA;EAOmB,iBAAA,CAAA,EAAA,CAAA,KAAA,EA/KU,oBA+KV,EAAA,GAAA,IAAA;EAUA;;;EAsBG,aAAA,CAAA,EAAA,CAAA,KAAA,EA3MG,gBA2MH,EAAA,GAAA,IAAA;EAAK;;;8BAvME;;;;oBAIV;;KAOP,yBAAA;;;;mBAIM,qBAAqB;;;;;wBAKhB,wBACf,qBACY,QAAQ;UAAsB;;;KAOtC,0BAAA,GAA6B;YAC9B,OAAA,CAAM;;;;;;;;;;;;;;;cAgBJ,uBAAuB,OAAA,CAAM,GAAG;;;;;iBA0G7B,gBAAA,CAAA,GAAoB;;;;;iBAQpB,sBAAA,CAAA;iEAOG;+DAUA;qDAQmC;yDAOI;qBAOpC"}

package/support/context/events.js

@@ -0,0 +1,139 @@
+"use client";
+
+
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/events.tsx
+const SupportEventsContext = React$1.createContext(null);
+/**
+* Provider for support widget events.
+* Allows listening to lifecycle events like message sent/received,
+* conversation start/end, and errors.
+*
+* @example
+* <Support
+*   onMessageSent={({ message }) => console.log("Sent:", message)}
+*   onMessageReceived={({ message }) => console.log("Received:", message)}
+*   onConversationStart={({ conversationId }) => console.log("Started:", conversationId)}
+*   onError={({ error }) => console.error("Error:", error)}
+* />
+*/
+const SupportEventsProvider = ({ onConversationStart, onConversationEnd, onMessageSent, onMessageReceived, onError, children }) => {
+	const callbacksRef = React$1.useRef({
+		onConversationStart,
+		onConversationEnd,
+		onMessageSent,
+		onMessageReceived,
+		onError
+	});
+	React$1.useEffect(() => {
+		callbacksRef.current = {
+			onConversationStart,
+			onConversationEnd,
+			onMessageSent,
+			onMessageReceived,
+			onError
+		};
+	}, [
+		onConversationStart,
+		onConversationEnd,
+		onMessageSent,
+		onMessageReceived,
+		onError
+	]);
+	const subscribersRef = React$1.useRef(/* @__PURE__ */ new Map());
+	const emit = React$1.useCallback((event) => {
+		switch (event.type) {
+			case "conversationStart":
+				callbacksRef.current.onConversationStart?.(event);
+				break;
+			case "conversationEnd":
+				callbacksRef.current.onConversationEnd?.(event);
+				break;
+			case "messageSent":
+				callbacksRef.current.onMessageSent?.(event);
+				break;
+			case "messageReceived":
+				callbacksRef.current.onMessageReceived?.(event);
+				break;
+			case "error":
+				callbacksRef.current.onError?.(event);
+				break;
+			default: break;
+		}
+		const subscribers = subscribersRef.current.get(event.type);
+		if (subscribers) for (const callback of subscribers) callback(event);
+	}, []);
+	const subscribe = React$1.useCallback((type, callback) => {
+		if (!subscribersRef.current.has(type)) subscribersRef.current.set(type, /* @__PURE__ */ new Set());
+		const subscribers = subscribersRef.current.get(type);
+		subscribers?.add(callback);
+		return () => {
+			subscribers?.delete(callback);
+		};
+	}, []);
+	const value = React$1.useMemo(() => ({
+		emit,
+		subscribe
+	}), [emit, subscribe]);
+	return /* @__PURE__ */ jsx(SupportEventsContext.Provider, {
+		value,
+		children
+	});
+};
+/**
+* Access the events context.
+* Returns null if not inside a SupportEventsProvider.
+*/
+function useSupportEvents() {
+	return React$1.useContext(SupportEventsContext);
+}
+/**
+* Hook to emit events from within the widget.
+* Safe to use outside of provider (will no-op).
+*/
+function useSupportEventEmitter() {
+	const events = useSupportEvents();
+	return React$1.useMemo(() => ({
+		emitConversationStart: (conversationId, conversation) => {
+			events?.emit({
+				type: "conversationStart",
+				conversationId,
+				conversation
+			});
+		},
+		emitConversationEnd: (conversationId, conversation) => {
+			events?.emit({
+				type: "conversationEnd",
+				conversationId,
+				conversation
+			});
+		},
+		emitMessageSent: (conversationId, message) => {
+			events?.emit({
+				type: "messageSent",
+				conversationId,
+				message
+			});
+		},
+		emitMessageReceived: (conversationId, message) => {
+			events?.emit({
+				type: "messageReceived",
+				conversationId,
+				message
+			});
+		},
+		emitError: (error, context) => {
+			events?.emit({
+				type: "error",
+				error,
+				context
+			});
+		}
+	}), [events]);
+}
+
+//#endregion
+export { SupportEventsProvider, useSupportEventEmitter, useSupportEvents };
+//# sourceMappingURL=events.js.map

package/support/context/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":["React","SupportEventsProvider: React.FC<SupportEventsProviderProps>"],"sources":["../../../src/support/context/events.tsx"],"sourcesContent":["\"use client\";\n\nimport type { Conversation } from \"@cossistant/types\";\nimport type { TimelineItem } from \"@cossistant/types/api/timeline-item\";\nimport * as React from \"react\";\n\n// =============================================================================\n// Event Types\n// =============================================================================\n\nexport type SupportEventType =\n\t| \"conversationStart\"\n\t| \"conversationEnd\"\n\t| \"messageSent\"\n\t| \"messageReceived\"\n\t| \"error\";\n\nexport type ConversationStartEvent = {\n\ttype: \"conversationStart\";\n\tconversationId: string;\n\tconversation?: Conversation;\n};\n\nexport type ConversationEndEvent = {\n\ttype: \"conversationEnd\";\n\tconversationId: string;\n\tconversation?: Conversation;\n};\n\nexport type MessageSentEvent = {\n\ttype: \"messageSent\";\n\tconversationId: string;\n\tmessage: TimelineItem;\n};\n\nexport type MessageReceivedEvent = {\n\ttype: \"messageReceived\";\n\tconversationId: string;\n\tmessage: TimelineItem;\n};\n\nexport type ErrorEvent = {\n\ttype: \"error\";\n\terror: Error;\n\tcontext?: string;\n};\n\nexport type SupportEvent =\n\t| ConversationStartEvent\n\t| ConversationEndEvent\n\t| MessageSentEvent\n\t| MessageReceivedEvent\n\t| ErrorEvent;\n\n// =============================================================================\n// Event Callbacks\n// =============================================================================\n\nexport type SupportEventCallbacks = {\n\t/**\n\t * Called when a new conversation is started.\n\t */\n\tonConversationStart?: (event: ConversationStartEvent) => void;\n\t/**\n\t * Called when a conversation ends (resolved, closed, etc.).\n\t */\n\tonConversationEnd?: (event: ConversationEndEvent) => void;\n\t/**\n\t * Called when the visitor sends a message.\n\t */\n\tonMessageSent?: (event: MessageSentEvent) => void;\n\t/**\n\t * Called when a message is received from an agent (human or AI).\n\t */\n\tonMessageReceived?: (event: MessageReceivedEvent) => void;\n\t/**\n\t * Called when an error occurs.\n\t */\n\tonError?: (event: ErrorEvent) => void;\n};\n\n// =============================================================================\n// Context\n// =============================================================================\n\nexport type SupportEventsContextValue = {\n\t/**\n\t * Emit an event to all registered callbacks.\n\t */\n\temit: <T extends SupportEvent>(event: T) => void;\n\t/**\n\t * Subscribe to a specific event type.\n\t * Returns an unsubscribe function.\n\t */\n\tsubscribe: <T extends SupportEventType>(\n\t\ttype: T,\n\t\tcallback: (event: Extract<SupportEvent, { type: T }>) => void\n\t) => () => void;\n};\n\nconst SupportEventsContext =\n\tReact.createContext<SupportEventsContextValue | null>(null);\n\nexport type SupportEventsProviderProps = SupportEventCallbacks & {\n\tchildren: React.ReactNode;\n};\n\n/**\n * Provider for support widget events.\n * Allows listening to lifecycle events like message sent/received,\n * conversation start/end, and errors.\n *\n * @example\n * <Support\n *   onMessageSent={({ message }) => console.log(\"Sent:\", message)}\n *   onMessageReceived={({ message }) => console.log(\"Received:\", message)}\n *   onConversationStart={({ conversationId }) => console.log(\"Started:\", conversationId)}\n *   onError={({ error }) => console.error(\"Error:\", error)}\n * />\n */\nexport const SupportEventsProvider: React.FC<SupportEventsProviderProps> = ({\n\tonConversationStart,\n\tonConversationEnd,\n\tonMessageSent,\n\tonMessageReceived,\n\tonError,\n\tchildren,\n}) => {\n\t// Store callbacks in refs to avoid stale closures\n\tconst callbacksRef = React.useRef<SupportEventCallbacks>({\n\t\tonConversationStart,\n\t\tonConversationEnd,\n\t\tonMessageSent,\n\t\tonMessageReceived,\n\t\tonError,\n\t});\n\n\t// Update refs when callbacks change\n\tReact.useEffect(() => {\n\t\tcallbacksRef.current = {\n\t\t\tonConversationStart,\n\t\t\tonConversationEnd,\n\t\t\tonMessageSent,\n\t\t\tonMessageReceived,\n\t\t\tonError,\n\t\t};\n\t}, [\n\t\tonConversationStart,\n\t\tonConversationEnd,\n\t\tonMessageSent,\n\t\tonMessageReceived,\n\t\tonError,\n\t]);\n\n\t// Additional subscribers (for internal use)\n\tconst subscribersRef = React.useRef<\n\t\tMap<SupportEventType, Set<(event: SupportEvent) => void>>\n\t>(new Map());\n\n\tconst emit = React.useCallback(<T extends SupportEvent>(event: T) => {\n\t\t// Call the prop callback\n\t\tswitch (event.type) {\n\t\t\tcase \"conversationStart\":\n\t\t\t\tcallbacksRef.current.onConversationStart?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"conversationEnd\":\n\t\t\t\tcallbacksRef.current.onConversationEnd?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"messageSent\":\n\t\t\t\tcallbacksRef.current.onMessageSent?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"messageReceived\":\n\t\t\t\tcallbacksRef.current.onMessageReceived?.(event);\n\t\t\t\tbreak;\n\t\t\tcase \"error\":\n\t\t\t\tcallbacksRef.current.onError?.(event);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\t// Unknown event type - no callback to call\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// Call any additional subscribers\n\t\tconst subscribers = subscribersRef.current.get(event.type);\n\t\tif (subscribers) {\n\t\t\tfor (const callback of subscribers) {\n\t\t\t\tcallback(event);\n\t\t\t}\n\t\t}\n\t}, []);\n\n\tconst subscribe = React.useCallback(\n\t\t<T extends SupportEventType>(\n\t\t\ttype: T,\n\t\t\tcallback: (event: Extract<SupportEvent, { type: T }>) => void\n\t\t) => {\n\t\t\tif (!subscribersRef.current.has(type)) {\n\t\t\t\tsubscribersRef.current.set(type, new Set());\n\t\t\t}\n\t\t\tconst subscribers = subscribersRef.current.get(type);\n\t\t\tsubscribers?.add(callback as (event: SupportEvent) => void);\n\n\t\t\t// Return unsubscribe function\n\t\t\treturn () => {\n\t\t\t\tsubscribers?.delete(callback as (event: SupportEvent) => void);\n\t\t\t};\n\t\t},\n\t\t[]\n\t);\n\n\tconst value = React.useMemo<SupportEventsContextValue>(\n\t\t() => ({ emit, subscribe }),\n\t\t[emit, subscribe]\n\t);\n\n\treturn (\n\t\t<SupportEventsContext.Provider value={value}>\n\t\t\t{children}\n\t\t</SupportEventsContext.Provider>\n\t);\n};\n\n/**\n * Access the events context.\n * Returns null if not inside a SupportEventsProvider.\n */\nexport function useSupportEvents(): SupportEventsContextValue | null {\n\treturn React.useContext(SupportEventsContext);\n}\n\n/**\n * Hook to emit events from within the widget.\n * Safe to use outside of provider (will no-op).\n */\nexport function useSupportEventEmitter() {\n\tconst events = useSupportEvents();\n\n\treturn React.useMemo(\n\t\t() => ({\n\t\t\temitConversationStart: (\n\t\t\t\tconversationId: string,\n\t\t\t\tconversation?: Conversation\n\t\t\t) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"conversationStart\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tconversation,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitConversationEnd: (\n\t\t\t\tconversationId: string,\n\t\t\t\tconversation?: Conversation\n\t\t\t) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"conversationEnd\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tconversation,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitMessageSent: (conversationId: string, message: TimelineItem) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"messageSent\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tmessage,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitMessageReceived: (conversationId: string, message: TimelineItem) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"messageReceived\",\n\t\t\t\t\tconversationId,\n\t\t\t\t\tmessage,\n\t\t\t\t});\n\t\t\t},\n\t\t\temitError: (error: Error, context?: string) => {\n\t\t\t\tevents?.emit({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\terror,\n\t\t\t\t\tcontext,\n\t\t\t\t});\n\t\t\t},\n\t\t}),\n\t\t[events]\n\t);\n}\n"],"mappings":";;;;;;;AAoGA,MAAM,uBACLA,QAAM,cAAgD,KAAK;;;;;;;;;;;;;;AAmB5D,MAAaC,yBAA+D,EAC3E,qBACA,mBACA,eACA,mBACA,SACA,eACK;CAEL,MAAM,eAAeD,QAAM,OAA8B;EACxD;EACA;EACA;EACA;EACA;EACA,CAAC;AAGF,SAAM,gBAAgB;AACrB,eAAa,UAAU;GACtB;GACA;GACA;GACA;GACA;GACA;IACC;EACF;EACA;EACA;EACA;EACA;EACA,CAAC;CAGF,MAAM,iBAAiBA,QAAM,uBAE3B,IAAI,KAAK,CAAC;CAEZ,MAAM,OAAOA,QAAM,aAAqC,UAAa;AAEpE,UAAQ,MAAM,MAAd;GACC,KAAK;AACJ,iBAAa,QAAQ,sBAAsB,MAAM;AACjD;GACD,KAAK;AACJ,iBAAa,QAAQ,oBAAoB,MAAM;AAC/C;GACD,KAAK;AACJ,iBAAa,QAAQ,gBAAgB,MAAM;AAC3C;GACD,KAAK;AACJ,iBAAa,QAAQ,oBAAoB,MAAM;AAC/C;GACD,KAAK;AACJ,iBAAa,QAAQ,UAAU,MAAM;AACrC;GACD,QAEC;;EAIF,MAAM,cAAc,eAAe,QAAQ,IAAI,MAAM,KAAK;AAC1D,MAAI,YACH,MAAK,MAAM,YAAY,YACtB,UAAS,MAAM;IAGf,EAAE,CAAC;CAEN,MAAM,YAAYA,QAAM,aAEtB,MACA,aACI;AACJ,MAAI,CAAC,eAAe,QAAQ,IAAI,KAAK,CACpC,gBAAe,QAAQ,IAAI,sBAAM,IAAI,KAAK,CAAC;EAE5C,MAAM,cAAc,eAAe,QAAQ,IAAI,KAAK;AACpD,eAAa,IAAI,SAA0C;AAG3D,eAAa;AACZ,gBAAa,OAAO,SAA0C;;IAGhE,EAAE,CACF;CAED,MAAM,QAAQA,QAAM,eACZ;EAAE;EAAM;EAAW,GAC1B,CAAC,MAAM,UAAU,CACjB;AAED,QACC,oBAAC,qBAAqB;EAAgB;EACpC;GAC8B;;;;;;AAQlC,SAAgB,mBAAqD;AACpE,QAAOA,QAAM,WAAW,qBAAqB;;;;;;AAO9C,SAAgB,yBAAyB;CACxC,MAAM,SAAS,kBAAkB;AAEjC,QAAOA,QAAM,eACL;EACN,wBACC,gBACA,iBACI;AACJ,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,sBACC,gBACA,iBACI;AACJ,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,kBAAkB,gBAAwB,YAA0B;AACnE,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,sBAAsB,gBAAwB,YAA0B;AACvE,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,YAAY,OAAc,YAAqB;AAC9C,WAAQ,KAAK;IACZ,MAAM;IACN;IACA;IACA,CAAC;;EAEH,GACD,CAAC,OAAO,CACR"}

package/support/context/handle.d.ts

@@ -0,0 +1,90 @@
+import * as React$1 from "react";
+import { RouteRegistry } from "@cossistant/core";
+
+//#region src/support/context/handle.d.ts
+
+/**
+ * Imperative handle for programmatic control of the Support widget.
+ * Access via ref on the Support component or via useSupportHandle hook.
+ *
+ * @example
+ * const supportRef = useRef<SupportHandle>(null);
+ *
+ * // Open the widget
+ * supportRef.current?.open();
+ *
+ * // Navigate to a conversation
+ * supportRef.current?.openConversation("conv_123");
+ *
+ * // Start a new conversation with a message
+ * supportRef.current?.startConversation("I need help with...");
+ *
+ * <Support ref={supportRef} />
+ */
+type SupportHandle = {
+  /**
+   * Open the support widget.
+   */
+  open: () => void;
+  /**
+   * Close the support widget.
+   */
+  close: () => void;
+  /**
+   * Toggle the support widget open/closed.
+   */
+  toggle: () => void;
+  /**
+   * Navigate to a specific page with optional params.
+   */
+  navigate: <K extends keyof RouteRegistry>(options: {
+    page: K;
+    params?: RouteRegistry[K];
+  }) => void;
+  /**
+   * Go back to the previous page.
+   */
+  goBack: () => void;
+  /**
+   * Open a specific conversation.
+   */
+  openConversation: (conversationId: string) => void;
+  /**
+   * Start a new conversation, optionally with an initial message.
+   */
+  startConversation: (initialMessage?: string) => void;
+  /**
+   * Navigate to the home page.
+   */
+  goHome: () => void;
+};
+type SupportHandleProviderProps = {
+  /**
+   * Ref to expose the handle to parent components.
+   */
+  forwardedRef?: React$1.Ref<SupportHandle>;
+  children: React$1.ReactNode;
+};
+/**
+ * Provider that creates and exposes the imperative handle.
+ */
+declare const SupportHandleProvider: React$1.FC<SupportHandleProviderProps>;
+/**
+ * Hook to access the imperative handle from within the widget.
+ * Returns null if not inside Support component.
+ *
+ * @example
+ * function MyComponent() {
+ *   const support = useSupportHandle();
+ *
+ *   return (
+ *     <button onClick={() => support?.startConversation("Hello!")}>
+ *       Get Help
+ *     </button>
+ *   );
+ * }
+ */
+declare function useSupportHandle(): SupportHandle | null;
+//#endregion
+export { SupportHandle, SupportHandleProvider, SupportHandleProviderProps, useSupportHandle };
+//# sourceMappingURL=handle.d.ts.map

package/support/context/handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","names":[],"sources":["../../../src/support/context/handle.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA6BA;;;;;;AA4CA;;;;;AAWA;AA2EA;;;;KAlIY,aAAA;;;;;;;;;;;;;;;;6BAgBgB;UACpB;aACG,cAAc;;;;;;;;;;;;;;;;;;;KA0Bb,0BAAA;;;;iBAII,OAAA,CAAM,IAAI;YACf,OAAA,CAAM;;;;;cAMJ,uBAAuB,OAAA,CAAM,GAAG;;;;;;;;;;;;;;;;iBA2E7B,gBAAA,CAAA,GAAoB"}

package/support/context/handle.js

@@ -0,0 +1,79 @@
+"use client";
+
+
+import { useSupportConfig, useSupportNavigation } from "../store/support-store.js";
+import { PENDING_CONVERSATION_ID } from "../../utils/id.js";
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/handle.tsx
+const SupportHandleContext = React$1.createContext(null);
+/**
+* Provider that creates and exposes the imperative handle.
+*/
+const SupportHandleProvider = ({ forwardedRef, children }) => {
+	const { open, close, toggle } = useSupportConfig();
+	const { navigate, goBack } = useSupportNavigation();
+	const handle = React$1.useMemo(() => ({
+		open,
+		close,
+		toggle,
+		navigate: (options) => {
+			navigate(options);
+		},
+		goBack,
+		openConversation: (conversationId) => {
+			navigate({
+				page: "CONVERSATION",
+				params: { conversationId }
+			});
+			open();
+		},
+		startConversation: (initialMessage) => {
+			navigate({
+				page: "CONVERSATION",
+				params: {
+					conversationId: PENDING_CONVERSATION_ID,
+					initialMessage
+				}
+			});
+			open();
+		},
+		goHome: () => {
+			navigate({ page: "HOME" });
+		}
+	}), [
+		open,
+		close,
+		toggle,
+		navigate,
+		goBack
+	]);
+	React$1.useImperativeHandle(forwardedRef, () => handle, [handle]);
+	return /* @__PURE__ */ jsx(SupportHandleContext.Provider, {
+		value: handle,
+		children
+	});
+};
+/**
+* Hook to access the imperative handle from within the widget.
+* Returns null if not inside Support component.
+*
+* @example
+* function MyComponent() {
+*   const support = useSupportHandle();
+*
+*   return (
+*     <button onClick={() => support?.startConversation("Hello!")}>
+*       Get Help
+*     </button>
+*   );
+* }
+*/
+function useSupportHandle() {
+	return React$1.useContext(SupportHandleContext);
+}
+
+//#endregion
+export { SupportHandleProvider, useSupportHandle };
+//# sourceMappingURL=handle.js.map

package/support/context/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","names":["React","SupportHandleProvider: React.FC<SupportHandleProviderProps>"],"sources":["../../../src/support/context/handle.tsx"],"sourcesContent":["\"use client\";\n\nimport type { RouteRegistry } from \"@cossistant/core\";\nimport * as React from \"react\";\nimport { PENDING_CONVERSATION_ID } from \"../../utils/id\";\nimport { useSupportConfig, useSupportNavigation } from \"../store/support-store\";\n\n// =============================================================================\n// Handle Type\n// =============================================================================\n\n/**\n * Imperative handle for programmatic control of the Support widget.\n * Access via ref on the Support component or via useSupportHandle hook.\n *\n * @example\n * const supportRef = useRef<SupportHandle>(null);\n *\n * // Open the widget\n * supportRef.current?.open();\n *\n * // Navigate to a conversation\n * supportRef.current?.openConversation(\"conv_123\");\n *\n * // Start a new conversation with a message\n * supportRef.current?.startConversation(\"I need help with...\");\n *\n * <Support ref={supportRef} />\n */\nexport type SupportHandle = {\n\t/**\n\t * Open the support widget.\n\t */\n\topen: () => void;\n\t/**\n\t * Close the support widget.\n\t */\n\tclose: () => void;\n\t/**\n\t * Toggle the support widget open/closed.\n\t */\n\ttoggle: () => void;\n\t/**\n\t * Navigate to a specific page with optional params.\n\t */\n\tnavigate: <K extends keyof RouteRegistry>(options: {\n\t\tpage: K;\n\t\tparams?: RouteRegistry[K];\n\t}) => void;\n\t/**\n\t * Go back to the previous page.\n\t */\n\tgoBack: () => void;\n\t/**\n\t * Open a specific conversation.\n\t */\n\topenConversation: (conversationId: string) => void;\n\t/**\n\t * Start a new conversation, optionally with an initial message.\n\t */\n\tstartConversation: (initialMessage?: string) => void;\n\t/**\n\t * Navigate to the home page.\n\t */\n\tgoHome: () => void;\n};\n\n// =============================================================================\n// Context\n// =============================================================================\n\nconst SupportHandleContext = React.createContext<SupportHandle | null>(null);\n\nexport type SupportHandleProviderProps = {\n\t/**\n\t * Ref to expose the handle to parent components.\n\t */\n\tforwardedRef?: React.Ref<SupportHandle>;\n\tchildren: React.ReactNode;\n};\n\n/**\n * Provider that creates and exposes the imperative handle.\n */\nexport const SupportHandleProvider: React.FC<SupportHandleProviderProps> = ({\n\tforwardedRef,\n\tchildren,\n}) => {\n\tconst { open, close, toggle } = useSupportConfig();\n\tconst { navigate, goBack } = useSupportNavigation();\n\n\tconst handle = React.useMemo<SupportHandle>(\n\t\t() => ({\n\t\t\topen,\n\t\t\tclose,\n\t\t\ttoggle,\n\t\t\tnavigate: <K extends keyof RouteRegistry>(options: {\n\t\t\t\tpage: K;\n\t\t\t\tparams?: RouteRegistry[K];\n\t\t\t}) => {\n\t\t\t\t// Use type assertion since we know the navigate function accepts these types\n\t\t\t\tnavigate(options as Parameters<typeof navigate>[0]);\n\t\t\t},\n\t\t\tgoBack,\n\t\t\topenConversation: (conversationId: string) => {\n\t\t\t\tnavigate({\n\t\t\t\t\tpage: \"CONVERSATION\",\n\t\t\t\t\tparams: { conversationId },\n\t\t\t\t});\n\t\t\t\t// Also open the widget if closed\n\t\t\t\topen();\n\t\t\t},\n\t\t\tstartConversation: (initialMessage?: string) => {\n\t\t\t\tnavigate({\n\t\t\t\t\tpage: \"CONVERSATION\",\n\t\t\t\t\tparams: {\n\t\t\t\t\t\tconversationId: PENDING_CONVERSATION_ID,\n\t\t\t\t\t\tinitialMessage,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\t// Also open the widget if closed\n\t\t\t\topen();\n\t\t\t},\n\t\t\tgoHome: () => {\n\t\t\t\tnavigate({ page: \"HOME\" });\n\t\t\t},\n\t\t}),\n\t\t[open, close, toggle, navigate, goBack]\n\t);\n\n\t// Expose handle via ref\n\tReact.useImperativeHandle(forwardedRef, () => handle, [handle]);\n\n\treturn (\n\t\t<SupportHandleContext.Provider value={handle}>\n\t\t\t{children}\n\t\t</SupportHandleContext.Provider>\n\t);\n};\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * Hook to access the imperative handle from within the widget.\n * Returns null if not inside Support component.\n *\n * @example\n * function MyComponent() {\n *   const support = useSupportHandle();\n *\n *   return (\n *     <button onClick={() => support?.startConversation(\"Hello!\")}>\n *       Get Help\n *     </button>\n *   );\n * }\n */\nexport function useSupportHandle(): SupportHandle | null {\n\treturn React.useContext(SupportHandleContext);\n}\n"],"mappings":";;;;;;;;;AAuEA,MAAM,uBAAuBA,QAAM,cAAoC,KAAK;;;;AAa5E,MAAaC,yBAA+D,EAC3E,cACA,eACK;CACL,MAAM,EAAE,MAAM,OAAO,WAAW,kBAAkB;CAClD,MAAM,EAAE,UAAU,WAAW,sBAAsB;CAEnD,MAAM,SAASD,QAAM,eACb;EACN;EACA;EACA;EACA,WAA0C,YAGpC;AAEL,YAAS,QAA0C;;EAEpD;EACA,mBAAmB,mBAA2B;AAC7C,YAAS;IACR,MAAM;IACN,QAAQ,EAAE,gBAAgB;IAC1B,CAAC;AAEF,SAAM;;EAEP,oBAAoB,mBAA4B;AAC/C,YAAS;IACR,MAAM;IACN,QAAQ;KACP,gBAAgB;KAChB;KACA;IACD,CAAC;AAEF,SAAM;;EAEP,cAAc;AACb,YAAS,EAAE,MAAM,QAAQ,CAAC;;EAE3B,GACD;EAAC;EAAM;EAAO;EAAQ;EAAU;EAAO,CACvC;AAGD,SAAM,oBAAoB,oBAAoB,QAAQ,CAAC,OAAO,CAAC;AAE/D,QACC,oBAAC,qBAAqB;EAAS,OAAO;EACpC;GAC8B;;;;;;;;;;;;;;;;;AAuBlC,SAAgB,mBAAyC;AACxD,QAAOA,QAAM,WAAW,qBAAqB"}

package/support/context/positioning.d.ts

@@ -0,0 +1,17 @@
+import * as React$1 from "react";
+
+//#region src/support/context/positioning.d.ts
+type TriggerRefContextValue = {
+  /** The trigger element (state-based for reactivity) */
+  triggerElement: HTMLElement | null;
+  /** Set the trigger element - triggers re-render when called */
+  setTriggerElement: (element: HTMLElement | null) => void;
+};
+type TriggerRefProviderProps = {
+  children: React$1.ReactNode;
+};
+declare const TriggerRefProvider: React$1.FC<TriggerRefProviderProps>;
+declare function useTriggerRef(): TriggerRefContextValue | null;
+//#endregion
+export { TriggerRefContextValue, TriggerRefProvider, TriggerRefProviderProps, useTriggerRef };
+//# sourceMappingURL=positioning.d.ts.map

package/support/context/positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.d.ts","names":[],"sources":["../../../src/support/context/positioning.tsx"],"sourcesContent":[],"mappings":";;;KAQY,sBAAA;;EAAA,cAAA,EAEK,WAFiB,GAAA,IAAA;EAmBtB;EAIC,iBAAA,EAAA,CAAA,OAqBZ,EAxC6B,WAmBY,GAAA,IAAA,EAAA,GAAA,IAAA;AA2B1C,CAAA;KA/BY,uBAAA;YACD,OAAA,CAAM;;cAGJ,oBAAoB,OAAA,CAAM,GAAG;iBA2B1B,aAAA,CAAA,GAAiB"}

package/support/context/positioning.js

@@ -0,0 +1,26 @@
+"use client";
+
+
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/positioning.tsx
+const TriggerRefContext = React$1.createContext(null);
+const TriggerRefProvider = ({ children }) => {
+	const [triggerElement, setTriggerElement] = React$1.useState(null);
+	const value = React$1.useMemo(() => ({
+		triggerElement,
+		setTriggerElement
+	}), [triggerElement]);
+	return /* @__PURE__ */ jsx(TriggerRefContext.Provider, {
+		value,
+		children
+	});
+};
+function useTriggerRef() {
+	return React$1.useContext(TriggerRefContext);
+}
+
+//#endregion
+export { TriggerRefProvider, useTriggerRef };
+//# sourceMappingURL=positioning.js.map

package/support/context/positioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.js","names":["React","TriggerRefProvider: React.FC<TriggerRefProviderProps>"],"sources":["../../../src/support/context/positioning.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type TriggerRefContextValue = {\n\t/** The trigger element (state-based for reactivity) */\n\ttriggerElement: HTMLElement | null;\n\t/** Set the trigger element - triggers re-render when called */\n\tsetTriggerElement: (element: HTMLElement | null) => void;\n};\n\n// =============================================================================\n// Context\n// =============================================================================\n\nconst TriggerRefContext = React.createContext<TriggerRefContextValue | null>(\n\tnull\n);\n\n// =============================================================================\n// Provider\n// =============================================================================\n\nexport type TriggerRefProviderProps = {\n\tchildren: React.ReactNode;\n};\n\nexport const TriggerRefProvider: React.FC<TriggerRefProviderProps> = ({\n\tchildren,\n}) => {\n\t// Using state instead of ref to trigger re-renders when trigger mounts\n\t// This ensures Floating UI receives the reference element\n\tconst [triggerElement, setTriggerElement] =\n\t\tReact.useState<HTMLElement | null>(null);\n\n\tconst value = React.useMemo<TriggerRefContextValue>(\n\t\t() => ({\n\t\t\ttriggerElement,\n\t\t\tsetTriggerElement,\n\t\t}),\n\t\t[triggerElement]\n\t);\n\n\treturn (\n\t\t<TriggerRefContext.Provider value={value}>\n\t\t\t{children}\n\t\t</TriggerRefContext.Provider>\n\t);\n};\n\n// =============================================================================\n// Hook\n// =============================================================================\n\nexport function useTriggerRef(): TriggerRefContextValue | null {\n\treturn React.useContext(TriggerRefContext);\n}\n"],"mappings":";;;;;;;AAmBA,MAAM,oBAAoBA,QAAM,cAC/B,KACA;AAUD,MAAaC,sBAAyD,EACrE,eACK;CAGL,MAAM,CAAC,gBAAgB,qBACtBD,QAAM,SAA6B,KAAK;CAEzC,MAAM,QAAQA,QAAM,eACZ;EACN;EACA;EACA,GACD,CAAC,eAAe,CAChB;AAED,QACC,oBAAC,kBAAkB;EAAgB;EACjC;GAC2B;;AAQ/B,SAAgB,gBAA+C;AAC9D,QAAOA,QAAM,WAAW,kBAAkB"}