@tambo-ai/react 0.72.0 → 0.73.0

package/esm/v1/providers/tambo-v1-thread-input-provider.js

@@ -0,0 +1,153 @@
+"use client";
+/**
+ * TamboV1ThreadInputProvider - Shared Thread Input Context for v1 API
+ *
+ * Provides shared input state across all components, enabling features like
+ * suggestions to update the input field directly.
+ *
+ * This mirrors the beta SDK's TamboThreadInputProvider pattern.
+ */
+import React, { createContext, useCallback, useContext, useState, } from "react";
+import { useMessageImages, } from "../../hooks/use-message-images";
+import { useTamboMutation, } from "../../hooks/react-query-hooks";
+import { useTamboV1SendMessage } from "../hooks/use-tambo-v1-send-message";
+import { useStreamState } from "./tambo-v1-stream-context";
+// Error messages for various input-related error scenarios.
+// TODO: Reintroduce explicit `NETWORK` and `SERVER` keys once `submit()` maps
+// failures into a small, stable set of user-facing error codes (at minimum:
+// connectivity failures vs non-2xx responses).
+export const INPUT_ERROR_MESSAGES = {
+    EMPTY: "Message cannot be empty",
+    VALIDATION: "Invalid message format",
+};
+function stagedImageToResourceContent(image) {
+    if (!image.dataUrl.startsWith("data:")) {
+        throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);
+    }
+    const commaIndex = image.dataUrl.indexOf(",");
+    if (commaIndex === -1) {
+        throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);
+    }
+    const header = image.dataUrl.slice("data:".length, commaIndex);
+    const [mimeType, ...params] = header.split(";");
+    const isBase64 = params.includes("base64");
+    if (mimeType !== image.type || !isBase64) {
+        throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);
+    }
+    return {
+        type: "resource",
+        resource: {
+            name: image.name,
+            mimeType: image.type,
+            // Shared.Resource.blob expects base64-encoded data; this is the base64
+            // payload from the `data:` URL.
+            blob: image.dataUrl.slice(commaIndex + 1),
+        },
+    };
+}
+/**
+ * Context for thread input state.
+ * @internal
+ */
+export const TamboV1ThreadInputContext = createContext(undefined);
+/**
+ * Provider that manages shared thread input state across all components.
+ *
+ * This ensures that useTamboV1ThreadInput, useTamboV1Suggestions, and other components
+ * all share the same input state.
+ * @param props - Provider props
+ * @param props.children - Child components
+ * @returns Thread input context provider
+ */
+export function TamboV1ThreadInputProvider({ children }) {
+    const [inputValue, setInputValue] = useState("");
+    const [threadId, setThreadId] = useState(undefined);
+    const imageState = useMessageImages();
+    const streamState = useStreamState();
+    // Use the current thread from stream state if no explicit threadId is set
+    const inheritedThreadId = streamState.currentThreadId ?? undefined;
+    const effectiveThreadId = threadId ?? inheritedThreadId;
+    const shouldAdoptThreadId = threadId === undefined && inheritedThreadId === undefined;
+    const sendMessage = useTamboV1SendMessage(effectiveThreadId);
+    const submitFn = useCallback(async (options) => {
+        const trimmedValue = inputValue.trim();
+        // Check if we have content to send
+        if (!trimmedValue && imageState.images.length === 0) {
+            throw new Error(INPUT_ERROR_MESSAGES.EMPTY);
+        }
+        const content = [];
+        if (trimmedValue) {
+            content.push({ type: "text", text: trimmedValue });
+        }
+        for (const image of imageState.images) {
+            content.push(stagedImageToResourceContent(image));
+        }
+        const result = await sendMessage.mutateAsync({
+            message: {
+                role: "user",
+                content,
+            },
+            debug: options?.debug,
+        });
+        // Clear input and images after successful submission
+        setInputValue("");
+        imageState.clearImages();
+        // Update threadId if a new thread was created
+        if (result.threadId && shouldAdoptThreadId) {
+            setThreadId(result.threadId);
+        }
+        return result;
+    }, 
+    // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).
+    [inputValue, imageState, sendMessage, shouldAdoptThreadId]);
+    const { mutateAsync: submitAsync, mutate: _unusedSubmit, ...mutationState } = useTamboMutation({
+        mutationFn: submitFn,
+    });
+    const contextValue = {
+        ...mutationState,
+        value: inputValue,
+        setValue: setInputValue,
+        submit: submitAsync,
+        images: imageState.images,
+        addImage: imageState.addImage,
+        addImages: imageState.addImages,
+        removeImage: imageState.removeImage,
+        clearImages: imageState.clearImages,
+        threadId: effectiveThreadId,
+        setThreadId,
+    };
+    return (React.createElement(TamboV1ThreadInputContext.Provider, { value: contextValue }, children));
+}
+/**
+ * Hook to access the shared thread input state.
+ *
+ * All components using this hook share the same input state, enabling
+ * features like suggestions to update the input field directly.
+ * @returns The shared thread input context
+ * @throws {Error} If used outside TamboV1ThreadInputProvider
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput();
+ *
+ *   return (
+ *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>
+ *       <input
+ *         value={value}
+ *         onChange={(e) => setValue(e.target.value)}
+ *         disabled={isPending}
+ *       />
+ *       <button type="submit" disabled={isPending}>Send</button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+export function useTamboV1ThreadInput() {
+    const context = useContext(TamboV1ThreadInputContext);
+    if (!context) {
+        throw new Error("useTamboV1ThreadInput must be used within TamboV1ThreadInputProvider");
+    }
+    return context;
+}
+//# sourceMappingURL=tambo-v1-thread-input-provider.js.map

package/esm/v1/providers/tambo-v1-thread-input-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-thread-input-provider.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-thread-input-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * TamboV1ThreadInputProvider - Shared Thread Input Context for v1 API\n *\n * Provides shared input state across all components, enabling features like\n * suggestions to update the input field directly.\n *\n * This mirrors the beta SDK's TamboThreadInputProvider pattern.\n */\n\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useState,\n  type PropsWithChildren,\n} from \"react\";\nimport {\n  useMessageImages,\n  type StagedImage,\n} from \"../../hooks/use-message-images\";\nimport {\n  useTamboMutation,\n  type UseTamboMutationResult,\n} from \"../../hooks/react-query-hooks\";\nimport { useTamboV1SendMessage } from \"../hooks/use-tambo-v1-send-message\";\nimport type { InputMessage } from \"../types/message\";\nimport { useStreamState } from \"./tambo-v1-stream-context\";\n\n// Error messages for various input-related error scenarios.\n// TODO: Reintroduce explicit `NETWORK` and `SERVER` keys once `submit()` maps\n// failures into a small, stable set of user-facing error codes (at minimum:\n// connectivity failures vs non-2xx responses).\nexport const INPUT_ERROR_MESSAGES = {\n  EMPTY: \"Message cannot be empty\",\n  VALIDATION: \"Invalid message format\",\n} as const;\n\nfunction stagedImageToResourceContent(\n  image: StagedImage,\n): InputMessage[\"content\"][number] {\n  if (!image.dataUrl.startsWith(\"data:\")) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const commaIndex = image.dataUrl.indexOf(\",\");\n  if (commaIndex === -1) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const header = image.dataUrl.slice(\"data:\".length, commaIndex);\n  const [mimeType, ...params] = header.split(\";\");\n  const isBase64 = params.includes(\"base64\");\n\n  if (mimeType !== image.type || !isBase64) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  return {\n    type: \"resource\",\n    resource: {\n      name: image.name,\n      mimeType: image.type,\n      // Shared.Resource.blob expects base64-encoded data; this is the base64\n      // payload from the `data:` URL.\n      blob: image.dataUrl.slice(commaIndex + 1),\n    },\n  };\n}\n\n/**\n * Options for submitting a message\n */\nexport interface SubmitOptions {\n  /**\n   * Enable debug logging for the stream\n   */\n  debug?: boolean;\n}\n\n/**\n * Context props for thread input state\n */\nexport interface TamboV1ThreadInputContextProps extends Omit<\n  UseTamboMutationResult<\n    { threadId: string | undefined },\n    Error,\n    SubmitOptions | undefined\n  >,\n  \"mutate\" | \"mutateAsync\"\n> {\n  /** Current value of the input field */\n  value: string;\n\n  /**\n   * Function to update the input value\n   * @param value - New value for the input field\n   */\n  setValue: React.Dispatch<React.SetStateAction<string>>;\n\n  /**\n   * Function to submit the current input value\n   * @param options - Submission options\n   * @returns Promise with the threadId\n   */\n  submit: (\n    options?: SubmitOptions,\n  ) => Promise<{ threadId: string | undefined }>;\n\n  /** Currently staged images */\n  images: StagedImage[];\n\n  /** Add a single image */\n  addImage: (file: File) => Promise<void>;\n\n  /** Add multiple images */\n  addImages: (files: File[]) => Promise<void>;\n\n  /** Remove an image by id */\n  removeImage: (id: string) => void;\n\n  /** Clear all staged images */\n  clearImages: () => void;\n\n  /** Current thread ID being used for input */\n  threadId: string | undefined;\n\n  /**\n   * Set the thread ID for input submission.\n   * If not set, a new thread will be created on submit.\n   */\n  setThreadId: React.Dispatch<React.SetStateAction<string | undefined>>;\n}\n\n/**\n * Context for thread input state.\n * @internal\n */\nexport const TamboV1ThreadInputContext = createContext<\n  TamboV1ThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components.\n *\n * This ensures that useTamboV1ThreadInput, useTamboV1Suggestions, and other components\n * all share the same input state.\n * @param props - Provider props\n * @param props.children - Child components\n * @returns Thread input context provider\n */\nexport function TamboV1ThreadInputProvider({ children }: PropsWithChildren) {\n  const [inputValue, setInputValue] = useState(\"\");\n  const [threadId, setThreadId] = useState<string | undefined>(undefined);\n  const imageState = useMessageImages();\n  const streamState = useStreamState();\n\n  // Use the current thread from stream state if no explicit threadId is set\n  const inheritedThreadId = streamState.currentThreadId ?? undefined;\n  const effectiveThreadId = threadId ?? inheritedThreadId;\n  const shouldAdoptThreadId =\n    threadId === undefined && inheritedThreadId === undefined;\n  const sendMessage = useTamboV1SendMessage(effectiveThreadId);\n\n  const submitFn = useCallback(\n    async (\n      options?: SubmitOptions,\n    ): Promise<{ threadId: string | undefined }> => {\n      const trimmedValue = inputValue.trim();\n\n      // Check if we have content to send\n      if (!trimmedValue && imageState.images.length === 0) {\n        throw new Error(INPUT_ERROR_MESSAGES.EMPTY);\n      }\n\n      const content: InputMessage[\"content\"] = [];\n\n      if (trimmedValue) {\n        content.push({ type: \"text\", text: trimmedValue });\n      }\n\n      for (const image of imageState.images) {\n        content.push(stagedImageToResourceContent(image));\n      }\n\n      const result = await sendMessage.mutateAsync({\n        message: {\n          role: \"user\",\n          content,\n        },\n        debug: options?.debug,\n      });\n\n      // Clear input and images after successful submission\n      setInputValue(\"\");\n      imageState.clearImages();\n\n      // Update threadId if a new thread was created\n      if (result.threadId && shouldAdoptThreadId) {\n        setThreadId(result.threadId);\n      }\n\n      return result;\n    },\n    // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).\n    [inputValue, imageState, sendMessage, shouldAdoptThreadId],\n  );\n\n  const {\n    mutateAsync: submitAsync,\n    mutate: _unusedSubmit,\n    ...mutationState\n  } = useTamboMutation({\n    mutationFn: submitFn,\n  });\n\n  const contextValue: TamboV1ThreadInputContextProps = {\n    ...mutationState,\n    value: inputValue,\n    setValue: setInputValue,\n    submit: submitAsync,\n    images: imageState.images,\n    addImage: imageState.addImage,\n    addImages: imageState.addImages,\n    removeImage: imageState.removeImage,\n    clearImages: imageState.clearImages,\n    threadId: effectiveThreadId,\n    setThreadId,\n  };\n\n  return (\n    <TamboV1ThreadInputContext.Provider value={contextValue}>\n      {children}\n    </TamboV1ThreadInputContext.Provider>\n  );\n}\n\n/**\n * Hook to access the shared thread input state.\n *\n * All components using this hook share the same input state, enabling\n * features like suggestions to update the input field directly.\n * @returns The shared thread input context\n * @throws {Error} If used outside TamboV1ThreadInputProvider\n * @example\n * ```tsx\n * function ChatInput() {\n *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput();\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>\n *       <input\n *         value={value}\n *         onChange={(e) => setValue(e.target.value)}\n *         disabled={isPending}\n *       />\n *       <button type=\"submit\" disabled={isPending}>Send</button>\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useTamboV1ThreadInput(): TamboV1ThreadInputContextProps {\n  const context = useContext(TamboV1ThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboV1ThreadInput must be used within TamboV1ThreadInputProvider\",\n    );\n  }\n  return context;\n}\n"]}

