adding several features

src/domain/repositories/file_repository.rs

@@ -1,6 +1,8 @@
-use std::path::PathBuf;
 use async_trait::async_trait;
 use crate::domain::entities::file::File;
+use crate::domain::services::path_service::StoragePath;
+use futures::Stream;
+use bytes::Bytes;
 
 /// Error types for file repository operations
 #[derive(Debug, thiserror::Error)]
@@ -18,6 +20,12 @@ pub enum FileRepositoryError {
     #[error("IO Error: {0}")]
     IoError(#[from] std::io::Error),
     
+    #[error("Mapping error: {0}")]
+    MappingError(String),
+    
+    #[error("Timeout error: {0}")]
+    Timeout(String),
+    
     #[error("Other error: {0}")]
     Other(String),
 }
@@ -26,11 +34,10 @@ pub enum FileRepositoryError {
 pub type FileRepositoryResult<T> = Result<T, FileRepositoryError>;
 
 /// Repository interface for file operations (primary port)
+/// Esta interfaz define las operaciones de negocio relacionadas con archivos
+/// sin exponer detalles de implementación como rutas o sistemas de archivos
 #[async_trait]
 pub trait FileRepository: Send + Sync + 'static {
-    /// Gets a folder by its ID - helper method for file repository to work with folders
-    #[allow(dead_code)]
-    async fn get_folder_by_id(&self, id: &str) -> FileRepositoryResult<crate::domain::entities::folder::Folder>;
     /// Saves a file from bytes
     async fn save_file_from_bytes(
         &self,
@@ -60,13 +67,20 @@ pub trait FileRepository: Send + Sync + 'static {
     /// Deletes a file
     async fn delete_file(&self, id: &str) -> FileRepositoryResult<()>;
     
-    /// Deletes a file and its entry from the map
+    /// Deletes a file and its entry from mapping systems
     #[allow(dead_code)]
     async fn delete_file_entry(&self, id: &str) -> FileRepositoryResult<()>;
     
-    /// Gets file content as bytes
+    /// Gets file content as bytes - use only for small files
     async fn get_file_content(&self, id: &str) -> FileRepositoryResult<Vec<u8>>;
     
-    /// Checks if a file exists at the given path
-    async fn file_exists(&self, path: &PathBuf) -> FileRepositoryResult<bool>;
+    /// Gets file content as a stream - better for large files
+    #[allow(clippy::type_complexity)]
+    async fn get_file_stream(&self, id: &str) -> FileRepositoryResult<Box<dyn Stream<Item = Result<Bytes, std::io::Error>> + Send>>;
+    
+    /// Moves a file to a different folder
+    async fn move_file(&self, id: &str, target_folder_id: Option<String>) -> FileRepositoryResult<File>;
+    
+    /// Gets the storage path for a file
+    async fn get_file_path(&self, id: &str) -> FileRepositoryResult<StoragePath>;
 }

src/domain/repositories/folder_repository.rs

@@ -1,6 +1,6 @@
-use std::path::PathBuf;
 use async_trait::async_trait;
 use crate::domain::entities::folder::Folder;
+use crate::domain::services::path_service::StoragePath;
 
 /// Error types for folder repository operations
 #[derive(Debug, thiserror::Error)]
@@ -18,6 +18,12 @@ pub enum FolderRepositoryError {
     #[error("IO Error: {0}")]
     IoError(#[from] std::io::Error),
     
+    #[error("Mapping error: {0}")]
+    MappingError(String),
+    
+    #[error("Validation error: {0}")]
+    ValidationError(String),
+    
     #[error("Other error: {0}")]
     Other(String),
 }
@@ -29,17 +35,31 @@ pub type FolderRepositoryResult<T> = Result<T, FolderRepositoryError>;
 #[async_trait]
 pub trait FolderRepository: Send + Sync + 'static {
     /// Creates a new folder
-    async fn create_folder(&self, name: String, parent_path: Option<PathBuf>) -> FolderRepositoryResult<Folder>;
+    async fn create_folder(&self, name: String, parent_id: Option<String>) -> FolderRepositoryResult<Folder>;
     
     /// Gets a folder by its ID
     async fn get_folder_by_id(&self, id: &str) -> FolderRepositoryResult<Folder>;
     
     /// Gets a folder by its path
-    async fn get_folder_by_path(&self, path: &PathBuf) -> FolderRepositoryResult<Folder>;
+    async fn get_folder_by_storage_path(&self, storage_path: &StoragePath) -> FolderRepositoryResult<Folder>;
     
-    /// Lists folders in a parent folder
+    /// Lists all folders in a parent folder (use with caution for large directories)
     async fn list_folders(&self, parent_id: Option<&str>) -> FolderRepositoryResult<Vec<Folder>>;
     
+    /// Lists folders in a parent folder with pagination support
+    /// 
+    /// * `parent_id` - Optional parent folder ID
+    /// * `offset` - Number of folders to skip
+    /// * `limit` - Maximum number of folders to return
+    /// * `include_total` - If true, returns the total count of folders as well
+    async fn list_folders_paginated(
+        &self, 
+        parent_id: Option<&str>, 
+        offset: usize, 
+        limit: usize,
+        include_total: bool
+    ) -> FolderRepositoryResult<(Vec<Folder>, Option<usize>)>;
+    
     /// Renames a folder
     async fn rename_folder(&self, id: &str, new_name: String) -> FolderRepositoryResult<Folder>;
     
@@ -50,5 +70,18 @@ pub trait FolderRepository: Send + Sync + 'static {
     async fn delete_folder(&self, id: &str) -> FolderRepositoryResult<()>;
     
     /// Checks if a folder exists at the given path
-    async fn folder_exists(&self, path: &PathBuf) -> FolderRepositoryResult<bool>;
+    async fn folder_exists_at_storage_path(&self, storage_path: &StoragePath) -> FolderRepositoryResult<bool>;
+    
+    /// Gets the storage path for a folder
+    async fn get_folder_storage_path(&self, id: &str) -> FolderRepositoryResult<StoragePath>;
+    
+    /// Legacy method - checks if a folder exists at the given PathBuf path
+    #[deprecated(note = "Use folder_exists_at_storage_path instead")]
+    #[allow(dead_code)]
+    async fn folder_exists(&self, path: &std::path::PathBuf) -> FolderRepositoryResult<bool>;
+    
+    /// Legacy method - gets a folder by its PathBuf path
+    #[deprecated(note = "Use get_folder_by_storage_path instead")]
+    #[allow(dead_code)]
+    async fn get_folder_by_path(&self, path: &std::path::PathBuf) -> FolderRepositoryResult<Folder>;
 }