Add carrier endpoints

src/ApiPlatform/Resources/Address/Address.php

@@ -22,6 +22,7 @@
 
 use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\NotExposed;
 use PrestaShop\PrestaShop\Core\Domain\Address\Command\DeleteAddressCommand;
 use PrestaShop\PrestaShop\Core\Domain\Address\Exception\AddressConstraintException;
 use PrestaShop\PrestaShop\Core\Domain\Address\Exception\AddressNotFoundException;
@@ -38,6 +39,10 @@
                 'address_write',
             ],
         ),
+        new NotExposed(
+            uriTemplate: '/addresses/{addressId}',
+            requirements: ['addressId' => '\d+'],
+        ),
     ],
     exceptionToStatus: [
         AddressConstraintException::class => Response::HTTP_UNPROCESSABLE_ENTITY,

src/ApiPlatform/Resources/Address/AddressRequiredFields.php

@@ -0,0 +1,54 @@
+<?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\ApiPlatform\Resources\Address;
+
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use PrestaShop\PrestaShop\Core\Domain\Address\Query\GetRequiredFieldsForAddress;
+use PrestaShopBundle\ApiPlatform\Metadata\CQRSGet;
+
+#[ApiResource(
+    operations: [
+        new CQRSGet(
+            uriTemplate: '/addresses/required-fields',
+            CQRSQuery: GetRequiredFieldsForAddress::class,
+            scopes: ['address_read'],
+            CQRSQueryMapping: ['[@index]' => '[requiredFields][@index]'],
+        ),
+    ],
+    normalizationContext: ['skip_null_values' => false],
+)]
+class AddressRequiredFields
+{
+    /**
+     * @var string[]
+     */
+    #[ApiProperty(
+        openapiContext: [
+            'type' => 'array',
+            'items' => ['type' => 'string'],
+            'example' => ['phone', 'company'],
+        ]
+    )]
+    public array $requiredFields = [];
+}

src/ApiPlatform/Resources/Carrier/Carrier.php

@@ -0,0 +1,121 @@
+<?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\ApiPlatform\Resources\Carrier;
+
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use PrestaShop\PrestaShop\Core\Domain\Carrier\Exception\CarrierNotFoundException;
+use PrestaShop\PrestaShop\Core\Domain\Carrier\Query\GetCarrierForEditing;
+use PrestaShopBundle\ApiPlatform\Metadata\CQRSGet;
+use PrestaShopBundle\ApiPlatform\Metadata\LocalizedValue;
+use Symfony\Component\HttpFoundation\Response;
+
+#[ApiResource(
+    operations: [
+        new CQRSGet(
+            uriTemplate: '/carriers/{carrierId}',
+            requirements: ['carrierId' => '\d+'],
+            CQRSQuery: GetCarrierForEditing::class,
+            scopes: ['carrier_read'],
+            CQRSQueryMapping: self::QUERY_MAPPING,
+        ),
+    ],
+    normalizationContext: ['skip_null_values' => false],
+    exceptionToStatus: [
+        CarrierNotFoundException::class => Response::HTTP_NOT_FOUND,
+    ],
+)]
+class Carrier
+{
+    #[ApiProperty(identifier: true)]
+    public int $carrierId;
+
+    public string $name;
+
+    public int $grade;
+
+    public string $trackingUrl;
+
+    public int $position;
+
+    public bool $active;
+
+    #[LocalizedValue]
+    public array $delay;
+
+    public ?string $logoPath;
+
+    public int $maxWidth;
+
+    public int $maxHeight;
+
+    public int $maxDepth;
+
+    public float $maxWeight;
+
+    #[ApiProperty(openapiContext: ['type' => 'array', 'items' => ['type' => 'integer'], 'example' => [1, 3]])]
+    public array $associatedGroupIds;
+
+    public bool $hasAdditionalHandlingFee;
+
+    public bool $isFree;
+
+    public int $shippingMethod;
+
+    public int $idTaxRuleGroup;
+
+    public int $rangeBehavior;
+
+    #[ApiProperty(openapiContext: ['type' => 'array', 'items' => ['type' => 'integer'], 'example' => [1, 3]])]
+    public array $associatedShopIds;
+
+    #[ApiProperty(openapiContext: ['type' => 'array', 'items' => ['type' => 'object']])]
+    public array $zones;
+
+    public int $ordersCount;
+
+    public const QUERY_MAPPING = [
+        '[_context][shopConstraint]' => '[shopConstraint]',
+        '[carrierId]' => '[getCarrierId][getValue]',
+        '[name]' => '[getName]',
+        '[grade]' => '[getGrade]',
+        '[trackingUrl]' => '[getTrackingUrl]',
+        '[position]' => '[getPosition]',
+        '[active]' => '[isActive]',
+        '[delay]' => '[getLocalizedDelay]',
+        '[logoPath]' => '[getLogoPath]',
+        '[maxWidth]' => '[getMaxWidth]',
+        '[maxHeight]' => '[getMaxHeight]',
+        '[maxDepth]' => '[getMaxDepth]',
+        '[maxWeight]' => '[getMaxWeight]',
+        '[associatedGroupIds]' => '[getAssociatedGroupIds]',
+        '[hasAdditionalHandlingFee]' => '[hasAdditionalHandlingFee]',
+        '[isFree]' => '[isFree]',
+        '[shippingMethod]' => '[getShippingMethod][getValue]',
+        '[idTaxRuleGroup]' => '[getIdTaxRuleGroup]',
+        '[rangeBehavior]' => '[getRangeBehavior][getValue]',
+        '[associatedShopIds]' => '[getAssociatedShopIds]',
+        '[zones]' => '[getZones]',
+        '[ordersCount]' => '[getOrdersCount]',
+    ];
+}

