@tambo-ai/react 0.42.0 → 0.43.0

package/esm/context-helpers/types.d.ts

@@ -8,23 +8,13 @@ export interface AdditionalContext {
     context: any;
 }
 /**
- * Interface for a context helper that can generate additional context
+ * A context helper is a function that returns data to include in the context,
+ * or null/undefined to skip including anything.
  */
-export interface AdditionalContextHelper {
-    /** The name of the context helper */
-    name: string;
-    /** Whether this helper is enabled */
-    enabled: boolean;
-    /** Function that generates the additional context */
-    run: () => AdditionalContext | Promise<AdditionalContext>;
-}
+export type ContextHelperFn = () => any | null | undefined | Promise<any | null | undefined>;
 /**
- * Configuration for context helpers
+ * A collection of context helpers keyed by their context name.
+ * The key becomes the AdditionalContext.name sent to the model.
  */
-export interface ContextHelpersConfig {
-    /** Enable/disable user time context helper */
-    userTime?: boolean;
-    /** Enable/disable user page context helper */
-    userPage?: boolean;
-}
+export type ContextHelpers = Record<string, ContextHelperFn>;
 //# sourceMappingURL=types.d.ts.map

package/esm/context-helpers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,GAAG,EAAE,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAC1B,GAAG,GACH,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,GAAG,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}

package/esm/context-helpers/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Interface for additional context that can be added to messages\n */\nexport interface AdditionalContext {\n  /** The name of the context type */\n  name: string;\n  /** The context data */\n  context: any;\n}\n\n/**\n * Interface for a context helper that can generate additional context\n */\nexport interface AdditionalContextHelper {\n  /** The name of the context helper */\n  name: string;\n  /** Whether this helper is enabled */\n  enabled: boolean;\n  /** Function that generates the additional context */\n  run: () => AdditionalContext | Promise<AdditionalContext>;\n}\n\n/**\n * Configuration for context helpers\n */\nexport interface ContextHelpersConfig {\n  /** Enable/disable user time context helper */\n  userTime?: boolean;\n  /** Enable/disable user page context helper */\n  userPage?: boolean;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context-helpers/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Interface for additional context that can be added to messages\n */\nexport interface AdditionalContext {\n  /** The name of the context type */\n  name: string;\n  /** The context data */\n  context: any;\n}\n\n/**\n * A context helper is a function that returns data to include in the context,\n * or null/undefined to skip including anything.\n */\nexport type ContextHelperFn = () =>\n  | any\n  | null\n  | undefined\n  | Promise<any | null | undefined>;\n\n/**\n * A collection of context helpers keyed by their context name.\n * The key becomes the AdditionalContext.name sent to the model.\n */\nexport type ContextHelpers = Record<string, ContextHelperFn>;\n"]}

package/esm/index.d.ts

@@ -15,6 +15,6 @@ export { type TamboThread } from "./model/tambo-thread";
 export type { TamboInteractableComponent as InteractableComponent, TamboInteractableContext, } from "./model/tambo-interactable";
 export { withTamboInteractable as withInteractable, type InteractableConfig, type WithTamboInteractableProps, } from "./providers/hoc/with-tambo-interactable";
 export { useTamboInteractable } from "./providers/tambo-interactable-provider";
-export { DEFAULT_CONTEXT_HELPERS, getUserPageContext, getUserTimeContext, } from "./context-helpers";
-export type { AdditionalContext, AdditionalContextHelper, ContextHelpersConfig, } from "./context-helpers";
+export { currentPageContextHelper, currentTimeContextHelper, } from "./context-helpers";
+export type { AdditionalContext, ContextHelperFn, ContextHelpers, } from "./context-helpers";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,YAAY,EACV,0BAA0B,IAAI,qBAAqB,EACnD,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAG/E,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,YAAY,EACV,0BAA0B,IAAI,qBAAqB,EACnD,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAG/E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/esm/index.js

@@ -12,5 +12,5 @@ export { GenerationStage, } from "./model/generate-component-response";
 export { withTamboInteractable as withInteractable, } from "./providers/hoc/with-tambo-interactable";
 export { useTamboInteractable } from "./providers/tambo-interactable-provider";
 // Context helpers exports
-export { DEFAULT_CONTEXT_HELPERS, getUserPageContext, getUserTimeContext, } from "./context-helpers";
+export { currentPageContextHelper, currentTimeContextHelper, } from "./context-helpers";
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,GAGrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,gCAAgC;AAChC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,cAAc,GAMf,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,OAAO,EACL,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,qBAAqB,IAAI,gBAAgB,GAG1C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,0BAA0B;AAC1B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC","sourcesContent":["/** Exports for the library. Only publically available exports are re-exported here. Anything not exported here is not supported and may change or break at any time. */\n\nexport { useTamboComponentState } from \"./hooks/use-component-state\";\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n  useTamboMessageContext,\n} from \"./hooks/use-current-message\";\nexport { useTamboStreamingProps } from \"./hooks/use-streaming-props\";\nexport * from \"./hooks/use-suggestions\";\nexport {\n  useTamboStreamStatus,\n  type PropStatus,\n  type StreamStatus,\n} from \"./hooks/use-tambo-stream-status\";\nexport { useTamboThreadInput } from \"./hooks/use-thread-input\";\n\n// Re-export provider components\nexport {\n  TamboClientProvider,\n  TamboComponentProvider,\n  TamboContextHelpersProvider,\n  TamboPropStreamProvider,\n  TamboProvider,\n  TamboStubProvider,\n  TamboThreadProvider,\n  useTambo,\n  useTamboClient,\n  useTamboContextHelpers,\n  useTamboStream,\n  useTamboThread,\n  type TamboComponent,\n  type TamboContextHelpersContextProps,\n  type TamboContextHelpersProviderProps,\n  type TamboRegistryContext,\n  type TamboStubProviderProps,\n} from \"./providers\";\n\n// Re-export types from Tambo Node SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\nexport { useTamboThreadList } from \"./hooks/use-tambo-threads\";\nexport {\n  type ComponentContextToolMetadata,\n  type ComponentRegistry,\n  type ParameterSpec,\n  type RegisteredComponent,\n  type TamboTool,\n} from \"./model/component-metadata\";\nexport {\n  GenerationStage,\n  type TamboThreadMessage,\n} from \"./model/generate-component-response\";\nexport { type TamboThread } from \"./model/tambo-thread\";\n\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"./model/tambo-interactable\";\nexport {\n  withTamboInteractable as withInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"./providers/hoc/with-tambo-interactable\";\nexport { useTamboInteractable } from \"./providers/tambo-interactable-provider\";\n\n// Context helpers exports\nexport {\n  DEFAULT_CONTEXT_HELPERS,\n  getUserPageContext,\n  getUserTimeContext,\n} from \"./context-helpers\";\nexport type {\n  AdditionalContext,\n  AdditionalContextHelper,\n  ContextHelpersConfig,\n} from \"./context-helpers\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,GAGrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,gCAAgC;AAChC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,cAAc,GAMf,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,OAAO,EACL,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,qBAAqB,IAAI,gBAAgB,GAG1C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,0BAA0B;AAC1B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC","sourcesContent":["/** Exports for the library. Only publically available exports are re-exported here. Anything not exported here is not supported and may change or break at any time. */\n\nexport { useTamboComponentState } from \"./hooks/use-component-state\";\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n  useTamboMessageContext,\n} from \"./hooks/use-current-message\";\nexport { useTamboStreamingProps } from \"./hooks/use-streaming-props\";\nexport * from \"./hooks/use-suggestions\";\nexport {\n  useTamboStreamStatus,\n  type PropStatus,\n  type StreamStatus,\n} from \"./hooks/use-tambo-stream-status\";\nexport { useTamboThreadInput } from \"./hooks/use-thread-input\";\n\n// Re-export provider components\nexport {\n  TamboClientProvider,\n  TamboComponentProvider,\n  TamboContextHelpersProvider,\n  TamboPropStreamProvider,\n  TamboProvider,\n  TamboStubProvider,\n  TamboThreadProvider,\n  useTambo,\n  useTamboClient,\n  useTamboContextHelpers,\n  useTamboStream,\n  useTamboThread,\n  type TamboComponent,\n  type TamboContextHelpersContextProps,\n  type TamboContextHelpersProviderProps,\n  type TamboRegistryContext,\n  type TamboStubProviderProps,\n} from \"./providers\";\n\n// Re-export types from Tambo Node SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\nexport { useTamboThreadList } from \"./hooks/use-tambo-threads\";\nexport {\n  type ComponentContextToolMetadata,\n  type ComponentRegistry,\n  type ParameterSpec,\n  type RegisteredComponent,\n  type TamboTool,\n} from \"./model/component-metadata\";\nexport {\n  GenerationStage,\n  type TamboThreadMessage,\n} from \"./model/generate-component-response\";\nexport { type TamboThread } from \"./model/tambo-thread\";\n\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"./model/tambo-interactable\";\nexport {\n  withTamboInteractable as withInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"./providers/hoc/with-tambo-interactable\";\nexport { useTamboInteractable } from \"./providers/tambo-interactable-provider\";\n\n// Context helpers exports\nexport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"./context-helpers\";\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"./context-helpers\";\n"]}

