<?php

namespace App\SendingServers\Identities;

/**
 * Verification status of an identity (or one of its DKIM records).
 *
 * Vendor-specific nuances (SES `NotStarted` / `TemporaryFailure`,
 * SendGrid `locked`, Mailgun `disabled`) collapse onto this 5-case set.
 * Drivers carry the verbatim vendor code in `Identity::$errorType` /
 * SendingIdentity::$error_type when finer detail matters.
 *
 * ARCHIVED is Acelle-derived (set by IdentitySyncService when a row
 * stops appearing in `fetchIdentities()`); no driver emits it directly.
 */
enum IdentityStatus: string
{
    case PENDING  = 'pending';
    case VERIFIED = 'verified';
    case FAILED   = 'failed';
    case DISABLED = 'disabled';
    case ARCHIVED = 'archived';
}