MQ-1273: Add metadata with metrics to queue broker response in miniflare

[KennethRuan]

Fixes https://jira.cfdata.org/browse/MQ-1273.

These changes keep the Miniflare Queues implementation up to date with its production counterpart.

There are currently changes in workerd that are gated behind an experimental flag (See PRs for MQ-1154, MQ-1200, MQ-1202). When those features are ungated,miniflare changes will need to be up to date so that local development with wrangler dev will match intended behaviour.

This PR adds an adapted implementation of metrics that simulates the production experience.

---

• Tests
  • Tests included/updated
  • Manual testing has been completed as follows:
    • Built and ran code locally against the experimental and non-experimental versions of workers
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: New response types will be exposed through worker types when the experimental flag is removed on workerd
    • Docs PR for Javascript API

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

---

[changeset-bot]

🦋 Changeset detected

Latest commit: c22ddbf

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

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

[workers-devprod]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers

[github-actions]

Changeset Review

Summary

✅ All changesets look good

Reviewed Changesets

File	Package(s)	Version	Status
queue-broker-metrics-response.md	miniflare	patch	✅ Valid
fix-ai-search-remote-bindings.md	wrangler	patch	✅ Valid
eleven-wolves-cry.md	@cloudflare/local-explorer-ui, miniflare	minor	✅ Valid (experimental feature noted)
animated-cloudflare-logo.md	@cloudflare/local-explorer-ui	minor	✅ Valid
step-context-parameters.md	@cloudflare/workflows-shared	minor	✅ Valid
calm-beers-help.md	@cloudflare/local-explorer-ui, miniflare	minor	✅ Valid (experimental feature noted)
dependabot-update-13337.md	miniflare, wrangler	patch	⏭️ Skipped (Dependabot dependency update)
dependabot-update-13362.md	miniflare, wrangler	patch	⏭️ Skipped (Dependabot dependency update)
c3-frameworks-update-13358.md	create-cloudflare	patch	⏭️ Skipped (Dependabot dependency update for create-cloudflare)

Notes

• All changesets have meaningful descriptions explaining the change
• No h1/h2/h3 headers found in any changeset
• Experimental features (local-explorer-ui changes) explicitly note their experimental status
• Version types are appropriate for the changes described
• Dependency update changesets for create-cloudflare were skipped per validation rule wrangler tail #5

[ask-bonk]

Review posted successfully on PR #13335. Here's a summary of the two issues I flagged:

1. backlogBytes inconsistency in #flush metadata (logic bug) — After this.#messages.splice(0, batchSize), the backlogCount in the metadata correctly reflects the post-splice message count, but this.#backlogBytes still includes the bytes of the batch that was just removed (it's not decremented until line 356). This means the MessageBatchMetadata sent to the consumer has inconsistent count vs bytes. I suggested subtracting the batch bytes before building the metadata object.

2. Changeset h1 header — The changeset uses # Return metadata... which violates the rule that changeset descriptions must not use h1/h2/h3 headers. Suggested removing the # prefix.

github run

[pkg-pr-new]

create-cloudflare

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

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-pool-workers

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

@cloudflare/workers-editor-shared

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

wrangler

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

commit: c22ddbf

[sdnts]

LGTM from Queues' side

[dario-piotrowicz]

LGTM, with some minor comments 🙂

[workers-devprod]

Codeowners reviews satisfied

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 6 additional findings in Devin Review.