Added SMSApi 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 }}
+        SMSAPI_AUTH_TOKEN: ${{ secrets.SMSAPI_AUTH_TOKEN }}
+        SMSAPI_TO: ${{ secrets.SMSAPI_TO }}
+        SMSAPI_FROM: ${{ secrets.SMSAPI_FROM }}
       run: |
         docker compose up -d --build
         sleep 5

README.md

@@ -105,6 +105,7 @@ $messaging->send($message);
 - [x] [Sinch](https://www.sinch.com/)
 - [x] [Seven](https://www.seven.io/)
 - [ ] [SmsGlobal](https://www.smsglobal.com/)
+- [x] [SMSApi](https://www.smsapi.com/)
 
 ### Push
 - [x] [FCM](https://firebase.google.com/docs/cloud-messaging)

docker-compose.yml

@@ -29,6 +29,9 @@ services:
     - VONAGE_API_SECRET
     - VONAGE_TO
     - VONAGE_FROM
+    - SMSAPI_AUTH_TOKEN
+    - SMSAPI_TO
+    - SMSAPI_FROM
     build:
       context: .
     volumes:

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

@@ -0,0 +1,51 @@
+<?php
+
+namespace Utopia\Messaging\Adapters\SMS;
+
+use Utopia\Messaging\Adapters\SMS as SMSAdapter;
+use Utopia\Messaging\Messages\SMS;
+
+// Reference Material
+// https://www.smsapi.com/docs/#2-single-sms
+class SMSApi extends SMSAdapter
+{
+    /**
+     * @param  string  $apiToken SMSApi token
+     */
+    public function __construct(
+        private string $apiToken
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return 'SMSApi';
+    }
+
+    public function getMaxMessagesPerRequest(): int
+    {
+        return 1000;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @throws \Exception
+     */
+    protected function process(SMS $message): string
+    {
+        return $this->request(
+            method: 'POST',
+            url: 'https://api.smsapi.com/sms.do',
+            headers: [
+                'Authorization: Bearer '.$this->apiToken,
+                'content-type: application/json',
+            ],
+            body: \json_encode([
+                'from' => $message->getFrom(),          //sendername made in https://ssl.smsapi.com/sms_settings/sendernames
+                'to' => $message->getTo()[0],           //destination number
+                'message' => $message->getContent(),    //message content
+            ]),
+        );
+    }
+}

tests/e2e/SMS/SMSApiTest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Tests\E2E;
+
+use Utopia\Messaging\Adapters\SMS\SMSApi;
+use Utopia\Messaging\Messages\SMS;
+
+class SMSApiTest extends Base
+{
+    /**
+     * @throws \Exception
+     */
+    public function testSendSMS()
+    {
+        // $sender = new SMSApi(getenv('SMSAPI_AUTH_TOKEN'));
+
+        // $message = new SMS(
+        //     to: [getenv('SMSAPI_TO')],
+        //     content: 'Test Content',
+        //     from: getenv('SMSAPI_FROM')
+        // );
+
+        // $response = $sender->send($message);
+        // $result = \json_decode($response, true);
+
+        // $this->assertEquals('success', $result['type']);
+
+        $this->markTestSkipped('SMSApi currenlty not available in INDIA.');
+    }
+}