feat: add laravel access response transformer

Author: maartenpaauw

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to `laravel-specification-pattern` will be documented in this file.
 
+## [v2.8.0] - 2024-11-21
+
+### Added
+
+- Transformer to transform specification into Laravel authorization access responses.
+
 ## [v2.7.0] - 2024-11-20
 
 ### Added

src/Laravel/AccessResponseTransformer.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Maartenpaauw\Specifications\Laravel;
+
+use Illuminate\Auth\Access\Response;
+use Maartenpaauw\Specifications\DissatisfiedSpecification;
+use Maartenpaauw\Specifications\Specification;
+
+/**
+ * @template TCandidate
+ */
+final class AccessResponseTransformer
+{
+    /**
+     * @param Specification<TCandidate> $specification
+     * @param TCandidate $candidate
+     */
+    public function transform(Specification $specification, mixed $candidate): Response
+    {
+        try {
+            $satisfied = $specification->isSatisfiedBy($candidate);
+        } catch (DissatisfiedSpecification $e) {
+            return Response::deny($e->getMessage(), $e->getCode());
+        }
+
+        return $satisfied ? Response::allow() : Response::deny();
+    }
+}

tests/Laravel/AccessResponseTransformerTest.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Maartenpaauw\Specifications\Tests\Laravel;
+
+use Maartenpaauw\Specifications\Laravel\AccessResponseTransformer;
+use Maartenpaauw\Specifications\Tests\TestCase;
+use Maartenpaauw\Specifications\VerboseSpecification;
+use Workbench\App\NegativeSpecification;
+use Workbench\App\PositiveSpecification;
+
+/**
+ * @internal
+ *
+ * @small
+ */
+final class AccessResponseTransformerTest extends TestCase
+{
+    public function test_transform(): void
+    {
+        // Arrange
+        $accessResponseTransformer = new AccessResponseTransformer();
+
+        // Act
+        $allowed = $accessResponseTransformer->transform(new PositiveSpecification(), null);
+        $denied = $accessResponseTransformer->transform(new NegativeSpecification(), null);
+        $verbose = $accessResponseTransformer->transform(
+            new VerboseSpecification(new NegativeSpecification(), 'This is a message.', 10),
+            null,
+        );
+
+        // Assert
+        $this->assertTrue($allowed->allowed());
+        $this->assertNull($allowed->message());
+        $this->assertNull($allowed->code());
+
+        $this->assertTrue($denied->denied());
+        $this->assertNull($denied->message());
+        $this->assertNull($denied->code());
+
+        $this->assertTrue($verbose->denied());
+        $this->assertIsString($verbose->message());
+        $this->assertNotEmpty($verbose->message());
+        $this->assertSame('This is a message.', $verbose->message());
+        $this->assertIsInt($verbose->code());
+        $this->assertSame(10, $verbose->code());
+    }
+}