Change8

Supabase JS

Backend & Infra

An isomorphic Javascript client for Supabase. Query your Supabase database, subscribe to realtime events, upload and download files, browse typescript examples, invoke postgres functions via rpc, invoke supabase edge functions, query pgvector.

Latest: v2.90.1100 releases6 breaking changesView on GitHub →

Release History

v2.90.12 fixes
Jan 8, 2026

This patch release addresses state management issues in the PostgREST query builder and improves validation for Realtime postgres_changes event filters.

v2.90.1-canary.11 fix
Jan 8, 2026

This canary release fixes a bug in the PostgREST query builder to prevent unintended shared state between operations.

v2.90.1-canary.01 fix
Jan 7, 2026

This canary release for supabase-js addresses a bug in the Realtime module by adding validation for table filters during postgres_changes event dispatching.

v2.90.010 fixes1 feature
Jan 7, 2026

This release introduces heartbeat latency tracking in Realtime and includes several Auth stability fixes, including deadlock prevention and improved session handling for magic links.

v2.89.1-canary.81 fix
Jan 7, 2026

This canary release introduces a configurable lock acquisition timeout in the auth module to mitigate deadlock issues.

v2.89.1-canary.72 fixes
Jan 7, 2026

This canary release addresses issues in the functions and postgrest modules, specifically improving body serialization for custom headers and refining RPC HEAD request behavior.

v2.89.1-canary.61 fix
Jan 5, 2026

This canary release fixes an authentication issue where clicking a magic link multiple times would fail to preserve the user session.

v2.89.1-canary.51 fix
Jan 5, 2026

This canary release addresses a bug in the auth module where the initial timeout for auto-refreshing was not being properly cleared.

v2.89.1-canary.41 fix
Jan 5, 2026

This canary release fixes Edge Runtime warnings in Next.js applications when using the Supabase client.

v2.89.1-canary.31 fix
Jan 5, 2026

This canary release provides a fix for the Supabase client types by inlining a string literal within the DatabaseWithoutInternals type definition.

v2.89.1-canary.22 features
Jan 5, 2026

This canary release updates the Auth type definitions to include banned_until for users and last_challenged_at for factors.

v2.89.1-canary.11 fix
Dec 23, 2025

This canary release addresses a minor issue in the Supabase package by splitting type-only exports to prevent unused import warnings.

v2.89.1-canary.01 feature
Dec 23, 2025

This canary release adds the ability to monitor heartbeat latency directly within the heartbeat callback for Realtime services.

v2.89.03 features
Dec 18, 2025

This release introduces X (OAuth 2.0) authentication support, enhances AMR claim handling, and exports the DatabaseWithoutInternals utility type.

v2.88.1-canary.21 feature
Dec 18, 2025

This canary release exports the DatabaseWithoutInternals utility type to improve type handling for Supabase users.

v2.88.1-canary.11 feature
Dec 17, 2025

This canary release introduces support for string array values within AMR claims in the auth module.

v2.88.1-canary.01 feature
Dec 17, 2025

This canary release introduces support for X (formerly Twitter) as an OAuth 2.0 authentication provider.

v2.88.02 fixes3 features
Dec 16, 2025

This release introduces a new 'notin' filter for Postgrest, custom predicates for session detection in Auth, and migrates the build system to tsdown for better module compatibility.

v2.87.4-canary.51 feature
Dec 16, 2025

This canary release migrates the build system to tsdown to ensure proper ESM and CJS compatibility across the repository.

v2.87.4-canary.45 fixes1 feature
Dec 16, 2025

This canary release focuses on internal repository maintenance, transitioning the build system to tsdown while ensuring backwards compatibility for deep imports.

v2.87.4-canary.31 feature
Dec 16, 2025

This canary release introduces the ability to provide a custom predicate for the detectSessionInUrl option within the auth module.

v2.87.4-canary.21 feature
Dec 16, 2025

This canary release introduces a new 'notin' filter to the PostgREST client.

v2.87.4-canary.11 fix
Dec 16, 2025

This canary release fixes a bug in the Realtime module where authorization headers were incorrectly sent even when no access token was present.

