stable version 5.0.3

Author: mendozagit

DownloaderExtensions.cs

@@ -169,16 +169,8 @@ public static TEnum ToEnumElement<TEnum>(this string code) where TEnum : struct,
     /// <param name="services">The service collection</param>
     /// <param name="storageSettings">File storage settings</param>
     /// <returns>The service collection for chaining</returns>
-    public static IServiceCollection AddXmlDownloader(this IServiceCollection services,
-        Action<FileStorageSettings>? storageSettings = null)
+    public static IServiceCollection AddXmlDownloader(this IServiceCollection services)
     {
-        // File storage settings
-        if (storageSettings is not null)
-            services.Configure(storageSettings);
-        else
-            services.Configure<FileStorageSettings>(settings => { settings.InitializeDefaultDirectories(); });
-
-
         // Register the services
         services.AddScoped<IAuthService, AuthService>();
         services.AddScoped<IQueryService, QueryService>();

FileStorage/FileStorageService.cs

@@ -14,64 +14,22 @@
  * ============================================================================
  */
 
-using System.Runtime.InteropServices;
-
 namespace Fiscalapi.XmlDownloader.FileStorage;
 
-/// <summary>
-/// Configuration settings for file management operations
-/// </summary>
-public class FileStorageSettings
+public static class FileStorageSettings
 {
     /// <summary>
     /// Package file extension
     /// </summary>
-    public string PackageExtension { get; set; } = ".zip";
+    public static string PackageExtension { get; set; } = ".zip";
 
     /// <summary>
-    /// XML file extension for CFDI documents
+    /// CFDI file extension
     /// </summary>
-    public string CfdiExtension { get; set; } = ".xml";
+    public static string CfdiExtension { get; set; } = ".xml";
 
     /// <summary>
     /// Metadata file extension
     /// </summary>
-    public string MetadataExtension { get; set; } = ".txt";
-
-    /// <summary>
-    /// Folder to perform temporary operations like folder extractions
-    /// </summary>
-    public string TempDirectory { get; set; } = string.Empty;
-
-    /// <summary>
-    /// Folder where packages will be saved
-    /// </summary>
-    public string PackagesDirectory { get; set; } = string.Empty;
-
-    /// <summary>
-    /// Initialize default directories based on current operating system 
-    /// </summary>
-    public void InitializeDefaultDirectories()
-    {
-        if (string.IsNullOrEmpty(TempDirectory))
-        {
-            //Windows: C:\Users\[Username]\AppData\Local\Fiscalapi\Temp
-            //Linux  : /home/[username]/.fiscalapi/temp
-            TempDirectory = RuntimeInformation.IsOSPlatform(OSPlatform.Windows)
-                ? Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "Fiscalapi",
-                    "Temp")
-                : Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".fiscalapi", "temp");
-        }
-
-        if (string.IsNullOrEmpty(PackagesDirectory))
-        {
-            //Windows: C:\Users\[Username]\AppData\Local\Fiscalapi\Packages
-            //Linux  : /home/[username]/.fiscalapi/packages
-            PackagesDirectory = RuntimeInformation.IsOSPlatform(OSPlatform.Windows)
-                ? Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "Fiscalapi",
-                    "Packages")
-                : Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".fiscalapi",
-                    "packages");
-        }
-    }
+    public static string MetaExtension { get; set; } = ".txt";
 }

FileStorage/FileStorageSettings.cs

@@ -17,91 +17,91 @@
 namespace Fiscalapi.XmlDownloader.FileStorage;
 
 /// <summary>
