@gram-ai/elements 1.18.3 → 1.18.5

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/api.d.ts

@@ -0,0 +1,2 @@
+import { ElementsConfig } from '../types';
+export declare function getApiUrl(config: ElementsConfig): string;

package/dist/lib/api.test.d.ts

@@ -0,0 +1 @@
+export {};

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.3",
+  "version": "1.18.5",
   "main": "dist/index.js",
   "exports": {
     ".": {
@@ -134,10 +134,13 @@
     "typescript-eslint": "^8.48.1",
     "vite": "^7.1.6",
     "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.13",
     "zustand": "^5.0.8"
   },
   "scripts": {
     "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "lint": "eslint src",
     "analyze": "pnpm dlx vite-bundle-visualizer",
     "storybook": "storybook dev -p 6006",