package/esm/providers/__tests__/tambo-context-helpers-provider.test.js

@@ -1,156 +1,330 @@
 import { act, renderHook } from "@testing-library/react";
 import React from "react";
-import * as contextHelpers from "../../context-helpers";
-import { DEFAULT_CONTEXT_HELPERS } from "../../context-helpers";
+import { currentPageContextHelper, currentTimeContextHelper, } from "../../context-helpers";
+import { setHelpers } from "../../context-helpers/registry";
 import { TamboContextHelpersProvider, useTamboContextHelpers, } from "../tambo-context-helpers-provider";
+/**
+ * Test suite for TamboContextHelpersProvider (simplified API, registry-backed)
+ *
+ * The simplified API:
+ * - Accepts a plain map of { key: () => any | null | undefined | Promise<any | null | undefined> }.
+ * - The key becomes the context name sent to the model.
+ * - Returning null/undefined from a helper skips inclusion.
+ * - Prebuilt helpers are just functions (e.g., prebuiltUserTime, prebuiltUserPage).
+ *
+ * The hook is now registry-backed and safe to call outside a provider. When used
+ * outside a provider, it proxies to a global registry and still works.
+ */
 describe("TamboContextHelpersProvider", () => {
-    // Create a wrapper component that provides the context for testing hooks
+    // Ensure registry is clean for each test to avoid cross-test contamination
+    beforeEach(() => {
+        setHelpers({});
+        jest.clearAllMocks();
+    });
+    // Base wrapper with no helpers provided
     const wrapper = ({ children }) => (React.createElement(TamboContextHelpersProvider, null, children));
     describe("useTamboContextHelpers", () => {
         /**
-         * Test: Hook throws error when used outside of provider
-         * This ensures developers get a clear error message if they forget to wrap
-         * their components with the TamboContextHelpersProvider
+         * NOTE: The hook is registry-backed and safe outside provider. It should not throw.
+         * This replaces the previous behavior that threw without a provider.
          */
-        it("should throw error when used outside provider", () => {
-            // Mock console.error to prevent error output in test logs
+        it("should be safe outside provider (registry-backed no provider)", async () => {
             const consoleSpy = jest
                 .spyOn(console, "error")
                 .mockImplementation(() => { });
-            // Verify that using the hook without a provider throws the expected error
-            expect(() => {
-                renderHook(() => useTamboContextHelpers());
-            }).toThrow("useTamboContextHelpers must be used within a TamboContextHelpersProvider");
-            // Restore console.error to its original implementation
+            const { result } = renderHook(() => useTamboContextHelpers());
+            // Should return callable functions
+            expect(typeof result.current.getAdditionalContext).toBe("function");
+            expect(typeof result.current.getContextHelpers).toBe("function");
+            expect(typeof result.current.addContextHelper).toBe("function");
+            expect(typeof result.current.removeContextHelper).toBe("function");
+            // Starts empty
+            expect(await result.current.getAdditionalContext()).toHaveLength(0);
+            // Add a helper and verify
+            act(() => {
+                result.current.addContextHelper("outsideHelper", () => ({ ok: true }));
+            });
+            const contexts = await result.current.getAdditionalContext();
+            expect(contexts).toContainEqual({
+                name: "outsideHelper",
+                context: { ok: true },
+            });
+            // Cleanup
+            act(() => {
+                result.current.removeContextHelper("outsideHelper");
+            });
             consoleSpy.mockRestore();
         });
         /**
-         * Test: Hook provides the expected API functions
-         * Verifies that all required functions are available when the hook is used
-         * within the provider context
+         * Verifies that the hook returns the expected API functions when used within a provider.
          */
-        it("should provide context helpers functions", () => {
+        it("should provide context helpers functions (inside provider)", () => {
             const { result } = renderHook(() => useTamboContextHelpers(), {
                 wrapper,
             });
-            // Verify all expected functions are present in the hook's return value
             expect(result.current).toHaveProperty("getAdditionalContext");
             expect(result.current).toHaveProperty("getContextHelpers");
-            expect(result.current).toHaveProperty("setContextHelperEnabled");
-        });
-        /**
-         * Test: Default configuration is applied correctly
-         * Ensures that the default context helpers are loaded with their
-         * expected enabled/disabled states
-         */
-        it("should return default context helpers configuration", () => {
-            const { result } = renderHook(() => useTamboContextHelpers(), {
-                wrapper,
-            });
-            const helpers = result.current.getContextHelpers();
-            // Verify we have the expected number of default helpers
-            expect(helpers).toHaveLength(DEFAULT_CONTEXT_HELPERS.length);
-            // Check specific helpers have their expected default states
-            const userTimeHelper = helpers.find((h) => h.name === "userTime");
-            const userPageHelper = helpers.find((h) => h.name === "userPage");
-            // userTime should be disabled by default
-            expect(userTimeHelper?.enabled).toBe(false);
-            // userPage should be disabled by default
-            expect(userPageHelper?.enabled).toBe(false);
+            expect(result.current).toHaveProperty("addContextHelper");
+            expect(result.current).toHaveProperty("removeContextHelper");
         });
         /**
-         * Test: Context helper enabled state can be toggled
-         * Verifies that the setContextHelperEnabled function correctly updates
-         * the enabled state of individual helpers
+         * With no helpers provided, no additional context should be returned.
          */
-        it("should allow toggling context helper enabled state", () => {
-            const { result } = renderHook(() => useTamboContextHelpers(), {
-                wrapper,
-            });
-            // Enable the userPage helper using the provided function
-            act(() => {
-                result.current.setContextHelperEnabled("userPage", true);
-            });
-            // Verify the helper's state was updated
-            const helpers = result.current.getContextHelpers();
-            const userPageHelper = helpers.find((h) => h.name === "userPage");
-            expect(userPageHelper?.enabled).toBe(true);
-        });
-        /**
-         * Test: Only enabled helpers contribute to additional context
-         * Verifies that getAdditionalContext only runs and returns data from
-         * helpers that are currently enabled
-         */
-        it("should get additional context from enabled helpers", async () => {
+        it("should return no additional context when no helpers are provided", async () => {
             const { result } = renderHook(() => useTamboContextHelpers(), {
                 wrapper,
             });
             const contexts = await result.current.getAdditionalContext();
-            // By default, no context helpers are enabled, so we should get no contexts
             expect(contexts).toHaveLength(0);
         });
         /**
-         * Test: Provider respects configuration prop
-         * Verifies that initial configuration can be customized through the
-         * contextHelpers prop on the provider
+         * When helpers are provided, getAdditionalContext should aggregate them.
+         * Note: prebuiltUserPage may be null in non-browser envs, so we only assert userTime when present.
          */
-        it("should respect contextHelpers configuration prop", () => {
-            // Create a custom wrapper with specific configuration
-            const customWrapper = ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
-                    userTime: false, // Disable userTime
-                    userPage: true, // Enable userPage
+        it("should get additional context when helpers are provided", async () => {
+            const withHelpers = ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    userTime: currentTimeContextHelper,
+                    userPage: currentPageContextHelper,
                 } }, children));
             const { result } = renderHook(() => useTamboContextHelpers(), {
-                wrapper: customWrapper,
+                wrapper: withHelpers,
             });
-            // Verify the custom configuration is applied
-            const helpers = result.current.getContextHelpers();
-            const userTimeHelper = helpers.find((h) => h.name === "userTime");
-            const userPageHelper = helpers.find((h) => h.name === "userPage");
-            expect(userTimeHelper?.enabled).toBe(false);
-            expect(userPageHelper?.enabled).toBe(true);
+            const contexts = await result.current.getAdditionalContext();
+            const names = contexts.map((c) => c.name);
+            // userTime should be present from prebuilt helper
+            expect(names).toContain("userTime");
+            // userPage may be absent on server; do not assert strictly
         });
         /**
-         * Test: Errors in context helpers are handled gracefully
-         * Verifies that if a context helper throws an error, it doesn't crash
-         * the entire system and other helpers continue to work
+         * Errors thrown by helper functions should be caught and skipped, not crash the system.
          */
         it("should handle errors in context helper functions gracefully", async () => {
-            // Mock console.error to capture error logs
             const consoleErrorSpy = jest
                 .spyOn(console, "error")
                 .mockImplementation(() => { });
-            // Create a helper that will throw an error when run
-            const errorHelper = {
-                name: "errorHelper",
-                enabled: true,
-                run: () => {
-                    throw new Error("Test error");
-                },
+            const badHelper = () => {
+                throw new Error("Test error");
             };
-            // Temporarily add the error helper to the default helpers
-            // Store original helpers to restore later
-            const originalHelpers = DEFAULT_CONTEXT_HELPERS;
-            Object.defineProperty(contextHelpers, "DEFAULT_CONTEXT_HELPERS", {
-                value: [...originalHelpers, errorHelper],
-                writable: true,
-            });
+            const withBadHelper = ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: { badHelper } }, children));
             const { result } = renderHook(() => useTamboContextHelpers(), {
-                wrapper,
+                wrapper: withBadHelper,
             });
-            // Call getAdditionalContext, which should handle the error gracefully
             const contexts = await result.current.getAdditionalContext();
-            // Should have no contexts because the error helper should be skipped
             expect(contexts.length).toBe(0);
-            // Verify that the error was logged appropriately
-            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("Error running context helper errorHelper"), expect.any(Error));
-            // Restore the original helpers and console.error
-            Object.defineProperty(contextHelpers, "DEFAULT_CONTEXT_HELPERS", {
-                value: originalHelpers,
-                writable: true,
-            });
+            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("Error running context helper badHelper"), expect.any(Error));
             consoleErrorSpy.mockRestore();
         });
     });
 });
