@tanstack/ai-gemini 0.28.0 → 0.29.0

package/dist/esm/utils/client.d.ts

@@ -1,5 +1,17 @@
 import { GoogleGenAI, GoogleGenAIOptions } from '@google/genai';
-export type GeminiClientConfig = GoogleGenAIOptions;
+export interface GeminiClientConfig extends GoogleGenAIOptions {
+    /**
+     * Base URL for every request. Maps onto `httpOptions.baseUrl` and wins
+     * over it when both are set. Same option name as the other adapters, so a
+     * gateway config can be spread into any of them.
+     */
+    baseURL?: string;
+    /**
+     * Headers sent with every request. Maps onto `httpOptions.headers` and wins
+     * over it when both are set. Same option name as the other adapters.
+     */
+    defaultHeaders?: Record<string, string>;
+}
 /**
  * Creates a Google Generative AI client instance.
  *

package/dist/esm/utils/client.js

@@ -9,7 +9,13 @@ import { generateId, getApiKeyFromEnv } from "@tanstack/ai-utils";
 */
 function createGeminiClient(config) {
 	if (!(config.vertexai === true || config.enterprise === true) && (config.apiKey === void 0 || config.apiKey.length === 0)) throw new Error("A Gemini API key is required when vertexai and enterprise are not set. Pass apiKey, or set GOOGLE_API_KEY or GEMINI_API_KEY.");
-	return new GoogleGenAI(config);
+	const { baseURL, defaultHeaders, ...options } = config;
+	if (baseURL !== void 0 || defaultHeaders !== void 0) options.httpOptions = {
+		...options.httpOptions,
+		...baseURL !== void 0 ? { baseUrl: baseURL } : {},
+		...defaultHeaders !== void 0 ? { headers: defaultHeaders } : {}
+	};
+	return new GoogleGenAI(options);
 }
 /**
 * Gets Google API key from environment variables

package/dist/esm/utils/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { GoogleGenAI } from '@google/genai'\nimport { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { GoogleGenAIOptions } from '@google/genai'\n\nexport type GeminiClientConfig = GoogleGenAIOptions\n\n/**\n * Creates a Google Generative AI client instance.\n *\n * AI Studio mode needs `apiKey`. Vertex / Enterprise mode (`vertexai` or\n * `enterprise`) uses project, location, and Google Cloud credentials instead.\n */\nexport function createGeminiClient(config: GeminiClientConfig): GoogleGenAI {\n  const vertexMode = config.vertexai === true || config.enterprise === true\n  if (\n    !vertexMode &&\n    (config.apiKey === undefined || config.apiKey.length === 0)\n  ) {\n    throw new Error(\n      'A Gemini API key is required when vertexai and enterprise are not set. Pass apiKey, or set GOOGLE_API_KEY or GEMINI_API_KEY.',\n    )\n  }\n  return new GoogleGenAI(config)\n}\n\n/**\n * Gets Google API key from environment variables\n * @throws Error if GOOGLE_API_KEY or GEMINI_API_KEY is not found\n */\nexport function getGeminiApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('GOOGLE_API_KEY')\n  } catch {\n    try {\n      return getApiKeyFromEnv('GEMINI_API_KEY')\n    } catch {\n      throw new Error(\n        'GOOGLE_API_KEY or GEMINI_API_KEY is not set. Please set one of these environment variables or pass the API key directly.',\n      )\n    }\n  }\n}\n\n/**\n * Generates a unique ID with a prefix\n */\nexport function generateId(prefix: string): string {\n  return _generateId(prefix)\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,mBAAmB,QAAyC;CAE1E,IACE,EAFiB,OAAO,aAAa,QAAQ,OAAO,eAAe,UAGlE,OAAO,WAAW,KAAA,KAAa,OAAO,OAAO,WAAW,IAEzD,MAAM,IAAI,MACR,8HACF;CAEF,OAAO,IAAI,YAAY,MAAM;AAC/B;;;;;AAMA,SAAgB,yBAAiC;CAC/C,IAAI;EACF,OAAO,iBAAiB,gBAAgB;CAC1C,QAAQ;EACN,IAAI;GACF,OAAO,iBAAiB,gBAAgB;EAC1C,QAAQ;GACN,MAAM,IAAI,MACR,0HACF;EACF;CACF;AACF;;;;AAKA,SAAgB,aAAW,QAAwB;CACjD,OAAO,WAAY,MAAM;AAC3B"}
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { GoogleGenAI } from '@google/genai'\nimport { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { GoogleGenAIOptions } from '@google/genai'\n\nexport interface GeminiClientConfig extends GoogleGenAIOptions {\n  /**\n   * Base URL for every request. Maps onto `httpOptions.baseUrl` and wins\n   * over it when both are set. Same option name as the other adapters, so a\n   * gateway config can be spread into any of them.\n   */\n  baseURL?: string\n  /**\n   * Headers sent with every request. Maps onto `httpOptions.headers` and wins\n   * over it when both are set. Same option name as the other adapters.\n   */\n  defaultHeaders?: Record<string, string>\n}\n\n/**\n * Creates a Google Generative AI client instance.\n *\n * AI Studio mode needs `apiKey`. Vertex / Enterprise mode (`vertexai` or\n * `enterprise`) uses project, location, and Google Cloud credentials instead.\n */\nexport function createGeminiClient(config: GeminiClientConfig): GoogleGenAI {\n  const vertexMode = config.vertexai === true || config.enterprise === true\n  if (\n    !vertexMode &&\n    (config.apiKey === undefined || config.apiKey.length === 0)\n  ) {\n    throw new Error(\n      'A Gemini API key is required when vertexai and enterprise are not set. Pass apiKey, or set GOOGLE_API_KEY or GEMINI_API_KEY.',\n    )\n  }\n  const { baseURL, defaultHeaders, ...options } = config\n  if (baseURL !== undefined || defaultHeaders !== undefined) {\n    options.httpOptions = {\n      ...options.httpOptions,\n      ...(baseURL !== undefined ? { baseUrl: baseURL } : {}),\n      ...(defaultHeaders !== undefined ? { headers: defaultHeaders } : {}),\n    }\n  }\n  return new GoogleGenAI(options)\n}\n\n/**\n * Gets Google API key from environment variables\n * @throws Error if GOOGLE_API_KEY or GEMINI_API_KEY is not found\n */\nexport function getGeminiApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('GOOGLE_API_KEY')\n  } catch {\n    try {\n      return getApiKeyFromEnv('GEMINI_API_KEY')\n    } catch {\n      throw new Error(\n        'GOOGLE_API_KEY or GEMINI_API_KEY is not set. Please set one of these environment variables or pass the API key directly.',\n      )\n    }\n  }\n}\n\n/**\n * Generates a unique ID with a prefix\n */\nexport function generateId(prefix: string): string {\n  return _generateId(prefix)\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,mBAAmB,QAAyC;CAE1E,IACE,EAFiB,OAAO,aAAa,QAAQ,OAAO,eAAe,UAGlE,OAAO,WAAW,KAAA,KAAa,OAAO,OAAO,WAAW,IAEzD,MAAM,IAAI,MACR,8HACF;CAEF,MAAM,EAAE,SAAS,gBAAgB,GAAG,YAAY;CAChD,IAAI,YAAY,KAAA,KAAa,mBAAmB,KAAA,GAC9C,QAAQ,cAAc;EACpB,GAAG,QAAQ;EACX,GAAI,YAAY,KAAA,IAAY,EAAE,SAAS,QAAQ,IAAI,CAAC;EACpD,GAAI,mBAAmB,KAAA,IAAY,EAAE,SAAS,eAAe,IAAI,CAAC;CACpE;CAEF,OAAO,IAAI,YAAY,OAAO;AAChC;;;;;AAMA,SAAgB,yBAAiC;CAC/C,IAAI;EACF,OAAO,iBAAiB,gBAAgB;CAC1C,QAAQ;EACN,IAAI;GACF,OAAO,iBAAiB,gBAAgB;EAC1C,QAAQ;GACN,MAAM,IAAI,MACR,0HACF;EACF;CACF;AACF;;;;AAKA,SAAgB,aAAW,QAAwB;CACjD,OAAO,WAAY,MAAM;AAC3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-gemini",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Google Gemini adapter for TanStack AI chat, images, speech, audio generation, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -63,13 +63,13 @@
     "@tanstack/ai-utils": "^0.4.0"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.52.2"
+    "@tanstack/ai": "^0.52.3"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
     "vite": "^8.2.1",
     "zod": "^4.2.0",
-    "@tanstack/ai": "0.52.2"
+    "@tanstack/ai": "0.52.3"
   },
   "scripts": {
     "build": "vite build",

package/src/utils/client.ts

@@ -2,7 +2,19 @@ import { GoogleGenAI } from '@google/genai'
 import { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'
 import type { GoogleGenAIOptions } from '@google/genai'
 
-export type GeminiClientConfig = GoogleGenAIOptions
+export interface GeminiClientConfig extends GoogleGenAIOptions {
+  /**
+   * Base URL for every request. Maps onto `httpOptions.baseUrl` and wins
+   * over it when both are set. Same option name as the other adapters, so a
+   * gateway config can be spread into any of them.
+   */
+  baseURL?: string
+  /**
+   * Headers sent with every request. Maps onto `httpOptions.headers` and wins
+   * over it when both are set. Same option name as the other adapters.
+   */
+  defaultHeaders?: Record<string, string>
+}
 
 /**
  * Creates a Google Generative AI client instance.
@@ -20,7 +32,15 @@ export function createGeminiClient(config: GeminiClientConfig): GoogleGenAI {
       'A Gemini API key is required when vertexai and enterprise are not set. Pass apiKey, or set GOOGLE_API_KEY or GEMINI_API_KEY.',
     )
   }
-  return new GoogleGenAI(config)
+  const { baseURL, defaultHeaders, ...options } = config
+  if (baseURL !== undefined || defaultHeaders !== undefined) {
+    options.httpOptions = {
+      ...options.httpOptions,
+      ...(baseURL !== undefined ? { baseUrl: baseURL } : {}),
+      ...(defaultHeaders !== undefined ? { headers: defaultHeaders } : {}),
+    }
+  }
+  return new GoogleGenAI(options)
 }
 
 /**