<?php

namespace App\Enums;

/**
 * Ergebnis der DNS-Prüfung einer E-Mail-Domain (Kontakterreichbarkeit,
 * Abschnitt 3). Bewertet ausschließlich den Zustellweg der Domain — nie das
 * einzelne Postfach und nie die Identität des Kontakts.
 */
enum EmailDomainState: string
{
    /** MX vorhanden und mindestens ein Ziel auflösbar. */
    case Deliverable = 'deliverable';

    /** Kein MX, aber A/AAAA — impliziter MX nach RFC 5321 § 5.1, zulässig. */
    case ImplicitMx = 'implicit_mx';

    /** `MX 0 .` — die Domain erklärt ausdrücklich, keine Mail anzunehmen (RFC 7505). */
    case NullMx = 'null_mx';

    /** Domain existiert, hat aber weder MX noch A/AAAA. */
    case NoMailPath = 'no_mail_path';

    /** Die Domain gibt es nicht (NXDOMAIN). */
    case DomainMissing = 'domain_missing';

    /** MX vorhanden, aber kein Ziel auflösbar — fehlerhafte Mailkonfiguration. */
    case BrokenMx = 'broken_mx';

    /** Timeout/SERVFAIL — Ergebnis unbekannt, erneut prüfen. Kein Befund. */
    case Unresolved = 'unresolved';

    public function isDeliverable(): bool
    {
        return $this === self::Deliverable || $this === self::ImplicitMx;
    }

    /**
     * Nachweislich kein Zustellweg. `Unresolved` gehört ausdrücklich nicht
     * dazu — „nicht geprüft" ist kein Befund.
     */
    public function isBroken(): bool
    {
        return match ($this) {
            self::NullMx, self::NoMailPath, self::DomainMissing, self::BrokenMx => true,
            default => false,
        };
    }

    public function label(): string
    {
        return match ($this) {
            self::Deliverable => 'Zustellweg vorhanden',
            self::ImplicitMx => 'Zustellweg über A-Eintrag',
            self::NullMx => 'Domain nimmt keine Mail an',
            self::NoMailPath => 'Kein Zustellweg im DNS',
            self::DomainMissing => 'Domain existiert nicht',
            self::BrokenMx => 'Mailserver nicht auflösbar',
            self::Unresolved => 'Prüfung offen',
        };
    }

    public function badgeClass(): string
    {
        return match ($this) {
            self::Deliverable, self::ImplicitMx => 'ok',
            self::Unresolved => 'warn',
            default => 'err',
        };
    }
}