Add support for detailed auto-updater event handling (#590)

Expanded event constructors to include more detailed update metadata such as version, files, release information, and system requirements. Added a `downloadUpdate` method to the AutoUpdater facade. These updates enhance event broadcasting and improve client interaction with the auto-updater.

Author: WINBIGFOX

src/AutoUpdater.php

@@ -17,4 +17,9 @@ public function quitAndInstall(): void
     {
         $this->client->post('auto-updater/quit-and-install');
     }
+
+    public function downloadUpdate(): void
+    {
+        $this->client->post('auto-updater/download-update');
+    }
 }

src/Events/AutoUpdater/DownloadProgress.php

@@ -12,7 +12,13 @@ class DownloadProgress implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 
-    public function __construct(public int $total, public int $delta, public int $transferred, public float $percent, public int $bytesPerSecond) {}
+    public function __construct(
+        public int $total,
+        public int $delta,
+        public int $transferred,
+        public float $percent,
+        public int $bytesPerSecond
+    ) {}
 
     public function broadcastOn()
     {

src/Events/AutoUpdater/Error.php

@@ -12,7 +12,11 @@ class Error implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 
-    public function __construct(public string $error) {}
+    public function __construct(
+        public string $name,
+        public string $message,
+        public ?string $stack,
+    ) {}
 
     public function broadcastOn()
     {

src/Events/AutoUpdater/UpdateAvailable.php

@@ -12,7 +12,15 @@ class UpdateAvailable implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 
-    public function __construct() {}
+    public function __construct(
+        public string $version,
+        public array $files,
+        public string $releaseDate,
+        public ?string $releaseName,
+        public string|array|null $releaseNotes,
+        public ?int $stagingPercentage,
+        public ?string $minimumSystemVersion,
+    ) {}
 
     public function broadcastOn()
     {

src/Events/AutoUpdater/UpdateCancelled.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Native\Laravel\Events\AutoUpdater;
+
+use Illuminate\Broadcasting\Channel;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class UpdateCancelled implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    public function __construct(
+        public string $version,
+        public array $files,
+        public string $releaseDate,
+        public ?string $releaseName,
+        public string|array|null $releaseNotes,
+        public ?int $stagingPercentage,
+        public ?string $minimumSystemVersion,
+    ) {}
+
+    public function broadcastOn()
+    {
+        return [
+            new Channel('nativephp'),
+        ];
+    }
+}

src/Events/AutoUpdater/UpdateDownloaded.php

@@ -12,7 +12,16 @@ class UpdateDownloaded implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 
-    public function __construct(public string $version, public string $downloadedFile, public string $releaseDate, public ?string $releaseNotes, public ?string $releaseName) {}
+    public function __construct(
+        public string $downloadedFile,
+        public string $version,
+        public array $files,
+        public string $releaseDate,
+        public ?string $releaseName,
+        public string|array|null $releaseNotes,
+        public ?int $stagingPercentage,
+        public ?string $minimumSystemVersion
+    ) {}
 
     public function broadcastOn()
     {

src/Events/AutoUpdater/UpdateNotAvailable.php

@@ -12,6 +12,16 @@ class UpdateNotAvailable implements ShouldBroadcastNow
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 
+    public function __construct(
+        public string $version,
+        public array $files,
+        public string $releaseDate,
+        public ?string $releaseName,
+        public string|array|null $releaseNotes,
+        public ?int $stagingPercentage,
+        public ?string $minimumSystemVersion,
+    ) {}
+
     public function broadcastOn()
     {
         return [

src/Facades/AutoUpdater.php

@@ -7,6 +7,7 @@
 /**
  * @method static void checkForUpdates()
  * @method static void quitAndInstall()
+ * @method static void downloadUpdate()
  */
 class AutoUpdater extends Facade
 {