From b0c9e2baa030e2dee63d7a33fbf0940bdf3e53ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timo=20B=C3=BChlmann?= <timo.buehlmann@gmail.com>
Date: Sat, 14 Dec 2024 14:39:00 +0100
Subject: [PATCH 1/3] graphql.md: add "MediaObject Normalization" chapter

graphql-normalizer needs to be injected
---
 core/graphql.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/core/graphql.md b/core/graphql.md
index bd02fbf380e..0aa73e7899a 100644
--- a/core/graphql.md
+++ b/core/graphql.md
@@ -2942,6 +2942,26 @@ final class CreateMediaObjectResolver implements MutationResolverInterface
 
 For handling the upload of multiple files, iterate over `$context['args']['input']['files']`.
 
+### Normalization of MediaObjects
+
+In the constructor of the `MediaObjectNormalizer`, the injected Normalizer must be replaced with the one from the
+graphql-namespace:
+
+```PHP
+<?php
+// api/src/Serializer/MediaObjectNormalizer.php
+
+...
+
+public function __construct(
+    #[Autowire(service: 'api_platform.graphql.normalizer.item')]
+    private readonly NormalizerInterface $normalizer,
+    private readonly StorageInterface $storage
+) {}
+
+...
+```
+
 ### Using the `createMediaObject` Mutation
 
 Following the specification, the upload must be done with a `multipart/form-data` content type.

From 0ba5db7c81ad65a09a9168a84695ad9de37c3f34 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timo=20B=C3=BChlmann?= <timo.buehlmann@gmail.com>
Date: Thu, 11 Sep 2025 09:44:03 +0200
Subject: [PATCH 2/3] graphql.md: add "MediaObject Normalization" chapter

optimization from @vinceAmstoutz

Co-authored-by: Vincent Amstoutz <vincent.amstoutz@outlook.com>
---
 core/graphql.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/core/graphql.md b/core/graphql.md
index 0aa73e7899a..4aa55b0f2bf 100644
--- a/core/graphql.md
+++ b/core/graphql.md
@@ -2945,7 +2945,7 @@ For handling the upload of multiple files, iterate over `$context['args']['input
 ### Normalization of MediaObjects
 
 In the constructor of the `MediaObjectNormalizer`, the injected Normalizer must be replaced with the one from the
-graphql-namespace:
+`api_platform.graphql.normalizer.item` from GraphQL:
 
 ```PHP
 <?php

From ec0c2df1cb483b228be00c933d73fee61eff1884 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timo=20B=C3=BChlmann?= <timo.buehlmann@gmail.com>
Date: Fri, 12 Sep 2025 09:02:43 +0200
Subject: [PATCH 3/3] graphql.md: add "MediaObject Normalization" chapter

optimization from @vinceAmstoutz

Co-authored-by: Vincent Amstoutz <vincent.amstoutz@outlook.com>
---
 core/graphql.md | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/core/graphql.md b/core/graphql.md
index 4aa55b0f2bf..ef36ea901d9 100644
--- a/core/graphql.md
+++ b/core/graphql.md
@@ -2947,20 +2947,23 @@ For handling the upload of multiple files, iterate over `$context['args']['input
 In the constructor of the `MediaObjectNormalizer`, the injected Normalizer must be replaced with the one from the
 `api_platform.graphql.normalizer.item` from GraphQL:
 
-```PHP
+```php
 <?php
 // api/src/Serializer/MediaObjectNormalizer.php
 
-...
-
-public function __construct(
-    #[Autowire(service: 'api_platform.graphql.normalizer.item')]
-    private readonly NormalizerInterface $normalizer,
-    private readonly StorageInterface $storage
-) {}
+use App\Storage\StorageInterface;
+use ApiPlatform\GraphQl\Serializer\ItemNormalizer;
 
-...
-```
+final readonly class MediaObjectNormalizer
+{
+    public function __construct(
+        #[Autowire(service: ItemNormalizer::class)]
+        private NormalizerInterface $normalizer,
+        private StorageInterface $storage
+    ) {}
+    
+    // ...
+}
 
 ### Using the `createMediaObject` Mutation