Managing Domains

use Lettr\Laravel\Facades\Lettr;

$domains = Lettr::domains()->list();

foreach ($domains as $domain) {
    echo $domain->domain;              // example.com
    echo $domain->status->value;       // 'pending', 'approved'
    echo $domain->canSend;             // true/false
    echo $domain->dkimStatus?->value;  // 'valid', 'invalid', etc.
    echo $domain->cnameStatus?->value;
}

use Lettr\ValueObjects\DomainName;

$result = Lettr::domains()->create('example.com');
// or pass a DomainName value object
$result = Lettr::domains()->create(new DomainName('example.com'));

echo $result->domain;        // example.com
echo $result->status->value; // 'pending'
echo $result->statusLabel;   // "Pending Review"

// DKIM records to publish in DNS
if ($result->dkim !== null) {
    echo $result->dkim->selector;      // e.g. "scph0226"
    echo $result->dkim->publicKey;
    echo $result->dkim->headers;       // signed headers
    echo $result->dkim->signingDomain;
}

$domain = Lettr::domains()->get('example.com');

echo $domain->domain;
echo $domain->status->value;
echo $domain->canSend;
echo $domain->dkimStatus?->label();   // DnsStatus enum
echo $domain->cnameStatus?->label();
echo $domain->dmarcStatus?->label();
echo $domain->spfStatus?->label();
echo $domain->trackingDomain;
echo $domain->createdAt;

// DKIM record helpers
if ($domain->dkim !== null) {
    echo $domain->dkim->recordName('example.com'); // Full DNS record name
    echo $domain->dkim->recordValue();             // Full DNS record value
}

$verification = Lettr::domains()->verify('example.com');

if ($verification->isFullyVerified()) {
    echo "Domain is ready to send!";
} else {
    // Individual record statuses
    echo $verification->dkimStatus->label();   // "Valid", "Invalid", "Missing", etc.
    echo $verification->cnameStatus->label();
    echo $verification->dmarcStatus->label();
    echo $verification->spfStatus->label();

    // Specific DNS record errors
    if ($verification->hasErrors()) {
        foreach ($verification->errors() as $type => $error) {
            echo "$type: $error";
        }
    }
}

Lettr::domains()->delete('example.com');