@gram-ai/elements 1.18.2 → 1.18.4

package/dist/hooks/useSession.d.ts

@@ -3,7 +3,8 @@ import { GetSessionFn } from '../types';
  * Hook to fetch or retrieve the session token for the chat.
  * @returns The session token string or null
  */
-export declare const useSession: ({ getSession, projectSlug, }: {
+export declare const useSession: ({ getSession, projectSlug, enabled, }: {
     getSession: GetSessionFn | null;
     projectSlug: string;
+    enabled: boolean;
 }) => string | null;

package/dist/lib/auth.d.ts

@@ -0,0 +1,5 @@
+import { ApiKeyAuthConfig, AuthConfig } from '../types';
+/**
+ * Checks if the auth config is an API key auth config
+ */
+export declare function isApiKeyAuth(auth: AuthConfig | undefined): auth is ApiKeyAuthConfig;

package/dist/types/index.d.ts

@@ -243,7 +243,7 @@ export interface ElementsConfig {
         url?: string;
     } & AuthConfig;
 }
-export type AuthConfig = {
+export type SessionAuthConfig = {
     /**
      * The function to use to retrieve the session token from the backend endpoint.
      * By default, this will attempt to fetch the session token from `/chat/session`.
@@ -257,8 +257,23 @@ export type AuthConfig = {
      *   },
      * }
      */
-    sessionFn?: GetSessionFn;
-} | {
+    sessionFn: GetSessionFn;
+};
+/**
+ * The API key auth config is used to authenticate the Elements library using an API key only.
+ *
+ * NOTE: This is not recommended for production use, and a warning
+ * will be displayed in the chat interface if you use this config.
+ * Define a session endpoint instead to avoid this warning.
+ *
+ * @example
+ * const config: ElementsConfig = {
+ *   api: {
+ *     UNSAFE_apiKey: 'your-api-key',
+ *   },
+ * }
+ */
+export type ApiKeyAuthConfig = {
     /**
      * The API key to use if you haven't yet configured a session endpoint.
      * Do not use this in production.
@@ -272,6 +287,7 @@ export type AuthConfig = {
      */
     UNSAFE_apiKey: string;
 };
+export type AuthConfig = SessionAuthConfig | ApiKeyAuthConfig | undefined;
 /**
  * The LLM model to use for the Elements library.
  *

package/package.json

@@ -2,7 +2,7 @@
   "name": "@gram-ai/elements",
   "description": "Gram Elements is a library of UI primitives for building chat-like experiences for MCP Servers.",
   "type": "module",
-  "version": "1.18.2",
+  "version": "1.18.4",
   "main": "dist/index.js",
   "exports": {
     ".": {