Struct Storage 

pub struct Storage {
    pub accounts: AccountRepository,
    pub transactions: TransactionRepository,
    pub categories: CategoryRepository,
    pub budget: BudgetRepository,
    pub payees: PayeeRepository,
    pub targets: TargetRepository,
    /* private fields */
}

Main storage coordinator that provides access to all repositories and handles audit logging for all operations.

Fields

accounts: AccountRepository

transactions: TransactionRepository

categories: CategoryRepository

budget: BudgetRepository

payees: PayeeRepository

targets: TargetRepository

Implementations

impl Storage

pub fn new(paths: EnvelopePaths) -> Result<Self, EnvelopeError>

Create a new Storage instance

pub fn paths(&self) -> &EnvelopePaths

Get the paths configuration

pub fn audit(&self) -> &AuditLogger

Get a reference to the audit logger

pub fn log_audit(&self, entry: &AuditEntry) -> EnvelopeResult<()>

Log an audit entry

pub fn log_create<T: Serialize>( &self, entity_type: EntityType, entity_id: impl Into<String>, entity_name: Option<String>, entity: &T, ) -> EnvelopeResult<()>

Log a create operation

pub fn log_update<T: Serialize>( &self, entity_type: EntityType, entity_id: impl Into<String>, entity_name: Option<String>, before: &T, after: &T, diff_summary: Option<String>, ) -> EnvelopeResult<()>

Log an update operation

pub fn log_delete<T: Serialize>( &self, entity_type: EntityType, entity_id: impl Into<String>, entity_name: Option<String>, entity: &T, ) -> EnvelopeResult<()>

Log a delete operation

pub fn read_audit_log(&self, count: usize) -> EnvelopeResult<Vec<AuditEntry>>

Read recent audit entries

pub fn load_all(&mut self) -> Result<(), EnvelopeError>

Load all data from disk

pub fn save_all(&self) -> Result<(), EnvelopeError>

Save all data to disk

pub fn is_initialized(&self) -> bool

Check if storage has been initialized (has any data)

pub fn create_backup(&self) -> EnvelopeResult<PathBuf>

Create a backup of all data

Creates a backup using the default retention policy. Returns the path to the created backup file.

pub fn create_backup_with_retention( &self, retention: BackupRetention, ) -> EnvelopeResult<(PathBuf, Vec<PathBuf>)>

Create a backup with a custom retention policy

pub fn restore_from_backup( &mut self, backup_path: &Path, ) -> EnvelopeResult<RestoreResult>

Restore data from a backup file

WARNING: This will overwrite all current data. It’s recommended to create a backup before restoring.

pub fn backup_manager(&self, retention: BackupRetention) -> BackupManager

Get the backup manager for advanced backup operations

pub fn backup_before_destructive(&self) -> EnvelopeResult<Option<PathBuf>>

Create a backup before a destructive operation if needed

This creates a backup only if:

• No backup exists yet, OR
• The most recent backup is older than 60 seconds

This prevents creating too many backups when multiple destructive operations happen in quick succession.

Returns Ok(Some(path)) if a backup was created, Ok(None) if skipped.