Struct FileStorageProvider 

pub struct FileStorageProvider { /* private fields */ }

Single-process local file provider with atomic replacement writes.

Implementations

impl FileStorageProvider

pub fn create_snapshot_backup( &self, name: &str, ) -> StorageResult<BackupDescriptor>

Creates an atomic, checksummed snapshot of the complete data root.

pub fn verify_snapshot_backup( &self, name: &str, ) -> StorageResult<BackupDescriptor>

Verifies a complete snapshot without changing current data.

pub fn restore_snapshot_backup( &self, name: &str, ) -> StorageResult<BackupDescriptor>

Restores a verified snapshot through a recoverable directory swap.

pub fn recover_snapshot_restore(&self) -> StorageResult<()>

Resolves interrupted restore phases without discarding the last good root.

impl FileStorageProvider

pub fn new( storage_path: impl Into<PathBuf>, backup_path: impl Into<PathBuf>, ) -> Self

Creates a provider with separate data and backup roots.

pub fn create_dirs(&self) -> StorageResult<()>

Creates the configured data and backup directories.

pub fn write_bytes(&self, path: &str, bytes: &[u8]) -> StorageResult<()>

Atomically writes bytes below the data root.

pub fn write_bytes_atomic(&self, path: &str, bytes: &[u8]) -> StorageResult<()>

Writes through an exclusive temporary file, fsync and atomic rename.

pub fn write_secure_bytes<P: TokenProvider>( &self, path: &str, bytes: &[u8], provider: &P, claims: &TokenClaims, ) -> StorageResult<()>

Seals and atomically writes bytes using an explicit token provider.

pub fn write_auth_required_bytes<P: TokenProvider>( &self, path: &str, bytes: &[u8], provider: Option<&P>, claims: &TokenClaims, ) -> StorageResult<()>

Writes sealed bytes and fails when authentication is not configured.

pub fn write_remote_auth_required_bytes( &self, path: &str, bytes: &[u8], client: Option<&RemoteAuthStorageClient>, ) -> StorageResult<()>

Seals bytes through a remote authentication service before writing.

pub fn read_bytes(&self, path: &str) -> StorageResult<Vec<u8>>

Reads bytes below the data root.

pub fn read_secure_bytes<P: TokenProvider>( &self, path: &str, provider: &P, claims: &TokenClaims, ) -> StorageResult<Vec<u8>>

Reads and opens sealed bytes using an explicit token provider.

pub fn read_auth_required_bytes<P: TokenProvider>( &self, path: &str, provider: Option<&P>, claims: &TokenClaims, ) -> StorageResult<Vec<u8>>

Reads sealed bytes and fails when authentication is not configured.

pub fn read_remote_auth_required_bytes( &self, path: &str, client: Option<&RemoteAuthStorageClient>, ) -> StorageResult<Vec<u8>>

Reads and opens bytes through a remote authentication service.

pub fn exists(&self, path: &str) -> StorageResult<bool>

Reports whether a relative data path exists.

pub fn backup_file(&self, source: &str, backup_name: &str) -> StorageResult<()>

Atomically copies a data file below the backup root.

pub fn backup_file_atomic( &self, source: &str, backup_name: &str, ) -> StorageResult<()>

Creates a backup through fsync and atomic replacement.

pub fn cleanup_temp_files(&self) -> StorageResult<usize>

Removes orphaned temporary files below data and backup roots.

Trait Implementations

impl Clone for FileStorageProvider

fn clone(&self) -> FileStorageProvider

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileStorageProvider

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl StorageCapabilityProviderV1 for FileStorageProvider

fn storage_capabilities_v1( &self, ) -> Result<StorageCapabilityDescriptorV1, StorageCapabilityError>

Returns an immutable descriptor without probing or opening the provider.

impl StorageProvider for FileStorageProvider

fn status(&self) -> StorageStatus

Returns coarse provider availability.

fn health(&self) -> StorageHealth

Returns a current provider health snapshot.

fn open(&mut self) -> StorageResult<()>

Opens and validates provider resources.

fn close(&mut self) -> StorageResult<()>

Closes provider resources.

fn begin_transaction(&mut self) -> StorageResult<Box<dyn Transaction>>

Begins a real unit of work or fails explicitly when unsupported.

fn list_backups(&self) -> Vec<BackupDescriptor>

Lists provider-owned backups.