src/ApiPlatform/Resources/Carrier/CarrierList.php

@@ -0,0 +1,67 @@
+<?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\ApiPlatform\Resources\Carrier;
+
+use ApiPlatform\Metadata\ApiProperty;
+use ApiPlatform\Metadata\ApiResource;
+use PrestaShop\PrestaShop\Core\Domain\Carrier\Exception\CarrierNotFoundException;
+use PrestaShop\PrestaShop\Core\Search\Filters\CarrierFilters;
+use PrestaShopBundle\ApiPlatform\Metadata\PaginatedList;
+use PrestaShopBundle\ApiPlatform\Provider\QueryListProvider;
+use Symfony\Component\HttpFoundation\Response;
+
+#[ApiResource(
+    operations: [
+        new PaginatedList(
+            uriTemplate: '/carriers',
+            provider: QueryListProvider::class,
+            scopes: ['carrier_read'],
+            ApiResourceMapping: [
+                '[id_carrier]' => '[carrierId]',
+                '[is_free]' => '[isFree]',
+            ],
+            gridDataFactory: 'prestashop.core.grid.data.factory.carrier',
+            filtersClass: CarrierFilters::class,
+        ),
+    ],
+    exceptionToStatus: [
+        CarrierNotFoundException::class => Response::HTTP_NOT_FOUND,
+    ],
+)]
+class CarrierList
+{
+    #[ApiProperty(identifier: true)]
+    public int $carrierId;
+
+    public string $name;
+
+    public ?string $delay;
+
+    public bool $active;
+
+    public bool $isFree;
+
+    public int $position;
+
+    public ?string $logo;
+}

tests/Integration/ApiPlatform/AddressEndpointTest.php

@@ -48,6 +48,11 @@ public static function tearDownAfterClass(): void
 
     public static function getProtectedEndpoints(): iterable
     {
+        yield 'get address required fields endpoint' => [
+            'GET',
+            '/addresses/required-fields',
+        ];
+
         yield 'get customer address endpoint' => [
             'GET',
             '/addresses/customers/1',
@@ -498,4 +503,17 @@ public function testAddressValidation(): void
         // Use the createItem method but expect it to fail with validation error
         $this->createItem('/addresses/customers', $invalidData, ['address_write'], 422);
     }
+
+    public function testGetAddressRequiredFields(): void
+    {
+        $result = $this->getItem('/addresses/required-fields', ['address_read']);
+        $this->assertArrayHasKey('requiredFields', $result);
+        $this->assertIsArray($result['requiredFields']);
+
+        // Assert some common required fields are present
+        if (!empty($result['requiredFields'])) {
+            // Just verifying it's an array of strings
+            $this->assertIsString($result['requiredFields'][0]);
+        }
+    }
 }