@ai-sdk/gateway 3.0.39 → 3.0.41

package/src/errors/as-gateway-error.ts

@@ -1,8 +1,32 @@
 import { APICallError } from '@ai-sdk/provider';
 import { extractApiCallResponse, GatewayError } from '.';
 import { createGatewayErrorFromResponse } from './create-gateway-error';
+import { GatewayTimeoutError } from './gateway-timeout-error';
 
-export function asGatewayError(
+/**
+ * Checks if an error is a timeout error from undici.
+ * Only checks undici-specific error codes to avoid false positives.
+ */
+function isTimeoutError(error: unknown): boolean {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+
+  // Check for undici-specific timeout error codes
+  const errorCode = (error as any).code;
+  if (typeof errorCode === 'string') {
+    const undiciTimeoutCodes = [
+      'UND_ERR_HEADERS_TIMEOUT',
+      'UND_ERR_BODY_TIMEOUT',
+      'UND_ERR_CONNECT_TIMEOUT',
+    ];
+    return undiciTimeoutCodes.includes(errorCode);
+  }
+
+  return false;
+}
+
+export async function asGatewayError(
   error: unknown,
   authMethod?: 'api-key' | 'oidc',
 ) {
@@ -10,8 +34,25 @@ export function asGatewayError(
     return error;
   }
 
+  // Check if this is a timeout error (or has a timeout error in the cause chain)
+  if (isTimeoutError(error)) {
+    return GatewayTimeoutError.createTimeoutError({
+      originalMessage: error instanceof Error ? error.message : 'Unknown error',
+      cause: error,
+    });
+  }
+
+  // Check if this is an APICallError caused by a timeout
   if (APICallError.isInstance(error)) {
-    return createGatewayErrorFromResponse({
+    // Check if the cause is a timeout error
+    if (error.cause && isTimeoutError(error.cause)) {
+      return GatewayTimeoutError.createTimeoutError({
+        originalMessage: error.message,
+        cause: error,
+      });
+    }
+
+    return await createGatewayErrorFromResponse({
       response: extractApiCallResponse(error),
       statusCode: error.statusCode ?? 500,
       defaultMessage: 'Gateway request failed',
@@ -20,7 +61,7 @@ export function asGatewayError(
     });
   }
 
-  return createGatewayErrorFromResponse({
+  return await createGatewayErrorFromResponse({
     response: {},
     statusCode: 500,
     defaultMessage:

package/src/errors/gateway-timeout-error.ts

@@ -0,0 +1,59 @@
+import { GatewayError } from './gateway-error';
+
+const name = 'GatewayTimeoutError';
+const marker = `vercel.ai.gateway.error.${name}`;
+const symbol = Symbol.for(marker);
+
+/**
+ * Client request timed out before receiving a response.
+ */
+export class GatewayTimeoutError extends GatewayError {
+  private readonly [symbol] = true; // used in isInstance
+
+  readonly name = name;
+  readonly type = 'timeout_error';
+
+  constructor({
+    message = 'Request timed out',
+    statusCode = 408,
+    cause,
+    generationId,
+  }: {
+    message?: string;
+    statusCode?: number;
+    cause?: unknown;
+    generationId?: string;
+  } = {}) {
+    super({ message, statusCode, cause, generationId });
+  }
+
+  static isInstance(error: unknown): error is GatewayTimeoutError {
+    return GatewayError.hasMarker(error) && symbol in error;
+  }
+
+  /**
+   * Creates a helpful timeout error message with troubleshooting guidance
+   */
+  static createTimeoutError({
+    originalMessage,
+    statusCode = 408,
+    cause,
+    generationId,
+  }: {
+    originalMessage: string;
+    statusCode?: number;
+    cause?: unknown;
+    generationId?: string;
+  }): GatewayTimeoutError {
+    const message = `Gateway request timed out: ${originalMessage}
+
+    This is a client-side timeout. To resolve this, increase your timeout configuration: https://vercel.com/docs/ai-gateway/capabilities/video-generation#extending-timeouts-for-node.js`;
+
+    return new GatewayTimeoutError({
+      message,
+      statusCode,
+      cause,
+      generationId,
+    });
+  }
+}

package/src/errors/index.ts

@@ -14,3 +14,4 @@ export {
 } from './gateway-model-not-found-error';
 export { GatewayRateLimitError } from './gateway-rate-limit-error';
 export { GatewayResponseError } from './gateway-response-error';
+export { GatewayTimeoutError } from './gateway-timeout-error';

package/src/gateway-provider-options.ts

@@ -2,7 +2,7 @@ import { InferSchema, lazySchema, zodSchema } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 // https://vercel.com/docs/ai-gateway/provider-options
-const gatewayProviderOptions = lazySchema(() =>
+const gatewayLanguageModelOptions = lazySchema(() =>
   zodSchema(
     z.object({
       /**
@@ -63,4 +63,6 @@ const gatewayProviderOptions = lazySchema(() =>
   ),
 );
 
-export type GatewayProviderOptions = InferSchema<typeof gatewayProviderOptions>;
+export type GatewayLanguageModelOptions = InferSchema<
+  typeof gatewayLanguageModelOptions
+>;

package/src/index.ts

@@ -15,7 +15,11 @@ export type {
   GatewayProvider,
   GatewayProviderSettings,
 } from './gateway-provider';
-export type { GatewayProviderOptions } from './gateway-provider-options';
+export type {
+  GatewayLanguageModelOptions,
+  /** @deprecated Use `GatewayLanguageModelOptions` instead. */
+  GatewayLanguageModelOptions as GatewayProviderOptions,
+} from './gateway-provider-options';
 export {
   GatewayError,
   GatewayAuthenticationError,