<?php

namespace App\Support\Monitoring;

use Illuminate\Support\Facades\RateLimiter;
use Illuminate\Support\Str;
use Sentry\Severity;
use Sentry\State\Scope;

use function Sentry\captureMessage;
use function Sentry\withScope;

/**
 * Fehler ohne Exception als GlitchTip-Warnung: tote
 * interne Links, verweigerte Zugriffe, abgelaufene Seiten. Gruppiert wird je
 * Signal und Ort; je Gruppe gehen höchstens fünf Meldungen in zehn Minuten
 * raus, damit ein Crawler mit gefälschtem Referrer GlitchTip nicht flutet.
 */
class ErrorSignal
{
    public const DeadInternalLink = 'dead_internal_link';

    public const AccessDenied = 'access_denied';

    public const PageExpired = 'page_expired';

    public const Throttled = 'throttled';

    private const Labels = [
        self::DeadInternalLink => 'Toter interner Link',
        self::AccessDenied => 'Zugriff verweigert (angemeldet)',
        self::PageExpired => 'Seite abgelaufen (419)',
        self::Throttled => 'Drosselung trifft angemeldeten Nutzer',
    ];

    private const MaxReportsPerWindow = 5;

    private const WindowSeconds = 600;

    /**
     * @param  array<string, mixed>  $context
     */
    public function report(string $signal, string $location, array $context = []): bool
    {
        $location = Str::limit($location, 200, '');

        $reported = RateLimiter::attempt(
            'error-signal:'.sha1($signal.'|'.$location),
            self::MaxReportsPerWindow,
            static fn (): bool => true,
            self::WindowSeconds,
        );

        if ($reported === false) {
            return false;
        }

        withScope(function (Scope $scope) use ($signal, $location, $context): void {
            $scope->setFingerprint(['error-signal', $signal, $location]);
            $scope->setTag('signal', $signal);
            $scope->setContext('signal', $context);

            captureMessage((self::Labels[$signal] ?? $signal).': '.$location, Severity::warning());
        });

        return true;
    }
}