Struct Stack0FileStorage 

pub struct Stack0FileStorage { /* private fields */ }

File storage backed by Stack0’s CDN.

Uploads use a 3-step flow: POST /cdn/upload to mint a presigned URL, PUT the bytes to that URL, then POST /cdn/upload/{assetId}/confirm. store() returns the public cdnUrl so clients can embed it directly without round-tripping through pylon.

Implementations

impl Stack0FileStorage

pub fn new(api_key: impl Into<String>) -> Self

pub fn with_folder(self, folder: impl Into<String>) -> Self

pub fn with_base_url(self, base_url: impl Into<String>) -> Self

Override the API base URL (useful for tests or self-hosted Stack0).

pub fn from_env() -> Option<Self>

Construct from environment variables. Reads: PYLON_STACK0_API_KEY (required), PYLON_STACK0_FOLDER (optional), PYLON_STACK0_BASE_URL (optional override).

pub fn build_upload_init_body( &self, filename: &str, content_type: &str, size: usize, ) -> Value

JSON body for the /cdn/upload init call. Pulled out so tests can pin the wire shape without exercising the network.

Trait Implementations

impl FileStorage for Stack0FileStorage

fn store( &self, name: &str, content: &[u8], content_type: &str, ) -> Result<StoredFile, FileStorageError>

Store file content, returning a file ID and public URL.

fn get(&self, id: &str) -> Result<Vec<u8>, FileStorageError>

Retrieve file content by ID.

fn delete(&self, id: &str) -> Result<bool, FileStorageError>

Delete a file by ID.

fn presigned_upload_url( &self, _name: &str, _content_type: &str, _expires_secs: u64, ) -> Result<Option<String>, FileStorageError>

Generate a presigned upload URL (for direct client uploads). Not all backends support this — returns None if unsupported.