package/esm/v1/utils/component-renderer.d.ts

@@ -1,5 +1,10 @@
-import type { ComponentRegistry } from "../../model/component-metadata";
-import type { Content, TamboV1Message, V1ComponentContent } from "../types/message";
+/**
+ * Component Renderer Utility for v1 API
+ *
+ * Provides the component content context for rendered components.
+ * Components can use useV1ComponentContent() to access their context.
+ */
+import React from "react";
 /**
  * Context for component content blocks.
  * Provides access to the component ID and thread ID for component state hooks.
@@ -14,6 +19,14 @@ export interface V1ComponentContentContext {
     /** Component name */
     componentName: string;
 }
+/**
+ * Provider for component content context.
+ * Wraps rendered components to provide access to component metadata.
+ * @returns Provider component with memoized context value
+ */
+export declare function V1ComponentContentProvider({ children, componentId, threadId, messageId, componentName, }: V1ComponentContentContext & {
+    children: React.ReactNode;
+}): React.JSX.Element;
 /**
  * Hook to access the current component content context.
  * Must be used within a rendered component.
@@ -21,69 +34,4 @@ export interface V1ComponentContentContext {
  * @throws {Error} If used outside a rendered component
  */
 export declare function useV1ComponentContent(): V1ComponentContentContext;
