@vercel/functions 3.1.0 → 3.1.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @vercel/functions
 
+## 3.1.2
+
+### Patch Changes
+
+- Add configurable timeout to RuntimeCache with sensible default to fail faster on gateway timeouts ([#14036](https://github.com/vercel/vercel/pull/14036))
+
+  The RuntimeCache client now includes a configurable timeout (default 500ms) for all fetch requests to prevent indefinite hangs on 502/504 gateway timeouts.
+  The timeout can be configured at build time via the `RUNTIME_CACHE_TIMEOUT` environment variable. When a timeout occurs, the request is aborted and the
+  error is logged via the onError callback.
+
+## 3.1.1
+
+### Patch Changes
+
+- Stronger detection of Vercel Runtime to reduce warnings ([#13776](https://github.com/vercel/vercel/pull/13776))
+
+- Updated dependencies [[`da6ca6d80915221b7f60cd711e4fada41a828e4c`](https://github.com/vercel/vercel/commit/da6ca6d80915221b7f60cd711e4fada41a828e4c), [`da6ca6d80915221b7f60cd711e4fada41a828e4c`](https://github.com/vercel/vercel/commit/da6ca6d80915221b7f60cd711e4fada41a828e4c), [`da6ca6d80915221b7f60cd711e4fada41a828e4c`](https://github.com/vercel/vercel/commit/da6ca6d80915221b7f60cd711e4fada41a828e4c)]:
+  - @vercel/oidc@3.0.1
+
 ## 3.1.0
 
 ### Minor Changes

package/cache/build-client.d.ts

@@ -2,10 +2,12 @@ export declare class BuildCache {
     private readonly endpoint;
     private readonly headers;
     private readonly onError?;
-    constructor({ endpoint, headers, onError, }: {
+    private readonly timeout;
+    constructor({ endpoint, headers, onError, timeout, }: {
         endpoint: string;
         headers: Record<string, string>;
         onError?: (error: Error) => void;
+        timeout?: number;
     });
     get: (key: string) => Promise<unknown>;
     set: (key: string, value: unknown, options?: {

package/cache/build-client.js

@@ -26,15 +26,20 @@ class BuildCache {
   constructor({
     endpoint,
     headers,
-    onError
+    onError,
+    timeout = 500
   }) {
     this.get = async (key) => {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
       try {
         const res = await fetch(`${this.endpoint}${key}`, {
           headers: this.headers,
-          method: "GET"
+          method: "GET",
+          signal: controller.signal
         });
         if (res.status === 404) {
+          clearTimeout(timeoutId);
           return null;
         }
         if (res.status === 200) {
@@ -43,18 +48,33 @@ class BuildCache {
           );
           if (cacheState !== import_index.PkgCacheState.Fresh) {
             res.body?.cancel?.();
+            clearTimeout(timeoutId);
             return null;
           }
-          return await res.json();
+          const result = await res.json();
+          clearTimeout(timeoutId);
+          return result;
         } else {
+          clearTimeout(timeoutId);
           throw new Error(`Failed to get cache: ${res.statusText}`);
         }
       } catch (error) {
-        this.onError?.(error);
+        clearTimeout(timeoutId);
+        if (error.name === "AbortError") {
+          const timeoutError = new Error(
+            `Cache request timed out after ${this.timeout}ms`
+          );
+          timeoutError.stack = error.stack;
+          this.onError?.(timeoutError);
+        } else {
+          this.onError?.(error);
+        }
         return null;
       }
     };
     this.set = async (key, value, options) => {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
       try {
         const optionalHeaders = {};
         if (options?.ttl) {
@@ -72,47 +92,85 @@ class BuildCache {
             ...this.headers,
             ...optionalHeaders
           },
-          body: JSON.stringify(value)
+          body: JSON.stringify(value),
+          signal: controller.signal
         });
+        clearTimeout(timeoutId);
         if (res.status !== 200) {
           throw new Error(`Failed to set cache: ${res.status} ${res.statusText}`);
         }
       } catch (error) {
-        this.onError?.(error);
+        clearTimeout(timeoutId);
+        if (error.name === "AbortError") {
+          const timeoutError = new Error(
+            `Cache request timed out after ${this.timeout}ms`
+          );
+          timeoutError.stack = error.stack;
+          this.onError?.(timeoutError);
+        } else {
+          this.onError?.(error);
+        }
       }
     };
     this.delete = async (key) => {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
       try {
         const res = await fetch(`${this.endpoint}${key}`, {
           method: "DELETE",
-          headers: this.headers
+          headers: this.headers,
+          signal: controller.signal
         });
+        clearTimeout(timeoutId);
         if (res.status !== 200) {
           throw new Error(`Failed to delete cache: ${res.statusText}`);
         }
       } catch (error) {
-        this.onError?.(error);
+        clearTimeout(timeoutId);
+        if (error.name === "AbortError") {
+          const timeoutError = new Error(
+            `Cache request timed out after ${this.timeout}ms`
+          );
+          timeoutError.stack = error.stack;
+          this.onError?.(timeoutError);
+        } else {
+          this.onError?.(error);
+        }
       }
     };
     this.expireTag = async (tag) => {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
       try {
         if (Array.isArray(tag)) {
           tag = tag.join(",");
         }
         const res = await fetch(`${this.endpoint}revalidate?tags=${tag}`, {
           method: "POST",
-          headers: this.headers
+          headers: this.headers,
+          signal: controller.signal
         });
+        clearTimeout(timeoutId);
         if (res.status !== 200) {
           throw new Error(`Failed to revalidate tag: ${res.statusText}`);
         }
       } catch (error) {
-        this.onError?.(error);
+        clearTimeout(timeoutId);
+        if (error.name === "AbortError") {
+          const timeoutError = new Error(
+            `Cache request timed out after ${this.timeout}ms`
+          );
+          timeoutError.stack = error.stack;
+          this.onError?.(timeoutError);
+        } else {
+          this.onError?.(error);
+        }
       }
     };
     this.endpoint = endpoint;
     this.headers = headers;
     this.onError = onError;
+    this.timeout = timeout;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/cache/index.js

@@ -114,10 +114,22 @@ function getCacheImplementation(debug) {
       console.error("Failed to parse RUNTIME_CACHE_HEADERS:", e);
       return inMemoryCacheInstance;
     }
+    let timeout = 500;
+    if (process.env.RUNTIME_CACHE_TIMEOUT) {
+      const parsed = parseInt(process.env.RUNTIME_CACHE_TIMEOUT, 10);
+      if (!isNaN(parsed) && parsed > 0) {
+        timeout = parsed;
+      } else {
+        console.warn(
+          `Invalid RUNTIME_CACHE_TIMEOUT value: "${process.env.RUNTIME_CACHE_TIMEOUT}". Using default: ${timeout}ms`
+        );
+      }
+    }
     buildCacheInstance = new import_build_client.BuildCache({
       endpoint: RUNTIME_CACHE_ENDPOINT,
       headers: parsedHeaders,
-      onError: (error) => console.error(error)
+      onError: (error) => console.error(error),
+      timeout
     });
   }
   return buildCacheInstance;

package/db-connections/index.js

@@ -61,7 +61,8 @@ let idleTimeoutResolve = () => {
 const bootTime = Date.now();
 const maximumDuration = 15 * 60 * 1e3 - 1e3;
 function waitUntilIdleTimeout(dbPool) {
-  if (!process.env.VERCEL_URL) {
+  if (!process.env.VERCEL_URL || // This is not set during builds where we don't need to wait for idle connections using the mechanism
+  !process.env.VERCEL_REGION) {
     return;
   }
   if (idleTimeout) {

package/docs/modules/index.md

@@ -56,7 +56,7 @@ attachDatabasePool(pgPool);
 
 #### Defined in
 
-[packages/functions/src/db-connections/index.ts:221](https://github.com/vercel/vercel/blob/main/packages/functions/src/db-connections/index.ts#L221)
+[packages/functions/src/db-connections/index.ts:225](https://github.com/vercel/vercel/blob/main/packages/functions/src/db-connections/index.ts#L225)
 
 ---
 
@@ -101,7 +101,7 @@ Use attachDatabasePool instead.
 
 #### Defined in
 
-[packages/functions/src/db-connections/index.ts:221](https://github.com/vercel/vercel/blob/main/packages/functions/src/db-connections/index.ts#L221)
+[packages/functions/src/db-connections/index.ts:225](https://github.com/vercel/vercel/blob/main/packages/functions/src/db-connections/index.ts#L225)
 
 ---
 

package/package.json

@@ -30,7 +30,7 @@
       "require": "./middleware.js"
     }
   },
-  "version": "3.1.0",
+  "version": "3.1.2",
   "repository": {
     "directory": "packages/functions",
     "type": "git",
@@ -72,7 +72,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@vercel/oidc": "3.0.0"
+    "@vercel/oidc": "3.0.1"
   },
   "scripts": {
     "pretest": "pnpm run build:code",