<?php
/**
 * © Copyright 2013-present Adobe. All rights reserved.
 *
 * This file is licensed under OSL 3.0 or your existing commercial license or subscription
 * agreement with Magento or its Affiliates (the "Agreement).
 *
 * You may obtain a copy of the OSL 3.0 license at http://opensource.org/licenses/osl-3.0.php Open
 * Software License (OSL 3.0) or by contacting engcom@adobe.com for a copy.
 *
 * Subject to your payment of fees and compliance with the terms and conditions of the Agreement,
 * the Agreement supersedes the OSL 3.0 license with respect to this file.
 */
declare(strict_types=1);

namespace Magento\QualityPatches\Test\Integrity\Testsuite;

use Magento\QualityPatches\Info;
use Magento\QualityPatches\Test\Integrity\Lib\Config;
use PHPUnit\Framework\Attributes\DoesNotPerformAssertions;
use PHPUnit\Framework\TestCase;

/**
 * @inheritDoc
 */
class ConfigStructureTest extends TestCase
{
    /**
     * Configuration JSON property.
     *
     * Contains patch filename, type string.
     */
    const PROP_FILE = 'file';

    /**
     * Configuration JSON property.
     *
     * Contains required patch ids, type array.
     */
    const PROP_REQUIRE = 'require';

    /**
     * Configuration JSON property.
     *
     * Contains patch id that current patch replaced with, type string.
     */
    const PROP_REPLACED_WITH = 'replaced-with';

    /**
     * Configuration JSON property.
     *
     * Defines whether patch is deprecated, type boolean.
     */
    const PROP_DEPRECATED = 'deprecated';

    /**
     * Configuration JSON property.
     *
     * Contains specific requirements for a patch.
     */
    const PROP_REQUIREMENTS = 'requirements';

    /**
     * Configuration JSON property.
     *
     * Defines metadata used in SWAT tool for patch recommendations.
     */
    const PROP_METADATA = 'metadata';

    /**
     * @var Config
     */
    private $config;

    /**
     * @var Info
     */
    private $info;

    /**
     * @inheritDoc
     */
    protected function setUp(): void
    {
        $this->info = new Info();
        $this->config = new Config();
    }

    /**
     * Validates patch configuration structure.
     */
    #[DoesNotPerformAssertions]
    public function testConfigStructure()
    {
        try {
            $config = $this->config->get();
        } catch (\InvalidArgumentException $e) {
            $this->fail($e->getMessage());
        }

        $errors = $this->validateConfiguration($config);
        if (!empty($errors)) {
            $this->fail(
                implode(PHP_EOL, $errors)
            );
        }
    }

    /**
     * Validates that patch titles end with a period.
     *
     * @return void
     */
    public function testPatchTitlesEndWithPeriod()
    {
        $config = $this->config->get();
        $errors = [];

        foreach ($config as $patchId => $patchConfig) {
            if (isset($patchConfig['title'])) {
                $title = $patchConfig['title'];
                if (!str_ends_with($title, '.')) {
                    $errors[] = sprintf(
                        "Patch '%s' has a title that does not end with a period: '%s'",
                        $patchId,
                        $title
                    );
                }
            }
        }

        if (!empty($errors)) {
            $this->fail(
                "The following patches have titles that do not end with a period:" . PHP_EOL .
                implode(PHP_EOL, $errors)
            );
        }

        $this->assertTrue(true);
    }

    /**
     * Validates patch configuration.
     *
     * @param array $config
     *
     * @return array
     */
    private function validateConfiguration(array $config): array
    {
        $errors = [];
        foreach ($config as $patchId => $patchGeneralConfig) {
            $patchErrors = [];
            if (isset($patchGeneralConfig[static::PROP_REQUIREMENTS]) &&
                !is_string($patchGeneralConfig[static::PROP_REQUIREMENTS])
            ) {
                $errors[] = sprintf(
                    " - Property '%s' from %s patch configuration has to be a string",
                    static::PROP_REQUIREMENTS,
                    $patchId
                );
            }
            foreach ($patchGeneralConfig['packages'] as $packageConfiguration) {
                $patchErrors = array_merge(
                    $patchErrors,
                    $this->validatePackageConfiguration($packageConfiguration)
                );
            }

            if (isset($patchGeneralConfig[static::PROP_METADATA])) {
                $metadata = $patchGeneralConfig[static::PROP_METADATA];
                if (!isset($metadata['and']) && !isset($metadata['or'])) {
                    $patchErrors[] = sprintf(
                        " - Property '%s' must contain 'and' or 'or' keys in a root.",
                        static::PROP_METADATA
                    );
                } else {
                    $patchErrors = array_merge(
                        $patchErrors,
                        $this->validateMetadata($metadata)
                    );
                }
            }

            if (!empty($patchErrors)) {
                $errors[] = "Patch {$patchId} has an invalid configuration:";
                $errors = array_merge($errors, $patchErrors);
            }
        }

        return $errors;
    }

    /**
     * Validates package configuration.
     *
     * @param array $packageConfiguration
     * @return array
     */
    private function validatePackageConfiguration(array $packageConfiguration): array
    {
        $errors = [];
        foreach ($packageConfiguration as $packageConstraint => $patchInfo) {
            $errors = array_merge(
                $errors,
                $this->validateProperties($patchInfo, $packageConstraint)
            );
        }
        return $errors;
    }

