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.110.6-canary.0100 releases4 breaking changes13 common errorsView on GitHub

Release History

v2.110.6-canary.0
5h ago
v2.110.5
8h ago
v2.110.4
13h ago
v2.110.4-canary.0
13h ago
v2.110.3
Jul 13, 2026
v2.110.3-canary.1
Jul 13, 2026
v2.110.3-canary.0
Jul 10, 2026
v2.110.21 fix
Jul 9, 2026

This patch release fixes an issue in the auth module where local sessions were not being cleared during signout failures.

v2.110.2-canary.01 fix
Jul 7, 2026

This canary release primarily addresses a bug in the auth module where local sessions were not being cleared during signout failures.

v2.110.12 fixes
Jul 7, 2026

This patch release addresses minor issues in auth and realtime modules, specifically concerning initialization notifications and heartbeat status reporting.

v2.110.1-canary.02 fixes
Jul 7, 2026

This canary release addresses two minor bugs related to auth initialization timing and realtime heartbeat status reporting.

v2.110.01 feature
Jun 30, 2026

This release drops support for Node.js 20, requiring users to upgrade their Node.js environment.

v2.110.0-canary.0Breaking
Jun 30, 2026

This canary release primarily removes support for Node.js 20, requiring users to upgrade their runtime environment.

v2.109.04 fixes3 features
Jun 30, 2026

This release introduces new filtering and cache purging capabilities for Realtime and Storage, alongside improvements to Auth admin APIs and bug fixes across Functions and Realtime dependencies.

v2.108.3-canary.2
Jun 19, 2026

This was a version bump only, there were no code changes.

v2.108.3-canary.12 fixes
Jun 18, 2026

This canary release primarily addresses bug fixes related to Content-Type overrides in functions and default sorting behavior in storage list operations.

v2.108.3-canary.01 fix
Jun 17, 2026

This canary release primarily addresses dependency pinning for the realtime module to ensure stability.

v2.108.22 fixes
Jun 15, 2026

This patch release focuses on stability fixes, particularly preserving user sessions during authentication refresh failures and clarifying realtime error messages.

v2.108.2-canary.5
Jun 15, 2026

This was a version bump only, there were no code changes.

v2.108.2-beta.52 fixes
Jun 12, 2026

This beta release focuses on stability fixes, specifically addressing session preservation during auth refresh failures and clarifying realtime error messages.

v2.108.2-canary.41 fix
Jun 12, 2026

This canary release primarily addresses a clarification for the httpSend() 404 error and server migration note within the realtime functionality.

v2.108.2-canary.3
Jun 11, 2026

This was a version bump only, there were no code changes.

v2.108.2-canary.21 fix
Jun 11, 2026

This canary release primarily focuses on restoring and enabling JSR publish flags for beta testing.

v2.108.2-beta.13 fixes
Jun 11, 2026

This beta release focuses on stability fixes, specifically addressing session preservation during authentication failures and improving the release process reliability by pinning Deno and adjusting JSR publishing settings.

v2.108.2-canary.11 fix
Jun 11, 2026

This canary release addresses an issue by pinning Deno and bounding JSR publish to prevent stranded-task hangs.

v2.108.2-beta.02 fixes
Jun 11, 2026

This beta release focuses on stability fixes, specifically addressing session preservation during authentication failures and improving the release process stability.

v2.108.2-canary.01 fix
Jun 11, 2026

This canary release primarily addresses a bug in the authentication flow, ensuring valid sessions are preserved during refresh failures.

v2.108.12 fixes
Jun 9, 2026

This patch release addresses minor fixes in CI configuration and Postgrest typing.

v2.108.1-canary.2
Jun 9, 2026

This was a version bump only, there were no code changes.

v2.108.1-canary.11 fix
Jun 8, 2026

This canary release primarily addresses a typing issue within the postgrest module.

v2.108.1-canary.01 fix
Jun 8, 2026

This canary release primarily addresses a CI configuration issue by forwarding the DOGFOOD_APP_CLIENT_ID environment variable.

v2.108.02 fixes1 feature
Jun 8, 2026

This release introduces a consistent confirmation flow for auth.resend() and resolves issues related to error logging and header passing for custom fetch environments.

v2.108.0-canary.02 fixes1 feature
Jun 4, 2026

