Wrangler Changelog

2023-10-26

3.15.0

#4201 0cac2c46 Thanks @penalosa! - Callout --minify when script size is too large
#4209 24d1c5cf Thanks @mrbbot! - fix: suppress compatibility date fallback warnings if no wrangler update is available
If a compatibility date greater than the installed version of workerd was configured, a warning would be logged. This warning was only actionable if a new version of wrangler was available. The intent here was to warn if a user set a new compatibility date, but forgot to update wrangler meaning changes enabled by the new date wouldn’t take effect. This change hides the warning if no update is available.
It also changes the default compatibility date for wrangler dev sessions without a configured compatibility date to the installed version of workerd. This previously defaulted to the current date, which may have been unsupported by the installed runtime.
#4135 53218261 Thanks @Cherry! - feat: resolve npm exports for file imports
Previously, when using wasm (or other static files) from an npm package, you would have to import the file like so:
```
import wasm from "../../node_modules/svg2png-wasm/svg2png_wasm_bg.wasm";
```
This update now allows you to import the file like so, assuming it’s exposed and available in the package’s exports field:
```
import wasm from "svg2png-wasm/svg2png_wasm_bg.wasm";
```
This will look at the package’s exports field in package.json and resolve the file using resolve.exports.
#4232 69b43030 Thanks @romeupalos! - fix: use zone_name to determine a zone when the pattern is a custom hostname
In Cloudflare for SaaS, custom hostnames of third party domain owners can be used in Cloudflare. Workers are allowed to intercept these requests based on the routes configuration. Before this change, the same logic used by wrangler dev was used in wrangler deploy, which caused wrangler to fail with:
✘ [ERROR] Could not find zone for [partner-saas-domain.com]
#4198 b404ab70 Thanks @penalosa! - When uploading additional modules with your worker, Wrangler will now report the (uncompressed) size of each individual module, as well as the aggregate size of your Worker
#4215 950bc401 Thanks @RamIdeas! - fix various logging of shell commands to correctly quote args when needed
#4274 be0c6283 Thanks @jspspike! - chore: bump miniflare to 3.20231025.0
This change enables Node-like console.log()ing in local mode. Objects with lots of properties, and instances of internal classes like Request, Headers, ReadableStream, etc will now be logged with much more detail.
#4127 3d55f965 Thanks @mrbbot! - fix: store temporary files in .wrangler
As Wrangler builds your code, it writes intermediate files to a temporary directory that gets cleaned up on exit. Previously, Wrangler used the OS’s default temporary directory. On Windows, this is usually on the C: drive. If your source code was on a different drive, our bundling tool would generate invalid source maps, breaking breakpoint debugging. This change ensures intermediate files are always written to the same drive as sources. It also ensures unused build outputs are cleaned up when running wrangler pages dev.
This change also means you no longer need to set cwd and resolveSourceMapLocations in .vscode/launch.json when creating an attach configuration for breakpoint debugging. Your .vscode/launch.json should now look something like…
```
{	"configurations": [		{			"name": "Wrangler",			"type": "node",			"request": "attach",			"port": 9229,			// These can be omitted, but doing so causes silent errors in the runtime			"attachExistingChildren": false,			"autoAttachChildProcesses": false		}	]}
```
#4189 05798038 Thanks @gabivlj! - Move helper cli files of C3 into @cloudflare/cli and make Wrangler and C3 depend on it
#4235 46cd2df5 Thanks @mrbbot! - fix: ensure console.log()s during startup are displayed
Previously, console.log() calls before the Workers runtime was ready to receive requests wouldn’t be shown. This meant any logs in the global scope likely weren’t visible. This change ensures startup logs are shown. In particular, this should fix Remix’s HMR, which relies on startup logs to know when the Worker is ready.

2023-10-19

3.14.0

#4204 38fdbe9b Thanks @matthewdavidrodgers! - Support user limits for CPU time
User limits provided via script metadata on upload
Example configuration:
```
[limits]
cpu_ms = 20000
```
#2162 a1f212e6 Thanks @WalshyDev! - add support for service bindings in wrangler pages dev by providing the new --service|-s flag which accepts an array of BINDING_NAME=SCRIPT_NAME where BINDING_NAME is the name of the binding and SCRIPT_NAME is the name of the worker (as defined in its wrangler.toml), such workers need to be running locally with with wrangler dev.
For example if a user has a worker named worker-a, in order to locally bind to that they’ll need to open two different terminals, in each navigate to the respective worker/pages application and then run respectively wrangler dev and wrangler pages ./publicDir --service MY_SERVICE=worker-a this will add the MY_SERVICE binding to pages’ worker env object.
Note: additionally after the SCRIPT_NAME the name of an environment can be specified, prefixed by an @ (as in: MY_SERVICE=SCRIPT_NAME@PRODUCTION), this behavior is however experimental and not fully properly defined.

