shaple library

Classes

AddPartitionSpecUpdate
AddSchemaUpdate
AddSortOrderUpdate
AdminUserAttributes
AMREntry
An authentication method reference (AMR) entry.
AnalyticsBucket
A bucket backed by the Apache Iceberg table format, used for structured analytical data storage.
ApiVersions
AssertCreate
AssertCurrentSchemaId
AssertDefaultSortOrderId
AssertDefaultSpecId
AssertLastAssignedFieldId
AssertLastAssignedPartitionId
AssertReferenceSnapshotId
AssertTableUuid
AssignUuidUpdate
AuthClientOptions
AuthMFAAdminDeleteFactorResponse
AuthMFAAdminListFactorsResponse
AuthMFAChallengeResponse
AuthMFAEnrollResponse
AuthMFAGetAuthenticatorAssuranceLevelResponse
AuthMFAListFactorsResponse
AuthMFAUnenrollResponse
AuthMFAVerifyResponse
AuthResponse
Response which might or might not contain session and/or user
AuthSessionUrlResponse
AuthState
Bucket
BucketOptions
public The visibility of the bucket. Public buckets don't require an authorization token to download objects, but still require a valid token for all other operations. By default, buckets are private.
CommitTableResult
The result of committing updates to a table.
CreateCustomProviderParams
Parameters for creating a new custom provider.
CreateOAuthClientParams
Parameters for creating a new OAuth client. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.
CreateTableRequest
Request describing a table to create.
CustomOAuthProvider
Custom OAuth/OIDC provider object returned from the admin API.
DecodedJwt
Decoded JWT structure
DownloadBehavior
Controls download behavior for signed and public URLs.
Factor
FileObject
FileObjectV2
FileOptions
FileSort
The column and direction that StorageFileApi.listPaginated sorts its results by.
GenerateLinkProperties
GenerateLinkResponse
GetClaimsOptions
Options for getClaims method
GetClaimsResponse
Response from getClaims method
GoTrueAdminApi
GoTrueAdminPasskeyApi
Admin methods for managing the passkeys of users.
GotrueAsyncStorage
Interface to provide async storage to store pkce tokens.
GoTrueClient
API client to interact with gotrue server.
GoTrueMFAApi
GoTrueOAuthApi
API namespace for the OAuth 2.1 authorization server consent flow.
GoTruePasskeyApi
API namespace for passkey (WebAuthn) authentication.
IcebergRestCatalog
Client for the Apache Iceberg REST Catalog exposed by Supabase Storage under an analytics bucket. It manages namespaces and tables within a warehouse (an analytics bucket).
IcebergType
A type in the Iceberg type system. Either a PrimitiveType represented by a type string, or one of the nested types StructType, ListType and MapType.
JWK
JSON Web Key (JWK) representation.
JWKSet
JwtHeader
JWT Header structure
JwtPayload
JWT Payload structure with standard claims
JwtRawParts
Raw encoded parts of a JWT
ListBucketsOptions
Filter, sort and pagination options for StorageBucketApi.listBuckets.
ListNamespacesOptions
Options for listing namespaces.
ListNamespacesResult
The result of listing namespaces.
ListTablesOptions
Options for listing tables.
ListTablesResult
The result of listing tables in a namespace.
ListType
A list type whose elements are of type element.
LoadTableOptions
Options for loading a table.
LoadTableResult
The full result of loading, creating or registering a table, including the server provided configuration, vended storage credentials and the response ETag.
MapType
A map type with keys of type key and values of type value.
OAuthAuthorizationDetailsResponse
Response type representing the details of a pending OAuth authorization request that still requires the user's consent.
OAuthAuthorizationRedirectResponse
Response type returned when the signed-in user has already granted consent to the requesting client.
OAuthAuthorizationResponse
Result returned by GoTrueOAuthApi.getAuthorizationDetails.
OAuthAuthorizedClient
OAuth client object returned from the OAuth 2.1 server when the client is authorized.
OAuthClient
OAuth client object returned from the OAuth 2.1 server. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.
OAuthConsentResponse
Response type for an OAuth authorization consent decision (approve or deny).
OAuthProvider
An OAuth provider identifier.
OAuthResponse
Response of OAuth signin
OIDCDiscoveryDocument
OIDC discovery document fields.
PaginatedFile
A file entry returned by StorageFileApi.listPaginated.
PaginatedFolder
A folder entry returned by StorageFileApi.listPaginated when using a delimiter.
PaginatedListResult
The result of StorageFileApi.listPaginated.
PaginatedSearchOptions
Options for StorageFileApi.listPaginated.
PartitionField
A single field of a PartitionSpec.
PartitionSpec
Describes how a table is partitioned.
Passkey
A passkey (WebAuthn credential) registered to a user.
PasskeyAuthenticationOptionsResponse
Response containing the options needed to sign in with a passkey.
PasskeyRegistrationOptionsResponse
Response containing the options needed to register a new passkey.
PhoneEnrollment
PostgrestBuilder<T, S, R>
The base builder class.
PostgrestClient
A PostgREST api client written in Dartlang. The goal of this library is to make an "ORM-like" restful interface.
PostgrestClientOptions
PostgrestFilterBuilder<T>
PostgrestQueryBuilder<T>
The query builder class provides a convenient interface to creating request queries.
PostgrestResponse<T>
A Postgrest response
PostgrestRpcBuilder
PostgrestTransformBuilder<T>
PrimitiveType
A primitive Iceberg type such as int, string, decimal(10,2) or fixed[16].
RawPostgrestBuilder<T, S, R>
Needed as a wrapper around PostgrestBuilder to allow for the different return type of withConverter than in ResponsePostgrestBuilder.withConverter.
RawTableUpdate
RegisterTableRequest
Request to register an existing metadata file as a table.
RemovePartitionSpecsUpdate
RemovePropertiesUpdate
RemoveSchemasUpdate
RemoveSnapshotReferenceUpdate
RemoveSnapshotsUpdate
ResendResponse
ResponsePostgrestBuilder<T, S, R>
Needed as a wrapper around PostgrestBuilder to allow for the different return type of withConverter than in RawPostgrestBuilder.withConverter.
SearchOptions
Session
SetCurrentSchemaUpdate
SetDefaultSortOrderUpdate
SetDefaultSpecUpdate
SetLocationUpdate
SetPropertiesUpdate
SetSnapshotReferenceUpdate
ShapleClient
SignedUploadURLResponse
SignedUrl
SignedUrlFailure
A failed SignedUrlResult: the path could not be signed (e.g. the file does not exist).
SignedUrlResult
Represents a per-item result from StorageFileApi.createSignedUrlsResult.
SignedUrlSuccess
A successful SignedUrlResult: the file was found and a signed URL was generated.
Snapshot
A snapshot of a table at a point in time.
SnapshotReference
A reference (branch or tag) pointing at a snapshot.
SortBy
SortField
A single field of a SortOrder.
SortOrder
Describes how a table is sorted when written.
StorageClientOptions
StorageCredential
Temporary storage credentials vended by the server for a table path prefix.
StorageFileApi
StorageRetryController
StorageVectorBucketApi
Index operations scoped to a single vector bucket.
StorageVectorIndexApi
Vector data operations scoped to a single index within a bucket.
StructType
A nested struct type containing fields.
SupabaseStorageClient
SupabaseVectorsClient
Client for the Storage Vectors API, reachable through supabase.storage.vectors.
TableField
A field within a StructType or a TableSchema.
TableIdentifier
Identifies a table by its namespace and name.
TableMetadata
Metadata describing the current state of a table, returned when loading or committing to a table.
TableRequirement
A precondition that must hold for a table commit to be applied. The server rejects the commit if any requirement is not met.
TableSchema
The schema of a table, a struct of fields.
TableUpdate
A single change applied to a table as part of a commit. The common data definition updates are modelled as dedicated subclasses. Updates that are not modelled (for example snapshot, statistics and encryption key updates) can be sent with TableUpdate.raw.
TOTPEnrollment
TransformOptions
Specifies the dimensions and the resize mode of the requesting image.
UpdateCustomProviderParams
Parameters for updating an existing custom provider.
UpdateNamespacePropertiesResult
The result of a namespace properties update.
UpdateOAuthClientParams
Parameters for updating an existing OAuth client. Only relevant when the OAuth 2.1 server is enabled in Supabase Auth.
UpgradeFormatVersionUpdate
User
UserAttributes
UserIdentity
UserResponse
Response that contains a user
Vector
A single vector to insert or update through StorageVectorIndexApi.putVectors.
VectorBucket
Metadata describing a vector bucket.
VectorBucketEncryption
Encryption settings attached to a vector bucket.
VectorBucketList
The result of SupabaseVectorsClient.listBuckets.
VectorIndex
Metadata describing a vector index within a bucket.
VectorIndexList
The result of StorageVectorBucketApi.listIndexes.
VectorList
The result of StorageVectorIndexApi.listVectors.
VectorMatch
A vector returned from a get, list or query operation.
VectorQueryResult
The result of StorageVectorIndexApi.queryVectors.

