feat: allow object to define how they are mapped to array (#532)

Author: Jeroen-G

src/Tempest/Mapper/src/Mappers/ObjectToArrayMapper.php

@@ -4,6 +4,7 @@
 
 namespace Tempest\Mapper\Mappers;
 
+use JsonSerializable;
 use Tempest\Mapper\Mapper;
 use Tempest\Mapper\MapTo;
 
@@ -16,6 +17,10 @@ public function canMap(mixed $from, mixed $to): bool
 
     public function map(mixed $from, mixed $to): array
     {
+        if ($from instanceof JsonSerializable) {
+            return $from->jsonSerialize();
+        }
+
         return (array) $from;
     }
 }

tests/Integration/Mapper/Fixtures/ObjectWithJsonSerialize.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Tempest\Integration\Mapper\Fixtures;
+
+use JsonSerializable;
+use Tempest\Mapper\Strict;
+
+#[Strict]
+final class ObjectWithJsonSerialize implements JsonSerializable
+{
+    public function __construct(
+        public string $a,
+        public string $b,
+    ) {
+    }
+
+    public function jsonSerialize(): array
+    {
+        return [
+            'c' => $this->a,
+            'd' => $this->b,
+        ];
+    }
+}

tests/Integration/Mapper/Mappers/ObjectToArrayMapperTestCase.php

@@ -8,6 +8,7 @@
 use Tempest\Mapper\MapTo;
 use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectA;
+use Tests\Tempest\Integration\Mapper\Fixtures\ObjectWithJsonSerialize;
 
 /**
  * @internal
@@ -20,4 +21,11 @@ public function test_object_to_array(): void
 
         $this->assertSame(['a' => 'a', 'b' => 'b'], $array);
     }
+
+    public function test_custom_to_array(): void
+    {
+        $array = map(new ObjectWithJsonSerialize('a', 'b'))->to(MapTo::ARRAY);
+
+        $this->assertSame(['c' => 'a', 'd' => 'b'], $array);
+    }
 }