<?php

/*
 * The MIT License
 *
 * Copyright (c) 2026 "YooMoney", NBСO LLC
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

namespace YooKassa\Model;

use YooKassa\Common\AbstractObject;
use YooKassa\Common\Exceptions\EmptyPropertyValueException;
use YooKassa\Common\Exceptions\InvalidPropertyValueException;
use YooKassa\Common\Exceptions\InvalidPropertyValueTypeException;
use YooKassa\Helpers\TypeCast;

/**
 * Класс описывающий авиабилет
 *
 * @package YooKassa
 *
 * @property string $bookingReference Номер бронирования. Обязателен на этапе создания платежа
 * @property string $booking_reference Номер бронирования. Обязателен на этапе создания платежа
 * @property string $ticketNumber Уникальный номер билета. Обязателен на этапе подтверждения платежа
 * @property string $ticket_number Уникальный номер билета. Обязателен на этапе подтверждения платежа
 * @property PassengerInterface[] $passengers Список пассажиров
 * @property Leg[] $legs Список маршрутов
 */
class Airline extends AbstractObject implements AirlineInterface
{
    /**
     * @var string Номер бронирования. Обязателен на этапе создания платежа
     */
    private $_bookingReference;

    /**
     * @var string Уникальный номер билета. Обязателен на этапе подтверждения платежа
     */
    private $_ticketNumber;

    /**
     * @var PassengerInterface[] Список пассажиров
     */
    private $_passengers;

    /**
     * @var LegInterface[] Список маршрутов
     */
    private $_legs;

    /**
     * @inheritdoc
     */
    public function getBookingReference()
    {
        return $this->_bookingReference;
    }

    /**
     * Устанавливает номер бронирования. Обязателен на этапе создания платежа.
     * @param string $value Номер бронирования
     */
    public function setBookingReference($value)
    {
        if ($value === null || $value === '') {
            $this->_bookingReference = null;
        } elseif (!TypeCast::canCastToString($value)) {
            throw new InvalidPropertyValueTypeException(
                'Invalid booking reference value type',
                0,
                'airline.booking_reference'
            );
        } elseif (mb_strlen((string)$value, 'utf-8') > 20) {
            throw new InvalidPropertyValueException(
                'Invalid booking reference value: "' . $value . '"',
                0,
                'airline.booking_reference'
            );
        } else {
            $this->_bookingReference = (string)$value;
        }
    }

    /**
     * @inheritdoc
     */
    public function getTicketNumber()
    {
        return $this->_ticketNumber;
    }

    /**
     * Устанавливает уникальный номер билета. Обязателен на этапе подтверждения платежа
     * @param string $value Уникальный номер билета
     */
    public function setTicketNumber($value)
    {
        if ($value === null || $value === '') {
            $this->_ticketNumber = null;
        } elseif (!TypeCast::canCastToString($value)) {
            throw new InvalidPropertyValueTypeException(
                'Invalid ticket number value type',
                0,
                'airline.ticket_number'
            );
        } elseif (!preg_match('/^[0-9]{1,150}$/', (string)$value)) {
            throw new InvalidPropertyValueException(
                'Invalid ticket_number value: "' . $value . '"',
                0,
                'airline.ticket_number'
            );
        } else {
            $this->_ticketNumber = (string)$value;
        }
    }

    /**
     * @inheritdoc
     */
    public function getPassengers()
    {
        return $this->_passengers;
    }

    /**
     * Устанавливает список объектов-контейнеров с данными пассажиров
     * @param array|PassengerInterface[] $value Список объектов-контейнеров с данными пассажиров
     */
    public function setPassengers($value)
    {
        if ($value === null || $value === '') {
            throw new EmptyPropertyValueException('Empty passengers value in airline', 0, 'airline.passengers');
        }
        if (!is_array($value) && !($value instanceof \Traversable)) {
            throw new InvalidPropertyValueTypeException(
                'Invalid passengers value type in airline',
                0,
                'airline.passengers',
                $value
            );
        }
        $this->_passengers = array();
        foreach ($value as $key => $val) {
            try {
                $this->addPassenger($val);
            } catch (InvalidPropertyValueTypeException $exception) {
                throw new InvalidPropertyValueTypeException(
                    'Invalid passenger value type in airline',
                    0,
                    'airline.passengers[' . $key . ']',
                    $val
                );
            }
        }
    }

    /**
     * Добавляет объект-контейнер с данными пассажиров
     * @param array|PassengerInterface $value Объект-контейнер с данными пассажиров
     */
    public function addPassenger($value)
    {
        if ($value instanceof PassengerInterface) {
            $this->_passengers[] = $value;
        } elseif (is_array($value)) {
            $passenger = new Passenger();
            $passenger->fromArray($value);
            $this->_passengers[] = $passenger;
        } else {
            throw new InvalidPropertyValueTypeException(
                'Invalid passenger value type in airline',
                0
            );
        }
    }

    /**
     * @inheritdoc
     */
    public function getLegs()
    {
        return $this->_legs;
    }

    /**
     * Устанавливает список объектов-контейнеров с данными о маршруте
     * @param array|LegInterface[] $value Список объектов-контейнеров с данными о маршруте
     */
    public function setLegs($value)
    {
        if ($value === null || $value === '') {
            throw new EmptyPropertyValueException('Empty legs value in airline', 0, 'airline.passengers');
        }
        if (!is_array($value) && !($value instanceof \Traversable)) {
            throw new InvalidPropertyValueTypeException(
                'Invalid legs value type in airline',
                0,
                'airline.legs',
                $value
            );
        }
        $this->_legs = array();
        foreach ($value as $key => $val) {
            try {
                $this->addLeg($val);
            } catch (InvalidPropertyValueTypeException $exception) {
                throw new InvalidPropertyValueTypeException(
                    'Invalid legs value type in airline',
                    0,
                    'airline.legs[' . $key . ']',
                    $val
                );
            }
        }
    }

    /**
     * Добавляет объект-контейнер с данными о маршруте
     * @param array|LegInterface $value Объект-контейнер с данными о маршруте
     */
    public function addLeg($value)
    {
        if ($value instanceof LegInterface) {
            $this->_legs[] = $value;
        } elseif (is_array($value)) {
            $leg = new Leg();
            $leg->fromArray($value);
            $this->_legs[] = $leg;
        } else {
            throw new InvalidPropertyValueTypeException(
                'Invalid passenger value type in airline',
                0
            );
        }
    }

    /**
     * Првоерка на наличие данных
     * @return bool
     */
    public function notEmpty()
    {
        return $this->_legs || $this->_passengers || $this->_ticketNumber || $this->_bookingReference;
    }

    /**
     * @inheritdoc
     */
    public function fromArray($sourceArray)
    {
        if (is_array($sourceArray['passengers']) && !empty($sourceArray['passengers'])) {
            $sourceArray['passengers'] = array_map(function ($passengerData) {
                if (is_array($passengerData)) {
                    $passenger = new Passenger();
                    $passenger->fromArray($passengerData);

                    return $passenger;
                } elseif ($passengerData instanceof PassengerInterface) {
                    return $passengerData;
                }
            }, $sourceArray['passengers']);
        }

        if (is_array($sourceArray['legs']) && !empty($sourceArray['legs'])) {
            $sourceArray['legs'] = array_map(function ($legData) {
                if (is_array($legData)) {
                    $leg = new Leg();
                    $leg->fromArray($legData);

                    return $leg;
                } elseif ($legData instanceof LegInterface) {
                    return $legData;
                }
            }, $sourceArray['legs']);
        }
        parent::fromArray($sourceArray);
    }
}