v2.87.4-canary.01 fix
Dec 15, 2025

This canary release addresses a WebSocket race condition in the realtime module specifically affecting Node.js users.

v2.87.31 fix
Dec 15, 2025

This patch release fixes a module resolution issue when importing the library via the jsDelivr CDN.

v2.87.3-canary.11 fix
Dec 15, 2025

This canary release fixes an ESM import issue when using the supabase-js library via the jsDelivr CDN.

v2.87.3-canary.01 fix
Dec 15, 2025

This canary release addresses a specific ESM import failure occurring on the jsDelivr CDN by resolving file extensions.

v2.87.23 fixes
Dec 15, 2025

This patch release focuses on stability improvements, including a memory leak fix in Realtime web workers and improved error handling for PKCE authentication.

v2.87.2-canary.03 fixes
Dec 15, 2025

This canary release focuses on stability improvements, including a memory leak fix in Realtime web workers and resolving ESM import issues for jsDelivr users.

v2.87.13 fixes
Dec 9, 2025

This patch release focuses on bug fixes for Auth session persistence and Realtime stability, specifically regarding JWT preservation and filter comparisons.

v2.87.1-canary.12 fixes
Dec 8, 2025

This canary release addresses two specific bugs in the auth and realtime modules, specifically regarding session persistence locking and null value handling in filters.

v2.87.1-canary.01 fix
Dec 8, 2025

This canary release fixes a bug in the Realtime module where custom JWT tokens were lost during channel resubscription.

v2.87.01 fix1 feature
Dec 8, 2025

This release aligns the storage analytics method with the standard { data, error } response pattern and updates the repository to support npm 11.

v2.86.3-canary.01 fix1 feature
Dec 5, 2025

This canary release aligns the storage analytics method with the standard { data, error } return pattern and updates the repository's npm version constraint.

v2.86.21 fix
Dec 4, 2025

This patch release fixes a property naming inconsistency in the storage module's QueryVectorsResponse, renaming 'matches' to 'vectors'.

v2.86.2-canary.01 fix
Dec 4, 2025

This canary release fixes a property naming inconsistency in the storage module's QueryVectorsResponse, renaming 'matches' to 'vectors'.

v2.86.15 fixes
Dec 4, 2025

This patch release focuses on bug fixes for Auth session handling, PostgREST type inference, and resolving module resolution issues in Nuxt via a new ESM wrapper.

v2.86.1-canary.05 fixes
Dec 4, 2025

This canary release focuses on bug fixes for Auth session handling, PostgREST type inference, and resolving module resolution issues in Nuxt via a new ESM wrapper.

v2.86.01 feature
Nov 26, 2025

This release introduces iceberg-js integration to the storage module, specifically adding the 'from' method.

v2.85.1-canary.01 feature
Nov 26, 2025

This canary release introduces iceberg-js integration to the storage module, specifically adding a new 'from' method.

v2.85.01 fix1 feature
Nov 26, 2025

This release introduces metadata support for Realtime user broadcast pushes and includes minor type improvements for Auth OAuth functionality.

v2.84.1-canary.11 feature
Nov 26, 2025

This canary release introduces the ability to include metadata when pushing broadcast messages via Realtime.

v2.84.1-canary.01 fix
Nov 26, 2025

This canary release includes minor type fixes for the OAuth authentication module.

v2.84.02 fixes1 feature
Nov 20, 2025

This release introduces new PostgREST operators for distinctness and regex matching, alongside stability improvements for relation name validation and Realtime message serialization.

v2.83.1-canary.21 feature
Nov 19, 2025

This canary release adds new PostgREST operators for distinctness checks and regex pattern matching.

v2.83.1-canary.11 fix
Nov 19, 2025

This canary release focuses on internal improvements to the Realtime serializer by removing redundant message types.

v2.83.1-canary.01 fix
Nov 19, 2025

This canary release introduces a fix for Postgrest to properly validate empty or invalid relation names.

v2.83.0Breaking1 feature
Nov 18, 2025

Version 2.83.0 introduces a breaking change by renaming StorageAnalyticsApi to StorageAnalyticsClient within the storage module.

