Add AutoUpdater feature with events and facade support (#570)

* Add AutoUpdater feature with events and facade support

Introduces the `AutoUpdater` class to manage update processes via the client. Adds events such as `UpdateAvailable`, `UpdateDownloaded`, and others for broadcasting update states. A facade is also provided for convenient usage.

* Add DownloadProgress event for real-time update broadcasting

This event handles broadcasting download progress updates through a 'nativephp' channel. It includes details such as total size, delta, transferred bytes, percentage completed, and speed.

* fix: update property types in DownloadProgress constructor

Adjusted the types of total, delta, and bytesPerSecond from float to int to ensure type consistency and accuracy. This change prevents potential precision issues and aligns with expected data formats.

Author: WINBIGFOX

src/AutoUpdater.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Native\Laravel;
+
+use Native\Laravel\Client\Client;
+
+class AutoUpdater
+{
+    public function __construct(protected Client $client) {}
+
+    public function checkForUpdates(): void
+    {
+        $this->client->post('auto-updater/check-for-updates');
+    }
+
+    public function quitAndInstall(): void
+    {
+        $this->client->post('auto-updater/quit-and-install');
+    }
+}

src/Events/AutoUpdater/CheckingForUpdate.php

@@ -0,0 +1,23 @@
+<?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 CheckingForUpdate implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    public function __construct() {}
+
+    public function broadcastOn()
+    {
+        return [
+            new Channel('nativephp'),
+        ];
+    }
+}

src/Events/AutoUpdater/DownloadProgress.php

@@ -0,0 +1,23 @@
+<?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 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 broadcastOn()
+    {
+        return [
+            new Channel('nativephp'),
+        ];
+    }
+}

src/Events/AutoUpdater/Error.php

@@ -0,0 +1,23 @@
+<?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 Error implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    public function __construct(public string $error) {}
+
+    public function broadcastOn()
+    {
+        return [
+            new Channel('nativephp'),
+        ];
+    }
+}

src/Events/AutoUpdater/UpdateAvailable.php

@@ -0,0 +1,23 @@
+<?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 UpdateAvailable implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    public function __construct() {}
+
+    public function broadcastOn()
+    {
+        return [
+            new Channel('nativephp'),
+        ];
+    }
+}

src/Events/AutoUpdater/UpdateDownloaded.php

@@ -0,0 +1,23 @@
+<?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 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 broadcastOn()
+    {
+        return [
+            new Channel('nativephp'),
+        ];
+    }
+}

src/Events/AutoUpdater/UpdateNotAvailable.php

@@ -0,0 +1,21 @@
+<?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 UpdateNotAvailable implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    public function broadcastOn()
+    {
+        return [
+            new Channel('nativephp'),
+        ];
+    }
+}

src/Facades/AutoUpdater.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Native\Laravel\Facades;
+
+use Illuminate\Support\Facades\Facade;
+
+/**
+ * @method static void checkForUpdates()
+ * @method static void quitAndInstall()
+ */
+class AutoUpdater extends Facade
+{
+    protected static function getFacadeAccessor()
+    {
+        return \Native\Laravel\AutoUpdater::class;
+    }
+}