namespace WorkCameraExport.Services.Interfaces
{
    /// <summary>
    /// 图片服务接口 - 负责图片下载和处理
    /// </summary>
    public interface IImageService : IDisposable
    {
        #region 下载

        /// <summary>
        /// 下载单张图片
        /// </summary>
        /// <param name="url">图片 URL</param>
        /// <param name="cancellationToken">取消令牌</param>
        /// <returns>图片字节数组</returns>
        Task<byte[]?> DownloadImageAsync(string url, CancellationToken cancellationToken = default);

        /// <summary>
        /// 批量并发下载图片
        /// </summary>
        /// <param name="urls">图片 URL 列表</param>
        /// <param name="outputDir">输出目录</param>
        /// <param name="concurrency">并发数</param>
        /// <param name="progress">进度回调（已下载数量）</param>
        /// <param name="cancellationToken">取消令牌</param>
        /// <returns>下载结果字典（URL -> 本地文件路径，失败的为 null）</returns>
        Task<Dictionary<string, string?>> DownloadImagesAsync(
            List<string> urls,
            string outputDir,
            int concurrency,
            IProgress<int>? progress = null,
            CancellationToken cancellationToken = default);

        #endregion

        #region 处理

        /// <summary>
        /// 压缩图片
        /// </summary>
        /// <param name="imageData">原始图片数据</param>
        /// <param name="quality">压缩质量 (1-100)</param>
        /// <returns>压缩后的图片数据</returns>
        byte[] CompressImage(byte[] imageData, int quality);

        /// <summary>
        /// 缩放图片
        /// </summary>
        /// <param name="imageData">原始图片数据</param>
        /// <param name="width">目标宽度</param>
        /// <param name="height">目标高度</param>
        /// <returns>缩放后的图片数据</returns>
        byte[] ResizeImage(byte[] imageData, int width, int height);

        /// <summary>
        /// 压缩并缩放图片
        /// </summary>
        /// <param name="imageData">原始图片数据</param>
        /// <param name="width">目标宽度</param>
        /// <param name="height">目标高度</param>
        /// <param name="quality">压缩质量 (1-100)</param>
        /// <returns>处理后的图片数据</returns>
        byte[] CompressAndResizeImage(byte[] imageData, int width, int height, int quality);

        #endregion
    }
}