Enums

AccessDelegation
Access delegation mechanisms that can be requested from the server for table read and write operations.
AMRMethod
AuthChangeEvent
AuthenticatorAssuranceLevels
AuthFlowType
BucketSortColumn
The column that StorageBucketApi.listBuckets can sort its results by.
BucketSortOrder
The direction that StorageBucketApi.listBuckets sorts its results in.
CountOption
Returns count as part of the response when specified.
CustomProviderType
Type of a custom OAuth/OIDC provider managed through the admin API.
DistanceMetric
Distance metric used when comparing vectors during a similarity search.
ErrorCode
ExplainFormat
The format of the plan returned by PostgrestTransformBuilder.explain.
FactorStatus
FactorType
FileSortColumn
The column that StorageFileApi.listPaginated can sort its results by.
FileSortOrder
The direction that StorageFileApi.listPaginated sorts its results in.
GenerateLinkType
HttpMethod
LoadTableSnapshots
Which snapshots the server should include when loading a table.
NullOrder
Where null values are ordered relative to non null values in a SortField.
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.
OAuthClientRegistrationType
OAuth client registration type. 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.
OtpChannel
Messaging channel to use (e.g. whatsapp or sms)
OtpType
RequestImageFormat
ResizeMode
Specifies how image cropping should be handled when performing image transformations.
ReturningOption
Returns count as part of the response when specified.
SignOutReason
The reason why an AuthChangeEvent.signedOut event was emitted.
SignOutScope
Determines which sessions should be logged out.
SnapshotReferenceType
The kind of reference a SnapshotReference points to.
SortDirection
The direction used when sorting a SortField.
TextSearchType
The type of tsquery conversion to use on query.
VectorDataType
Supported data types for vector components.