2023-10-17

3.13.2

#4206 8e927170 Thanks @1000hz! - chore: bump miniflare to 3.20231016.0
#4144 54800f6f Thanks @a-robinson! - Log a warning when using a Hyperdrive binding in local wrangler dev

2023-10-12

3.13.1

#4171 88f15f61 Thanks @penalosa! - patch: This release fixes some regressions related to running wrangler dev that were caused by internal refactoring of the dev server architecture ( #3960). The change has been reverted, and will be added back in a future release.

3.13.0

#4161 403bc25c Thanks @RamIdeas! - Fix wrangler generated types to match runtime exports
#3960 c36b78b4 Thanks @RamIdeas! - Refactoring the internals of wrangler dev servers (including wrangler dev, wrangler dev --remote and unstable_dev()).
There are no changes required for developers to opt-in. Improvements include:
- fewer ‘address in use’ errors upon reloads
- upon config/source file changes, requests are buffered to guarantee the response is from the new version of the Worker
#3590 f4ad634a Thanks @penalosa! - fix: When a middleware is configured which doesn’t support your Worker’s script format, fail early with a helpful error message

2023-10-11

3.12.0

#4071 f880a009 Thanks @matthewdavidrodgers! - Support TailEvent messages in Tail sessions
When tailing a tail worker, messages previously had a null event property. Following https://github.com/cloudflare/workerd/pull/1248, these events have a valid event, specifying which scripts produced events that caused your tail worker to run.
As part of rolling this out, we’re filtering out tail events in the internal tail infrastructure, so we control when these new messages are forward to tail sessions, and can merge this freely.
One idiosyncracy to note, however, is that tail workers always report an “OK” status, even if they run out of memory or throw. That is being tracked and worked on separately.
#2397 93833f04 Thanks @a-robinson! - feature: Support Queue consumer events in tail
So that it’s less confusing when tailing a worker that consumes events from a Queue.
#2687 3077016f Thanks @jrf0110! - Fixes large Pages projects failing to complete direct upload due to expiring JWTs
For projects which are slow to upload - either because of client bandwidth or large numbers of files and sizes - It’s possible for the JWT to expire multiple times. Since our network request concurrency is set to 3, it’s possible that each time the JWT expires we get 3 failed attempts. This can quickly exhaust our upload attempt count and cause the entire process to bail.
This change makes it such that jwt refreshes do not count as a failed upload attempt.
#4069 f4d28918 Thanks @a-robinson! - Default new Hyperdrive configs for PostgreSQL databases to port 5432 if the port is not specified

2023-10-05

3.11.0

