Struct StorageBucket 

pub struct StorageBucket {
    pub name: String,
    /* private fields */
}

Operations for a single storage bucket.

Fields

name: String

Implementations

impl StorageBucket

pub fn get_url(&self, key: &str) -> String

Get public URL for a stored file (synchronous, no network).

pub async fn upload( &self, key: &str, data: Vec<u8>, content_type: &str, ) -> Result<Value, Error>

Upload a file using multipart/form-data. Keep as direct HTTP — binary multipart upload.

pub async fn download(&self, key: &str) -> Result<Vec<u8>, Error>

Download raw file bytes. Keep as direct HTTP — binary download.

pub async fn delete(&self, key: &str) -> Result<Value, Error>

Delete a file.

pub async fn list( &self, prefix: &str, limit: u32, offset: u32, ) -> Result<Value, Error>

List files in the bucket.

pub async fn get_metadata(&self, key: &str) -> Result<Value, Error>

Get file metadata.

pub async fn update_metadata( &self, key: &str, metadata: &Value, ) -> Result<Value, Error>

Update file metadata.

pub async fn create_signed_url( &self, key: &str, expires_in: &str, ) -> Result<Value, Error>

Create a signed download URL.

pub async fn create_signed_upload_url( &self, key: &str, expires_in: &str, ) -> Result<Value, Error>

Create a signed upload URL for direct client-side uploads.

pub async fn create_signed_upload_url_with_options( &self, key: &str, expires_in: &str, max_file_size: Option<&str>, ) -> Result<Value, Error>

Create a signed upload URL with optional constraints such as maxFileSize.

pub async fn upload_string( &self, key: &str, data: &str, encoding: &str, content_type: &str, ) -> Result<Value, Error>

Upload a string with encoding support. encoding: “raw”, “base64”, “base64url”, “data_url”.

pub async fn initiate_resumable_upload( &self, key: &str, content_type: &str, ) -> Result<String, Error>

Initiate a multipart upload. Returns the upload ID.

pub async fn upload_part( &self, key: &str, upload_id: &str, part_number: u32, data: Vec<u8>, ) -> Result<Value, Error>

Upload a single part for a multipart upload. Returns { partNumber, etag }. Keep as direct HTTP — binary part upload.

pub async fn complete_resumable_upload( &self, key: &str, upload_id: &str, parts: Vec<Value>, ) -> Result<Value, Error>

Complete a multipart upload. parts is a list of { partNumber, etag } from upload_part.

pub async fn abort_resumable_upload( &self, key: &str, upload_id: &str, ) -> Result<Value, Error>

Abort a multipart upload before completion.

pub async fn resume_upload( &self, key: &str, upload_id: &str, chunk: Vec<u8>, part_number: usize, is_last_chunk: bool, ) -> Result<Value, Error>

Upload a chunk for a resumable upload (legacy convenience wrapper). Uploads a single part and, if is_last_chunk, completes the upload.