kulakpos_web/vendor/knuckleswtf/scribe/camel/Extraction/ExtractedEndpointData.php

<?php

namespace Knuckles\Camel\Extraction;

use Illuminate\Http\UploadedFile;
use Illuminate\Routing\Route;
use Knuckles\Camel\BaseDTO;
use Knuckles\Scribe\Extracting\Shared\UrlParamsNormalizer;
use Knuckles\Scribe\Tools\Globals;
use Knuckles\Scribe\Tools\Utils as u;

class ExtractedEndpointData extends BaseDTO
{
    /**
     * @var array<string>
     */
    public array $httpMethods;

    public string $uri;

    public Metadata $metadata;

    /**
     * @var array<string,string>
     */
    public array $headers = [];

    /**
     * @var array<string,Parameter>
     */
    public array $urlParameters = [];

    /**
     * @var array<string,mixed>
     */
    public array $cleanUrlParameters = [];

    /**
     * @var array<string,Parameter>
     */
    public array $queryParameters = [];

    /**
     * @var array<string,mixed>
     */
    public array $cleanQueryParameters = [];

    /**
     * @var array<string,Parameter>
     */
    public array $bodyParameters = [];

    /**
     * @var array<string,mixed>
     */
    public array $cleanBodyParameters = [];

    /**
     * @var array<string,array|UploadedFile>
     */
    public array $fileParameters = [];

    public ResponseCollection $responses;

    /**
     * @var array<string,ResponseField>
     */
    public array $responseFields = [];

    /**
     * Authentication info for this endpoint. In the form [{where}, {name}, {sample}]
     * Example: ["queryParameters", "api_key", "njiuyiw97865rfyvgfvb1"].
     */
    public array $auth = [];

    public ?\ReflectionClass $controller;

    public ?\ReflectionFunctionAbstract $method;

    public ?Route $route;

    public function __construct(array $parameters = [])
    {
        $parameters['metadata'] ??= new Metadata([]);
        $parameters['responses'] ??= new ResponseCollection([]);

        parent::__construct($parameters);

        $defaultNormalizer = fn () => UrlParamsNormalizer::normalizeParameterNamesInRouteUri($this->route, $this->method);
        $this->uri = match (is_callable(Globals::$__normalizeEndpointUrlUsing)) {
            true => call_user_func_array(
                Globals::$__normalizeEndpointUrlUsing,
                [$this->route->uri, $this->route, $this->method, $this->controller, $defaultNormalizer]
            ),
            default => $defaultNormalizer(),
        };
    }

    /**
     * @param  array  $extras  Only used for quick overrides in tests
     *
     * @throws \ReflectionException
     */
    public static function fromRoute(Route $route, array $extras = []): self
    {
        $httpMethods = self::getMethods($route);
        $uri = $route->uri();

        [$controllerName, $methodName] = u::getRouteClassAndMethodNames($route);
        $controller = new \ReflectionClass($controllerName);
        $method = u::getReflectedRouteMethod([$controllerName, $methodName]);

        $data = compact('httpMethods', 'uri', 'controller', 'method', 'route');
        $data = array_merge($data, $extras);

        return new self($data);
    }

    /**
     * @return array<string>
     */
    public static function getMethods(Route $route): array
    {
        $methods = $route->methods();

        // Laravel adds an automatic "HEAD" endpoint for each GET request, so we'll strip that out,
        // but not if there's only one method (means it was intentional)
        if (count($methods) === 1) {
            return $methods;
        }

        return array_diff($methods, ['HEAD']);
    }

    public function name()
    {
        return sprintf("[%s] {$this->route->uri}.", implode(',', $this->route->methods));
    }

    public function endpointId()
    {
        return $this->httpMethods[0].str_replace(['/', '?', '{', '}', ':', '\\', '+', '|'], '-', $this->uri);
    }

    /**
     * Prepare the endpoint data for serialising.
     */
    public function forSerialisation()
    {
        $copyArray = $this->except(
            // Get rid of all duplicate data
            'cleanQueryParameters',
            'cleanUrlParameters',
            'fileParameters',
            'cleanBodyParameters',
            // and objects used only in extraction
            'route',
            'controller',
            'method',
            'auth',
        );
        // Remove these, since they're on the parent group object
        if (isset($copyArray['metadata']) && $copyArray['metadata'] instanceof Metadata) {
            $copyArray['metadata'] = $copyArray['metadata']->except('groupName', 'groupDescription');
        }

        return $copyArray;
    }
}