Deprecation notice: @supabase/supabase-js will require TypeScript 5.0

[mandarini]

Deprecation notice: @supabase/supabase-js will require TypeScript 5.0

Summary

Starting with a minor release on or after January 2027, @supabase/supabase-js and the packages it bundles (postgrest-js, auth-js, realtime-js, storage-js, functions-js) will require TypeScript 5.0 or later. TypeScript 4.7–4.9 will no longer be tested or supported.

Consistent with our existing Support Policy, raising the minimum TypeScript version ships in a minor release and is not considered a breaking change, the same way we handle end-of-life Node.js versions.

Why

• Our type declarations currently target a TypeScript 4.7 floor (May 2022, ~4 years old) — roughly a dozen releases and two major lines behind current TypeScript.
• Holding the 4.7 floor blocks us from using modern type features that materially improve the SDK's types — const type parameters, the satisfies operator, and (later) NoInfer for the postgrest-js query-builder generics.
• It also pins transitive tooling (e.g. zod) to older releases.

What you need to do

• On TypeScript 5.0 or newer: nothing. You're already covered.
• On TypeScript 4.7–4.9: upgrade your project's TypeScript to >= 5.0 before the release above. TypeScript 5.x has been stable since March 2023.

Timeline

• Now: advance notice (this post); our SDKs continues to emit 4.7-compatible types.
• On/after January 2027: a minor release raises the floor to TypeScript 5.0. The last version supporting TypeScript 4.7 will be called out in the release notes and the README once that release is cut.

Questions and concerns welcome below.