VersionedHelpers.php

<?php

namespace Orchestra\Routing;

use Illuminate\Contracts\Support\Arrayable;
use Illuminate\Support\Collection;
use Illuminate\Support\Fluent;
use Orchestra\Http\Transformer;
use Orchestra\Support\Transformer as BaseTransformer;

trait VersionedHelpers
{
    /**
     * Transform and serialize the instance.
     *
     * @param  \Orchestra\Model\Eloquent|\Illuminate\Support\Collection  $instance
     *
     * @return array
     */
    protected function transform($instance, string $transformer, ?string $serializer = null, array $options = [])
    {
        if (\is_null($serializer)) {
            $serializer = $transformer;
        }

        return $this->serializeWith(
            $this->transformWith($instance, $transformer, $options),
            $serializer,
            $options
        );
    }

    /**
     * Process the instance.
     *
     * @param  \Orchestra\Model\Eloquent|\Illuminate\Support\Collection  $instance
     * @param  mixed  $parameters
     *
     * @return mixed
     */
    protected function processWith($instance, string $name, string $method, ...$parameters)
    {
        $processor = $this->getVersionedResourceClassName('Processors', $name);

        return \app($processor)->{$method}($this, $instance, ...$parameters);
    }

    /**
     * Transform the instance.
     *
     * @param  \Orchestra\Model\Eloquent|\Illuminate\Support\Collection  $instance
     *
     * @return mixed
     */
    protected function transformWith($instance, string $name, array $options = [])
    {
        $transformer = $this->getVersionedResourceClassName('Transformers', $name);

        if (\class_exists($transformer)) {
            $transformer = \resolve($transformer);

            if ($transformer instanceof Transformer) {
                return $transformer->options($options)->handle($instance);
            }

            if ($transformer instanceof BaseTransformer) {
                return $transformer->handle($instance);
            }

            return $instance->transform($transformer);
        }

        return $instance;
    }

    /**
     * Serialize the instance.
     *
     * @param  mixed  $instance
     *
     * @return array
     */
    protected function serializeWith($instance, string $name)
    {
        $serializer = $this->getVersionedResourceClassName('Serializers', $name);

        if (\class_exists($serializer)) {
            return \call_user_func(\app($serializer), $instance);
        }

        if ($instance instanceof Fluent) {
            return $instance->getAttributes();
        } elseif ($instance instanceof Collection) {
            return $instance->all();
        } elseif ($instance instanceof Arrayable) {
            return $instance->toArray();
        }

        return $instance;
    }

    /**
     * Get versioned resource class name.
     */
    abstract public function getVersionedResourceClassName(string $group, string $name): string;
}