@tambo-ai/react 0.32.1 → 0.34.0

package/dist/hooks/__tests__/use-tambo-stream-status.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-tambo-stream-status.test.d.ts.map

package/dist/hooks/__tests__/use-tambo-stream-status.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-stream-status.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/use-tambo-stream-status.test.tsx"],"names":[],"mappings":""}

package/dist/hooks/__tests__/use-tambo-stream-status.test.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("@testing-library/react");
+const generate_component_response_1 = require("../../model/generate-component-response");
+const tambo_thread_provider_1 = require("../../providers/tambo-thread-provider");
+const use_current_message_1 = require("../use-current-message");
+const use_tambo_stream_status_1 = require("../use-tambo-stream-status");
+// Mock the required providers
+jest.mock("../../providers/tambo-thread-provider", () => ({
+    useTamboThread: jest.fn(),
+}));
+jest.mock("../use-current-message", () => ({
+    useTamboCurrentMessage: jest.fn(),
+}));
+// Mock window for SSR tests
+const originalWindow = global.window;
+// Helper function to create mock ComponentDecisionV2
+const createMockComponent = (props = {}) => ({
+    componentName: "TestComponent",
+    componentState: {},
+    message: "Component generated",
+    props,
+    reasoning: "Test reasoning",
+});
+// Helper function to create mock TamboThreadMessage
+const createMockMessage = (overrides = {}) => ({
+    id: "test-message",
+    componentState: {},
+    content: [{ type: "text", text: "test content" }],
+    createdAt: new Date().toISOString(),
+    role: "assistant",
+    threadId: "test-thread",
+    ...overrides,
+});
+describe("useTamboStreamStatus", () => {
+    beforeEach(() => {
+        // Restore window for client-side tests
+        global.window = originalWindow;
+        // Default mock implementations
+        jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+            generationStage: generate_component_response_1.GenerationStage.IDLE,
+        });
+        jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue({
+            id: "test-message",
+            component: {
+                props: {},
+            },
+        });
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    describe("Initial State", () => {
+        it("should start with all flags as pending when idle and no props", () => {
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.IDLE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "", body: "" }),
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            expect(result.current.streamStatus).toEqual({
+                isPending: true,
+                isStreaming: false,
+                isSuccess: false,
+                isError: false,
+                streamError: undefined,
+            });
+            expect(result.current.propStatus.title).toEqual({
+                isPending: true,
+                isStreaming: false,
+                isSuccess: false,
+                error: undefined,
+            });
+            expect(result.current.propStatus.body).toEqual({
+                isPending: true,
+                isStreaming: false,
+                isSuccess: false,
+                error: undefined,
+            });
+        });
+    });
+    describe("Generation vs Props Streaming", () => {
+        it("should show generation streaming but props still pending when STREAMING_RESPONSE with no prop content", () => {
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.STREAMING_RESPONSE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "", body: "" }),
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // Global streaming should be false because no props are actually streaming yet
+            expect(result.current.streamStatus.isStreaming).toBe(false);
+            expect(result.current.streamStatus.isPending).toBe(false);
+            // Individual props should be pending because they haven't started streaming yet
+            expect(result.current.propStatus.title.isPending).toBe(true);
+            expect(result.current.propStatus.title.isStreaming).toBe(false);
+            expect(result.current.propStatus.body.isPending).toBe(true);
+            expect(result.current.propStatus.body.isStreaming).toBe(false);
+        });
+        it("should show prop streaming when props receive content during STREAMING_RESPONSE", () => {
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.STREAMING_RESPONSE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "Hello", body: "" }),
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // Title prop should be streaming since it has content
+            expect(result.current.propStatus.title.isStreaming).toBe(true);
+            expect(result.current.propStatus.title.isPending).toBe(false);
+            // Body prop should still be pending since it has no content
+            expect(result.current.propStatus.body.isStreaming).toBe(false);
+            expect(result.current.propStatus.body.isPending).toBe(true);
+            // Global should be streaming because at least one prop is streaming
+            expect(result.current.streamStatus.isStreaming).toBe(true);
+        });
+    });
+    describe("Boolean Lifecycle", () => {
+        it("should transition through Init -> Streaming -> Success lifecycle", () => {
+            // Start with IDLE (Init phase)
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.IDLE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "", body: "" }),
+            }));
+            const { result, rerender } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // Phase 1: Init - isPending = true
+            expect(result.current.streamStatus.isPending).toBe(true);
+            expect(result.current.streamStatus.isStreaming).toBe(false);
+            expect(result.current.streamStatus.isSuccess).toBe(false);
+            // Phase 2: Streaming - move to STREAMING_RESPONSE with content
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.STREAMING_RESPONSE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({
+                    title: "Hello World",
+                    body: "Some content",
+                }),
+            }));
+            rerender();
+            expect(result.current.streamStatus.isPending).toBe(false);
+            expect(result.current.streamStatus.isStreaming).toBe(true);
+            expect(result.current.streamStatus.isSuccess).toBe(false);
+            // Phase 3: Complete - move to COMPLETE
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.COMPLETE,
+            });
+            rerender();
+            expect(result.current.streamStatus.isPending).toBe(false);
+            expect(result.current.streamStatus.isStreaming).toBe(false);
+            expect(result.current.streamStatus.isSuccess).toBe(true);
+        });
+        it("should handle error state correctly", () => {
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.ERROR,
+            });
+            const errorMessage = "Generation failed";
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "", body: "" }),
+                error: errorMessage,
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            expect(result.current.streamStatus.isPending).toBe(true);
+            expect(result.current.streamStatus.isStreaming).toBe(false);
+            expect(result.current.streamStatus.isSuccess).toBe(false);
+            expect(result.current.streamStatus.isError).toBe(true);
+            expect(result.current.streamStatus.streamError?.message).toBe(errorMessage);
+        });
+    });
+    describe("Derivation Rules", () => {
+        it("should derive isPending correctly (no generation activity AND all props pending)", () => {
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.IDLE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "", body: "", footer: "" }),
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // All props are pending and no generation activity
+            expect(result.current.streamStatus.isPending).toBe(true);
+            expect(result.current.propStatus.title.isPending).toBe(true);
+            expect(result.current.propStatus.body.isPending).toBe(true);
+            expect(result.current.propStatus.footer.isPending).toBe(true);
+        });
+        it("should derive isStreaming correctly (generation streaming OR any prop streaming)", () => {
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.COMPLETE,
+            });
+            // One prop still streaming
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({
+                    title: "Complete Title",
+                    body: "Still streaming...",
+                }),
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // Should be streaming because at least one prop is streaming
+            expect(result.current.streamStatus.isStreaming).toBe(false); // Note: this will be false in our implementation because props are considered complete when generation is COMPLETE
+        });
+        it("should derive isSuccess correctly (generation complete AND all props successful)", () => {
+            // Step 1: Start with streaming, props empty
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.STREAMING_RESPONSE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({
+                    title: "",
+                    body: "",
+                }),
+            }));
+            const { result, rerender } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // Step 2: Simulate streaming in title
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({
+                    title: "Complete Title",
+                    body: "",
+                }),
+            }));
+            rerender();
+            // Step 3: Simulate streaming in body
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({
+                    title: "Complete Title",
+                    body: "Complete Body",
+                }),
+            }));
+            rerender();
+            // Step 4: Generation complete
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.COMPLETE,
+            });
+            rerender();
+            // Now both props should be successful
+            expect(result.current.propStatus.title.isSuccess).toBe(true);
+            expect(result.current.propStatus.body.isSuccess).toBe(true);
+            expect(result.current.streamStatus.isSuccess).toBe(true);
+        });
+        it("should derive isError correctly (generation error OR any prop error)", () => {
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.COMPLETE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({
+                    title: "Good Title",
+                    body: "Good Body",
+                }),
+                error: "Something went wrong",
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            expect(result.current.streamStatus.isError).toBe(true);
+            expect(result.current.streamStatus.streamError?.message).toBe("Something went wrong");
+        });
+    });
+    describe("Type Safety", () => {
+        it("should provide strongly typed prop status based on generic", () => {
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({
+                    title: "Test",
+                    description: "Test desc",
+                    count: 42,
+                }),
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // TypeScript should infer these keys correctly
+            expect(result.current.propStatus.title).toBeDefined();
+            expect(result.current.propStatus.description).toBeDefined();
+            expect(result.current.propStatus.count).toBeDefined();
+            // This would cause a TypeScript error if uncommented:
+            // expect(result.current.propStatus.nonExistentProp).toBeDefined();
+        });
+        it("should work without generic type parameter", () => {
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ dynamicProp: "value" }),
+            }));
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            expect(result.current.streamStatus).toBeDefined();
+            expect(result.current.propStatus).toBeDefined();
+        });
+    });
+    describe("Edge Cases", () => {
+        it("should handle missing message gracefully", () => {
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(undefined);
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            expect(result.current.streamStatus.isPending).toBe(true);
+            expect(result.current.propStatus).toEqual({});
+        });
+        it("should handle missing component props gracefully", () => {
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue({
+                id: "test-message",
+                // Missing component property
+            });
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            expect(result.current.streamStatus.isPending).toBe(true);
+            expect(result.current.propStatus).toEqual({});
+        });
+        it("should reset prop tracking when generation restarts", () => {
+            // Step 1: Complete a message
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.STREAMING_RESPONSE,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "" }),
+            }));
+            const { result, rerender } = (0, react_1.renderHook)(() => (0, use_tambo_stream_status_1.useTamboStreamStatus)());
+            // Simulate streaming in title
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                component: createMockComponent({ title: "First Title" }),
+            }));
+            rerender();
+            // Complete generation
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.COMPLETE,
+            });
+            rerender();
+            // Should be successful initially
+            expect(result.current.propStatus.title.isSuccess).toBe(true);
+            // Step 2: Start new generation with a new message ID to trigger reset
+            jest.mocked(tambo_thread_provider_1.useTamboThread).mockReturnValue({
+                generationStage: generate_component_response_1.GenerationStage.CHOOSING_COMPONENT,
+            });
+            jest.mocked(use_current_message_1.useTamboCurrentMessage).mockReturnValue(createMockMessage({
+                id: "new-message-id", // Different message ID to trigger reset
+                component: createMockComponent({ title: "" }),
+            }));
+            rerender();
+            // Should reset to pending
+            expect(result.current.propStatus.title.isPending).toBe(true);
+            expect(result.current.propStatus.title.isSuccess).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=use-tambo-stream-status.test.js.map

