Wrangler · Wrangler

3.32.0

Thursday, Mar 7, 2024

#5148 11951f3 Thanks @dom96! - chore: bump workerd to 1.20240304.0
#5148 11951f3 Thanks @dom96! - fix: use python_workers compat flag for Python
#5089 5b85dc9 Thanks @DaniFoldi! - fix: include all currently existing bindings in wrangler types

Add support for Email Send, Vectorize, Hyperdrive, mTLS, Browser Rendering and Workers AI bindings in wrangler types

For example, from the following wrangler.toml setup:

Previously, nothing would have been included in the generated Environment. Now, the following will be generated:
Updated dependencies [ 11951f3, 11951f3]:
- miniflare@3.20240304.0

3.31.0

Tuesday, Mar 5, 2024

#5119 b0bd413 Thanks @garrettgu10! - feature: Python support for remote dev
#5118 30694a3 Thanks @garrettgu10! - fix: Including version identifiers in Python requirements.txt will now throw an error
#5132 82a3f94 Thanks @mrbbot! - fix: switch default logging level of unstable_dev() to warn

When running unstable_dev() in its default “test mode”, the logging level was set to none. This meant any Worker startup errors or helpful warnings wouldn’t be shown. This change switches the default to warn. To restore the previous behaviour, include logLevel: "none" in your options object:
#5128 d27e2a7 Thanks @taylorlee! - fix: Add legacy_env support to experimental versions upload command.
#5087 a5231de Thanks @dario-piotrowicz! - fix: make wrangler types always generate a d.ts file for module workers

Currently if a config file doesn’t define any binding nor module, running wrangler types against such file would not produce a d.ts file.

Producing a d.ts file can however still be beneficial as it would define a correct env interface (even if empty) that can be expanded/referenced by user code (this can be particularly convenient for scaffolding tools that may want to always generate an env interface).

Example: Before wrangler types --env-interface MyEnv run with an empty wrangler.toml file would not generate any file, after these change it would instead generate a file with the following content:
```
interface MyEnv {
}
```
#5138 3dd9089 Thanks @G4brym! - fix: ensure Workers-AI local mode fetcher returns headers to client worker
Updated dependencies [ 42bcc72, 42bcc72]:
- miniflare@3.20240223.1

3.30.1

Thursday, Feb 29, 2024

#5106 2ed7f32 Thanks @RamIdeas! - fix: automatically drain incoming request bodies

Previously, requests sent to wrangler dev with unconsumed bodies could result in Network connection lost errors. This change attempts to work around the issue by ensuring incoming request bodies are drained if they’re not used. This is a temporary fix whilst we try to address the underlying issue. Whilst we don’t think this change will introduce any other issues, it can be disabled by setting the WRANGLER_DISABLE_REQUEST_BODY_DRAINING=true environment variable. Note this fix is only applied if you’ve enabled Wrangler’s bundling—--no-bundle mode continues to have the previous behaviour.
#5107 65d0399 Thanks @penalosa! - fix: Ensures that switching to remote mode during a dev session (from local mode) will correctly use the right zone. Previously, zone detection happened before the dev session was mounted, and so dev sessions started with local mode would have no zone inferred, and would have failed to start, with an ugly error.
#5107 65d0399 Thanks @penalosa! - fix: Ensure that preview sessions created without a zone don’t switch the host on which to start the preview from the one returned by the API.
#4833 54f6bfc Thanks @admah! - fix: remove extra arguments from wrangler init deprecation message and update recommended c3 version

c3 can now infer the pre-existing type from the presence of the --existing-script flag so we can remove the extra type argument. C3 2.5.0 introduces an auto-update feature that will make sure users get the latest minor version of c3 and prevent problems where older 2.x.x versions get cached by previous runs of wrangler init.

3.30.0

Tuesday, Feb 27, 2024

#4742 c2f3f1e Thanks @benycodes! - feat: allow preserving file names when defining rules for non-js modules