This canary release introduces a consistent confirmation flow for auth.resend() and fixes issues related to error logging and header passing for RN/custom-fetch compatibility.

v2.107.06 fixes3 features
Jun 2, 2026

This release updates authentication mechanisms, enhances Realtime payload handling, and refines error reporting in Postgrest. It also addresses several authentication flow issues.

v2.107.0-canary.6
Jun 2, 2026

This was a version bump only, there were no code changes.

v2.107.0-canary.51 fix
Jun 2, 2026

This canary release primarily addresses an internal publishing fix related to the gotrue-js legacy mirror.

v2.107.0-beta.76 fixes3 features
Jun 2, 2026

This beta release introduces a new structured metadata format for X-Client-Info and updates authentication handling by removing the navigator.locks-based mutex. Several bug fixes address JWT validation and error handling in Auth and Postgrest modules.

v2.107.0-canary.41 fix
Jun 2, 2026

This canary release primarily addresses an internal dependency pinning issue related to JSR publishing.

v2.107.0-beta.64 fixes3 features
Jun 2, 2026

This beta release introduces new features for authentication mutex handling, binary payload support in realtime, and structured metadata for client info. Several fixes address JWT handling, OAuth redirects, and error reporting in PostgREST responses.

v2.107.0-canary.3
Jun 2, 2026

This was a version bump only, there were no code changes.

v2.107.0-canary.21 fix
Jun 2, 2026

This canary release reverts a previous fix related to encoding client-id in oauth requests.

v2.107.0-canary.11 feature
Jun 1, 2026

This canary release introduces a significant change to the authentication system by replacing the navigator.locks-based mutex with a commit guard and dispose() mechanism.

v2.107.0-canary.01 fix2 features
Jun 1, 2026

This canary release introduces the ability to send binary payloads via httpSend in realtime and updates the X-Client-Info header format for better metadata tracking.

v2.106.3-canary.21 fix
May 28, 2026

This canary release primarily addresses a bug in Postgrest handling of successful responses with non-JSON bodies.

v2.106.3-canary.1
May 28, 2026

This was a version bump only, there were no code changes.

v2.106.3-canary.01 fix
May 28, 2026

This canary release fixes an issue where expired JWTs were not correctly returning AuthInvalidJwtError from getClaims.

v2.107.0-beta.1
May 27, 2026

This release was a version bump only, containing no functional code changes.

v2.107.0-beta.0
May 26, 2026

This release was solely a version bump with no accompanying code changes.

v2.106.22 fixes
May 25, 2026

This patch release fixes an issue with the auth signup response and improves compatibility for React Native environments using Hermes.

v2.106.2-canary.1
May 22, 2026

This was a version bump only, there were no code changes.

v2.106.2-canary.02 fixes
May 22, 2026

This canary release primarily focuses on fixing an issue with the auth signup user response and improving compatibility for React Native environments.

v2.106.2-beta.2
May 22, 2026

This release was a version bump only, containing no functional code changes.

v2.106.2-beta.0
May 21, 2026

This release was solely a version bump with no accompanying code changes.

v2.106.12 fixes
May 20, 2026

This patch release fixes an issue with client-id encoding in OAuth requests and hides dynamic imports from hermesc.

v2.106.1-canary.11 fix
May 20, 2026

This canary release primarily addresses an internal issue by hiding a dynamic import from hermesc.

v2.106.1-beta.32 fixes
May 20, 2026

This beta release primarily focuses on bug fixes, including ensuring the client-id is encoded in OAuth requests and resolving an OpenTelemetry import issue.

v2.106.1-canary.01 fix
May 20, 2026

This canary release fixes an issue where the client-id was not being encoded correctly in OAuth requests.

v2.106.1-beta.22 fixes
May 20, 2026

This patch release primarily addresses an authentication bug by ensuring the client-id is encoded in OAuth requests and resolves an OpenTelemetry import issue.

v2.106.1-beta.11 fix
May 19, 2026

This beta release primarily focuses on minor fixes, including resolving an issue with OpenTelemetry imports.

v2.106.1-beta.02 fixes
May 19, 2026

This beta release primarily addresses an OpenTelemetry import issue and includes the addition of new tests.

v2.106.03 fixes1 feature
May 18, 2026

