Version Packages by workers-devprod · Pull Request #11700 · cloudflare/workers-sdk

workers-devprod · 2025-12-18T14:13:24Z

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

create-cloudflare@2.62.0

Minor Changes

#11549 d059f69 Thanks @dario-piotrowicz! - Support Vike in --experimental mode
#11692 df1f9c9 Thanks @dario-piotrowicz! - Support Waku in --experimental mode

Patch Changes

#11812 faf8d27 Thanks @dario-piotrowicz! - Remove redundant output present for the experimental setup of frameworks (by using new CLI flags of wrangler setup).

miniflare@4.20260103.0

Minor Changes

#11648 eac5cf7 Thanks @pombosilva! - Add Workflows test handlers in vitest-pool-workers to get the Workflow instance output and error:

getOutput(): Returns the output of the successfully completed Workflow instance.
getError(): Returns the error information of the errored Workflow instance.

Example:

// First wait for the workflow instance to complete:
await expect(
	instance.waitForStatus({ status: "complete" })
).resolves.not.toThrow();

// Then, get its output
const output = await instance.getOutput();

// Or for errored workflow instances, get their error:
await expect(
	instance.waitForStatus({ status: "errored" })
).resolves.not.toThrow();
const error = await instance.getError();

Patch Changes

#11714 65d1850 Thanks @dependabot! - chore: update dependencies of "miniflare" package

The following dependency versions have been updated:

Dependency From To

workerd 1.20251217.0 1.20251219.0
#11732 1615fce Thanks @dependabot! - chore: update dependencies of "miniflare" package

The following dependency versions have been updated:

Dependency From To

workerd 1.20251219.0 1.20251221.0
#11748 b2769bf Thanks @dependabot! - chore: update dependencies of "miniflare" package

The following dependency versions have been updated:

Dependency From To

workerd 1.20251221.0 1.20251223.0
#11791 554a4df Thanks @dependabot! - chore: update dependencies of "miniflare" package

The following dependency versions have been updated:

Dependency From To

workerd 1.20251223.0 1.20260103.0
#11642 8eede3f Thanks @petebacondarwin! - Fix intermittent "Fetch failed" errors in Miniflare tests on Windows

Miniflare tests would occasionally fail with "Fetch failed" errors (particularly on Windows CI runners) due to race conditions between undici's Keep-Alive mechanism and the Miniflare server closing idle connections. Miniflare now configures the Dispatcher to prevent connection reuse and eliminate these race condition errors.
#11493 6a05b1c Thanks @GameRoMan! - Update zod from 3.22.3 to 3.25.76

@cloudflare/unenv-preset@2.8.0

Minor Changes

#11733 62fd118 Thanks @petebacondarwin! - Add support for native node:inspector module when the enable_nodejs_inspector_module compatibility flag is enabled. This feature is currently experimental and requires both the enable_nodejs_inspector_module and experimental compatibility flags to be set.

To enable the native inspector module, add the following to your wrangler.jsonc:
```
{
	"compatibility_flags": ["experimental", "enable_nodejs_inspector_module"],
}
```
Then you can import and use the inspector module in your Worker:
```
import inspector from "node:inspector";

// Access inspector APIs (note: workerd's implementation is a non-functional stub)
inspector.url(); // returns undefined
inspector.close(); // no-op
```
#11744 a7e9f80 Thanks @petebacondarwin! - Add support for native node:inspector/promises module when the enable_nodejs_inspector_module compatibility flag is enabled. This extends the existing node:inspector support to include the promises-based API.

To enable the native inspector/promises module, add the following to your wrangler.jsonc:
```
{
	"compatibility_flags": ["experimental", "enable_nodejs_inspector_module"],
}
```
Then you can import and use the inspector/promises module in your Worker:
```
import inspector from "node:inspector/promises";

// Access inspector APIs (note: workerd's implementation is a non-functional stub)
inspector.url(); // returns undefined
inspector.close(); // no-op
```

@cloudflare/vite-plugin@1.20.0

Minor Changes

#11620 25f6672 Thanks @dario-piotrowicz! - Expose a new getLocalWorkerdCompatibilityDate utility that allows callers to get the compatibility date of the locally installed workerd package.
#11723 3455912 Thanks @jamesopstad! - Add a post buildApp hook that builds Worker environments that haven't already been built.

This ensures that auxiliary Workers are included in the build when using full-stack frameworks that define their own builder.buildApp function. Note that this feature is not supported with Vite 6 as the buildApp hook was introduced in Vite 7.
#11738 c54f8da Thanks @jamesopstad! - Add default Text module rule for .sql files.

