@xbrain-swe/nova-chat-widget 0.2.4-dev.15 → 0.3.0-dev.17

package/dist/index.d.cts

@@ -171,7 +171,8 @@ type UseXbNovaChatResult = {
     messages: ChatMessage[];
     busy: boolean;
     error: string | null;
-    send: (text: string) => Promise<void>;
+    /** `nudgeOpening`은 대화 중 넛지를 눌러 띄운 질문이다. 답을 보낼 때 그 앞에 AI 발화로 남긴다. */
+    send: (text: string, nudgeOpening?: string | null) => Promise<void>;
     /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
     clientResults: ClientResults;
     /** messageId → 현재 평가. 평가 안 한 메시지는 키가 없다. */

package/dist/index.d.ts

@@ -171,7 +171,8 @@ type UseXbNovaChatResult = {
     messages: ChatMessage[];
     busy: boolean;
     error: string | null;
-    send: (text: string) => Promise<void>;
+    /** `nudgeOpening`은 대화 중 넛지를 눌러 띄운 질문이다. 답을 보낼 때 그 앞에 AI 발화로 남긴다. */
+    send: (text: string, nudgeOpening?: string | null) => Promise<void>;
     /** client action 핸들러가 돌려준 정규화 결과(tool_call_id별). 채팅 화면이 view 렌더러로 그린다. */
     clientResults: ClientResults;
     /** messageId → 현재 평가. 평가 안 한 메시지는 키가 없다. */

package/dist/index.js

@@ -70,23 +70,34 @@ function InternalProvider({
   const sessionId = auth.sessionKey || null;
   const latestRef = useRef({ auth, visitorId, sessionId });
   latestRef.current = { auth, visitorId, sessionId };
-  const sendEvent = useCallback((kind, fields = {}) => {
+  const sendEvent = useCallback((event, properties = {}) => {
     const { auth: a, visitorId: v, sessionId: sid } = latestRef.current;
-    fetch(`${a.apiBaseUrl}/v1/nudge-events`, {
+    if (!v) return;
+    const { conversation_id: conversationId, occurred_at: occurredAt, ...rest } = properties;
+    fetch(`${a.apiBaseUrl}/v1/events`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ app_id: a.appId, kind, visitor_id: v || null, session_id: sid, ...fields })
+      keepalive: true,
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${a.apiKey}` },
+      body: JSON.stringify({
+        app_id: a.appId,
+        event,
+        visitor_id: v,
+        session_id: sid,
+        conversation_id: conversationId ?? null,
+        occurred_at: occurredAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+        properties: { screen: a.screen, ...rest }
+      })
     }).catch(() => {
     });
   }, []);
   const widgetViewSentRef = useRef(false);
+  const mountedAtRef = useRef((/* @__PURE__ */ new Date()).toISOString());
   useEffect(() => {
     if (widgetViewSentRef.current) return;
     const send = () => {
       if (widgetViewSentRef.current) return;
       widgetViewSentRef.current = true;
-      const screen = latestRef.current.auth.screen;
-      sendEvent("widget_view", screen ? { payload: { screen } } : {});
+      sendEvent("widget_view", { occurred_at: mountedAtRef.current });
     };
     if (sessionId) {
       send();
@@ -1176,7 +1187,6 @@ function useXbNovaChat(options) {
   const [resumed, setResumed] = useState3(false);
   const [sentOpening, setSentOpening] = useState3(null);
   const conversationIdRef = useRef7(null);
-  const pendingOpeningRef = useRef7(null);
   const messagesRef = useRef7(messages);
   messagesRef.current = messages;
   const [busy, setBusy] = useState3(false);
@@ -1199,7 +1209,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}` },
@@ -1232,16 +1241,6 @@ function useXbNovaChat(options) {
       cancelled = true;
     };
   }, [apiBaseUrl, apiKey, botId, userKey, threadKey]);
-  const openingMessage = options?.openingMessage;
-  useEffect8(() => {
-    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] };
@@ -1274,6 +1273,7 @@ function useXbNovaChat(options) {
         }
       );
       if (!res.ok) throw new Error(`${res.status}`);
+      sendEvent("feedback_submit", { conversation_id: conversationId, message_id: messageId, rating, reason });
       options?.onFeedback?.({ conversationId, messageId, rating, reason });
     } catch (e) {
       console.warn("[xbnova] \uD53C\uB4DC\uBC31 \uC800\uC7A5 \uC2E4\uD328", e);
@@ -1283,7 +1283,7 @@ function useXbNovaChat(options) {
   function postClientActionEvent(kind, action, label) {
     const conversationId = conversationIdRef.current;
     if (!conversationId) return;
-    sendEvent(kind, { conversation_id: conversationId, payload: label ? { action, label } : { action } });
+    sendEvent(kind, { conversation_id: conversationId, action, label });
   }
   function trackClientActionClick(action, label) {
     postClientActionEvent("cta_click", action, label);
@@ -1359,13 +1359,20 @@ function useXbNovaChat(options) {
       void runClientAction(spec, part, last.parts);
     }
   }, [messages, clientActionHandlers, onboarding, apiBaseUrl, apiKey, botId]);
-  async function send(text) {
+  async function send(text, nudgeOpening) {
     const trimmed = text.trim();
     if (!trimmed || busy) return;
+    sendEvent("message_send", {
+      conversation_id: conversationIdRef.current,
+      is_first: messages.length === 0,
+      length: trimmed.length
+    });
     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: [] }
     ]);
@@ -1378,14 +1385,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,
@@ -1396,7 +1402,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
@@ -1416,7 +1422,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,
@@ -1716,6 +1722,7 @@ function XbNovaChat({
   const [activeBotId, setActiveBotId] = useState4(void 0);
   const [activeNudgeNodeId, setActiveNudgeNodeId] = useState4(void 0);
   const [nudgeQuickReplies, setNudgeQuickReplies] = useState4([]);
+  const [nudgePrompt, setNudgePrompt] = useState4(null);
   const [openingLine, setOpeningLine] = useState4(null);
   const [showDisclosure, setShowDisclosure] = useState4(false);
   const [input, setInput] = useState4("");
@@ -1785,9 +1792,11 @@ function XbNovaChat({
       setOpeningLine(consumed.text);
       setActiveNudgeNodeId(consumed.messageNodeId);
       setNudgeQuickReplies(consumed.quickReplies);
+      setNudgePrompt(consumed.text);
       sendEvent("nudge_open", { nudge_node_id: consumed.messageNodeId, bot_id: consumed.botId });
     } else {
       setNudgeQuickReplies([]);
+      setNudgePrompt(null);
       setActiveNudgeNodeId(void 0);
       const focused = getFocusedTrackEntry(trackRegistry);
       setOpeningLine(
@@ -1799,12 +1808,17 @@ function XbNovaChat({
       markDisclosureSeen();
     }
     setOpen(true);
+    sendEvent("chat_open", { from_nudge: Boolean(consumed) });
     try {
       onOpen?.({ fromNudge: Boolean(consumed), hintText: consumed?.text });
     } catch (err) {
       console.warn("[XbNova] onOpen \uCF5C\uBC31 \uC624\uB958", err);
     }
   }
+  function closeSheet() {
+    setOpen(false);
+    sendEvent("chat_close");
+  }
   if (!open) {
     if (barHidden) return null;
     const showHint = Boolean(hint && hintsEnabled);
@@ -1909,7 +1923,7 @@ function XbNovaChat({
           transition: "opacity 260ms ease-out",
           ...backdropStyle
         },
-        children: /* @__PURE__ */ jsx7("div", { className: "h-full w-full bg-black/45", onClick: () => setOpen(false) })
+        children: /* @__PURE__ */ jsx7("div", { className: "h-full w-full bg-black/45", onClick: closeSheet })
       }
     ) : null,
     /* @__PURE__ */ jsx7(
@@ -1945,7 +1959,7 @@ function XbNovaChat({
               "button",
               {
                 type: "button",
-                onClick: () => setOpen(false),
+                onClick: closeSheet,
                 "aria-label": "\uCC44\uD305 \uB2EB\uAE30",
                 className: "shrink-0 text-neutral-400 hover:text-neutral-700 dark:hover:text-neutral-200",
                 children: "\xD7"
@@ -2004,19 +2018,24 @@ function XbNovaChat({
             /* @__PURE__ */ jsx7("div", { ref: bottomRef })
           ] }),
           (() => {
-            if (nudgeQuickReplies.length > 0) {
-              return /* @__PURE__ */ jsx7("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__ */ jsx7(
-                "button",
-                {
-                  onClick: () => {
-                    setNudgeQuickReplies([]);
-                    send(q);
+            const prompt = messages.length > 0 ? nudgePrompt : null;
+            if (prompt || nudgeQuickReplies.length > 0) {
+              return /* @__PURE__ */ jsxs3("div", { className: "space-y-2 border-t border-neutral-200 px-3.5 py-2.5 dark:border-neutral-700", children: [
+                prompt ? /* @__PURE__ */ jsx7("div", { className: "text-sm font-medium", children: /* @__PURE__ */ jsx7(AssistantMarkdown, { text: prompt }) }) : null,
+                nudgeQuickReplies.length > 0 ? /* @__PURE__ */ jsx7("div", { className: "flex flex-wrap gap-1.5", children: nudgeQuickReplies.map((q) => /* @__PURE__ */ jsx7(
+                  "button",
+                  {
+                    onClick: () => {
+                      setNudgeQuickReplies([]);
+                      setNudgePrompt(null);
+                      send(q, prompt);
+                    },
+                    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;
@@ -2036,7 +2055,8 @@ function XbNovaChat({
               onSubmit: (e) => {
                 e.preventDefault();
                 setNudgeQuickReplies([]);
-                send(input);
+                setNudgePrompt(null);
+                send(input, 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",