Upgrade: [dependabot] - bump @aws-lambda-powertools/commons from 2.31.0 to 2.32.0

[dependabot]

Bumps @aws-lambda-powertools/commons from 2.31.0 to 2.32.0.

Release notes

Sourced from @​aws-lambda-powertools/commons's releases.

v2.32.0

Summary

In this release, we are pleased to announce a new utility for interacting with the Lambda Metadata Service in the commons package, allowing you to easily retrieve information about the Lambda function, such as the Availability Zone ID.

In the HTTP event handler, we have delivered two much requested features: a type-safe Store API, letting you share state between middleware and route handlers with full type safety, and request and response validation, so you can enforce data contracts at your API boundary, eliminating manual parsing and type assertion code.

We've also fixed a bug where the Kafka consumer would throw when processing tombstone events with undefined values.

⭐ Congratulations to @​haslers for their first PR merged in the project 🎉

Lambda Metadata Service

A new getMetadata() utility in the commons package fetches metadata from the AWS Lambda Metadata endpoint. The utility automatically returns an empty object outside of Lambda, so your code works seamlessly in local development and testing.

import { getMetadata } from '@aws-lambda-powertools/commons/utils/metadata';
import { Logger } from '@aws-lambda-powertools/logger';
const logger = new Logger({ serviceName: 'serverlessAirline' });
const metadata = await getMetadata();
export const handler = async () => {
const { AvailabilityZoneID: azId } = metadata;
logger.appendKeys({ azId });
};

Type-safe Store API

The HTTP event handler now includes a Store API that provides type-safe, scoped state management for route handlers with two built-in storage scopes:

• Request store — per-invocation state (set in middleware, read in handlers). Cleared automatically between requests.
• Shared store — router-scoped state (set at cold start, read everywhere). Persists across invocations.

import { Router } from '@aws-lambda-powertools/event-handler/http';
import type { Context } from 'aws-lambda';
type AppEnv = {
store: {
request: { userId: string; isAdmin: boolean };
shared: { db: { query: (sql: string) => Promise<unknown> } };
};
};
const app = new Router<AppEnv>();
app.shared.set('db', createDbClient());
</tr></table>

... (truncated)

Changelog

Sourced from @​aws-lambda-powertools/commons's changelog.

2.32.0 (2026-03-19)

Features

• commons add Lambda Metadata Service support (#5109) (46ffc2a)
• commons add Lambda Metadata Service support (#5106) (bdfa583)
• event-handler add type-safe Store API for request and shared state (#5081) (03034db)
• event-handler add validation support for REST router (#4736) (3617c8c)

Maintenance

• commons bump @​aws/lambda-invoke-store from 0.2.3 to 0.2.4 (#5089) (fe519ab)
• logger bump @​aws/lambda-invoke-store from 0.2.3 to 0.2.4 (#5089) (fe519ab)
• metrics bump @​aws/lambda-invoke-store from 0.2.3 to 0.2.4 (#5089) (fe519ab)
• batch bump @​aws/lambda-invoke-store from 0.2.3 to 0.2.4 (#5089) (fe519ab)
• validation bump ajv from 8.17.1 to 8.18.0 (#5021) (a7791e1)

Bug Fixes

• event-handler add overloads to route() for typed validation context (#5052) (dae12e4)
• event-handler default error handler returns a web Response correctly (#5024) (f8100e8)
• kafka handle tombstone events without value (#5017) (79553c9)

Commits

• 0abf2f0 chore(ci): bump version to 2.32.0 (#5112)
• 3677abc chore(ci): temporarily disable me-central-1 deployments (#5111)
• 46ffc2a feat(commons): add Lambda Metadata Service support (#5109)
• f1dc056 revert: feat(commons): add Lambda Metadata Service support (#5106) (#5107)
• e49984d chore(deps): bump valibot from 1.2.0 to 1.3.0 (#5101)
• 0cc6b0a chore(deps-dev): bump @​biomejs/biome from 2.4.6 to 2.4.7 (#5097)
• 4e3812b chore(deps): bump release-drafter/release-drafter from 7.0.0 to 7.1.0 (#5104)
• bdfa583 feat(commons): add Lambda Metadata Service support (#5106)
• 03034db feat(event-handler): add type-safe Store API for request and shared state (#...
• a72f66c chore(deps): bump release-drafter/release-drafter from 6.4.0 to 7.0.0 (#5095)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[github-actions]

This PR is raised by Dependabot to update a dependency.

[eps-autoapprove-dependabot]

I'm approving this pull request because it includes a patch or minor update

[eps-autoapprove-dependabot]

I'm approving this pull request because it includes a patch or minor update

[eps-autoapprove-dependabot]

I'm approving this pull request because it includes a patch or minor update

[eps-autoapprove-dependabot]

I'm approving this pull request because it includes a patch or minor update

[eps-autoapprove-dependabot]

I'm approving this pull request because it includes a patch or minor update

[eps-autoapprove-dependabot]

I'm approving this pull request because it includes a patch or minor update

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[eps-autoapprove-dependabot]

I'm approving this pull request because it includes a patch or minor update

[dependabot]

Looks like @aws-lambda-powertools/commons is up-to-date now, so this is no longer needed.