This enables importing .sql files directly in Wrangler and the Cloudflare Vite plugin without extra configuration.

Patch Changes

#11815 70ef3ed Thanks @jamesopstad! - Set ignoreOutdatedRequests to true in optimizeDeps config.

This is a workaround for Optimizer behaviour change leading to errors vitejs/vite#20867 and will resolve Error: There is a new version of the pre-bundle for ... errors that some users are experiencing. The longer term solution is to use full-bundle mode rather than optimizeDeps once it is supported for server environments. Vite v7.3.1 or above is needed for this change to take effect.
#11735 dd66dcd Thanks @jamesopstad! - Remove topLevelName and name when passing entryWorkerConfig to the config function for auxiliary Workers.

The name for each Worker should be unique and the topLevelName is computed rather than provided directly.
#11720 0457de6 Thanks @jamesopstad! - fix: regression where plain class and object types were no longer supported as Durable Objects and Worker entrypoints
Updated dependencies [02fbd22, b993d95, f612b46, 77078ef, 2510723, 65d1850, 1615fce, b2769bf, 554a4df, 9f6dd71, 8eede3f, d123ad0, 9e360f6, 5121b23, 82e7e90, 6a05b1c, 62fd118, a7e9f80, fc95831, b0dbf1a, 4688f59, 69979a3, c54f8da, df1f9c9, d059f69, eac5cf7, b827893]:
- wrangler@4.57.0
- miniflare@4.20260103.0
- @cloudflare/unenv-preset@2.8.0

@cloudflare/vitest-pool-workers@0.12.0

Minor Changes

#11648 eac5cf7 Thanks @pombosilva! - Add Workflows test handlers in vitest-pool-workers to get the Workflow instance output and error:

getOutput(): Returns the output of the successfully completed Workflow instance.
getError(): Returns the error information of the errored Workflow instance.

Example:

// First wait for the workflow instance to complete:
await expect(
	instance.waitForStatus({ status: "complete" })
).resolves.not.toThrow();

// Then, get its output
const output = await instance.getOutput();

// Or for errored workflow instances, get their error:
await expect(
	instance.waitForStatus({ status: "errored" })
).resolves.not.toThrow();
const error = await instance.getError();

Patch Changes

#11681 1223663 Thanks @ascorbic! - Fix vitest-pool-workers hanging when the default inspector port (9229) is already in use. When debugging is enabled and the default port is unavailable, the pool now automatically finds the next available port. If a user explicitly specifies an inspector port that is unavailable, an error is thrown with a clear message.
Updated dependencies [02fbd22, b993d95, f612b46, 77078ef, 2510723, 65d1850, 1615fce, b2769bf, 554a4df, 9f6dd71, 8eede3f, d123ad0, 9e360f6, 5121b23, 82e7e90, 6a05b1c, fc95831, b0dbf1a, 4688f59, 69979a3, c54f8da, df1f9c9, d059f69, eac5cf7, b827893]:
- wrangler@4.57.0
- miniflare@4.20260103.0

@cloudflare/workers-utils@0.6.0

Minor Changes

#11702 f612b46 Thanks @gpanders! - Add support for trusted_user_ca_keys in Wrangler

You can now configure SSH trusted user CA keys for containers. Add the following to your wrangler.toml:
```
[[containers.trusted_user_ca_keys]]
public_key = "ssh-ed25519 AAAAC3..."
```
This allows you to specify CA public keys that can be used to verify SSH user certificates.
#11620 25f6672 Thanks @dario-piotrowicz! - Expose a new getLocalWorkerdCompatibilityDate utility that allows callers to get the compatibility date of the locally installed workerd package.
#11616 fc95831 Thanks @NuroDev! - Add type generation support to wrangler dev

You can now have your worker configuration types be automatically generated when the local Wrangler development server starts.

To use it you can either:
1. Add the --types flag when running wrangler dev.
2. Update your Wrangler configuration file to add the new dev.generate_types boolean property.
```
{
	"$schema": "node_modules/wrangler/config-schema.json",
	"name": "example",
	"main": "src/index.ts",
	"compatibility_date": "2025-12-12",
	"dev": {
		"generate_types": true
	}
}
```
#11620 25f6672 Thanks @dario-piotrowicz! - Expose new isCompatDate utility that discerns whether a string represents a compatibility date or not

Patch Changes

#11737 2cfea12 Thanks @NuroDev! - Fix the triggers JSON schema default value to use valid JSON ({"crons":[]}) instead of an invalid JavaScript literal, which was causing IDE auto-completion to insert a string rather than an object.
#11651 d123ad0 Thanks @dario-piotrowicz! - Surface error in diagnostics when TOML date/time values are used in vars

