add flows to manage suppressions

src/Actions/ManagesSuppressions.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace Spatie\MailcoachSdk\Actions;
+
+use Spatie\MailcoachSdk\Resources\Suppression;
+use Spatie\MailcoachSdk\Support\PaginatedResults;
+
+trait ManagesSuppressions
+{
+    /**
+     * @param  array<string, string>  $filters
+     * @return PaginatedResults<Suppression>
+     */
+    public function suppressions(array $filters = []): PaginatedResults
+    {
+        return PaginatedResults::make(
+            "suppressions{$this->buildFilterString($filters)}",
+            Suppression::class,
+            $this,
+        );
+    }
+
+    public function createSuppression(string $email): void
+    {
+        $this->createSuppressions([$email]);
+    }
+
+    /** @param array<int, string> $emails */
+    public function createSuppressions(array $emails): void
+    {
+        $payload = [];
+        foreach ($emails as $email) {
+            $payload[] = ['email' => $email];
+        }
+
+        $this->post("suppressions", $payload);
+    }
+
+    public function deleteSuppression(string $email): void
+    {
+        $this->deleteSuppressions([$email]);
+    }
+
+    /** @param array<int, string> $emails */
+    public function deleteSuppressions(array $emails): void
+    {
+        $payload = [];
+        foreach ($emails as $email) {
+            $payload[] = ['email' => $email];
+        }
+
+        $this->delete("suppressions", $payload);
+    }
+}

src/Mailcoach.php

@@ -7,6 +7,7 @@
 use Spatie\MailcoachSdk\Actions\ManagesCampaigns;
 use Spatie\MailcoachSdk\Actions\ManagesEmailLists;
 use Spatie\MailcoachSdk\Actions\ManagesSubscribers;
+use Spatie\MailcoachSdk\Actions\ManagesSuppressions;
 use Spatie\MailcoachSdk\Actions\ManagesTransactionalMails;
 
 class Mailcoach
@@ -16,6 +17,7 @@ class Mailcoach
     use ManagesEmailLists;
     use ManagesSubscribers;
     use ManagesTransactionalMails;
+    use ManagesSuppressions;
 
     public function __construct(
         public string $apiToken,

src/Resources/Suppression.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Spatie\MailcoachSdk\Resources;
+
+class Suppression extends ApiResource
+{
+    public string $uuid;
+
+    public string $email;
+
+    public string $reason;
+
+    public ?string $createdAt;
+
+    public ?string $updatedAt;
+}