v2.82.1-canary.0Breaking1 feature
Nov 18, 2025

This canary release renames the StorageAnalyticsApi to StorageAnalyticsClient within the storage module.

v2.82.03 fixes1 feature
Nov 18, 2025

This release introduces OAuth grant management features and includes several stability fixes for Postgrest error reporting, Realtime message encoding, and Storage properties.

v2.81.2-canary.31 fix
Nov 18, 2025

This canary release provides a fix for the analytics bucket property within the storage module.

v2.81.2-canary.21 feature
Nov 18, 2025

This canary release introduces new authentication capabilities for managing OAuth grants, specifically allowing users to list and revoke them.

v2.81.2-canary.11 fix
Nov 17, 2025

This canary release addresses a bug in the realtime module where null references were not properly handled during message encoding.

v2.81.2-canary.01 fix
Nov 12, 2025

This canary release improves error reporting in the postgrest module by ensuring fetch error causes and codes are properly surfaced.

v2.81.12 fixes1 feature
Nov 11, 2025

This patch release focuses on fixing authentication and realtime issues, specifically improving compatibility with Next.js 16 and streamlining SSO redirects.

v2.81.1-canary.11 fix
Nov 11, 2025

This canary release fixes an issue in the realtime module where setAuth was incorrectly required when using custom JWT tokens.

v2.81.1-canary.01 fix1 feature
Nov 11, 2025

This canary release focuses on Auth module improvements, including Next.js 16 compatibility fixes and automatic redirects for SSO sign-ins.

v2.81.0Breaking4 fixes1 feature
Nov 10, 2025

This release introduces a new V2 serializer for Realtime and significant updates to WebAuthn authentication parameters and Edge Functions error handling.

v2.80.1-canary.51 fix
Nov 10, 2025

This canary release fixes a resource leak in the realtime module by ensuring WebSocket connections are properly closed during teardown.

v2.80.1-canary.41 fix
Nov 7, 2025

This canary release addresses an authentication issue by implementing direct attestation for registration and login processes.

v2.80.1-canary.31 feature
Nov 7, 2025

This canary release introduces a new V2 serializer for the Realtime module.

v2.80.1-canary.21 fix
Nov 7, 2025

This canary release provides a fix for the Auth module by adding the providers type to the UserAppMetadata interface.

v2.80.1-canary.1Breaking1 fix
Nov 7, 2025

This release updates the authentication logic to make WebAuthn parameters optional and restructures how registration parameters are passed.

v2.80.1-canary.01 fix2 features
Nov 6, 2025

This canary release introduces configurable timeouts for functions and standardizes error reporting by normalizing abort and timeout errors into a specific FunctionsFetchError type.

v2.80.01 fix1 feature
Nov 6, 2025

This release introduces TypeScript types for JWT claims and updates the behavior of storage-key conflicts in the auth module to be a warning rather than an error.

v2.79.1-canary.11 fix
Nov 6, 2025

This canary release updates the authentication module to issue a warning instead of an error when multiple clients utilize the same storage key.

v2.79.1-canary.01 feature
Nov 6, 2025

This canary release introduces TypeScript types for documented JWT claims fields within the auth module.

v2.79.0Breaking2 features
Nov 4, 2025

This release introduces an option for the auth module to throw errors and updates the minimum system requirements to Node.js 20 by removing the node-fetch dependency.

v2.78.1-canary.1Breaking1 feature
Nov 4, 2025

This canary release removes the node-fetch dependency and raises the minimum required Node.js version to 20.

v2.78.1-canary.01 feature
Oct 31, 2025

This canary release introduces a new error handling behavior in the auth module, allowing developers to opt into throwing errors instead of receiving them as return values.

v2.78.02 fixes3 features
Oct 30, 2025

This release introduces OAuth 2.1 consent management and client update support, alongside internal refactors to authentication methods and session warning logic.

v2.77.1-canary.21 feature
Oct 30, 2025

This canary release focuses on a refactor of the getAuthenticatorAssuranceLevel method within the auth module.

