Allow accessing the transformer

[Mohammad-Alavi]

Summary

Addded a public method to be able to access the transformer.

Reasoning

TL;DR

Using my own extended Fractal facade, this allows me to call the ok method both with and without setting a transformer.

• Fractal::create($this->user, UserTransformer::class)->ok();
• Fractal::ok();

Otherwise, I get a NoTransformerSpecified exception.

Yes, I can just create a 200 response using a thousand other ways but I woud like to be consistence and use the Fractal facade to generate all of my responses.

Explanation

Background

I am using your awesome larave-fractal package which has the Spatie\Fractal\Fractal that extends the Spatie\Fractalistic\Fractal.

Glossary

When I say	I mean
LaravelFractal	Spatie\Fractal\Fractal
FractalisticFractal	Spatie\Fractalistic\Fractal
MyFractal	My class that extends Spatie\Fractal\Fractal

Why

LaravelFractal class has a convenient respond method that helps with genarating responses.
In my project I have added some other convenient methods to MyFractal. For example,

class MyFractal extends LaravelFractal
{
    public function ok(): JsonResponse
    {
        // notice here, I am using the proposed method
        if (is_null($this->getTransformer())) {
            // `empty` is just another convenient method of mine.
            // It returns a transformer that returns an empty array, [], never mind it!
            $this->transformWith(Transformer::empty());
        }
    
        return $this->respond(200); // I am using the `LaravelFractal::respond`
    }
}

Using my own facade, this allows me to call the ok method both with and without setting a transformer.

• MyFractal::create($this->user, UserTransformer::class)->ok();
• MyFractal::ok();

Otherwise, I get a NoTransformerSpecified exception.
This happens because MyFractal::ok method uses the LaravelFractal::respond method underneath. And in turn,
LaravelFractal::respond method calls the FractalisticFractal::createData method and this method throws an exception if it is called without a transfromer. (which is the case with MyFractal::ok mthod)

    public function createData()
    {
        if (is_null($this->transformer)) {
            throw new NoTransformerSpecified();
        }
        // ...
    }

[Mohammad-Alavi]

Just update the outdated docblock, because the transformer can be null already.

[Nielsvanpach]

Thanks!