@helpway/react 0.1.0 → 0.1.1

package/dist/index.js

@@ -1,32 +1,3 @@
-// src/helpway-widget.tsx
-import { useEffect } from "react";
-function HelpwayWidget({
-  apiKey,
-  src = "https://api.helpway.ai/widget.js"
-}) {
-  useEffect(() => {
-    if (typeof document === "undefined") return;
-    const existing = document.querySelector(
-      `script[data-helpway-loader="${apiKey}"]`
-    );
-    if (existing) return;
-    const s = document.createElement("script");
-    s.src = src;
-    s.dataset.key = apiKey;
-    s.dataset.helpwayLoader = apiKey;
-    s.defer = true;
-    document.body.appendChild(s);
-    return () => {
-      s.remove();
-      try {
-        window.dispatchEvent(new CustomEvent("helpway:cleanup"));
-      } catch {
-      }
-    };
-  }, [apiKey, src]);
-  return null;
-}
-
 // ../widget-core/src/client.ts
 import { createTRPCClient, httpBatchLink } from "@trpc/client";
 
@@ -740,7 +711,7 @@ import {
   createContext,
   useCallback,
   useContext,
-  useEffect as useEffect2,
+  useEffect,
   useRef,
   useState
 } from "react";
@@ -811,7 +782,7 @@ function SupportProvider({
     setHasBootstrapError(false);
     setBootstrapAttempt((n) => n + 1);
   }, []);
