[wrangler] add artifacts binding support by mattzcarey · Pull Request #13326 · cloudflare/workers-sdk

mattzcarey · 2026-04-07T12:59:54Z

Summary

Add wrangler configuration, deployment, and type generation support for the Artifacts binding (16 files changed, 294 insertions).

Binding config

// wrangler.jsonc
{
	"artifacts": [{ "binding": "MY_ARTIFACTS", "namespace": "default" }],
}

Type generation

Generates Artifacts type reference from the workerd type definitions:

interface Env {
	MY_ARTIFACTS: Artifacts;
}

Changes (16 files)

`packages/workers-utils` (7 files)

File	Change
`src/config/config.ts`	Add `artifacts: []` default
`src/config/environment.ts`	Add `artifacts` binding type definition (`binding` + `namespace`, both required)
`src/config/validation.ts`	Add `validateArtifactsBinding` validator, `ConfigBindingFieldName`, `friendlyBindingNames`, `bindingTypeFriendlyNames`, `notInheritable` call, `safeBindings` entry, previews allowed keys + validation
`src/types.ts`	Add `artifacts` to `WorkerMetadataBinding` union + `Binding` union, import `CfArtifacts`
`src/worker.ts`	Add `CfArtifacts` interface
`src/map-worker-metadata-bindings.ts`	Handle `"artifacts"` case in metadata binding mapping
`tests/.../normalize-and-validate-config.test.ts`	Add `artifacts: []` to expected defaults + 4 new test cases (object error, null error, valid bindings, invalid bindings)

`packages/wrangler` (9 files)

File	Change
`src/api/startDevWorker/utils.ts`	Add `"artifacts"` case in `convertConfigToBindings`
`src/deploy/config-diffs.ts`	Add `artifacts: true` to reorderable bindings
`src/deployment-bundle/create-worker-upload-form.ts`	Extract + serialize artifacts bindings to upload metadata
`src/preview/shared.ts`	Add `"artifacts"` case in `getBindingValue` + extract artifacts in `extractConfigBindings`
`src/type-generation/index.ts`	Add artifacts loop in both `collectCoreBindings` and `collectCoreBindingsPerEnvironment` (generates `Artifacts` type)
`src/utils/add-created-resource-config.ts`	Add `"artifacts"` to `ValidKeys` exclusion
`src/utils/print-bindings.ts`	Extract + display artifacts bindings in CLI output
`src/__tests__/type-generation.test.ts`	Add `MY_ARTIFACTS` binding to mock config + `MY_ARTIFACTS: Artifacts` to 3 expected type output blocks

Root

File	Change
`.changeset/artifacts-binding-support.md`	Minor changeset for `wrangler` + `@cloudflare/workers-utils`

Tests
- Tests included/updated
- 4 new validation tests for artifacts bindings (object, null, valid, invalid)
- Type generation test updated with artifacts binding mock + expected output in all 3 test blocks
- All 510 workers-utils tests pass, all 100 type-generation tests pass
Public documentation
- Documentation not necessary because: Artifacts is a new product not yet publicly documented. Docs PR is incoming and will be linked here once created.

changeset-bot · 2026-04-07T13:00:11Z

🦋 Changeset detected

Latest commit: 0a533dc

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

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

pkg-pr-new · 2026-04-15T11:47:38Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@13326

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@13326

miniflare

npm i https://pkg.pr.new/miniflare@13326

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@13326

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@13326

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@13326

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@13326

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@13326

wrangler

npm i https://pkg.pr.new/wrangler@13326

commit: 0a533dc

workers-devprod · 2026-04-15T11:57:26Z

Codeowners approval required for this PR:

✅ @cloudflare/wrangler

Show detailed file reviewers

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>

dario-piotrowicz

LGTM 😄

dario-piotrowicz · 2026-04-15T23:00:50Z

Note

The types are being introduced in cloudflare/workerd#6508 but the API is not fully finalized just yet

workers-devprod

Codeowners reviews satisfied

mattzcarey force-pushed the feat/artifacts-binding branch from 443ef3e to bc7c37b Compare April 7, 2026 13:13

