Add getContactIdsByNextUrl function because we need to get contacts by next url

- AUT-3915

Co-authored-by: Peter Kozma <peter.kozma@emarsys.com>

Author: bencekadaremar

src/Suite/Api/ContactList.php

@@ -127,6 +127,16 @@ public function getContactIdsInList(int $customerId, int $contactListId, int $to
         }
     }
 
+    public function getContactIdsByNextUrl(string $nextUrl): array
+    {
+        try {
+            $response = $this->apiClient->get($nextUrl);
+            return $response['data'] ?? [];
+        } catch (Error $error) {
+            throw new RequestFailed('Could not fetch contact ids: ' . $error->getMessage(), $error->getCode(), $error);
+        }
+    }
+
     public function getListChunkIterator(int $customerId, int $contactListId, int $chunkSize = null) : iterable
     {
         $nextUrlFull = $this->endPoints->contactIdsInList($customerId, $contactListId, $chunkSize);

test/unit/Suite/Api/ContactListTest.php

@@ -279,6 +279,33 @@ public function getContactIdsInList_ApiCallFails_ExceptionThrown(): void
         $this->listService->getContactIdsInList($this->customerId, $this->contactListId);
     }
 
+    /**
+     * @test
+     */
+    public function getContactIdsByNextUrl_CalledWithProperUrl_ApiResponseConverted(): void
+    {
+        $nextUrl = "/123/contactlist/456/contactIds";
+        $response = ['value' => [1, 2, 3], 'next' => '/next/url'];
+        $this->apiClient
+            ->method('get')
+            ->with($nextUrl)
+            ->willReturn($this->apiSuccess($response));
+
+        $result = $this->listService->getContactIdsByNextUrl($nextUrl);
+        $this->assertEquals($response, $result);
+    }
+
+    /**
+     * @test
+     */
+    public function getContactIdsByNextUrl_ApiCallFails_ExceptionThrown(): void
+    {
+        $this->apiClient->method('get')->will($this->apiFailure());
+        $this->expectException(RequestFailed::class);
+
+        $this->listService->getContactIdsByNextUrl('/test');
+    }
+
     /**
      * @test
      */