@xbrain-swe/nova-chat-widget 0.3.0-dev.16 → 0.3.0-dev.18

package/dist/index.cjs

@@ -72,7 +72,7 @@ function useXbNovaInternal() {
   return ctx;
 }
 var VISITOR_STORAGE_KEY = "xbnova_visitor_id";
-var WIDGET_VIEW_WAIT_MS = 1e4;
+var HOST_IDENTITY_WAIT_MS = 1e4;
 function resolveVisitorId() {
   if (typeof window === "undefined") return "";
   try {
@@ -117,10 +117,10 @@ function InternalProvider({
   const sessionId = auth.sessionKey || null;
   const latestRef = (0, import_react.useRef)({ auth, visitorId, sessionId });
   latestRef.current = { auth, visitorId, sessionId };
-  const sendEvent = (0, import_react.useCallback)((event, properties = {}) => {
+  const postEvent = (0, import_react.useCallback)((event, properties) => {
     const { auth: a, visitorId: v, sessionId: sid } = latestRef.current;
     if (!v) return;
-    const { conversation_id: conversationId, ...rest } = properties;
+    const { conversation_id: conversationId, occurred_at: occurredAt, ...rest } = properties;
     fetch(`${a.apiBaseUrl}/v1/events`, {
       method: "POST",
       keepalive: true,
@@ -131,26 +131,45 @@ function InternalProvider({
         visitor_id: v,
         session_id: sid,
         conversation_id: conversationId ?? null,
-        properties: { screen: a.screen, ...rest }
+        occurred_at: occurredAt,
+        properties: { screen: a.screen, ...a.eventProperties, ...rest }
       })
     }).catch(() => {
     });
   }, []);
-  const widgetViewSentRef = (0, import_react.useRef)(false);
+  const eventQueueRef = (0, import_react.useRef)([]);
+  const identitySettledRef = (0, import_react.useRef)(false);
+  const flushEvents = (0, import_react.useCallback)(() => {
+    identitySettledRef.current = true;
+    for (const [event, properties] of eventQueueRef.current.splice(0)) postEvent(event, properties);
+  }, [postEvent]);
+  const sendEvent = (0, import_react.useCallback)(
+    (event, properties = {}) => {
+      const stamped = { ...properties, occurred_at: properties.occurred_at ?? (/* @__PURE__ */ new Date()).toISOString() };
+      if (identitySettledRef.current) postEvent(event, stamped);
+      else eventQueueRef.current.push([event, stamped]);
+    },
+    [postEvent]
+  );
+  const hostIdentity = auth.userKey || sessionId;
   (0, import_react.useEffect)(() => {
-    if (widgetViewSentRef.current) return;
-    const send = () => {
-      if (widgetViewSentRef.current) return;
-      widgetViewSentRef.current = true;
-      sendEvent("widget_view");
-    };
-    if (sessionId) {
-      send();
+    if (hostIdentity) {
+      flushEvents();
       return;
     }
-    const timer = setTimeout(send, WIDGET_VIEW_WAIT_MS);
-    return () => clearTimeout(timer);
-  }, [sessionId, sendEvent]);
+    const timer = setTimeout(flushEvents, HOST_IDENTITY_WAIT_MS);
+    window.addEventListener("pagehide", flushEvents);
+    return () => {
+      clearTimeout(timer);
+      window.removeEventListener("pagehide", flushEvents);
+    };
+  }, [hostIdentity, flushEvents]);
+  const widgetViewSentRef = (0, import_react.useRef)(false);
+  (0, import_react.useEffect)(() => {
+    if (widgetViewSentRef.current) return;
+    widgetViewSentRef.current = true;
+    sendEvent("view_vehicle");
+  }, [sendEvent]);
   const value = (0, import_react.useMemo)(
     () => ({
       auth,
@@ -746,7 +765,7 @@ function XbNovaNudgeLoop({ appId }) {
           autoHideMs: messageNode.auto_hide_ms ?? 2e4,
           quickReplies: messageNode.quick_replies ?? []
         });
-        sendEvent("nudge_impression", { nudge_node_id: messageNode.id, bot_id: botId });
+        sendEvent("nudge_AI_view", { nudge_node_id: messageNode.id, bot_id: botId });
       };
       const tryFireFrom = (node) => {
         const nextEdge = (edgesFrom.get(node.id) ?? [])[0];
@@ -952,6 +971,7 @@ function XbNovaProvider({
   userKey,
   threadKey,
   sessionKey,
+  eventProperties,
   children
 }) {
   (0, import_react6.useEffect)(() => {
@@ -967,6 +987,7 @@ function XbNovaProvider({
   (0, import_react6.useEffect)(() => {
     if (screen) bumpVisitCount(screen);
   }, [screen]);
+  const eventPropertiesJson = JSON.stringify(eventProperties ?? null);
   const auth = (0, import_react6.useMemo)(
     () => ({
       apiKey,
@@ -976,9 +997,10 @@ function XbNovaProvider({
       screen,
       userKey: userKey || void 0,
       threadKey: threadKey || void 0,
-      sessionKey: sessionKey || void 0
+      sessionKey: sessionKey || void 0,
+      eventProperties: JSON.parse(eventPropertiesJson) ?? void 0
     }),
-    [apiKey, botId, appId, apiBaseUrl, screen, userKey, threadKey, sessionKey]
+    [apiKey, botId, appId, apiBaseUrl, screen, userKey, threadKey, sessionKey, eventPropertiesJson]
   );
   const resolvedTheme = (0, import_react6.useMemo)(
     () => ({ ...DEFAULT_THEME, ...theme }),
@@ -1222,6 +1244,10 @@ async function resumeToolResult(apiBaseUrl, apiKey, body, handlers) {
 
 // src/use-chat.ts
 var DEFAULT_CLIENT_ACTION_TIMEOUT_MS = 15e3;
+var CTA_CLICK_EVENTS = {
+  suggest_consultation: { event: "apply_AI_click", ctaType: "consult" },
+  suggest_finance_limit: { event: "finance_AI_click", ctaType: "finance" }
+};
 function useXbNovaChat(options) {
   const { auth, trackRegistry, contextRegistry, clientActionHandlers, visitorId, sessionId, sendEvent } = useXbNovaInternal();
   const botId = options?.botId ?? auth.botId;
@@ -1233,7 +1259,6 @@ function useXbNovaChat(options) {
   const [resumed, setResumed] = (0, import_react8.useState)(false);
   const [sentOpening, setSentOpening] = (0, import_react8.useState)(null);
   const conversationIdRef = (0, import_react8.useRef)(null);
-  const pendingOpeningRef = (0, import_react8.useRef)(null);
   const messagesRef = (0, import_react8.useRef)(messages);
   messagesRef.current = messages;
   const [busy, setBusy] = (0, import_react8.useState)(false);
@@ -1256,7 +1281,6 @@ function useXbNovaChat(options) {
     setFeedbackState({});
     dispatchedClientActionsRef.current = /* @__PURE__ */ new Set();
     conversationIdRef.current = null;
-    pendingOpeningRef.current = null;
     fetch(`${apiBaseUrl}/v1/conversations`, {
       method: "POST",
       headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
@@ -1289,16 +1313,6 @@ function useXbNovaChat(options) {
       cancelled = true;
     };
   }, [apiBaseUrl, apiKey, botId, userKey, threadKey]);
-  const openingMessage = options?.openingMessage;
-  (0, import_react8.useEffect)(() => {
-    if (!onboarding || !nudgeNodeId || !openingMessage) return;
-    if (messagesRef.current.length === 0) return;
-    setMessages((prev) => [
-      ...prev,
-      { role: "assistant", parts: [{ kind: "text", id: `nudge:${nudgeNodeId}:${prev.length}`, text: openingMessage }] }
-    ]);
-    pendingOpeningRef.current = openingMessage;
-  }, [onboarding, nudgeNodeId, openingMessage]);
   const appendToLastAssistant = (existingParts, newParts) => setMessages((prev) => {
     const next = [...prev];
     next[next.length - 1] = { ...next[next.length - 1], role: "assistant", parts: [...existingParts, ...newParts] };
@@ -1338,13 +1352,14 @@ function useXbNovaChat(options) {
       apply(prevRating);
     }
   }
-  function postClientActionEvent(kind, action, label) {
+  function postClientActionEvent(event, action, label, ctaType) {
     const conversationId = conversationIdRef.current;
     if (!conversationId) return;
-    sendEvent(kind, { conversation_id: conversationId, action, label });
+    sendEvent(event, { conversation_id: conversationId, action, label, cta_type: ctaType });
   }
   function trackClientActionClick(action, label) {
-    postClientActionEvent("cta_click", action, label);
+    const cta = CTA_CLICK_EVENTS[action];
+    postClientActionEvent(cta?.event ?? "cta_click", action, label, cta?.ctaType);
   }
   async function runClientAction(spec, part, existingParts) {
     if (spec.dismissSheet) options?.onDismissSheet?.();
@@ -1417,7 +1432,7 @@ function useXbNovaChat(options) {
       void runClientAction(spec, part, last.parts);
     }
   }, [messages, clientActionHandlers, onboarding, apiBaseUrl, apiKey, botId]);
-  async function send(text) {
+  async function send(text, { nudgeOpening, inputType = "typed" } = {}) {
     const trimmed = text.trim();
     if (!trimmed || busy) return;
     sendEvent("message_send", {
@@ -1425,10 +1440,19 @@ function useXbNovaChat(options) {
       is_first: messages.length === 0,
       length: trimmed.length
     });
+    let firstQuestionPending = messages.length === 0;
+    const reportFirstQuestion = (conversationId) => {
+      if (!firstQuestionPending) return;
+      firstQuestionPending = false;
+      sendEvent("question_AI_first", { conversation_id: conversationId, input_type: inputType });
+    };
+    if (conversationIdRef.current) reportFirstQuestion(conversationIdRef.current);
     setError(null);
     setBusy(true);
+    const resumedOpening = messages.length > 0 && nudgeOpening ? nudgeOpening : null;
     setMessages((prev) => [
       ...prev,
+      ...resumedOpening ? [{ role: "assistant", parts: [{ kind: "text", id: `nudge:${prev.length}`, text: resumedOpening }] }] : [],
       { role: "user", parts: [{ kind: "text", id: "u", text: trimmed }] },
       { role: "assistant", parts: [] }
     ]);
@@ -1441,14 +1465,13 @@ function useXbNovaChat(options) {
     const notes = collectContextEntries(contextRegistry);
     const screen = focused ? { region: focused.region, data: resolveFactValue(focused.data) } : {};
     const context = focused || notes.length ? { ...screen, ...notes.length ? { notes } : {} } : void 0;
-    let openingMessage2;
+    let openingMessage;
     if (messages.length === 0) {
-      openingMessage2 = (options?.openingMessage ?? onboarding?.greeting) || null;
-      setSentOpening(openingMessage2);
+      openingMessage = (options?.openingMessage ?? onboarding?.greeting) || null;
+      setSentOpening(openingMessage);
     } else {
-      openingMessage2 = pendingOpeningRef.current;
+      openingMessage = resumedOpening;
     }
-    pendingOpeningRef.current = null;
     try {
       await streamChat(
         apiBaseUrl,
@@ -1459,7 +1482,7 @@ function useXbNovaChat(options) {
           conversation_id: conversationIdRef.current,
           context,
           nudge_node_id: nudgeNodeId ?? null,
-          opening_message: openingMessage2,
+          opening_message: openingMessage,
           visitor_id: userKey || null,
           thread_key: threadKey ?? null,
           session_id: sessionId
@@ -1469,6 +1492,7 @@ function useXbNovaChat(options) {
           onMessageId: setLastAssistantId,
           onConversationId: (id) => {
             conversationIdRef.current = id;
+            reportFirstQuestion(id);
           },
           onError: setError
         }
@@ -1479,7 +1503,7 @@ function useXbNovaChat(options) {
       setBusy(false);
     }
   }
-  const opening = resumed ? null : sentOpening ?? options?.openingMessage ?? onboarding?.greeting ?? null;
+  const opening = resumed ? null : messages.length > 0 ? sentOpening : options?.openingMessage ?? onboarding?.greeting ?? null;
   return {
     onboarding,
     opening,
@@ -1779,6 +1803,7 @@ function XbNovaChat({
   const [activeBotId, setActiveBotId] = (0, import_react9.useState)(void 0);
   const [activeNudgeNodeId, setActiveNudgeNodeId] = (0, import_react9.useState)(void 0);
   const [nudgeQuickReplies, setNudgeQuickReplies] = (0, import_react9.useState)([]);
+  const [nudgePrompt, setNudgePrompt] = (0, import_react9.useState)(null);
   const [openingLine, setOpeningLine] = (0, import_react9.useState)(null);
   const [showDisclosure, setShowDisclosure] = (0, import_react9.useState)(false);
   const [input, setInput] = (0, import_react9.useState)("");
@@ -1848,10 +1873,13 @@ function XbNovaChat({
       setOpeningLine(consumed.text);
       setActiveNudgeNodeId(consumed.messageNodeId);
       setNudgeQuickReplies(consumed.quickReplies);
-      sendEvent("nudge_open", { nudge_node_id: consumed.messageNodeId, bot_id: consumed.botId });
+      setNudgePrompt(consumed.text);
+      sendEvent("nudge_AI_click", { nudge_node_id: consumed.messageNodeId, bot_id: consumed.botId });
     } else {
       setNudgeQuickReplies([]);
+      setNudgePrompt(null);
       setActiveNudgeNodeId(void 0);
+      sendEvent("chat_AI_open", { source: "direct" });
       const focused = getFocusedTrackEntry(trackRegistry);
       setOpeningLine(
         focused ? `${focused.label ?? focused.region}\uC744(\uB97C) \uBCF4\uACE0 \uACC4\uC2DC\uB124\uC694. \uAD81\uAE08\uD558\uC2E0 \uC810\uC744 \uD3B8\uD558\uAC8C \uBB3C\uC5B4\uBCF4\uC138\uC694.` : null
@@ -1862,7 +1890,6 @@ function XbNovaChat({
       markDisclosureSeen();
     }
     setOpen(true);
-    sendEvent("chat_open", { from_nudge: Boolean(consumed) });
     try {
       onOpen?.({ fromNudge: Boolean(consumed), hintText: consumed?.text });
     } catch (err) {
@@ -2072,26 +2099,31 @@ function XbNovaChat({
             /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { ref: bottomRef })
           ] }),
           (() => {
-            if (nudgeQuickReplies.length > 0) {
-              return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "flex flex-wrap gap-1.5 border-t border-neutral-200 px-3.5 py-2.5 dark:border-neutral-700", children: nudgeQuickReplies.map((q) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
-                "button",
-                {
-                  onClick: () => {
-                    setNudgeQuickReplies([]);
-                    send(q);
+            const prompt = messages.length > 0 ? nudgePrompt : null;
+            if (prompt || nudgeQuickReplies.length > 0) {
+              return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "space-y-2 border-t border-neutral-200 px-3.5 py-2.5 dark:border-neutral-700", children: [
+                prompt ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "text-sm font-medium", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(AssistantMarkdown, { text: prompt }) }) : null,
+                nudgeQuickReplies.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "flex flex-wrap gap-1.5", children: nudgeQuickReplies.map((q) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+                  "button",
+                  {
+                    onClick: () => {
+                      setNudgeQuickReplies([]);
+                      setNudgePrompt(null);
+                      send(q, { nudgeOpening: prompt, inputType: "quick_reply" });
+                    },
+                    className: "xbnova-chip rounded-full border px-2.5 py-1 text-[11px] font-semibold transition",
+                    children: q
                   },
-                  className: "xbnova-chip rounded-full border px-2.5 py-1 text-[11px] font-semibold transition",
-                  children: q
-                },
-                q
-              )) });
+                  q
+                )) }) : null
+              ] });
             }
             const quickReplies = onboarding?.quick_replies ?? [];
             if (messages.length !== 0 || quickReplies.length === 0) return null;
             return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "flex flex-wrap gap-1.5 border-t border-neutral-200 px-3.5 py-2.5 dark:border-neutral-700", children: quickReplies.map((q) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
               "button",
               {
-                onClick: () => send(q),
+                onClick: () => send(q, { inputType: "quick_reply" }),
                 className: "xbnova-chip rounded-full border px-2.5 py-1 text-[11px] font-semibold transition",
                 children: q
               },
@@ -2104,7 +2136,8 @@ function XbNovaChat({
               onSubmit: (e) => {
                 e.preventDefault();
                 setNudgeQuickReplies([]);
-                send(input);
+                setNudgePrompt(null);
+                send(input, { nudgeOpening: messages.length > 0 ? nudgePrompt : null });
                 setInput("");
               },
               className: "flex items-center gap-2 border-t border-neutral-200 px-3 py-2.5 dark:border-neutral-700",