TOML parses unquoted date/time values like DATE = 2024-01-01 as TOML Date, Date-Time, and Time values. The config validation now surfaces an error in the diagnostics result when this type of values are encountered, with a clear message telling you to quote the value as a string, e.g. DATE = "2024-01-01".
#11693 385ec7f Thanks @vicb! - Update the signature of ParseTOML to drop the Generics.

Use an explicit cast where required.

wrangler@4.57.0

Minor Changes

#11682 b993d95 Thanks @ascorbic! - Add wrangler auth token command to retrieve your current authentication credentials.

You can now retrieve your authentication token for use with other tools and scripts:
```
wrangler auth token
```
The command returns whichever authentication method is currently configured:
- OAuth token from wrangler login (automatically refreshed if expired)
- API token from CLOUDFLARE_API_TOKEN environment variable
Use --json to get structured output including the token type, which also supports API key/email authentication:
```
wrangler auth token --json
```
This is similar to gh auth token in the GitHub CLI.
#11702 f612b46 Thanks @gpanders! - Add support for trusted_user_ca_keys in Wrangler

You can now configure SSH trusted user CA keys for containers. Add the following to your wrangler.toml:
```
[[containers.trusted_user_ca_keys]]
public_key = "ssh-ed25519 AAAAC3..."
```
This allows you to specify CA public keys that can be used to verify SSH user certificates.
#11437 9e360f6 Thanks @ichernetsky-cf! - Drop deprecated containers observability.logging field
#11616 fc95831 Thanks @NuroDev! - Add type generation support to wrangler dev

You can now have your worker configuration types be automatically generated when the local Wrangler development server starts.

To use it you can either:
1. Add the --types flag when running wrangler dev.
2. Update your Wrangler configuration file to add the new dev.generate_types boolean property.
```
{
	"$schema": "node_modules/wrangler/config-schema.json",
	"name": "example",
	"main": "src/index.ts",
	"compatibility_date": "2025-12-12",
	"dev": {
		"generate_types": true
	}
}
```
#11524 b0dbf1a Thanks @penalosa! - Add hidden CLI flags to wrangler setup for suppressing output

Two new hidden flags have been added to wrangler setup:
- --no-completion-message: Suppresses the deployment details message after setup completes
- --no-install-wrangler: Skips Wrangler installation during project setup
#11777 69979a3 Thanks @MattieTK! - Add analytics properties to secret commands for better usage insights

Secret commands (wrangler secret put, wrangler secret bulk, and their Pages/versions equivalents) now include additional analytics properties to help understand how secrets are being managed:
- secretOperation: Whether this is a "single" or "bulk" secret operation
- secretSource: How the secret was provided ("interactive", "stdin", or "file")
- secretFormat: For bulk operations, the format used ("json" or "dotenv")
- hasEnvironment: Whether an environment was specified
These properties help improve the developer experience by understanding common usage patterns. No sensitive information (secret names, values, or counts) is tracked.
#11738 c54f8da Thanks @jamesopstad! - Add default Text module rule for .sql files.

This enables importing .sql files directly in Wrangler and the Cloudflare Vite plugin without extra configuration.
#11692 df1f9c9 Thanks @dario-piotrowicz! - Support Waku in autoconfig
#11549 d059f69 Thanks @dario-piotrowicz! - Support Vike in autoconfig

Patch Changes

#11683 02fbd22 Thanks @ascorbic! - Display a warning when authentication errors occur and the account_id in your Wrangler configuration does not match any of your authenticated accounts. This helps identify configuration issues where you may have the wrong account ID set in your wrangler.toml or wrangler.jsonc file.
#11704 77078ef Thanks @dario-piotrowicz! - Fix autoconfig handling of Next.js apps with CJS config files and incompatible Next.js versions

Previously, wrangler setup and wrangler deploy --x-autoconfig would fail when working with Next.js applications that use CommonJS config files (next.config.cjs) or have versions of Next.js that don't match the required peer dependencies. The autoconfig process now uses dynamic imports and forced installation to handle these scenarios gracefully.
#11796 2510723 Thanks @dario-piotrowicz! - wrangler deploy delegates to opennextjs-cloudflare deploy only when the --x-autoconfig flag is used

The wrangler deploy command has been updated to delegate to the opennextjs-cloudflare deploy command when run in an open-next project. Once this behavior had been introduced it caused a few issues. So it's been decided to enable it for the time being only when the --x-autoconfig flag is set (since this behavior, although generally valid, is only strictly necessary for the wrangler deploy's autoconfig flow).
#11764 9f6dd71 Thanks @terakoya76! - Fix R2 Data Catalog snapshot-expiration API field names

