Releases: cloudflare/workers-sdk
create-cloudflare@2.66.3
Patch Changes
-
#13274
6e62043Thanks @dependabot! - Update dependencies of "create-cloudflare"The following dependency versions have been updated:
Dependency From To create-astro 5.0.4 5.0.5 -
#13275
b221b00Thanks @dependabot! - Update dependencies of "create-cloudflare"The following dependency versions have been updated:
Dependency From To create-next-app 16.2.1 16.2.2 -
#13276
94ea512Thanks @dependabot! - Update dependencies of "create-cloudflare"The following dependency versions have been updated:
Dependency From To create-react-router 7.13.2 7.14.0 -
#13278
8e7074fThanks @dependabot! - Update dependencies of "create-cloudflare"The following dependency versions have been updated:
Dependency From To @angular/create 21.2.5 21.2.6 -
#13279
51f784fThanks @dependabot! - Update dependencies of "create-cloudflare"The following dependency versions have been updated:
Dependency From To create-vue 3.22.1 3.22.2 -
#13243
448fec8Thanks @petebacondarwin! - Show a clear error message when running on an unsupported Node.js versionPreviously, running
create-cloudflareon an older Node.js version (e.g. v18) would fail with a confusing syntax error. Now, a dedicated version check runs before loading the CLI and displays a helpful message explaining the minimum required Node.js version and suggesting version managers like Volta or nvm.
@cloudflare/workflows-shared@0.8.0
Minor Changes
-
#13145
5b60405Thanks @Caio-Nogueira! - Add support for ReadableStream on workflow steps. This allows users to overcome the 1MB limit per step output.ReadableStream<Uint8Array>is already serializable on the workers platform. This feature makes it native to workflows as well by persisting each chunk and replaying it if needed
@cloudflare/vitest-pool-workers@0.14.2
Patch Changes
-
#13095
65e6684Thanks @penalosa! - Reject V8 coverage provider with a clear error messageV8 native code coverage (
@vitest/coverage-v8) requiresnode:inspectorto collect profiling data from V8's runtime. workerd only providesnode:inspectoras a non-functional stub, so V8 coverage would silently fail or crash with a confusingNo such module "node:inspector"error.The pool now detects this configuration early — during Vite plugin setup, before Vitest tries to load the coverage provider — and throws a clear error directing users to use Istanbul coverage instead, which works by instrumenting source code at build time and runs on any JavaScript runtime.
-
Updated dependencies [
a3e3b57,7d318e1,fa6d84f,96ee5d4,7d318e1,7a60d4b,78cbe37,6fa5dfd]:- miniflare@4.20260405.0
- wrangler@4.81.0
@cloudflare/vite-plugin@1.31.1
@cloudflare/pages-shared@0.13.122
@cloudflare/local-explorer-ui@0.10.0
Minor Changes
wrangler@4.80.0
Minor Changes
-
#13151
9c4035bThanks @G4brym! - Add type generation for AI Search bindingsRunning
wrangler typesnow generatesAiSearchNamespaceandAiSearchInstancetypes forai_search_namespacesandai_searchconfig bindings respectively. Both simple and per-environment modes are supported.// wrangler.json { "ai_search_namespaces": [ { "binding": "AI_SEARCH", "namespace": "production" } ], "ai_search": [ { "binding": "BLOG_SEARCH", "instance_name": "cloudflare-blog" } ] }
// Generated by `wrangler types` interface Env { AI_SEARCH: AiSearchNamespace; BLOG_SEARCH: AiSearchInstance; }
-
#13011
b9b7e9dThanks @ruifigueira! - Add experimental headful browser rendering support for local developmentExperimental: This feature may be removed or changed without notice.
When developing locally with the Browser Rendering API, you can enable headful (visible) mode via the
X_BROWSER_HEADFULenvironment variable to see the browser while debugging:X_BROWSER_HEADFUL=true wrangler dev X_BROWSER_HEADFUL=true vite dev
Note: when using
@cloudflare/playwright, two Chrome windows may appear — the initial blank page and the one created bybrowser.newPage(). This is expected behavior due to how Playwright handles browser contexts via CDP. -
#12992
48d83caThanks @RiscadoA! - Addvpc_networksbinding support for routing Worker traffic through a Cloudflare Tunnel or network.{ "vpc_networks": [ // Route through a specific Cloudflare Tunnel { "binding": "MY_FIRST_VPC", "tunnel_id": "<tunnel-id>" }, // Route through the Cloudflare One mesh network { "binding": "MY_SECOND_VPC", "network_id": "cf1:network" } ] }
Patch Changes
-
#13155
5d29055Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260329.1 1.20260331.1 -
#13162
fb67a18Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260331.1 1.20260401.1 -
#13136
ab44870Thanks @petebacondarwin! - Display build errors for auxiliary workers in multi-worker modePreviously, when running
wrangler devwith multiple-cconfig flags (multi-worker mode), build errors from auxiliary/secondary workers were only logged at debug level, causing Wrangler to silently hang. Build errors from all workers are now displayed at error level so you can see what went wrong and fix it. -
#12992
48d83caThanks @RiscadoA! - Fix remote proxy worker not catching errors thrown by bindings duringwrangler dev -
#13238
b2f53eaThanks @guybedford! - Fix source phase imports in bundled and non-bundled WorkersWrangler now preserves
import sourcesyntax when it runs esbuild, including module format detection and bundled deploy output. This fixes both--no-bundleand bundled deployments for Workers that import WebAssembly using source phase imports. -
#10126
14e72ebThanks @nekoze1210! - fix: Sort D1 migration files to ensure consistent chronological orderingwrangler d1 migrations listandwrangler d1 migrations applypreviously returned migration files in an order dependent on the filesystem, which could vary across operating systems. Migration filenames are now sorted alphabetically before being returned, ensuring consistent chronological ordering. -
#13150
4dc94fdThanks @dario-piotrowicz! - Polish Cloudflare Vite plugin installation during autoconfigProjects using Vite 6.0.x were rejected by auto-configuration because the minimum supported version was set to 6.1.0 (the
@cloudflare/vite-pluginpeer dependency). The minimum version check is now 6.0.0, and when a project has Vite in the [6.0.0, 6.1.0) range, auto-configuration will automatically upgrade it to the latest 6.x before installing@cloudflare/vite-plugin. -
#13051
d5bffdeThanks @dario-piotrowicz! - Use today's date as the default compatibility datePreviously, when generating a compatibility date for new projects or when no compatibility date was configured, the date was resolved by loading the locally installed
workerdpackage viaminiflare. This approach was unreliable in some package manager environments (notablypnpm). The logic now simply uses today's date instead, which is always correct and works reliably across all environments. -
Updated dependencies [
5d29055,fb67a18,d5bffde,b9b7e9d,b2f53ea,48d83ca]:- miniflare@4.20260401.0
miniflare@4.20260401.0
Minor Changes
-
#13051
d5bffdeThanks @dario-piotrowicz! - DeprecatesupportedCompatibilityDateexportThe
supportedCompatibilityDateexport is now deprecated. Instead of relying on the workerd-derived compatibility date, callers should just use today's date directly, e.g.new Date().toISOString().slice(0, 10). -
#13011
b9b7e9dThanks @ruifigueira! - Add experimental headful browser rendering support for local developmentExperimental: This feature may be removed or changed without notice.
When developing locally with the Browser Rendering API, you can enable headful (visible) mode via the
X_BROWSER_HEADFULenvironment variable to see the browser while debugging:X_BROWSER_HEADFUL=true wrangler dev X_BROWSER_HEADFUL=true vite dev
Note: when using
@cloudflare/playwright, two Chrome windows may appear — the initial blank page and the one created bybrowser.newPage(). This is expected behavior due to how Playwright handles browser contexts via CDP. -
#12992
48d83caThanks @RiscadoA! - Addvpc_networksbinding support for routing Worker traffic through a Cloudflare Tunnel or network.{ "vpc_networks": [ // Route through a specific Cloudflare Tunnel { "binding": "MY_FIRST_VPC", "tunnel_id": "<tunnel-id>" }, // Route through the Cloudflare One mesh network { "binding": "MY_SECOND_VPC", "network_id": "cf1:network" } ] }
Patch Changes
-
#13155
5d29055Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260329.1 1.20260331.1 -
#13162
fb67a18Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260331.1 1.20260401.1 -
#13238
b2f53eaThanks @guybedford! - Fix source phase imports parsing in MiniflareMiniflare now uses the
acorn-import-phasesplugin to parseimport sourcesyntax when analyzing module dependencies. This fixesERR_MODULE_PARSEerrors when running Workers that use source phase imports for WebAssembly modules in local development.
create-cloudflare@2.66.2
Patch Changes
-
#13051
d5bffdeThanks @dario-piotrowicz! - Use today's date as the default compatibility datePreviously, when generating a compatibility date for new projects or when no compatibility date was configured, the date was resolved by loading the locally installed
workerdpackage viaminiflare. This approach was unreliable in some package manager environments (notablypnpm). The logic now simply uses today's date instead, which is always correct and works reliably across all environments.
@cloudflare/workers-utils@0.15.0
Minor Changes
-
#13011
b9b7e9dThanks @ruifigueira! - Add experimental headful browser rendering support for local developmentExperimental: This feature may be removed or changed without notice.
When developing locally with the Browser Rendering API, you can enable headful (visible) mode via the
X_BROWSER_HEADFULenvironment variable to see the browser while debugging:X_BROWSER_HEADFUL=true wrangler dev X_BROWSER_HEADFUL=true vite dev
Note: when using
@cloudflare/playwright, two Chrome windows may appear — the initial blank page and the one created bybrowser.newPage(). This is expected behavior due to how Playwright handles browser contexts via CDP. -
#13051
d5bffdeThanks @dario-piotrowicz! - RemoveformatCompatibilityDatefrom the package's public exportsThis utility has been removed from the public API. Callers should use
getTodaysCompatDate()from@cloudflare/workers-utilsinstead. -
#13051
d5bffdeThanks @dario-piotrowicz! - RemovegetLocalWorkerdCompatibilityDatefrom the packageThis utility has been removed because its implementation besides being unreliable is no longer needed. Callers should now use today's date as the compatibility date directly, e.g. via
getTodaysCompatDate()from@cloudflare/workers-utils. -
#12992
48d83caThanks @RiscadoA! - Addvpc_networksbinding support for routing Worker traffic through a Cloudflare Tunnel or network.{ "vpc_networks": [ // Route through a specific Cloudflare Tunnel { "binding": "MY_FIRST_VPC", "tunnel_id": "<tunnel-id>" }, // Route through the Cloudflare One mesh network { "binding": "MY_SECOND_VPC", "network_id": "cf1:network" } ] } -
#13051
d5bffdeThanks @dario-piotrowicz! - AddgetTodaysCompatDate()utility functionReturns today's date as a
YYYY-MM-DDstring.