feat: add update page, refactor update checking process

2026-03-14 20:33:40 +00:00 · 2026-01-16 13:39:11 +01:00 · 2026-01-16 13:39:11 +01:00 · 297a17d00b
commit 297a17d00b
parent eb767fa6d0
17 changed files with 1212 additions and 241 deletions
--- a/tests/Feature/Jobs/CheckVersionUpdateJobTest.php
+++ b/tests/Feature/Jobs/CheckVersionUpdateJobTest.php
@ -0,0 +1,147 @@
+<?php
+
+use App\Jobs\CheckVersionUpdateJob;
+use App\Settings\UpdateSettings;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Http;
+
+beforeEach(function (): void {
+    Http::preventStrayRequests();
+    Cache::flush();
+    config(['app.version' => '1.0.0']);
+});
+
+test('it returns latest version when update is available', function (): void {
+    $githubRepo = config('app.github_repo');
+    $apiBaseUrl = "https://api.github.com/repos/{$githubRepo}";
+
+    Http::fake([
+        "{$apiBaseUrl}/releases/latest" => Http::response([
+            'tag_name' => '1.1.0',
+            'body' => 'Release notes',
+        ], 200),
+    ]);
+
+    $result = (new CheckVersionUpdateJob)->handle(app(UpdateSettings::class));
+
+    expect($result)
+        ->latest_version->toBe('1.1.0')
+        ->is_newer->toBeTrue()
+        ->release_data->not->toBeNull();
+});
+
+test('it returns false when no update is available', function (): void {
+    $githubRepo = config('app.github_repo');
+    $apiBaseUrl = "https://api.github.com/repos/{$githubRepo}";
+
+    Http::fake([
+        "{$apiBaseUrl}/releases/latest" => Http::response([
+            'tag_name' => '1.0.0',
+            'body' => 'Release notes',
+        ], 200),
+    ]);
+
+    $result = (new CheckVersionUpdateJob)->handle(app(UpdateSettings::class));
+
+    expect($result)
+        ->latest_version->toBe('1.0.0')
+        ->is_newer->toBeFalse();
+});
+
+test('it caches the release data', function (): void {
+    $githubRepo = config('app.github_repo');
+    $apiBaseUrl = "https://api.github.com/repos/{$githubRepo}";
+
+    Http::fake([
+        "{$apiBaseUrl}/releases/latest" => Http::response([
+            'tag_name' => '1.1.0',
+            'body' => 'Release notes',
+        ], 200),
+    ]);
+
+    (new CheckVersionUpdateJob)->handle(app(UpdateSettings::class));
+
+    expect(Cache::has('latest_release'))->toBeTrue();
+});
+
+test('it forces refresh when forceRefresh is true', function (): void {
+    $githubRepo = config('app.github_repo');
+    $apiBaseUrl = "https://api.github.com/repos/{$githubRepo}";
+
+    Http::fake([
+        "{$apiBaseUrl}/releases/latest" => Http::sequence()
+            ->push([
+                'tag_name' => '1.1.0',
+                'body' => 'Release notes',
+            ], 200)
+            ->push([
+                'tag_name' => '1.2.0',
+                'body' => 'New release notes',
+            ], 200),
+    ]);
+
+    // First call caches
+    (new CheckVersionUpdateJob)->handle(app(UpdateSettings::class));
+
+    // Second call with force refresh should make new request
+    $result = (new CheckVersionUpdateJob(true))->handle(app(UpdateSettings::class));
+
+    expect($result['latest_version'])->toBe('1.2.0');
+    Http::assertSentCount(2);
+});
+
+test('it handles pre-releases when enabled', function (): void {
+    $updateSettings = app(UpdateSettings::class);
+    $updateSettings->prereleases = true;
+    $updateSettings->save();
+
+    $githubRepo = config('app.github_repo');
+    $apiBaseUrl = "https://api.github.com/repos/{$githubRepo}";
+
+    Http::fake([
+        "{$apiBaseUrl}/releases" => Http::response([
+            [
+                'tag_name' => '1.2.0-beta',
+                'body' => 'Beta release',
+                'prerelease' => true,
+            ],
+            [
+                'tag_name' => '1.1.0',
+                'body' => 'Stable release',
+                'prerelease' => false,
+            ],
+        ], 200),
+    ]);
+
+    $result = (new CheckVersionUpdateJob)->handle($updateSettings);
+
+    // Should prefer pre-release if newer
+    expect($result['latest_version'])->toBe('1.2.0-beta');
+});
+
+test('it returns null when no version is configured', function (): void {
+    config(['app.version' => null]);
+
+    $result = (new CheckVersionUpdateJob)->handle(app(UpdateSettings::class));
+
+    expect($result)
+        ->latest_version->toBeNull()
+        ->is_newer->toBeFalse()
+        ->release_data->toBeNull();
+});
+
+test('it handles API failures gracefully', function (): void {
+    $githubRepo = config('app.github_repo');
+    $apiBaseUrl = "https://api.github.com/repos/{$githubRepo}";
+
+    Http::fake([
+        "{$apiBaseUrl}/releases/latest" => Http::response([], 500),
+    ]);
+
+    $result = (new CheckVersionUpdateJob)->handle(app(UpdateSettings::class));
+
+    expect($result)
+        ->latest_version->toBeNull()
+        ->is_newer->toBeFalse()
+        ->release_data->toBeNull();
+});