Wrangler · Wrangler

3.14.0

Thursday, Oct 19, 2023

#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.

3.13.2

Tuesday, Oct 17, 2023

#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

3.13.1

Thursday, Oct 12, 2023

#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

Thursday, Oct 12, 2023

#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

3.12.0

Wednesday, Oct 11, 2023

#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

3.11.0

Thursday, Oct 5, 2023

#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.

3.10.1

Thursday, Sep 28, 2023

#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.

3.10.0

Tuesday, Sep 26, 2023

#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

3.9.1

Monday, Sep 25, 2023

#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 {
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

3.9.0

Wednesday, Sep 20, 2023

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…

…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

3.8.0

Wednesday, Sep 13, 2023

#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.

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:
#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

3.7.0

Tuesday, Sep 5, 2023

#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.

2.20.1

Monday, Aug 28, 2023

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

3.6.0

Thursday, Aug 24, 2023

#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

3.5.1

Tuesday, Aug 15, 2023

#3752 8f5ed7fe Thanks @DaniFoldi! - Changed the binding type of WfP Dispatch Namespaces to DispatchNamespace
#3765 e17d3096 Thanks @RamIdeas! - bump miniflare version to 3.20230814.1