package/dist/hooks/__tests__/use-tambo-stream-status.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-stream-status.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/use-tambo-stream-status.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { renderHook } from \"@testing-library/react\";\nimport {\n  GenerationStage,\n  TamboThreadMessage,\n} from \"../../model/generate-component-response\";\nimport {\n  TamboThreadContextProps,\n  useTamboThread,\n} from \"../../providers/tambo-thread-provider\";\nimport { useTamboCurrentMessage } from \"../use-current-message\";\nimport { useTamboStreamStatus } from \"../use-tambo-stream-status\";\n\n// Mock the required providers\njest.mock(\"../../providers/tambo-thread-provider\", () => ({\n  useTamboThread: jest.fn(),\n}));\n\njest.mock(\"../use-current-message\", () => ({\n  useTamboCurrentMessage: jest.fn(),\n}));\n\n// Mock window for SSR tests\nconst originalWindow = global.window;\n\n// Helper function to create mock ComponentDecisionV2\nconst createMockComponent = (props: Record<string, unknown> = {}): any => ({\n  componentName: \"TestComponent\",\n  componentState: {},\n  message: \"Component generated\",\n  props,\n  reasoning: \"Test reasoning\",\n});\n\n// Helper function to create mock TamboThreadMessage\nconst createMockMessage = (\n  overrides: Partial<TamboThreadMessage> = {},\n): TamboThreadMessage => ({\n  id: \"test-message\",\n  componentState: {},\n  content: [{ type: \"text\", text: \"test content\" }],\n  createdAt: new Date().toISOString(),\n  role: \"assistant\",\n  threadId: \"test-thread\",\n  ...overrides,\n});\n\ndescribe(\"useTamboStreamStatus\", () => {\n  beforeEach(() => {\n    // Restore window for client-side tests\n    global.window = originalWindow;\n\n    // Default mock implementations\n    jest.mocked(useTamboThread).mockReturnValue({\n      generationStage: GenerationStage.IDLE,\n    } as TamboThreadContextProps);\n\n    jest.mocked(useTamboCurrentMessage).mockReturnValue({\n      id: \"test-message\",\n      component: {\n        props: {},\n      },\n    } as TamboThreadMessage);\n  });\n\n  afterEach(() => {\n    jest.clearAllMocks();\n  });\n\n  describe(\"Initial State\", () => {\n    it(\"should start with all flags as pending when idle and no props\", () => {\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.IDLE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"\", body: \"\" }),\n        }),\n      );\n\n      const { result } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      expect(result.current.streamStatus).toEqual({\n        isPending: true,\n        isStreaming: false,\n        isSuccess: false,\n        isError: false,\n        streamError: undefined,\n      });\n\n      expect(result.current.propStatus.title).toEqual({\n        isPending: true,\n        isStreaming: false,\n        isSuccess: false,\n        error: undefined,\n      });\n\n      expect(result.current.propStatus.body).toEqual({\n        isPending: true,\n        isStreaming: false,\n        isSuccess: false,\n        error: undefined,\n      });\n    });\n  });\n\n  describe(\"Generation vs Props Streaming\", () => {\n    it(\"should show generation streaming but props still pending when STREAMING_RESPONSE with no prop content\", () => {\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.STREAMING_RESPONSE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"\", body: \"\" }),\n        }),\n      );\n\n      const { result } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      // Global streaming should be false because no props are actually streaming yet\n      expect(result.current.streamStatus.isStreaming).toBe(false);\n      expect(result.current.streamStatus.isPending).toBe(false);\n\n      // Individual props should be pending because they haven't started streaming yet\n      expect(result.current.propStatus.title.isPending).toBe(true);\n      expect(result.current.propStatus.title.isStreaming).toBe(false);\n      expect(result.current.propStatus.body.isPending).toBe(true);\n      expect(result.current.propStatus.body.isStreaming).toBe(false);\n    });\n\n    it(\"should show prop streaming when props receive content during STREAMING_RESPONSE\", () => {\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.STREAMING_RESPONSE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"Hello\", body: \"\" }),\n        }),\n      );\n\n      const { result } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      // Title prop should be streaming since it has content\n      expect(result.current.propStatus.title.isStreaming).toBe(true);\n      expect(result.current.propStatus.title.isPending).toBe(false);\n\n      // Body prop should still be pending since it has no content\n      expect(result.current.propStatus.body.isStreaming).toBe(false);\n      expect(result.current.propStatus.body.isPending).toBe(true);\n\n      // Global should be streaming because at least one prop is streaming\n      expect(result.current.streamStatus.isStreaming).toBe(true);\n    });\n  });\n\n  describe(\"Boolean Lifecycle\", () => {\n    it(\"should transition through Init -> Streaming -> Success lifecycle\", () => {\n      // Start with IDLE (Init phase)\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.IDLE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"\", body: \"\" }),\n        }),\n      );\n\n      const { result, rerender } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      // Phase 1: Init - isPending = true\n      expect(result.current.streamStatus.isPending).toBe(true);\n      expect(result.current.streamStatus.isStreaming).toBe(false);\n      expect(result.current.streamStatus.isSuccess).toBe(false);\n\n      // Phase 2: Streaming - move to STREAMING_RESPONSE with content\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.STREAMING_RESPONSE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({\n            title: \"Hello World\",\n            body: \"Some content\",\n          }),\n        }),\n      );\n\n      rerender();\n\n      expect(result.current.streamStatus.isPending).toBe(false);\n      expect(result.current.streamStatus.isStreaming).toBe(true);\n      expect(result.current.streamStatus.isSuccess).toBe(false);\n\n      // Phase 3: Complete - move to COMPLETE\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.COMPLETE,\n      } as TamboThreadContextProps);\n\n      rerender();\n\n      expect(result.current.streamStatus.isPending).toBe(false);\n      expect(result.current.streamStatus.isStreaming).toBe(false);\n      expect(result.current.streamStatus.isSuccess).toBe(true);\n    });\n\n    it(\"should handle error state correctly\", () => {\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.ERROR,\n      } as TamboThreadContextProps);\n\n      const errorMessage = \"Generation failed\";\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"\", body: \"\" }),\n          error: errorMessage,\n        }),\n      );\n\n      const { result } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      expect(result.current.streamStatus.isPending).toBe(true);\n      expect(result.current.streamStatus.isStreaming).toBe(false);\n      expect(result.current.streamStatus.isSuccess).toBe(false);\n      expect(result.current.streamStatus.isError).toBe(true);\n      expect(result.current.streamStatus.streamError?.message).toBe(\n        errorMessage,\n      );\n    });\n  });\n\n  describe(\"Derivation Rules\", () => {\n    it(\"should derive isPending correctly (no generation activity AND all props pending)\", () => {\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.IDLE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"\", body: \"\", footer: \"\" }),\n        }),\n      );\n\n      const { result } = renderHook(() =>\n        useTamboStreamStatus<{\n          title: string;\n          body: string;\n          footer: string;\n        }>(),\n      );\n\n      // All props are pending and no generation activity\n      expect(result.current.streamStatus.isPending).toBe(true);\n      expect(result.current.propStatus.title.isPending).toBe(true);\n      expect(result.current.propStatus.body.isPending).toBe(true);\n      expect(result.current.propStatus.footer.isPending).toBe(true);\n    });\n\n    it(\"should derive isStreaming correctly (generation streaming OR any prop streaming)\", () => {\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.COMPLETE,\n      } as TamboThreadContextProps);\n\n      // One prop still streaming\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({\n            title: \"Complete Title\",\n            body: \"Still streaming...\",\n          }),\n        }),\n      );\n\n      const { result } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      // Should be streaming because at least one prop is streaming\n      expect(result.current.streamStatus.isStreaming).toBe(false); // Note: this will be false in our implementation because props are considered complete when generation is COMPLETE\n    });\n\n    it(\"should derive isSuccess correctly (generation complete AND all props successful)\", () => {\n      // Step 1: Start with streaming, props empty\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.STREAMING_RESPONSE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({\n            title: \"\",\n            body: \"\",\n          }),\n        }),\n      );\n\n      const { result, rerender } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      // Step 2: Simulate streaming in title\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({\n            title: \"Complete Title\",\n            body: \"\",\n          }),\n        }),\n      );\n      rerender();\n\n      // Step 3: Simulate streaming in body\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({\n            title: \"Complete Title\",\n            body: \"Complete Body\",\n          }),\n        }),\n      );\n      rerender();\n\n      // Step 4: Generation complete\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.COMPLETE,\n      } as TamboThreadContextProps);\n      rerender();\n\n      // Now both props should be successful\n      expect(result.current.propStatus.title.isSuccess).toBe(true);\n      expect(result.current.propStatus.body.isSuccess).toBe(true);\n      expect(result.current.streamStatus.isSuccess).toBe(true);\n    });\n\n    it(\"should derive isError correctly (generation error OR any prop error)\", () => {\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.COMPLETE,\n      } as TamboThreadContextProps);\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({\n            title: \"Good Title\",\n            body: \"Good Body\",\n          }),\n          error: \"Something went wrong\",\n        }),\n      );\n\n      const { result } = renderHook(() =>\n        useTamboStreamStatus<{ title: string; body: string }>(),\n      );\n\n      expect(result.current.streamStatus.isError).toBe(true);\n      expect(result.current.streamStatus.streamError?.message).toBe(\n        \"Something went wrong\",\n      );\n    });\n  });\n\n  describe(\"Type Safety\", () => {\n    it(\"should provide strongly typed prop status based on generic\", () => {\n      interface TestProps {\n        title: string;\n        description: string;\n        count: number;\n      }\n\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({\n            title: \"Test\",\n            description: \"Test desc\",\n            count: 42,\n          }),\n        }),\n      );\n\n      const { result } = renderHook(() => useTamboStreamStatus<TestProps>());\n\n      // TypeScript should infer these keys correctly\n      expect(result.current.propStatus.title).toBeDefined();\n      expect(result.current.propStatus.description).toBeDefined();\n      expect(result.current.propStatus.count).toBeDefined();\n\n      // This would cause a TypeScript error if uncommented:\n      // expect(result.current.propStatus.nonExistentProp).toBeDefined();\n    });\n\n    it(\"should work without generic type parameter\", () => {\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ dynamicProp: \"value\" }),\n        }),\n      );\n\n      const { result } = renderHook(() => useTamboStreamStatus());\n\n      expect(result.current.streamStatus).toBeDefined();\n      expect(result.current.propStatus).toBeDefined();\n    });\n  });\n\n  describe(\"Edge Cases\", () => {\n    it(\"should handle missing message gracefully\", () => {\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(undefined);\n\n      const { result } = renderHook(() => useTamboStreamStatus());\n\n      expect(result.current.streamStatus.isPending).toBe(true);\n      expect(result.current.propStatus).toEqual({});\n    });\n\n    it(\"should handle missing component props gracefully\", () => {\n      jest.mocked(useTamboCurrentMessage).mockReturnValue({\n        id: \"test-message\",\n        // Missing component property\n      } as TamboThreadMessage);\n\n      const { result } = renderHook(() => useTamboStreamStatus());\n\n      expect(result.current.streamStatus.isPending).toBe(true);\n      expect(result.current.propStatus).toEqual({});\n    });\n\n    it(\"should reset prop tracking when generation restarts\", () => {\n      // Step 1: Complete a message\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.STREAMING_RESPONSE,\n      } as TamboThreadContextProps);\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"\" }),\n        }),\n      );\n      const { result, rerender } = renderHook(() =>\n        useTamboStreamStatus<{ title: string }>(),\n      );\n      // Simulate streaming in title\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          component: createMockComponent({ title: \"First Title\" }),\n        }),\n      );\n      rerender();\n      // Complete generation\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.COMPLETE,\n      } as TamboThreadContextProps);\n      rerender();\n      // Should be successful initially\n      expect(result.current.propStatus.title.isSuccess).toBe(true);\n\n      // Step 2: Start new generation with a new message ID to trigger reset\n      jest.mocked(useTamboThread).mockReturnValue({\n        generationStage: GenerationStage.CHOOSING_COMPONENT,\n      } as TamboThreadContextProps);\n      jest.mocked(useTamboCurrentMessage).mockReturnValue(\n        createMockMessage({\n          id: \"new-message-id\", // Different message ID to trigger reset\n          component: createMockComponent({ title: \"\" }),\n        }),\n      );\n      rerender();\n      // Should reset to pending\n      expect(result.current.propStatus.title.isPending).toBe(true);\n      expect(result.current.propStatus.title.isSuccess).toBe(false);\n    });\n  });\n});\n"]}

