Wrangler v4 #7334

penalosa · 2024-11-25T16:26:25Z

Wrangler v4 is coming! We’re releasing this release candidate now as a way for you to check the upcoming version works with your projects. More detailed migration guides & documentation will be coming over the next few months as we prepare to roll this out, but a TLDR of the breaking changes to expect are:

Node v18 is now the minimum Node version
Wrangler now uses esbuild v0.24.2
wrangler r2 and wrangler kv are --local by default
All deprecated commands & config have been removed

To try it out, install and use wrangler@next.

Let us know what you think! We'd love to hear any feedback, either as comments on this PR or in the #wrangler channel on Discord.

changeset-bot · 2024-11-25T16:26:30Z

🦋 Changeset detected

Latest commit: f6ca096

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

This PR includes changesets to release 5 packages

Name	Type
wrangler	Major
miniflare	Major
@cloudflare/vitest-pool-workers	Minor
@cloudflare/pages-shared	Patch
@cloudflare/vite-plugin	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 · 2024-11-25T16:35:41Z

A wrangler prerelease is available for testing. You can install this latest build in your project with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-wrangler-7334

You can reference the automatically updated head of this PR with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/prs/7334/npm-package-wrangler-7334

Or you can use npx with this latest build directly:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-wrangler-7334 dev path/to/script.js

Additional artifacts:

cloudflare-workers-bindings-extension:

wget https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-workers-bindings-extension-7334 -O ./cloudflare-workers-bindings-extension.0.0.0-ve8260e5ca.vsix && code --install-extension ./cloudflare-workers-bindings-extension.0.0.0-ve8260e5ca.vsix

create-cloudflare:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-create-cloudflare-7334 --no-auto-update

@cloudflare/kv-asset-handler:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-kv-asset-handler-7334

miniflare:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-miniflare-7334

@cloudflare/pages-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-pages-shared-7334

@cloudflare/unenv-preset:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-unenv-preset-7334

@cloudflare/vite-plugin:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-vite-plugin-7334

@cloudflare/vitest-pool-workers:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-vitest-pool-workers-7334

@cloudflare/workers-editor-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-workers-editor-shared-7334

@cloudflare/workers-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-workers-shared-7334

@cloudflare/workflows-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13418999425/npm-package-cloudflare-workflows-shared-7334

Note that these links will no longer work once the GitHub Actions artifact expires.

[email protected] includes the following runtime dependencies:

Package	Constraint	Resolved
`miniflare`	workspace:*	3.20250214.0
`workerd`	1.20250214.0	1.20250214.0
`workerd --version`	1.20250214.0	2025-02-14

Please ensure constraints are pinned, and miniflare/workerd minor versions match.

* chore: remove alpha support from `wrangler d1 migrations apply` * chore: remove `wrangler d1 backups` * chore: fixup tests * chore: fixup tests * chore: fixup tests * chore: remove --batch-size

* Remove wrangler version * Remove generate & strip down init * Add changesets * Remove deprecated --format & config * Add changeset * remove commands * Fix tests * Remove .only() * Remove legacy assets * clarify legacy assets -> sites naming

esbuild 0.24.2 variable naming changes

* feat(wrangler): Drop worker prefix when creating KV namespaces * Remove crypto polyfill --------- Co-authored-by: Samuel Macleod <[email protected]>

emily-shen

nit: can we add a pre-requisites section to the wrangler readme that mentions this

emily-shen

the node app pages dev script in its package.json still uses the --node-compat flag

.changeset/funny-pets-punch.md

packages/wrangler/README.md

.changeset/funny-pets-punch.md

penalosa · 2025-02-19T18:32:55Z

Remaining test failures should be resolved by cloudflare/next-on-pages#940

packages/wrangler/src/r2/object.ts

packages/wrangler/src/init.ts

packages/wrangler/src/index.ts

emily-shen · 2025-02-20T14:57:49Z

.changeset/major-remove-version.md

@@ -0,0 +1,5 @@
+---


--version is listed as a global command, but doesn't actually work on any command except for wrangler --version as listed here. Can we get rid of it from the global flags group as well?