-/**
- * Hook to optionally access the current component content context.
- * Returns null if not within a rendered component.
- * @returns Component content context or null
- */
-export declare function useV1ComponentContentOptional(): V1ComponentContentContext | null;
-/**
- * Options for rendering a component content block.
- */
-export interface RenderComponentOptions {
-    /** Thread ID for the component context */
-    threadId: string;
-    /** Message ID the component belongs to */
-    messageId: string;
-    /** Component registry to look up components */
-    componentList: ComponentRegistry;
-}
-/**
- * Check if a content block is a component.
- * @param content - Content block to check
- * @returns True if content is a V1ComponentContent
- */
-export declare function isComponentContent(content: Content): content is V1ComponentContent;
-/**
- * Render a component content block into a React element.
- *
- * Looks up the component in the registry, creates a React element with props,
- * and wraps it with the component content context provider.
- * @param content - Component content block to render
- * @param options - Rendering options including registry and context info
- * @returns V1ComponentContent with the renderedComponent attached
- * @example
- * ```tsx
- * const rendered = renderComponentContent(componentContent, {
- *   threadId: 'thread_123',
- *   messageId: 'msg_456',
- *   componentList: registry.componentList,
- * });
- *
- * // Use in JSX:
- * {rendered.renderedComponent}
- * ```
- */
-export declare function renderComponentContent(content: V1ComponentContent, options: RenderComponentOptions): V1ComponentContent;
-/**
- * Render all component content blocks in a message.
- *
- * Renders component content blocks and attaches renderedComponent.
- * Non-component content blocks are passed through unchanged.
- * @param content - Array of content blocks
- * @param options - Rendering options including registry and context info
- * @returns Array of content with rendered components
- */
-export declare function renderMessageContent(content: Content[], options: RenderComponentOptions): Content[];
-/**
- * Render all components in a message.
- *
- * Creates a new message object with all component content blocks rendered.
- * @param message - Message to render components for
- * @param options - Rendering options (threadId is extracted from message if not provided)
- * @returns Message with rendered component content
- */
-export declare function renderMessageComponents(message: TamboV1Message, options: Omit<RenderComponentOptions, "messageId"> & {
-    threadId: string;
-}): TamboV1Message;
 //# sourceMappingURL=component-renderer.d.ts.map

