@usecrow/ui 0.1.54 → 0.1.56

package/dist/index.d.cts

@@ -341,6 +341,8 @@ interface CrowWidgetProps {
     productId: string;
     /** API URL (defaults to relative path) */
     apiUrl?: string;
+    /** Subdomain for multi-endpoint routing */
+    subdomain?: string;
     /** Widget variant: floating (with bubble) or embedded (for preview) */
     variant?: "floating" | "embedded";
     /** Custom styles to override DB and default styles */
@@ -382,14 +384,21 @@ interface CrowWidgetProps {
      * exists for its name, that component is rendered inline in the chat.
      */
     toolRenderers?: ToolRenderers;
+    /**
+     * ISO 639-1 language code (e.g., "es", "fr", "ja"). When set, the AI
+     * responds in that language and the welcome message is translated.
+     */
+    language?: string;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
     productId: string;
     /** API URL (defaults to relative path) */
     apiUrl?: string;
+    /** Subdomain for multi-endpoint routing */
+    subdomain?: string;
     /** Copilot variant: embedded (in-app) or floating (with toggle button) */
     variant?: "embedded" | "floating";
     /** Title shown in header (fallback if agentName not provided) */
@@ -458,8 +467,13 @@ interface CrowCopilotProps {
      * ```
      */
     context?: Record<string, unknown>;
+    /**
+     * ISO 639-1 language code (e.g., "es", "fr", "ja"). When set, the AI
+     * responds in that language and the welcome message is translated.
+     */
+    language?: string;
 }
-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;
+declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -467,7 +481,7 @@ interface CrowProviderProps extends CrowClientConfig {
 /**
  * Provider component that creates and shares a CrowClient instance
  */
-declare function CrowProvider({ children, productId, apiUrl, model, }: CrowProviderProps): react_jsx_runtime.JSX.Element;
+declare function CrowProvider({ children, productId, apiUrl, model, subdomain, }: CrowProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Default Widget and Copilot Styles
@@ -653,10 +667,14 @@ interface UseChatOptions {
     welcomeMessage?: string;
     /** AI model to use for this chat (defaults to DEFAULT_MODEL) */
     selectedModel?: string;
+    /** Subdomain for multi-endpoint products (routes to specific backend config) */
+    subdomain?: string;
     /** Per-tool consent settings — when a tool has requires_consent, show Allow/Deny before executing */
     toolConsentSettings?: Record<string, {
         requires_consent: boolean;
     }>;
+    /** ISO 639-1 language code (e.g., "es", "fr") — AI will respond in this language */
+    language?: string;
     onVerificationStatus?: (isVerified: boolean) => void;
     onConversationId?: (id: string) => void;
     onWorkflowEvent?: (event: WorkflowEvent) => void;
@@ -664,7 +682,7 @@ interface UseChatOptions {
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
     onRestoredConversation?: (conversationId: string) => void;
 }
-declare function useChat({ productId, apiUrl, persistAnonymousConversations, welcomeMessage, selectedModel: initialSelectedModel, toolConsentSettings, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onToolResult, onRestoredConversation, }: UseChatOptions): {
+declare function useChat({ productId, apiUrl, persistAnonymousConversations, welcomeMessage, selectedModel: initialSelectedModel, subdomain, toolConsentSettings, language, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onToolResult, onRestoredConversation, }: UseChatOptions): {
     messages: Message[];
     isLoading: boolean;
     activeToolCalls: ToolCall[];
@@ -811,6 +829,8 @@ interface UseWidgetStylesOptions {
     skip?: boolean;
     /** Cache key override (defaults to productId) */
     cacheKey?: string;
+    /** ISO 639-1 language code for welcome message translation */
+    language?: string;
 }
 interface UseWidgetStylesResult {
     /** Fully resolved styles ready for use */
@@ -863,6 +883,8 @@ interface UseCopilotStylesOptions {
     skip?: boolean;
     /** Cache key override (defaults to productId) */
     cacheKey?: string;
+    /** ISO 639-1 language code for welcome message translation */
+    language?: string;
 }
 interface UseCopilotStylesResult {
     /** Fully resolved styles ready for use */
@@ -908,7 +930,7 @@ interface UseCopilotStylesResult {
  * });
  * ```
  */
-declare function useWidgetStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, }: UseWidgetStylesOptions): UseWidgetStylesResult;
+declare function useWidgetStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, language, }: UseWidgetStylesOptions): UseWidgetStylesResult;
 /**
  * Hook to fetch and merge copilot styles
  *
@@ -920,7 +942,7 @@ declare function useWidgetStyles$1({ productId, apiUrl, propStyles, skip, cacheK
  * });
  * ```
  */
