feat(wrangler): DX optimisations in wrangler dev --remote

[CarmenPopoviciu]

Fixes DEVX-1523

Workers + Assets projects have, in certain situations, a relatively degraded wrangler dev --remote developer experience, as opposed to Workers proper projects. This is due to the fact that, for Workers + Assets, we need to make
extra API calls to:

1. check for asset files changes
2. upload the changed assets, if any

This commit improves the wrangler dev --remote DX for Workers + Assets, for use cases when the User Worker/assets change while the API calls for previous changes are still in flight. For such use cases, we have put an exit early strategy in place, that drops the event handler execution of the previous changes, in favour of the handler triggered by the
new changes.

For before/after screenshots pls see DEVX-1523

How these changes were tested

NOTE

For posterity, we did discuss internally the unit/e2e test coverage for this PR, and we all agreed that our current dev and dev --remote tests give us enough coverage for these changes. Testing these changes would in fact involve testing a core wrangler functionality, aka aborting in progress changes if there’s a new pending change that would run immediately after, which is not specific to assets. This functionality is already covered by tests, so adding more that are specific for assets doesn't seem to add much value. We therefore decided to merge as is, and rely on existing tests.

• Workers + Assets (with changes in both assets and User Worker code)

Before

After

• Workers + Assets only

After

• Workers proper (no assets)

After

---

• Tests
  • TODO (before merge)
  • Tests included
  • Tests not necessary because: we're covered by existing e2e & unit tests here
• E2E Tests CI Job required? (Use "e2e" label or ask maintainer to run separately)
  • I don't know
  • Required
  • Not required because:
• Public documentation
  • TODO (before merge)
  • Cloudflare docs PR(s):
  • Documentation not necessary because: watch mode optimizations

[changeset-bot]

🦋 Changeset detected

Latest commit: e849ab5

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

This PR includes changesets to release 2 packages

Name	Type
wrangler	Minor
@cloudflare/vitest-pool-workers	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]

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/12409630032/npm-package-wrangler-7425

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

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

Or you can use npx with this latest build directly:

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

Additional artifacts:

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

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

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

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

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

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

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

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

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

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

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.20241205.0
workerd	1.20241205.0	1.20241205.0
workerd --version	1.20241205.0	2024-12-05

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