storage-kt/io.github.jan.supabase.storage

Package-level declarations

Types

@Serializable

data class Bucket( val createdAt: Instant, val id: String, val name: String, val owner: String, val updatedAt: Instant, val public: Boolean, val allowedMimeTypes: List<String>? = null, val fileSizeLimit: Long? = null)

Represents a storage bucket

BucketApi

sealed interface BucketApi

The api for interacting with a bucket

BucketBuilder

class BucketBuilder

A builder for Buckets

BucketListFilter

class BucketListFilter

A filter builder for BucketApi.list

DownloadOptionBuilder

class DownloadOptionBuilder( transform: ImageTransformation.() -> Unit = {}, httpRequestOverrides: MutableList<HttpRequestOverride> = mutableListOf())

Builder for downloading files with additional options

DownloadStatus

sealed interface DownloadStatus

Represents the status of a download

FileObject

@Serializable

data class FileObject( val name: String, val id: String?, val updatedAt: Instant?, val createdAt: Instant?, val lastAccessedAt: Instant?, val metadata: JsonObject?)

Represents a file or a folder in a bucket. If the item is a folder, everything except name is null.

FileObjectV2

@Serializable

data class FileObjectV2( val name: String, val id: String?, val version: String, val bucketId: String? = null, val updatedAt: Instant? = null, val createdAt: Instant, val lastAccessedAt: Instant? = null, val metadata: JsonObject? = null, val size: Long, val rawContentType: String, val etag: String? = null, val lastModified: Instant? = null, val cacheControl: String? = null, serializer: SupabaseSerializer = KotlinXSerializer())

Represents a file or a folder in a bucket. If the item is a folder, everything except name is null.

FileSizeLimit

@JvmInline

value class FileSizeLimit

A file size limit for buckets

FileUploadResponse

data class FileUploadResponse(val id: String? = null, val path: String, val key: String? = null)

The response of a file upload

ImageTransformation

class ImageTransformation

Represents a transformation for an image. Used for Storage objects

SignedUrl

@Serializable

data class SignedUrl(val error: String? = null, val signedURL: String, val path: String)

Represents a signed url

Storage

sealed interface Storage : MainPlugin<Storage.Config> , CustomSerializationPlugin

Plugin for interacting with the Supabase Storage API

StorageItem

data class StorageItem(val path: String, val bucketId: String, val authenticated: Boolean)

Represents a file in the storage bucket.

UploadData

data class UploadData(val stream: ByteReadChannel, val size: Long)

Represents the data to upload

UploadOptionBuilder

class UploadOptionBuilder( serializer: SupabaseSerializer, var upsert: Boolean = false, var userMetadata: JsonObject? = null, var contentType: ContentType? = null, httpRequestOverrides: MutableList<HttpRequestOverride> = mutableListOf())

Builder for uploading files with additional options

UploadSignedUrl

data class UploadSignedUrl(val url: String, val path: String, val token: String)

A signed url to upload a file

UploadStatus

sealed interface UploadStatus

Represents the status of an upload

Properties

storage

val SupabaseClient.storage: Storage

Supabase Storage is a simple way to store large files for various purposes

Functions

authenticatedRequest

suspend fun BucketApi.authenticatedRequest(path: String): Pair<String, String>

Can be used if you want to quickly access a file under an url with your auth_token using a custom download method.

authenticatedStorageItem

fun authenticatedStorageItem(bucketId: String, path: String): StorageItem

Creates a StorageItem for an authenticated file.

continuePreviousFileUploads

suspend fun ResumableClient.continuePreviousFileUploads(): List<Deferred<ResumableUpload>>

Reads pending uploads from the cache and creates a new ResumableUpload for each of them. This done in parallel, so you can start the uploads independently.

createOrContinueUpload

suspend fun ResumableClient.createOrContinueUpload( path: String, file: <Error class: unknown class>, options: UploadOptionBuilder.() -> Unit = {}): ResumableUpload

Creates a new resumable upload or continues an existing one. If there is an url in the cache for the given Fingerprint, the upload will be continued.

suspend fun ResumableClient.createOrContinueUpload(path: String, uri: Uri, options: UploadOptionBuilder.() -> Unit = {}): ResumableUpload

Creates a new upload or continues an existing one from the given uri

downloadAuthenticatedAsFlow

fun BucketApi.downloadAuthenticatedAsFlow(path: String, options: DownloadOptionBuilder.() -> Unit = {}): Flow<DownloadStatus>

fun BucketApi.downloadAuthenticatedAsFlow( path: String, channel: ByteWriteChannel, options: DownloadOptionBuilder.() -> Unit = {}): Flow<DownloadStatus>

Downloads a file from BucketApi.bucketId under path

downloadAuthenticatedTo

suspend fun BucketApi.downloadAuthenticatedTo(path: String, file: <Error class: unknown class>, options: DownloadOptionBuilder.() -> Unit = {})

