namespace Musify.Application.Contracts;

public interface IStorageService
{
    /// <summary>Opens an object for reading, or returns null when it does not exist.</summary>
    public Task<Stream?> GetFileAsync(string bucket, string key, CancellationToken cancellationToken);

    public Task<ObjectMetaData?> HeadObjectAsync(string bucket, string key, CancellationToken cancellationToken);

    public Task<string> GetUploadUrlAsync(string bucket, string key, string contentType, TimeSpan expirationTime, bool preventOverwrite = true, CancellationToken cancellationToken = default);

    public Task UploadFileAsync(string filePath, string bucket, string key, CancellationToken cancellationToken);

    public Task UploadFileAsync(Stream sourceStream, string contentType, string bucket, string key, CancellationToken cancellationToken);

    public Task<IReadOnlyList<string>> TransferFilesAsync(string sourceDirectory, string bucket, string route, CancellationToken cancellationToken);

    public Task RemoveFileAsync(string bucket, string key, CancellationToken cancellationToken);

    public Task CopyFileAsync(string sourceBucket, string sourceKey, string destinationBucket, string destinationKey,
        CancellationToken cancellationToken);

    public IAsyncEnumerable<StorageObject> ListObjectsAsync(string bucket, string prefix, CancellationToken cancellationToken);
}