[wrangler] add artifacts binding support

[mattzcarey]

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]

🦋 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]

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]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers

[dario-piotrowicz]

LGTM 😄

[dario-piotrowicz]

Note

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

[workers-devprod]

Codeowners reviews satisfied