Add bounces per campaign and subscriber methods

Author: tatevikg1

src/Endpoint/BouncesClient.php

@@ -55,6 +55,42 @@ public function list(?int $afterId = null, ?int $limit = 25, ?string $status = n
         return new BounceCollection($response);
     }
 
+    /**
+     * Get a list of bounce counts by campaign.
+     *
+     * GET /api/v2/bounces/by/campaign
+     *
+     * @return array<int, array{
+     *     message_id: int,
+     *     subject: string,
+     *     total_bounces: int
+     * }> Raw API response
+     * @throws ApiException If an API error occurs
+     */
+    public function listByCampaign(): array
+    {
+        return $this->client->get('bounces/by/campaign');
+    }
+
+    /**
+     * Get a list of bounce counts by subscriber.
+     *
+     * GET /api/v2/bounces/by/subscriber
+     *
+     * @return array<int, array{
+     *     subscriber_id: int,
+     *     email: string,
+     *     confirmed: bool,
+     *     blacklisted: bool,
+     *     total_bounces: int
+     * }> Raw API response
+     * @throws ApiException If an API error occurs
+     */
+    public function listBySubscriber(): array
+    {
+        return $this->client->get('bounces/by/subscriber');
+    }
+
     /**
      * Create or update a bounce regex rule.
      *

tests/Endpoint/BouncesClientMethodTest.php

@@ -39,4 +39,50 @@ public function testListReturnsBounceCollection(): void
         $this->assertSame(123, $result->items[0]->messageId);
         $this->assertSame('user@example.com', $result->items[0]->subscriberEmail);
     }
+
+    public function testListByCampaignReturnsRawArray(): void
+    {
+        $mockClient = $this->createMock(Client::class);
+        $mockClient->expects($this->once())
+            ->method('get')
+            ->with('bounces/by/campaign')
+            ->willReturn([
+                [
+                    'message_id' => 1,
+                    'subject' => 'System',
+                    'total_bounces' => 3,
+                ],
+            ]);
+
+        $bouncesClient = new BouncesClient($mockClient);
+        $result = $bouncesClient->listByCampaign();
+
+        $this->assertIsArray($result);
+        $this->assertSame(1, $result[0]['message_id']);
+        $this->assertSame(3, $result[0]['total_bounces']);
+    }
+
+    public function testListBySubscriberReturnsRawArray(): void
+    {
+        $mockClient = $this->createMock(Client::class);
+        $mockClient->expects($this->once())
+            ->method('get')
+            ->with('bounces/by/subscriber')
+            ->willReturn([
+                [
+                    'subscriber_id' => 1,
+                    'email' => 'example@email.com',
+                    'confirmed' => true,
+                    'blacklisted' => false,
+                    'total_bounces' => 2,
+                ],
+            ]);
+
+        $bouncesClient = new BouncesClient($mockClient);
+        $result = $bouncesClient->listBySubscriber();
+
+        $this->assertIsArray($result);
+        $this->assertSame(1, $result[0]['subscriber_id']);
+        $this->assertSame(2, $result[0]['total_bounces']);
+    }
 }