feat: add AfricasTalking SMS adapter

src/Utopia/Messaging/Adapter/SMS/AfricasTalking.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace Utopia\Messaging\Adapter\SMS;
+
+use Utopia\Messaging\Adapter\SMS as SMSAdapter;
+use Utopia\Messaging\Messages\SMS as SMSMessage;
+use Utopia\Messaging\Response;
+
+class AfricasTalking extends SMSAdapter
+{
+    protected const NAME = 'AfricasTalking';
+
+    private const API_URL = 'https://api.africasTalking.com/sms/1/action';
+
+    public function __construct(
+        private string $username,
+        private string $apiKey,
+        private ?string $from = null
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return static::NAME;
+    }
+
+    public function getMaxMessagesPerRequest(): int
+    {
+        return 100;
+    }
+
+    protected function process(SMSMessage $message): array
+    {
+        $response = new Response($this->getType());
+
+        $recipients = \array_map(
+            fn ($to) => \ltrim($to, '+'),
+            $message->getTo()
+        );
+
+        $from = $this->from ?? $message->getFrom();
+
+        foreach ($recipients as $recipient) {
+            $result = $this->request(
+                method: 'POST',
+                url: self::API_URL,
+                headers: [
+                    'Content-Type: application/x-www-form-urlencoded',
+                    'apiKey: ' . $this->apiKey,
+                ],
+                body: [
+                    'username' => $this->username,
+                    'to' => $recipient,
+                    'message' => $message->getContent(),
+                    'from' => $from,
+                ]
+            );
+
+            if ($result['statusCode'] === 201) {
+                $response->incrementDeliveredTo();
+                $response->addResult($recipient);
+            } else {
+                $errorMessage = 'Unknown error';
+                if (isset($result['response']['errorMessage'])) {
+                    $errorMessage = $result['response']['errorMessage'];
+                } elseif (isset($result['response']['message'])) {
+                    $errorMessage = $result['response']['message'];
+                }
+                $response->addResult($recipient, $errorMessage);
+            }
+        }
+
+        return $response->toArray();
+    }
+}

tests/Messaging/Adapter/SMS/AfricasTalkingTest.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Utopia\Tests\Adapter\SMS;
+
+use Utopia\Messaging\Adapter\SMS\AfricasTalking;
+use Utopia\Messaging\Messages\SMS;
+use Utopia\Tests\Adapter\Base;
+
+class AfricasTalkingTest extends Base
+{
+    public function testSendSMS(): void
+    {
+        $username = \getenv('AFRICAS_TALKING_USERNAME');
+        $apiKey = \getenv('AFRICAS_TALKING_API_KEY');
+        $to = \getenv('AFRICAS_TALKING_TO');
+
+        if (empty($username) || empty($apiKey) || empty($to)) {
+            $this->markTestSkipped('AfricasTalking credentials are not available.');
+        }
+
+        $sender = new AfricasTalking($username, $apiKey);
+
+        $message = new SMS(
+            to: [$to],
+            content: 'Test Content',
+            from: \getenv('AFRICAS_TALKING_FROM') ?: null
+        );
+
+        $response = $sender->send($message);
+
+        $result = \json_decode($response, true);
+
+        $this->assertResponse($result);
+    }
+
+    public function testSendSMSWithFrom(): void
+    {
+        $username = \getenv('AFRICAS_TALKING_USERNAME');
+        $apiKey = \getenv('AFRICAS_TALKING_API_KEY');
+        $to = \getenv('AFRICAS_TALKING_TO');
+        $from = \getenv('AFRICAS_TALKING_FROM');
+
+        if (empty($username) || empty($apiKey) || empty($to)) {
+            $this->markTestSkipped('AfricasTalking credentials are not available.');
+        }
+
+        $sender = new AfricasTalking($username, $apiKey, $from ?: 'AFRICAST');
+
+        $message = new SMS(
+            to: [$to],
+            content: 'Test Content with custom from'
+        );
+
+        $response = $sender->send($message);
+
+        $result = \json_decode($response, true);
+
+        $this->assertResponse($result);
+    }
+}