<?php
/**
 * 将 GeoIP / API 返回的国家值统一为 ISO 3166-1 alpha-2（两位大写国家码）。
 */
class CountryCodeNormalizer
{
    /** @var array{names:array<string,string>,alpha3:array<string,string>}|null */
    private static $maps = null;

    /**
     * @param mixed $value ISO2、ISO3 或英文国名
     * @return string|null 两位国家码；无法识别时 null
     */
    public static function toAlpha2($value)
    {
        $value = trim((string) $value);
        if ($value === '') {
            return null;
        }

        $upper = strtoupper($value);
        if (preg_match('/^[A-Z]{2}$/', $upper)) {
            return $upper;
        }

        $maps = self::maps();
        if (preg_match('/^[A-Z]{3}$/', $upper) && isset($maps['alpha3'][$upper])) {
            return $maps['alpha3'][$upper];
        }

        $nameKey = self::nameKey($value);
        if (isset($maps['names'][$nameKey])) {
            return $maps['names'][$nameKey];
        }

        return null;
    }

    /**
     * @return array{names:array<string,string>,alpha3:array<string,string>}
     */
    private static function maps()
    {
        if (self::$maps === null) {
            $file = __DIR__ . '/iso3166_maps.php';
            $data = is_file($file) ? require $file : ['names' => [], 'alpha3' => []];
            self::$maps = [
                'names'  => isset($data['names']) && is_array($data['names']) ? $data['names'] : [],
                'alpha3' => isset($data['alpha3']) && is_array($data['alpha3']) ? $data['alpha3'] : [],
            ];
        }
        return self::$maps;
    }

    private static function nameKey($name)
    {
        $name = preg_replace('/\s+/u', ' ', trim((string) $name));
        return strtoupper($name);
    }
}