v2beta queue format by ctgowrie · Pull Request #14970 · vercel/vercel

ctgowrie · 2026-02-10T15:10:59Z

Add queue/v2beta trigger type support

Summary

Adds support for queue/v2beta trigger type where the consumer name is implicitly derived from the function path
For v2beta, only one queue trigger per function is allowed
Consumer name is sanitized from the function path (e.g., api/test.js → api-testjs)

Changes

Schema: Accept both queue/v1beta and queue/v2beta types; v2beta doesn't allow consumer field in config
Types: Separate input types (TriggerEventInput) from output types (TriggerEvent); output always has consumer
getLambdaOptionsFromFunction: Populates consumer for v2beta triggers using sanitizeConsumerName(functionPath)
sanitizeConsumerName: New utility that strips dots and replaces invalid characters with hyphens

v1beta vs v2beta

	v1beta	v2beta
`consumer` in config	Required	Not allowed
Consumer name	User-specified	Derived from function path
Triggers per function	Unlimited	1 max

Note

Low Risk Change

This PR adds a new queue trigger format (v2beta) with schema validation, type definitions, and a utility function to derive consumer names from function paths - all additive changes with comprehensive test coverage.

Adds queue/v2beta trigger type alongside existing queue/v1beta with schema validation
New sanitizeConsumerName utility encodes function paths into valid consumer names
Extensive unit tests covering v2beta validation and sanitization edge cases

^{Risk assessment for commit 739c6be.}

changeset-bot · 2026-02-10T15:11:15Z

🦋 Changeset detected

Latest commit: 739c6be

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 16 packages

Name	Type
@vercel/build-utils	Patch
@vercel/config	Patch
vercel	Patch
@vercel/backends	Patch
@vercel/client	Patch
@vercel/elysia	Patch
@vercel/express	Patch
@vercel/fastify	Patch
@vercel/gatsby-plugin-vercel-builder	Patch
@vercel/h3	Patch
@vercel/hono	Patch
@vercel/koa	Patch
@vercel/nestjs	Patch
@vercel/node	Patch
@vercel/static-build	Patch
@vercel/cervel	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-02-10T15:11:16Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-7b37rqefy.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-7b37rqefy.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

github-actions · 2026-02-10T15:14:13Z

🧪 Unit Test Strategy

Comparing: a5349dc → 739c6be (view diff)

Strategy: Code changed outside of a package - running all unit tests

⚠️ All unit tests will run because global code changes could impact all packages.