-declare function useCopilotStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, }: UseCopilotStylesOptions): UseCopilotStylesResult;
+declare function useCopilotStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, language, }: UseCopilotStylesOptions): UseCopilotStylesResult;
 /**
  * Clear the style cache (useful for testing or forcing refetch)
  */

package/dist/index.d.ts

@@ -341,6 +341,8 @@ interface CrowWidgetProps {
     productId: string;
     /** API URL (defaults to relative path) */
     apiUrl?: string;
+    /** Subdomain for multi-endpoint routing */
+    subdomain?: string;
     /** Widget variant: floating (with bubble) or embedded (for preview) */
     variant?: "floating" | "embedded";
     /** Custom styles to override DB and default styles */
@@ -382,14 +384,21 @@ interface CrowWidgetProps {
      * exists for its name, that component is rendered inline in the chat.
      */
     toolRenderers?: ToolRenderers;
+    /**
+     * ISO 639-1 language code (e.g., "es", "fr", "ja"). When set, the AI
+     * responds in that language and the welcome message is translated.
+     */
+    language?: string;
 }
-declare function CrowWidget({ productId, apiUrl, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
+declare function CrowWidget({ productId, apiUrl, subdomain, variant, styles: propStyles, previewMode, showThinking: showThinkingProp, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, onReady, onIdentify, tools, navigate, onToolResult, getIdentityToken, context, toolRenderers, language, }: CrowWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface CrowCopilotProps {
     /** Product ID for this copilot */
     productId: string;
     /** API URL (defaults to relative path) */
     apiUrl?: string;
+    /** Subdomain for multi-endpoint routing */
+    subdomain?: string;
     /** Copilot variant: embedded (in-app) or floating (with toggle button) */
     variant?: "embedded" | "floating";
     /** Title shown in header (fallback if agentName not provided) */
@@ -458,8 +467,13 @@ interface CrowCopilotProps {
      * ```
      */
     context?: Record<string, unknown>;
+    /**
+     * ISO 639-1 language code (e.g., "es", "fr", "ja"). When set, the AI
+     * responds in that language and the welcome message is translated.
+     */
+    language?: string;
 }
-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;
+declare function CrowCopilot({ productId, apiUrl, subdomain, variant, title, agentName: agentNameProp, welcomeMessage: welcomeMessageProp, position, width, defaultOpen, showClose, onClose, styles: propStyles, previewMode, className, onReady, navigate, onToolResult, toolRenderers, getIdentityToken, context, language, }: CrowCopilotProps): react_jsx_runtime.JSX.Element;
 
 interface CrowProviderProps extends CrowClientConfig {
     children: React.ReactNode;
@@ -467,7 +481,7 @@ interface CrowProviderProps extends CrowClientConfig {
 /**
  * Provider component that creates and shares a CrowClient instance
  */
-declare function CrowProvider({ children, productId, apiUrl, model, }: CrowProviderProps): react_jsx_runtime.JSX.Element;
+declare function CrowProvider({ children, productId, apiUrl, model, subdomain, }: CrowProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Default Widget and Copilot Styles
@@ -653,10 +667,14 @@ interface UseChatOptions {
     welcomeMessage?: string;
     /** AI model to use for this chat (defaults to DEFAULT_MODEL) */
     selectedModel?: string;
+    /** Subdomain for multi-endpoint products (routes to specific backend config) */
+    subdomain?: string;
     /** Per-tool consent settings — when a tool has requires_consent, show Allow/Deny before executing */
     toolConsentSettings?: Record<string, {
         requires_consent: boolean;
     }>;
+    /** ISO 639-1 language code (e.g., "es", "fr") — AI will respond in this language */
+    language?: string;
     onVerificationStatus?: (isVerified: boolean) => void;
     onConversationId?: (id: string) => void;
     onWorkflowEvent?: (event: WorkflowEvent) => void;
@@ -664,7 +682,7 @@ interface UseChatOptions {
     onToolResult?: (toolName: string, result: Record<string, unknown>) => void;
     onRestoredConversation?: (conversationId: string) => void;
 }
-declare function useChat({ productId, apiUrl, persistAnonymousConversations, welcomeMessage, selectedModel: initialSelectedModel, toolConsentSettings, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onToolResult, onRestoredConversation, }: UseChatOptions): {
+declare function useChat({ productId, apiUrl, persistAnonymousConversations, welcomeMessage, selectedModel: initialSelectedModel, subdomain, toolConsentSettings, language, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onToolResult, onRestoredConversation, }: UseChatOptions): {
     messages: Message[];
     isLoading: boolean;
     activeToolCalls: ToolCall[];
@@ -811,6 +829,8 @@ interface UseWidgetStylesOptions {
     skip?: boolean;
     /** Cache key override (defaults to productId) */
     cacheKey?: string;
+    /** ISO 639-1 language code for welcome message translation */
+    language?: string;
 }
 interface UseWidgetStylesResult {
     /** Fully resolved styles ready for use */
@@ -863,6 +883,8 @@ interface UseCopilotStylesOptions {
     skip?: boolean;
     /** Cache key override (defaults to productId) */
     cacheKey?: string;
+    /** ISO 639-1 language code for welcome message translation */
+    language?: string;
 }
 interface UseCopilotStylesResult {
     /** Fully resolved styles ready for use */
@@ -908,7 +930,7 @@ interface UseCopilotStylesResult {
  * });
  * ```
  */
-declare function useWidgetStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, }: UseWidgetStylesOptions): UseWidgetStylesResult;
+declare function useWidgetStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, language, }: UseWidgetStylesOptions): UseWidgetStylesResult;
 /**
  * Hook to fetch and merge copilot styles
  *
@@ -920,7 +942,7 @@ declare function useWidgetStyles$1({ productId, apiUrl, propStyles, skip, cacheK
  * });
  * ```
  */
-declare function useCopilotStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, }: UseCopilotStylesOptions): UseCopilotStylesResult;
+declare function useCopilotStyles$1({ productId, apiUrl, propStyles, skip, cacheKey, language, }: UseCopilotStylesOptions): UseCopilotStylesResult;
 /**
  * Clear the style cache (useful for testing or forcing refetch)
  */

