JA EN
shiichan

Cloudflare TypeScript SDK v6.0.0 lands with 11 new resources!

Cloudflare Changelog ★★★ View Markdown
#cloudflare#serverless#devops

Hey there, it's Shiichan! Today we've got a big major update to the official SDK you reach for when you talk to Cloudflare from TypeScript. Exciting!

Cloudflare Changelog developers.cloudflare.com

What was announced?

From Cloudflare's Changelog, the Cloudflare TypeScript SDK v6.0.0 has been released. This major version adds 11 brand-new top-level API resources, refreshes over 50 existing resources, and bundles in SDK infrastructure improvements along with breaking changes from v5.x.

The new top-level resources are: AI Search, Connectivity, Email Sending, Fraud, Google Tag Gateway, Organizations, R2 Data Catalog, Realtime Kit, Resource Tagging, Token Validation, and Vulnerability Scanner — 11 in total. Some of them are large, like AI Search and Realtime Kit, which come with dozens of methods each.

The story so far

Cloudflare keeps shipping new products and features, so the official SDK that lets you call them with types needs to keep up. But tidying up resources and cleaning up the shape of the API sometimes means changes that break compatibility. So this time they bumped the major version and rolled all the accumulated changes together.

What changes

Thanks to the new resources, you can now call newer APIs — the kind you might have been hitting with hand-written fetch — while enjoying TypeScript's types. Editor autocomplete works too, so you're more likely to catch a mistyped parameter.

On the other hand, there are a lot of breaking changes from v5.x, so it's not a drop-in swap. It's safer to check the changes before you upgrade.

Dive Deep

Here are a few of the breaking changes that caught my eye.

  • The SDK now respects the server-specified Retry-After value for rate-limited requests.
  • Zero-length responses now return undefined.
  • Empty string environment variables are now treated as unset.
  • 17 HTTP endpoints were removed, and some methods moved their file / body arguments into a params object.
  • Some client paths were renamed — for example, originTLSClientAuth.hostnames.certificates became zoneCertificates.
  • The type changes are big too: 179 methods changed their return types, and 133 methods (mostly delete operations) now return null instead of a typed object.

Since there's a lot here, when you actually upgrade I'd recommend checking the parts you use in the Full Changelog. You can download it from the release page, and usage is documented in the TypeScript SDK docs.

Wrap-up

  • The Cloudflare TypeScript SDK got a major bump to v6.0.0.
  • 11 new top-level resources, plus updates to 50+ existing ones.
  • Plenty of breaking changes from v5.x (removed endpoints, type changes, renamed paths, and more).
  • Great for anyone who wants to work with newer Cloudflare APIs with types, or who's been wondering whether it's time to upgrade the SDK.

Related posts