feat: add Flagship binding support

[roerohan]

Summary

Add end-to-end support for the Flagship binding across @cloudflare/workers-utils, miniflare, and wrangler.

Corresponding workerd PR: cloudflare/workerd#6456

• @cloudflare/workers-utils: Config schema, validation, default values, CfFlagship type, WorkerMetadataBinding/Binding union entries, and metadata binding mapping
• miniflare: New remote-only plugin (plugins/flagship/) with zod schema, proxy bindings, and remote proxy client wiring
• wrangler: Deployment bundle upload, dev wiring (miniflare options, convertConfigToBindings), CLI binding display, type generation (Flags type in both code paths), OAuth scopes (flagship:read, flagship:write), and config-diffs support

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because: This PR adds the plumbing only — tests will be added in a follow-up once the workerd Flagship binding types land
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: Public docs will be published closer to GA

---

[changeset-bot]

🦋 Changeset detected

Latest commit: 5ce25e1

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

• packages/miniflare/src/plugins/flagship/index.ts: [@cloudflare/wrangler]
• packages/miniflare/src/plugins/index.ts: [@cloudflare/wrangler]
• packages/workers-utils/src/config/config.ts: [@cloudflare/wrangler]
• packages/workers-utils/src/config/environment.ts: [@cloudflare/wrangler]
• packages/workers-utils/src/config/validation.ts: [@cloudflare/wrangler]
• packages/workers-utils/src/map-worker-metadata-bindings.ts: [@cloudflare/wrangler]
• packages/workers-utils/src/types.ts: [@cloudflare/wrangler]
• packages/workers-utils/src/worker.ts: [@cloudflare/wrangler]
• packages/workers-utils/tests/config/validation/normalize-and-validate-config.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/tests/deploy/core.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/tests/type-generation.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/tests/user.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/tests/whoami.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/api/startDevWorker/utils.ts: [@cloudflare/wrangler]
• packages/wrangler/src/deploy/config-diffs.ts: [@cloudflare/wrangler]
• packages/wrangler/src/deployment-bundle/create-worker-upload-form.ts: [@cloudflare/wrangler]
• packages/wrangler/src/dev/miniflare/index.ts: [@cloudflare/wrangler]
• packages/wrangler/src/type-generation/index.ts: [@cloudflare/wrangler]
• packages/wrangler/src/user/user.ts: [@cloudflare/wrangler]
• packages/wrangler/src/utils/add-created-resource-config.ts: [@cloudflare/wrangler]
• packages/wrangler/src/utils/print-bindings.ts: [@cloudflare/wrangler]

[pkg-pr-new]

create-cloudflare

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

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-pool-workers

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

@cloudflare/workers-editor-shared

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

wrangler

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

commit: 5ce25e1

[roerohan]

@fixture/vitest-pool-workers:test:ci: ⎯⎯⎯⎯⎯⎯⎯ Failed Tests 1 ⎯⎯⎯⎯⎯⎯⎯
@fixture/vitest-pool-workers:test:ci: 
@fixture/vitest-pool-workers:test:ci:  FAIL   rpc  test/unit.test.ts > Durable Object > increments count and allows direct/rpc access to instance/storage
@fixture/vitest-pool-workers:test:ci: Error: Test timed out in 5000ms.
@fixture/vitest-pool-workers:test:ci: If this is a long-running test, pass a timeout value as the last argument or configure it globally with "testTimeout".
@fixture/vitest-pool-workers:test:ci:  ❯ test/unit.test.ts:72:2
@fixture/vitest-pool-workers:test:ci:      70|   });
@fixture/vitest-pool-workers:test:ci:      71|  });
@fixture/vitest-pool-workers:test:ci:      72|  it("increments count and allows direct/rpc access to instance/storage…
@fixture/vitest-pool-workers:test:ci:        |  ^
@fixture/vitest-pool-workers:test:ci:      73|   expect,
@fixture/vitest-pool-workers:test:ci:      74|  }) => {
@fixture/vitest-pool-workers:test:ci: 
@fixture/vitest-pool-workers:test:ci: ⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/1]⎯
@fixture/vitest-pool-workers:test:ci: 
@fixture/vitest-pool-workers:test:ci: 
@fixture/vitest-pool-workers:test:ci:  Test Files  1 failed | 49 passed (50)
@fixture/vitest-pool-workers:test:ci:       Tests  1 failed | 131 passed (132)
@fixture/vitest-pool-workers:test:ci:    Start at  12:20:26
@fixture/vitest-pool-workers:test:ci:    Duration  59.98s (transform 13.40s, setup 8.40s, import 21.69s, tests 24.37s, environment 9ms)

This is the current CI error, a simple re-run should fix it
CC @petebacondarwin

[petebacondarwin]

But this is not a flake: https://github.com/cloudflare/workers-sdk/actions/runs/23796373130/job/69344578952?pr=13139#step:6:1650

[petebacondarwin]

Can you add tests for this binding configuration to packages/workers-utils/tests/config/validation/normalize-and-validate-config.test.ts.

Can you add tests to miniflare for: getObjectValue, getObjectDetails, getStringDetails, and getNumberDetails.

[workers-devprod]

Codeowners reviews satisfied