<?php

namespace App\Support;

use App\Enums\PressReleaseStatus;
use App\Models\PressRelease;
use App\Scopes\PortalScope;
use Illuminate\Support\Carbon;

/**
 * Liefert den „Redaktions-Stichtag" für aktualitätsbezogene Startseiten-Abfragen.
 *
 * Das migrierte Archiv ist historisch: Der jüngste veröffentlichte Datensatz
 * kann Wochen/Monate in der Vergangenheit liegen. Würde man „heute / letzte 7
 * Tage" hart gegen das echte now() rechnen, liefern alle Aktualitäts-Module
 * 0 Treffer und fallen auf Mock-Daten zurück.
 *
 * Stattdessen wird der Stichtag an den jüngsten verfügbaren Veröffentlichungs-
 * zeitpunkt gekoppelt (gedeckelt auf now()): Liegt das jüngste published_at in
 * der Vergangenheit, dient es als Referenz-„Jetzt"; sobald frische
 * Pressemitteilungen mit aktuellem Datum einlaufen, greift automatisch wieder
 * das echte now().
 */
class EditorialClock
{
    /**
     * @param  array<int, string>  $portalValues
     */
    public static function reference(array $portalValues, string $language = 'de'): Carbon
    {
        $latest = PressRelease::query()
            ->withoutGlobalScope(PortalScope::class)
            ->whereIn('portal', $portalValues)
            ->where('status', PressReleaseStatus::Published)
            ->where('language', $language)
            ->whereNotNull('published_at')
            ->where('published_at', '<=', now())
            ->max('published_at');

        if (! $latest) {
            return now();
        }

        $latest = Carbon::parse($latest);

        return $latest->lt(now()) ? $latest : now();
    }
}