-/// Interface for cross-platform file system operations
-/// Designed to support multiple implementations like local file system, cloud storage, etc.
+/// Interface for file system operations.
 /// </summary>
 public interface IFileStorageService
 {
-    /// <summary>
-    /// Check if a file exists at the specified path
-    /// </summary>
-    bool FileExists(string filePath);
-
     /// <summary>
     /// Check if a directory exists at the specified path
     /// </summary>
+    /// <param name="directoryPath">Full path to the directory</param>
+    /// <returns>True if directory exists</returns>
     bool DirectoryExists(string directoryPath);
 
     /// <summary>
     /// Delete all files and folders recursively from the specified directory
     /// </summary>
-    Task CleanDirectoryAsync(string directoryPath, CancellationToken cancellationToken = default);
+    /// <param name="directoryPath">Full path to the directory to clean</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    void CleanDirectory(string directoryPath, CancellationToken cancellationToken = default);
 
     /// <summary>
-    /// Extract a ZIP file to the specified destination path or default directory if not specified
+    /// Create a directory if it doesn't exist
     /// </summary>
-    /// <param name="zipFilePath">Package .zip path</param>
-    /// <param name="extractToPath">Path to write unzip files</param>
-    /// <param name="cancellationToken">CancellationToken</param>
-    /// <returns>Completion Task</returns>
-    Task ExtractZipFileAsync(string zipFilePath, string? extractToPath = null,
-        CancellationToken cancellationToken = default);
+    /// <param name="directoryPath">Full path to the directory to create</param>
+    void CreateDirectoryIfNotExist(string directoryPath);
 
     /// <summary>
-    /// Ensure required directories exist based on configuration settings
+    /// Check if a file exists at the specified path
     /// </summary>
-    Task EnsureDirectoriesAsync(CancellationToken cancellationToken = default);
+    /// <param name="fullFilePath">Full path to the file</param>
+    /// <returns>True if file exists</returns>
+    bool FileExists(string fullFilePath);
 
     /// <summary>
-    /// Get a list of files from the specified directory with optional file extension filter
+    /// Extract a ZIP file to the specified destination path
     /// </summary>
-    Task<List<FileDetails>> GetFilesAsync(string directoryPath, string? fileExtension = null,
+    /// <param name="fullFilePath">Full path to the ZIP file</param>
+    /// <param name="extractToPath">Path to extract files to</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Completion Task</returns>
+    void ExtractZipFile(string fullFilePath, string extractToPath,
         CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// Get a list of files from the specified directory with optional file extension filter
+    /// </summary>
+    /// <param name="directoryPath">Full path to the directory</param>
+    /// <param name="fileExtension">File extension filter (optional)</param>
+    /// <returns>List of file details</returns>
+    List<FileDetails> GetFiles(string directoryPath, string? fileExtension = null);
+
     /// <summary>
     /// Write binary data to a file
     /// </summary>
-    Task WriteFileAsync(string filePath, byte[] data, CancellationToken cancellationToken = default);
+    /// <param name="fullFilePath">Full path to the file</param>
+    /// <param name="data">Binary data to write</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    Task WriteFileAsync(string fullFilePath, byte[] data, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// Write base64 encoded data to a file
     /// </summary>
-    Task WriteFileAsync(string filePath, string base64Data, CancellationToken cancellationToken = default);
+    /// <param name="fullFilePath">Full path to the file</param>
+    /// <param name="base64Data">Base64 encoded data to write</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    Task WriteFileAsync(string fullFilePath, string base64Data, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// Read file content as byte array
     /// </summary>
-    Task<byte[]> ReadFileAsync(string filePath, CancellationToken cancellationToken = default);
+    /// <param name="fullFilePath">Full path to the file</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>File content as byte array</returns>
+    Task<byte[]> ReadFileAsync(string fullFilePath, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// Read file content as string
     /// </summary>
-    Task<string> ReadFileContentAsync(string filePath, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Copy a file from source to destination
-    /// </summary>
-    Task<bool> CopyFileAsync(string sourceFilePath, string destinationFilePath, bool overwrite = false,
-        CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Move a file from source to destination
-    /// </summary>
-    Task<bool> MoveFileAsync(string sourceFilePath, string destinationFilePath,
-        CancellationToken cancellationToken = default);
+    /// <param name="fullFilePath">Full path to the file</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>File content as string</returns>
+    Task<string> ReadFileContentAsync(string fullFilePath, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// Delete a file
     /// </summary>
-    Task<bool> DeleteFileAsync(string filePath, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Get file size in bytes
-    /// </summary>
-    Task<long> GetFileSizeAsync(string filePath, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Create a directory if it doesn't exist
-    /// </summary>
-    Task CreateDirectoryAsync(string directoryPath, CancellationToken cancellationToken = default);
+    /// <param name="fullFilePath">Full path to the file</param>
+    /// <returns>True if file was deleted successfully</returns>
+    void DeleteFile(string fullFilePath);
 }

FileStorage/IFileStorageService.cs

@@ -89,39 +89,40 @@ Task<AuthResponse> AuthenticateAsync(string base64Cer, string base64Key, string
     /// <summary>
     /// Writes the downloaded package bytes to a file at the specified path.
     /// </summary>
-    /// <param name="path">Disk path where package will be written</param>
+    /// <param name="fullFilePath">Disk path where package will be written</param>
     /// <param name="bytes">Package data in bytes</param>
     /// <param name="cancellationToken">cancellationToken</param>
     /// <returns>Completed Task</returns>
-    Task WritePackageAsync(string path, byte[] bytes, CancellationToken cancellationToken = default);
+    Task WritePackageAsync(string fullFilePath, byte[] bytes, CancellationToken cancellationToken = default);
 
 
     /// <summary>
     /// Writes the downloaded package data to a file at the specified path.
     /// </summary>
-    /// <param name="path">Disk path where package will be written</param>
+    /// <param name="fullFilePath">Disk path where package will be written</param>
     /// <param name="base64Package">Package data in base 64</param>
     /// <param name="cancellationToken">cancellationToken</param>
     /// <returns>Completed Task</returns>
-    Task WritePackageAsync(string path, string base64Package, CancellationToken cancellationToken = default);
+    Task WritePackageAsync(string fullFilePath, string base64Package, CancellationToken cancellationToken = default);
 
 
     /// <summary>
     /// Reads a file from the disk at the specified path and returns its content as a byte array.
     /// </summary>
-    /// <param name="filePath">File path</param>
+    /// <param name="fullFilePath">File path</param>
     /// <param name="cancellationToken">CancellationToken</param>
     /// <returns>data in bytes</returns>
-    Task<byte[]> ReadFileAsync(string filePath, CancellationToken cancellationToken = default);
+    Task<byte[]> ReadFileAsync(string fullFilePath, CancellationToken cancellationToken = default);
 
 
     /// <summary>
     /// Retrieves a list of Comprobantes from a package represented by its extracted directory path.
     /// </summary>
-    /// <param name="zipFilePath">Package .zip file path</param>
+    /// <param name="fullZipFilePath">Package .zip file path</param>
+    /// <param name="extractToPath"></param>
     /// <param name="cancellationToken">CancellationToken</param>
     /// <returns>List of Comprobantes objects</returns>
-    IAsyncEnumerable<Comprobante> GetComprobantesAsync(string zipFilePath,
+    IAsyncEnumerable<Comprobante> GetComprobantesAsync(string fullZipFilePath, string extractToPath,
         CancellationToken cancellationToken = default);
 
     /// <summary>

IXmlDownloaderService.cs

@@ -4,7 +4,7 @@
 	  <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-	  <Version>5.0.2</Version>
+	  <Version>5.0.3</Version>
 	  <AssemblyVersion>$(Version)</AssemblyVersion>
 	  <FileVersion>$(Version)</FileVersion>
 	  <PackageVersion>$(Version)</PackageVersion>