@cloudflare/workers-types v5

[penalosa]

After the stabilisation of wrangler types-based runtime type generation in Wrangler v4, the confusing entrypoint system in @cloudflare/workers-types is no longer needed. As such, this PR changes @cloudflare/workers-types to only include the latest version of the runtime types (previously this was the /experimental entrypoint).

After some analysis of open source repos with Sourcegraph, it's clear that the usage of the alternative entrypoints to @cloudflare/workers-types is very low to 0, and so this shouldn't have a practical impact on users. However, it's still a breaking change, and so this will be released as @cloudflare/workers-types@5. There are two migration paths available to users:

• Continue using @cloudflare/workers-types, but be aware that the typing environment may not be 100% compatible with runtime behaviour, depending on your compatibility date + flags, or
• Migrate to wrangler types

cc @anonrig this will also cut the build time of workers-types by 90%

cc @irvinebroque @korinne for visibility

[github-actions]

The generated output of @cloudflare/workers-types matches the snapshot in types/generated-snapshot 🎉

[DaniFoldi]

Hi @penalosa 👋,

Would it perhaps make more sense to have it defined as an alias to the "latest stable" date? Right now, that would be 2023-07-01, which more closely maps to types available to users. Experimental has some methods which aren't yet accessible to users, but if they show up in types, it might cause confusion.

[penalosa]

(converting to draft so that this doesn't get accidentally merged while still under discussion)

[penalosa]

@DaniFoldi The problem with the "latest stable" compatibility date is that it doesn't really represent anything in the runtime. It's just the last time the typings changed in a significant way, but it also means users miss out on types added since then. Using the experimental entrypoint has a slight risk of experimental APIs being available in user code, but it also means that everything else is always up to date.

[irvinebroque]

So basically this means — if you want types that match a specific compat date — then you need to use wrangler types?

[anonrig]

Can we move the spawning of workerd to bazel now?

[DaniFoldi]

but it also means users miss out on types added since then

I don't think it does, the only types that are unavailable are ones that haven't been default on that date, such as some stream related ones in the oldest date.

[github-actions]

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

[NuroDev]

I have read the CLA Document and I hereby sign the CLA