Downloads a file from BucketApi.bucketId under path and saves it to file

downloadAuthenticatedToAsFlow

fun BucketApi.downloadAuthenticatedToAsFlow( path: String, file: <Error class: unknown class>, options: DownloadOptionBuilder.() -> Unit = {}): Flow<DownloadStatus>

Downloads a file from BucketApi.bucketId under path and saves it to file

downloadPublicAsFlow

fun BucketApi.downloadPublicAsFlow(path: String, options: DownloadOptionBuilder.() -> Unit = {}): Flow<DownloadStatus>

fun BucketApi.downloadPublicAsFlow( path: String, channel: ByteWriteChannel, options: DownloadOptionBuilder.() -> Unit = {}): Flow<DownloadStatus>

Downloads a file from BucketApi.bucketId under path using the public url

downloadPublicTo

suspend fun BucketApi.downloadPublicTo(path: String, file: <Error class: unknown class>, options: DownloadOptionBuilder.() -> Unit = {})

Downloads a file from BucketApi.bucketId under path and saves it to file

downloadPublicToAsFlow

fun BucketApi.downloadPublicToAsFlow( path: String, file: <Error class: unknown class>, options: DownloadOptionBuilder.() -> Unit = {}): Flow<DownloadStatus>

Downloads a file from BucketApi.bucketId under path and saves it to file

publicStorageItem

fun publicStorageItem(bucketId: String, path: String): StorageItem

Creates a StorageItem for a public file.

update

suspend fun BucketApi.update(path: String, file: <Error class: unknown class>, options: UploadOptionBuilder.() -> Unit = {}): FileUploadResponse

Updates a file in BucketApi.bucketId under path

suspend fun BucketApi.update(path: String, uri: Uri, options: UploadOptionBuilder.() -> Unit = {}): FileUploadResponse

Updates a file in BucketApi.bucketId under path

updateAsFlow

fun BucketApi.updateAsFlow( path: String, file: <Error class: unknown class>, options: UploadOptionBuilder.() -> Unit = {}): <Error class: unknown class>

Updates a file in BucketApi.bucketId under path

fun BucketApi.updateAsFlow(path: String, uri: Uri, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Updates a file in BucketApi.bucketId under path

fun BucketApi.updateAsFlow(path: String, data: UploadData, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Uploads a file in BucketApi.bucketId under path

fun BucketApi.updateAsFlow(path: String, data: ByteArray, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Updates a file in BucketApi.bucketId under path

upload

suspend fun BucketApi.upload(path: String, file: <Error class: unknown class>, options: UploadOptionBuilder.() -> Unit = {}): FileUploadResponse

Uploads a file in BucketApi.bucketId under path

suspend fun BucketApi.upload(path: String, uri: Uri, options: UploadOptionBuilder.() -> Unit = {}): FileUploadResponse

Uploads a file in BucketApi.bucketId under path

uploadAsFlow

fun BucketApi.uploadAsFlow( path: String, file: <Error class: unknown class>, options: UploadOptionBuilder.() -> Unit = {}): <Error class: unknown class>

Uploads a file in BucketApi.bucketId under path

fun BucketApi.uploadAsFlow(path: String, uri: Uri, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Uploads a file in BucketApi.bucketId under path

fun BucketApi.uploadAsFlow(path: String, data: UploadData, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Updates a file in BucketApi.bucketId under path

fun BucketApi.uploadAsFlow(path: String, data: ByteArray, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Uploads a file in BucketApi.bucketId under path

uploadToSignedUrl

suspend fun BucketApi.uploadToSignedUrl( path: String, token: String, file: <Error class: unknown class>, options: UploadOptionBuilder.() -> Unit = {}): FileUploadResponse

Uploads a file in BucketApi.bucketId under path using a presigned url

suspend fun BucketApi.uploadToSignedUrl(path: String, token: String, uri: Uri, options: UploadOptionBuilder.() -> Unit = {}): FileUploadResponse

Uploads a file in BucketApi.bucketId under path using a presigned url

uploadToSignedUrlAsFlow

fun BucketApi.uploadToSignedUrlAsFlow( path: String, token: String, file: <Error class: unknown class>, options: UploadOptionBuilder.() -> Unit = {}): <Error class: unknown class>

Uploads a file in BucketApi.bucketId under path using a presigned url

fun BucketApi.uploadToSignedUrlAsFlow(path: String, token: String, uri: Uri, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Uploads a file in BucketApi.bucketId under path using a presigned url

fun BucketApi.uploadToSignedUrlAsFlow( path: String, token: String, data: UploadData, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

fun BucketApi.uploadToSignedUrlAsFlow( path: String, token: String, data: ByteArray, options: UploadOptionBuilder.() -> Unit = {}): Flow<UploadStatus>

Uploads a file in BucketApi.bucketId under path using a presigned url