<?php

declare(strict_types=1);

namespace MonetaPhpShop\receipt;

use InvalidArgumentException;
use MonetaPhpShop\Money;
use MonetaPhpShop\protocol\JsonNumber;

/**
 * Позиция чека: `inventPositions` (`kassaspecification.pdf`) и элемент `items` JSON Check URL
 * (`cmsspecification.pdf`). Количество — до трёх знаков после точки ({@see Quantity});
 * единица измерения (`measure`) — из перечня кассы ({@see Measure}).
 * Признак предмета расчёта (`po` / `paymentObject`) — явно: у товаров из настройки, у доставки
 * `service` (без него касса ставит `commodity` всем, и «Доставка» уходила бы товаром). Способ
 * расчёта (`pm` / `paymentMethod`) — явно: `kassaspecification.pdf` требует поле.
 * Значения — настройки «Признак предмета расчёта» ({@see PaymentObject}) и
 * «Признак способа расчёта» ({@see PaymentMethod}). Оба признака — только в чеке для кассы:
 * без фискализации `INVENTORY` их не несёт ({@see self::toInventoryPosition()}).
 */
final class ReceiptItem
{
    public const NAME_MAX_LENGTH = 128;

    /** Потолок кассы для цены и для `price * quantity`. */
    public const PRICE_MAX = '42949672.95';

    /** @var string */
    private $name;

    /** @var Money */
    private $price;

    /** @var Quantity */
    private $quantity;

    /** @var string */
    private $measure;

    /** @var Vat */
    private $vat;

    /** @var PaymentObject */
    private $paymentObject;

    /** @var PaymentMethod */
    private $paymentMethod;

    /**
     * @param string             $name в UTF-8; пустое после чистки касса не примет — запасное название
     *     подставляет {@see ReceiptBuilder} (литералы модуля после сборки в cp1251)
     * @param PaymentObject|null $paymentObject null — товар
     * @param PaymentMethod|null $paymentMethod null — полный расчёт
     * @param string             $measure код единицы измерения кассы ({@see Measure})
     */
    public function __construct(
        string $name,
        Money $price,
        Quantity $quantity,
        Vat $vat,
        ?PaymentObject $paymentObject = null,
        ?PaymentMethod $paymentMethod = null,
        string $measure = Measure::UNIT
    ) {
        $this->name = ReceiptText::clean($name, self::NAME_MAX_LENGTH);
        if ($this->name === '') {
            throw new InvalidArgumentException('Пустое название позиции чека.');
        }
        $this->price = $price;
        $this->quantity = $quantity;
        $this->measure = $measure;
        $this->vat = $vat;
        $this->paymentObject = $paymentObject ?? PaymentObject::commodity();
        $this->paymentMethod = $paymentMethod ?? PaymentMethod::fullPayment();

        $max = Money::fromDecimal(self::PRICE_MAX)->toMinorUnits();
        if (($price->toMinorUnits() > $max) || ($this->total()->toMinorUnits() > $max)) {
            throw new InvalidArgumentException('Сумма позиции чека выше потолка кассы.');
        }
    }

    public function getName(): string
    {
        return $this->name;
    }

    public function getPrice(): Money
    {
        return $this->price;
    }

    public function getQuantity(): Quantity
    {
        return $this->quantity;
    }

    public function getMeasure(): string
    {
        return $this->measure;
    }

    public function getVat(): Vat
    {
        return $this->vat;
    }

    public function getPaymentObject(): PaymentObject
    {
        return $this->paymentObject;
    }

    public function getPaymentMethod(): PaymentMethod
    {
        return $this->paymentMethod;
    }

    /**
     * Сумма позиции так, как её посчитает касса: цена x количество до копейки.
     */
    public function total(): Money
    {
        return $this->quantity->totalOf($this->price);
    }

    /**
     * Элемент `items` JSON-ответа Check URL; цена — меткой {@see JsonNumber}.
     *
     * @return array<string, mixed>
     */
    public function toCheckItem(): array
    {
        return [
            'name' => $this->name,
            'price' => JsonNumber::placeholder($this->price),
            'quantity' => JsonNumber::quantity($this->quantity),
            'measure' => $this->measure,
            'paymentMethod' => $this->paymentMethod->getValue(),
            'paymentObject' => $this->paymentObject->getValue(),
            'vat' => $this->vat->getCode(),
        ];
    }

    /**
     * Объект `inventPositions` для атрибута `INVENTORY`. Без фискализации — только то, что
     * MONETA.RU сохранит в операции: без `vatTag`, `pm`, `po`.
     *
     * @return array<string, mixed>
     */
    public function toInventoryPosition(bool $fiscalization = true): array
    {
        $position = [
            'name' => $this->name,
            'price' => JsonNumber::placeholder($this->price),
            'quantity' => JsonNumber::quantity($this->quantity),
            'measure' => $this->measure,
        ];
        if (!$fiscalization) {
            return $position;
        }

        return $position + [
            'vatTag' => $this->vat->getTag(),
            'pm' => $this->paymentMethod->getValue(),
            'po' => $this->paymentObject->getValue(),
        ];
    }
}