From 4f6b82daa8017db6cf8543964d14e2d054880080 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B6rn=20Fromme?= <fromme@dreipunktnull.com>
Date: Thu, 30 Apr 2026 12:31:58 +0200
Subject: [PATCH] chore: fix phpstan errors, add inline docs

---
 .../Webhook/MailjetNewsletterWebhookController.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/Controller/Webhook/MailjetNewsletterWebhookController.php b/src/Controller/Webhook/MailjetNewsletterWebhookController.php
index 13f33d3..93cecb0 100644
--- a/src/Controller/Webhook/MailjetNewsletterWebhookController.php
+++ b/src/Controller/Webhook/MailjetNewsletterWebhookController.php
@@ -51,7 +51,10 @@ final class MailjetNewsletterWebhookController extends AbstractController
     }
 
     /**
-     * @param array<string, mixed> $payload
+     * Mailjet may send one event or a batch of events, so normalize both shapes
+     * into a list before dispatching.
+     *
+     * @param array<int|string, mixed> $payload
      * @return list<array<string, mixed>>
      */
     private function normalizeEvents(array $payload): array
@@ -61,7 +64,14 @@ final class MailjetNewsletterWebhookController extends AbstractController
         }
 
         if (array_is_list($payload)) {
-            return array_values(array_filter($payload, static fn (mixed $entry): bool => is_array($entry)));
+            $events = [];
+            foreach ($payload as $entry) {
+                if (true === is_array($entry)) {
+                    $events[] = $entry;
+                }
+            }
+
+            return $events;
         }
 
         return [$payload];