Releases: cloudflare/workers-sdk
[email protected]
Minor Changes
-
#12401
8723684Thanks @jonesphillip! - Add validation retry loops to pipelines setup commandThe
wrangler pipelines setupcommand now prompts users to retry when validation errors occur, instead of failing the entire setup process. This includes:- Validation retry prompts for pipeline names, bucket names, and field names
- A "simple" mode for sink configuration that uses sensible defaults
- Automatic bucket creation when buckets don't exist
- Automatic Data Catalog enablement when not already active
This improves the setup experience by allowing users to correct mistakes without restarting the entire configuration flow.
-
#12395
aa82c2bThanks @cmackenzie1! - Generate typed pipeline bindings from stream schemasWhen running
wrangler types, pipeline bindings now generate TypeScript types based on the stream's schema definition. This gives you full autocomplete and type checking when sending data to your pipelines.If your stream has a schema with fields like
user_id(string) andevent_count(int32), the generated types will be:declare namespace Cloudflare { type AnalyticsStreamRecord = { user_id: string; event_count: number }; interface Env { ANALYTICS: Pipeline<Cloudflare.AnalyticsStreamRecord>; } }
For unstructured streams or when not authenticated, bindings fall back to the generic
Pipeline<PipelineRecord>type.
Patch Changes
-
#12592
aaa7200Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260217.0 1.20260218.0 -
#12606
2f19a40Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260218.0 1.20260219.0 -
#12604
e2a6600Thanks @petebacondarwin! - fix: pass--envflag to auxiliary workers in multi-worker modeWhen running
wrangler devwith multiple config files (e.g.-c ./apps/api/wrangler.jsonc -c ./apps/queues/wrangler.jsonc -e=dev), the--envflag was not being passed to auxiliary (non-primary) workers. This meant that environment-specific configuration (such as queue bindings) was not applied to auxiliary workers, causing features like queue consumers to not be triggered in local development. -
#12597
0b17117Thanks @sdnts! - The maximum allowed delivery and retry delays for Queues is now 24 hours -
#12598
ca58062Thanks @mattzcarey! - Stop redactingwrangler whoamioutput in non-interactive modewrangler whoamiis explicitly invoked to retrieve account info, so email and account names should always be visible. Redacting them in non-interactive/CI environments makes it difficult for coding agents and automated tools to identify which account to use. Other error messages that may appear unexpectedly in CI logs (e.g. multi-account selection errors) remain redacted. -
Updated dependencies [
f239077,aaa7200,2f19a40,5f9f0b4,452cdc8,527e4f5,0b17117]:- [email protected]
- @cloudflare/[email protected]
[email protected]
Minor Changes
-
#12462
f239077Thanks @petebacondarwin! - AddMiniflare#purgeCache()method to clear cache entries programmaticallyThis allows developers to clear cached data during local development without
restarting the Miniflare instance. Useful when working with Workers Sites
or any application that uses the Cache API.const mf = new Miniflare({ /* options */ }); // Purge the default cache await mf.purgeCache(); // Purge a specific named cache await mf.purgeCache("my-named-cache");
-
#12574
527e4f5Thanks @emily-shen! - Local explorer: add /query endpoint to introspect sqlite in DOsThis required adding a wrapper that extends user DO classes and adds in an extra method to access
ctx.storage.sql. This shouldn't have any impact on user code, but is gated by the env varX_LOCAL_EXPLORER.This is for an experimental WIP feature.
Patch Changes
-
#12592
aaa7200Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260217.0 1.20260218.0 -
#12606
2f19a40Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260218.0 1.20260219.0 -
#12597
0b17117Thanks @sdnts! - The maximum allowed delivery and retry delays for Queues is now 24 hours
@cloudflare/[email protected]
@cloudflare/[email protected]
@cloudflare/[email protected]
Patch Changes
- Updated dependencies [
f239077,aaa7200,2f19a40,8723684,e2a6600,5f9f0b4,452cdc8,527e4f5,aa82c2b,0b17117,ca58062]:- [email protected]
- [email protected]
- @cloudflare/[email protected]
@cloudflare/[email protected]
Minor Changes
-
#11734
5f9f0b4Thanks @petebacondarwin! - Add support for nativenode:readlinemodule when theenable_nodejs_readline_modulecompatibility flag is enabled.This feature is currently experimental and requires both the
enable_nodejs_readline_moduleandexperimentalcompatibility flags to be set. -
#12043
452cdc8Thanks @petebacondarwin! - Add support for nativenode:worker_threadsmodule from workerd when theenable_nodejs_worker_threads_modulecompatibility flag is enabled.This feature is currently experimental and requires
nodejs_compat,experimental, andenable_nodejs_worker_threads_modulecompatibility flags to be set.
@cloudflare/[email protected]
@cloudflare/[email protected]
[email protected]
Minor Changes
-
#12466
caf9b11Thanks @petebacondarwin! - AddWRANGLER_CACHE_DIRenvironment variable and smart cache directory detectionWrangler now intelligently detects where to store cache files:
- Use
WRANGLER_CACHE_DIRenv var if set - Use existing cache directory if found (
node_modules/.cache/wrangleror.wrangler/cache) - Create cache in
node_modules/.cache/wranglerifnode_modulesexists - Otherwise use
.wrangler/cache
This improves compatibility with Yarn PnP, pnpm, and other package managers that don't use traditional
node_modulesdirectories, without requiring any configuration. - Use
-
#12572
936187dThanks @dario-piotrowicz! - Ensure thenodejs_compatflag is always applied in autoconfigPreviously, the autoconfig feature relied on individual framework configurations to specify Node.js compatibility flags, some could set
nodejs_compatwhile othersnodejs_als.Now instead
nodejs_compatis always included as a compatibility flag, this is generally beneficial and the user can always remove the flag afterwards if they want to. -
#12560
c4c86f8Thanks @taylorlee! - Support--tagand--messageflags onwrangler deployThey have the same behavior that they do as during
wrangler versions upload, as both
are set on the version.The message is also reused for the deployment as well, with the same behavior as used
duringwrangler versions deploy.
Patch Changes
-
#12543
5a868a0Thanks @G4brym! - Fix AI Search binding failing in local devUsing AI Search bindings with
wrangler devwould fail with "RPC stub points at a non-serializable type". AI Search bindings now work correctly in local development. -
#12552
c58e81bThanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260212.0 1.20260213.0 -
#12568
33a9a8fThanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260213.0 1.20260214.0 -
#12576
8077c14Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260214.0 1.20260217.0 -
#12466
caf9b11Thanks @petebacondarwin! - fix: exclude.wranglerdirectory from Pages uploadsThe
.wranglerdirectory contains local cache and state files that should never be deployed. This aligns Pages upload behavior with Workers Assets, which already excludes.wranglervia.assetsignore. -
#12556
7d2355eThanks @ascorbic! - Fix port availability check probing the wrong host when host changesmemoizeGetPortcorrectly invalidated its cached port when called with a different host, but then still probed the original host for port availability. This could return a port that was free on the original host but already in use on the requested one, leading to bind failures at startup. -
#12562
7ea69afThanks @MattieTK! - Support function-based Vite configs in autoconfig setupwrangler setupandwrangler deploy --x-autoconfigcan now automatically add the Cloudflare Vite plugin to projects that use function-baseddefineConfig()patterns. Previously, autoconfig would fail with "Cannot modify Vite config: expected an object literal but found ArrowFunctionExpression" for configs like:export default defineConfig(({ isSsrBuild }) => ({ plugins: [reactRouter(), tsconfigPaths()], }));
This pattern is used by several official framework templates, including React Router's
node-postgresandnode-custom-servertemplates. The followingdefineConfig()patterns are now supported:defineConfig({ ... })(object literal, already worked)defineConfig(() => ({ ... }))(arrow function with expression body)defineConfig(({ isSsrBuild }) => ({ ... }))(arrow function with destructured params)defineConfig(() => { return { ... }; })(arrow function with block body)defineConfig(function() { return { ... }; })(function expression)
-
#12548
5cc7158Thanks @dario-piotrowicz! - Fix.assetsignoreformatting when autoconfig creates a new filePreviously, when
wrangler setuporwrangler deploy --x-autoconfigcreated a new.assetsignorefile via autoconfig, it would add unnecessary leading empty lines before the wrangler-specific entries. Empty separator lines should only be added when appending to an existing.assetsignorefile. This fix ensures newly created.assetsignorefiles start cleanly without leading blank lines. -
#12556
7d2355eThanks @ascorbic! - Improve error message when port binding is blocked by a sandbox or security policyWhen running
wrangler devinside a restricted environment (such as an AI coding agent sandbox or locked-down container), the port availability check would fail with a rawEPERMerror. This now provides a clear message explaining that a sandbox or security policy is blocking network access, rather than the generic permission error that previously pointed at the file system. -
#12545
c9d0f9dThanks @dario-piotrowicz! - Improve framework detection when multiple frameworks are foundWhen autoconfig detects multiple frameworks in a project, Wrangler now applies smarter logic to select the most appropriate one. Selecting the wrong one is acceptable locally where the user can change the detected framework, in CI an error is instead thrown.
-
#12548
5cc7158Thanks @dario-piotrowicz! - Add trailing newline to generatedpackage.jsonandwrangler.jsoncfiles -
#12548
5cc7158Thanks @dario-piotrowicz! - Fix.gitignoreformatting when autoconfig creates a new filePreviously, when
wrangler setuporwrangler deploycreated a new.gitignorefile via autoconfig, it would add unnecessary leading empty lines before the wrangler-specific entries. Empty separator lines should only be added when appending to an existing.gitignorefile. This fix ensures newly created.gitignorefiles start cleanly without leading blank lines. -
#12545
c9d0f9dThanks @dario-piotrowicz! - Throw actionable error when autoconfig is run in the root of a workspaceWhen running Wrangler commands that trigger auto-configuration (like
wrangler devorwrangler deploy) in the root directory of a monorepo workspace, a helpful error is now shown directing users to run the command in a specific project's directory instead. -
Updated dependencies [[
5a868a0](5a868a0c0b305548e4...
[email protected]
Minor Changes
-
#12546
43c462aThanks @emily-shen! - Local explorer: add endpoints to list DO namespaces and objectsThis is part of an experimental, WIP feature.
Patch Changes
-
#12543
5a868a0Thanks @G4brym! - Fix AI Search binding failing in local devUsing AI Search bindings with
wrangler devwould fail with "RPC stub points at a non-serializable type". AI Search bindings now work correctly in local development. -
#12552
c58e81bThanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260212.0 1.20260213.0 -
#12568
33a9a8fThanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260213.0 1.20260214.0 -
#12576
8077c14Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"The following dependency versions have been updated:
Dependency From To workerd 1.20260214.0 1.20260217.0 -
#12466
caf9b11Thanks @petebacondarwin! - AddMINIFLARE_CACHE_DIRenvironment variable and smart cache directory detectionMiniflare now intelligently detects where to store its cf.json cache file:
- Use
MINIFLARE_CACHE_DIRenv var if set - Use existing cache directory if found (
node_modules/.mfor.wrangler/cache) - Create cache in
node_modules/.mfifnode_modulesexists - Otherwise use
.wrangler/cache
This improves compatibility with Yarn PnP, pnpm, and other package managers that don't use traditional
node_modulesdirectories, without requiring any configuration. - Use