#3726 7d20bdbd Thanks @petebacondarwin! - feat: support partial bundling with configurable external modules
Setting find_additional_modules to true in your configuration file will now instruct Wrangler to look for files in your base_dir that match your configured rules, and deploy them as unbundled, external modules with your Worker. base_dir defaults to the directory containing your main entrypoint.
Wrangler can operate in two modes: the default bundling mode and --no-bundle mode. In bundling mode, dynamic imports (e.g. await import("./large-dep.mjs")) would be bundled into your entrypoint, making lazy loading less effective. Additionally, variable dynamic imports (e.g. await import(`./lang/${language}.mjs`)) would always fail at runtime, as Wrangler would have no way of knowing which modules to upload. The --no-bundle mode sought to address these issues by disabling Wrangler’s bundling entirely, and just deploying code as is. Unfortunately, this also disabled Wrangler’s code transformations (e.g. TypeScript compilation, --assets, --test-scheduled, etc).
With this change, we now additionally support partial bundling. Files are bundled into a single Worker entry-point file unless find_additional_modules is true, and the file matches one of the configured rules. See https://developers.cloudflare.com/workers/wrangler/bundling/ for more details and examples.
#4093 c71d8a0f Thanks @mrbbot! - chore: bump miniflare to 3.20231002.0
#3726 7d20bdbd Thanks @petebacondarwin! - fix: ensure that additional modules appear in the out-dir
When using find_additional_modules (or no_bundle) we find files that will be uploaded to be deployed alongside the Worker.
Previously, if an outDir was specified, only the Worker code was output to this directory. Now all additional modules are also output there too.
#4067 31270711 Thanks @mrbbot! - fix: generate valid source maps with wrangler pages dev on macOS
On macOS, wrangler pages dev previously generated source maps with an incorrect number of ../s in relative paths. This change ensures paths are always correct, improving support for breakpoint debugging.
#4084 9a7559b6 Thanks @RamIdeas! - fix: respect the options.local value in unstable_dev (it was being ignored)
#4107 807ab931 Thanks @mrbbot! - chore: bump miniflare to 3.20231002.1
#3726 7d20bdbd Thanks @petebacondarwin! - fix: allow __STATIC_CONTENT_MANIFEST module to be imported anywhere
__STATIC_CONTENT_MANIFEST can now be imported in subdirectories when --no-bundle or find_additional_modules are enabled.
#3926 f585f695 Thanks @penalosa! - Log more detail about tokens after authentication errors
#3695 1d0b7ad5 Thanks @JacksonKearl! - Fixed pages dev crashing and leaving port open when building a worker script fails
#4066 c8b4a07f Thanks @RamIdeas! - fix: we no longer infer pathnames from route patterns as the host
During local development, inside your worker, the host of request.url is inferred from the routes in your config.
Previously, route patterns like “*/some/path/name” would infer the host as “some”. We now handle this case and determine we cannot infer a host from such patterns.

2023-09-28

3.10.1

#4041 6b1c327d Thanks @elithrar! - Fixed a bug in Vectorize that send preset configurations with the wrong key. This was patched on the server-side to work around this for users in the meantime.
#4054 f8c52b93 Thanks @mrbbot! - fix: allow wrangler pages dev sessions to be reloaded
Previously, wrangler pages dev attempted to send messages on a closed IPC channel when sources changed, resulting in an ERR_IPC_CHANNEL_CLOSED error. This change ensures the channel stays open until the user exits wrangler pages dev.

2023-09-26

3.10.0

#4013 3cd72862 Thanks @elithrar! - Adds wrangler support for Vectorize, Cloudflare’s new vector database, with wrangler vectorize. Visit the developer documentation (https://developers.cloudflare.com/vectorize/) to learn more and create your first vector database with wrangler vectorize create my-first-index.
#3999 ee6f3458 Thanks @OilyLime! - Adds support for Hyperdrive, via wrangler hyperdrive.
#4034 bde9d64a Thanks @ndisidore! - Adds Vectorize support uploading batches of newline delimited json (ndjson) vectors from a source file. Load a dataset with vectorize insert my-index --file vectors.ndjson
#4028 d5389731 Thanks @JacobMGEvans! - fix: Bulk Secret Draft Worker
Fixes the issue of a upload of a Secret when a Worker doesn’t exist yet, the draft worker is created and the secret is uploaded to it.
Fixes https://github.com/cloudflare/wrangler-action/issues/162

2023-09-25

3.9.1

#3992 35564741 Thanks @edevil! - Add AI binding that will be used to interact with the AI project.

Example wrangler.toml

name = "ai-worker"
main = "src/index.ts"

[ai]
binding = "AI"

Example script:

import Ai from "@cloudflare/ai"

export default {
    async fetch(request: Request, env: Env): Promise<Response> {
        const ai = new Ai(env.AI);

        const story = await ai.run({
            model: 'llama-2',
            input: {
                prompt: 'Tell me a story about the future of the Cloudflare dev platform'
            }
        });

    return new Response(JSON.stringify(story));
    },
};

export interface Env {
    AI: any;
}

#4006 bc8c147a Thanks @rozenmd! - fix: remove warning around using D1’s binding, and clean up the epilogue when running D1 commands
#4027 9e466599 Thanks @jspspike! - Add WebGPU support through miniflare update
#3986 00247a8d Thanks @edevil! - Added AI related CLI commands

2023-09-20

3.9.0

Note this release changes the layout of persisted data in the .wrangler folder. KV namespaces, R2 buckets and D1 databases will automatically be migrated to the new layout. See the corresponding miniflare@3.20230918.0 release notes for more information.

