<?php

declare(strict_types=1);

namespace MonetaPhpShop\protocol;

/**
 * Константы протокола MONETA.Assistant (`MONETA.Assistant.ru.pdf`).
 */
final class AssistantProtocol
{
    /** `MNT_COMMAND` проверочного запроса на Check URL; на Pay URL параметра нет. */
    public const COMMAND_CHECK = 'CHECK';

    /** Текстовый отказ на Check/Pay URL: сервис повторит уведомление. */
    public const TEXT_FAIL = 'FAIL';

    /** Единственная валюта модуля (ISO 4217). */
    public const CURRENCY_RUB = 'RUB';

    private function __construct() {}

    /**
     * ISO-код валюты магазина -> `MNT_CURRENCY_CODE`; null — валюта модулем не поддерживается.
     * `RUR` — устаревший код рубля, который ещё встречается в справочниках валют магазинов.
     */
    public static function normalizeCurrency(string $iso): ?string
    {
        $iso = strtoupper(trim($iso));

        return (($iso === self::CURRENCY_RUB) || ($iso === 'RUR')) ? self::CURRENCY_RUB : null;
    }

    /**
     * Значение `MNT_TEST_MODE` для формы и подписи.
     */
    public static function testModeFlag(bool $testMode): string
    {
        return $testMode ? '1' : '0';
    }

    /**
     * Язык витрины PHPShop (`russian`, `russian_utf`, `english`, `english_utf`) ->
     * `moneta.locale` платёжной формы. Монета знает только `ru` и `en`
     * (`MONETA.Assistant.ru.pdf`, параметры запроса): английская витрина — `en`, остальные — `ru`.
     */
    public static function normalizeLocale(string $shopLocale): string
    {
        return strncmp(strtolower(trim($shopLocale)), 'english', 7) === 0 ? 'en' : 'ru';
    }
}