cloudflare/workers-sdk miniflare@5.20260804.0-alpha

on GitHub

Major Changes

• #14994 2194f88 Thanks @emily-shen! - Replace Miniflare's options API with Cloudflare config-based worker options

  new Miniflare() and setOptions() now require a workers array of worker entries. Binding, service, tail, remote, asset, workflow, unsafe binding, and other worker configuration now follows the schemas in packages/miniflare/src/config/schema.ts.

  The previous flat options shape is no longer accepted directly. Existing v4-shaped options can be migrated with convertV4MiniflareOptions().

• #14994 2194f88 Thanks @emily-shen! - Change the Miniflare plugin API

  Plugins now receive parsed Miniflare worker and instance config instead of per-plugin option slices. Per-plugin option schema exports have been removed; unsafe plugin authors should read bindings, exports, and triggers from the parsed config passed to plugin hooks.

• #14994 2194f88 Thanks @emily-shen! - Remove automatic module graph discovery

  Miniflare no longer discovers Worker modules from modules: true and modulesRules. Module workers must provide their module graph through the config manifest. Existing v4-shaped options can be migrated with convertV4MiniflareOptions(), but modulesRules cannot be converted without losing behavior.

• #14994 2194f88 Thanks @emily-shen! - Remove internal or redundant options from Miniflare's config

  Miniflare no longer accepts service designator objects such as { network }, { external }, and { disk } on outboundService, tails, or streamingTails.

  Miniflare also no longer supports unsafeExcludeFromObservability, which has been dropped in favour of unsafeRegisterWorker.

• #14994 2194f88 Thanks @emily-shen! - Remove support for legacy alpha D1 (__D1_BETA__) bindings

  Miniflare no longer supports deprecated beta D1 instances created before wrangler@3.3.0.

Minor Changes

• #14994 2194f88 Thanks @emily-shen! - Add convertV4MiniflareOptions for migrating Miniflare v4 options

  You can now convert v4-shaped Miniflare options to the config-based workers shape before creating or updating a Miniflare instance. Some v4 options cannot be converted without losing behavior and will throw an error instead.

Patch Changes

• #15072 6dbd192 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"

  The following dependency versions have been updated:

  Dependency	From	To
  @cloudflare/workers-types	^5.20260801.1	^5.20260804.1
  workerd	1.20260801.1	1.20260804.1