// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

using System.IO;
using System.IO.Compression;
using System.Threading.Tasks;

namespace Microsoft.Arcade.Common
{
    public interface IZipArchiveManager
    {
        /// <summary>
        /// Opens a given archive.
        /// </summary>
        /// <param name="archivePath">Path to the zip archive</param>
        /// <param name="mode">Access mode</param>
        ZipArchive OpenArchive(string archivePath, ZipArchiveMode mode);

        /// <summary>
        /// Loads an embedded resource and adds it to a target archive.
        /// </summary>
        /// <typeparam name="TAssembly">Type from the assembly where the resource is embedded (usually the caller)</typeparam>
        /// <param name="archivePath">Path to the archive where the file will be added</param>
        /// <param name="resourceName">Name of the embedded resource</param>
        /// <param name="targetFileName">New name of the file in the archive</param>
        Task AddResourceFileToArchive<TAssembly>(string archivePath, string resourceName, string targetFileName = null);

        /// <summary>
        /// Creates a file with given content in a given archive.
        /// </summary>
        /// <param name="archivePath">Path to the archive</param>
        /// <param name="targetFilename">New path of the file in the archive</param>
        /// <param name="content">Content of the file</param>
        Task AddContentToArchive(string archivePath, string targetFilename, Stream content);

        /// <summary>
        /// Creates a file with given content in a given archive.
        /// </summary>
        /// <param name="archivePath">Path to the archive</param>
        /// <param name="targetFilename">New path of the file in the archive</param>
        /// <param name="content">Content of the file</param>
        Task AddContentToArchive(string archivePath, string targetFilename, string content);

        /// <summary>
        /// Compresses a directory into an archive on a given path.
        /// </summary>
        /// <param name="directoryPath">The directory to archive</param>
        /// <param name="archivePath">Path where to create the archive</param>
        /// <param name="includeBaseDirectory">When true, includes top-level directory in the archive</param>
        void ArchiveDirectory(string directoryPath, string archivePath, bool includeBaseDirectory);

        /// <summary>
        /// Creates a new archive containing given file.
        /// </summary>
        /// <param name="filePath">File to archive</param>
        /// <param name="archivePath">Path where to create the archive</param>
        void ArchiveFile(string filePath, string archivePath);
    }
}