Hi there! Are you looking for the official Deno documentation? Try docs.deno.com for all your Deno learning needs.

§Classes

AuthApiError

Error returned directly from the GoTrue REST API.

AuthError

Base error thrown by Supabase Auth helpers.

AuthImplicitGrantRedirectError

Error thrown when implicit grant redirects contain an error.

AuthInvalidCredentialsError

Error thrown when email/password credentials are invalid.

AuthInvalidJwtError

Error thrown when a JWT cannot be verified or parsed.

AuthInvalidTokenResponseError

Error thrown when the token response is malformed.

AuthPKCEGrantCodeExchangeError

Error thrown during PKCE code exchanges.

AuthRetryableFetchError

Error thrown when a transient fetch issue occurs.

AuthSessionMissingError

Error thrown when an operation requires a session but none is present.

AuthUnknownError

Wraps non-standard errors so callers can inspect the root cause.

AuthWeakPasswordError

Error thrown when a supplied password is considered weak.

CustomAuthError

Flexible error class used to create named auth errors at runtime.

FunctionsError

Base error for Supabase Edge Function invocations.

FunctionsFetchError

Error thrown when the network request to an Edge Function fails.

FunctionsHttpError

Error thrown when the Edge Function returns a non-2xx status code.

FunctionsRelayError

Error thrown when the Supabase relay cannot reach the Edge Function.

GoTrueAdminApi
GoTrueClient
NavigatorLockAcquireTimeoutError

Error thrown when the browser Navigator Lock API fails to acquire a lock.

PostgrestError

Error format

RealtimeChannel

A channel is the basic building block of Realtime and narrows the scope of data flow to subscribed clients. You can think of a channel as a chatroom where participants are able to see who's online and send and receive messages.

RealtimeClient
RealtimePresence
SupabaseClient

Supabase Client.

WebSocketFactory

Utilities for creating WebSocket instances across runtimes.

§Enums

FunctionRegion
REALTIME_LISTEN_TYPES
REALTIME_POSTGRES_CHANGES_LISTEN_EVENT
REALTIME_PRESENCE_LISTEN_EVENTS
REALTIME_SUBSCRIBE_STATES

§Variables

AuthAdminApi
AuthClient
createClient

Creates a new Supabase Client.

lockInternals
REALTIME_CHANNEL_STATES
SIGN_OUT_SCOPES

§Functions

isAuthApiError
isAuthError
isAuthImplicitGrantRedirectError
isAuthRetryableFetchError
isAuthSessionMissingError
isAuthWeakPasswordError
navigatorLock

Implements a global exclusive lock using the Navigator LockManager API. It is available on all browsers released after 2022-03-15 with Safari being the last one to release support. If the API is not available, this function will throw. Make sure you check availablility before configuring GoTrueClient.

processLock

Implements a global exclusive lock that works only in the current process. Useful for environments like React Native or other non-browser single-process (i.e. no concept of "tabs") environments.

§Interfaces

AdminUserAttributes
AMREntry

An authentication methord reference (AMR) entry.

AuthOAuthServerApi

Contains all OAuth 2.1 authorization server user-facing methods. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

AuthSession
AuthUser
GenerateLinkOptions
GoTrueAdminMFAApi

Contains the full multi-factor authentication administration API.

GoTrueAdminOAuthApi

Contains all OAuth client administration methods. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

GoTrueMFAApi

Contains the full multi-factor authentication API.

JWK
JwtPayload

JWT Payload containing claims for Supabase authentication tokens.

Session
Subscription
User
UserAppMetadata
UserAttributes
UserIdentity
UserMetadata
VerifyEmailOtpParams
VerifyMobileOtpParams
VerifyTokenHashParams
WebSocketLike
WebSocketLikeConstructor

Minimal WebSocket constructor interface that RealtimeClient can work with. Supply a compatible implementation (native WebSocket, ws, etc) when running outside the browser.

§Type Aliases

AMRMethod
AuthChangeEvent
AuthChangeEventMFA
AuthenticatorAssuranceLevels
AuthFlowType
AuthMFAAdminDeleteFactorParams
AuthMFAAdminDeleteFactorResponse
AuthMFAAdminListFactorsParams
AuthMFAAdminListFactorsResponse
AuthMFAChallengePhoneResponse
AuthMFAChallengeResponse
AuthMFAChallengeTOTPResponse
AuthMFAChallengeWebauthnResponse

Response type for WebAuthn MFA challenge. Contains credential creation or request options from the server.

AuthMFAChallengeWebauthnResponseDataJSON

JSON-serializable version of WebAuthn challenge response. Used for server communication with base64url-encoded binary fields.

AuthMFAChallengeWebauthnServerResponse

Server response type for WebAuthn MFA challenge. Contains JSON-formatted WebAuthn options ready for browser API.

AuthMFAEnrollPhoneResponse
AuthMFAEnrollResponse
AuthMFAEnrollTOTPResponse
AuthMFAEnrollWebauthnResponse

Response type for WebAuthn factor enrollment. Returns the enrolled factor ID and metadata.

AuthMFAGetAuthenticatorAssuranceLevelResponse
AuthMFAListFactorsResponse

response of ListFactors, which should contain all the types of factors that are available, this ensures we always include all

AuthMFAUnenrollResponse
AuthMFAVerifyResponse

Response type for MFA verification operations. Returns session tokens on successful verification.

AuthMFAVerifyResponseData

Data returned after successful MFA verification. Contains new session tokens and updated user information.

AuthOAuthAuthorizationDetailsResponse

Response type for getting OAuth authorization details. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

AuthOAuthConsentResponse

Response type for OAuth consent decision (approve/deny). Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

AuthOAuthGrantsResponse

Response type for listing user's OAuth grants. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

AuthOAuthRevokeGrantResponse

Response type for revoking an OAuth grant. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

AuthOtpResponse

AuthOtpResponse is returned when OTP is used.

AuthResponse
AuthResponsePassword
AuthTokenResponse
AuthTokenResponsePassword
CallRefreshTokenResult
CreateOAuthClientParams

Parameters for creating a new OAuth client. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

EmailOtpType
EthereumWallet
EthereumWeb3Credentials
Factor

A MFA factor.

FactorType

Type of factor. totp and phone supported with this version

FunctionInvokeOptions
GenerateEmailChangeLinkParams
GenerateInviteOrMagiclinkParams
GenerateLinkParams
GenerateLinkProperties

The properties related to the email link generated

GenerateLinkResponse
GenerateLinkType
GenerateRecoveryLinkParams
GenerateSignupLinkParams
GoTrueClientOptions
InitializeResult
JwtHeader
LockFunc

Provide your own global lock implementation instead of the default implementation. The function should acquire a lock for the duration of the fn async function, such that no other client instances will be able to hold it at the same time.

MFAChallengeAndVerifyParams
MFAChallengeParams
MFAChallengePhoneParams
MFAChallengeTOTPParams
MFAChallengeWebauthnParams

Parameters for initiating a WebAuthn MFA challenge. Includes Relying Party information needed for WebAuthn ceremonies.

MFAEnrollParams
MFAEnrollPhoneParams
MFAEnrollTOTPParams
MFAEnrollWebauthnParams

Parameters for enrolling a WebAuthn factor. Creates an unverified WebAuthn factor that must be verified with a credential.

MFATOTPChannel
MFAUnenrollParams
MFAVerifyParams
MFAVerifyPhoneParams
MFAVerifyTOTPParams
MFAVerifyWebauthnParamFields

WebAuthn-specific fields for MFA verification. Supports both credential creation (registration) and request (authentication) flows.

MFAVerifyWebauthnParams

Parameters for WebAuthn MFA verification. Used to verify WebAuthn credentials after challenge.

MobileOtpType
OAuthAuthorizationClient

OAuth client details in an authorization request. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthAuthorizationDetails

OAuth authorization details for the consent flow. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthClient

OAuth client object returned from the OAuth 2.1 server. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthClientGrantType

OAuth client grant types supported by the OAuth 2.1 server. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthClientListResponse

Response type for listing OAuth clients. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthClientRegistrationType

OAuth client registration type. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthClientResponse

Response type for OAuth client operations. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthClientResponseType

OAuth client response types supported by the OAuth 2.1 server. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthClientType

OAuth client type indicating whether the client can keep credentials confidential. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthGrant

An OAuth grant representing a user's authorization of an OAuth client. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

OAuthResponse
PageParams
Pagination
PostgrestMaybeSingleResponse
PostgrestResponse
PostgrestSingleResponse
Prettify

Resolve mapped types and show the derived keys and their types when hovering in VS Code, instead of just showing the names those mapped types are defined with.

Provider

One of the providers supported by GoTrue.

QueryData
QueryError
QueryResult

Helper types for query results.

RealtimeChannelOptions
RealtimeChannelSendResponse
RealtimeClientOptions
RealtimeMessage
RealtimePostgresChangesFilter
RealtimePostgresChangesPayload
RealtimePostgresDeletePayload
RealtimePostgresInsertPayload
RealtimePostgresUpdatePayload
RealtimePresenceJoinPayload
RealtimePresenceLeavePayload
RealtimePresenceState
RealtimeRemoveChannelResponse
RequestResult

a shared result type that encapsulates errors instead of throwing them, allows you to optionally specify the ErrorType

RequestResultSafeDestructure

similar to RequestResult except it allows you to destructure the possible shape of the success response {@see RequestResult}

RequiredClaims
ResendParams
SignInAnonymouslyCredentials
SignInWithIdTokenCredentials
SignInWithOAuthCredentials
SignInWithPasswordCredentials
SignInWithPasswordlessCredentials
SignInWithSSO
SignOut
SignOutScope
SignUpWithPasswordCredentials
SolanaWallet
SolanaWeb3Credentials
SSOResponse
StrictOmit

A stricter version of TypeScript's Omit that only allows omitting keys that actually exist. This prevents typos and ensures type safety at compile time. Unlike regular Omit, this will error if you try to omit a non-existent key.

SupabaseClientOptions
SupportedStorage
UpdateOAuthClientParams

Parameters for updating an existing OAuth client. All fields are optional. Only provided fields will be updated. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.

UserResponse
VerifyOtpParams
WeakPassword
WeakPasswordReasons
Web3Credentials