feat(api): add generic query parameter type casting denormalizer

HTTP query parameters are always strings, but CQRS query constructors
expect properly typed values (int, bool, float, etc.).

This denormalizer uses reflection to automatically cast query parameter
values to their expected types based on the CQRS query constructor signature.

Benefits:
- Works for ALL CQRS queries (not just SearchProducts)
- No need for query-specific denormalizers
- Handles int, float, bool, and string types
- Fails gracefully if reflection is not possible

This is a cleaner, more maintainable solution than having separate
denormalizers for each CQRS query that uses query parameters.

Author: tleon

config/admin/services.yml

@@ -28,3 +28,12 @@ services:
   PrestaShop\Module\APIResources\Validation\IframeValidationGroupsResolver:
     arguments:
       - '@prestashop.adapter.legacy.configuration'
+
+  # Generic denormalizer that handles type casting for query parameters in CQRS queries
+  # This is needed because HTTP query parameters are always strings, but CQRS queries
+  # expect properly typed parameters (int, bool, etc.)
+  PrestaShop\Module\APIResources\Normalizer\QueryParameterTypeCastDenormalizer:
+    autowire: true
+    autoconfigure: true
+    tags:
+      - { name: 'serializer.normalizer', priority: 10 }

src/Normalizer/QueryParameterTypeCastDenormalizer.php

@@ -0,0 +1,127 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Academic Free License version 3.0
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/AFL-3.0
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@prestashop.com so we can send you a copy immediately.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/AFL-3.0 Academic Free License version 3.0
+ */
+
+declare(strict_types=1);
+
+namespace PrestaShop\Module\APIResources\Normalizer;
+
+use PrestaShopBundle\ApiPlatform\Normalizer\CQRSApiNormalizer;
+use ReflectionClass;
+use ReflectionException;
+use ReflectionNamedType;
+
+/**
+ * Generic denormalizer that casts query parameter string values to their expected types
+ * for ALL CQRS queries. This is necessary because HTTP query parameters are always strings,
+ * but CQRS query constructors expect properly typed values (int, bool, float, etc.).
+ *
+ * This provides a generic solution that works for any CQRS query without needing
+ * query-specific denormalizers.
+ */
+class QueryParameterTypeCastDenormalizer extends CQRSApiNormalizer
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function denormalize(mixed $data, string $type, ?string $format = null, array $context = []): mixed
+    {
+        // Only process if data is an array (query parameters)
+        if (is_array($data)) {
+            $data = $this->castQueryParametersToExpectedTypes($data, $type);
+        }
+
+        return parent::denormalize($data, $type, $format, $context);
+    }
+
+    /**
+     * Cast string query parameter values to their expected types based on the CQRS query constructor.
+     *
+     * @param array $data The query parameters (all strings from URL)
+     * @param string $queryClass The CQRS query class name
+     *
+     * @return array The data with properly typed values
+     */
+    private function castQueryParametersToExpectedTypes(array $data, string $queryClass): array
+    {
+        try {
+            $reflection = new ReflectionClass($queryClass);
+            $constructor = $reflection->getConstructor();
+
+            if (!$constructor) {
+                return $data;
+            }
+
+            foreach ($constructor->getParameters() as $parameter) {
+                $paramName = $parameter->getName();
+
+                // Skip if parameter is not in data or is not a string
+                if (!array_key_exists($paramName, $data) || !is_string($data[$paramName])) {
+                    continue;
+                }
+
+                $type = $parameter->getType();
+
+                // Only handle simple named types (not union, intersection, or class types)
+                if (!$type instanceof ReflectionNamedType || !$type->isBuiltin()) {
+                    continue;
+                }
+
+                // Cast the string value to the expected type
+                $data[$paramName] = $this->castValue($data[$paramName], $type->getName());
+            }
+        } catch (ReflectionException $e) {
+            // If reflection fails, return data unchanged
+            return $data;
+        }
+
+        return $data;
+    }
+
+    /**
+     * Cast a string value to the specified PHP type.
+     *
+     * @param string $value The string value from query parameter
+     * @param string $typeName The target PHP type (int, float, bool, string)
+     *
+     * @return mixed The value cast to the appropriate type
+     */
+    private function castValue(string $value, string $typeName): mixed
+    {
+        return match ($typeName) {
+            'int' => (int) $value,
+            'float' => (float) $value,
+            'bool' => filter_var($value, FILTER_VALIDATE_BOOLEAN),
+            'string' => $value,
+            default => $value,
+        };
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getSupportedTypes(?string $format): array
+    {
+        // Support all CQRS queries (conventionally in Core\Domain namespace)
+        return [
+            'PrestaShop\PrestaShop\Core\Domain\*' => true,
+        ];
+    }
+}
+