Added Termii messaging adapter

.github/workflows/tests.yml

@@ -40,6 +40,9 @@ jobs:
         VONAGE_API_SECRET: ${{ secrets.VONAGE_API_SECRET }}
         VONAGE_TO: ${{ secrets.VONAGE_TO }}
         VONAGE_FROM: ${{ secrets.VONAGE_FROM }}
+        TERMII_API_KEY: ${{ secrets.TERMII_API_KEY }}
+        TERMII_TO: ${{ secrets.TERMII_TO }}
+        TERMII_FROM: ${{ secrets.TERMII_FROM }}
       run: |
         docker compose up -d --build
         sleep 5

docker-compose.yml

@@ -29,6 +29,9 @@ services:
     - VONAGE_API_SECRET
     - VONAGE_TO
     - VONAGE_FROM
+    - TERMII_API_KEY
+    - TERMII_TO
+    - TERMII_FROM
     build:
       context: .
     volumes:

src/Utopia/Messaging/Adapters/SMS/Termii.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace Utopia\Messaging\Adapters\SMS;
+
+use Utopia\Messaging\Adapters\SMS as SMSAdapter;
+use Utopia\Messaging\Messages\SMS;
+
+// Reference Material
+// https://developers.termii.com/messaging-api
+class Termii extends SMSAdapter
+{
+    const SMSType = 'plain';
+
+    const SMSChannel = 'generic';
+
+    public function __construct(
+        private string $apiKey
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return 'Termii';
+    }
+
+    public function getMaxMessagesPerRequest(): int
+    {
+        return 100;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @throws \Exception
+     */
+    protected function process(SMS $message): string
+    {
+        return $this->request(
+            method: 'POST',
+            url: 'https://api.ng.termii.com/api/sms/send',
+            headers: [
+                'Content-Type: application/json',
+            ],
+            body: \json_encode(
+                $this->getRequestBody(
+                    to: $message->getTo(),
+                    text: $message->getContent(),
+                    from: $message->getFrom()
+                )
+            ),
+        );
+    }
+
+    /**
+     * Get the request body
+     *
+     * @param  array  $to  Phone number
+     * @param  string  $text  Message to send
+     * @param  string|null  $from Origin of the message
+     */
+    private function getRequestBody(array $to, string $text, string $from = null): array
+    {
+        $from = $from ?? '';
+
+        // removing + from numbers if exists
+        $to = \array_map(
+            fn ($to) => \ltrim($to, '+'),
+            $to
+        );
+
+        if (count($to) == 1) {
+            $to = $to[0];
+        }
+
+        $body = [
+            'api_key' => $this->apiKey,
+            'to' => $to,
+            'from' => $from,
+            'sms' => $text,
+            'type' => self::SMSType,
+            'channel' => self::SMSChannel,
+        ];
+
+        return $body;
+    }
+}

tests/e2e/SMS/TermiiTest.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Tests\E2E;
+
+use Utopia\Messaging\Adapters\SMS\Termii;
+use Utopia\Messaging\Messages\SMS;
+
+class TermiiTest extends Base
+{
+    /**
+     * @throws \Exception
+     */
+    public function testSendSMS()
+    {
+        $apiKey = getenv('TERMII_API_KEY');
+
+        $to = [getenv('TERMII_TO')];
+        $from = getenv('TERMII_FROM');
+
+        $sender = new Termii($apiKey);
+        $message = new SMS(
+            to: $to,
+            content: 'Test Content',
+            from: $from
+        );
+
+        $response = $sender->send($message);
+        $result = \json_decode($response, true);
+
+        $this->assertArrayNotHasKey('errors', $result);
+        $this->assertArrayHasKey('message_id', $result);
+        $this->assertArrayHasKey('message', $result);
+        $this->assertArrayHasKey('balance', $result);
+    }
+}