feat: added Mandrill email adapter

.github/workflows/tests.yml

@@ -17,6 +17,7 @@ jobs:
         MAILGUN_API_KEY: ${{ secrets.MAILGUN_API_KEY }}
         MAILGUN_DOMAIN: ${{ secrets.MAILGUN_DOMAIN }}
         SENDGRID_API_KEY: ${{ secrets.SENDGRID_API_KEY }}
+        MANDRILL_API_KEY: ${{ secrets.MANDRILL_API_KEY }}
         FCM_SERVER_KEY: ${{ secrets.FCM_SERVER_KEY }}
         FCM_SERVER_TO: ${{ secrets.FCM_SERVER_TO }}
         TWILIO_ACCOUNT_SID: ${{ secrets.TWILIO_ACCOUNT_SID }}

docker-compose.yml

@@ -6,6 +6,7 @@ services:
     - MAILGUN_API_KEY
     - MAILGUN_DOMAIN
     - SENDGRID_API_KEY
+    - MANDRILL_API_KEY
     - FCM_SERVER_KEY
     - FCM_SERVER_TO
     - TWILIO_ACCOUNT_SID

src/Utopia/Messaging/Adapters/Email/Mandrill.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Utopia\Messaging\Adapters\Email;
+
+use Utopia\Messaging\Adapters\Email as EmailAdapter;
+use Utopia\Messaging\Messages\Email;
+
+class Mandrill extends EmailAdapter
+{
+    /**
+     * @param  string  $apiKey Your Mandrill API key to authenticate with the API.
+     * @return void
+     */
+    public function __construct(private string $apiKey)
+    {
+    }
+
+    /**
+     * Get adapter name.
+     *
+     * @return string
+     */
+    public function getName(): string
+    {
+        return 'Mandrill';
+    }
+
+    /**
+     * Get max messages per request.
+     *
+     * @return int
+     */
+    public function getMaxMessagesPerRequest(): int
+    {
+        return 1;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @param  Email  $message
+     * @return string
+     *
+     * @throws Exception
+     */
+    protected function process(Email $message): string
+    {
+        return $this->request(
+            method: 'POST',
+            url: 'https://mandrillapp.com/api/1.0/messages/send',
+            headers: [
+                'Content-Type: application/json',
+            ],
+            body: \json_encode([
+                "key" => $this->apiKey,
+                "message" => [
+                    "subject" => $message->getSubject(),
+                    "html" => $message->isHTML() ? $message->getContent() : null,
+                    "text" => $message->isHTML() ? null : $message->getContent(),
+                    "from_email" => $message->getFrom(),
+                    "to" => \array_map(
+                            fn ($to) => ['email' => $to],
+                            $message->getTo()
+                        ),
+                ]
+            ]),
+        );
+    }
+}

tests/e2e/Email/MandrillTest.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Tests\E2E;
+
+use Utopia\Messaging\Adapters\Email\Mandrill;
+use Utopia\Messaging\Messages\Email;
+
+class MandrillTest extends Base
+{
+    /**
+     * @throws \Exception
+     */
+    public function testSendEmail()
+    {
+        $key = getenv('MANDRILL_API_KEY');
+        $sender = new Mandrill($key);
+
+        $to = getenv('TEST_EMAIL');
+        $subject = 'Test Subject';
+        $content = 'Test Content';
+        $from = getenv('TEST_FROM_EMAIL');
+
+        $message = new Email(
+            to: [$to],
+            from: $from,
+            subject: $subject,
+            content: $content,
+        );
+
+        $response =json_decode($sender->send($message))[0];
+
+        $this->assertArrayHasKey('_id',$response);
+        $this->assertArrayHasKey('email',$response);
+        $this->assertArrayHasKey('status',$response);
+        $this->assertArrayHasKey('reject_reason',$response);
+        $this->assertArrayHasKey('queued_reason',$response);
+    }
+}