<?php

namespace App\Enums;

/**
 * Herkunft eines Konversionsereignisses (Roadmap Block 0).
 *
 * Der entscheidende Punkt: Der Wert wird auf dem MAGIC-LINK-TOKEN gespeichert,
 * nicht in einer Session. Die zu messende Strecke führt über zwei Domains
 * (presseecho.de → pressekonto.com), einen Mailclient und mögliche
 * Weiterleitungen. Eine Session überlebt das nicht, ein Token schon. Ohne
 * diesen Schritt wüsste man am Ende, dass jemand gebucht hat, aber nicht, ob er
 * aus einer Ablehnungsmail kam — und genau das ist die Frage.
 */
enum ConversionSource: string
{
    case MailPublish = 'mail_publish';

    case MailReject = 'mail_reject';

    case ProfileClaim = 'profile_claim';

    case Organic = 'organic';

    public function label(): string
    {
        return match ($this) {
            self::MailPublish => 'Veröffentlichungsmail',
            self::MailReject => 'Ablehnungsmail',
            self::ProfileClaim => 'Hinweis auf der Newsroom-Seite',
            self::Organic => 'ohne zugeordnete Herkunft',
        };
    }

    /**
     * Auflösung eines Werts aus einer URL oder einem Token.
     *
     * Unbekannte Werte werden zu `organic` statt zu einem Fehler: Der Parameter
     * steht in fremder Hand (Mailclient, Weiterleitung, manuell getippt) und
     * darf niemals einen Request scheitern lassen.
     */
    public static function parse(?string $value): self
    {
        return self::tryFrom((string) $value) ?? self::Organic;
    }
}