<?php

namespace App\Ops\Tasks;

use App\Ops\ArchiveUpdate;
use App\Ops\Updater;

/**
 * Fragt einmal täglich, ob es eine neuere Fassung gibt.
 *
 * Sie prüft nur und installiert nichts. Ein Update tauscht Dateien und führt Migrationen aus;
 * das gehört an einen Knopf, den ein Mensch drückt, und nicht in den Seitenaufruf eines
 * Besuchers.
 *
 * Ist die Fassungsliste nicht erreichbar, ist das ein Fehler und keine Entwarnung: „keine
 * Antwort" und „kein Update" sehen sonst gleich aus, und das eine ist eine Nachricht, das andere
 * eine ausgefallene Prüfung.
 */
final class UpdateCheckTask implements Task
{
    public function __construct(private ArchiveUpdate $archive, private Updater $updater)
    {
    }

    public function name(): string
    {
        return 'update-check';
    }

    public function label(): string
    {
        return 'Nach Updates sehen';
    }

    public function explanation(): string
    {
        return 'Fragt beim Repository nach der neuesten Fassung. Sie installiert nichts – das Ergebnis steht hier und auf dem Bildschirm „System".';
    }

    public function interval(): int
    {
        return 86400;
    }

    public function run(): string
    {
        $latest = $this->archive->latest();
        if (null === $latest) {
            throw new \RuntimeException('Die Fassungsliste war nicht erreichbar. Erlaubt dieses Hosting ausgehende Verbindungen?');
        }
        $installed = $this->updater->version();

        return version_compare($latest['version'], $installed, '>')
            ? sprintf('Fassung %s ist verfügbar; installiert ist %s.', $latest['version'], $installed)
            : sprintf('Aktuell: Fassung %s.', $installed);
    }
}