Change8

Supabase Auth

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.103.2-canary.2100 releases13 common errorsView on GitHub

Release History

v2.103.2-canary.212 fixes3 features
3h ago

This canary release introduces null stripping for Postgrest, a cacheNonce option for Storage downloads, and exports key builder/error types. Several bug fixes address serialization, error handling, and content-type issues across auth, functions, postgrest, and storage modules.

v2.103.2-canary.111 fixes3 features
3h ago

This canary release introduces new methods for null stripping in Postgrest and a cacheNonce option for Storage downloads, alongside numerous fixes for error serialization and various component behaviors.

v2.103.2-canary.010 fixes3 features
4h ago

This canary release introduces new methods for null stripping in Postgrest and a cacheNonce parameter for Storage downloads, alongside numerous serialization and header handling fixes across auth, functions, postgrest, and storage modules.

v2.103.14 fixes
7h ago

This patch release focuses on bug fixes, primarily ensuring correct JSON serialization for AuthError and StorageError, and improving handling for bigint RPCs and storage operations.

v2.103.1-canary.09 fixes3 features
7h ago

This canary release introduces new methods for null stripping in Postgrest and a cacheNonce parameter for Storage downloads, alongside numerous serialization and type inference fixes across auth, storage, and postgrest modules.

v2.103.1-beta.02 fixes
Apr 9, 2026

This beta release primarily addresses an internal change in the auth module by switching the default browser lock mechanism and includes related testing improvements.

v2.103.01 fix2 features
Apr 9, 2026

This release introduces new functionality for null stripping in postgrest and a cache nonce parameter for storage downloads, alongside a fix for scalar computed column type inference.

v2.103.0-canary.25 fixes3 features
Apr 9, 2026

This canary release introduces new methods for null stripping in Postgrest and cache nonce control in Storage, alongside several bug fixes across Auth, Functions, Postgrest, and Storage modules.

v2.103.0-canary.15 fixes2 features
Apr 9, 2026

This canary release introduces a new cacheNonce parameter for storage downloads and exports PostgrestFilterBuilder and StorageApiError. It also includes several bug fixes across auth, functions, postgrest, and storage modules.

v2.102.2-canary.05 fixes1 feature
Apr 8, 2026

This release introduces exports for PostgrestFilterBuilder and StorageApiError from supabase-js, alongside several bug fixes across auth, functions, postgrest, and storage modules.

v2.102.11 fix
Apr 7, 2026

This patch release addresses a serialization issue by adding a toJSON method to FunctionsError.

v2.102.1-canary.04 fixes1 feature
Apr 7, 2026

This canary release introduces exports for PostgrestFilterBuilder and StorageApiError from supabase-js, alongside several bug fixes related to logging, error serialization, and storage content-type handling.

v2.102.06 fixes3 features
Apr 7, 2026

This release introduces automatic retries for transient PostgREST errors and exports key types like PostgrestFilterBuilder and StorageApiError. Several fixes address serialization, content-type handling in Storage, and logging in Auth.

v2.102.0-canary.53 fixes1 feature
Apr 7, 2026

This canary release introduces exports for PostgrestFilterBuilder and StorageApiError from supabase-js, alongside several fixes related to auth logging and storage content-type handling.

v2.102.0-canary.42 fixes
Apr 7, 2026

This canary release primarily focuses on fixing content-type header issues in storage operations, specifically for uploads and vector requests.

v2.102.0-canary.31 fix
Apr 6, 2026

This canary release primarily addresses a bug related to setting the correct content-type for storage uploads.

v2.102.0-canary.21 fix
Apr 3, 2026

This canary release primarily addresses a bug related to setting the correct content-type during storage uploads.

v2.102.0-canary.1
Apr 3, 2026

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

v2.102.0-canary.01 fix1 feature
Apr 2, 2026

This canary release introduces automatic retries for transient errors in postgrest operations and enhances CI security by ignoring installation scripts during platform tests.

v2.102.0-beta.02 fixes2 features
Mar 31, 2026

This beta release introduces automatic retries for transient errors in postgrest and includes several fixes related to error handling and snapshot updates.

v2.101.11 fix
Mar 31, 2026

This patch release primarily addresses a bug fix related to property typing within the storage module.

v2.101.1-canary.01 fix
Mar 31, 2026

This canary release primarily addresses a bug fix related to property types in the storage module.

v2.101.02 features
Mar 30, 2026

This release introduces new functionality to realtime, including `copyBindings` and improved event listener management.

v2.101.0-canary.0
Mar 30, 2026

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

v2.100.0-canary.91 feature
Mar 30, 2026