This release introduces W3C/OpenTelemetry trace context propagation for Supabase and includes several fixes related to auth verification and storage stream handling.

v2.106.0-canary.4
May 15, 2026

This release was solely a version bump with no accompanying code changes.

v2.106.0-canary.3
May 15, 2026

This release was solely a version bump with no accompanying code changes.

v2.106.0-canary.2
May 14, 2026

This release was a version bump only, containing no functional code changes.

v2.105.5-beta.101 fix1 feature
May 14, 2026

This beta release introduces W3C/OpenTelemetry trace context propagation for Supabase operations and addresses internal packaging for the tracing module.

v2.106.0-canary.11 fix
May 13, 2026

This canary release primarily focuses on internal maintenance by marking the @supabase/tracing package as private and snapshotting it for JSR.

v2.105.5-beta.91 fix1 feature
May 13, 2026

This beta release introduces W3C/OpenTelemetry trace context propagation for Supabase and includes internal packaging fixes for the tracing module.

v2.106.0-canary.01 feature
May 13, 2026

This canary release introduces W3C/OpenTelemetry trace context propagation support for Supabase operations.

v2.105.5-beta.8
May 13, 2026

This release (2.105.5-beta.8) was strictly a version bump with no accompanying code changes.

v2.105.5-beta.5
May 13, 2026

This release was a version bump only, containing no functional code changes.

v3.0.0-next.29
May 11, 2026

This was a version bump only, there were no code changes.

v2.105.5-beta.0Breaking14 fixes2 features
May 11, 2026

This beta release introduces significant new features, including WebAuthn passkey support in Auth and deferred disconnect in Realtime. It also includes several bug fixes, notably ensuring errors are consistently wrapped as PostgrestError and modifying the Storage 'exists' behavior.

v2.105.43 fixes
May 8, 2026

This patch release focuses on stability fixes across Auth, Postgrest, and Realtime modules, addressing JSON parsing errors, fetch abort detection, and storage access in restricted environments.

v2.105.4-canary.2
May 8, 2026

This release was solely a version bump with no accompanying code changes.

v3.0.0-next.28
May 8, 2026

This was a version bump only, there were no code changes.

v3.0.0-next.271 fix
May 8, 2026

This release primarily addresses a bug fix related to sessionStorage access in restricted-storage browsers within the realtime functionality.

v2.105.4-canary.11 fix
May 8, 2026

This canary release primarily addresses a bug related to accessing sessionStorage in restricted-storage browsers within the realtime module.

v2.105.4-canary.02 fixes
May 8, 2026

This canary release addresses minor bugs in the auth and postgrest modules, specifically handling JSON parse failures and abort detection in fetch operations.

v3.0.0-next.261 fix
May 7, 2026

This release primarily addresses a bug in the auth module where getItemAsync failed on JSON parse errors, now correctly returning null.

v3.0.0-next.251 fix
May 7, 2026

This release primarily focuses on fixing an issue in the postgrest fetch catch mechanism related to abort detection.

v2.105.31 fix
May 4, 2026

This patch release primarily addresses a type-checking issue within the authentication module.

v3.0.0-next.241 fix
May 4, 2026

This release focuses on fixing type-checking issues related to OAuth and CustomProvider configurations.

v3.0.0-next.23
May 4, 2026

This was a version bump only, there were no code changes.

v2.105.25 fixes
May 4, 2026

This patch release focuses on stability and internal improvements, including unifying Postgrest signatures and enhancing serialization for auth errors.

v2.105.2-canary.4
May 4, 2026

This was a version bump only, there were no code changes.

v3.0.0-next.22
May 4, 2026

This was a version bump only, there were no code changes.

v2.105.2-canary.3
May 4, 2026

This was a version bump only, there were no code changes.

v3.0.0-next.21
May 4, 2026

This was a version bump only, there were no code changes.

v2.105.2-canary.23 fixes
May 4, 2026

This canary release focuses on minor fixes, including improving JSON serialization for WebAuthnError and unifying Postgrest insert/upsert signatures.

v3.0.0-next.201 fix
May 4, 2026

This release primarily focuses on a bug fix related to JSON serialization for WebAuthnError.

v3.0.0-next.191 fix
May 4, 2026

