Version Packages

[workers-devprod]

This PR was opened by the Changesets release 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

wrangler@3.28.0

Minor Changes

• #4499 cf9c029b Thanks @penalosa! - feat: Support runtime-agnostic polyfills

  Previously, Wrangler treated any imports of node:* modules as build-time errors (unless one of the two Node.js compatibility modes was enabled). This is sometimes overly aggressive, since those imports are often not hit at runtime (for instance, it was impossible to write a library that worked across Node.JS and Workers, using Node packages only when running in Node). Here's an example of a function that would cause Wrangler to fail to build:

  export function randomBytes(length: number) {
  	if (navigator.userAgent !== "Cloudflare-Workers") {
  		return new Uint8Array(require("node:crypto").randomBytes(length));
  	} else {
  		return crypto.getRandomValues(new Uint8Array(length));
  	}
  }

  This function should work in both Workers and Node, since it gates Node-specific functionality behind a user agent check, and falls back to the built-in Workers crypto API. Instead, Wrangler detected the node:crypto import and failed with the following error:

  ✘ [ERROR] Could not resolve "node:crypto"
  
      src/randomBytes.ts:5:36:
        5 │ ... return new Uint8Array(require('node:crypto').randomBytes(length));
          ╵                                   ~~~~~~~~~~~~~
  
    The package "node:crypto" wasn't found on the file system but is built into node.
    Add "node_compat = true" to your wrangler.toml file to enable Node.js compatibility.
  

  This change turns that Wrangler build failure into a warning, which users can choose to ignore if they know the import of node:* APIs is safe (because it will never trigger at runtime, for instance):

  ▲ [WARNING] The package "node:crypto" wasn't found on the file system but is built into node.
  
    Your Worker may throw errors at runtime unless you enable the "nodejs_compat"
    compatibility flag. Refer to
    https://developers.cloudflare.com/workers/runtime-apis/nodejs/ for more details.
    Imported from:
     - src/randomBytes.ts
  

  However, in a lot of cases, it's possible to know at build time whether the import is safe. This change also injects navigator.userAgent into esbuild's bundle settings as a predefined constant, which means that esbuild can tree-shake away imports of node:* APIs that are guaranteed not to be hit at runtime, supressing the warning entirely.

• #4926 a14bd1d9 Thanks @dario-piotrowicz! - feature: add a cf field to the getBindingsProxy result

  Add a new cf field to the getBindingsProxy result that people can use to mock the production
  cf (IncomingRequestCfProperties) object.

  Example:

  const { cf } = await getBindingsProxy();
  
  console.log(`country = ${cf.country}; colo = ${cf.colo}`);

Patch Changes

• #4931 321c7ed7 Thanks @dario-piotrowicz! - fix: make the entrypoint optional for the types command

  Currently running wrangler types against a wrangler.toml file without a defined entrypoint (main value)
  causes the command to error with the following message:

  ✘ [ERROR] Missing entry-point: The entry-point should be specified via the command line (e.g. `wrangler types path/to/script`) or the `main` config field.
  

  However developers could want to generate types without the entrypoint being defined (for example when using getBindingsProxy), so these changes
  make the entrypoint optional for the types command, assuming modules syntax if none is specified.

• #4867 d637bd59 Thanks @RamIdeas! - fix: inflight requests to UserWorker which failed across reloads are now retried

  Previously, when running wrangler dev, requests inflight during a UserWorker reload (due to config or source file changes) would fail.

  Now, if those inflight requests are GET or HEAD requests, they will be reproxied against the new UserWorker. This adds to the guarantee that requests made during local development reach the latest worker.

• #4928 4a735c46 Thanks @sdnts! - fix: Update API calls for Sippy's endpoints

• #4938 75bd08ae Thanks @rozenmd! - fix: print wrangler banner at the start of every d1 command

  This PR adds a wrangler banner to the start of every D1 command (except when invoked in JSON-mode)

  For example:

   ⛅️ wrangler 3.27.0
  -------------------
  ...
  

• #4953 d96bc7dd Thanks @mrbbot! - fix: allow port option to be specified with unstable_dev()

  Previously, specifying a non-zero port when using unstable_dev() would try to start two servers on that port. This change ensures we only start the user-facing server on the specified port, allow unstable_dev() to startup correctly.

create-cloudflare@2.11.2

Patch Changes

• #4935 0699506d Thanks @dependabot! - chore: Bumped create-qwik from 1.4.3 to 1.4.4

• #4927 49696ab3 Thanks @jculvey! - feature: Add getBindingsProxy support to qwik template

  The qwik template now uses getBindingsProxy for handling requests for bound resources
  in dev. This allows projects to use vite for dev instead of wrangler pages dev on built output.

[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/7833473147/npm-package-wrangler-4934

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

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

Or you can use npx with this latest build directly:

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

Additional artifacts:

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

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

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

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

---

wrangler@3.28.0 includes the following runtime dependencies:

Package	Constraint	Resolved
miniflare	workspace:*	3.20240129.1
workerd	1.20240129.0	1.20240129.0
workerd --version	1.20240129.0	2024-01-29

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

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (4eb4d7f) 70.48% compared to head (a2c9c63) 70.46%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4934      +/-   ##
==========================================
- Coverage   70.48%   70.46%   -0.02%     
==========================================
  Files         295      295              
  Lines       15407    15407              
  Branches     3948     3948              
==========================================
- Hits        10860    10857       -3     
- Misses       4547     4550       +3     

see 1 file with indirect coverage changes