yookassa-sdk-php/tests/Common/AbstractRequestBuilderTest.php

<?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 Tests\YooKassa\Common;

use Exception;
use InvalidArgumentException;
use PHPUnit\Framework\TestCase;
use YooKassa\Common\AbstractRequest;
use YooKassa\Common\AbstractRequestBuilder;
use YooKassa\Common\Exceptions\InvalidRequestException;

/**
 * @internal
 */
class AbstractRequestBuilderTest extends TestCase
{
    public function testBuild(): void
    {
        $builder = new TestAbstractRequestBuilder();

        try {
            $builder->build([]);
        } catch (InvalidRequestException $e) {
            $request = $builder->build([
                'isValid' => true,
            ]);
            self::assertTrue($request->isValid());

            $mess = 'test message';

            try {
                $builder->build([
                    'throwException' => new Exception($mess),
                ]);
            } catch (Exception $e) {
                self::assertEquals($mess, $e->getPrevious()->getMessage());

                return;
            }
            self::fail('Exception not thrown in setThrowException method');

            return;
        }
        self::fail('Exception not thrown in build method');
    }

    public function testSetOptions(): void
    {
        $builder = new TestAbstractRequestBuilder();

        $builder->setOptions([]);

        try {
            $builder->build();
        } catch (InvalidRequestException $e) {
            $builder->setOptions([
                'is_valid' => true,
            ]);
            self::assertTrue($builder->build()->isValid());

            try {
                $builder->setOptions('test');
            } catch (Exception $e) {
                self::assertInstanceOf(InvalidArgumentException::class, $e);

                return;
            }
            self::fail('Exception not thrown in setOptions method');
        }
        self::fail('Exception not thrown in build method');
    }
}

class TestAbstractRequestBuilder extends AbstractRequestBuilder
{
    public function setIsValid($value)
    {
        $this->currentObject->setIsValid($value);

        return $this;
    }

    /**
     * @throws Exception
     */
    public function setThrowException(Exception $e): TestAbstractRequestBuilder
    {
        $this->currentObject->setThrowException($e);

        return $this;
    }

    /**
     * Инициализирует пустой запрос
     *
     * @return TestAbstractRequestClass Инстанс запроса, который будем собирать
     */
    protected function initCurrentObject(): TestAbstractRequestClass
    {
        return new TestAbstractRequestClass();
    }
}

class TestAbstractRequestClass extends AbstractRequest
{
    private bool $valid = false;

    private ?Exception $exception = null;

    /**
     * @throws Exception
     */
    public function setThrowException(Exception $e): void
    {
        $this->exception = $e;
    }

    public function setIsValid(bool $value): void
    {
        $this->valid = $value;
    }

    public function isValid(): bool
    {
        return $this->valid;
    }

    /**
     * Валидирует текущий запрос, проверяет все ли нужные свойства установлены.
     *
     * @return bool True если запрос валиден, false если нет
     *
     * @throws Exception
     */
    public function validate(): bool
    {
        if (null !== $this->exception) {
            $this->setValidationError($this->exception->getMessage());

            throw $this->exception;
        }

        return $this->valid;
    }
}