Constants

version → const String

Functions

decodeJwt(String token) → DecodedJwt
Decodes a JWT token without performing validation
validateExp(int? exp) → void
Validates the expiration time of a JWT

Typedefs

BroadcastChannel = ({void Function() close, Stream<Map<String, dynamic>> onMessage, void Function(Map) postMessage})
Headers = Map<String, String>
PostgrestConverter<S, T> = S Function(T data)
PostgrestList = List<PostgrestMap>
PostgrestListResponse = PostgrestResponse<PostgrestList>
PostgrestMap = Map<String, dynamic>
PostgrestMapResponse = PostgrestResponse<PostgrestMap>

Exceptions / Errors

AuthApiException
AuthException
AuthInvalidJwtException
AuthPKCEGrantCodeExchangeError
AuthRetryableFetchException
AuthSessionMissingException
AuthUnknownException
AuthWeakPasswordException
IcebergAuthenticationTimeoutException
Authentication timed out and the request should be retried with fresh credentials (HTTP 419).
IcebergCommitStateUnknownException
A table commit was sent but its outcome is unknown, so retrying it could duplicate data.
IcebergConflictException
The request conflicts with the current state, for example the resource already exists or a commit lost a race (HTTP 409).
IcebergException
Error thrown by IcebergRestCatalog operations when the Iceberg REST Catalog API returns an error response or a request fails at the network level.
IcebergNetworkException
A request failed at the network level, before any response was received.
IcebergNotFoundException
The requested namespace or table does not exist (HTTP 404).
IcebergServerException
The server failed to handle the request (HTTP 5xx).
IcebergUnknownException
Any Iceberg failure that does not fit a more specific subtype.
PostgrestException
A Postgrest response exception
RequestAbortedException
Thrown when an HTTP request is aborted.
StorageException