@vercel/functions 2.2.7 → 2.2.11

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @vercel/functions
 
+## 2.2.11
+
+### Patch Changes
+
+- Fix dependency ([#13726](https://github.com/vercel/vercel/pull/13726))
+
+## 2.2.10
+
+### Patch Changes
+
+- Update dependency ([#13722](https://github.com/vercel/vercel/pull/13722))
+
+## 2.2.9
+
+### Patch Changes
+
+- Extract AWS dynamic import to async loader with error handling ([#13660](https://github.com/vercel/vercel/pull/13660))
+
+- Updated dependencies [[`a133e534e7dfd785beeeb0dcafed8d2c991e9f11`](https://github.com/vercel/vercel/commit/a133e534e7dfd785beeeb0dcafed8d2c991e9f11)]:
+  - @vercel/oidc@2.1.0
+
+## 2.2.8
+
+### Patch Changes
+
+- Declare attachDatabasePool stable ([#13673](https://github.com/vercel/vercel/pull/13673))
+
 ## 2.2.7
 
 ### Patch Changes

package/db-connections/index.d.ts

@@ -72,10 +72,14 @@ export type DbPool = PgPool | MySQLPool | MySQL2Pool | MariaDBPool | MongoDBPool
  * const pgPool = new Pool({
  *   connectionString: process.env.DATABASE_URL,
  * });
- * experimental_attachDatabasePool(pgPool);
+ * attachDatabasePool(pgPool);
  * ```
  *
  * @experimental
  */
-export declare function experimental_attachDatabasePool(dbPool: DbPool): void;
+export declare function attachDatabasePool(dbPool: DbPool): void;
+/**
+ * @deprecated Use attachDatabasePool instead.
+ */
+export declare const experimental_attachDatabasePool: typeof attachDatabasePool;
 export {};

package/db-connections/index.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var db_connections_exports = {};
 __export(db_connections_exports, {
+  attachDatabasePool: () => attachDatabasePool,
   experimental_attachDatabasePool: () => experimental_attachDatabasePool
 });
 module.exports = __toCommonJS(db_connections_exports);
@@ -87,7 +88,7 @@ function waitUntilIdleTimeout(dbPool) {
     console.warn("Pool release event triggered outside of request scope.");
   }
 }
-function experimental_attachDatabasePool(dbPool) {
+function attachDatabasePool(dbPool) {
   if (idleTimeout) {
     idleTimeoutResolve?.();
     clearTimeout(idleTimeout);
@@ -142,7 +143,9 @@ function experimental_attachDatabasePool(dbPool) {
   }
   throw new Error("Unsupported database pool type");
 }
+const experimental_attachDatabasePool = attachDatabasePool;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  attachDatabasePool,
   experimental_attachDatabasePool
 });

package/docs/modules/index.md

@@ -10,6 +10,7 @@
 
 ### Functions
 
+- [attachDatabasePool](index.md#attachdatabasepool)
 - [experimental_attachDatabasePool](index.md#experimental_attachdatabasepool)
 - [geolocation](index.md#geolocation)
 - [getCache](index.md#getcache)
@@ -21,9 +22,9 @@
 
 ## Functions
 
-### experimental_attachDatabasePool
+### attachDatabasePool
 
-▸ **experimental_attachDatabasePool**(`dbPool`): `void`
+▸ **attachDatabasePool**(`dbPool`): `void`
 
 Call this function right after creating a database pool with the database pool object
 as argument.
@@ -36,7 +37,7 @@ idle database connections to be removed from the pool.
 const pgPool = new Pool({
   connectionString: process.env.DATABASE_URL,
 });
-experimental_attachDatabasePool(pgPool);
+attachDatabasePool(pgPool);
 ```
 
 #### Parameters
@@ -55,6 +56,30 @@ experimental_attachDatabasePool(pgPool);
 
 ---
 
+### experimental_attachDatabasePool
+
+▸ **experimental_attachDatabasePool**(`dbPool`): `void`
+
+**`Deprecated`**
+
+Use attachDatabasePool instead.
+
+#### Parameters
+
+| Name     | Type     |
+| :------- | :------- |
+| `dbPool` | `DbPool` |
+
+#### Returns
+
+`void`
+
+#### 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)
+
+---
+
 ### geolocation
 
 ▸ **geolocation**(`request`): [`Geo`](../interfaces/index.Geo.md)

package/docs/modules/oidc.md

@@ -18,46 +18,19 @@
 
 ▸ **awsCredentialsProvider**(`init`): `AwsCredentialIdentityProvider`
 
-Obtains the Vercel OIDC token and creates an AWS credential provider function
-that gets AWS credentials by calling STS AssumeRoleWithWebIdentity API.
-
-**`Example`**
-
-```js
-import * as s3 from '@aws-sdk/client-s3';
-import { awsCredentialsProvider } from '@vercel/functions/oidc';
-
-const s3Client = new s3.S3Client({
-  credentials: awsCredentialsProvider({
-    roleArn: 'arn:aws:iam::1234567890:role/RoleA',
-    clientConfig: { region: 'us-west-2' },
-    clientPlugins: [addFooHeadersPlugin],
-    roleAssumerWithWebIdentity: customRoleAssumer,
-    roleSessionName: 'session_123',
-    providerId: 'graph.facebook.com',
-    policyArns: [{ arn: 'arn:aws:iam::1234567890:policy/SomePolicy' }],
-    policy:
-      '{"Statement": [{"Effect": "Allow", "Action": "s3:ListBucket", "Resource": "*"}]}',
-    durationSeconds: 7200,
-  }),
-});
-```
-
 #### Parameters
 
-| Name   | Type                                                                             | Description                |
-| :----- | :------------------------------------------------------------------------------- | :------------------------- |
-| `init` | [`AwsCredentialsProviderInit`](../interfaces/oidc.AwsCredentialsProviderInit.md) | The initialization object. |
+| Name   | Type                                                                             |
+| :----- | :------------------------------------------------------------------------------- |
+| `init` | [`AwsCredentialsProviderInit`](../interfaces/oidc.AwsCredentialsProviderInit.md) |
 
 #### Returns
 
 `AwsCredentialIdentityProvider`
 
-A function that provides AWS credentials.
-
 #### Defined in
 
-[packages/functions/src/oidc/aws-credentials-provider.ts:60](https://github.com/vercel/vercel/blob/main/packages/functions/src/oidc/aws-credentials-provider.ts#L60)
+[packages/functions/src/oidc/aws-credentials-provider.ts:70](https://github.com/vercel/vercel/blob/main/packages/functions/src/oidc/aws-credentials-provider.ts#L70)
 
 ---
 
@@ -97,7 +70,7 @@ A promise that resolves to the OIDC token.
 
 #### Defined in
 
-packages/oidc/dist/get-vercel-oidc-token.d.ts:23
+node_modules/.pnpm/@vercel+oidc@2.0.0/node_modules/@vercel/oidc/dist/get-vercel-oidc-token.d.ts:23
 
 ---
 
@@ -132,4 +105,4 @@ The OIDC token.
 
 #### Defined in
 
-packages/oidc/dist/get-vercel-oidc-token.d.ts:43
+node_modules/.pnpm/@vercel+oidc@2.0.0/node_modules/@vercel/oidc/dist/get-vercel-oidc-token.d.ts:43

package/index.d.ts

@@ -4,5 +4,5 @@ export { getEnv } from './get-env';
 export { waitUntil } from './wait-until';
 export { rewrite, next } from './middleware';
 export { getCache } from './cache';
-export { experimental_attachDatabasePool } from './db-connections';
+export { attachDatabasePool, experimental_attachDatabasePool, } from './db-connections';
 export type { RuntimeCache } from './cache/types';

package/index.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var src_exports = {};
 __export(src_exports, {
+  attachDatabasePool: () => import_db_connections.attachDatabasePool,
   experimental_attachDatabasePool: () => import_db_connections.experimental_attachDatabasePool,
   geolocation: () => import_headers.geolocation,
   getCache: () => import_cache.getCache,
@@ -36,6 +37,7 @@ var import_cache = require("./cache");
 var import_db_connections = require("./db-connections");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  attachDatabasePool,
   experimental_attachDatabasePool,
   geolocation,
   getCache,

package/oidc/aws-credentials-provider.d.ts

@@ -17,41 +17,4 @@ import type { FromWebTokenInit } from '@aws-sdk/credential-provider-web-identity
 export interface AwsCredentialsProviderInit// eslint-disable-line @typescript-eslint/no-empty-interface
  extends Omit<FromWebTokenInit, 'webIdentityToken'> {
 }
-/**
- * Obtains the Vercel OIDC token and creates an AWS credential provider function
- * that gets AWS credentials by calling STS AssumeRoleWithWebIdentity API.
- *
- * @param {AwsCredentialsProviderInit} init - The initialization object.
- * @param {string} init.roleArn - ARN of the role that the caller is assuming.
- * @param {Object} [init.clientConfig] - Custom STS client configurations overriding the default ones.
- * @param {Array} [init.clientPlugins] - Custom STS client middleware plugin to modify the client default behavior.
- * @param {Function} [init.roleAssumerWithWebIdentity] - A function that assumes a role with web identity and returns a promise fulfilled with credentials for the assumed role.
- * @param {string} [init.roleSessionName] - An identifier for the assumed role session.
- * @param {string} [init.providerId] - The fully qualified host component of the domain name of the identity provider.
- * @param {Array} [init.policyArns] - ARNs of the IAM managed policies that you want to use as managed session policies.
- * @param {string} [init.policy] - An IAM policy in JSON format that you want to use as an inline session policy.
- * @param {number} [init.durationSeconds=3600] - The duration, in seconds, of the role session. Defaults to 3600 seconds.
- *
- * @returns {AwsCredentialIdentityProvider} A function that provides AWS credentials.
- *
- * @example
- * ```js
- * import * as s3 from '@aws-sdk/client-s3';
- * import { awsCredentialsProvider } from '@vercel/functions/oidc';
- *
- * const s3Client = new s3.S3Client({
- *   credentials: awsCredentialsProvider({
- *     roleArn: "arn:aws:iam::1234567890:role/RoleA",
- *     clientConfig: { region: "us-west-2" },
- *     clientPlugins: [addFooHeadersPlugin],
- *     roleAssumerWithWebIdentity: customRoleAssumer,
- *     roleSessionName: "session_123",
- *     providerId: "graph.facebook.com",
- *     policyArns: [{ arn: "arn:aws:iam::1234567890:policy/SomePolicy" }],
- *     policy: "{\"Statement\": [{\"Effect\": \"Allow\", \"Action\": \"s3:ListBucket\", \"Resource\": \"*\"}]}",
- *     durationSeconds: 7200
- *   }),
- * });
- * ```
- */
 export declare function awsCredentialsProvider(init: AwsCredentialsProviderInit): AwsCredentialIdentityProvider;

package/oidc/aws-credentials-provider.js

@@ -32,9 +32,18 @@ __export(aws_credentials_provider_exports, {
 });
 module.exports = __toCommonJS(aws_credentials_provider_exports);
 var import_oidc = require("@vercel/oidc");
+async function loadAwsCredentialProviderWebIdentity() {
+  try {
+    return await import("@aws-sdk/credential-provider-web-identity");
+  } catch (err) {
+    throw new Error(
+      "package '@aws-sdk/credential-provider-web-identity' not found"
+    );
+  }
+}
 function awsCredentialsProvider(init) {
   return async () => {
-    const { fromWebToken } = await import("@aws-sdk/credential-provider-web-identity");
+    const { fromWebToken } = await loadAwsCredentialProviderWebIdentity();
     return fromWebToken({
       ...init,
       webIdentityToken: (0, import_oidc.getVercelOidcTokenSync)()

package/package.json

@@ -30,7 +30,7 @@
       "require": "./middleware.js"
     }
   },
-  "version": "2.2.7",
+  "version": "2.2.11",
   "repository": {
     "directory": "packages/functions",
     "type": "git",