miniflare@4.20260430.0
Breaking Changes📦 cloudflare-workersView on GitHub →
⚠ 2 breaking✨ 4 features🐛 3 fixes🔧 6 symbols
Summary
This release enforces a minimum Node.js version of 22, introduces local restart support for Workflows, and fixes several local development issues related to Hyperdrive connections and data serialization.
⚠️ Breaking Changes
- Wrangler now requires Node.js version 22.0.0 or higher. Users on Node.js 20.x or older will experience failures.
- If you are using Hyperdrive bindings locally with `wrangler dev` and SSL is disabled, the connection method has changed to direct database connection instead of using a local TCP proxy server. This may resolve connection refused errors but could expose different network issues if firewall rules were previously bypassed by the proxy.
Migration Steps
- Ensure your Node.js environment is running version 22.0.0 or newer.
- If you rely on local Hyperdrive connections without SSL, monitor connections as the local TCP proxy is now skipped in favor of direct connection.
- When restarting workflows locally, use the new optional parameter in `WorkflowInstance.restart()` to specify the starting step.
✨ New Features
- Added support for restarting local Workflow development from a specific step using the optional `{ from: { name, count?, type? } }` parameter in the `WorkflowInstance.restart()` method.
- Support for V2 protocol for module fallback service when the `new_module_registry` compatibility flag is set.
- Exported a `parseModuleFallbackRequest()` utility to help handle the V2 protocol for module fallback requests.
- Exposed `send_email` bindings from `getPlatformProxy()` for local Node.js development, supporting the plain-object MessageBuilder API.
🐛 Bug Fixes
- Fixed an issue where Hyperdrive bindings could fail to connect to local databases during `wrangler dev` due to local TCP proxy server creation being skipped when SSL was not enabled.
- Fixed serialization issue where Node.js `Buffer` (a subclass of `Uint8Array`) caused failures in the proxy serialization bridge; the reducer now normalizes subclass constructor names to their nearest standard typed array parent.
- Fixed Miniflare asset services failing to start when the configured `assets.directory` did not exist on disk by creating a temporary empty directory until the real directory is created.