The developer is now able to specify the `preserve_file_names property in wrangler.toml which specifies whether Wrangler will preserve the file names additional modules that are added to the deployment bundle of a Worker.

If not set to true, files will be named using the pattern ${fileHash}-${basename}. For example, 34de60b44167af5c5a709e62a4e20c4f18c9e3b6-favicon.ico.

Resolves #4741
Updated dependencies [ 0c0949d]:
- miniflare@3.20240223.0

3.29.0

Thursday, Feb 22, 2024

#5042 5693d076 Thanks @dario-piotrowicz! - feat: add new --env-interface to wrangler types

Allow users to specify the name of the interface that they want wrangler types to generate for the env parameter, via the new CLI flag --env-interface

Example:

generates

instead of
#5042 5693d076 Thanks @dario-piotrowicz! - feat: add new path positional argument to wrangler types

Allow users to specify the path to the typings (.d.ts) file they want wrangler types to generate

Example:

generates a my-env.d.ts file in the current directory instead of creating a worker-configuration.d.ts file
#5042 5693d076 Thanks @dario-piotrowicz! - feat: include command run in the wrangler types comment

In the comment added to the .d.ts file generated by wrangler types include the command run to generated the file
#4303 1c460287 Thanks @richardscarrott! - fix: allow Pages Functions to import built-in node:* modules, even when not bundling with wrangler
#4957 50f93bd2 Thanks @garrettgu10! - fix: don’t strip .py extensions from Python modules
#5042 5693d076 Thanks @dario-piotrowicz! - fix: make wrangler types honor top level config argument

The wrangler types command currently ignores the -c|--config argument (although it is still getting shown in the command’s help message). Make sure that the command honors the flag. Also, if no config file is detected present a warning to the user
#5042 5693d076 Thanks @dario-piotrowicz! - fix: make the wrangler types command pick up local secret keys from .dev.vars

Make sure that the wrangler types command correctly picks up secret keys defined in .dev.vars and includes them in the generated file (marking them as generic string types of course)
Updated dependencies [ b03db864]:
- miniflare@3.20240208.0

3.28.4

Tuesday, Feb 20, 2024

#5050 88be4b84 Thanks @nora-soderlund! - fix: allow kv:namespace create to accept a namespace name that contains characters not allowed in a binding name

This command tries to use the namespace name as the binding. Previously, we would unnecessarily error if this namespace name did not fit the binding name constraints. Now we accept such names and then remove invalid characters when generating the binding name.

3.28.3

Friday, Feb 16, 2024

#5026 04584722 Thanks @dario-piotrowicz! - fix: make sure getPlatformProxy produces a production-like caches object

make sure that the caches object returned to getPlatformProxy behaves in the same manner as the one present in production (where calling unsupported methods throws a helpful error message)

note: make sure that the unsupported methods are however not included in the CacheStorage type definition
#5030 55ea0721 Thanks @mrbbot! - fix: don’t suggest reporting user errors to GitHub

Wrangler has two different types of errors: internal errors caused by something going wrong, and user errors caused by an invalid configuration. Previously, we would encourage users to submit bug reports for user errors, even though there’s nothing we can do to fix them. This change ensures we only suggest this for internal errors.
#4900 3389f2e9 Thanks @OilyLime! - feature: allow hyperdrive users to set local connection string as environment variable

Wrangler dev now supports the HYPERDRIVE_LOCAL_CONNECTION_STRING environmental variable for connecting to a local database instance when testing Hyperdrive in local development. This environmental variable takes precedence over the localConnectionString set in wrangler.toml.
#5033 b1ace91b Thanks @mrbbot! - fix: wait for actual port before opening browser with --port=0

Previously, running wrangler dev --remote --port=0 and then immediately pressing b would open localhost:0 in your default browser. This change queues up opening the browser until Wrangler knows the port the dev server was started on.
#5026 04584722 Thanks @dario-piotrowicz! - fix: relax the getPlatformProxy’s’ cache request/response types

prior to these changes the caches obtained from getPlatformProxy would use unknowns as their types, this proved too restrictive and incompatible with the equivalent @cloudflare/workers-types types, we decided to use anys instead to allow for more flexibility whilst also making the type compatible with workers-types
Updated dependencies [ 7723ac17, 027f9719, 027f9719, 027f9719, 027f9719, 027f9719, 027f9719]:
- miniflare@3.20240129.3

3.28.2

Tuesday, Feb 13, 2024

#4950 05360e43 Thanks @petebacondarwin! - fix: ensure we do not rewrite external Origin headers in wrangler dev

In https://github.com/cloudflare/workers-sdk/pull/4812 we tried to fix the Origin headers to match the Host header but were overzealous and rewrote Origin headers for external origins (outside of the proxy server’s origin).

This is now fixed, and moreover we rewrite any headers that refer to the proxy server on the request with the configured host and vice versa on the response.

This should ensure that CORS is not broken in browsers when a different host is being simulated based on routes in the Wrangler configuration.
#4997 bfeefe27 Thanks @dario-piotrowicz! - chore: add missing defineNavigatorUserAgent dependency to useEsbuild hook
#4966 36692326 Thanks @penalosa! - fix: Report Custom Build failures as UserErrors
#5002 315a651b Thanks @dario-piotrowicz! - chore: rename getBindingsProxy to getPlatformProxy

initially getBindingsProxy was supposed to only provide proxies for bindings, the utility has however grown, including now cf, ctx and caches, to clarify the increased scope the utility is getting renamed to getPlatformProxy and its bindings field is getting renamed env

note: getBindingProxy with its signature is still kept available, making this a non breaking change
Updated dependencies [ 05360e43]:
- miniflare@3.20240129.2