v2.77.1-canary.11 fix
Oct 30, 2025

This canary release includes a bug fix for the auth module, relocating the session warning proxy from the session object to the user object.

v2.77.1-canary.01 fix2 features
Oct 29, 2025

This canary release introduces OAuth 2.1 authorization consent management and client update support, while fixing a redirection issue in the getAuthorizationDetails method.

v2.77.06 fixes3 features
Oct 29, 2025

This release introduces OAuth 2.1 consent management and client updates, adds pagination and sorting to storage buckets, and improves performance via RegExp precompilation.

v2.76.2-canary.21 fix
Oct 23, 2025

This canary release focuses on repository maintenance by cleaning up lock files for npm and Bun.

v2.76.2-canary.11 feature
Oct 22, 2025

This canary release introduces pagination and sorting capabilities for storage buckets.

v2.76.2-canary.01 fix
Oct 21, 2025

This canary release includes a fix for the Auth module to correctly handle 204 No Content responses during OAuth client deletion.

v2.76.11 fix
Oct 21, 2025

This patch release adds the missing tslib dependency to core packages to resolve potential runtime issues in environments where it was not explicitly installed.

v2.76.07 fixes3 features
Oct 20, 2025

This release introduces storage vectors and analytics support, enhances Realtime types and REST capabilities, and fixes several issues in Edge Functions and Storage type definitions.

v2.75.2-canary.11 fix
Oct 20, 2025

This canary release provides a fix for API type definitions within the storage module.

v2.75.2-canary.06 fixes3 features
Oct 17, 2025

This canary release introduces storage vectors and analytics support, enhances Realtime types and REST capabilities, and fixes several issues in Functions and Storage response handling.

v2.75.11 fix
Oct 17, 2025

Version 2.75.1 is a maintenance release that fixes a regression in the storage download function by restoring its original return type.

v2.75.1-canary.51 fix
Oct 16, 2025

A canary patch release focused on internal repository improvements, specifically converting the postbuild process to explicit code generation.

v2.75.1-canary.42 fixes
Oct 16, 2025

This canary release addresses two issues in the FunctionsClient, specifically fixing body handling when custom Content-Type headers are used and adding support for PDF response parsing.

v2.75.1-canary.31 fix
Oct 13, 2025

This canary release includes a bug fix for the Realtime module to ensure more robust URL manipulation using the native URL object.

v2.75.1-canary.21 feature
Oct 13, 2025

This canary release improves the type definitions for RealtimeChannel within the Supabase client.

v2.75.1-canary.12 fixes
Oct 9, 2025

This canary release focuses on fixing type mismatches in the Storage V2 API and ensuring backward compatibility for the storage download function.

v2.75.1-canary.01 feature
Oct 9, 2025

This canary release introduces the ability to make explicit REST calls within the realtime module.

v2.75.01 feature
Oct 9, 2025

This release introduces type inference for embedded functions within the PostgREST module.

v2.74.1-canary.71 feature
Oct 8, 2025

This canary release introduces type inference for embedded functions within the Postgrest module.

v2.74.1-canary.6
Oct 7, 2025

This is a version bump only release with no functional code changes.

v2.74.1-canary.5
Oct 7, 2025

This is a version bump only release with no code changes.

v2.74.1-canary.4
Oct 7, 2025

This is a version bump only release with no code changes.

v2.74.1-canary.3
Oct 7, 2025

This is a version bump only release with no code changes.

v2.74.1-canary.2
Oct 6, 2025

This is a version bump only release with no functional code changes.

v2.74.1-canary.1
Oct 6, 2025

This is a version bump only release with no code changes.

v2.74.1-canary.0
Oct 6, 2025

This is a canary version bump with no functional code changes.

v2.74.01 fix5 features
Oct 6, 2025

This release introduces OAuth 2.1 admin endpoints, Broadcast Replay configuration for Realtime, and sorting for Storage list v2, while deprecating async callbacks in onAuthStateChange.

v2.73.1-canary.81 fix
Oct 6, 2025

This canary release fixes a bug in the storage module where trailing slashes in the baseUrl were not being correctly normalized.