+/**
+ * Test suite for Custom Context Helpers using the simplified API.
+ *
+ * Focuses on:
+ * - Passing custom helpers via the provider prop.
+ * - Overriding prebuilt helpers with custom implementations.
+ * - Dynamic add/remove helper management at runtime.
+ * - Supporting both sync and async helpers.
+ * - Using the config key as the context name.
+ * - Graceful error handling for custom helpers.
+ */
+describe("Custom Context Helpers via contextHelpers config", () => {
+    beforeEach(() => {
+        setHelpers({});
+        jest.clearAllMocks();
+    });
+    /**
+     * Custom helpers can be added through the provider configuration.
+     * The key becomes the context name and the function returns the raw value.
+     */
+    it("should accept custom helpers through contextHelpers config", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    customData: async () => ({ custom: "value" }),
+                } }, children)),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "customData",
+            context: { custom: "value" },
+        });
+    });
+    /**
+     * Built-in helpers can be overridden by providing a function under the same key.
+     */
+    it("should allow custom helpers to override built-in ones", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    userTime: async () => ({ customTime: "override" }),
+                } }, children)),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        const userTimeContext = contexts.find((c) => c.name === "userTime");
+        expect(userTimeContext?.context).toEqual({ customTime: "override" });
+    });
+    /**
+     * Helpers can be added dynamically at runtime via addContextHelper.
+     */
+    it("should handle dynamic addition of custom helpers", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {} }, children)),
+        });
+        // Initially none
+        expect(await result.current.getAdditionalContext()).toHaveLength(0);
+        act(() => {
+            result.current.addContextHelper("dynamicHelper", async () => ({
+                dynamic: true,
+            }));
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "dynamicHelper",
+            context: { dynamic: true },
+        });
+    });
+    /**
+     * Helpers can be removed dynamically via removeContextHelper.
+     */
+    it("should handle dynamic removal of context helpers", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    customHelper: async () => ({ test: "data" }),
+                } }, children)),
+        });
+        // Verify exists
+        let contexts = await result.current.getAdditionalContext();
+        expect(contexts.find((c) => c.name === "customHelper")).toBeDefined();
+        // Remove
+        act(() => {
+            result.current.removeContextHelper("customHelper");
+        });
+        // Verify removed
+        contexts = await result.current.getAdditionalContext();
+        expect(contexts.find((c) => c.name === "customHelper")).toBeUndefined();
+    });
+    /**
+     * Multiple custom helpers should be supported; helpers returning null/undefined are skipped.
+     */
+    it("should handle multiple custom helpers", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    helper1: async () => ({ data: "one" }),
+                    helper2: async () => ({ data: "two" }),
+                    helper3: () => null, // disabled by returning null
+                } }, children)),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "helper1",
+            context: { data: "one" },
+        });
+        expect(contexts).toContainEqual({
+            name: "helper2",
+            context: { data: "two" },
+        });
+        expect(contexts.find((c) => c.name === "helper3")).toBeUndefined();
+    });
+    /**
+     * Both synchronous and asynchronous helpers should be supported.
+     */
+    it("should handle sync and async custom helpers", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    syncHelper: () => ({ sync: true }),
+                    asyncHelper: async () => {
+                        await new Promise((resolve) => setTimeout(resolve, 10));
+                        return { async: true };
+                    },
+                } }, children)),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "syncHelper",
+            context: { sync: true },
+        });
+        expect(contexts).toContainEqual({
+            name: "asyncHelper",
+            context: { async: true },
+        });
+    });
+    /**
+     * The key used in the contextHelpers map becomes the context name.
+     */
+    it("should use key name as context name for custom helpers", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    myCustomKey: async () => ({ value: "test" }),
+                } }, children)),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "myCustomKey",
+            context: { value: "test" },
+        });
+    });
+    /**
+     * Errors thrown by custom helpers should be logged and skipped, not crash the system.
+     */
+    it("should handle errors in custom helpers gracefully", async () => {
+        const consoleErrorSpy = jest
+            .spyOn(console, "error")
+            .mockImplementation(() => { });
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    errorHelper: async () => {
+                        throw new Error("Custom helper error");
+                    },
+                    goodHelper: async () => ({ good: "data" }),
+                } }, children)),
+        });
+        const contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "goodHelper",
+            context: { good: "data" },
+        });
+        expect(contexts.find((c) => c.name === "errorHelper")).toBeUndefined();
+        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("Error running context helper errorHelper"), expect.any(Error));
+        consoleErrorSpy.mockRestore();
+    });
+    /**
+     * Removing non-existent helpers should be a no-op without throwing errors.
+     */
+    it("should handle removing non-existent helper gracefully", () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {} }, children)),
+        });
+        expect(() => {
+            act(() => {
+                result.current.removeContextHelper("nonExistent");
+            });
+        }).not.toThrow();
+    });
+    /**
+     * Adding with an existing name should update/replace the helper implementation.
+     */
+    it("should allow updating existing helper via addContextHelper", async () => {
+        const { result } = renderHook(() => useTamboContextHelpers(), {
+            wrapper: ({ children }) => (React.createElement(TamboContextHelpersProvider, { contextHelpers: {
+                    testHelper: async () => ({ original: true }),
+                } }, children)),
+        });
+        // Verify original helper
+        let contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "testHelper",
+            context: { original: true },
+        });
+        // Update the helper
+        act(() => {
+            result.current.addContextHelper("testHelper", async () => ({
+                updated: true,
+            }));
+        });
+        // Verify updated helper
+        contexts = await result.current.getAdditionalContext();
+        expect(contexts).toContainEqual({
+            name: "testHelper",
+            context: { updated: true },
+        });
+    });
+});
 //# sourceMappingURL=tambo-context-helpers-provider.test.js.map

