92 lines
2.7 KiB
Rust
92 lines
2.7 KiB
Rust
|
//! Thumbnail Port - Application layer abstraction for thumbnail generation.
|
|||
|
|
//!
|
|||
|
|
//! This module defines the port (trait) for thumbnail operations,
|
|||
|
|
//! keeping the application and interface layers independent of specific
|
|||
|
|
//! image processing implementations.
|
|||
|
|
|
|||
|
|
use std::path::{Path, PathBuf};
|
|||
|
|
use std::sync::Arc;
|
|||
|
|
use async_trait::async_trait;
|
|||
|
|
use bytes::Bytes;
|
|||
|
|
use crate::common::errors::DomainError;
|
|||
|
|
|
|||
|
|
/// Thumbnail sizes supported by the system.
|
|||
|
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|||
|
|
pub enum ThumbnailSize {
|
|||
|
|
/// Small icon for file listings (150×150)
|
|||
|
|
Icon,
|
|||
|
|
/// Medium preview for gallery view (400×400)
|
|||
|
|
Preview,
|
|||
|
|
/// Large preview for detail view (800×800)
|
|||
|
|
Large,
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
impl ThumbnailSize {
|
|||
|
|
/// Get the maximum dimension for this size.
|
|||
|
|
pub fn max_dimension(&self) -> u32 {
|
|||
|
|
match self {
|
|||
|
|
ThumbnailSize::Icon => 150,
|
|||
|
|
ThumbnailSize::Preview => 400,
|
|||
|
|
ThumbnailSize::Large => 800,
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// Get the directory name for this size.
|
|||
|
|
pub fn dir_name(&self) -> &'static str {
|
|||
|
|
match self {
|
|||
|
|
ThumbnailSize::Icon => "icon",
|
|||
|
|
ThumbnailSize::Preview => "preview",
|
|||
|
|
ThumbnailSize::Large => "large",
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// Get all thumbnail sizes.
|
|||
|
|
pub fn all() -> &'static [ThumbnailSize] {
|
|||
|
|
&[ThumbnailSize::Icon, ThumbnailSize::Preview, ThumbnailSize::Large]
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// Statistics about the thumbnail cache.
|
|||
|
|
#[derive(Debug, Clone)]
|
|||
|
|
pub struct ThumbnailStatsDto {
|
|||
|
|
pub cached_thumbnails: usize,
|
|||
|
|
pub cache_size_bytes: usize,
|
|||
|
|
pub max_cache_bytes: usize,
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// Port for thumbnail generation and retrieval.
|
|||
|
|
///
|
|||
|
|
/// Implementations handle the actual image processing, caching,
|
|||
|
|
/// and storage of thumbnails, while the application layer only
|
|||
|
|
/// interacts through this abstraction.
|
|||
|
|
#[async_trait]
|
|||
|
|
pub trait ThumbnailPort: Send + Sync + 'static {
|
|||
|
|
/// Check if a file is an image that can have thumbnails.
|
|||
|
|
fn is_supported_image(&self, mime_type: &str) -> bool;
|
|||
|
|
|
|||
|
|
/// Get a thumbnail, generating it on-demand if needed.
|
|||
|
|
///
|
|||
|
|
/// Returns the thumbnail bytes in WebP format.
|
|||
|
|
async fn get_thumbnail(
|
|||
|
|
&self,
|
|||
|
|
file_id: &str,
|
|||
|
|
size: ThumbnailSize,
|
|||
|
|
original_path: &Path,
|
|||
|
|
) -> Result<Bytes, DomainError>;
|
|||
|
|
|
|||
|
|
/// Generate all thumbnail sizes for a file in the background.
|
|||
|
|
///
|
|||
|
|
/// Called after file upload to pre-generate thumbnails.
|
|||
|
|
fn generate_all_sizes_background(
|
|||
|
|
self: Arc<Self>,
|
|||
|
|
file_id: String,
|
|||
|
|
original_path: PathBuf,
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
/// Delete all thumbnails for a file.
|
|||
|
|
async fn delete_thumbnails(&self, file_id: &str) -> Result<(), DomainError>;
|
|||
|
|
|
|||
|
|
/// Get cache statistics.
|
|||
|
|
async fn get_stats(&self) -> ThumbnailStatsDto;
|
|||
|
|
}
|