-  useEffect2(() => {
+  useEffect(() => {
     let cancelled = false;
     async function bootstrap() {
       try {
@@ -903,7 +874,7 @@ function SupportProvider({
       ws.disconnect();
     };
   }, [client, store, ws, bootstrapAttempt]);
-  useEffect2(() => {
+  useEffect(() => {
     if (locale != null) {
       setLocale(locale);
     }
@@ -936,176 +907,20 @@ function inferApiUrl() {
   return typeof window !== "undefined" ? window.location.origin : "http://localhost:52500";
 }
 
-// src/hooks/use-widget.ts
-function useWidget() {
-  const { client } = useWidgetContext();
-  const isReady = useWidgetStore((s) => s.isReady);
-  const isConnecting = useWidgetStore((s) => s.isConnecting);
-  const visitor = useWidgetStore((s) => s.visitor);
-  const website = useWidgetStore((s) => s.website);
-  const agentConfig = useWidgetStore((s) => s.agentConfig);
-  async function identify(data) {
-    return client.widget.identify.mutate(data);
-  }
-  return { isReady, isConnecting, visitor, website, agentConfig, identify };
-}
-
-// src/hooks/use-conversations.ts
-import { useCallback as useCallback2, useRef as useRef2, useState as useState2 } from "react";
-function useConversations() {
-  const { client, store } = useWidgetContext();
-  const conversations = useWidgetStore((s) => s.conversations);
-  const setActiveConversation = useWidgetStore((s) => s.setActiveConversation);
-  const [isCreating, setIsCreating] = useState2(false);
-  const clientRef = useRef2(client);
-  const storeRef = useRef2(store);
-  clientRef.current = client;
-  storeRef.current = store;
-  const create = useCallback2(async (text) => {
-    setIsCreating(true);
-    const tempConversationId = `temp-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
-    const now = (/* @__PURE__ */ new Date()).toISOString();
-    const optimisticMessageId = `optimistic-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
-    const currentVisitorId = storeRef.current.getState().visitor?.id ?? null;
-    const optimisticMsg = {
-      id: optimisticMessageId,
-      conversationId: tempConversationId,
-      organizationId: "",
-      type: "message",
-      visibility: "public",
-      text,
-      parts: null,
-      userId: null,
-      visitorId: currentVisitorId,
-      aiAgentId: null,
-      createdAt: now,
-      editedAt: null,
-      deletedAt: null
-    };
-    const store2 = storeRef.current.getState();
-    store2.addConversation({
-      id: tempConversationId,
-      title: null,
-      status: "open",
-      lastMessageText: text,
-      lastMessageAt: now,
-      unreadCount: 0
-    });
-    store2.setMessages(tempConversationId, [optimisticMsg]);
-    store2.setActiveConversation(tempConversationId);
-    try {
-      const result = await clientRef.current.widget.createConversation.mutate({ text });
-      const conv = result.conversation;
-      storeRef.current.getState().remapConversationId(tempConversationId, conv.id);
-      if (result.item) {
-        storeRef.current.getState().replaceMessage(conv.id, optimisticMessageId, result.item);
-      }
-      if (result.welcomeItem) {
-        const welcome = result.welcomeItem;
-        const existing = storeRef.current.getState().messages.get(conv.id) ?? [];
-        const withoutWelcome = existing.filter((m) => m.id !== welcome.id);
-        storeRef.current.getState().setMessages(conv.id, [welcome, ...withoutWelcome]);
-      }
-      return conv;
-    } catch (err) {
-      storeRef.current.getState().removeMessage(tempConversationId, optimisticMessageId);
-      const convs = storeRef.current.getState().conversations.filter((c) => c.id !== tempConversationId);
-      storeRef.current.setState({ conversations: convs, activeConversationId: null });
-      throw err;
-    } finally {
-      setIsCreating(false);
-    }
-  }, []);
-  return { conversations, create, isCreating, setActiveConversation };
-}
-
-// src/hooks/use-timeline.ts
-import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef3, useState as useState3 } from "react";
-var EMPTY_ITEMS = [];
-function useTimeline(conversationId) {
-  const { client, store } = useWidgetContext();
-  const messages = useWidgetStore(
-    (s) => conversationId ? s.messages.get(conversationId) ?? EMPTY_ITEMS : EMPTY_ITEMS
-  );
-  const [isLoading, setIsLoading] = useState3(false);
-  const [hasMore, setHasMore] = useState3(false);
-  const cursorRef = useRef3(void 0);
-  const clientRef = useRef3(client);
-  const storeRef = useRef3(store);
-  clientRef.current = client;
-  storeRef.current = store;
-  useEffect3(() => {
-    if (!conversationId) return;
-    if (conversationId.startsWith("temp-")) return;
-    let cancelled = false;
-    const existingMessages = storeRef.current.getState().messages.get(conversationId);
-    const hasSeed = !!existingMessages && existingMessages.length > 0;
-    if (hasSeed) {
-      storeRef.current.getState().clearUnread(conversationId);
-      clientRef.current.widget.markSeen.mutate({ conversationId }).catch(() => {
-      });
-      return () => {
-        cancelled = true;
-      };
-    }
-    setIsLoading(true);
-    async function load() {
-      try {
-        const data = await clientRef.current.widget.getTimeline.query({
-          conversationId,
-          limit: 50
-        });
-        if (cancelled) return;
-        if (data.items.length > 0) {
-          storeRef.current.getState().setMessages(conversationId, data.items);
-        }
-        setHasMore(data.hasMore);
-        cursorRef.current = data.nextCursor ?? void 0;
-        storeRef.current.getState().clearUnread(conversationId);
-        clientRef.current.widget.markSeen.mutate({ conversationId }).catch(() => {
-        });
-      } catch (err) {
-        console.error("[useTimeline] Failed to load:", err);
-      } finally {
-        if (!cancelled) setIsLoading(false);
-      }
-    }
-    load();
-    return () => {
-      cancelled = true;
-    };
-  }, [conversationId]);
-  const loadMore = useCallback3(async () => {
-    if (!conversationId || !hasMore || isLoading) return;
-    setIsLoading(true);
-    try {
-      const data = await clientRef.current.widget.getTimeline.query({
-        conversationId,
-        cursor: cursorRef.current,
-        limit: 50
-      });
-      const existing = storeRef.current.getState().messages.get(conversationId) ?? [];
-      storeRef.current.getState().setMessages(conversationId, [...data.items, ...existing]);
-      setHasMore(data.hasMore);
-      cursorRef.current = data.nextCursor ?? void 0;
-    } finally {
-      setIsLoading(false);
-    }
-  }, [conversationId, hasMore, isLoading]);
-  return { items: messages, isLoading, hasMore, loadMore };
-}
+// src/themed/default-widget.tsx
+import { useCallback as useCallback12, useEffect as useEffect10, useRef as useRef13, useState as useState12 } from "react";
 
 // src/hooks/use-composer.ts
-import { useCallback as useCallback4, useState as useState4 } from "react";
+import { useCallback as useCallback2, useState as useState2 } from "react";
 var MAX_ATTACHMENTS = 10;
 var MAX_FILE_SIZE = 10 * 1024 * 1024;
 function useComposer(conversationId) {
   const { client, ws, store } = useWidgetContext();
-  const [text, setText] = useState4("");
-  const [isSubmitting, setIsSubmitting] = useState4(false);
-  const [attachments, setAttachments] = useState4([]);
-  const [sendError, setSendError] = useState4(null);
-  const addFiles = useCallback4(
+  const [text, setText] = useState2("");
+  const [isSubmitting, setIsSubmitting] = useState2(false);
+  const [attachments, setAttachments] = useState2([]);
+  const [sendError, setSendError] = useState2(null);
+  const addFiles = useCallback2(
     async (files) => {
       if (!conversationId) return;
       const remaining = MAX_ATTACHMENTS - attachments.length;
@@ -1148,14 +963,14 @@ function useComposer(conversationId) {
     },
     [conversationId, attachments.length, client]
   );
-  const removeAttachment = useCallback4((id) => {
+  const removeAttachment = useCallback2((id) => {
     setAttachments((prev) => {
       const item = prev.find((a) => a.id === id);
       if (item?.previewUrl) URL.revokeObjectURL(item.previewUrl);
       return prev.filter((a) => a.id !== id);
     });
   }, []);
-  const submit = useCallback4(async () => {
+  const submit = useCallback2(async () => {
     const trimmed = text.trim();
     const readyParts = attachments.filter((a) => a.part !== null).map((a) => a.part);
     const hasText = trimmed.length > 0;
@@ -1232,7 +1047,7 @@ function useComposer(conversationId) {
       setIsSubmitting(false);
     }
   }, [text, attachments, conversationId, isSubmitting, client, ws, store]);
-  const clearSendError = useCallback4(() => setSendError(null), []);
+  const clearSendError = useCallback2(() => setSendError(null), []);
   return {
     text,
     setText,
@@ -1259,8 +1074,89 @@ function fileToBase64(file) {
   });
 }
 
+// src/hooks/use-conversations.ts
+import { useCallback as useCallback3, useRef as useRef2, useState as useState3 } from "react";
+function useConversations() {
+  const { client, store } = useWidgetContext();
+  const conversations = useWidgetStore((s) => s.conversations);
+  const setActiveConversation = useWidgetStore((s) => s.setActiveConversation);
+  const [isCreating, setIsCreating] = useState3(false);
+  const clientRef = useRef2(client);
+  const storeRef = useRef2(store);
+  clientRef.current = client;
+  storeRef.current = store;
+  const create = useCallback3(async (text) => {
+    setIsCreating(true);
+    const tempConversationId = `temp-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const optimisticMessageId = `optimistic-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+    const currentVisitorId = storeRef.current.getState().visitor?.id ?? null;
+    const optimisticMsg = {
+      id: optimisticMessageId,
+      conversationId: tempConversationId,
+      organizationId: "",
+      type: "message",
+      visibility: "public",
+      text,
+      parts: null,
+      userId: null,
+      visitorId: currentVisitorId,
+      aiAgentId: null,
+      createdAt: now,
+      editedAt: null,
+      deletedAt: null
+    };
+    const store2 = storeRef.current.getState();
+    store2.addConversation({
+      id: tempConversationId,
+      title: null,
+      status: "open",
+      lastMessageText: text,
+      lastMessageAt: now,
+      unreadCount: 0
+    });
+    store2.setMessages(tempConversationId, [optimisticMsg]);
+    store2.setActiveConversation(tempConversationId);
+    try {
+      const result = await clientRef.current.widget.createConversation.mutate({ text });
+      const conv = result.conversation;
+      storeRef.current.getState().remapConversationId(tempConversationId, conv.id);
+      if (result.item) {
+        storeRef.current.getState().replaceMessage(conv.id, optimisticMessageId, result.item);
+      }
+      if (result.welcomeItem) {
+        const welcome = result.welcomeItem;
+        const existing = storeRef.current.getState().messages.get(conv.id) ?? [];
+        const withoutWelcome = existing.filter((m) => m.id !== welcome.id);
+        storeRef.current.getState().setMessages(conv.id, [welcome, ...withoutWelcome]);
+      }
+      return conv;
+    } catch (err) {
+      storeRef.current.getState().removeMessage(tempConversationId, optimisticMessageId);
+      const convs = storeRef.current.getState().conversations.filter((c) => c.id !== tempConversationId);
+      storeRef.current.setState({ conversations: convs, activeConversationId: null });
+      throw err;
+    } finally {
+      setIsCreating(false);
+    }
+  }, []);
+  return { conversations, create, isCreating, setActiveConversation };
+}
+
+// src/hooks/use-i18n.ts
+import { useEffect as useEffect2, useState as useState4 } from "react";
+function useI18n() {
+  const [rev, setRev] = useState4(() => getI18nRevision());
+  useEffect2(() => {
+    return onLocaleChange(() => {
+      setRev(getI18nRevision());
+    });
+  }, []);
+  return rev;
+}
+
 // src/hooks/use-presence.ts
-import { useCallback as useCallback5, useRef as useRef4 } from "react";
+import { useCallback as useCallback4, useRef as useRef3 } from "react";
 function usePresence(conversationId) {
   const { ws } = useWidgetContext();
   const isTyping = useWidgetStore(
@@ -1269,9 +1165,9 @@ function usePresence(conversationId) {
   const isAiProcessing = useWidgetStore(
     (s) => conversationId ? s.aiProcessing.get(conversationId) ?? false : false
   );
-  const typingTimer = useRef4(null);
-  const isSendingTyping = useRef4(false);
-  const setTyping = useCallback5(
+  const typingTimer = useRef3(null);
+  const isSendingTyping = useRef3(false);
+  const setTyping = useCallback4(
     (typing) => {
       if (!conversationId) return;
       if (typingTimer.current) clearTimeout(typingTimer.current);
@@ -1296,6 +1192,82 @@ function usePresence(conversationId) {
   return { isTyping, isAiProcessing, setTyping };
 }
 
+// src/hooks/use-timeline.ts
+import { useCallback as useCallback5, useEffect as useEffect3, useRef as useRef4, useState as useState5 } from "react";
+var EMPTY_ITEMS = [];
+function useTimeline(conversationId) {
+  const { client, store } = useWidgetContext();
+  const messages = useWidgetStore(
+    (s) => conversationId ? s.messages.get(conversationId) ?? EMPTY_ITEMS : EMPTY_ITEMS
+  );
+  const [isLoading, setIsLoading] = useState5(false);
+  const [hasMore, setHasMore] = useState5(false);
+  const cursorRef = useRef4(void 0);
+  const clientRef = useRef4(client);
+  const storeRef = useRef4(store);
+  clientRef.current = client;
+  storeRef.current = store;
+  useEffect3(() => {
+    if (!conversationId) return;
+    if (conversationId.startsWith("temp-")) return;
+    let cancelled = false;
+    const existingMessages = storeRef.current.getState().messages.get(conversationId);
+    const hasSeed = !!existingMessages && existingMessages.length > 0;
+    if (hasSeed) {
+      storeRef.current.getState().clearUnread(conversationId);
+      clientRef.current.widget.markSeen.mutate({ conversationId }).catch(() => {
+      });
+      return () => {
+        cancelled = true;
+      };
+    }
+    setIsLoading(true);
+    async function load() {
+      try {
+        const data = await clientRef.current.widget.getTimeline.query({
+          conversationId,
+          limit: 50
+        });
+        if (cancelled) return;
+        if (data.items.length > 0) {
+          storeRef.current.getState().setMessages(conversationId, data.items);
+        }
+        setHasMore(data.hasMore);
+        cursorRef.current = data.nextCursor ?? void 0;
+        storeRef.current.getState().clearUnread(conversationId);
+        clientRef.current.widget.markSeen.mutate({ conversationId }).catch(() => {
+        });
+      } catch (err) {
+        console.error("[useTimeline] Failed to load:", err);
+      } finally {
+        if (!cancelled) setIsLoading(false);
+      }
+    }
+    load();
+    return () => {
+      cancelled = true;
+    };
+  }, [conversationId]);
+  const loadMore = useCallback5(async () => {
+    if (!conversationId || !hasMore || isLoading) return;
+    setIsLoading(true);
+    try {
+      const data = await clientRef.current.widget.getTimeline.query({
+        conversationId,
+        cursor: cursorRef.current,
+        limit: 50
+      });
+      const existing = storeRef.current.getState().messages.get(conversationId) ?? [];
+      storeRef.current.getState().setMessages(conversationId, [...data.items, ...existing]);
+      setHasMore(data.hasMore);
+      cursorRef.current = data.nextCursor ?? void 0;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [conversationId, hasMore, isLoading]);
+  return { items: messages, isLoading, hasMore, loadMore };
+}
+
 // src/hooks/use-unread.ts
 function useUnread() {
   const totalUnread = useWidgetStore(
@@ -1304,28 +1276,18 @@ function useUnread() {
   return { totalUnread };
 }
 
-// src/hooks/use-realtime.ts
-import { useEffect as useEffect4 } from "react";
-function useRealtime(handler) {
-  const { ws } = useWidgetContext();
-  useEffect4(() => {
-    return ws.onEvent(handler);
-  }, [ws, handler]);
-}
-
-// src/themed/default-widget.tsx
-import { useCallback as useCallback12, useEffect as useEffect12, useRef as useRef13, useState as useState12 } from "react";
-
-// src/hooks/use-i18n.ts
-import { useEffect as useEffect5, useState as useState5 } from "react";
-function useI18n() {
-  const [rev, setRev] = useState5(() => getI18nRevision());
-  useEffect5(() => {
-    return onLocaleChange(() => {
-      setRev(getI18nRevision());
-    });
-  }, []);
-  return rev;
+// src/hooks/use-widget.ts
+function useWidget() {
+  const { client } = useWidgetContext();
+  const isReady = useWidgetStore((s) => s.isReady);
+  const isConnecting = useWidgetStore((s) => s.isConnecting);
+  const visitor = useWidgetStore((s) => s.visitor);
+  const website = useWidgetStore((s) => s.website);
+  const agentConfig = useWidgetStore((s) => s.agentConfig);
+  async function identify(data) {
+    return client.widget.identify.mutate(data);
+  }
+  return { isReady, isConnecting, visitor, website, agentConfig, identify };
 }
 
 // src/themed/composer.tsx
@@ -1359,7 +1321,7 @@ import { useCallback as useCallback6, useLayoutEffect, useRef as useRef6, useSta
 import { createPortal } from "react-dom";
 
 // src/themed/content/simple-markdown.tsx
-import { useEffect as useEffect6, useRef as useRef5 } from "react";
+import { useEffect as useEffect4, useRef as useRef5 } from "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
 function renderMarkdown(md) {
   const codeBlocks = [];
@@ -1421,7 +1383,7 @@ function MarkdownContent({
 }) {
   const rootRef = useRef5(null);
   const html = bodyHtml ?? (bodyMarkdown ? renderMarkdown(bodyMarkdown) : "");
-  useEffect6(() => {
+  useEffect4(() => {
     const root = rootRef.current;
     if (!root) return;
     const handler = (e) => {
@@ -1929,7 +1891,7 @@ function extractFiles(data) {
 }
 
 // src/themed/debug-overlay.tsx
-import { useEffect as useEffect7, useMemo, useRef as useRef8, useState as useState8 } from "react";
+import { useEffect as useEffect5, useMemo, useRef as useRef8, useState as useState8 } from "react";
 import { jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
 var MAX_EVENTS = 60;
 function isDebugEnabled() {
@@ -1956,7 +1918,7 @@ function WidgetDebugOverlay() {
   const typingUsers = useWidgetStore((s) => s.typingUsers);
   const aiProcessingMap = useWidgetStore((s) => s.aiProcessing);
   const { store } = useWidgetContext();
-  useEffect7(() => {
+  useEffect5(() => {
     setEnabled(isDebugEnabled());
   }, []);
   const pushEvent = useMemo(
@@ -1971,7 +1933,7 @@ function WidgetDebugOverlay() {
     },
     []
   );
-  useEffect7(() => {
+  useEffect5(() => {
     if (!enabled) return;
     if (typeof window === "undefined" || typeof window.fetch !== "function") return;
     const originalFetch = window.fetch.bind(window);
@@ -2003,7 +1965,7 @@ function WidgetDebugOverlay() {
       window.fetch = originalFetch;
     };
   }, [enabled, pushEvent]);
-  useEffect7(() => {
+  useEffect5(() => {
     if (!enabled) return;
     const original = store.getState().handleRealtimeEvent;
     store.setState({
@@ -2022,7 +1984,7 @@ function WidgetDebugOverlay() {
     [activeMessages]
   );
   const prevSigRef = useRef8(lastMsgSignature);
-  useEffect7(() => {
+  useEffect5(() => {
     if (!enabled) return;
     if (prevSigRef.current !== lastMsgSignature) {
       prevSigRef.current = lastMsgSignature;
@@ -2175,10 +2137,10 @@ var styles = {
 };
 
 // src/themed/content/content-tab-view.tsx
-import { useCallback as useCallback11, useEffect as useEffect10 } from "react";
+import { useCallback as useCallback11, useEffect as useEffect8 } from "react";
 
 // src/hooks/use-content-tab.ts
-import { useCallback as useCallback8, useEffect as useEffect8, useState as useState9 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect6, useState as useState9 } from "react";
 var EMPTY_TABS = [];
 function listKey(tabId, lang) {
   return `flat:${tabId}:${lang}:list`;
@@ -2293,7 +2255,7 @@ function useContentTab(tabId) {
   const clearDetail = useCallback8(() => {
     setDetail(null);
   }, []);
-  useEffect8(() => {
+  useEffect6(() => {
     if (tab && entries.length === 0) {
       fetchEntries({ page: 1, reset: true });
     }
@@ -2439,7 +2401,7 @@ function ContentEntryCard({
 }
 
 // src/themed/content/grouped-content-tab-view.tsx
-import { useEffect as useEffect9, useRef as useRef11 } from "react";
+import { useEffect as useEffect7, useRef as useRef11 } from "react";
 
 // src/hooks/use-grouped-content-tab.ts
 import { useCallback as useCallback10, useRef as useRef10, useState as useState11 } from "react";
@@ -2683,16 +2645,16 @@ function GroupedContentTabView({
     fetchDetail,
     clearCategory
   } = useGroupedContentTab(tab.id);
-  useEffect9(() => {
+  useEffect7(() => {
     initFetch();
   }, [initFetch]);
-  useEffect9(() => {
+  useEffect7(() => {
     if (detailSlug && subView === "content-detail") {
       fetchDetail(detailSlug);
     }
   }, [detailSlug, subView, fetchDetail]);
   const prevSubView = useRef11(subView);
-  useEffect9(() => {
+  useEffect7(() => {
     if (prevSubView.current === "content-category" && subView === null) {
       clearCategory();
     }
@@ -2786,7 +2748,7 @@ function FlatContentTabView({
     loadMore,
     fetchDetail
   } = useContentTab(tab.id);
-  useEffect10(() => {
+  useEffect8(() => {
     if (detailSlug) fetchDetail(detailSlug);
   }, [detailSlug, fetchDetail]);
   const handleSearch = useCallback11(
@@ -2829,7 +2791,7 @@ function ContentTabIconComponent({ icon }) {
 }
 
 // src/themed/message-list.tsx
-import React, { useEffect as useEffect11, useRef as useRef12 } from "react";
+import React, { useEffect as useEffect9, useRef as useRef12 } from "react";
 import { jsx as jsx11, jsxs as jsxs6 } from "react/jsx-runtime";
 function parseParts(raw) {
   if (!raw) return null;
@@ -2857,7 +2819,7 @@ function MessageList({
   const prevItemCountRef = useRef12(items.length);
   const isInitialLoadRef = useRef12(true);
   const agentName = useWidgetStore((s) => s.agentConfig?.name) ?? t("widget.better_ai");
-  useEffect11(() => {
+  useEffect9(() => {
     const prevCount = prevItemCountRef.current;
     const newCount = items.length;
     prevItemCountRef.current = newCount;
@@ -2872,12 +2834,12 @@ function MessageList({
       isInitialLoadRef.current = false;
     }
   }, [items]);
-  useEffect11(() => {
+  useEffect9(() => {
     if (isTyping || isAiProcessing) {
       bottomRef.current?.scrollIntoView({ behavior: "smooth" });
     }
   }, [isTyping, isAiProcessing]);
-  useEffect11(() => {
+  useEffect9(() => {
     if (!hasMore || !onLoadMore || !topRef.current) return;
     const observer = new IntersectionObserver(
       (entries) => {
@@ -3313,7 +3275,7 @@ function DefaultWidget({ initialOpen = false } = {}) {
       handleClose();
     }
   }, [handleClose]);
-  useEffect12(() => {
+  useEffect10(() => {
     if (!isOpen || !windowRef.current) return;
     const vv = window.visualViewport;
     if (!vv) return;
@@ -3330,7 +3292,7 @@ function DefaultWidget({ initialOpen = false } = {}) {
       win.style.removeProperty("--hw-visible-height");
     };
   }, [isOpen]);
-  useEffect12(() => {
+  useEffect10(() => {
     if (!isOpen || !windowRef.current) return;
     const win = windowRef.current;
     const handleKeyDown = (e) => {
@@ -3346,7 +3308,7 @@ function DefaultWidget({ initialOpen = false } = {}) {
     win.addEventListener("keydown", handleKeyDown);
     return () => win.removeEventListener("keydown", handleKeyDown);
   }, [isOpen, subView, handleClose, goBack]);
-  useEffect12(() => {
+  useEffect10(() => {
     if (!isOpen || !windowRef.current) return;
     const win = windowRef.current;
     const getFocusable = () => win.querySelectorAll(
@@ -4091,7 +4053,7 @@ function MessagePreview({ onOpen }) {
   const dismissPreview = useWidgetStore((s) => s.dismissPreview);
   const agentName = useWidgetStore((s) => s.agentConfig?.name) ?? "Support";
   const [closing, setClosing] = useState12(false);
-  useEffect12(() => {
+  useEffect10(() => {
     if (!preview) return;
     const timer = setTimeout(() => {
       setClosing(true);
@@ -4139,6 +4101,40 @@ function MessagePreview({ onOpen }) {
     }
   );
 }
+
+// src/helpway-widget.tsx
+import { jsx as jsx13 } from "react/jsx-runtime";
+function HelpwayWidget({
+  apiKey,
+  apiUrl,
+  locale,
+  initialConversationId,
+  onReady,
+  // eslint-disable-next-line @typescript-eslint/no-deprecated
+  src
+}) {
+  const resolvedApiUrl = apiUrl ?? (src ? src.replace(/\/widget\.js$/, "") : void 0);
+  return /* @__PURE__ */ jsx13(
+    SupportProvider,
+    {
+      apiKey,
+      apiUrl: resolvedApiUrl,
+      locale,
+      initialConversationId,
+      onReady,
+      children: /* @__PURE__ */ jsx13(DefaultWidget, {})
+    }
+  );
+}
+
+// src/hooks/use-realtime.ts
+import { useEffect as useEffect11 } from "react";
+function useRealtime(handler) {
+  const { ws } = useWidgetContext();
+  useEffect11(() => {
+    return ws.onEvent(handler);
+  }, [ws, handler]);
+}
 export {
   Composer,
   DefaultWidget,