#3951 e0850ad1 Thanks @mrbbot! - feat: add support for breakpoint debugging to wrangler dev’s --remote and --no-bundle modes
Previously, breakpoint debugging using Wrangler’s DevTools was only supported in local mode, when using Wrangler’s built-in bundler. This change extends that to remote development, and --no-bundle.
When using --remote and --no-bundle together, uncaught errors will now be source-mapped when logged too.
#3951 e0850ad1 Thanks @mrbbot! - feat: add support for Visual Studio Code’s built-in breakpoint debugger
Wrangler now supports breakpoint debugging with Visual Studio Code’s debugger. Create a .vscode/launch.json file with the following contents…
```
{	"configurations": [		{			"name": "Wrangler",			"type": "node",			"request": "attach",			"port": 9229,			"cwd": "/",			"resolveSourceMapLocations": null,			"attachExistingChildren": false,			"autoAttachChildProcesses": false		}	]}
```
…then run wrangler dev, and launch the configuration.
#3954 bc88f0ec Thanks @dario-piotrowicz! - update wrangler pages dev D1 and DO descriptions
#3928 95b24b1e Thanks @JacobMGEvans! - Colorize Deployed Bundle Size Most bundlers, and other tooling that give you size outputs will colorize their the text to indicate if the value is within certain ranges. The current range values are: red 100% - 90% yellow 89% - 70% green <70%
resolves #1312

2023-09-13

3.8.0

#3775 3af30879 Thanks @bthwaites! - R2 Jurisdictional Restrictions guarantee objects in a bucket are stored within a specific jurisdiction. Wrangler now allows you to interact with buckets in a defined jurisdiction.
Wrangler R2 operations now support a -J flag that allows the user to specify a jurisdiction. When passing the -J flag, you will only be able to interact with R2 resources within that jurisdiction.
```
# List all of the buckets in the EU jurisdictionwrangler r2 bucket list -J eu# Downloads the object 'myfile.txt' from the bucket 'mybucket' in EU jurisdictionwrangler r2 object get mybucket/myfile.txt -J eu
```
To access R2 buckets that belong to a jurisdiction from Workers, you will need to specify the jurisdiction as well as the bucket name as part of your bindings in your wrangler.toml:
```
[[r2_buckets]]
bindings = [  { binding = "MY_BUCKET", bucket_name = "<YOUR_BUCKET_NAME>", jurisdiction = "<JURISDICTION>" }
]
```
#3901 a986f19f Thanks @DaniFoldi! - Only require preview_id and preview_bucket_name in remote dev mode
#3912 0ba58841 Thanks @jspspike! - Ignore cached account id when CLOUDFLARE_ACCOUNT_ID is specified

2023-09-05

3.7.0

#3772 a3b3765d Thanks @jspspike! - Bump esbuild version to 0.17.19. Breaking changes to esbuild are documented here
#3895 40f56562 Thanks @mrbbot! - chore: bump miniflare to 3.20230904.0
#3774 ae2d5cb5 Thanks @mrbbot! - feat: support breakpoint debugging in local mode
wrangler dev now supports breakpoint debugging in local mode! Press d to open DevTools and set breakpoints.

2023-08-28

2.20.1

#3820 546c2319 Thanks @GregBrimble! - fix: Prevent wrangler pages dev from serving asset files outside of the build output directory

2023-08-24

3.6.0

#3727 a5e7c0be Thanks @echen67! - Warn user when the last deployment was via the API
#3762 18dc7b54 Thanks @GregBrimble! - feat: Add internal wrangler pages project validate [directory] command which validates an asset directory
#3758 0adccc71 Thanks @jahands! - fix: Retry deployment errors in wrangler pages publish
This will improve reliability when deploying to Cloudflare Pages

Wrangler Changelog

​​ 2023-10-26

​​ 3.15.0

​​ 2023-10-19

​​ 3.14.0

​​ 2023-10-17

​​ 3.13.2

​​ 2023-10-12

​​ 3.13.1

​​ 3.13.0

​​ 2023-10-11

​​ 3.12.0

​​ 2023-10-05

​​ 3.11.0

​​ 2023-09-28

​​ 3.10.1

​​ 2023-09-26

​​ 3.10.0

​​ 2023-09-25

​​ 3.9.1

​​ 2023-09-20

​​ 3.9.0

​​ 2023-09-13

​​ 3.8.0

​​ 2023-09-05

​​ 3.7.0

​​ 2023-08-28

​​ 2.20.1

​​ 2023-08-24

​​ 3.6.0