package/esm/v1/utils/component-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AA+BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,yBAAyB,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,kBAAkB,CAE/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,sBAAsB,GAC9B,kBAAkB,CAwDpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,EAAE,CAQX;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxE,cAAc,CAUhB"}
+{"version":3,"file":"component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,GACd,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAY3D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,CAQjE"}

package/esm/v1/utils/component-renderer.js

@@ -2,47 +2,17 @@
 /**
  * Component Renderer Utility for v1 API
  *
- * Provides utilities for rendering React components from component content blocks.
- * Components are looked up in the registry and wrapped with context providers.
+ * Provides the component content context for rendered components.
+ * Components can use useV1ComponentContent() to access their context.
  */
-import React, { createContext, createElement, useContext, useMemo, } from "react";
-/**
- * Props that should be filtered out when rendering components.
- * These could be used for event handler injection or other security concerns.
- */
-const DANGEROUS_PROP_PATTERNS = [
-    /^on[A-Z]/, // Event handlers (onClick, onError, etc.)
-    /^dangerouslySetInnerHTML$/,
-];
-const DANGEROUS_PROP_NAMES = new Set(["ref", "key", "children"]);
-/**
- * Sanitize props by removing potentially dangerous properties.
- * Filters out event handlers, refs, and other props that could be abused.
- * @param props - Raw props from the component content
- * @returns Sanitized props safe for spreading to components
- */
-function sanitizeProps(props) {
-    const sanitized = {};
-    for (const [key, value] of Object.entries(props)) {
-        // Skip dangerous prop names
-        if (DANGEROUS_PROP_NAMES.has(key)) {
-            continue;
-        }
-        // Skip props matching dangerous patterns
-        if (DANGEROUS_PROP_PATTERNS.some((pattern) => pattern.test(key))) {
-            continue;
-        }
-        sanitized[key] = value;
-    }
-    return sanitized;
-}
+import React, { createContext, useContext, useMemo } from "react";
 const ComponentContentContext = createContext(null);
 /**
  * Provider for component content context.
  * Wraps rendered components to provide access to component metadata.
  * @returns Provider component with memoized context value
  */
