Struct S3Storage 

pub struct S3Storage { /* private fields */ }

S3-compatible storage client Per [[RFC-0004:C-UPLOAD-TRACKING]]

Implementations

impl S3Storage

pub fn new(config: &StorageConfig) -> Result<Self>

Create a new S3Storage client from config

pub fn config_id(&self) -> &str

Get the storage configuration identifier

pub fn url_prefix(&self) -> &str

Get the URL prefix

pub async fn upload( &self, local_path: &Path, data: &[u8], ) -> Result<UploadResult>

Upload an asset to S3 Per [[RFC-0004:C-UPLOAD-TRACKING]] and [[RFC-0004:C-URL-CONSTRUCTION]]

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

Check if an object exists in S3

pub fn compute_hash(data: &[u8]) -> String

Compute SHA-256 hash of data (lowercase hex, 64 chars) Per [[RFC-0004:C-UPLOAD-TRACKING]]

pub fn normalize_extension(path: &Path) -> String

Normalize file extension per [[RFC-0004:C-UPLOAD-TRACKING]]

1. Extract extension from filename
2. Convert to lowercase
3. Remove non-alphanumeric characters
4. Return empty string if result is empty

pub fn build_object_key(content_hash: &str, extension: &str) -> String

Build object key per [[RFC-0004:C-UPLOAD-TRACKING]] Format: {content_hash}.{extension} or {content_hash} if no extension

pub fn build_url(url_prefix: &str, object_key: &str) -> String

Build public URL per [[RFC-0004:C-URL-CONSTRUCTION]] Format: {url_prefix}/{object_key}