Changelog | wrangler

wrangler - 4.15.2

Thu, 15 May 2025 00:00:00 GMT

Patch Changes

#9257 33daa09 Thanks @penalosa! - Relax R2 bucket validation for pages dev commands
#9256 3b384e2 Thanks @penalosa! - Move the Analytics Engine simulator implementation from JSRPC to a Wrapped binding. This fixes a regression introduced in https://github.com/cloudflare/workers-sdk/pull/8935 that preventing Analytics Engine bindings working in local dev for Workers with a compatibility date prior to JSRPC being enabled.
Updated dependencies [3b384e2]:
- miniflare@4.20250508.2
- @cloudflare/unenv-preset@2.3.2

wrangler - 4.15.1

Thu, 15 May 2025 00:00:00 GMT

Patch Changes

#9248 07f4010 Thanks @vicb! - fix unenv version mismatch
#9219 ea71df3 Thanks @vicb! - bump unenv to 2.0.0-rc.17
#9246 d033a7d Thanks @edmundhung! - fix: strip CF-Connecting-IP header within fetch

In v4.15.0, Miniflare began stripping the CF-Connecting-IP header via a global outbound service, which led to a TCP connection regression due to a bug in Workerd. This PR patches the fetch API to strip the header during local wrangler dev sessions as a temporary workaround until the underlying issue is resolved.
Updated dependencies [f61a08e, ea71df3, d033a7d]:
- @cloudflare/unenv-preset@2.3.2
- miniflare@4.20250508.1

wrangler - 4.15.0

Tue, 13 May 2025 00:00:00 GMT

Minor Changes

#8794 02f0699 Thanks @eastlondoner! - This adds support for more accurate types for service bindings when running wrangler types. Previously, running wrangler types with a config including a service binding would generate an Env type like this:
```
interface Env {
    SERVICE_BINDING: Fetcher;
}
```
This type was "correct", but didn't capture the possibility of using JSRPC to communicate with the service binding. Now, running wrangler types -c wrangler.json -c ../service/wrangler.json (the first config representing the current Worker, and any additional configs representing service bound Workers) will generate an Env type like this:
```
interface Env {
    SERVICE_BINDING: Service<import("../service/src/index").Entrypoint>;
}
```
#8716 63a6504 Thanks @ItsWendell! - add --metafile flag to generate esbuild metadata file during build
#9122 f17ee08 Thanks @avenceslau! - Unhide wrangler workflows delete command

Patch Changes

#9168 6b42c28 Thanks @dario-piotrowicz! - remove experimental MixedModeConnectionString type

remove the experimental MixedModeConnectionString type which is now exposed by Miniflare instead
#7914 37af035 Thanks @andyjessop! - fix(miniflare): strip CF-Connecting-IP header from all outbound requests
#9161 53ba97d Thanks @lambrospetrou! - Fix d1 info command showing read_replication: [object Object]
#9165 91d0c40 Thanks @vicb! - validate r2 bucket names
#9183 f6f1a18 Thanks @dario-piotrowicz! - add remote option to initial bindings

add the remote option (initial implementation gated behind --x-mixed-mode) for the following bindings: service, kv, r2, d1, queue and workflow
#9149 415520e Thanks @penalosa! - Implement mixed mode proxy server & client
Updated dependencies [37af035, ceeb375, 349cffc, 362cb0b, 2cc8197, 6b42c28]:
- miniflare@4.20250508.0

wrangler - 4.14.4

Thu, 08 May 2025 00:00:00 GMT

Patch Changes

#9124 d0d62e6 Thanks @dario-piotrowicz! - make that unstable_startWorker can correctly throw configuration errors

make sure that unstable_startWorker can throw configuration related errors when:
- the utility is called
- the worker's setConfig is called with the throwErrors argument set to true
additionally when an error is thrown when unstable_startWorker is called make sure that the worker is properly disposed (since, given the fact that it is not returned by the utility the utility's caller wouldn't have any way to dispose it themselves)

wrangler - 4.14.3

Wed, 07 May 2025 00:00:00 GMT

Patch Changes

#9158 826c5e8 Thanks @petebacondarwin! - fix CallSite.toString() not to throw
#9159 c6b3f10 Thanks @petebacondarwin! - bump esbuild version to fix regression in 0.25.0
#8985 078c568 Thanks @gabivlj! - wrangler deploy is able to deploy new container versions
#9162 8c3cdc3 Thanks @petebacondarwin! - Do not report "d1 execute" command file missing error to Sentry
Updated dependencies [df5d1f6, 4672bda, c6b3f10]:
- miniflare@4.20250507.0

wrangler - 4.14.2

Tue, 06 May 2025 00:00:00 GMT

Patch Changes

#9118 1cd30a5 Thanks @dario-piotrowicz! - fix: remove outdated js-doc comment for unstable_startDevWorker's entrypoint
#9120 11aa362 Thanks @dario-piotrowicz! - Add experimental_startMixedModeSession no-op utility

