toMatchArray([ 'status' => 'none', 'running_version' => '4.3.0', 'target_version' => '4.3.1', ]); })->with([ 'empty' => '', 'whitespace' => ' ', 'missing fields' => '6|Upgrade complete', 'single token' => 'complete', ]); it('returns in_progress for intermediate upgrade steps', function () { $content = '4|Stopping containers|'.Carbon::parse('2026-08-13T12:00:00+00:00')->toIso8601String(); $result = CoolifyUpgradeStatus::fromFile( content: $content, runningVersion: '4.3.0', targetVersion: '4.3.1', now: Carbon::parse('2026-08-13T12:01:00+00:00'), ); expect($result)->toMatchArray([ 'status' => 'in_progress', 'step' => 4, 'message' => 'Stopping containers', 'running_version' => '4.3.0', 'target_version' => '4.3.1', ]); }); it('does not mark the upgrade complete when the script finished but the running version is still old', function () { $content = '6|Upgrade complete|'.Carbon::parse('2026-08-13T12:00:00+00:00')->toIso8601String(); $result = CoolifyUpgradeStatus::fromFile( content: $content, runningVersion: '4.3.0', targetVersion: '4.3.1', now: Carbon::parse('2026-08-13T12:01:00+00:00'), ); expect($result['status'])->toBe('in_progress') ->and($result['step'])->toBe(6) ->and($result['running_version'])->toBe('4.3.0') ->and($result['target_version'])->toBe('4.3.1') ->and($result['message'])->toContain('Waiting for Coolify') ->and($result['message'])->toContain('4.3.1'); }); it('marks the upgrade complete only after the running version matches the target', function () { $content = '6|Upgrade complete|'.Carbon::parse('2026-08-13T12:00:00+00:00')->toIso8601String(); $result = CoolifyUpgradeStatus::fromFile( content: $content, runningVersion: '4.3.1', targetVersion: '4.3.1', now: Carbon::parse('2026-08-13T12:01:00+00:00'), ); expect($result)->toMatchArray([ 'status' => 'complete', 'step' => 6, 'message' => 'Upgrade complete', 'running_version' => '4.3.1', 'target_version' => '4.3.1', ]); }); it('treats a running version newer than the target as complete', function () { $content = '6|Upgrade complete|'.Carbon::parse('2026-08-13T12:00:00+00:00')->toIso8601String(); $result = CoolifyUpgradeStatus::fromFile( content: $content, runningVersion: '4.3.2', targetVersion: '4.3.1', now: Carbon::parse('2026-08-13T12:01:00+00:00'), ); expect($result['status'])->toBe('complete'); }); it('returns error status without requiring a version match', function () { $content = 'error|Failed to pull image|'.Carbon::parse('2026-08-13T12:00:00+00:00')->toIso8601String(); $result = CoolifyUpgradeStatus::fromFile( content: $content, runningVersion: '4.3.0', targetVersion: '4.3.1', now: Carbon::parse('2026-08-13T12:01:00+00:00'), ); expect($result)->toMatchArray([ 'status' => 'error', 'step' => 0, 'message' => 'Failed to pull image', ]); }); it('ignores stale status files older than ten minutes', function () { $content = '6|Upgrade complete|'.Carbon::parse('2026-08-13T11:00:00+00:00')->toIso8601String(); $result = CoolifyUpgradeStatus::fromFile( content: $content, runningVersion: '4.3.1', targetVersion: '4.3.1', now: Carbon::parse('2026-08-13T12:00:00+00:00'), ); expect($result['status'])->toBe('none'); }); it('reports whether the running version has reached the target', function (string $running, string $target, bool $reached) { expect(CoolifyUpgradeStatus::hasReachedTargetVersion($running, $target))->toBe($reached); })->with([ 'old instance still serving' => ['4.3.0', '4.3.1', false], 'target reached' => ['4.3.1', '4.3.1', true], 'already newer' => ['4.3.2', '4.3.1', true], 'missing running version' => ['', '4.3.1', false], 'missing target version' => ['4.3.1', '', false], ]); it('detects a running upgrade only for recent intermediate steps', function (string $step, int $minutesAgo, bool $expected) { $now = Carbon::parse('2026-08-13T12:00:00+00:00'); $content = "{$step}|Some message|".$now->copy()->subMinutes($minutesAgo)->toIso8601String(); expect(CoolifyUpgradeStatus::isRunning($content, $now))->toBe($expected); })->with([ 'recent step 1' => ['1', 0, true], 'step 5 at lock expiry' => ['5', 15, true], 'step 3 after lock expiry' => ['3', 16, false], 'complete' => ['6', 1, false], 'error' => ['error', 1, false], ]); it('does not detect a running upgrade for empty or malformed status', function (string $content) { expect(CoolifyUpgradeStatus::isRunning($content))->toBeFalse(); })->with([ 'empty' => '', 'missing fields' => '3|Pulling Docker images', 'invalid timestamp' => '3|Pulling Docker images|not-a-date', ]);