jamesopstad requested review from jamesopstad and removed request for jamesopstad April 10, 2026 11:47

mattzcarey force-pushed the feat/artifacts-binding branch 2 times, most recently from 8b20700 to b2a644d Compare April 15, 2026 11:38

workers-devprod added this to workers-sdk Apr 15, 2026

github-project-automation Bot moved this to Untriaged in workers-sdk Apr 15, 2026

mattzcarey marked this pull request as ready for review April 15, 2026 11:56

mattzcarey requested a review from workers-devprod as a code owner April 15, 2026 11:56

workers-devprod requested review from a team and vicb and removed request for a team April 15, 2026 11:57

mattzcarey force-pushed the feat/artifacts-binding branch from 15abfc4 to c863b00 Compare April 15, 2026 11:58

This comment was marked as resolved.

Sign in to view

mattzcarey force-pushed the feat/artifacts-binding branch from 8111fb7 to 6806c5b Compare April 15, 2026 12:23

mattzcarey changed the title ~~feat: add artifacts binding support to wrangler~~ [wrangler] add artifacts binding support Apr 15, 2026

mattzcarey force-pushed the feat/artifacts-binding branch from 6806c5b to 9c677cc Compare April 15, 2026 12:25

feat: add artifacts binding support to wrangler

d3475c8

mattzcarey force-pushed the feat/artifacts-binding branch from dcd0292 to d3475c8 Compare April 15, 2026 17:42

This comment was marked as resolved.

Sign in to view

dario-piotrowicz added 2 commits April 15, 2026 22:47

update removeRemoteConfigFieldFromBindings accordingly

6fc33f8

add unit tests

26372ae

This comment was marked as resolved.

Sign in to view

mattzcarey and others added 2 commits April 15, 2026 23:02

ci: retry

a2fe78f

Update .changeset/artifacts-binding-support.md

85145e4

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>

dario-piotrowicz approved these changes Apr 15, 2026

View reviewed changes

edmundhung approved these changes Apr 15, 2026

View reviewed changes

Merge branch 'main' into feat/artifacts-binding

8f62e61

workers-devprod approved these changes Apr 17, 2026

View reviewed changes

github-project-automation Bot moved this from Untriaged to Approved in workers-sdk Apr 17, 2026

mattzcarey and others added 2 commits April 17, 2026 10:22

Merge branch 'main' into feat/artifacts-binding

f90f164

Merge branch 'main' into feat/artifacts-binding

0a533dc

dario-piotrowicz merged commit 4a9ba90 into cloudflare:main Apr 17, 2026
57 of 58 checks passed

github-project-automation Bot moved this from Approved to Done in workers-sdk Apr 17, 2026

workers-devprod mentioned this pull request Apr 17, 2026

Version Packages #13511

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[wrangler] add artifacts binding support#13326

[wrangler] add artifacts binding support#13326
dario-piotrowicz merged 8 commits into
cloudflare:mainfrom
mattzcarey:feat/artifacts-binding

mattzcarey commented Apr 7, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Apr 7, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Apr 15, 2026 •

edited

Loading

Uh oh!

workers-devprod commented Apr 15, 2026 •

edited

Loading

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

dario-piotrowicz left a comment

Uh oh!

dario-piotrowicz commented Apr 15, 2026

Uh oh!

workers-devprod left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

mattzcarey commented Apr 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Binding config

Type generation

Changes (16 files)

packages/workers-utils (7 files)

packages/wrangler (9 files)

Root

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-new Bot commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

workers-devprod commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

dario-piotrowicz left a comment

Choose a reason for hiding this comment

Uh oh!

dario-piotrowicz commented Apr 15, 2026

Uh oh!

workers-devprod left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mattzcarey commented Apr 7, 2026 •

edited

Loading

`packages/workers-utils` (7 files)

`packages/wrangler` (9 files)

changeset-bot Bot commented Apr 7, 2026 •

edited

Loading

pkg-pr-new Bot commented Apr 15, 2026 •

edited

Loading

workers-devprod commented Apr 15, 2026 •

edited

Loading