feat: add a hook for entity to resource transformation

Author: mrossard

tests/Behat/DoctrineContext.php

@@ -97,6 +97,7 @@
 use ApiPlatform\Tests\Fixtures\TestBundle\Document\SoMany as SoManyDocument;
 use ApiPlatform\Tests\Fixtures\TestBundle\Document\Taxon as TaxonDocument;
 use ApiPlatform\Tests\Fixtures\TestBundle\Document\ThirdLevel as ThirdLevelDocument;
+use ApiPlatform\Tests\Fixtures\TestBundle\Document\TransformedDummyDocument;
 use ApiPlatform\Tests\Fixtures\TestBundle\Document\UrlEncodedId as UrlEncodedIdDocument;
 use ApiPlatform\Tests\Fixtures\TestBundle\Document\User as UserDocument;
 use ApiPlatform\Tests\Fixtures\TestBundle\Document\VideoGame as VideoGameDocument;
@@ -2714,4 +2715,9 @@ private function buildLinkHandledDummy(string $slug): LinkHandledDummy|LinkHandl
     {
         return $this->isOrm() ? new LinkHandledDummy($slug) : new LinkHandledDummyDocument($slug);
     }
+
+    private function buildTransformedDummy(\DateTimeImmutable $dateTime): TransformedDummyEntity|TransformedDummyDocument
+    {
+        return $this->isOrm() ? new TransformedDummyEntity($dateTime) : new TransformedDummyDocument($dateTime);
+    }
 }

tests/Fixtures/TestBundle/Document/TransformedDummyDocument.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace ApiPlatform\Tests\Fixtures\TestBundle\Document;
+
+use Doctrine\DBAL\Types\Types;
+use Doctrine\ODM\MongoDB\Mapping\Annotations as ODM;
+
+class TransformedDummyDocument
+{
+
+    #[ODM\Id(type: 'int', strategy: 'INCREMENT')]
+    private ?int $id = null;
+
+    #[ODM\Field(type: Types::DATETIME_IMMUTABLE)]
+    private \DateTimeInterface $date;
+
+    public function __construct(\DateTimeInterface $date = null)
+    {
+        $this->setDate($date ?? new \DateTimeImmutable());
+    }
+
+    public function getDate(): \DateTimeInterface
+    {
+        return $this->date;
+    }
+
+    public function setDate(\DateTimeInterface $date): void
+    {
+        $this->date = $date;
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+}