[vitest-pool-workers] Preserve deprecated Miniflare cache option

[edmundhung]

Preserves the deprecated Miniflare cache worker option in @cloudflare/vitest-pool-workers while Miniflare v5 renames it to cacheAPI.

The pool normalizes worker options before Miniflare schema parsing, for both the test runner and auxiliary workers. cacheAPI takes precedence when both names are provided. The legacy cache field remains typed with a deprecation annotation so existing configurations continue to compile.

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: This preserves an existing option during an internal dependency upgrade and marks the replacement in the public type.

A picture of a cute animal (not mandatory, but encouraged)

---

[changeset-bot]

🦋 Changeset detected

Latest commit: b231e27

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@cloudflare/vitest-pool-workers	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

✅ All changesets look good

[ask-bonk]

No other references. The implementation is coherent and correct.

Let me summarize my findings:

The core logic is correct:

• cacheAPI ?? cache precedence is properly implemented (cacheAPI wins).
• Both runner and auxiliary workers pass through parseWorkerOptions → normalizeMiniflareWorkerOptions.
• Type annotations are sound.
• Semantics match Miniflare v5's cacheAPI ?? true.

Minor observations (not bugs, not actionable):

• No runtime deprecation warning when cache is used (only JSDoc @deprecated).
• Tests don't cover the auxiliary-workers path even though the PR claims it, but the code path is shared.
• cacheWarnUsage (removed in v5) isn't handled, but that's out of scope for this PR.

None of these rise to the level of a logic bug, security issue, backward-compat violation, or incorrect API behavior. The one behavioral edge — cache: undefined with no cacheAPI → cacheAPI: undefined → defaults to enabled — is correct and matches prior behavior.

There are no actionable issues.

LGTM

github run

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[pkg-pr-new]

@cloudflare/autoconfig

npm i https://pkg.pr.new/@cloudflare/autoconfig@14913

@cloudflare/config

npm i https://pkg.pr.new/@cloudflare/config@14913

create-cloudflare

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

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@14913

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-pool-workers

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

@cloudflare/workers-auth

npm i https://pkg.pr.new/@cloudflare/workers-auth@14913

@cloudflare/workers-editor-shared

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

@cloudflare/workers-utils

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

wrangler

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

commit: b231e27