namespace CMSMicroservice.Application.Common.Interfaces;

/// <summary>
/// Service for uploading files to FMS (File Management Service)
/// </summary>
public interface IFileManagementService
{
    /// <summary>
    /// Uploads a file to FMS and returns the stored file path
    /// </summary>
    /// <param name="directory">Target directory path (e.g. "Images/Products")</param>
    /// <param name="fileBytes">Raw file bytes</param>
    /// <param name="mime">MIME type (e.g. "image/jpeg")</param>
    /// <param name="fileName">Original file name</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>The stored file path returned by FMS, or null if upload failed</returns>
    Task<string?> UploadFileAsync(string directory, byte[] fileBytes, string mime, string? fileName, CancellationToken cancellationToken = default);
    
    /// <summary>
    /// Uploads an image to FMS with optimization (resize + compress)
    /// Returns both main image path and thumbnail path
    /// </summary>
    /// <param name="directory">Target directory path (e.g. "Images/Products")</param>
    /// <param name="fileBytes">Raw image bytes</param>
    /// <param name="mime">MIME type (e.g. "image/jpeg")</param>
    /// <param name="fileName">Original file name</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Tuple of (mainImagePath, thumbnailPath), either can be null if upload failed</returns>
    Task<(string? MainImagePath, string? ThumbnailPath)> UploadImageWithThumbnailAsync(
        string directory, byte[] fileBytes, string mime, string? fileName, 
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Deletes a file from FMS by its ID
    /// </summary>
    Task<bool> DeleteFileAsync(long fileId, CancellationToken cancellationToken = default);
}