@usecrow/ui 0.1.40 → 0.1.41

package/dist/index.d.cts

@@ -243,8 +243,19 @@ interface CrowWidgetProps {
     navigate?: (path: string) => void;
     /** Callback fired when a server-side tool completes, with the tool name and full result data */
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
+    /**
+     * Async function that returns a JWT for user identity verification.
+     * Called on mount and automatically on 401 (token refresh).
+     * Preferred over onIdentify for simpler integration.
+     */
+    getIdentityToken?: () => Promise<string>;
+    /**
+     * Page context data sent with every message. Reactive — updates whenever
+     * the object reference changes. Replaces window.crow('setContext', ...).
+     */
+    context?: Record<string, unknown>;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Shared TypeScript interfaces for the widget and copilot
@@ -399,8 +410,33 @@ interface CrowCopilotProps {
      * ```
      */
     toolRenderers?: ToolRenderers;
+    /**
+     * Async function that returns a JWT for user identity verification.
+     * Called on mount and automatically on 401 (token refresh).
+     * Replaces the need for a separate component calling window.crow('identify').
+     *
+     * @example
+     * ```tsx
+     * getIdentityToken={async () => {
+     *   const res = await fetch('/api/crow-token');
+     *   const { token } = await res.json();
+     *   return token;
+     * }}
+     * ```
+     */
+    getIdentityToken?: () => Promise<string>;
+    /**
+     * Page context data sent with every message. Reactive — updates whenever
+     * the object reference changes. Replaces window.crow('setContext', ...).
+     *
+     * @example
+     * ```tsx
+     * context={{ cmsContentItemId: "abc-123", agentBlogId: "def-456" }}
+     * ```
+     */
+    context?: Record<string, unknown>;
 }
-declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;

package/dist/index.d.ts

@@ -243,8 +243,19 @@ interface CrowWidgetProps {
     navigate?: (path: string) => void;
     /** Callback fired when a server-side tool completes, with the tool name and full result data */
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
+    /**
+     * Async function that returns a JWT for user identity verification.
+     * Called on mount and automatically on 401 (token refresh).
+     * Preferred over onIdentify for simpler integration.
+     */
+    getIdentityToken?: () => Promise<string>;
+    /**
+     * Page context data sent with every message. Reactive — updates whenever
+     * the object reference changes. Replaces window.crow('setContext', ...).
+     */
+    context?: Record<string, unknown>;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Shared TypeScript interfaces for the widget and copilot
@@ -399,8 +410,33 @@ interface CrowCopilotProps {
      * ```
      */
     toolRenderers?: ToolRenderers;
+    /**
+     * Async function that returns a JWT for user identity verification.
+     * Called on mount and automatically on 401 (token refresh).
+     * Replaces the need for a separate component calling window.crow('identify').
+     *
+     * @example
+     * ```tsx
+     * getIdentityToken={async () => {
+     *   const res = await fetch('/api/crow-token');
+     *   const { token } = await res.json();
+     *   return token;
+     * }}
+     * ```
+     */
+    getIdentityToken?: () => Promise<string>;
+    /**
+     * Page context data sent with every message. Reactive — updates whenever
+     * the object reference changes. Replaces window.crow('setContext', ...).
+     *
+     * @example
+     * ```tsx
+     * context={{ cmsContentItemId: "abc-123", agentBlogId: "def-456" }}
+     * ```
+     */
+    context?: Record<string, unknown>;
 }
-declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
+declare function CrowCopilot({ productId, apiUrl, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;

package/dist/index.js

@@ -2898,7 +2898,9 @@ function CrowWidget({
   onIdentify,
   tools,
   navigate,
-  onToolResult
+  onToolResult,
+  getIdentityToken,
+  context
 }) {
   const {
     styles,
@@ -3076,6 +3078,35 @@ function CrowWidget({
       onIdentify(identify);
     }
   }, [isLoadingStyles, onIdentify]);
+  useEffect(() => {
+    if (!getIdentityToken || isLoadingStyles) return;
+    let cancelled = false;
+    const identify = async () => {
+      try {
+        const token = await getIdentityToken();
+        if (!cancelled && token) {
+          window.crow?.("identify", { token });
+        }
+      } catch (e) {
+        console.error("[Crow] getIdentityToken failed:", e);
+      }
+    };
+    identify();
+    const handleRefresh = () => identify();
+    window.addEventListener("crow:token-refresh-needed", handleRefresh);
+    return () => {
+      cancelled = true;
+      window.removeEventListener("crow:token-refresh-needed", handleRefresh);
+    };
+  }, [getIdentityToken, isLoadingStyles]);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    if (context && Object.keys(context).length > 0) {
+      window.__crow_page_context = context;
+    } else {
+      window.__crow_page_context = void 0;
+    }
+  }, [context]);
   const handleBrowserConfirmation = useCallback(
     (instruction) => {
       return new Promise((resolve) => {
@@ -3437,7 +3468,9 @@ function CrowCopilot({
   onReady,
   navigate,
   onToolResult,
-  toolRenderers
+  toolRenderers,
+  getIdentityToken,
+  context
 }) {
   const {
     styles,
@@ -3654,6 +3687,35 @@ function CrowCopilot({
       onReady?.();
     }
   }, [isLoadingStyles, onReady]);
+  useEffect(() => {
+    if (!getIdentityToken || isLoadingStyles) return;
+    let cancelled = false;
+    const identify = async () => {
+      try {
+        const token = await getIdentityToken();
+        if (!cancelled && token) {
+          window.crow?.("identify", { token });
+        }
+      } catch (e) {
+        console.error("[Crow] getIdentityToken failed:", e);
+      }
+    };
+    identify();
+    const handleRefresh = () => identify();
+    window.addEventListener("crow:token-refresh-needed", handleRefresh);
+    return () => {
+      cancelled = true;
+      window.removeEventListener("crow:token-refresh-needed", handleRefresh);
+    };
+  }, [getIdentityToken, isLoadingStyles]);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    if (context && Object.keys(context).length > 0) {
+      window.__crow_page_context = context;
+    } else {
+      window.__crow_page_context = void 0;
+    }
+  }, [context]);
   const handleSend = (message) => {
     if (!message.trim()) return;
     chat.sendMessage(message);