This canary release introduces a feature to prevent setting the 'postgres_changes' event listener after a Realtime connection has been established.

v2.100.0-canary.81 feature
Mar 30, 2026

This canary release introduces the new `copyBindings` functionality within the realtime module.

v2.100.15 fixes
Mar 26, 2026

This patch release focuses on bug fixes across the postgrest and storage modules, including improved type safety and request handling.

v2.100.0-canary.71 fix
Mar 26, 2026

This canary release primarily addresses a bug fix in the storage module related to spreading default file options during signed URL uploads.

v2.100.0-canary.61 fix
Mar 26, 2026

This canary release primarily addresses a bug in postgrest related to the classification of Args: never functions.

v2.100.0-canary.52 fixes
Mar 26, 2026

This canary release primarily addresses a bug in postgrest related to maybeSingle functionality by removing an Accept header override and refines testing configurations.

v2.100.0-canary.41 fix
Mar 23, 2026

This canary release primarily focuses on improving type safety within the postgrest client for equality checks.

v2.100.03 fixes1 feature
Mar 23, 2026

This release introduces an update to the realtime client to use Phoenix's JS library and includes several bug fixes across auth, realtime, and storage modules.

v2.100.0-canary.3
Mar 20, 2026

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

v2.100.0-canary.2
Mar 19, 2026

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

v2.100.0-canary.12 fixes
Mar 19, 2026

This canary release includes fixes for authentication lock handling and improved error detection in storage operations.

v2.99.32 fixes
Mar 19, 2026

This patch release addresses specific bugs in the Auth and Storage modules, improving request handling and error detection.

v2.100.0-canary.01 fix
Mar 17, 2026

This canary release primarily addresses a bug fix in the realtime module by reverting the `vsn` type to string.

v2.100.0-rc.0
Mar 16, 2026

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

v2.99.3-canary.01 feature
Mar 16, 2026

This canary release introduces an internal update to the Realtime client, leveraging Phoenix's JavaScript library for improved functionality.

v2.99.21 fix
Mar 16, 2026

This patch release addresses a specific bug in the Storage module related to signed URL generation for empty transform objects.

v2.99.2-canary.01 fix
Mar 13, 2026

This canary release primarily addresses a bug in the Storage module related to signed URL generation for empty transform objects.

v2.99.11 fix
Mar 11, 2026

This patch release adds the RateLimitError to the Deno.errors namespace within the functions module.

v2.99.1-canary.01 fix
Mar 11, 2026

This canary release primarily addresses a bug fix by adding RateLimitError to the Deno.errors namespace.

v2.99.01 fix1 feature
Mar 9, 2026

This release introduces new administrative CRUD methods for custom OIDC/OAuth providers in the auth module and fixes an issue related to FileObject type accuracy in storage.

v2.98.1-canary.11 fix
Mar 5, 2026

This canary release primarily focuses on improving type accuracy for FileObject within the storage module.

v2.98.1-canary.01 feature
Feb 27, 2026

This canary release introduces new administrative CRUD capabilities for custom OIDC/OAuth providers within the auth module.

v2.98.04 fixes3 features
Feb 26, 2026

This release introduces new features for OAuth client configuration and custom providers in the auth module, alongside several bug fixes addressing lock recovery and Realtime connection handling.

v2.97.1-canary.51 fix
Feb 26, 2026

This canary release primarily addresses a bug fix related to userattributes typing within the authentication module.

v2.97.1-canary.41 fix
Feb 25, 2026

This canary release primarily addresses a bug in the Realtime module related to patching channel join payloads with the access token.

v2.97.1-canary.32 features
Feb 24, 2026

This canary release introduces support for custom authentication providers and updates the UserAttributes type with the currentPassword field.

v2.97.1-canary.21 feature
Feb 24, 2026

This canary release introduces a new configuration option for OAuth clients within the auth module.

v2.97.1-canary.11 fix
Feb 19, 2026

This canary release primarily addresses an authentication fix by lowering the default lockAcquireTimeout and updating associated JSDoc.

v2.97.1-canary.01 fix
Feb 19, 2026

This canary release primarily addresses an issue in the authentication module by implementing a steal fallback to recover from orphaned navigator locks.

v2.97.01 feature
Feb 18, 2026

This release introduces the skipAutoInitialize option for the auth module to control constructor auto-initialization.

v2.96.1-canary.01 feature
Feb 18, 2026

This canary release introduces a new option to control automatic initialization within the auth module.

v2.96.03 fixes1 feature
Feb 17, 2026

This release introduces a new setHeader method for BaseApiClient in storage and includes several bug fixes across auth, postgrest, and realtime modules.

