@vercel/functions 2.0.2 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @vercel/functions
 
+## 2.1.0
+
+### Minor Changes
+
+- Change the load order of the OIDC token ([#13337](https://github.com/vercel/vercel/pull/13337))
+
+### Patch Changes
+
+- Rename getRuntimeCache to getCache ([#13325](https://github.com/vercel/vercel/pull/13325))
+
+## 2.0.3
+
+### Patch Changes
+
+- Rename FunctionCache / getFunctionCache to RuntimeCache / getRuntimeCache ([#13296](https://github.com/vercel/vercel/pull/13296))
+
 ## 2.0.2
 
 ### Patch Changes

package/cache/in-memory-cache.d.ts

@@ -1,5 +1,5 @@
-import { FunctionCache } from './types';
-export declare class InMemoryCache implements FunctionCache {
+import { RuntimeCache } from './types';
+export declare class InMemoryCache implements RuntimeCache {
     private cache;
     get(key: string, options?: {
         tags?: string[];

package/cache/index.d.ts

@@ -1,6 +1,6 @@
-import { CacheOptions, FunctionCache } from './types';
+import { CacheOptions, RuntimeCache } from './types';
 /**
- * Retrieves the Vercel Function Cache.
+ * Retrieves the Vercel Runtime Cache.
  *
  * Keys are hashed to ensure they are unique and consistent. The hashing function can be overridden by providing a custom
  * `keyHashFunction` in the `cacheOptions` parameter.
@@ -10,7 +10,7 @@ import { CacheOptions, FunctionCache } from './types';
  * namespaceSeparator can also be customized using the `namespaceSeparator` option.
  *
  * @param cacheOptions - Optional configuration for the cache.
- * @returns An instance of the Vercel Function Cache.
+ * @returns An instance of the Vercel Runtime Cache.
  * @throws {Error} If no cache is available in the context and `InMemoryCache` cannot be created.
  */
-export declare const getFunctionCache: (cacheOptions?: CacheOptions) => FunctionCache;
+export declare const getCache: (cacheOptions?: CacheOptions) => RuntimeCache;

package/cache/index.js

@@ -18,7 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var cache_exports = {};
 __export(cache_exports, {
-  getFunctionCache: () => getFunctionCache
+  getCache: () => getCache
 });
 module.exports = __toCommonJS(cache_exports);
 var import_get_context = require("../get-context");
@@ -32,7 +32,7 @@ const defaultKeyHashFunction = (key) => {
 };
 const defaultNamespaceSeparator = "$";
 let inMemoryCacheInstance = null;
-const getFunctionCache = (cacheOptions) => {
+const getCache = (cacheOptions) => {
   let cache;
   if ((0, import_get_context.getContext)().cache) {
     cache = (0, import_get_context.getContext)().cache;
@@ -68,5 +68,5 @@ const getFunctionCache = (cacheOptions) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  getFunctionCache
+  getCache
 });

package/cache/types.d.ts

@@ -1,7 +1,7 @@
 /**
- * Interface representing the function cache.
+ * Interface representing the runtime cache.
  */
-export interface FunctionCache {
+export interface RuntimeCache {
     /**
      * Deletes a value from the cache.
      *

package/docs/interfaces/{index.FunctionCache.md → index.RuntimeCache.md}

@@ -1,17 +1,17 @@
-# Interface: FunctionCache
+# Interface: RuntimeCache
 
-[index](../modules/index.md).FunctionCache
+[index](../modules/index.md).RuntimeCache
 
-Interface representing the function cache.
+Interface representing the runtime cache.
 
 ## Table of contents
 
 ### Properties
 
-- [delete](index.FunctionCache.md#delete)
-- [expireTag](index.FunctionCache.md#expiretag)
-- [get](index.FunctionCache.md#get)
-- [set](index.FunctionCache.md#set)
+- [delete](index.RuntimeCache.md#delete)
+- [expireTag](index.RuntimeCache.md#expiretag)
+- [get](index.RuntimeCache.md#get)
+- [set](index.RuntimeCache.md#set)
 
 ## Properties
 

package/docs/interfaces/oidc.AwsCredentialsProviderInit.md

@@ -40,7 +40,7 @@ Omit.clientConfig
 
 #### Defined in
 
-node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.803.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:135
+node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.806.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:135
 
 ---
 
@@ -56,7 +56,7 @@ Omit.clientPlugins
 
 #### Defined in
 
-node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.803.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:139
+node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.806.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:139
 
 ---
 
@@ -202,7 +202,7 @@ Omit.roleAssumerWithWebIdentity
 
 #### Defined in
 
-node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.803.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:130
+node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.806.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:130
 
 ---
 
@@ -218,4 +218,4 @@ Omit.roleSessionName
 
 #### Defined in
 
-node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.803.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:123
+node*modules/.pnpm/@aws-sdk+credential-provider-web-identity@3.609.0*@aws-sdk+client-sts@3.806.0/node_modules/@aws-sdk/credential-provider-web-identity/dist-types/fromWebToken.d.ts:123

package/docs/modules/index.md

@@ -4,15 +4,15 @@
 
 ### Interfaces
 
-- [FunctionCache](../interfaces/index.FunctionCache.md)
 - [Geo](../interfaces/index.Geo.md)
 - [Request](../interfaces/index.Request.md)
+- [RuntimeCache](../interfaces/index.RuntimeCache.md)
 
 ### Functions
 
 - [geolocation](index.md#geolocation)
+- [getCache](index.md#getcache)
 - [getEnv](index.md#getenv)
-- [getFunctionCache](index.md#getfunctioncache)
 - [ipAddress](index.md#ipaddress)
 - [next](index.md#next)
 - [rewrite](index.md#rewrite)
@@ -68,6 +68,41 @@ The location information of the request, in this way:
 
 ---
 
+### getCache
+
+▸ **getCache**(`cacheOptions?`): [`RuntimeCache`](../interfaces/index.RuntimeCache.md)
+
+Retrieves the Vercel Runtime Cache.
+
+Keys are hashed to ensure they are unique and consistent. The hashing function can be overridden by providing a custom
+`keyHashFunction` in the `cacheOptions` parameter.
+
+To specify a namespace for the cache keys, you can pass a `namespace` option in the `cacheOptions` parameter. If
+a namespace is provided, the cache keys will be prefixed with the namespace followed by a separator (default is `$`). The
+namespaceSeparator can also be customized using the `namespaceSeparator` option.
+
+**`Throws`**
+
+If no cache is available in the context and `InMemoryCache` cannot be created.
+
+#### Parameters
+
+| Name            | Type           | Description                           |
+| :-------------- | :------------- | :------------------------------------ |
+| `cacheOptions?` | `CacheOptions` | Optional configuration for the cache. |
+
+#### Returns
+
+[`RuntimeCache`](../interfaces/index.RuntimeCache.md)
+
+An instance of the Vercel Runtime Cache.
+
+#### Defined in
+
+[packages/functions/src/cache/index.ts:32](https://github.com/vercel/vercel/blob/main/packages/functions/src/cache/index.ts#L32)
+
+---
+
 ### getEnv
 
 ▸ **getEnv**(`env?`): `Object`
@@ -118,41 +153,6 @@ https://vercel.com/docs/projects/environment-variables/system-environment-variab
 
 ---
 
-### getFunctionCache
-
-▸ **getFunctionCache**(`cacheOptions?`): [`FunctionCache`](../interfaces/index.FunctionCache.md)
-
-Retrieves the Vercel Function Cache.
-
-Keys are hashed to ensure they are unique and consistent. The hashing function can be overridden by providing a custom
-`keyHashFunction` in the `cacheOptions` parameter.
-
-To specify a namespace for the cache keys, you can pass a `namespace` option in the `cacheOptions` parameter. If
-a namespace is provided, the cache keys will be prefixed with the namespace followed by a separator (default is `$`). The
-namespaceSeparator can also be customized using the `namespaceSeparator` option.
-
-**`Throws`**
-
-If no cache is available in the context and `InMemoryCache` cannot be created.
-
-#### Parameters
-
-| Name            | Type           | Description                           |
-| :-------------- | :------------- | :------------------------------------ |
-| `cacheOptions?` | `CacheOptions` | Optional configuration for the cache. |
-
-#### Returns
-
-[`FunctionCache`](../interfaces/index.FunctionCache.md)
-
-An instance of the Vercel Function Cache.
-
-#### Defined in
-
-[packages/functions/src/cache/index.ts:32](https://github.com/vercel/vercel/blob/main/packages/functions/src/cache/index.ts#L32)
-
----
-
 ### ipAddress
 
 ▸ **ipAddress**(`input`): `string` \| `undefined`

package/docs/modules/oidc.md

@@ -66,8 +66,9 @@ A function that provides AWS credentials.
 
 Returns the OIDC token from the request context or the environment variable.
 
-This function first checks if the OIDC token is available in the environment variable
-`VERCEL_OIDC_TOKEN`. If it is not found there, it retrieves the token from the request
+This function is used to retrieve the OIDC token from the request context or the environment variable.
+It checks for the `x-vercel-oidc-token` header in the request context and falls back to the `VERCEL_OIDC_TOKEN` environment variable if the header is not present.
+
 context headers.
 
 **`Throws`**
@@ -95,4 +96,4 @@ A promise that resolves to the OIDC token.
 
 #### Defined in
 
-[packages/functions/src/oidc/get-vercel-oidc-token.ts:24](https://github.com/vercel/vercel/blob/main/packages/functions/src/oidc/get-vercel-oidc-token.ts#L24)
+[packages/functions/src/oidc/get-vercel-oidc-token.ts:25](https://github.com/vercel/vercel/blob/main/packages/functions/src/oidc/get-vercel-oidc-token.ts#L25)

package/get-context.d.ts

@@ -1,7 +1,7 @@
-import { FunctionCache } from './cache/types';
+import { RuntimeCache } from './cache/types';
 type Context = {
     waitUntil?: (promise: Promise<unknown>) => void;
-    cache?: FunctionCache;
+    cache?: RuntimeCache;
     headers?: Record<string, string>;
 };
 export declare const SYMBOL_FOR_REQ_CONTEXT: unique symbol;

package/index.d.ts

@@ -3,5 +3,5 @@ export { geolocation, ipAddress } from './headers';
 export { getEnv } from './get-env';
 export { waitUntil } from './wait-until';
 export { rewrite, next } from './middleware';
-export { getFunctionCache } from './cache';
-export type { FunctionCache } from './cache/types';
+export { getCache } from './cache';
+export type { RuntimeCache } from './cache/types';

package/index.js

@@ -19,8 +19,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   geolocation: () => import_headers.geolocation,
+  getCache: () => import_cache.getCache,
   getEnv: () => import_get_env.getEnv,
-  getFunctionCache: () => import_cache.getFunctionCache,
   ipAddress: () => import_headers.ipAddress,
   next: () => import_middleware.next,
   rewrite: () => import_middleware.rewrite,
@@ -35,8 +35,8 @@ var import_cache = require("./cache");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   geolocation,
+  getCache,
   getEnv,
-  getFunctionCache,
   ipAddress,
   next,
   rewrite,

package/oidc/get-vercel-oidc-token.d.ts

@@ -1,8 +1,9 @@
 /**
  * Returns the OIDC token from the request context or the environment variable.
  *
- * This function first checks if the OIDC token is available in the environment variable
- * `VERCEL_OIDC_TOKEN`. If it is not found there, it retrieves the token from the request
+ * This function is used to retrieve the OIDC token from the request context or the environment variable.
+ * It checks for the `x-vercel-oidc-token` header in the request context and falls back to the `VERCEL_OIDC_TOKEN` environment variable if the header is not present.
+ *
  * context headers.
  *
  * @returns {Promise<string>} A promise that resolves to the OIDC token.

package/oidc/get-vercel-oidc-token.js

@@ -23,9 +23,7 @@ __export(get_vercel_oidc_token_exports, {
 module.exports = __toCommonJS(get_vercel_oidc_token_exports);
 var import_get_context = require("../get-context");
 async function getVercelOidcToken() {
-  if (process.env.VERCEL_OIDC_TOKEN)
-    return process.env.VERCEL_OIDC_TOKEN;
-  const token = (0, import_get_context.getContext)().headers?.["x-vercel-oidc-token"];
+  const token = (0, import_get_context.getContext)().headers?.["x-vercel-oidc-token"] ?? process.env.VERCEL_OIDC_TOKEN;
   if (!token) {
     throw new Error(
       `The 'x-vercel-oidc-token' header is missing from the request. Do you have the OIDC option enabled in the Vercel project settings?`

package/package.json

@@ -26,7 +26,7 @@
       "require": "./middleware.js"
     }
   },
-  "version": "2.0.2",
+  "version": "2.1.0",
   "repository": {
     "directory": "packages/functions",
     "type": "git",