The wrangler r2 bucket catalog snapshot-expiration enable command was sending incorrect field names
to the Cloudflare API, resulting in a 422 Unprocessable Entity error. This fix updates the API request
body to use the correct field names:
- olderThanDays -> max_snapshot_age (as duration string, e.g., "30d")
- retainLast -> min_snapshots_to_keep
The CLI options (--older-than-days and --retain-last) remain unchanged.
#11651 d123ad0 Thanks @dario-piotrowicz! - Surface a more helpful error message for TOML Date, Date-Time, and Time values in vars

TOML parses unquoted date/time values like DATE = 2024-01-01 as objects. Previously this would cause an unhelpful error message further down the stack. Now wrangler surfaces a more helpful error message earlier, telling you to quote the value as a string, e.g. DATE = "2024-01-01".
#11711 5121b23 Thanks @southpolesteve! - Show an error when D1 migration commands are run without a configuration file

Previously, running wrangler d1 migrations apply, wrangler d1 migrations list, or wrangler d1 migrations create in a directory without a Wrangler configuration file would silently exit with no feedback. Now these commands display a clear error message:

"No configuration file found. Create a wrangler.jsonc file to define your D1 database."
#11710 82e7e90 Thanks @dario-piotrowicz! - Fix arguments passed to wrangler deploy not being forwarded to opennextjs-cloudflare deploy

wrangler deploy run in an open-next project delegates to opennextjs-cloudflare deploy, as part of this all the arguments passed to wrangler deploy need be forwarded to opennextjs-cloudflare deploy, before the arguments would be lost, now they will be successfully forwarded (for example wrangler deploy --keep-vars will call opennextjs-cloudflare deploy --keep-vars)
#10750 4688f59 Thanks @jacoblearned! - Notify user on local dev server reload.

When running wrangler dev, the local server suppresses Miniflare's reload messages to prevent duplicate log entries from the proxy and user workers. This update adds a reload complete message so users know their changes were applied, instead of only seeing "Reloading local server...".
#11673 b827893 Thanks @MattieTK! - Breaks out version numbers into sortable number types for analytics logging
Updated dependencies [65d1850, 1615fce, b2769bf, 554a4df, 8eede3f, 6a05b1c, 62fd118, a7e9f80, eac5cf7]:
- miniflare@4.20260103.0
- @cloudflare/unenv-preset@2.8.0

@cloudflare/pages-shared@0.13.96

Patch Changes

Updated dependencies [65d1850, 1615fce, b2769bf, 554a4df, 8eede3f, 6a05b1c, eac5cf7]:
- miniflare@4.20260103.0

@cloudflare/containers-shared@0.7.0

Minor Changes

#11702 f612b46 Thanks @gpanders! - Add support for trusted_user_ca_keys in Wrangler

You can now configure SSH trusted user CA keys for containers. Add the following to your wrangler.toml:
```
[[containers.trusted_user_ca_keys]]
public_key = "ssh-ed25519 AAAAC3..."
```
This allows you to specify CA public keys that can be used to verify SSH user certificates.
#11437 9e360f6 Thanks @ichernetsky-cf! - Drop deprecated containers observability.logging field

Patch Changes

#11768 2a4299d Thanks @gpanders! - Rename "durable_objects_active" field in ApplicationHealthInstances to "active"

@cloudflare/workflows-shared@0.4.0

Minor Changes

#11648 eac5cf7 Thanks @pombosilva! - Add Workflows test handlers in vitest-pool-workers to get the Workflow instance output and error:

getOutput(): Returns the output of the successfully completed Workflow instance.
getError(): Returns the error information of the errored Workflow instance.

Example:

// First wait for the workflow instance to complete:
await expect(
	instance.waitForStatus({ status: "complete" })
).resolves.not.toThrow();

// Then, get its output
const output = await instance.getOutput();

// Or for errored workflow instances, get their error:
await expect(
	instance.waitForStatus({ status: "errored" })
).resolves.not.toThrow();
const error = await instance.getError();

claude · 2025-12-18T14:13:49Z

Claude finished @workers-devprod's task —— View job

Changeset Review

Read changeset guidelines
Review deleted changeset files
Validate version types and changelog quality
Provide final assessment

⚠️ Issues found

I reviewed all 17 changesets against the guidelines in .changeset/README.md. Most changesets follow the guidelines well, but there are some issues:

Blocking Issues

1. Insufficient documentation for minor features

The following changesets are marked as minor (new features) but lack usage examples or sufficient context:

