@wallavi/widget 1.3.8 → 1.4.0

package/dist/index.d.mts

@@ -119,8 +119,32 @@ interface BubbleWidgetProps extends ChatWidgetConfig {
      * @default true
      */
     autoConfig?: boolean;
+    /**
+     * Hide the floating bubble button. The panel can still be opened via:
+     *   - Keyboard shortcut (keyboardShortcut + shortcutKey)
+     *   - Controlled mode (isOpen + onOpenChange) — connect your own button or trigger
+     * Useful when you want a custom-placed button or a purely keyboard-driven widget.
+     * @default false
+     */
+    hideBubble?: boolean;
+    /**
+     * Controlled open state. When provided the widget becomes fully controlled —
+     * the parent is responsible for managing open/close. Pair with onOpenChange.
+     *
+     * @example
+     * const [chatOpen, setChatOpen] = useState(false);
+     * <button onClick={() => setChatOpen(v => !v)}>Support</button>
+     * <BubbleWidget isOpen={chatOpen} onOpenChange={setChatOpen} hideBubble ... />
+     */
+    isOpen?: boolean;
+    /**
+     * Called whenever the widget wants to change its open state
+     * (bubble click, header close button, Cmd+K, autoOpen).
+     * Use together with isOpen to fully control open/close from outside.
+     */
+    onOpenChange?: (open: boolean) => void;
 }
-declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
+declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, hideBubble, isOpen: isOpenProp, onOpenChange, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
 
 declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 

package/dist/index.d.ts

@@ -119,8 +119,32 @@ interface BubbleWidgetProps extends ChatWidgetConfig {
      * @default true
      */
     autoConfig?: boolean;
+    /**
+     * Hide the floating bubble button. The panel can still be opened via:
+     *   - Keyboard shortcut (keyboardShortcut + shortcutKey)
+     *   - Controlled mode (isOpen + onOpenChange) — connect your own button or trigger
+     * Useful when you want a custom-placed button or a purely keyboard-driven widget.
+     * @default false
+     */
+    hideBubble?: boolean;
+    /**
+     * Controlled open state. When provided the widget becomes fully controlled —
+     * the parent is responsible for managing open/close. Pair with onOpenChange.
+     *
+     * @example
+     * const [chatOpen, setChatOpen] = useState(false);
+     * <button onClick={() => setChatOpen(v => !v)}>Support</button>
+     * <BubbleWidget isOpen={chatOpen} onOpenChange={setChatOpen} hideBubble ... />
+     */
+    isOpen?: boolean;
+    /**
+     * Called whenever the widget wants to change its open state
+     * (bubble click, header close button, Cmd+K, autoOpen).
+     * Use together with isOpen to fully control open/close from outside.
+     */
+    onOpenChange?: (open: boolean) => void;
 }
-declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
+declare function BubbleWidget({ position: positionProp, width, height, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize, panelClassName, autoConfig, hideBubble, isOpen: isOpenProp, onOpenChange, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
 
 declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 

package/dist/index.js

@@ -148,8 +148,10 @@ function useChat({
         { id: assistantMsgId, role: "assistant", parts: [] }
       ]);
       try {
-        const token = typeof window !== "undefined" ? await window.Clerk?.session?.getToken() : null;
-        const res = await fetch(`${API_URL}/api/threads/${threadId}/stream`, {
+        const isPrivate = Boolean(workspaceId);
+        const token = isPrivate && typeof window !== "undefined" ? await window.Clerk?.session?.getToken() : null;
+        const url = isPrivate ? `${API_URL}/api/threads/${threadId}/stream` : `${API_URL}/api/public/chat/stream`;
+        const res = await fetch(url, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -158,14 +160,17 @@ function useChat({
           body: JSON.stringify({
             input: userInput,
             agentId,
-            workspaceId,
+            // Private endpoint: workspaceId + threadId in URL, playgroundOverrides allowed.
+            // Public endpoint: threadId in body (no workspaceId, no playgroundOverrides).
+            ...isPrivate ? { workspaceId, ...playgroundOverrides ? { playgroundOverrides } : {} } : { threadId },
             source,
-            ...playgroundOverrides ? { playgroundOverrides } : {},
             ...userContext?.userName ? { userName: userContext.userName } : {},
             ...userContext?.userEmail ? { userEmail: userContext.userEmail } : {},
             userMetadata: {
               ...userContext?.metadata ?? {},
               ...userContext?.pageContext ? { pageContext: userContext.pageContext } : {},
+              // Forward client auth headers to the pipeline (for action/tool execution).
+              // On the private path, also include the Wallavi Clerk token.
               headers: {
                 ...token ? { Authorization: `Bearer ${token}` } : {},
                 ...userContext?.headers ?? {}
@@ -830,9 +835,19 @@ function BubbleWidget({
   bubbleSize = 52,
   panelClassName,
   autoConfig = true,
+  hideBubble = false,
+  isOpen: isOpenProp,
+  onOpenChange,
   ...chatProps
 }) {
-  const [open, setOpen] = react.useState(false);
+  const isControlled = isOpenProp !== void 0;
+  const [internalOpen, setInternalOpen] = react.useState(false);
+  const open = isControlled ? isOpenProp : internalOpen;
+  const setOpen = react.useCallback((valueOrUpdater) => {
+    const next = typeof valueOrUpdater === "function" ? valueOrUpdater(open) : valueOrUpdater;
+    if (!isControlled) setInternalOpen(next);
+    onOpenChange?.(next);
+  }, [isControlled, open, onOpenChange]);
   const [expanded, setExpanded] = react.useState(false);
   const panelRef = react.useRef(null);
   const autoOpenedRef = react.useRef(false);
@@ -901,7 +916,9 @@ function BubbleWidget({
   }, [open]);
   const handleClose = () => {
     setOpen(false);
-    localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    if (!isControlled) {
+      localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    }
   };
   const toggleExpanded = () => setExpanded((v) => {
     const next = !v;
@@ -948,7 +965,7 @@ function BubbleWidget({
             )
           }
         ),
-        /* @__PURE__ */ jsxRuntime.jsx(
+        !hideBubble && /* @__PURE__ */ jsxRuntime.jsx(
           "button",
           {
             onClick: () => setOpen((v) => !v),

package/dist/index.mjs

@@ -122,8 +122,10 @@ function useChat({
         { id: assistantMsgId, role: "assistant", parts: [] }
       ]);
       try {
-        const token = typeof window !== "undefined" ? await window.Clerk?.session?.getToken() : null;
-        const res = await fetch(`${API_URL}/api/threads/${threadId}/stream`, {
+        const isPrivate = Boolean(workspaceId);
+        const token = isPrivate && typeof window !== "undefined" ? await window.Clerk?.session?.getToken() : null;
+        const url = isPrivate ? `${API_URL}/api/threads/${threadId}/stream` : `${API_URL}/api/public/chat/stream`;
+        const res = await fetch(url, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -132,14 +134,17 @@ function useChat({
           body: JSON.stringify({
             input: userInput,
             agentId,
-            workspaceId,
+            // Private endpoint: workspaceId + threadId in URL, playgroundOverrides allowed.
+            // Public endpoint: threadId in body (no workspaceId, no playgroundOverrides).
+            ...isPrivate ? { workspaceId, ...playgroundOverrides ? { playgroundOverrides } : {} } : { threadId },
             source,
-            ...playgroundOverrides ? { playgroundOverrides } : {},
             ...userContext?.userName ? { userName: userContext.userName } : {},
             ...userContext?.userEmail ? { userEmail: userContext.userEmail } : {},
             userMetadata: {
               ...userContext?.metadata ?? {},
               ...userContext?.pageContext ? { pageContext: userContext.pageContext } : {},
+              // Forward client auth headers to the pipeline (for action/tool execution).
+              // On the private path, also include the Wallavi Clerk token.
               headers: {
                 ...token ? { Authorization: `Bearer ${token}` } : {},
                 ...userContext?.headers ?? {}
@@ -804,9 +809,19 @@ function BubbleWidget({
   bubbleSize = 52,
   panelClassName,
   autoConfig = true,
+  hideBubble = false,
+  isOpen: isOpenProp,
+  onOpenChange,
   ...chatProps
 }) {
-  const [open, setOpen] = useState(false);
+  const isControlled = isOpenProp !== void 0;
+  const [internalOpen, setInternalOpen] = useState(false);
+  const open = isControlled ? isOpenProp : internalOpen;
+  const setOpen = useCallback((valueOrUpdater) => {
+    const next = typeof valueOrUpdater === "function" ? valueOrUpdater(open) : valueOrUpdater;
+    if (!isControlled) setInternalOpen(next);
+    onOpenChange?.(next);
+  }, [isControlled, open, onOpenChange]);
   const [expanded, setExpanded] = useState(false);
   const panelRef = useRef(null);
   const autoOpenedRef = useRef(false);
@@ -875,7 +890,9 @@ function BubbleWidget({
   }, [open]);
   const handleClose = () => {
     setOpen(false);
-    localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    if (!isControlled) {
+      localStorage.setItem(KEY_DISMISSED, String(Date.now() + 24 * 60 * 60 * 1e3));
+    }
   };
   const toggleExpanded = () => setExpanded((v) => {
     const next = !v;
@@ -922,7 +939,7 @@ function BubbleWidget({
             )
           }
         ),
-        /* @__PURE__ */ jsx(
+        !hideBubble && /* @__PURE__ */ jsx(
           "button",
           {
             onClick: () => setOpen((v) => !v),

package/package.json

@@ -33,7 +33,7 @@
   },
   "private": false,
   "types": "./dist/index.d.ts",
-  "version": "1.3.8",
+  "version": "1.4.0",
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit"