Remove `getLocalWorkerdCompatibilityDate` from workers-utils and re-export `supportedCompatibilityDate` from miniflare instead by dario-piotrowicz · Pull Request #12387 · cloudflare/workers-sdk

dario-piotrowicz · 2026-02-03T16:06:48Z

Fixes https://jira.cfdata.org/browse/DEVX-2446

This PR removes the getLocalWorkerdCompatibilityDate utility from the @cloudflare/worker-utils package and makes sure that the miniflare's supportedCompatibilityDate is exposed by the package. The same variable is then re-exported by wrangler.

This value is then also used by C3 ensuring that the compatibility date can be reliably retrieved when using pnpm.

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): Add getLocalWorkerdCompatibilityDate documentation in the wrangler programmatic API page cloudflare-docs#28082
- Documentation not necessary because:

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

changeset-bot · 2026-02-03T16:06:53Z

🦋 Changeset detected

Latest commit: c9ccae5

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

claude · 2026-02-03T16:07:21Z

Claude finished @dario-piotrowicz's task —— View job

Changeset Review

Reviewing changesets for this PR...

Tasks:

Read changeset guidelines
Review .changeset/dirty-moments-join.md
Review .changeset/long-colts-occur.md
Review .changeset/quiet-roses-help.md
Review .changeset/smart-buckets-wonder.md
Provide final assessment

⚠️ Issues Found

`.changeset/long-colts-occur.md` (@cloudflare/vite-plugin)

Issue: Typo in changeset description - supportedCompatibility should be supportedCompatibilityDate

The description says:

miniflare exports the latest compatibility date supportedCompatibility as, and that is the value that now the package uses...

Should be:

miniflare exports the latest compatibility date supportedCompatibilityDate as, and that is the value that now the package uses...

Also, the sentence structure is awkward with "exports...as, and that is" - consider rephrasing to:

miniflare exports the latest compatibility date as supportedCompatibilityDate, and that is the value that the package now uses...

All other changesets look good:

✅ .changeset/dirty-moments-join.md (wrangler minor) - Appropriate version type and clear description
✅ .changeset/quiet-roses-help.md (create-cloudflare patch) - Concise bug fix description
✅ .changeset/smart-buckets-wonder.md (@cloudflare/workers-utils minor) - Appropriate version type for removing a function from a 0.x package

pkg-pr-new · 2026-02-03T16:12:16Z

create-cloudflare

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

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-pool-workers

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

@cloudflare/workers-editor-shared

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

wrangler

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

commit: c9ccae5

vicb · 2026-02-04T06:55:34Z

@dario-piotrowicz could you please take a look at #11910 - looks like both PR handle the same thing?

dario-piotrowicz · 2026-02-04T10:47:46Z

@dario-piotrowicz could you please take a look at #11910 - looks like both PR handle the same thing?

I commented there, I think there's little benefit in merging #11910 since that doesn't solve the pnpm issue

devin-ai-integration

✅ Devin Review: No Issues Found

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

View in Devin Review to see 4 additional flags.

petebacondarwin · 2026-02-04T13:54:51Z

This all feels very convoluted 😢. Especially where we have to try to import wrangler in the workers-utils package.

dario-piotrowicz · 2026-02-04T14:46:14Z

This all feels very convoluted 😢. Especially where we have to try to import wrangler in the workers-utils package.

But that's a temporary solution / workaround, in a followup PR I am planning to remove the function from workers-utils, so at that point we'll only have:

getLocalWorkerdCompatibilityDate exported by miniflare (for direct miniflare users)
getLocalWorkerdCompatibilityDate re-exported by wrangler (for anyone using wrangler programmatically)
C3 using wrangler's getLocalWorkerdCompatibilityDate (in a way analogous to what workers-utils does today)

I think that that would be quite clean and clear, no?

petebacondarwin · 2026-02-04T15:06:28Z

Can we not just do that in one go here in this PR?
I feel like the workaround makes this PR more complicated that if we just did the full move now.

dario-piotrowicz · 2026-02-04T15:13:13Z

Can we not just do that in one go here in this PR? I feel like the workaround makes this PR more complicated that if we just did the full move now.

I wanted to go this way because I think it's safer (and I didn't think it'd introduce too much complexity), I'm happy to do all of that in one go if that's the preference 🙂

dario-piotrowicz · 2026-02-04T19:01:28Z

@petebacondarwin PR updated to remove the extra complexity 🙂

Co-authored-by: Victor Berchet <victor@suumit.com>

petebacondarwin

Bunch of comments - I think mostly nits - so marking as approved.

petebacondarwin · 2026-03-24T13:32:43Z


+### `supportedCompatibilityDate`
+
+Exported value containing the latest [compatibility date](https://developers.cloudflare.com/workers/platform/compatibility-dates/) supported by the locally installed `workerd` package. If the `workerd` package's compatibility date is in the future, the value contains today's date instead. The value is a string in the `YYYY-MM-DD` format (e.g. `"2025-09-27"`).


I think it is worth explaining the logic for compat dates again here...

Each workerd release exposes a supported compat date that it guarantees can be used with this version of the package. This date is up to 7 days after the release date of the version.
Normally this supportedCompatibilityDate is equal to the value exported by workerd, but if this supported compat date is in the future (because the workerd package was released in the last 7 days) then the value of this export is today.

Co-authored-by: Pete Bacon Darwin <pete@bacondarwin.com>

devin-ai-integration

Devin Review found 1 new potential issue.

View 12 additional findings in Devin Review.

petebacondarwin · 2026-03-24T17:28:25Z

+		// supportedCompatibilityDate is already a YYYY-MM-DD string, which sorts
+		// lexicographically as a date. Compare directly against today's date.
+		const todayDate = formatCompatibilityDate(new Date());
+		expect(supportedCompatibilityDate <= todayDate).toBe(true);


Suggested change

expect(supportedCompatibilityDate <= todayDate).toBe(true);

expect(supportedCompatibilityDate).toBeLessThanOrEqual(todayDate);

dario-piotrowicz · 2026-03-25T01:01:01Z

Closing in favour of #13051

workers-devprod added this to workers-sdk Feb 3, 2026

github-project-automation bot moved this to Untriaged in workers-sdk Feb 3, 2026

dario-piotrowicz commented Feb 3, 2026

View reviewed changes

Comment thread packages/workers-utils/src/compatibility-date.ts Outdated

vicb reviewed Feb 3, 2026

View reviewed changes

Comment thread .changeset/dirty-moments-join.md Outdated

vicb reviewed Feb 3, 2026

View reviewed changes

Comment thread packages/miniflare/src/runtime/index.ts Outdated

dario-piotrowicz mentioned this pull request Feb 4, 2026

[workers-utils] Fix compat date resolution in workspaces #11910

Closed

5 tasks

dario-piotrowicz requested a review from vicb February 4, 2026 10:47

dario-piotrowicz marked this pull request as ready for review February 4, 2026 11:08

dario-piotrowicz requested a review from a team as a code owner February 4, 2026 11:08

devin-ai-integration bot reviewed Feb 4, 2026

View reviewed changes

dario-piotrowicz mentioned this pull request Feb 4, 2026

Add getLocalWorkerdCompatibilityDate documentation in the wrangler programmatic API page cloudflare/cloudflare-docs#28082

Closed

dario-piotrowicz marked this pull request as draft February 4, 2026 15:13

dario-piotrowicz mentioned this pull request Feb 4, 2026

Add getSupportedCompatibilityDate export #12384

Closed

5 tasks

dario-piotrowicz force-pushed the dario/DEVX-2446/miniflare-getLocalWorkerdCompatibilityDate branch from 2d8af12 to c4a0c37 Compare February 4, 2026 17:52

dario-piotrowicz changed the title ~~Add getLocalWorkerdCompatibiltyDate to miniflare~~ Move getLocalWorkerdCompatibiltyDate to miniflare Feb 4, 2026

dario-piotrowicz force-pushed the dario/DEVX-2446/miniflare-getLocalWorkerdCompatibilityDate branch 2 times, most recently from c2d82c4 to 40a4b0a Compare February 4, 2026 18:08

dario-piotrowicz marked this pull request as ready for review February 4, 2026 19:01

dario-piotrowicz requested a review from a team as a code owner February 4, 2026 19:01

This comment was marked as resolved.

Sign in to view

dario-piotrowicz and others added 8 commits March 24, 2026 10:43

remove inline comments

ec884f0

Update packages/miniflare/src/runtime/compatibility-date.ts

22b2b2d

Co-authored-by: Victor Berchet <victor@suumit.com>

update changeset

befed3d

update changeset

8c0addc

Update packages/miniflare/src/runtime/compatibility-date.ts

de99ecb

Co-authored-by: Victor Berchet <victor@suumit.com>

improve changesets

c01cf7c

address issue of older version of wrangler

f3031b5

bump fallback date

8b4ba49

dario-piotrowicz requested a review from vicb March 24, 2026 11:37

petebacondarwin approved these changes Mar 24, 2026

View reviewed changes

dario-piotrowicz and others added 12 commits March 24, 2026 14:17

Update .changeset/quiet-roses-help.md

9eb1dd3

Co-authored-by: Pete Bacon Darwin <pete@bacondarwin.com>

Update .changeset/quiet-roses-help.md

7214732

Co-authored-by: Pete Bacon Darwin <pete@bacondarwin.com>

Update .changeset/dirty-moments-join.md

3aa2610

Co-authored-by: Pete Bacon Darwin <pete@bacondarwin.com>

Apply suggestions from code review

490a0d1

Co-authored-by: Pete Bacon Darwin <pete@bacondarwin.com>

update changeset to major

af2445e

add reverse date check

cb41c70

avoid re-exporting * from compatibility-date

3402f7a

compare date strings

81b5623

update README

ae72d62

add check in c3 e2es for compatibility date

a86d1e0

fix formatting

edf4d29

fix typo

2997ba3

devin-ai-integration bot reviewed Mar 24, 2026

View reviewed changes

Comment thread packages/create-cloudflare/e2e/tests/workers/workers.test.ts

revert changeset to minor

c9ccae5

petebacondarwin reviewed Mar 24, 2026

View reviewed changes

dario-piotrowicz closed this Mar 25, 2026

github-project-automation bot moved this from In Review to Done in workers-sdk Mar 25, 2026

dario-piotrowicz deleted the dario/DEVX-2446/miniflare-getLocalWorkerdCompatibilityDate branch March 25, 2026 01:10


		### `supportedCompatibilityDate`

		Exported value containing the latest [compatibility date](https://developers.cloudflare.com/workers/platform/compatibility-dates/) supported by the locally installed `workerd` package. If the `workerd` package's compatibility date is in the future, the value contains today's date instead. The value is a string in the `YYYY-MM-DD` format (e.g. `"2025-09-27"`).

	expect(supportedCompatibilityDate <= todayDate).toBe(true);
	expect(supportedCompatibilityDate).toBeLessThanOrEqual(todayDate);

Conversation

dario-piotrowicz commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

claude bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changeset Review

⚠️ Issues Found

.changeset/long-colts-occur.md (@cloudflare/vite-plugin)

Uh oh!

Uh oh!

pkg-pr-new bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vicb commented Feb 4, 2026

Uh oh!

dario-piotrowicz commented Feb 4, 2026

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

✅ Devin Review: No Issues Found

Uh oh!

petebacondarwin commented Feb 4, 2026

Uh oh!

dario-piotrowicz commented Feb 4, 2026

Uh oh!

petebacondarwin commented Feb 4, 2026

Uh oh!

dario-piotrowicz commented Feb 4, 2026

Uh oh!

dario-piotrowicz commented Feb 4, 2026

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

petebacondarwin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

petebacondarwin Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

petebacondarwin Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

dario-piotrowicz commented Mar 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

dario-piotrowicz commented Feb 3, 2026 •

edited

Loading

changeset-bot bot commented Feb 3, 2026 •

edited

Loading

claude bot commented Feb 3, 2026 •

edited

Loading

`.changeset/long-colts-occur.md` (@cloudflare/vite-plugin)

pkg-pr-new bot commented Feb 3, 2026 •

edited

Loading