Struct FilesStore 

pub struct FilesStore { /* private fields */ }

Disk-backed store for uploaded files.

All methods are synchronous and intended to be called from within a tokio::task::spawn_blocking context (see the route handlers).

Implementations

impl FilesStore

pub fn new(root: PathBuf) -> FilesStoreResult<Self>

Open (or create) the files store root directory.

Creates the directory tree if it does not exist.

pub fn create( &self, filename: &str, purpose: FilePurpose, data: &[u8], ) -> FilesStoreResult<OxiFile>

Upload a new file and persist it atomically.

Returns the OxiFile metadata record. Fails with FileTooLarge if data.len() exceeds MAX_FILE_BYTES.

pub fn create_with_limit( &self, filename: &str, purpose: FilePurpose, data: &[u8], limit: usize, ) -> FilesStoreResult<OxiFile>

Like create but with a caller-supplied byte limit.

Useful in tests where the 512 MiB default is impractical.

pub fn get(&self, file_id: &str) -> FilesStoreResult<OxiFile>

Retrieve metadata for a single file by ID.

Returns FileNotFound if no entry with this ID exists.

pub fn list(&self) -> FilesStoreResult<Vec<OxiFile>>

List all files stored in the root directory.

Returns them in an unspecified order. Entries whose meta.json cannot be parsed are silently skipped so a single corrupt entry does not block the listing.

pub fn get_content(&self, file_id: &str) -> FilesStoreResult<Vec<u8>>

Read the raw bytes for a file.

Returns FileNotFound if the file does not exist.

pub fn delete(&self, file_id: &str) -> FilesStoreResult<()>

Delete a file and all associated data.

Returns FileNotFound if no such file exists.