refactor(api): use query parameters for product search endpoint

Changed the product search endpoint from:
  GET /products/search/{phrase}/{resultsLimit}/{isoCode}
To:
  GET /products/search/{phrase}?resultsLimit=20&isoCode=EUR

Benefits:
- Query parameters are properly typed by API Platform automatically
- No need for custom denormalizer to handle string-to-int conversion
- More RESTful design (only essential identifier in path)
- Parameters can be optional or have defaults
- Cleaner OpenAPI documentation with parameter descriptions

This removes the need for SearchProductsDenormalizer entirely, as API
Platform handles query parameter type conversion natively.

Fixes #34486

Author: tleon

config/admin/services.yml

@@ -29,8 +29,3 @@ services:
     arguments:
       - '@prestashop.adapter.legacy.configuration'
 
-  # Custom denormalizer to handle type conversion for SearchProducts query
-  PrestaShop\Module\APIResources\Normalizer\SearchProductsDenormalizer:
-    autowire: true
-    tags:
-      - { name: 'serializer.normalizer', priority: 10 }

src/ApiPlatform/Resources/Product/FoundProduct.php

@@ -30,7 +30,7 @@
 #[ApiResource(
     operations: [
         new CQRSGetCollection(
-            uriTemplate: '/products/search/{phrase}/{resultsLimit}/{isoCode}',
+            uriTemplate: '/products/search/{phrase}',
             scopes: [
                 'product_read',
             ],
@@ -40,26 +40,30 @@
                     [
                         'name' => 'phrase',
                         'in' => 'path',
+                        'description' => 'Search phrase to find products',
                         'required' => true,
                         'schema' => [
                             'type' => 'string',
                         ],
                     ],
                     [
                         'name' => 'resultsLimit',
-                        'in' => 'path',
+                        'in' => 'query',
                         'required' => true,
                         'schema' => [
                             'type' => 'integer',
+                            'default' => 20,
                         ],
+                        'description' => 'Maximum number of results to return',
                     ],
                     [
                         'name' => 'isoCode',
-                        'in' => 'path',
+                        'in' => 'query',
                         'required' => true,
                         'schema' => [
                             'type' => 'string',
                         ],
+                        'description' => 'Currency ISO code (e.g., EUR, USD)',
                     ],
                     [
                         'name' => 'orderId',
@@ -68,6 +72,7 @@
                         'schema' => [
                             'type' => 'integer',
                         ],
+                        'description' => 'Optional order ID for context-specific pricing',
                     ],
                 ],
             ]