<?php

declare(strict_types=1);

namespace MonetaPhpShop\protocol;

/**
 * Коды `MNT_RESULT_CODE` ответов модуля (`MONETA.Assistant.ru.pdf`, гл. 4–5;
 * `cmsspecification.pdf`, «Параметры ответа»).
 *
 * На Check URL код описывает состояние заказа; на Pay URL сервис считает
 * уведомление доставленным только при 200, при 100/302/402 повторяет его,
 * при 500 прекращает попытки. Value-объект вместо enum — модуль работает на PHP 7.4.
 */
final class ResultCode
{
    /** Ответ содержит сумму заказа — в проверочном запросе `MNT_AMOUNT` не было. */
    public const WITH_AMOUNT = 100;

    /** Заказ оплачен, уведомление доставлено. */
    public const PAID = 200;

    /** Заказ в обработке, точный статус определить нельзя. */
    public const IN_PROGRESS = 302;

    /** Заказ создан и готов к оплате. */
    public const AWAITING_PAYMENT = 402;

    /** Заказ неактуален (отменён, не найден); сервис прекращает повторы. */
    public const REJECTED = 500;

    /**
     * Текст для `MNT_DESCRIPTION` / `description`: без кавычек, `&`, `$`, `#`
     * и слэшей — требование `cmsspecification.pdf` к значениям ответа.
     */
    private const DESCRIPTIONS = [
        self::WITH_AMOUNT => 'Order amount',
        self::PAID => 'Order is paid',
        self::IN_PROGRESS => 'Order is being processed',
        self::AWAITING_PAYMENT => 'Order created, but not paid',
        self::REJECTED => 'Order is not available',
    ];

    /** @var int */
    private $value;

    private function __construct(int $value)
    {
        $this->value = $value;
    }

    public static function fromValue(int $value): self
    {
        if (!array_key_exists($value, self::DESCRIPTIONS)) {
            throw new \InvalidArgumentException('Неизвестный код MNT_RESULT_CODE.');
        }

        return new self($value);
    }

    public static function withAmount(): self
    {
        return new self(self::WITH_AMOUNT);
    }

    public static function paid(): self
    {
        return new self(self::PAID);
    }

    public static function inProgress(): self
    {
        return new self(self::IN_PROGRESS);
    }

    public static function awaitingPayment(): self
    {
        return new self(self::AWAITING_PAYMENT);
    }

    public static function rejected(): self
    {
        return new self(self::REJECTED);
    }

    public function getValue(): int
    {
        return $this->value;
    }

    public function description(): string
    {
        return self::DESCRIPTIONS[$this->value];
    }

    public function equals(self $other): bool
    {
        return ($this->value === $other->value);
    }

    public function __toString(): string
    {
        return (string) $this->value;
    }
}