package/esm/providers/__tests__/tambo-context-helpers-provider.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-context-helpers-provider.test.js","sourceRoot":"","sources":["../../../src/providers/__tests__/tambo-context-helpers-provider.test.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAE3C,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,yEAAyE;IACzE,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,2BAA2B,QAAE,QAAQ,CAA+B,CACtE,CAAC;IAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC;;;;WAIG;QACH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,0DAA0D;YAC1D,MAAM,UAAU,GAAG,IAAI;iBACpB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;iBACvB,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEhC,0EAA0E;YAC1E,MAAM,CAAC,GAAG,EAAE;gBACV,UAAU,CAAC,GAAG,EAAE,CAAC,sBAAsB,EAAE,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC,OAAO,CACR,0EAA0E,CAC3E,CAAC;YAEF,uDAAuD;YACvD,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH;;;;WAIG;QACH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,uEAAuE;YACvE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC;YAC9D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;YAC3D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH;;;;WAIG;QACH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAEnD,wDAAwD;YACxD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;YAE7D,4DAA4D;YAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;YAClE,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;YAElE,yCAAyC;YACzC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,yCAAyC;YACzC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH;;;;WAIG;QACH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,yDAAyD;YACzD,GAAG,CAAC,GAAG,EAAE;gBACP,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;YAEH,wCAAwC;YACxC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACnD,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;YAElE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH;;;;WAIG;QACH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAE7D,2EAA2E;YAC3E,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH;;;;WAIG;QACH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,sDAAsD;YACtD,MAAM,aAAa,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CACrE,oBAAC,2BAA2B,IAC1B,cAAc,EAAE;oBACd,QAAQ,EAAE,KAAK,EAAE,mBAAmB;oBACpC,QAAQ,EAAE,IAAI,EAAE,kBAAkB;iBACnC,IAEA,QAAQ,CACmB,CAC/B,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE;gBAC5D,OAAO,EAAE,aAAa;aACvB,CAAC,CAAC;YAEH,6CAA6C;YAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACnD,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;YAClE,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;YAElE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH;;;;WAIG;QACH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;YAC3E,2CAA2C;YAC3C,MAAM,eAAe,GAAG,IAAI;iBACzB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;iBACvB,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEhC,oDAAoD;YACpD,MAAM,WAAW,GAAG;gBAClB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,GAAG,EAAE;oBACR,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;gBAChC,CAAC;aACF,CAAC;YAEF,0DAA0D;YAC1D,0CAA0C;YAC1C,MAAM,eAAe,GAAG,uBAAuB,CAAC;YAChD,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,yBAAyB,EAAE;gBAC/D,KAAK,EAAE,CAAC,GAAG,eAAe,EAAE,WAAW,CAAC;gBACxC,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,sEAAsE;YACtE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAE7D,qEAAqE;YACrE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEhC,iDAAiD;YACjD,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAC1C,MAAM,CAAC,gBAAgB,CAAC,0CAA0C,CAAC,EACnE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAClB,CAAC;YAEF,iDAAiD;YACjD,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,yBAAyB,EAAE;gBAC/D,KAAK,EAAE,eAAe;gBACtB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YACH,eAAe,CAAC,WAAW,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { act, renderHook } from \"@testing-library/react\";\nimport React from \"react\";\nimport * as contextHelpers from \"../../context-helpers\";\nimport { DEFAULT_CONTEXT_HELPERS } from \"../../context-helpers\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../tambo-context-helpers-provider\";\n\ndescribe(\"TamboContextHelpersProvider\", () => {\n  // Create a wrapper component that provides the context for testing hooks\n  const wrapper = ({ children }: { children: React.ReactNode }) => (\n    <TamboContextHelpersProvider>{children}</TamboContextHelpersProvider>\n  );\n\n  describe(\"useTamboContextHelpers\", () => {\n    /**\n     * Test: Hook throws error when used outside of provider\n     * This ensures developers get a clear error message if they forget to wrap\n     * their components with the TamboContextHelpersProvider\n     */\n    it(\"should throw error when used outside provider\", () => {\n      // Mock console.error to prevent error output in test logs\n      const consoleSpy = jest\n        .spyOn(console, \"error\")\n        .mockImplementation(() => {});\n\n      // Verify that using the hook without a provider throws the expected error\n      expect(() => {\n        renderHook(() => useTamboContextHelpers());\n      }).toThrow(\n        \"useTamboContextHelpers must be used within a TamboContextHelpersProvider\",\n      );\n\n      // Restore console.error to its original implementation\n      consoleSpy.mockRestore();\n    });\n\n    /**\n     * Test: Hook provides the expected API functions\n     * Verifies that all required functions are available when the hook is used\n     * within the provider context\n     */\n    it(\"should provide context helpers functions\", () => {\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper,\n      });\n\n      // Verify all expected functions are present in the hook's return value\n      expect(result.current).toHaveProperty(\"getAdditionalContext\");\n      expect(result.current).toHaveProperty(\"getContextHelpers\");\n      expect(result.current).toHaveProperty(\"setContextHelperEnabled\");\n    });\n\n    /**\n     * Test: Default configuration is applied correctly\n     * Ensures that the default context helpers are loaded with their\n     * expected enabled/disabled states\n     */\n    it(\"should return default context helpers configuration\", () => {\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper,\n      });\n\n      const helpers = result.current.getContextHelpers();\n\n      // Verify we have the expected number of default helpers\n      expect(helpers).toHaveLength(DEFAULT_CONTEXT_HELPERS.length);\n\n      // Check specific helpers have their expected default states\n      const userTimeHelper = helpers.find((h) => h.name === \"userTime\");\n      const userPageHelper = helpers.find((h) => h.name === \"userPage\");\n\n      // userTime should be disabled by default\n      expect(userTimeHelper?.enabled).toBe(false);\n      // userPage should be disabled by default\n      expect(userPageHelper?.enabled).toBe(false);\n    });\n\n    /**\n     * Test: Context helper enabled state can be toggled\n     * Verifies that the setContextHelperEnabled function correctly updates\n     * the enabled state of individual helpers\n     */\n    it(\"should allow toggling context helper enabled state\", () => {\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper,\n      });\n\n      // Enable the userPage helper using the provided function\n      act(() => {\n        result.current.setContextHelperEnabled(\"userPage\", true);\n      });\n\n      // Verify the helper's state was updated\n      const helpers = result.current.getContextHelpers();\n      const userPageHelper = helpers.find((h) => h.name === \"userPage\");\n\n      expect(userPageHelper?.enabled).toBe(true);\n    });\n\n    /**\n     * Test: Only enabled helpers contribute to additional context\n     * Verifies that getAdditionalContext only runs and returns data from\n     * helpers that are currently enabled\n     */\n    it(\"should get additional context from enabled helpers\", async () => {\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper,\n      });\n\n      const contexts = await result.current.getAdditionalContext();\n\n      // By default, no context helpers are enabled, so we should get no contexts\n      expect(contexts).toHaveLength(0);\n    });\n\n    /**\n     * Test: Provider respects configuration prop\n     * Verifies that initial configuration can be customized through the\n     * contextHelpers prop on the provider\n     */\n    it(\"should respect contextHelpers configuration prop\", () => {\n      // Create a custom wrapper with specific configuration\n      const customWrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            userTime: false, // Disable userTime\n            userPage: true, // Enable userPage\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      );\n\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper: customWrapper,\n      });\n\n      // Verify the custom configuration is applied\n      const helpers = result.current.getContextHelpers();\n      const userTimeHelper = helpers.find((h) => h.name === \"userTime\");\n      const userPageHelper = helpers.find((h) => h.name === \"userPage\");\n\n      expect(userTimeHelper?.enabled).toBe(false);\n      expect(userPageHelper?.enabled).toBe(true);\n    });\n\n    /**\n     * Test: Errors in context helpers are handled gracefully\n     * Verifies that if a context helper throws an error, it doesn't crash\n     * the entire system and other helpers continue to work\n     */\n    it(\"should handle errors in context helper functions gracefully\", async () => {\n      // Mock console.error to capture error logs\n      const consoleErrorSpy = jest\n        .spyOn(console, \"error\")\n        .mockImplementation(() => {});\n\n      // Create a helper that will throw an error when run\n      const errorHelper = {\n        name: \"errorHelper\",\n        enabled: true,\n        run: () => {\n          throw new Error(\"Test error\");\n        },\n      };\n\n      // Temporarily add the error helper to the default helpers\n      // Store original helpers to restore later\n      const originalHelpers = DEFAULT_CONTEXT_HELPERS;\n      Object.defineProperty(contextHelpers, \"DEFAULT_CONTEXT_HELPERS\", {\n        value: [...originalHelpers, errorHelper],\n        writable: true,\n      });\n\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper,\n      });\n\n      // Call getAdditionalContext, which should handle the error gracefully\n      const contexts = await result.current.getAdditionalContext();\n\n      // Should have no contexts because the error helper should be skipped\n      expect(contexts.length).toBe(0);\n\n      // Verify that the error was logged appropriately\n      expect(consoleErrorSpy).toHaveBeenCalledWith(\n        expect.stringContaining(\"Error running context helper errorHelper\"),\n        expect.any(Error),\n      );\n\n      // Restore the original helpers and console.error\n      Object.defineProperty(contextHelpers, \"DEFAULT_CONTEXT_HELPERS\", {\n        value: originalHelpers,\n        writable: true,\n      });\n      consoleErrorSpy.mockRestore();\n    });\n  });\n});\n"]}
+{"version":3,"file":"tambo-context-helpers-provider.test.js","sourceRoot":"","sources":["../../../src/providers/__tests__/tambo-context-helpers-provider.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { act, renderHook } from \"@testing-library/react\";\nimport React from \"react\";\nimport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"../../context-helpers\";\nimport { setHelpers } from \"../../context-helpers/registry\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../tambo-context-helpers-provider\";\n\n/**\n * Test suite for TamboContextHelpersProvider (simplified API, registry-backed)\n *\n * The simplified API:\n * - Accepts a plain map of { key: () => any | null | undefined | Promise<any | null | undefined> }.\n * - The key becomes the context name sent to the model.\n * - Returning null/undefined from a helper skips inclusion.\n * - Prebuilt helpers are just functions (e.g., prebuiltUserTime, prebuiltUserPage).\n *\n * The hook is now registry-backed and safe to call outside a provider. When used\n * outside a provider, it proxies to a global registry and still works.\n */\ndescribe(\"TamboContextHelpersProvider\", () => {\n  // Ensure registry is clean for each test to avoid cross-test contamination\n  beforeEach(() => {\n    setHelpers({});\n    jest.clearAllMocks();\n  });\n\n  // Base wrapper with no helpers provided\n  const wrapper = ({ children }: { children: React.ReactNode }) => (\n    <TamboContextHelpersProvider>{children}</TamboContextHelpersProvider>\n  );\n\n  describe(\"useTamboContextHelpers\", () => {\n    /**\n     * NOTE: The hook is registry-backed and safe outside provider. It should not throw.\n     * This replaces the previous behavior that threw without a provider.\n     */\n    it(\"should be safe outside provider (registry-backed no provider)\", async () => {\n      const consoleSpy = jest\n        .spyOn(console, \"error\")\n        .mockImplementation(() => {});\n      const { result } = renderHook(() => useTamboContextHelpers());\n\n      // Should return callable functions\n      expect(typeof result.current.getAdditionalContext).toBe(\"function\");\n      expect(typeof result.current.getContextHelpers).toBe(\"function\");\n      expect(typeof result.current.addContextHelper).toBe(\"function\");\n      expect(typeof result.current.removeContextHelper).toBe(\"function\");\n\n      // Starts empty\n      expect(await result.current.getAdditionalContext()).toHaveLength(0);\n\n      // Add a helper and verify\n      act(() => {\n        result.current.addContextHelper(\"outsideHelper\", () => ({ ok: true }));\n      });\n\n      const contexts = await result.current.getAdditionalContext();\n      expect(contexts).toContainEqual({\n        name: \"outsideHelper\",\n        context: { ok: true },\n      });\n\n      // Cleanup\n      act(() => {\n        result.current.removeContextHelper(\"outsideHelper\");\n      });\n      consoleSpy.mockRestore();\n    });\n\n    /**\n     * Verifies that the hook returns the expected API functions when used within a provider.\n     */\n    it(\"should provide context helpers functions (inside provider)\", () => {\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper,\n      });\n      expect(result.current).toHaveProperty(\"getAdditionalContext\");\n      expect(result.current).toHaveProperty(\"getContextHelpers\");\n      expect(result.current).toHaveProperty(\"addContextHelper\");\n      expect(result.current).toHaveProperty(\"removeContextHelper\");\n    });\n\n    /**\n     * With no helpers provided, no additional context should be returned.\n     */\n    it(\"should return no additional context when no helpers are provided\", async () => {\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper,\n      });\n      const contexts = await result.current.getAdditionalContext();\n      expect(contexts).toHaveLength(0);\n    });\n\n    /**\n     * When helpers are provided, getAdditionalContext should aggregate them.\n     * Note: prebuiltUserPage may be null in non-browser envs, so we only assert userTime when present.\n     */\n    it(\"should get additional context when helpers are provided\", async () => {\n      const withHelpers = ({ children }: { children: React.ReactNode }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            userTime: currentTimeContextHelper,\n            userPage: currentPageContextHelper,\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      );\n\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper: withHelpers,\n      });\n\n      const contexts = await result.current.getAdditionalContext();\n      const names = contexts.map((c) => c.name);\n\n      // userTime should be present from prebuilt helper\n      expect(names).toContain(\"userTime\");\n      // userPage may be absent on server; do not assert strictly\n    });\n\n    /**\n     * Errors thrown by helper functions should be caught and skipped, not crash the system.\n     */\n    it(\"should handle errors in context helper functions gracefully\", async () => {\n      const consoleErrorSpy = jest\n        .spyOn(console, \"error\")\n        .mockImplementation(() => {});\n\n      const badHelper = () => {\n        throw new Error(\"Test error\");\n      };\n\n      const withBadHelper = ({ children }: { children: React.ReactNode }) => (\n        <TamboContextHelpersProvider contextHelpers={{ badHelper }}>\n          {children}\n        </TamboContextHelpersProvider>\n      );\n\n      const { result } = renderHook(() => useTamboContextHelpers(), {\n        wrapper: withBadHelper,\n      });\n\n      const contexts = await result.current.getAdditionalContext();\n      expect(contexts.length).toBe(0);\n      expect(consoleErrorSpy).toHaveBeenCalledWith(\n        expect.stringContaining(\"Error running context helper badHelper\"),\n        expect.any(Error),\n      );\n      consoleErrorSpy.mockRestore();\n    });\n  });\n});\n\n/**\n * Test suite for Custom Context Helpers using the simplified API.\n *\n * Focuses on:\n * - Passing custom helpers via the provider prop.\n * - Overriding prebuilt helpers with custom implementations.\n * - Dynamic add/remove helper management at runtime.\n * - Supporting both sync and async helpers.\n * - Using the config key as the context name.\n * - Graceful error handling for custom helpers.\n */\ndescribe(\"Custom Context Helpers via contextHelpers config\", () => {\n  beforeEach(() => {\n    setHelpers({});\n    jest.clearAllMocks();\n  });\n\n  /**\n   * Custom helpers can be added through the provider configuration.\n   * The key becomes the context name and the function returns the raw value.\n   */\n  it(\"should accept custom helpers through contextHelpers config\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            customData: async () => ({ custom: \"value\" }),\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"customData\",\n      context: { custom: \"value\" },\n    });\n  });\n\n  /**\n   * Built-in helpers can be overridden by providing a function under the same key.\n   */\n  it(\"should allow custom helpers to override built-in ones\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            userTime: async () => ({ customTime: \"override\" }),\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    const userTimeContext = contexts.find((c) => c.name === \"userTime\");\n    expect(userTimeContext?.context).toEqual({ customTime: \"override\" });\n  });\n\n  /**\n   * Helpers can be added dynamically at runtime via addContextHelper.\n   */\n  it(\"should handle dynamic addition of custom helpers\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider contextHelpers={{}}>\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    // Initially none\n    expect(await result.current.getAdditionalContext()).toHaveLength(0);\n\n    act(() => {\n      result.current.addContextHelper(\"dynamicHelper\", async () => ({\n        dynamic: true,\n      }));\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"dynamicHelper\",\n      context: { dynamic: true },\n    });\n  });\n\n  /**\n   * Helpers can be removed dynamically via removeContextHelper.\n   */\n  it(\"should handle dynamic removal of context helpers\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            customHelper: async () => ({ test: \"data\" }),\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    // Verify exists\n    let contexts = await result.current.getAdditionalContext();\n    expect(contexts.find((c) => c.name === \"customHelper\")).toBeDefined();\n\n    // Remove\n    act(() => {\n      result.current.removeContextHelper(\"customHelper\");\n    });\n\n    // Verify removed\n    contexts = await result.current.getAdditionalContext();\n    expect(contexts.find((c) => c.name === \"customHelper\")).toBeUndefined();\n  });\n\n  /**\n   * Multiple custom helpers should be supported; helpers returning null/undefined are skipped.\n   */\n  it(\"should handle multiple custom helpers\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            helper1: async () => ({ data: \"one\" }),\n            helper2: async () => ({ data: \"two\" }),\n            helper3: () => null, // disabled by returning null\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"helper1\",\n      context: { data: \"one\" },\n    });\n    expect(contexts).toContainEqual({\n      name: \"helper2\",\n      context: { data: \"two\" },\n    });\n    expect(contexts.find((c) => c.name === \"helper3\")).toBeUndefined();\n  });\n\n  /**\n   * Both synchronous and asynchronous helpers should be supported.\n   */\n  it(\"should handle sync and async custom helpers\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            syncHelper: () => ({ sync: true }),\n            asyncHelper: async () => {\n              await new Promise((resolve) => setTimeout(resolve, 10));\n              return { async: true };\n            },\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"syncHelper\",\n      context: { sync: true },\n    });\n    expect(contexts).toContainEqual({\n      name: \"asyncHelper\",\n      context: { async: true },\n    });\n  });\n\n  /**\n   * The key used in the contextHelpers map becomes the context name.\n   */\n  it(\"should use key name as context name for custom helpers\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            myCustomKey: async () => ({ value: \"test\" }),\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"myCustomKey\",\n      context: { value: \"test\" },\n    });\n  });\n\n  /**\n   * Errors thrown by custom helpers should be logged and skipped, not crash the system.\n   */\n  it(\"should handle errors in custom helpers gracefully\", async () => {\n    const consoleErrorSpy = jest\n      .spyOn(console, \"error\")\n      .mockImplementation(() => {});\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            errorHelper: async () => {\n              throw new Error(\"Custom helper error\");\n            },\n            goodHelper: async () => ({ good: \"data\" }),\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"goodHelper\",\n      context: { good: \"data\" },\n    });\n    expect(contexts.find((c) => c.name === \"errorHelper\")).toBeUndefined();\n    expect(consoleErrorSpy).toHaveBeenCalledWith(\n      expect.stringContaining(\"Error running context helper errorHelper\"),\n      expect.any(Error),\n    );\n    consoleErrorSpy.mockRestore();\n  });\n\n  /**\n   * Removing non-existent helpers should be a no-op without throwing errors.\n   */\n  it(\"should handle removing non-existent helper gracefully\", () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider contextHelpers={{}}>\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    expect(() => {\n      act(() => {\n        result.current.removeContextHelper(\"nonExistent\");\n      });\n    }).not.toThrow();\n  });\n\n  /**\n   * Adding with an existing name should update/replace the helper implementation.\n   */\n  it(\"should allow updating existing helper via addContextHelper\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: ({ children }) => (\n        <TamboContextHelpersProvider\n          contextHelpers={{\n            testHelper: async () => ({ original: true }),\n          }}\n        >\n          {children}\n        </TamboContextHelpersProvider>\n      ),\n    });\n\n    // Verify original helper\n    let contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"testHelper\",\n      context: { original: true },\n    });\n\n    // Update the helper\n    act(() => {\n      result.current.addContextHelper(\"testHelper\", async () => ({\n        updated: true,\n      }));\n    });\n\n    // Verify updated helper\n    contexts = await result.current.getAdditionalContext();\n    expect(contexts).toContainEqual({\n      name: \"testHelper\",\n      context: { updated: true },\n    });\n  });\n});\n"]}