Change8

miniflare@5.20260828.0-alpha

📦 cloudflare-workersView on GitHub →
4 features🐛 1 fixes🔧 7 symbols

Summary

This release enhances local development with new features for email handling and image uploads/delivery. It also includes a renaming of worker target fields for consistency and dependency updates.

Migration Steps

  1. Rename Worker target fields from `workerName` to `worker` in `@cloudflare/config` and Miniflare configuration.

✨ New Features

  • Add email inspection and testing to Local Explorer, including Routing and Sending views for inspecting messages received by a Worker's `email()` handler and messages sent through its `send_email` bindings. Detail views show message content, metadata, attachments, and handler activity. A test-email composer allows delivering custom messages directly to the selected Worker's `email()` handler during local development.
  • Support `env.IMAGES.hosted.createDirectUpload()` in local development, creating a draft image and returning an `uploadURL` served by a new local endpoint that accepts the completed upload as `multipart/form-data`. This matches production's validation and semantics.
  • Support the `filter.metadata` option on `env.IMAGES.hosted.list()` in local development, matching the metadata filtering behaviour of the production Images binding. Filters support various operators and nested field paths.
  • Support `env.IMAGES.hosted.image(id).signedUrl()` in local development using a fixed local-dev signing secret to generate and verify signed delivery URLs, matching production's signed URL behaviour.

🐛 Bug Fixes

  • Validate custom headers sent through the Local Explorer test-email endpoint, rejecting header names and values that cannot be safely encoded. Multiline values are supported and folded into valid MIME continuation lines.

Affected Symbols