Allow to get service points by ids

Author: loevgaard

src/Client/Endpoint/ServicePointsEndpoint.php

@@ -13,8 +13,23 @@ final class ServicePointsEndpoint extends Endpoint implements ServicePointsEndpo
 {
     public function getNearestByAddress(Query $query): ServicePointInformationResponse
     {
-        $source = new JsonSource($this->client->get(sprintf('%s/nearest/byaddress', $this->endpoint), $query));
+        return $this
+            ->mapperBuilder
+            ->mapper()
+            ->map(
+                ServicePointInformationResponse::class,
+                Source::iterable(new JsonSource($this->client->get(sprintf('%s/nearest/byaddress', $this->endpoint), $query))),
+            );
+    }
 
-        return $this->mapperBuilder->mapper()->map(ServicePointInformationResponse::class, Source::iterable($source));
+    public function getByIds(Query $query): ServicePointInformationResponse
+    {
+        return $this
+            ->mapperBuilder
+            ->mapper()
+            ->map(
+                ServicePointInformationResponse::class,
+                Source::iterable(new JsonSource($this->client->get(sprintf('%s/ids', $this->endpoint), $query))),
+            );
     }
 }

src/Client/Endpoint/ServicePointsEndpointInterface.php

@@ -10,4 +10,6 @@
 interface ServicePointsEndpointInterface extends EndpointInterface
 {
     public function getNearestByAddress(Query $query): ServicePointInformationResponse;
+
+    public function getByIds(Query $query): ServicePointInformationResponse;
 }

src/Request/Query/ServicePoints/ByIdsQuery.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Setono\PostNord\Request\Query\ServicePoints;
+
+use Setono\PostNord\Request\Query\Query;
+
+final class ByIdsQuery extends Query
+{
+    /**
+     * @param list<string|int> $ids
+     */
+    public static function create(
+        array $ids,
+        string $countryCode,
+        string $responseFilter = null,
+        string $grouped = null,
+        string $located = null,
+        string $callback = null,
+        string $whiteLabelName = null,
+        string $returnType = 'json',
+    ): self {
+        return new self([
+            'ids' => implode(',', $ids),
+            'countryCode' => $countryCode,
+            'responseFilter' => $responseFilter,
+            'grouped' => $grouped,
+            'located' => $located,
+            'callback' => $callback,
+            'whiteLabelName' => $whiteLabelName,
+            'returnType' => $returnType,
+        ]);
+    }
+}

src/Response/ServicePoints/ServicePoint.php

@@ -9,7 +9,7 @@ final class ServicePoint
     public function __construct(
         public readonly string $name,
         public readonly string $servicePointId,
-        public readonly int $routeDistance,
+        public readonly ?int $routeDistance,
         public readonly Address $visitingAddress,
     ) {
     }