feat: Add support for Fetch Implementation

api-report/genai-node.api.md

@@ -1624,6 +1624,7 @@ export class GoogleGenAI {
 export interface GoogleGenAIOptions {
     apiKey?: string;
     apiVersion?: string;
+    fetchImplementation?: typeof fetch;
     googleAuthOptions?: GoogleAuthOptions;
     httpOptions?: HttpOptions;
     location?: string;

api-report/genai-web.api.md

@@ -1624,6 +1624,7 @@ export class GoogleGenAI {
 export interface GoogleGenAIOptions {
     apiKey?: string;
     apiVersion?: string;
+    fetchImplementation?: typeof fetch;
     googleAuthOptions?: GoogleAuthOptions;
     httpOptions?: HttpOptions;
     location?: string;

api-report/genai.api.md

@@ -1624,6 +1624,7 @@ export class GoogleGenAI {
 export interface GoogleGenAIOptions {
     apiKey?: string;
     apiVersion?: string;
+    fetchImplementation?: typeof fetch;
     googleAuthOptions?: GoogleAuthOptions;
     httpOptions?: HttpOptions;
     location?: string;

src/_api_client.ts

@@ -78,6 +78,13 @@ export interface ApiClientInitOptions {
    * This can be used to e.g specify the runtime and its version.
    */
   userAgentExtra?: string;
+  /**
+   * Optional. A custom fetch implementation to use for all HTTP requests made by the SDK.
+   *
+   * @remarks
+   * If unset, the SDK will use the default `fetch` implementation available in the runtime environment.
+   */
+  fetchImplementation?: typeof fetch;
 }
 
 /**
@@ -630,7 +637,10 @@ export class ApiClient implements GeminiNextGenAPIClientAdapter {
     url: string,
     requestInit: RequestInit,
   ): Promise<Response> {
-    return fetch(url, requestInit).catch((e) => {
+    return (this.clientOptions.fetchImplementation || fetch)(
+      url,
+      requestInit,
+    ).catch((e) => {
       throw new Error(`exception ${e} sending request`);
     });
   }

src/client.ts

@@ -89,6 +89,13 @@ export interface GoogleGenAIOptions {
    * Optional. A set of customizable configuration for HTTP requests.
    */
   httpOptions?: HttpOptions;
+  /**
+   * Optional. A custom fetch implementation to use for all HTTP requests made by the SDK.
+   *
+   * @remarks
+   * If unset, the SDK will use the default `fetch` implementation available in the runtime environment.
+   */
+  fetchImplementation?: typeof fetch;
 }
 
 /**
@@ -197,6 +204,7 @@ export class GoogleGenAI {
       userAgentExtra: LANGUAGE_LABEL_PREFIX + 'cross',
       uploader: new CrossUploader(),
       downloader: new CrossDownloader(),
+      fetchImplementation: options.fetchImplementation,
     });
     this.models = new Models(this.apiClient);
     this.live = new Live(this.apiClient, auth, new CrossWebSocketFactory());

src/node/node_client.ts

@@ -210,6 +210,7 @@ export class GoogleGenAI {
       userAgentExtra: LANGUAGE_LABEL_PREFIX + process.version,
       uploader: new NodeUploader(),
       downloader: new NodeDownloader(),
+      fetchImplementation: options.fetchImplementation,
     });
     this.models = new Models(this.apiClient);
     this.live = new Live(this.apiClient, auth, new NodeWebSocketFactory());

src/web/web_client.ts

@@ -151,6 +151,7 @@ export class GoogleGenAI {
       userAgentExtra: LANGUAGE_LABEL_PREFIX + 'web',
       uploader: new BrowserUploader(),
       downloader: new BrowserDownloader(),
+      fetchImplementation: options.fetchImplementation,
     });
     this.models = new Models(this.apiClient);
     this.live = new Live(this.apiClient, auth, new BrowserWebSocketFactory());