Change8

miniflare@4.20260424.0

📦 cloudflare-workersView on GitHub →
5 features🐛 2 fixes🔧 11 symbols

Summary

This release introduces local video serving capabilities, stable stream preview URLs via `publicUrl`, and fixes reliability issues with the dev registry watcher on Windows. Caption uploads via ReadableStream are also now supported locally.

Migration Steps

  1. If you rely on the dev registry watcher behavior on Windows, note that it now uses polling mode for reliability.
  2. If you are using the dev registry and encounter issues on Windows related to worker registration timing, ensure your setup is compatible with polling watchers.

✨ New Features

  • Support serving videos locally, where they are served at /cdn-cgi/mf/stream/<video-id>/watch.
  • Added `publicUrl` option for `MiniflareOptions` to provide stable, externally-reachable stream preview URLs.
  • The `preview` field in `StreamVideo` is now directly fetchable during development.
  • Exported helper functions `buildPublicUrl` and `getLocallyAccessibleHost` from `miniflare` to correctly construct client-reachable URLs handling IPv6 bracketing and wildcard listen addresses.
  • Caption uploads via `ReadableStream` are now supported in local mode, resolving previous errors.

🐛 Bug Fixes

  • Preserve NonRetryableError message and name when the `workflows_preserve_non_retryable_error_message` compatibility flag is enabled, instead of replacing it with a generic error message.
  • Made the dev registry watcher reliable on Windows by switching to chokidar's polling mode (100ms interval) to reliably observe cross-process worker registrations, fixing dropped/delayed create events.

Affected Symbols