This release primarily focuses on a bug fix related to forwarding the lockAcquireTimeout setting within the authentication client.

v2.105.2-canary.11 fix
May 4, 2026

This canary release primarily addresses a bug by forwarding the lockAcquireTimeout setting to the SupabaseAuthClient.

v3.0.0-next.182 fixes
Apr 30, 2026

This release focuses on internal improvements, specifically reducing 'any' usage and unifying Postgrest insert/upsert signatures.

v3.0.0-next.17Breaking1 fix
Apr 29, 2026

This release primarily focuses on improving error handling within the Postgrest client by ensuring all processResponse errors are wrapped in a PostgrestError instance, which constitutes a breaking change for error handling logic.

v2.105.2-canary.01 fix
Apr 28, 2026

This canary release primarily addresses a fix related to widening enum-like unions for better forward compatibility.

v3.0.0-next.16
Apr 28, 2026

This was a version bump only, there were no code changes.

v3.0.0-next.15Breaking3 fixes
Apr 28, 2026

This release introduces a significant change in the Storage `exists` method behavior, preventing errors when files are not found, and improves Realtime error surfacing and general forward compatibility.

v2.105.12 fixes
Apr 28, 2026

This patch release addresses a query reassignment regression in postgrest and improves error surfacing for transport-level CHANNEL_ERROR in realtime.

v2.105.1-canary.21 fix
Apr 28, 2026

This canary release primarily fixes an issue where real errors were not being surfaced correctly at the transport level for realtime channels.

v3.0.0-next.141 fix
Apr 28, 2026

This release focuses on a bug fix within the realtime transport layer, ensuring proper error surfacing.

Common Errors

SelectQueryError6 reports

SelectQueryError often arises from type mismatches or ambiguities when the TypeScript compiler cannot infer the correct return type of a `select` query, especially after using `rpc` or joins across schemas. Explicitly provide the type expected in the `select` statement using `<Type>` or ensure your database schema definitions are accurately reflected in your TypeScript types, potentially widening type definitions to accommodate all possible return structures. Review your type mappings thoroughly, ensuring column names and types align with the database schema, and consider using `infer` for complex type inference.

StorageUnknownError3 reports

"StorageUnknownError" often arises from network instability or server-side issues during file operations. Implement retry logic with exponential backoff around storage calls to handle transient network problems and ensure your Supabase project has adequate resources, checking Supabase status pages for potential outages. Examine server-side logs for detailed error messages if retries fail to isolate and address the underlying problem.

AuthSessionMissingError3 reports

The "AuthSessionMissingError" in supabase-js usually arises when the client attempts to access or manipulate authentication state (like signing out) before the initial authentication session has been established or after it has expired/been cleared unexpectedly. To fix this, ensure your app properly initializes Supabase auth on startup, checks for an existing session, and handles session expiry gracefully by re-authenticating or redirecting the user to login if necessary before attempting operations like `signOut`. Consider using `supabase.auth.getSession()` to check the session state before calling `signOut`.

AuthApiError3 reports

AuthApiError usually indicates a problem with the data you're sending to the Supabase Auth API, commonly due to missing or invalid parameters like the auth code, code verifier, or refresh token during authentication flows (especially OAuth or code exchange). Double-check that all required parameters are present and correctly formatted according to the Supabase documentation for the specific authentication method you are using. Ensure that parameters like the 'code_verifier' generated during sign-in are properly stored and used during the exchange process.

StorageApiError1 report

StorageApiError in supabase-js often arises from incorrect file paths or insufficient permissions within your Supabase storage bucket. Double check that the file path provided in your `upload` or `download` function exists and aligns with your bucket's structure. Additionally, review your bucket's policies in the Supabase dashboard to ensure the user has the necessary read/write access for the specified path.

AuthRetryableFetchError1 report

AuthRetryableFetchError in supabase-js usually indicates network connectivity issues or incorrect Supabase URL/anon key, especially after OTA updates in environments like Expo where the app's configuration might be temporarily out of sync. Verify your Supabase URL and anon key are correctly set and accessible from the updated app version, and consider implementing a retry mechanism with exponential backoff for auth calls to handle transient network problems. Ensure your build environment is correctly configured to inject the correct environment variables.

Related Backend & Infra Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed