<?php

namespace App\Services;

use App\Models\WaitlistSubscriber;

final class WaitlistService
{
    /**
     * Add someone to the feature-launch waitlist.
     *
     * Idempotent: re-subscribing an existing email is a no-op that returns the
     * original subscriber unchanged — original meta (source, referrer) is kept,
     * never a duplicate row or an error.
     */
    public function subscribe(
        string $name,
        string $email,
        ?string $source = null,
        ?string $referrer = null,
    ): WaitlistSubscriber {
        $email = strtolower(trim($email));

        return WaitlistSubscriber::firstOrCreate(
            ['email' => $email],
            ['name' => $name, 'source' => $source, 'referrer' => $referrer],
        );
    }
}