@tanstack/ai-gemini 0.24.2 → 0.25.0

package/dist/esm/index.d.ts

@@ -32,6 +32,7 @@ export { GEMINI_EMBEDDING_MODELS } from './model-meta.js';
 export type { GeminiModels as GeminiTextModel } from './model-meta.js';
 export type { GeminiImageModels as GeminiImageModel } from './model-meta.js';
 export type { GeminiTTSVoice } from './model-meta.js';
+export type { GeminiClientConfig } from './utils/client.js';
 export type { GeminiChatModelProviderOptionsByName, GeminiChatModelToolCapabilitiesByName, GeminiModelInputModalitiesByName, GeminiEmbeddingModel, GeminiEmbeddingModelProviderOptionsByName, GeminiEmbeddingModelInputModalitiesByName, } from './model-meta.js';
 export type { GeminiStructuredOutputOptions, GeminiThinkingOptions, } from './text/text-provider-options.js';
 export type { GoogleGeminiTool } from './tools/index.js';

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

@@ -1,9 +1,10 @@
 import { GoogleGenAI, GoogleGenAIOptions } from '@google/genai';
-export interface GeminiClientConfig extends GoogleGenAIOptions {
-    apiKey: string;
-}
+export type GeminiClientConfig = GoogleGenAIOptions;
 /**
- * Creates a Google Generative AI client instance
+ * Creates a Google Generative AI client instance.
+ *
+ * AI Studio mode needs `apiKey`. Vertex / Enterprise mode (`vertexai` or
+ * `enterprise`) uses project, location, and Google Cloud credentials instead.
  */
 export declare function createGeminiClient(config: GeminiClientConfig): GoogleGenAI;
 /**

package/dist/esm/utils/client.js

@@ -2,13 +2,14 @@ import { GoogleGenAI } from "@google/genai";
 import { generateId, getApiKeyFromEnv } from "@tanstack/ai-utils";
 //#region src/utils/client.ts
 /**
-* Creates a Google Generative AI client instance
+* Creates a Google Generative AI client instance.
+*
+* AI Studio mode needs `apiKey`. Vertex / Enterprise mode (`vertexai` or
+* `enterprise`) uses project, location, and Google Cloud credentials instead.
 */
 function createGeminiClient(config) {
-	return new GoogleGenAI({
-		...config,
-		apiKey: config.apiKey
-	});
+	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);
 }
 /**
 * 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 interface GeminiClientConfig extends GoogleGenAIOptions {\n  apiKey: string\n}\n\n/**\n * Creates a Google Generative AI client instance\n */\nexport function createGeminiClient(config: GeminiClientConfig): GoogleGenAI {\n  return new GoogleGenAI({\n    ...config,\n    apiKey: config.apiKey,\n  })\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":";;;;;;AAWA,SAAgB,mBAAmB,QAAyC;CAC1E,OAAO,IAAI,YAAY;EACrB,GAAG;EACH,QAAQ,OAAO;CACjB,CAAC;AACH;;;;;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 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"}

package/package.json

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

package/src/index.ts

@@ -146,6 +146,7 @@ export type { GeminiTTSVoice } from './model-meta'
 // Type Exports
 // ===========================
 
+export type { GeminiClientConfig } from './utils/client'
 export type {
   GeminiChatModelProviderOptionsByName,
   GeminiChatModelToolCapabilitiesByName,

package/src/utils/client.ts

@@ -2,18 +2,25 @@ import { GoogleGenAI } from '@google/genai'
 import { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'
 import type { GoogleGenAIOptions } from '@google/genai'
 
-export interface GeminiClientConfig extends GoogleGenAIOptions {
-  apiKey: string
-}
+export type GeminiClientConfig = GoogleGenAIOptions
 
 /**
- * Creates a Google Generative AI client instance
+ * Creates a Google Generative AI client instance.
+ *
+ * AI Studio mode needs `apiKey`. Vertex / Enterprise mode (`vertexai` or
+ * `enterprise`) uses project, location, and Google Cloud credentials instead.
  */
 export function createGeminiClient(config: GeminiClientConfig): GoogleGenAI {
-  return new GoogleGenAI({
-    ...config,
-    apiKey: config.apiKey,
-  })
+  const vertexMode = config.vertexai === true || config.enterprise === true
+  if (
+    !vertexMode &&
+    (config.apiKey === undefined || 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)
 }
 
 /**