big-crabs-agree.md (create-cloudflare): "Support Vike in --experimental mode"
chilly-camels-serve.md (create-cloudflare): "Support Waku in --experimental mode"
tall-jobs-taste.md (wrangler): "Support Waku in autoconfig"
tiny-tires-write.md (wrangler): "Support Vike in autoconfig"

Per the guidelines: "For new features or significant changes, include a brief usage example. This helps users understand how to use the new functionality."

These should include at least a basic example of how users can use Vike/Waku support (e.g., what command to run, what gets configured).

Non-blocking Concerns

2. Questionable version type

young-crews-learn.md (wrangler minor): "Breaks out version numbers into sortable number types for analytics logging"

This sounds like an internal implementation detail for analytics rather than a user-facing feature. The guidelines suggest that internal refactoring without user-facing impact doesn't require a changeset. If this truly has no user-facing impact, it should either:

Be a patch instead of minor, or
Not require a changeset at all

What looks good ✓

No h1/h2/h3 headers found in any changesets
No major version bumps for wrangler (correctly avoided)
Most patch changesets have clear descriptions
Minor features with examples (auth-token-command.md, plain-beds-spend.md) follow best practices
Version types generally appropriate for the changes

pkg-pr-new · 2025-12-18T14:19:33Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@11700

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@11700

miniflare

npm i https://pkg.pr.new/miniflare@11700

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@11700

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@11700

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@11700

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@11700

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@11700

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@11700

wrangler

npm i https://pkg.pr.new/wrangler@11700

commit: 57833dd

workers-devprod requested review from a team as code owners December 18, 2025 14:13

workers-devprod force-pushed the changeset-release/main branch from 9a3033c to eb7afae Compare December 18, 2025 14:15

workers-devprod force-pushed the changeset-release/main branch 25 times, most recently from 9f91ebd to 35facc3 Compare December 22, 2025 19:19

workers-devprod force-pushed the changeset-release/main branch 6 times, most recently from fec54df to 76a6b03 Compare December 23, 2025 18:42

workers-devprod force-pushed the changeset-release/main branch 11 times, most recently from 1949c6f to f05d3ec Compare January 5, 2026 22:20

dario-piotrowicz approved these changes Jan 6, 2026

View reviewed changes

devin-ai-integration Bot mentioned this pull request Jan 6, 2026

ci: fix changeset review for Version Packages PRs #11806

Merged

8 tasks

workers-devprod force-pushed the changeset-release/main branch from f05d3ec to 8c60ed8 Compare January 6, 2026 18:30

lrapoport-cf approved these changes Jan 6, 2026

View reviewed changes

workers-devprod force-pushed the changeset-release/main branch 4 times, most recently from 67b181c to 9007ac3 Compare January 7, 2026 10:51

Version Packages

57833dd

workers-devprod force-pushed the changeset-release/main branch from 9007ac3 to 57833dd Compare January 7, 2026 11:04

petebacondarwin approved these changes Jan 7, 2026

View reviewed changes

dario-piotrowicz merged commit f978609 into main Jan 7, 2026
36 checks passed

dario-piotrowicz deleted the changeset-release/main branch January 7, 2026 11:44

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Version Packages#11700

Version Packages#11700
dario-piotrowicz merged 1 commit intomainfrom
changeset-release/main

workers-devprod commented Dec 18, 2025 •

edited

Loading

Uh oh!

claude Bot commented Dec 18, 2025 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Dec 18, 2025 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

workers-devprod commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Releases

create-cloudflare@2.62.0

Minor Changes

Patch Changes

miniflare@4.20260103.0

Minor Changes

Patch Changes

@cloudflare/unenv-preset@2.8.0

Minor Changes

@cloudflare/vite-plugin@1.20.0

Minor Changes

Patch Changes

@cloudflare/vitest-pool-workers@0.12.0

Minor Changes

Patch Changes

@cloudflare/workers-utils@0.6.0

Minor Changes

Patch Changes

wrangler@4.57.0

Minor Changes

Patch Changes

@cloudflare/pages-shared@0.13.96

Patch Changes

@cloudflare/containers-shared@0.7.0

Minor Changes

Patch Changes

@cloudflare/workflows-shared@0.4.0

Minor Changes

Uh oh!

claude Bot commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changeset Review

Blocking Issues

Non-blocking Concerns

What looks good ✓

Uh oh!

pkg-pr-new Bot commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

workers-devprod commented Dec 18, 2025 •

edited

Loading

claude Bot commented Dec 18, 2025 •

edited

Loading

pkg-pr-new Bot commented Dec 18, 2025 •

edited

Loading