    /**
     * Validates properties.
     *
     * @param array $patchData
     * @param string $packageConstraint
     * @return array
     */
    private function validateProperties(array $patchData, string $packageConstraint): array
    {
        $errors = [];
        $allowedProperties = [
            static::PROP_FILE,
            static::PROP_REQUIRE,
            static::PROP_REPLACED_WITH,
            static::PROP_DEPRECATED,
            static::PROP_REQUIREMENTS,
            static::PROP_METADATA
        ];

        foreach (array_keys($patchData) as $property) {
            if (!in_array($property, $allowedProperties, true)) {
                $errors[] = sprintf(
                    " - Undeclared property '%s' found in '%s'",
                    $property,
                    $packageConstraint
                );
            }
        }

        $errors = array_merge($errors, $this->validateMandatoryProperties($patchData, $packageConstraint));
        $errors = array_merge($errors, $this->validatePropertyTypes($patchData, $packageConstraint));
        $errors = array_merge($errors, $this->validatePackageConstraint($packageConstraint));

        return $errors;
    }

    /**
     * Validates mandatory properties.
     *
     * @param array $patchData
     * @param string $packageConstraint
     * @return array
     */
    private function validateMandatoryProperties(array $patchData, string $packageConstraint): array
    {
        $errors = [];
        if (!isset($patchData[static::PROP_FILE])) {
            $errors[] = sprintf(
                " - Property '%s' is not found in '%s'",
                static::PROP_FILE,
                $packageConstraint
            );
        } elseif (!file_exists($this->info->getPatchesDirectory() . '/' . $patchData[static::PROP_FILE])) {
            $errors[] = sprintf(
                " - File '%s' from '%s' does not exist",
                $this->info->getPatchesDirectory() . '/' . $patchData[static::PROP_FILE],
                $packageConstraint
            );
        }

        return $errors;
    }

    /**
     * Validates property types.
     *
     * @param array $patchData
     * @param string $packageConstraint
     * @return array
     */
    private function validatePropertyTypes(array $patchData, string $packageConstraint): array
    {
        $errors = [];
        if (isset($patchData[static::PROP_REQUIRE]) &&
            !is_array($patchData[static::PROP_REQUIRE])
        ) {
            $errors[] = sprintf(
                " - Property '%s' from '%s' should have an array type",
                static::PROP_REQUIRE,
                $packageConstraint
            );
        }

        if (isset($patchData[static::PROP_REPLACED_WITH]) &&
            !is_string($patchData[static::PROP_REPLACED_WITH])
        ) {
            $errors[] = sprintf(
                " - Property '%s' from '%s' should have a string type",
                static::PROP_REPLACED_WITH,
                $packageConstraint
            );
        }

        if (isset($patchData[static::PROP_DEPRECATED]) &&
            !is_bool($patchData[static::PROP_DEPRECATED])
        ) {
            $errors[] = sprintf(
                " - Property '%s' from '%s' should have a boolean type",
                static::PROP_DEPRECATED,
                $packageConstraint
            );
        }

        return $errors;
    }

    /**
     * Validates package constraint format.
     *
     * @param string $packageConstraint
     * @return array
     */
    private function validatePackageConstraint(string $packageConstraint): array
    {
        $errors = [];
        $singleVersionPattern = '[~^]?\d+\.\d+\.\d+(-p\d+)?';
        $versionRangePattern = ">=?$singleVersionPattern( <=?$singleVersionPattern)*";
        $packageConstraintPattern =
            "/^($singleVersionPattern|$versionRangePattern)( \|\| ($singleVersionPattern|$versionRangePattern))*$/";
        if (!preg_match($packageConstraintPattern, $packageConstraint)) {
            $errors[] = sprintf(
                " - Constraint '%s' doesn't match the expected pattern." . PHP_EOL .
                "   Expected pattern examples:" . PHP_EOL .
                "   - ^2.3.0" . PHP_EOL .
                "   - >=1.1.6" . PHP_EOL .
                "   - ~2.3.6 || >=2.4.0" . PHP_EOL .
                "   - >2.4.0 <2.4.1 || >=2.4.3 <=2.4.3-p2",
                $packageConstraint
            );
        }

        return $errors;
    }

    /**
     * @param array $metadata
     * @return array
     */
    private function validateMetadata(array $metadata): array
    {
        $errors = [];
        foreach ($metadata as $key => $node) {
            if (in_array((string) $key, ['and', 'or'])) {
                $errors = array_merge_recursive($errors, $this->validateMetadata($node));
            } else {
                if (!isset($node['type'])) {
                    $errors[] = sprintf(
                        " - All nodes of '%s' property must contain 'type' key.",
                        static::PROP_METADATA
                    );
                }

                if (!isset($node['path'])) {
                    $errors[] = sprintf(
                        " - All nodes of '%s' property must contain 'path' key.",
                        static::PROP_METADATA
                    );
                }

                if (!isset($node['match'])) {
                    $errors[] = sprintf(
                        " - All nodes of '%s' property must contain 'match' key.",
                        static::PROP_METADATA
                    );
                }
            }
        }

        return $errors;
    }
}