Refactor Downloader classes to improve code structure and readability

src/Utils/Downloader/Downloader.php

@@ -2,6 +2,12 @@
 
 namespace Kiwilan\Steward\Utils\Downloader;
 
+/**
+ * Downloader to download a file or a stream of zip files.
+ *
+ * - Use `Downloader::direct()` to download a file directly.
+ * - Use `Downloader::stream()` to download a stream of zip files.
+ */
 class Downloader
 {
     protected function __construct(
@@ -12,23 +18,15 @@ protected function __construct(
     ) {
     }
 
-    /**
-     * Initialize the downloader.
-     */
-    public static function make(): self
-    {
-        return new self();
-    }
-
-    public function direct(string $path): DownloaderDirect
+    public static function direct(string $path): DownloaderDirect
     {
         $download = new DownloaderDirect($path);
         $download->filename = basename($path);
 
         return $download;
     }
 
-    public function stream(string $filename): DownloaderZipStream
+    public static function stream(string $filename): DownloaderZipStream
     {
         $zip = new DownloaderZipStream();
         $zip->filename = "{$filename}.zip";

src/Utils/Downloader/DownloaderDirect.php

@@ -2,6 +2,9 @@
 
 namespace Kiwilan\Steward\Utils\Downloader;
 
+/**
+ * Downloader to download a file.
+ */
 class DownloaderDirect extends Downloader
 {
     protected function __construct(
@@ -10,13 +13,19 @@ protected function __construct(
         parent::__construct(basename($path));
     }
 
+    /**
+     * Set the value of mimeType. If null, it will be automatically determined from the filename.
+     */
     public function autoMimeType(): self
     {
         $this->mimeType = mime_content_type($this->path);
 
         return $this;
     }
 
+    /**
+     * Trigger the download.
+     */
     public function get(): void
     {
         $this->size = filesize($this->path);

src/Utils/Downloader/DownloaderZipStream.php

@@ -2,6 +2,9 @@
 
 namespace Kiwilan\Steward\Utils\Downloader;
 
+/**
+ * Downloader to download a stream of zip files.
+ */
 class DownloaderZipStream extends Downloader
 {
     /**
@@ -14,7 +17,7 @@ protected function __construct(
     }
 
     /**
-     * Set the value of files.
+     * Set files to be downloaded, use `DownloaderZipStreamItem` to create a file.
      *
      * @param  DownloaderZipStreamItem[]  $files
      */
@@ -25,6 +28,9 @@ public function files(array $files): self
         return $this;
     }
 
+    /**
+     * Trigger the download.
+     */
     public function get(): void
     {
         ini_set('max_execution_time', $this->maxExecutionTime);