We could, but if we did that I'm not sure where we'd document it?

(this also isn't a breaking change, so we could do this outside of the v4 scope)

emily-shen

a couple of places to update:

error message in getBindings in wrangler/src/dev.ts mentions kv:namespace create
workers-chat-demo fixture has [build.upload] in its config
legacy assets is mentioned in an error message in versions/secrets/index.ts in parseModules()

emily-shen · 2025-02-20T15:05:58Z

.changeset/major-remove-d1-backups.md

+
+Remove `wrangler d1 backups`
+
+BREAKING CHANGE: This change removes `wrangler d1 backups`, a set of alpha-only commands that would allow folks to interact with backups of their D1 alpha DBs.


nit: in context, having BREAKING CHANGE on just a couple of the breaking changes could be a bit confusing, maybe we could remove this from these changesets?

.changeset/major-remove-d1-backups.md
.changeset/major-remove-d1-deprecated-batch-size.md
.changeset/major-remove-d1-migrations-alpha.md

emily-shen · 2025-02-20T15:10:16Z

.changeset/major-remove-legacy-assets.md

+"wrangler": major
+---
+
+Remove legacy assets


Remove the --legacy-assets flag.

(and config key if there was one?)

penalosa requested a review from a team as a code owner November 25, 2024 16:26

penalosa added skip-pr-description-validation Skip validation of the required PR description format e2e Run wrangler e2e tests on a PR labels Nov 25, 2024

This was referenced Nov 27, 2024

Document Wrangler's OS & Node support policy cloudflare/cloudflare-docs#17513

Closed

Deprecated dependencies in Wrangler v3.91.0 causing warnings #7373

Closed

penalosa added the breaking change Change that will result in breaking existing behavior label Nov 29, 2024

penalosa requested a review from a team as a code owner November 29, 2024 15:47

penalosa requested a review from a team as a code owner December 2, 2024 12:26

penalosa requested a review from a team as a code owner December 2, 2024 16:12

rozenmd requested a review from a team as a code owner December 10, 2024 22:09

CarmenPopoviciu added the v4 wrangler version 4 label Dec 17, 2024

dario-piotrowicz linked an issue Jan 13, 2025 that may be closed by this pull request

🐛 BUG: this handling in static blocks results in undefined #7741

Closed

pmiguel force-pushed the next branch 2 times, most recently from 86a4971 to b35265a Compare January 14, 2025 11:55

penalosa mentioned this pull request Jan 17, 2025

🐛 BUG: Import Assertions Using with Syntax in Wrangler 3.102.0 #7771

Closed

vicb mentioned this pull request Jan 26, 2025

🚀 Feature Request: Allow more flexible esbuild version #7898

Closed

penalosa and others added 3 commits February 18, 2025 13:56

ci: setup next branch with prereleases to next tag

32b5102

chore: remove deprecated getBindingsProxy (#5005)

7fbb44f

Require Node v18 in Wrangler v4 (#7338)

4af0d79

penalosa force-pushed the next branch from b35265a to d4bd6ec Compare February 18, 2025 18:08

penalosa requested a review from a team as a code owner February 18, 2025 18:08

workers-devprod added the c3-e2e label Feb 18, 2025

penalosa and others added 6 commits February 18, 2025 18:39

Remove node_compat in Wrangler & Miniflare v4 (#7336)

e40c66f

Remove v2 warning (#7228)

fbf6feb

chore: update esbuild (#6884)

0e95d46

--local by default for wrangler kv & wrangler r2 (#7392)

08f84db

deprecate unused D1 commands/options (#7471)

cb6f3c9

* chore: remove alpha support from `wrangler d1 migrations apply` * chore: remove `wrangler d1 backups` * chore: fixup tests * chore: fixup tests * chore: fixup tests * chore: remove --batch-size

Remove deprecated commands & config (#7352)

c5175e3

* Remove wrangler version * Remove generate & strip down init * Add changesets * Remove deprecated --format & config * Add changeset * remove commands * Fix tests * Remove .only() * Remove legacy assets * clarify legacy assets -> sites naming

various test fixes after rebase

f6bce8a

penalosa force-pushed the next branch from d4bd6ec to f6bce8a Compare February 18, 2025 18:39

penalosa and others added 3 commits February 18, 2025 19:11

fixup! chore: update esbuild (#6884)

1551c69

esbuild 0.24.2 variable naming changes

fixup! Remove node_compat in Wrangler & Miniflare v4 (#7336)

5cb917d

feat(wrangler): Drop worker prefix when creating KV namespaces (#7759)

d702a2f

* feat(wrangler): Drop worker prefix when creating KV namespaces * Remove crypto polyfill --------- Co-authored-by: Samuel Macleod <[email protected]>

penalosa requested a review from a team as a code owner February 19, 2025 11:55

penalosa added 5 commits February 19, 2025 11:58

Include node version in name

435f155

Ignore kv-asset-handler tests on Node 22

74bde06

rename tests

c7bfef9

Rename positional json args. Fixes #7688

9ce1df6

unescape

389cc9e

emily-shen reviewed Feb 19, 2025

View reviewed changes

.changeset/funny-pets-punch.md Outdated Show resolved Hide resolved

emily-shen reviewed Feb 19, 2025

View reviewed changes

packages/wrangler/README.md Show resolved Hide resolved

fix tests

edb32e3

penalosa commented Feb 19, 2025

View reviewed changes

.changeset/funny-pets-punch.md Outdated Show resolved Hide resolved

penalosa added 4 commits February 19, 2025 16:33

Update .changeset/funny-pets-punch.md

24cbc22

Add system requirements to the README

f0f1d26

fix formatting

6307025

fix formatting

f6ca096

emily-shen reviewed Feb 20, 2025

View reviewed changes

packages/wrangler/src/r2/object.ts Show resolved Hide resolved

emily-shen reviewed Feb 20, 2025

View reviewed changes

packages/wrangler/src/init.ts Show resolved Hide resolved

emily-shen reviewed Feb 20, 2025

View reviewed changes

packages/wrangler/src/index.ts Show resolved Hide resolved

emily-shen reviewed Feb 20, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Wrangler v4 #7334

Wrangler v4 #7334

penalosa commented Nov 25, 2024 •

edited

Loading

changeset-bot bot commented Nov 25, 2024 •

edited

Loading

github-actions bot commented Nov 25, 2024 •

edited

Loading

emily-shen left a comment

emily-shen left a comment •

edited

Loading

penalosa commented Feb 19, 2025

emily-shen Feb 20, 2025

penalosa Feb 20, 2025

emily-shen left a comment

emily-shen Feb 20, 2025

emily-shen Feb 20, 2025


		Remove `wrangler d1 backups`

		BREAKING CHANGE: This change removes `wrangler d1 backups`, a set of alpha-only commands that would allow folks to interact with backups of their D1 alpha DBs.

Wrangler v4 #7334

Are you sure you want to change the base?

Wrangler v4 #7334

Conversation

penalosa commented Nov 25, 2024 • edited Loading

changeset-bot bot commented Nov 25, 2024 • edited Loading

🦋 Changeset detected

github-actions bot commented Nov 25, 2024 • edited Loading

emily-shen left a comment

Choose a reason for hiding this comment

emily-shen left a comment • edited Loading

Choose a reason for hiding this comment

penalosa commented Feb 19, 2025

emily-shen Feb 20, 2025

Choose a reason for hiding this comment

penalosa Feb 20, 2025

Choose a reason for hiding this comment

emily-shen left a comment

Choose a reason for hiding this comment

emily-shen Feb 20, 2025

Choose a reason for hiding this comment

emily-shen Feb 20, 2025

Choose a reason for hiding this comment

penalosa commented Nov 25, 2024 •

edited

Loading

changeset-bot bot commented Nov 25, 2024 •

edited

Loading

github-actions bot commented Nov 25, 2024 •

edited

Loading

emily-shen left a comment •

edited

Loading