Leuchtfeuer/typo3-secure-downloads

<?php

declare(strict_types=1);

/*
 * This file is part of the "Secure Downloads" Extension for TYPO3 CMS.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * (c) Dev <dev@Leuchtfeuer.com>, Leuchtfeuer Digital Marketing
 */

namespace Leuchtfeuer\SecureDownloads\Registry;

use Leuchtfeuer\SecureDownloads\Domain\Transfer\Token\AbstractToken;
use Leuchtfeuer\SecureDownloads\Exception\ClassNotFoundException;
use Leuchtfeuer\SecureDownloads\Exception\InvalidClassException;
use TYPO3\CMS\Core\Utility\GeneralUtility;

class TokenRegistry extends AbstractRegistry
{
    /**
     * @var array<string, mixed>
     */
    private static array $tokenList = [];

    /**
     * @param string $identifier        An unique identifier for the object
     * @param string $className         The class name of the object
     * @param int    $priority          The priority of the registered object
     * @param bool   $overwriteExisting Whether an existing entry should be overwritten or not
     *
     * @throws ClassNotFoundException
     * @throws InvalidClassException
     */
    public static function register(string $identifier, string $className, int $priority = 0, bool $overwriteExisting = false): void
    {
        if (array_key_exists($identifier, self::$tokenList) && $overwriteExisting === false) {
            // Do nothing. Maybe log this in future.
            return;
        }

        self::$tokenList[$identifier] = [
            'class' => self::getTokenFromClassName($className),
            'priority' => $priority,
        ];

        self::sortByPriority(self::$tokenList);
    }

    /**
     * @return AbstractToken Get the highest prioritized token
     * @throws InvalidClassException
     */
    public static function getToken(): AbstractToken
    {
        $firstEntry = reset(self::$tokenList);
        if (is_array($firstEntry)) {
            return $firstEntry['class'];
        }
        throw new InvalidClassException();
    }

    /**
     * Instantiates the token object from its name.
     *
     * @param string $className The class name of the token
     *
     * @return AbstractToken The actual token object
     *
     * @throws ClassNotFoundException
     * @throws InvalidClassException
     */
    private static function getTokenFromClassName(string $className): AbstractToken
    {
        if (!class_exists($className)) {
            throw new ClassNotFoundException(
                sprintf('Class "%s" not found.', $className),
                1588840845
            );
        }

        $token = GeneralUtility::makeInstance($className);

        if (!$token instanceof AbstractToken) {
            throw new InvalidClassException(
                sprintf('Class "%s" must extend "%s"', $className, AbstractToken::class),
                1588840850
            );
        }

        return $token;
    }
}