APIResourceManager.php

<?php

namespace Juampi92\APIResources;

use Exception;
use Illuminate\Contracts\Config\Repository;
use Illuminate\Http\Resources\Json\JsonResource;
use Illuminate\Http\Resources\Json\ResourceCollection;
use Juampi92\APIResources\Resolvers\ClassnameResolverFactory;
use Juampi92\APIResources\Support\Version;

class APIResourceManager
{
    private Repository $config;

    private ClassnameResolverFactory $classnameResolverFactory;

    private ?APIResourceVersion $version = null;

    public function __construct(Repository $config, ClassnameResolverFactory $classnameResolverFactory)
    {
        $this->config = $config;
        $this->classnameResolverFactory = $classnameResolverFactory;
    }

    private function getResourceVersion(): APIResourceVersion
    {
        if (! $this->version) {
            throw new Exception('APIResource not initialised. Please use APIResource::setVersion($version) to specify the current version');
        }

        return $this->version;
    }

    /**
     * Returns the name of the versioned route.
     *
     * @param string $route
     * @return string
     */
    public function getRouteName(string $route)
    {
        return $this->getResourceVersion()->getRouteName($route);
    }

    /**
     * Returns the versioned url.
     *
     * @param string $name
     * @param mixed $parameters
     */
    public function getRoute($name, $parameters = [], bool $absolute = true): string
    {
        return route($this->getRouteName((string) $name), $parameters, $absolute);
    }

    /**
     * Sets the current API version.
     *
     * @param string $current
     * @param string $apiName = null
     *
     * @return $this
     */
    public function setVersion(string $current, ?string $apiName = null)
    {
        $config = new Config($this->config, $apiName);
        $resolver = $this->classnameResolverFactory->make($config);

        $this->version = new APIResourceVersion($config, $current, $resolver);

        return $this;
    }

    /**
     * Gets the current API version.
     *
     * @return string
     */
    public function getVersion()
    {
        return $this->getResourceVersion()->getVersion();
    }

    public function getLatestVersion(): string
    {
        return $this->getResourceVersion()->getLatestVersion();
    }

    /**
     * Checks if the given version is the latest.
     *
     * @param string $current
     *
     * @return bool
     */
    public function isLatest(string $current = null): bool
    {
        if (is_null($current)) {
            $current = $this->getResourceVersion()->getVersion();
        }

        return $this->getResourceVersion()->getLatestVersion() === $current;
    }

    /**
     * Smart builds the classname using the correct version.
     * If it fails with the current version, it falls back to
     * the latest version. If it still fails, throw exception.
     *
     * @param string $classname
     *
     * @return APIResource
     * @throws Exceptions\ResourceNotFoundException
     */
    public function resolve(string $classname): APIResource
    {
        return new APIResource(
            $this->resolveClassname($classname)
        );
    }

    /**
     * @returns class-string<JsonResource>
     */
    public function resolveClassname(string $classname): string
    {
        return $this->getResourceVersion()->resolveClassname($classname);
    }

    /**
     * @param string $classname
     * @param array $args
     *
     * @return JsonResource
     */
    public function make($classname, ...$args)
    {
        $resource = $this->resolve($classname);

        return $resource->make(...$args);
    }

    /**
     * @param string $classname
     * @param array ...$args
     *
     * @return ResourceCollection
     */
    public function collection($classname, ...$args)
    {
        $resource = $this->resolve($classname);

        return $resource->collection(...$args);
    }
}