Struct BucketService 

pub struct BucketService { /* private fields */ }

A bucket-aware storage service that enforces policies.

Wraps a StorageBackend with a BucketConfig to validate upload size and MIME type restrictions before delegating operations.

Implementations

impl BucketService

pub const fn new(backend: StorageBackend, config: BucketConfig) -> Self

Creates a new bucket service.

pub const fn config(&self) -> &BucketConfig

Returns a reference to the bucket configuration.

pub async fn upload( &self, key: &str, data: &[u8], content_type: &str, ) -> Result<String>

Uploads data with policy validation.

Validates:

• Key is safe (no path traversal)
• Data size does not exceed configured limit
• Content type is in allowed MIME types list

Errors

Returns FraiseQLError::File if validation fails or upload fails.

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

Downloads data without policy validation (policies only apply to upload).

Errors

Returns FraiseQLError::File if download fails.

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

Deletes an object.

Errors

Returns FraiseQLError::File if deletion fails.

pub async fn exists(&self, key: &str) -> Result<bool>

Checks if an object exists.

Errors

Returns FraiseQLError::File on backend communication errors.

pub async fn list( &self, prefix: &str, cursor: Option<&str>, limit: usize, ) -> Result<ListResult>

Lists objects in the bucket by prefix.

Errors

Returns FraiseQLError::File if listing fails.

pub async fn presigned_url(&self, key: &str, expiry: Duration) -> Result<String>

Generates a presigned URL for direct access to an object.

Errors

Returns FraiseQLError::File if presigned URLs are not supported by the backend or if generation fails.