feat: Add SMSGateApp adapter

.env.dev

@@ -34,3 +34,6 @@ FAST2SMS_MESSAGE_ID=
 FAST2SMS_TO=
 INFORU_API_TOKEN=
 INFORU_SENDER_ID=
+SMSGATEAPP_USERNAME=
+SMSGATEAPP_PASSWORD=
+SMSGATEAPP_TO=

README.md

@@ -106,6 +106,7 @@ $messaging->send($message);
 - [x] [Seven](https://www.seven.io/)
 - [ ] [SmsGlobal](https://www.smsglobal.com/)
 - [x] [Inforu](https://www.inforu.co.il/)
+- [x] [SMS Gateway for Android™](https://sms-gate.app/)
 
 ### Push
 - [x] [FCM](https://firebase.google.com/docs/cloud-messaging)

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

@@ -0,0 +1,86 @@
+<?php
+
+namespace Utopia\Messaging\Adapter\SMS;
+
+use Utopia\Messaging\Adapter\SMS as SMSAdapter;
+use Utopia\Messaging\Messages\SMS as SMSMessage;
+use Utopia\Messaging\Response;
+
+/**
+ * SMSGateApp adapter class.
+ */
+class SMSGateApp extends SMSAdapter {
+    protected const NAME = 'SMS Gateway for Android™';
+    protected const DEFAULT_API_ENDPOINT = 'https://api.sms-gate.app/3rdparty/v1';
+
+    /**
+     * @param string $apiUsername SMSGate username
+     * @param string $apiPassword SMSGate password
+     * @param string|null $apiEndpoint SMSGate API endpoint
+     */
+    public function __construct(
+        private string $apiUsername,
+        private string $apiPassword,
+        private ?string $apiEndpoint = null,
+    ) {
+        $this->apiEndpoint = $this->apiEndpoint ?: self::DEFAULT_API_ENDPOINT;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getName(): string {
+        return static::NAME;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getMaxMessagesPerRequest(): int {
+        return 10;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function process(SMSMessage $message): array {
+        $response = new Response($this->getType());
+
+        $body = [
+            'textMessage' => [
+                'text' => $message->getContent(),
+            ],
+            'phoneNumbers' => $message->getTo(),
+        ];
+
+        $result = $this->request(
+            method: 'POST',
+            url: $this->apiEndpoint . '/messages?skipPhoneValidation=true',
+            headers: [
+                'Content-Type: application/json',
+                'Authorization: Basic ' . base64_encode("{$this->apiUsername}:{$this->apiPassword}"),
+            ],
+            body: $body,
+        );
+
+        if ($result['statusCode'] === 202) {
+            $success = 0;
+            foreach ($result['response']['recipients'] as $recipient) {
+                $response->addResult($recipient['phoneNumber'], $recipient['error'] ?? '');
+
+                if ($recipient['state'] !== 'Failed') {
+                    $success++;
+                }
+            }
+
+            $response->setDeliveredTo($success);
+        } else {
+            $errorMessage = $result['response']['message'] ?? 'Unknown error';
+            foreach ($message->getTo() as $recipient) {
+                $response->addResult($recipient, $errorMessage);
+            }
+        }
+
+        return $response->toArray();
+    }
+}

tests/Messaging/Adapter/SMS/SMSGateAppTest.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Utopia\Tests\Adapter\SMS;
+
+use Utopia\Messaging\Adapter\SMS\SMSGateApp;
+use Utopia\Messaging\Messages\SMS;
+use Utopia\Tests\Adapter\Base;
+
+class SMSGateAppTest extends Base {
+    /**
+     * Test sending SMS message with SMSGateApp
+     */
+    public function testSendSMS(): void {
+        // Environment variables for credentials
+        $username = \getenv('SMSGATEAPP_USERNAME');
+        $password = \getenv('SMSGATEAPP_PASSWORD');
+        $to = \getenv('SMSGATEAPP_TO');
+
+        if (!$username || !$password || !$to) {
+            $this->markTestSkipped('SMSGateApp credentials not configured');
+        }
+
+        // Optional API endpoint if set
+        $endpoint = \getenv('SMSGATEAPP_ENDPOINT') ?? null;
+
+        // Instantiate SMSGateApp
+        $sender = new SMSGateApp($username, $password, $endpoint);
+
+        // Create SMS message with required 'to' parameter
+        $message = new SMS(
+            to: [$to],
+            content: 'Test content from SMSGateApp'
+        );
+
+        // Call send() and verify response
+        $response = $sender->send($message);
+
+        // Assertion to match expected response formatting
+        $this->assertResponse($response);
+    }
+}