v2.95.4-canary.21 fix
Feb 12, 2026

This canary release primarily addresses a security-related bug fix concerning Firefox content scripts and authentication locks.

v2.95.4-canary.11 fix
Feb 11, 2026

This canary release primarily focuses on a bug fix within the Postgrest client to enforce type safety for table and view names in the from() method.

v2.95.4-canary.01 fix1 feature
Feb 10, 2026

This canary release introduces a new setHeader method for storage operations and fixes an unnecessary check in the realtime channel removal logic.

v2.95.32 fixes1 feature
Feb 6, 2026

This release introduces canonical CORS header export for Edge Functions and includes fixes for Realtime channel management and Storage download parameters.

v2.95.21 fix
Feb 5, 2026

This patch release primarily addresses a documentation issue by adding module information to the tsdoc for the supabase integration.

v2.95.2-canary.22 fixes
Feb 5, 2026

This canary release (2.95.2-canary.2) primarily addresses minor fixes, including testing compatibility with older ESM versions and a small addition to the core supabase functionality.

v2.95.2-canary.11 fix
Feb 5, 2026

This canary release primarily addresses a bug related to repository subpath handling.

v2.95.2-canary.01 fix
Feb 5, 2026

This canary release primarily addresses an ESM release issue within the repository.

v2.95.1
Feb 5, 2026

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

v2.95.02 fixes1 feature
Feb 5, 2026

This release introduces canonical CORS header export for Supabase edge functions and includes fixes for realtime channel management and storage download parameters.

v2.94.2-canary.02 fixes1 feature
Feb 5, 2026

This canary release introduces canonical CORS header export for Supabase edge functions and includes fixes for realtime channel management and storage download parameters.

v2.94.11 fix
Feb 4, 2026

This patch release fixes an issue where OAuth authorization types did not correctly match API responses in the auth module.

v2.94.1-canary.01 fix
Feb 4, 2026

This canary release primarily addresses an issue in the auth module by correcting OAuth authorization types to match API responses.

v2.94.01 fix1 feature
Feb 3, 2026

Version 2.94.0 introduces URL length validation and timeout protection for postgrest operations and resolves a CI script issue.

v2.93.4-canary.11 fix1 feature
Jan 30, 2026

This canary release introduces URL length validation and timeout protection for postgrest, alongside a fix for the CI release script.

v2.93.4-canary.02 fixes
Jan 29, 2026

This canary release primarily focuses on fixing internal CI/CD and authentication verification issues related to the canary build process.

v2.93.32 fixes
Jan 29, 2026

This patch release (2.93.3) focuses on minor fixes, including improvements to authentication fallback naming and handling of empty responses in storage vector operations.

v2.93.21 fix
Jan 27, 2026

This patch release reverts client platform and runtime detection headers for the supabase integration.

v2.93.2-canary.01 fix
Jan 27, 2026

This canary release primarily addresses a bug fix by reverting changes related to Supabase client platform and runtime detection headers.

v2.93.11 fix
Jan 26, 2026

This patch release reverts an unnecessary validation step in the realtime postgres_changes event dispatch mechanism.

v2.93.06 fixes2 features
Jan 26, 2026

This release introduces an optional jwt parameter for authentication assurance level and improves client platform detection by adding necessary HTTP headers. Several bug fixes address promise rejections, storage handling, and realtime connection errors.

v2.92.1-canary.01 fix
Jan 26, 2026

This canary release addresses an issue with environment detection for Supabase when running in Node.js versus browser contexts.

v2.92.1-rc.21 fix
Jan 23, 2026

This release includes a minor fix addressing an internal implementation detail within the Supabase integration.

v2.92.1-rc.11 fix
Jan 23, 2026

This release addresses a specific environment detection issue within the Supabase integration.

v2.91.3-rc.1
Jan 23, 2026

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

v2.91.3-rc.0
Jan 23, 2026

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

v2.91.2-rc.06 fixes2 features
Jan 23, 2026

This release introduces an optional JWT parameter for assurance level retrieval and improves client platform detection via HTTP headers. Several bug fixes address promise rejections, storage handling, and realtime connection errors.

v2.91.11 fix
Jan 23, 2026

This patch release primarily focuses on fixing an issue where SSR OAuth functionality was broken in the previous version.

v2.91.1-canary.31 feature
Jan 23, 2026

This canary release introduces an optional jwt parameter for the getAuthenticatorAssuranceLevel function in the auth module.

v2.91.1-canary.24 fixes1 feature
Jan 23, 2026

This canary release introduces improved platform detection via HTTP headers and fixes several bugs related to auth, realtime connections, and storage error reporting.

v2.91.1-canary.01 fix
Jan 21, 2026