This experimental utility has no effect. More details will be shared as we roll out its functionality.
#7423 2be85d7 Thanks @penalosa! - Make sure custom build logging output is more clearly signposted, and make sure it doesn't interfere with the interactive dev session output.
#9112 3fe85d4 Thanks @penalosa! - Warn if the Node.js version is below Node.js 20

wrangler - 4.14.1

Thu, 01 May 2025 00:00:00 GMT

Patch Changes

#9085 cdc88d8 Thanks @petebacondarwin! - Do not include .wrangler and Wrangler config files in additional modules

Previously, if you added modules rules such as **/*.js or **/*.json, specified no_bundle: true, and the entry-point to the Worker was in the project root directory, Wrangler could include files that were not intended, such as .wrangler/tmp/xxx.js or the Wrangler config file itself. Now these files are automatically skipped when trying to find additional modules by searching the file tree.
#9095 508a1a3 Thanks @petebacondarwin! - wrangler login put custom callback host and port into the auth URL
#9113 82e220e Thanks @dario-piotrowicz! - Add x-mixed-mode flag

This experimental flag currently has no effect. More details will be shared as we roll out its functionality.
Updated dependencies [357d42a]:
- miniflare@4.20250428.1

wrangler - 3.114.8

Thu, 01 May 2025 00:00:00 GMT

Patch Changes

#9086 a2a56c8 Thanks @petebacondarwin! - Do not include .wrangler and Wrangler config files in additional modules

Previously, if you added modules rules such as **/*.js or **/*.json, specified no_bundle: true, and the entry-point to the Worker was in the project root directory, Wrangler could include files that were not intended, such as .wrangler/tmp/xxx.js or the Wrangler config file itself. Now these files are automatically skipped when trying to find additional modules by searching the file tree.
#9037 d0d0025 Thanks @CarmenPopoviciu! - fix: When generating Env types, set type of version metadata binding to WorkerVersionMetadata. This means it now correctly includes the timestamp field.
#9093 2f2f7ba Thanks @CarmenPopoviciu! - fix: Validate input file for Vectorize inserts
Updated dependencies [fc04292, a01adca]:
- miniflare@3.20250408.1

wrangler - 4.14.0

Tue, 29 Apr 2025 00:00:00 GMT

Minor Changes

#8981 3b60131 Thanks @Caio-Nogueira! - Adds support for waitForEvent step type
#9083 137d2da Thanks @penalosa! - Support Tail Workers in local dev

Patch Changes

#8975 9bf55aa Thanks @Caio-Nogueira! - Adds missing waiting status on the wrangler workflow instances list command
#9048 0b4d22a Thanks @garvit-gupta! - fix: Validate input file for Vectorize inserts
Updated dependencies [d2ecc76, 137d2da]:
- miniflare@4.20250428.0

wrangler - 4.13.2

Fri, 25 Apr 2025 00:00:00 GMT

Patch Changes

Updated dependencies [2c50115]:
- miniflare@4.20250424.1

wrangler - 4.13.1

Thu, 24 Apr 2025 00:00:00 GMT

Patch Changes

#8983 f5ebb33 Thanks @Caio-Nogueira! - Remove open-beta disclaimer from workflows commands
#8990 6291fa1 Thanks @emily-shen! - fix: When generating Env types, set type of version metadata binding to WorkerVersionMetadata. This means it now correctly includes the timestamp field.
#8966 234afae Thanks @penalosa! - Internal refactor to use the createCommand utility
Updated dependencies [fc47c79, 0838f1b]:
- miniflare@4.20250424.0

wrangler - 4.13.0

Wed, 23 Apr 2025 00:00:00 GMT

Minor Changes

#8640 5ce70bd Thanks @kentonv! - Add support for defining props on a Service binding.

In your configuration file, you can define a service binding with props:

{
    "services": [
        {
            "binding": "MY_SERVICE",
            "service": "some-worker",
            "props": { "foo": 123, "bar": "value" }
        }
    ]
}

These can then be accessed by the callee:

import { WorkerEntrypoint } from "cloudflare:workers";

export default class extends WorkerEntrypoint {
    fetch() {
        return new Response(JSON.stringify(this.ctx.props));
    }
}

#8771 0cfcfe0 Thanks @dario-piotrowicz! - feat: add config.keep_names option

Adds a new option to Wrangler to allow developers to opt out of esbuild's keep_names option (https://esbuild.github.io/api/#keep-names). By default, Wrangler sets this to true

This is something developers should not usually need to care about, but sometimes keep_names can create issues, and in such cases they will be now able to opt-out.

Example wrangler.jsonc:
```
{
    "name": "my-worker",
    "main": "src/worker.ts",
    "keep_names": false
}
```

Patch Changes

#9024 c409318 Thanks @IRCody! - Correctly handle 0 length responses to wrangler containers list.
Updated dependencies [5ce70bd, 3f0adf3]:
- miniflare@4.20250422.0

wrangler - 4.12.1

Tue, 22 Apr 2025 00:00:00 GMT

Patch Changes

#8935 41f095b Thanks @penalosa! - Internal refactor to move local analytics engine support from Wrangler to Miniflare
Updated dependencies [2a7749b, 41f095b]:
- miniflare@4.20250417.0

wrangler - 3.114.7

Tue, 22 Apr 2025 00:00:00 GMT

Patch Changes

#8955 b7eba92 Thanks @workers-devprod! - When Wrangler encounters an error, if the Bun runtime is detected it will now warn users that Wrangler does not officially support Bun.
#8928 8bcb257 Thanks @dario-piotrowicz! - fix redirected config env validation breaking wrangler pages commands

a validation check has recently been introduced to make wrangler error on deploy commands when an environment is specified and a redirected configuration is in use (the reason being that redirected configurations should not include any environment), this check is problematic with pages commands where the "production" environment is anyways set by default, to address this the validation check is being relaxed here on pages commands

wrangler - 4.12.0

Thu, 17 Apr 2025 00:00:00 GMT

Minor Changes

#8316 69864b4 Thanks @gnekich! - introduce callback-host and callback-port param for wrangler login command

Patch Changes

#8889 eab7ad9 Thanks @penalosa! - When Wrangler encounters an error, if the Bun runtime is detected it will now warn users that Wrangler does not officially support Bun.
#8673 5de2b9a Thanks @IRCody! - Add containers {info, list, delete} subcommands.
Updated dependencies [62c40d7]:
- miniflare@4.20250416.0

wrangler - 4.11.1

Tue, 15 Apr 2025 00:00:00 GMT

Patch Changes

#8950 bab1724 Thanks @edmundhung! - fix: include telemetry-related environment variables in release builds
#8903 085a565 Thanks @emily-shen! - disable eslint in generated types file
Updated dependencies [511be3d]:
- miniflare@4.20250410.1

wrangler - 4.11.0

Tue, 15 Apr 2025 00:00:00 GMT

Minor Changes

#8890 c912b99 Thanks @edmundhung! - update esbuild version to 0.25
#8711 4cc036d Thanks @CarmenPopoviciu! - Add the Pages deployment id to the JSON output for wrangler pages deployment list
#8244 84ecfe9 Thanks @CarmenPopoviciu! - feat: Add debug logs to capture assets upload status, specifically:
- which asset files were read from the file system
- which files were successfully uploaded

Patch Changes

#8885 f2802f9 Thanks @CarmenPopoviciu! - Disambiguate the "No files to upload. Proceeding with deployment..." message
#8924 d2b44a2 Thanks @dario-piotrowicz! - fix redirected config env validation breaking wrangler pages commands

a validation check has recently been introduced to make wrangler error on deploy commands when an environment is specified and a redirected configuration is in use (the reason being that redirected configurations should not include any environment), this check is problematic with pages commands where the "production" environment is anyways set by default, to address this the validation check is being relaxed here on pages commands
Updated dependencies [f5413c5]:
- miniflare@4.20250410.0

wrangler - 3.114.6

Mon, 14 Apr 2025 00:00:00 GMT

Patch Changes

#8783 7bcf352 Thanks @petebacondarwin! - Improve error message when request to obtain membership info fails

Wrangler now informs user that specific permission might be not granted when fails to obtain membership info. The same information is provided when Wrangler is unable to fetch user's email.
#8866 db673d6 Thanks @edmundhung! - improve error message when redirected config contains environments

this change improves that validation error message that users see when a redirected config file contains environments, by:
- cleaning the message formatting and displaying the offending environments in a list
- prompting the user to report the issue to the author of the tool which has generated the config
#8600 91cf028 Thanks @workers-devprod! - add validation to redirected configs in regards to environments

add the following validation behaviors to wrangler deploy commands, that relate to redirected configs (i.e. config files specified by .wrangler/deploy/config.json files):
- redirected configs are supposed to be already flattened configurations without any environment (i.e. a build tool should generate redirected configs already targeting specific environments), so if wrangler encounters a redirected config with some environments defined it should error
- given the point above, specifying an environment (--env=my-env) when using redirected configs is incorrect, so these environments should be ignored and a warning should be presented to the user

wrangler - 4.10.0

Thu, 10 Apr 2025 00:00:00 GMT

Minor Changes

#8807 dcce2ec Thanks @LuisDuarte1! - Promote workflows commands to stable

Patch Changes

#8883 5388447 Thanks @penalosa! - fix: Only log requests to the Wrangler dev server once
Updated dependencies [b7ac367, 5388447]:
- miniflare@4.20250409.0