<?php

declare(strict_types=1);

namespace App\Services;

use libphonenumber\NumberParseException;
use libphonenumber\PhoneNumberFormat;
use libphonenumber\PhoneNumberUtil;

/**
 * Parses international and national phone input and normalizes to E.164 for storage (includes leading +).
 */
final class PhoneNumberNormalizer
{
    public function __construct(
        private readonly string $defaultRegion
    ) {}

    /**
     * Returns E.164 (e.g. +31612345678) or null if empty/invalid.
     */
    public function normalizeToE164(?string $input): ?string
    {
        if ($input === null) {
            return null;
        }

        $trimmed = trim($input);
        if ($trimmed === '') {
            return null;
        }

        $util = PhoneNumberUtil::getInstance();

        try {
            $number = $util->parse($trimmed, $this->defaultRegion);
        } catch (NumberParseException) {
            return null;
        }

        if (! $util->isValidNumber($number)) {
            return null;
        }

        return $util->format($number, PhoneNumberFormat::E164);
    }
}