Dionisio
f70890e884
- Fix 'folder_id is required' upload error by adding create_home_folder through the full hexagonal architecture (trait, service, repository, auth) - Fix double upload issue with _isUploading concurrency guard - Fix Share context menu doing nothing (ID collision between sharedView and main share dialog resolved with sv- prefix) - Fix Compartidos tab duplicate headers and broken layout - Add missing .shared-dialog CSS with dark mode support - Fix dark mode white backgrounds on empty-state, shared-filters, trash-actions, action-btn, and header - Fix i18n key mismatches in sharedView - Bump version to 0.4.1 Closes #120
111 lines
3.8 KiB
Rust
111 lines
3.8 KiB
Rust
//! Domain persistence port for the Folder entity.
|
|
//!
|
|
//! Defines the contract that any folder storage implementation
|
|
//! must fulfill. This trait lives in the domain because Folder is a core entity
|
|
//! of the system and its persistence contracts belong to the domain layer,
|
|
//! following the principles of Clean/Hexagonal Architecture.
|
|
//!
|
|
//! Concrete implementations (filesystem, PostgreSQL, S3, etc.) live in
|
|
//! the infrastructure layer.
|
|
|
|
use async_trait::async_trait;
|
|
|
|
use crate::common::errors::DomainError;
|
|
use crate::domain::entities::folder::Folder;
|
|
use crate::domain::services::path_service::StoragePath;
|
|
|
|
/// Domain port for folder persistence.
|
|
///
|
|
/// Defines the CRUD and management operations required for
|
|
/// the Folder entity in the storage system.
|
|
#[async_trait]
|
|
pub trait FolderRepository: Send + Sync + 'static {
|
|
/// Creates a new folder
|
|
async fn create_folder(
|
|
&self,
|
|
name: String,
|
|
parent_id: Option<String>,
|
|
) -> Result<Folder, DomainError>;
|
|
|
|
/// Gets a folder by its ID
|
|
async fn get_folder(&self, id: &str) -> Result<Folder, DomainError>;
|
|
|
|
/// Gets a folder by its storage path
|
|
async fn get_folder_by_path(&self, storage_path: &StoragePath) -> Result<Folder, DomainError>;
|
|
|
|
/// Lists folders within a parent folder
|
|
async fn list_folders(&self, parent_id: Option<&str>) -> Result<Vec<Folder>, DomainError>;
|
|
|
|
/// Lists root-level folders owned by a specific user.
|
|
/// For non-root queries (parent_id is Some), ownership is implicit
|
|
/// because the parent already belongs to the user.
|
|
async fn list_folders_by_owner(
|
|
&self,
|
|
parent_id: Option<&str>,
|
|
owner_id: &str,
|
|
) -> Result<Vec<Folder>, DomainError>;
|
|
|
|
/// Lists folders with pagination
|
|
async fn list_folders_paginated(
|
|
&self,
|
|
parent_id: Option<&str>,
|
|
offset: usize,
|
|
limit: usize,
|
|
include_total: bool,
|
|
) -> Result<(Vec<Folder>, Option<usize>), DomainError>;
|
|
|
|
/// Lists folders with pagination, scoped to a specific owner.
|
|
/// Combines the owner filtering of `list_folders_by_owner` with
|
|
/// the pagination of `list_folders_paginated`.
|
|
async fn list_folders_by_owner_paginated(
|
|
&self,
|
|
parent_id: Option<&str>,
|
|
owner_id: &str,
|
|
offset: usize,
|
|
limit: usize,
|
|
include_total: bool,
|
|
) -> Result<(Vec<Folder>, Option<usize>), DomainError>;
|
|
|
|
/// Renames a folder
|
|
async fn rename_folder(&self, id: &str, new_name: String) -> Result<Folder, DomainError>;
|
|
|
|
/// Moves a folder to another parent
|
|
async fn move_folder(
|
|
&self,
|
|
id: &str,
|
|
new_parent_id: Option<&str>,
|
|
) -> Result<Folder, DomainError>;
|
|
|
|
/// Deletes a folder
|
|
async fn delete_folder(&self, id: &str) -> Result<(), DomainError>;
|
|
|
|
/// Checks if a folder exists at the given path
|
|
async fn folder_exists(&self, storage_path: &StoragePath) -> Result<bool, DomainError>;
|
|
|
|
/// Gets the path of a folder
|
|
async fn get_folder_path(&self, id: &str) -> Result<StoragePath, DomainError>;
|
|
|
|
// ── Trash operations ──
|
|
|
|
/// Moves a folder to the trash
|
|
async fn move_to_trash(&self, folder_id: &str) -> Result<(), DomainError>;
|
|
|
|
/// Restores a folder from the trash to its original location
|
|
async fn restore_from_trash(
|
|
&self,
|
|
folder_id: &str,
|
|
original_path: &str,
|
|
) -> Result<(), DomainError>;
|
|
|
|
/// Permanently deletes a folder (used by the trash)
|
|
async fn delete_folder_permanently(&self, folder_id: &str) -> Result<(), DomainError>;
|
|
|
|
/// Creates a root-level home folder for a user.
|
|
/// This is used during user registration to create the user's personal folder.
|
|
async fn create_home_folder(
|
|
&self,
|
|
user_id: &str,
|
|
name: String,
|
|
) -> Result<Folder, DomainError>;
|
|
}
|