-function V1ComponentContentProvider({ children, componentId, threadId, messageId, componentName, }) {
+export function V1ComponentContentProvider({ children, componentId, threadId, messageId, componentName, }) {
     // Memoize context value to prevent unnecessary re-renders of consumers
     const value = useMemo(() => ({ componentId, threadId, messageId, componentName }), [componentId, threadId, messageId, componentName]);
     return (React.createElement(ComponentContentContext.Provider, { value: value }, children));
@@ -60,116 +30,4 @@ export function useV1ComponentContent() {
     }
     return context;
 }
-/**
- * Hook to optionally access the current component content context.
- * Returns null if not within a rendered component.
- * @returns Component content context or null
- */
-export function useV1ComponentContentOptional() {
-    return useContext(ComponentContentContext);
-}
-/**
- * Check if a content block is a component.
- * @param content - Content block to check
- * @returns True if content is a V1ComponentContent
- */
-export function isComponentContent(content) {
-    return content.type === "component";
-}
-/**
- * Render a component content block into a React element.
- *
- * Looks up the component in the registry, creates a React element with props,
- * and wraps it with the component content context provider.
- * @param content - Component content block to render
- * @param options - Rendering options including registry and context info
- * @returns V1ComponentContent with the renderedComponent attached
- * @example
- * ```tsx
- * const rendered = renderComponentContent(componentContent, {
- *   threadId: 'thread_123',
- *   messageId: 'msg_456',
- *   componentList: registry.componentList,
- * });
- *
- * // Use in JSX:
- * {rendered.renderedComponent}
- * ```
- */
-export function renderComponentContent(content, options) {
-    const { threadId, messageId, componentList } = options;
-    // Look up component in registry
-    const registeredComponent = componentList[content.name];
-    if (!registeredComponent) {
-        console.warn(`Component "${content.name}" not found in registry`);
-        return {
-            ...content,
-            renderedComponent: null,
-        };
-    }
-    const Component = registeredComponent.component;
-    const LoadingComponent = registeredComponent.loadingComponent;
-    // Determine if we should show loading state
-    const isStreaming = content.streamingState !== "done";
-    // Sanitize props to prevent injection of event handlers or other dangerous props
-    const props = sanitizeProps(content.props);
-    // Create the component element
-    let element;
-    if (isStreaming && LoadingComponent) {
-        // Show loading component during streaming (with props for partial data display)
-        element = createElement(LoadingComponent, props);
-    }
-    else {
-        // Show main component - props stream in as they're filled out
-        element = createElement(Component, {
-            ...props,
-            // Pass state as initialState prop only if not already provided
-            ...(props.initialState === undefined
-                ? { initialState: content.state }
-                : {}),
-        });
-    }
-    // Wrap with component content context
-    const wrappedElement = (React.createElement(V1ComponentContentProvider, { componentId: content.id, threadId: threadId, messageId: messageId, componentName: content.name }, element));
-    return {
-        ...content,
-        renderedComponent: wrappedElement,
-    };
-}
-/**
- * Render all component content blocks in a message.
- *
- * Renders component content blocks and attaches renderedComponent.
- * Non-component content blocks are passed through unchanged.
- * @param content - Array of content blocks
- * @param options - Rendering options including registry and context info
- * @returns Array of content with rendered components
- */
-export function renderMessageContent(content, options) {
-    return content.map((block) => {
-        if (isComponentContent(block)) {
-            return renderComponentContent(block, options);
-        }
-        // Pass through non-component content unchanged
-        return block;
-    });
-}
-/**
- * Render all components in a message.
- *
- * Creates a new message object with all component content blocks rendered.
- * @param message - Message to render components for
- * @param options - Rendering options (threadId is extracted from message if not provided)
- * @returns Message with rendered component content
- */
-export function renderMessageComponents(message, options) {
-    const renderedContent = renderMessageContent(message.content, {
-        ...options,
-        messageId: message.id,
-    });
-    return {
-        ...message,
-        content: renderedContent,
-    };
-}
 //# sourceMappingURL=component-renderer.js.map

package/esm/v1/utils/component-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-renderer.js","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * Component Renderer Utility for v1 API\n *\n * Provides utilities for rendering React components from component content blocks.\n * Components are looked up in the registry and wrapped with context providers.\n */\n\nimport React, {\n  createContext,\n  createElement,\n  useContext,\n  useMemo,\n  type ReactElement,\n} from \"react\";\n\n/**\n * Props that should be filtered out when rendering components.\n * These could be used for event handler injection or other security concerns.\n */\nconst DANGEROUS_PROP_PATTERNS = [\n  /^on[A-Z]/, // Event handlers (onClick, onError, etc.)\n  /^dangerouslySetInnerHTML$/,\n];\n\nconst DANGEROUS_PROP_NAMES = new Set([\"ref\", \"key\", \"children\"]);\n\n/**\n * Sanitize props by removing potentially dangerous properties.\n * Filters out event handlers, refs, and other props that could be abused.\n * @param props - Raw props from the component content\n * @returns Sanitized props safe for spreading to components\n */\nfunction sanitizeProps(\n  props: Record<string, unknown>,\n): Record<string, unknown> {\n  const sanitized: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(props)) {\n    // Skip dangerous prop names\n    if (DANGEROUS_PROP_NAMES.has(key)) {\n      continue;\n    }\n\n    // Skip props matching dangerous patterns\n    if (DANGEROUS_PROP_PATTERNS.some((pattern) => pattern.test(key))) {\n      continue;\n    }\n\n    sanitized[key] = value;\n  }\n\n  return sanitized;\n}\nimport type { ComponentRegistry } from \"../../model/component-metadata\";\nimport type {\n  Content,\n  TamboV1Message,\n  V1ComponentContent,\n} from \"../types/message\";\n\n/**\n * Context for component content blocks.\n * Provides access to the component ID and thread ID for component state hooks.\n */\nexport interface V1ComponentContentContext {\n  /** Component instance ID */\n  componentId: string;\n  /** Thread ID the component belongs to */\n  threadId: string;\n  /** Message ID the component belongs to */\n  messageId: string;\n  /** Component name */\n  componentName: string;\n}\n\nconst ComponentContentContext = createContext<V1ComponentContentContext | null>(\n  null,\n);\n\n/**\n * Provider for component content context.\n * Wraps rendered components to provide access to component metadata.\n * @returns Provider component with memoized context value\n */\nfunction V1ComponentContentProvider({\n  children,\n  componentId,\n  threadId,\n  messageId,\n  componentName,\n}: V1ComponentContentContext & { children: React.ReactNode }) {\n  // Memoize context value to prevent unnecessary re-renders of consumers\n  const value = useMemo(\n    () => ({ componentId, threadId, messageId, componentName }),\n    [componentId, threadId, messageId, componentName],\n  );\n\n  return (\n    <ComponentContentContext.Provider value={value}>\n      {children}\n    </ComponentContentContext.Provider>\n  );\n}\n\n/**\n * Hook to access the current component content context.\n * Must be used within a rendered component.\n * @returns Component content context\n * @throws {Error} If used outside a rendered component\n */\nexport function useV1ComponentContent(): V1ComponentContentContext {\n  const context = useContext(ComponentContentContext);\n  if (!context) {\n    throw new Error(\n      \"useV1ComponentContent must be used within a rendered component\",\n    );\n  }\n  return context;\n}\n\n/**\n * Hook to optionally access the current component content context.\n * Returns null if not within a rendered component.\n * @returns Component content context or null\n */\nexport function useV1ComponentContentOptional(): V1ComponentContentContext | null {\n  return useContext(ComponentContentContext);\n}\n\n/**\n * Options for rendering a component content block.\n */\nexport interface RenderComponentOptions {\n  /** Thread ID for the component context */\n  threadId: string;\n  /** Message ID the component belongs to */\n  messageId: string;\n  /** Component registry to look up components */\n  componentList: ComponentRegistry;\n}\n\n/**\n * Check if a content block is a component.\n * @param content - Content block to check\n * @returns True if content is a V1ComponentContent\n */\nexport function isComponentContent(\n  content: Content,\n): content is V1ComponentContent {\n  return content.type === \"component\";\n}\n\n/**\n * Render a component content block into a React element.\n *\n * Looks up the component in the registry, creates a React element with props,\n * and wraps it with the component content context provider.\n * @param content - Component content block to render\n * @param options - Rendering options including registry and context info\n * @returns V1ComponentContent with the renderedComponent attached\n * @example\n * ```tsx\n * const rendered = renderComponentContent(componentContent, {\n *   threadId: 'thread_123',\n *   messageId: 'msg_456',\n *   componentList: registry.componentList,\n * });\n *\n * // Use in JSX:\n * {rendered.renderedComponent}\n * ```\n */\nexport function renderComponentContent(\n  content: V1ComponentContent,\n  options: RenderComponentOptions,\n): V1ComponentContent {\n  const { threadId, messageId, componentList } = options;\n\n  // Look up component in registry\n  const registeredComponent = componentList[content.name];\n\n  if (!registeredComponent) {\n    console.warn(`Component \"${content.name}\" not found in registry`);\n    return {\n      ...content,\n      renderedComponent: null,\n    };\n  }\n\n  const Component = registeredComponent.component;\n  const LoadingComponent = registeredComponent.loadingComponent;\n\n  // Determine if we should show loading state\n  const isStreaming = content.streamingState !== \"done\";\n\n  // Sanitize props to prevent injection of event handlers or other dangerous props\n  const props = sanitizeProps(content.props as Record<string, unknown>);\n\n  // Create the component element\n  let element: ReactElement;\n\n  if (isStreaming && LoadingComponent) {\n    // Show loading component during streaming (with props for partial data display)\n    element = createElement(LoadingComponent, props);\n  } else {\n    // Show main component - props stream in as they're filled out\n    element = createElement(Component, {\n      ...props,\n      // Pass state as initialState prop only if not already provided\n      ...(props.initialState === undefined\n        ? { initialState: content.state }\n        : {}),\n    });\n  }\n\n  // Wrap with component content context\n  const wrappedElement = (\n    <V1ComponentContentProvider\n      componentId={content.id}\n      threadId={threadId}\n      messageId={messageId}\n      componentName={content.name}\n    >\n      {element}\n    </V1ComponentContentProvider>\n  );\n\n  return {\n    ...content,\n    renderedComponent: wrappedElement,\n  };\n}\n\n/**\n * Render all component content blocks in a message.\n *\n * Renders component content blocks and attaches renderedComponent.\n * Non-component content blocks are passed through unchanged.\n * @param content - Array of content blocks\n * @param options - Rendering options including registry and context info\n * @returns Array of content with rendered components\n */\nexport function renderMessageContent(\n  content: Content[],\n  options: RenderComponentOptions,\n): Content[] {\n  return content.map((block) => {\n    if (isComponentContent(block)) {\n      return renderComponentContent(block, options);\n    }\n    // Pass through non-component content unchanged\n    return block;\n  });\n}\n\n/**\n * Render all components in a message.\n *\n * Creates a new message object with all component content blocks rendered.\n * @param message - Message to render components for\n * @param options - Rendering options (threadId is extracted from message if not provided)\n * @returns Message with rendered component content\n */\nexport function renderMessageComponents(\n  message: TamboV1Message,\n  options: Omit<RenderComponentOptions, \"messageId\"> & { threadId: string },\n): TamboV1Message {\n  const renderedContent = renderMessageContent(message.content, {\n    ...options,\n    messageId: message.id,\n  });\n\n  return {\n    ...message,\n    content: renderedContent,\n  };\n}\n"]}
+{"version":3,"file":"component-renderer.js","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAiBlE,MAAM,uBAAuB,GAAG,aAAa,CAC3C,IAAI,CACL,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,GAC6C;IAC1D,uEAAuE;IACvE,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,EAC3D,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,CAClD,CAAC;IAEF,OAAO,CACL,oBAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IAC3C,QAAQ,CACwB,CACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["\"use client\";\n\n/**\n * Component Renderer Utility for v1 API\n *\n * Provides the component content context for rendered components.\n * Components can use useV1ComponentContent() to access their context.\n */\n\nimport React, { createContext, useContext, useMemo } from \"react\";\n\n/**\n * Context for component content blocks.\n * Provides access to the component ID and thread ID for component state hooks.\n */\nexport interface V1ComponentContentContext {\n  /** Component instance ID */\n  componentId: string;\n  /** Thread ID the component belongs to */\n  threadId: string;\n  /** Message ID the component belongs to */\n  messageId: string;\n  /** Component name */\n  componentName: string;\n}\n\nconst ComponentContentContext = createContext<V1ComponentContentContext | null>(\n  null,\n);\n\n/**\n * Provider for component content context.\n * Wraps rendered components to provide access to component metadata.\n * @returns Provider component with memoized context value\n */\nexport function V1ComponentContentProvider({\n  children,\n  componentId,\n  threadId,\n  messageId,\n  componentName,\n}: V1ComponentContentContext & { children: React.ReactNode }) {\n  // Memoize context value to prevent unnecessary re-renders of consumers\n  const value = useMemo(\n    () => ({ componentId, threadId, messageId, componentName }),\n    [componentId, threadId, messageId, componentName],\n  );\n\n  return (\n    <ComponentContentContext.Provider value={value}>\n      {children}\n    </ComponentContentContext.Provider>\n  );\n}\n\n/**\n * Hook to access the current component content context.\n * Must be used within a rendered component.\n * @returns Component content context\n * @throws {Error} If used outside a rendered component\n */\nexport function useV1ComponentContent(): V1ComponentContentContext {\n  const context = useContext(ComponentContentContext);\n  if (!context) {\n    throw new Error(\n      \"useV1ComponentContent must be used within a rendered component\",\n    );\n  }\n  return context;\n}\n"]}