<?php

declare(strict_types=1);

namespace Monitor\Api\Sync;

/**
 * Bestimmt, wie lange der Sync-Dauerlaeufer (bin/sync-codeberg.php --watch) bis zum
 * naechsten Lauf wartet.
 *
 * Nach einem erfolgreichen Lauf ist das schlicht MONITOR_SYNC_INTERVAL. Nach einem
 * Fehlschlag wird der naechste Versuch dagegen deutlich vorgezogen: Ein per Webhook
 * angeforderter Sync ist zu diesem Zeitpunkt bereits quittiert (SyncTrigger::consume()
 * loescht die Anforderung vor dem Lauf), er wuerde sonst also erst nach vollen 600s
 * nachgeholt - genau die Verzoegerung, die der Webhook abschaffen soll.
 *
 * Der Abstand waechst exponentiell (5s, 10s, 20s, …), gedeckelt auf das regulaere
 * Intervall. Damit erholt sich ein kurzer Aussetzer (beobachtet: vereinzelte
 * curl-Timeouts nach 15s ohne Antwort) binnen Sekunden, waehrend eine laengere
 * Codeberg-Stoerung nicht in einen Dauerbeschuss laeuft.
 */
final class SyncSchedule
{
    /** Ab hier waere 2^$failures groesser als jedes sinnvolle Intervall - schuetzt vor Overflow. */
    private const MAX_EXPONENT = 20;

    public function __construct(
        private readonly int $intervalSeconds,
        private readonly int $retryBaseSeconds = 5,
    ) {
    }

    public function secondsUntilNextRun(int $consecutiveFailures): int
    {
        if ($consecutiveFailures < 1) {
            return $this->intervalSeconds;
        }

        $exponent = min($consecutiveFailures - 1, self::MAX_EXPONENT);

        return min($this->intervalSeconds, $this->retryBaseSeconds * (2 ** $exponent));
    }
}