<?php

declare(strict_types=1);

namespace App\Administration\Domain\Model\Session;

/**
 * Localisation approximative basée sur l'adresse IP.
 *
 * Utilisé pour afficher "France, Paris" dans la liste des sessions.
 * La précision dépend du service de géolocalisation.
 *
 * @see Story 1.6 - Gestion des sessions
 */
final readonly class Location
{
    private function __construct(
        public ?string $ip,
        public ?string $country,
        public ?string $city,
    ) {
    }

    /**
     * Crée une localisation à partir d'une IP et des données de géolocalisation.
     */
    public static function fromIp(string $ip, ?string $country, ?string $city): self
    {
        return new self(
            ip: $ip,
            country: $country,
            city: $city,
        );
    }

    /**
     * Crée une localisation inconnue (quand la géolocalisation échoue).
     */
    public static function unknown(): self
    {
        return new self(
            ip: null,
            country: null,
            city: null,
        );
    }

    /**
     * Reconstitue une localisation depuis le stockage.
     *
     * @internal Pour usage Infrastructure uniquement
     */
    public static function reconstitute(
        ?string $ip,
        ?string $country,
        ?string $city,
    ): self {
        return new self($ip, $country, $city);
    }

    /**
     * Formate la localisation pour affichage.
     *
     * @return string "France, Paris" ou "France" ou "Inconnu"
     */
    public function format(): string
    {
        if ($this->country !== null && $this->city !== null) {
            return "{$this->country}, {$this->city}";
        }

        if ($this->country !== null) {
            return $this->country;
        }

        return 'Inconnu';
    }
}