package/dist/hooks/index.d.ts

@@ -2,6 +2,7 @@ export * from "./react-query-hooks";
 export { useTamboComponentState } from "./use-component-state";
 export { useTamboCurrentMessage, useTamboMessageContext, } from "./use-current-message";
 export { useTamboStreamingProps } from "./use-streaming-props";
+export { useTamboStreamStatus, type StreamStatus, type PropStatus, } from "./use-tambo-stream-status";
 export * from "./use-suggestions";
 export { useTamboThreadList } from "./use-tambo-threads";
 export { useTamboThreadInput } from "./use-thread-input";

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,2BAA2B,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTamboThreadInput = exports.useTamboThreadList = exports.useTamboStreamingProps = exports.useTamboMessageContext = exports.useTamboCurrentMessage = exports.useTamboComponentState = void 0;
+exports.useTamboThreadInput = exports.useTamboThreadList = exports.useTamboStreamStatus = exports.useTamboStreamingProps = exports.useTamboMessageContext = exports.useTamboCurrentMessage = exports.useTamboComponentState = void 0;
 // Export all hooks from this directory
 __exportStar(require("./react-query-hooks"), exports);
 var use_component_state_1 = require("./use-component-state");
@@ -24,6 +24,8 @@ Object.defineProperty(exports, "useTamboCurrentMessage", { enumerable: true, get
 Object.defineProperty(exports, "useTamboMessageContext", { enumerable: true, get: function () { return use_current_message_1.useTamboMessageContext; } });
 var use_streaming_props_1 = require("./use-streaming-props");
 Object.defineProperty(exports, "useTamboStreamingProps", { enumerable: true, get: function () { return use_streaming_props_1.useTamboStreamingProps; } });
+var use_tambo_stream_status_1 = require("./use-tambo-stream-status");
+Object.defineProperty(exports, "useTamboStreamStatus", { enumerable: true, get: function () { return use_tambo_stream_status_1.useTamboStreamStatus; } });
 __exportStar(require("./use-suggestions"), exports);
 var use_tambo_threads_1 = require("./use-tambo-threads");
 Object.defineProperty(exports, "useTamboThreadList", { enumerable: true, get: function () { return use_tambo_threads_1.useTamboThreadList; } });

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAAuC;AACvC,sDAAoC;AACpC,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA;AAC/B,6DAG+B;AAF7B,6HAAA,sBAAsB,OAAA;AACtB,6HAAA,sBAAsB,OAAA;AAExB,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA;AAC/B,oDAAkC;AAClC,yDAAyD;AAAhD,uHAAA,kBAAkB,OAAA;AAC3B,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA","sourcesContent":["// Export all hooks from this directory\nexport * from \"./react-query-hooks\";\nexport { useTamboComponentState } from \"./use-component-state\";\nexport {\n  useTamboCurrentMessage,\n  useTamboMessageContext,\n} from \"./use-current-message\";\nexport { useTamboStreamingProps } from \"./use-streaming-props\";\nexport * from \"./use-suggestions\";\nexport { useTamboThreadList } from \"./use-tambo-threads\";\nexport { useTamboThreadInput } from \"./use-thread-input\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uCAAuC;AACvC,sDAAoC;AACpC,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA;AAC/B,6DAG+B;AAF7B,6HAAA,sBAAsB,OAAA;AACtB,6HAAA,sBAAsB,OAAA;AAExB,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA;AAC/B,qEAImC;AAHjC,+HAAA,oBAAoB,OAAA;AAItB,oDAAkC;AAClC,yDAAyD;AAAhD,uHAAA,kBAAkB,OAAA;AAC3B,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA","sourcesContent":["// Export all hooks from this directory\nexport * from \"./react-query-hooks\";\nexport { useTamboComponentState } from \"./use-component-state\";\nexport {\n  useTamboCurrentMessage,\n  useTamboMessageContext,\n} from \"./use-current-message\";\nexport { useTamboStreamingProps } from \"./use-streaming-props\";\nexport {\n  useTamboStreamStatus,\n  type StreamStatus,\n  type PropStatus,\n} from \"./use-tambo-stream-status\";\nexport * from \"./use-suggestions\";\nexport { useTamboThreadList } from \"./use-tambo-threads\";\nexport { useTamboThreadInput } from \"./use-thread-input\";\n"]}

package/dist/hooks/use-tambo-stream-status.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Global stream status flags for a specific component in a message.
+ * Represents the aggregate state across all props for this component only.
+ * Once a component completes, its status remains stable regardless of other generations.
+ */
+export interface StreamStatus {
+    /**
+     * Indicates no tokens have been received for any prop and generation is not active.
+     * Useful for showing initial loading states before any data arrives.
+     */
+    isPending: boolean;
+    /**
+     * Indicates active streaming - either generation is streaming OR at least one prop is still streaming.
+     * Use this to show loading animations or skeleton states during data transmission.
+     */
+    isStreaming: boolean;
+    /**
+     * Indicates successful completion - generation is complete AND every prop finished without error.
+     * Safe to render the final component when this is true.
+     */
+    isSuccess: boolean;
+    /**
+     * Indicates a fatal error occurred in any prop or the stream itself.
+     * Check streamError for details about what went wrong.
+     */
+    isError: boolean;
+    /**
+     * The first fatal error encountered during streaming (if any).
+     * Will be undefined if no errors occurred.
+     */
+    streamError?: Error;
+}
+/**
+ * Streaming status flags for individual component props.
+ * Tracks the state of each prop as it streams from the LLM.
+ */
+export interface PropStatus {
+    /**
+     * Indicates no tokens have been received for this specific prop yet.
+     * The prop value is still undefined, null, or empty string.
+     */
+    isPending: boolean;
+    /**
+     * Indicates at least one token has been received but streaming is not complete.
+     * The prop has partial content that may still be updating.
+     */
+    isStreaming: boolean;
+    /**
+     * Indicates this prop has finished streaming successfully.
+     * The prop value is complete and stable.
+     */
+    isSuccess: boolean;
+    /**
+     * The error that occurred during streaming (if any).
+     * Will be undefined if no error occurred for this prop.
+     */
+    error?: Error;
+}
+/**
+ * Hook that exposes per-prop and global streaming status for tambo-ai components.
+ * Provides streaming readiness flags so consumers can show loaders, skeletons,
+ * or errors while LLM-generated props stream in.
+ * This hook tracks status for the specific component in the current message only.
+ * Once a component's props complete streaming, they remain stable regardless of
+ * other components being generated in the thread.
+ * @template Props - The type of the component props being tracked (defaults to Record<string, any>)
+ * @returns An object containing both global streamStatus and per-prop propStatus
+ * @throws {Error} When used during SSR/SSG
+ * @example
+ * ```tsx
+ * // Wait for entire stream
+ * const { streamStatus } = useTamboStreamStatus();
+ * if (!streamStatus.isSuccess) return <Spinner />;
+ * return <Card {...props} />;
+ * ```
+ * @example
+ * ```tsx
+ * // Highlight in-flight props
+ * const { propStatus } = useTamboStreamStatus<Props>();
+ * <h2 className={propStatus.title.isStreaming ? "animate-pulse" : ""}>
+ *   {title}
+ * </h2>
+ * ```
+ */
+export declare function useTamboStreamStatus<Props extends Record<string, any> = Record<string, any>>(): {
+    streamStatus: StreamStatus;
+    propStatus: Record<keyof Props, PropStatus>;
+};
+//# sourceMappingURL=use-tambo-stream-status.d.ts.map

package/dist/hooks/use-tambo-stream-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-stream-status.d.ts","sourceRoot":"","sources":["../../src/hooks/use-tambo-stream-status.tsx"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AA8ND;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACpD;IACH,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,KAAK,EAAE,UAAU,CAAC,CAAC;CAC7C,CAmCA"}