package/dist/index.js

@@ -44,7 +44,9 @@ function useChat({
   persistAnonymousConversations,
   welcomeMessage,
   selectedModel: initialSelectedModel,
+  subdomain,
   toolConsentSettings,
+  language,
   onVerificationStatus,
   onConversationId,
   onWorkflowEvent,
@@ -126,10 +128,12 @@ function useChat({
             conversation_id: conversationId,
             identity_token: identityToken,
             model: selectedModel,
+            subdomain,
             user_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
             user_local_time: (/* @__PURE__ */ new Date()).toLocaleString("en-US", { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "numeric", hour12: true }),
             page_path: typeof window !== "undefined" ? window.location.pathname : void 0,
-            context: typeof window !== "undefined" ? window.__crow_page_context : void 0
+            context: typeof window !== "undefined" ? window.__crow_page_context : void 0,
+            ...language && language !== "en" ? { language } : {}
           }),
           signal: abortControllerRef.current.signal
         });
@@ -458,7 +462,7 @@ function useChat({
         abortControllerRef.current = null;
       }
     },
-    [apiUrl, productId, conversationId, selectedModel, persistAnonymousConversations, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onToolResult]
+    [apiUrl, productId, conversationId, selectedModel, subdomain, persistAnonymousConversations, onVerificationStatus, onConversationId, onWorkflowEvent, onToolCall, onToolResult]
   );
   const sendMessage = useCallback(
     (content) => {
@@ -549,8 +553,10 @@ function useChat({
             result,
             identity_token: identityToken,
             model: selectedModel,
+            subdomain,
             user_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-            user_local_time: (/* @__PURE__ */ new Date()).toLocaleString("en-US", { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "numeric", hour12: true })
+            user_local_time: (/* @__PURE__ */ new Date()).toLocaleString("en-US", { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "numeric", hour12: true }),
+            ...language && language !== "en" ? { language } : {}
           })
         });
         if (!response.ok) {
@@ -827,7 +833,7 @@ function useChat({
         setIsLoading(false);
       }
     },
-    [apiUrl, productId, conversationId, selectedModel]
+    [apiUrl, productId, conversationId, selectedModel, subdomain]
   );
   const addMessage = useCallback(
     async (role, content) => {
@@ -1511,9 +1517,12 @@ function stylesToCSSVariables(styles) {
 
 // src/hooks/useWidgetStyles.ts
 var styleCache = /* @__PURE__ */ new Map();
-async function fetchWidgetConfig(productId, apiUrl) {
+async function fetchWidgetConfig(productId, apiUrl, language) {
   const baseUrl = apiUrl || "";
-  const url = `${baseUrl}/api/products/${productId}/widget-config`;
+  let url = `${baseUrl}/api/products/${productId}/widget-config`;
+  if (language && language !== "en") {
+    url += `?language=${encodeURIComponent(language)}`;
+  }
   const response = await fetch(url);
   if (!response.ok) {
     throw new Error(`Failed to fetch widget config: ${response.status} ${response.statusText}`);
@@ -1525,9 +1534,10 @@ function useWidgetStyles({
   apiUrl,
   propStyles,
   skip = false,
-  cacheKey
+  cacheKey,
+  language
 }) {
-  const key = cacheKey || productId;
+  const key = cacheKey || (language && language !== "en" ? `${productId}:${language}` : productId);
   const [isLoading, setIsLoading] = useState(!skip && !styleCache.has(key));
   const [error, setError] = useState(null);
   const [dbStyles, setDbStyles] = useState(
@@ -1567,7 +1577,7 @@ function useWidgetStyles({
     setIsLoading(true);
     setError(null);
     try {
-      const config = await fetchWidgetConfig(productId, apiUrl);
+      const config = await fetchWidgetConfig(productId, apiUrl, language);
       styleCache.set(key, config);
       setDbStyles(config.widgetStyles);
       setAgentName(config.agentName || "Assistant");
@@ -1627,9 +1637,10 @@ function useCopilotStyles({
   apiUrl,
   propStyles,
   skip = false,
-  cacheKey
+  cacheKey,
+  language
 }) {
-  const key = cacheKey || productId;
+  const key = cacheKey || (language && language !== "en" ? `${productId}:${language}` : productId);
   const [isLoading, setIsLoading] = useState(!skip && !styleCache.has(key));
   const [error, setError] = useState(null);
   const [dbStyles, setDbStyles] = useState(
@@ -1663,7 +1674,7 @@ function useCopilotStyles({
     setIsLoading(true);
     setError(null);
     try {
-      const config = await fetchWidgetConfig(productId, apiUrl);
+      const config = await fetchWidgetConfig(productId, apiUrl, language);
       styleCache.set(key, config);
       setDbStyles(config.copilotStyles);
       setAgentName(config.agentName || "Assistant");
@@ -3487,6 +3498,7 @@ function injectStyles(target = document) {
 function CrowWidget({
   productId,
   apiUrl = "",
+  subdomain,
   variant = "floating",
   styles: propStyles,
   previewMode = false,
@@ -3500,7 +3512,8 @@ function CrowWidget({
   onToolResult,
   getIdentityToken,
   context,
-  toolRenderers
+  toolRenderers,
+  language
 }) {
   const effectiveGetIdentityToken = getIdentityToken || window.__crow_identity_token_fetcher;
   const effectiveOnToolResult = onToolResult || window.__crow_on_tool_result;
@@ -3522,7 +3535,8 @@ function CrowWidget({
     productId,
     apiUrl,
     propStyles,
-    skip: previewMode
+    skip: previewMode,
+    language
   });
   const agentName = agentNameProp ?? agentNameFromAPI;
   const welcomeMessage = welcomeMessageProp ?? welcomeMessageFromAPI;
@@ -3560,7 +3574,9 @@ function CrowWidget({
     persistAnonymousConversations,
     welcomeMessage,
     selectedModel,
+    subdomain,
     toolConsentSettings,
+    language,
     onVerificationStatus: (isVerified) => {
       setIsVerifiedUser(isVerified);
     },
@@ -4303,6 +4319,7 @@ function CopilotContainer({
 function CrowCopilot({
   productId,
   apiUrl = "",
+  subdomain,
   variant = "embedded",
   title = "Copilot",
   agentName: agentNameProp,
@@ -4320,7 +4337,8 @@ function CrowCopilot({
   onToolResult,
   toolRenderers,
   getIdentityToken,
-  context
+  context,
+  language
 }) {
   const effectiveGetIdentityToken = getIdentityToken || window.__crow_identity_token_fetcher;
   const effectiveOnToolResult = onToolResult || window.__crow_on_tool_result;
@@ -4340,7 +4358,8 @@ function CrowCopilot({
     productId,
     apiUrl,
     propStyles,
-    skip: previewMode
+    skip: previewMode,
+    language
   });
   const agentName = agentNameProp ?? agentNameFromAPI ?? title;
   const welcomeMessage = welcomeMessageProp ?? welcomeMessageFromAPI;
@@ -4526,7 +4545,9 @@ function CrowCopilot({
     persistAnonymousConversations,
     welcomeMessage,
     selectedModel,
+    subdomain,
     toolConsentSettings,
+    language,
     onVerificationStatus: (isVerified) => {
       setIsVerifiedUser(isVerified);
     },
@@ -5413,11 +5434,12 @@ function CrowProvider({
   children,
   productId,
   apiUrl,
-  model
+  model,
+  subdomain
 }) {
   const clientRef = useRef(null);
   if (!clientRef.current) {
-    clientRef.current = new CrowClient({ productId, apiUrl, model });
+    clientRef.current = new CrowClient({ productId, apiUrl, model, subdomain });
   }
   const client = clientRef.current;
   useEffect(() => {