Affected packages - 40 (100%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples
vercel

Results

Unit tests: All affected packages will run unit tests
E2E tests: Handled separately (Version Packages PRs or run-e2e-tests label)
Type checks: All affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

.changeset/forty-seahorses-shave.md

packages/build-utils/src/lambda.ts

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## @vercel/build-utils@13.4.0 ### Minor Changes - [services] synchronize dependencies in dev mode for JS/TS and Python services ([#14987](#14987)) ### Patch Changes - Add new expirementalTrigger format for queues v2beta ([#14970](#14970)) - Updated dependencies \[[`a960cf23a42ff1a570c808ee9567670c24422f98`](a960cf2)]: - @vercel/python-analysis@0.4.1 ## vercel@50.16.0 ### Minor Changes - [services] synchronize dependencies in dev mode for JS/TS and Python services ([#14987](#14987)) - Add `contract` cli cmd for checking contract commitments ([#14735](#14735)) - Add `usage` command to check billing and usage information ([#14733](#14733)) ### Patch Changes - Add `--plan` flag to `vercel integration add` for specifying a billing plan ID ([#14965](#14965)) - Include the current Vercel CLI version in `.vercel/output/builds.json` generated by `vercel build`. ([#14999](#14999)) - Fixed deployment rate limit error message displaying incorrect retry time ([#14947](#14947)) - [services] services dev server orchestrator framework fallback fix ([#14985](#14985)) - Add new expirementalTrigger format for queues v2beta ([#14970](#14970)) - non-interactive mode for link - selectOrg ([#15003](#15003)) - non-interactive mode for link ([#15001](#15001)) - Remove tags column from `integration discover` table and compact terminal views to reduce width on small screens. Tags remain available in JSON output. ([#15000](#15000)) - non-interactive mode for link - enable for agents ([#15002](#15002)) - Add `--breakdown` option to `vercel usage` for viewing usage broken down by period ([#14741](#14741)) - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071), [`a960cf23a42ff1a570c808ee9567670c24422f98`](a960cf2)]: - @vercel/build-utils@13.4.0 - @vercel/python@6.12.0 - @vercel/backends@0.0.33 - @vercel/elysia@0.1.36 - @vercel/express@0.1.45 - @vercel/fastify@0.1.39 - @vercel/go@3.4.0 - @vercel/h3@0.1.45 - @vercel/hono@0.2.39 - @vercel/hydrogen@1.3.5 - @vercel/koa@0.1.19 - @vercel/nestjs@0.2.40 - @vercel/next@4.15.28 - @vercel/node@5.6.3 - @vercel/redwood@2.4.9 - @vercel/remix-builder@5.5.10 - @vercel/ruby@2.3.0 - @vercel/rust@1.0.5 - @vercel/static-build@2.8.37 ## @vercel/python@6.12.0 ### Minor Changes - [services] synchronize dependencies in dev mode for JS/TS and Python services ([#14987](#14987)) ### Patch Changes - log contents of malformed manifests ([#15019](#15019)) - Updated dependencies \[[`a960cf23a42ff1a570c808ee9567670c24422f98`](a960cf2)]: - @vercel/python-analysis@0.4.1 ## @vercel/backends@0.0.33 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/cervel@0.0.20 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.33 ## @vercel/client@17.2.40 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/config@0.0.30 ### Patch Changes - Add new expirementalTrigger format for queues v2beta ([#14970](#14970)) ## @vercel/elysia@0.1.36 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/express@0.1.45 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 - @vercel/cervel@0.0.20 ## @vercel/fastify@0.1.39 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/gatsby-plugin-vercel-builder@2.0.135 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/h3@0.1.45 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/hono@0.2.39 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/koa@0.1.19 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/mcp-adapter@0.3.2 ### Patch Changes - Fix .repository field in package.json to make it possible to publish ([#14997](#14997)) ## @vercel/nestjs@0.2.40 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/node@5.6.3 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/python-analysis@0.4.1 ### Patch Changes - log contents of malformed manifests ([#15019](#15019)) ## @vercel/static-build@2.8.37 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.0.135 ## @vercel/python-runtime@0.4.0 ### Minor Changes - Install \_runtime_requirements.txt during lambda execution if provided. ([#15011](#15011)) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

ctgowrie added 2 commits February 10, 2026 09:41

Add v2beta format

fe40181

Gen consumer

2be20b2

ctgowrie requested review from a team and MatthewStanciu as code owners February 10, 2026 15:11

ctgowrie requested a review from Timer February 10, 2026 15:11

union

906c617

vercel bot deployed to Preview February 10, 2026 15:19 View deployment

ctgowrie added 2 commits February 10, 2026 11:26

resolve merge conflicts

cd4b7e0

changeset

db4f881

vercel bot deployed to Preview February 10, 2026 16:29 View deployment

Timer reviewed Feb 10, 2026

View reviewed changes

.changeset/forty-seahorses-shave.md Outdated Show resolved Hide resolved

Timer reviewed Feb 10, 2026

View reviewed changes

packages/build-utils/src/lambda.ts Outdated Show resolved Hide resolved

ctgowrie requested a review from Timer February 11, 2026 13:44

mnemonic encoding

fe4b49a

vercel bot deployed to Preview February 11, 2026 13:54 View deployment

Merge branch 'main' into cgowrie/v2-beta-queue

7bb0e7a

vercel bot deployed to Preview February 11, 2026 15:03 View deployment

Timer approved these changes Feb 11, 2026

View reviewed changes

Merge branch 'main' into cgowrie/v2-beta-queue

739c6be

ctgowrie requested a review from a team as a code owner February 11, 2026 20:10

vercel bot deployed to Preview February 11, 2026 20:12 View deployment

ctgowrie merged commit 2686071 into main Feb 11, 2026
150 checks passed

ctgowrie deleted the cgowrie/v2-beta-queue branch February 11, 2026 21:19

vercel-release-bot mentioned this pull request Feb 11, 2026

Version Packages #14998

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

v2beta queue format#14970

v2beta queue format#14970
ctgowrie merged 8 commits intomainfrom
cgowrie/v2-beta-queue

ctgowrie commented Feb 10, 2026 •

edited by vercel bot

Loading

Uh oh!

changeset-bot bot commented Feb 10, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 10, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 10, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ctgowrie commented Feb 10, 2026 • edited by vercel bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add queue/v2beta trigger type support

Summary

Changes

v1beta vs v2beta

Uh oh!

changeset-bot bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Uh oh!

github-actions bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ctgowrie commented Feb 10, 2026 •

edited by vercel bot

Loading

changeset-bot bot commented Feb 10, 2026 •

edited

Loading

github-actions bot commented Feb 10, 2026 •

edited

Loading

github-actions bot commented Feb 10, 2026 •

edited

Loading