This canary release primarily focuses on fixing an issue where SSR OAuth functionality was broken in the previous version.

v2.91.03 fixes1 feature
Jan 20, 2026

This release introduces an update to the default realtime serializer and includes several bug fixes related to auth operations and cross-context promise errors in Firefox.

v2.90.2-canary.21 fix
Jan 20, 2026

This canary release primarily addresses a clarification regarding the behavior of updateUserById in the auth module.

v2.90.2-canary.11 fix1 feature
Jan 20, 2026

This canary release introduces an update to the default serializer for realtime functionality and fixes a cross-context Promise error in the Firefox extension.

v2.90.2-canary.01 fix
Jan 12, 2026

This canary release primarily addresses a deadlock issue within the authentication flow by deferring subscriber notification.

v2.90.12 fixes
Jan 8, 2026

This patch release addresses critical bugs in postgrest query building and realtime event dispatch validation.

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

This canary release primarily addresses a bug in the PostgREST query builder to ensure proper isolation between operations.

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

This canary release primarily addresses a bug fix related to validating table filters during postgres_changes event dispatch.

v2.90.010 fixes1 feature
Jan 7, 2026

This release introduces the exposure of heartbeat latency in realtime callbacks and includes numerous bug fixes across auth, functions, postgrest, and general supabase types to improve stability and compatibility.

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

This canary release primarily addresses an authentication issue by introducing a configurable lock acquisition timeout to prevent deadlocks.

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

This canary release addresses two specific bugs related to function content-type handling and RPC head requests with object arguments in Postgrest.

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

This canary release fixes an issue where the user session was not preserved if a magic link was clicked twice.

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

This canary release primarily addresses a bug fix in the auth module related to clearing the initial setTimeout during auto-refresh stop.

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

This canary release primarily addresses an issue in the supabase integration to avoid edge runtime warnings within Next.js environments.

Common Errors

SelectQueryError6 reports

SelectQueryError in supabase-auth usually arises from type mismatches when the TypeScript compiler infers incorrect types after a database operation like `rpc()` or joins involving different schemas. To fix it, explicitly cast the returned data to the correct TypeScript type using `as` or define a more specific function return type using generics, ensuring the compiler understands the structure of the data you're selecting. This guarantees the expected schema and data types are aligned, resolving the mismatch.

AuthSessionMissingError3 reports

The "AuthSessionMissingError" usually occurs when the app tries to access or manipulate an authentication session (like signing out) before a session has been properly initialized or is no longer valid (e.g., expired or cleared). To fix this, ensure you have a valid Supabase client initialized and that a user session exists before attempting operations like signOut. If the session might be expired or cleared, handle the error gracefully by checking for a valid session before calling `signOut` or re-authenticating the user.

StorageUnknownError3 reports

The "StorageUnknownError" in supabase-auth often arises from inconsistent or corrupted data in the storage bucket's metadata or underlying storage system, or from temporary unavailability/glitches in Supabase's storage service. To resolve, try retrying the operation (especially uploads) after a short delay to see if it was transient; if the error persists, investigate and consider refreshing/resetting your storage bucket, using Supabase's dashboard, if data corruption is suspected. If that doesn't fix it, contact Supabase support.

AuthApiError3 reports

The "AuthApiError" in supabase-auth often arises from incorrect or missing configuration, particularly with environment variables or authentication providers. Double-check that your Supabase project URL and anon key are correctly set in your application and that any external authentication providers (like Google, phone auth) are properly configured and enabled in your Supabase project dashboard. Verify that your code handling authentication flows, especially `exchangeCodeForSession` or similar methods, correctly provides all required parameters like the auth code and code verifier (if applicable), ensuring they are non-empty.

FunctionsRelayError1 report

FunctionsRelayError usually indicates a mismatch between the supabase-js client version and the Supabase project's Functions relay version, or a misconfiguration in the Functions URL. Upgrade your supabase-js client to the latest version matching your project's expected Functions relay and diligently verify that your Functions URL in the client's configuration is correct and accessible. Ensure that the Supabase Functions runtime URL is correctly set in your Supabase project settings.

ReferenceError1 report

The "ReferenceError: window is not defined" error usually occurs because `window` is a browser-specific object and your code is running in a server-side environment (like Next.js SSR, Node.js) where it doesn't exist. To fix this, conditionally use browser-specific code only when running in the browser, commonly achieved using a check like `typeof window !== 'undefined'` before accessing `window` or by lazy-loading the supabase-auth client within a `useEffect` hook in React/Next.js. If using Next.js, consider using dynamic imports with `ssr: false`.

Related Backend & Infra Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed