feat: add clicksend-sms-adapter

README.md

@@ -98,6 +98,7 @@ $messaging->send($message);
 - [x] [TextMagic](https://www.textmagic.com/)
 - [x] [Msg91](https://msg91.com/)
 - [x] [Vonage](https://www.vonage.com/)
+- [x] [ClickSend](https://www.clicksend.com/)
 - [ ] [Plivo](https://www.plivo.com/)
 - [ ] [Infobip](https://www.infobip.com/)
 - [ ] [Clickatell](https://www.clickatell.com/)

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

@@ -0,0 +1,66 @@
+<?php
+
+namespace Utopia\Messaging\Adapters\SMS;
+
+use Utopia\Messaging\Adapters\SMS as SMSAdapter;
+use Utopia\Messaging\Messages\SMS;
+
+// Reference Material
+// https://developers.clicksend.com/docs/rest/v3/#send-sms
+
+class ClickSend extends SMSAdapter
+{
+    /**
+     * @param  string  $username ClickSend Username
+     * @param  string  $apiKey ClickSend API Key
+     */
+    public function __construct(
+        private string $username,
+        private string $apiKey
+    ) {
+    }
+
+    public function getName(): string
+    {
+        return 'ClickSend';
+    }
+
+    public function getMaxMessagesPerRequest(): int
+    {
+        return 1000;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @throws \Exception
+     */
+    protected function process(SMS $message): string
+    {
+        $to = \array_map(
+            fn ($to) => \ltrim($to, '+'),
+            $message->getTo()
+        );
+        $body = array();
+        foreach ($to as $t) {
+            array_push($body, [
+                'body' => $message->getContent(),
+                'from' => $message->getFrom(),
+                'to' => $t,
+                'source' => 'appwrite'
+            ]);
+        }
+
+        return $this->request(
+            method: 'POST',
+            url: 'https://rest.clicksend.com/v3/sms/send',
+            headers: [
+                'Content-Type: application/json',
+                'Authorization: Basic ' . base64_encode("{$this->username}:{$this->apiKey}"),
+            ],
+            body: \json_encode([
+                'messages' => $body
+            ]),
+        );
+    }
+}