<?php

namespace App\Mail;

use App\Models\Monitoring\ApiRateEvent;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Content;
use Illuminate\Mail\Mailables\Envelope;
use Illuminate\Queue\SerializesModels;

/**
 * Aviso a Sistemas de que una IP está cerca del tope de peticiones de la API, o ya
 * lo ha alcanzado.
 *
 * Se envía con enfriamiento (ver `config/api.php` → `alerts.cooldown_minutes`): un
 * correo por IP y motivo, no uno por petición. Ver known-issues MGR-008.
 */
class ApiRateLimitAlert extends Mailable
{
    use Queueable;
    use SerializesModels;

    public function __construct(
        public ApiRateEvent $evento,
        public string $entorno
    ) {
    }

    public function envelope(): Envelope
    {
        $aviso = $this->evento->kind === ApiRateEvent::KIND_BLOCKED
            ? 'Tope de peticiones ALCANZADO'
            : 'Aviso: IP cerca del tope de peticiones';

        return new Envelope(
            subject: "[Manager {$this->entorno}] {$aviso} — {$this->evento->ip}",
        );
    }

    public function content(): Content
    {
        return new Content(
            markdown: 'emails.api-rate-limit-alert',
            with: [
                'evento' => $this->evento,
                'entorno' => $this->entorno,
            ],
        );
    }
}