<?php

namespace App\Enums;

/**
 * Art eines Rückläufers. Maßgeblich ist bei DSNs `Action`, nicht der
 * Statuscode allein (Konzept `bounce-mails-2026-09-15.md`).
 */
enum EmailBounceKind: string
{
    /** `Action: failed`, Status 5.x.x — Postfach existiert nicht, sofort sperren */
    case Hard = 'hard';

    /** `Action: delayed` oder Status 4.x.x — zählen, ab dem dritten in sieben Tagen sperren */
    case Soft = 'soft';

    /** Relay lehnt UNS ab (5.7.x, 554 Spam-Pattern, Verbindung) — kein Empfängerproblem, Circuit Breaker */
    case Relay = 'relay';

    /**
     * Der Empfängerserver lehnt aus Richtlinie ab (5.7.x: „Relay access
     * denied", Spamfilter, Transportregel). Das Postfach kann einwandfrei
     * existieren — wird protokolliert und angezeigt, zählt aber auf keinen
     * Schwellwert. Sonst sperrt ein dreimal zuschlagender Firmenfilter eine
     * funktionierende Adresse.
     */
    case Policy = 'policy';

    public function label(): string
    {
        return match ($this) {
            self::Hard => 'hart',
            self::Soft => 'weich',
            self::Relay => 'Relay',
            self::Policy => 'Richtlinie',
        };
    }
}