rustbasic-medialibrary 0.0.3

Highly optimized, extremely secure, and powerful media library management package with Local and Cloud S3 integrations for the RustBasic Framework.
Documentation
/* ---------------------------------------------------------
 * 🖼️ LABEL: MEDIA LIBRARY HELPERS (app/helpers/media.rs)
 * Pengolahan upload berkas, validasi MIME, kompresi WebP, dan thumbnail.
 * --------------------------------------------------------- */

use std::sync::Arc;
use rustbasic_medialibrary::{MediaLibrary, LocalStorageBackend, MediaFile};

/// Menginisialisasi instansi MediaLibrary lokal bawaan
pub fn initialize_media_library(upload_dir: &str) -> MediaLibrary {
    // 1. Buat local storage backend (menyimpan aset ke folder publik)
    let backend = Arc::new(LocalStorageBackend::new(upload_dir));

    // 2. Buat manager dengan batas maksimal 10MB dan pembatasan MIME type
    MediaLibrary::new(backend)
        .max_size(10 * 1024 * 1024) // Maksimal 10MB
        .allow_mime("image/jpeg")
        .allow_mime("image/png")
        .allow_mime("image/webp")
        .allow_mime("application/pdf")
}

/// Menangani unggahan avatar pengguna: validasi, ubah ke WebP, dan crop kotak 150x150!
pub fn handle_user_avatar_upload(
    raw_bytes: &[u8],
    original_name: &str,
    mime_type: &str
) -> Result<MediaFile, String> {
    // 1. Inisialisasi media library pada folder public/uploads/avatars
    let library = initialize_media_library("public/uploads/avatars");

    // 2. Upload file asli (akan divalidasi MIME type dan ukuran filenya)
    let original_file = library.upload(original_name, mime_type, raw_bytes)?;

    println!("🖼️ [Media Library] Berkas avatar berhasil diunggah: {}", original_file.filename);

    // 3. Konversi format berkas gambar ke WebP modern agar sangat hemat bandwidth!
    let webp_file = library.convert_to_webp(&original_file)?;
    println!("⚡ [Media Library] Transcoded ke WebP: {} -> {}", original_file.filename, webp_file.filename);

    // 4. Potong (crop) dan ubah ukuran (resize) menjadi avatar kotak presisi 150x150 piksel
    let avatar_thumbnail = library.create_thumbnail(&webp_file, 150, 150)?;
    println!("✅ [Media Library] Avatar thumbnail siap pakai: {}", avatar_thumbnail.filename);

    // Hapus file asli dan file Webp mentah agar ruang penyimpanan lokal efisien dan bersih!
    let _ = library.delete(&original_file);
    if webp_file.filename != avatar_thumbnail.filename {
        let _ = library.delete(&webp_file);
    }

    Ok(avatar_thumbnail)
}