<?php

namespace App\Services\Mail;

/**
 * Schmale DNS-Schnittstelle, damit die Domainprüfung deterministisch testbar
 * bleibt (Abnahmekriterium: keine öffentlichen Resolver im Testlauf).
 */
interface DnsResolver
{
    /**
     * Records eines Typs.
     *
     * @param  'MX'|'A'|'AAAA'|'NS'|'SOA'  $type
     * @return list<array<string, mixed>>|null null = Resolver-Fehler
     *                                         (Timeout/SERVFAIL), [] = Domain
     *                                         antwortet, hat aber keinen
     *                                         solchen Record
     */
    public function records(string $domain, string $type): ?array;
}