From e6af6a052ed122ebb3e635a02761c6136b8f0c10 Mon Sep 17 00:00:00 2001
From: Kartik Jolapara <kjmickey003@gmail.com>
Date: Sat, 25 Jul 2026 13:05:05 +0530
Subject: [PATCH] feat: add Netcore Email adapter

---
 .../Messaging/Adapter/Email/Netcore.php       | 64 +++++++++++++++++++
 tests/e2e/Email/NetcoreTest.php               | 25 ++++++++
 2 files changed, 89 insertions(+)
 create mode 100644 src/Utopia/Messaging/Adapter/Email/Netcore.php
 create mode 100644 tests/e2e/Email/NetcoreTest.php

diff --git a/src/Utopia/Messaging/Adapter/Email/Netcore.php b/src/Utopia/Messaging/Adapter/Email/Netcore.php
new file mode 100644
index 00000000..dec88aaf
--- /dev/null
+++ b/src/Utopia/Messaging/Adapter/Email/Netcore.php
@@ -0,0 +1,64 @@
+<?php
+
+namespace Utopia\Messaging\Adapter\Email;
+
+use Utopia\Messaging\Adapter\Email as EmailAdapter;
+use Utopia\Messaging\Messages\Email;
+use Utopia\Messaging\Response;
+
+class Netcore extends EmailAdapter
+{
+    public function __construct(
+        private string $apiKey,
+        private bool $isEU = false
+    ) {
+        parent::__construct();
+    }
+
+    public function getName(): string
+    {
+        return 'Netcore';
+    }
+
+    public function getMaxMessagesPerRequest(): int
+    {
+        return 1000;
+    }
+
+    protected function process(Email $message): array
+    {
+        $usDomain = 'emailapi.netcorecloud.net';
+        $euDomain = 'apieu.netcorecloud.net';
+
+        $domain = $this->isEU ? $euDomain : $usDomain;
+
+        $response = new Response($this->getType());
+        $result = $this->request(
+            method: 'POST',
+            url: "https://$domain/v5.1/mail/send",
+            headers: [
+                'apiKey: ' . \base64_encode('api:' . $this->apiKey),
+                'Accept: application/json',
+                'Content-Type: application/json',
+            ],
+            body: [
+                'to' => \implode(',', $message->getTo()),
+                'from' => $message->getFrom(),
+                'subject' => $message->getSubject(),
+                'content' => [
+                    'type' => $message->isHtml() ? 'html' : 'amp',
+                    'value' => $message->getContent(),
+                ],
+            ],
+        );
+
+        if ($result['statusCode'] >= 200 && $result['statusCode'] < 300) {
+            $response->addResult(\implode(',', $message->getTo()));
+        } else {
+            $error = $result['response']['error'] ?? $result['error'] ?? 'Unknown error';
+            $response->addResult(\implode(',', $message->getTo()), $error);
+        }
+
+        return $response->toArray();
+    }
+}
diff --git a/tests/e2e/Email/NetcoreTest.php b/tests/e2e/Email/NetcoreTest.php
new file mode 100644
index 00000000..626b391d
--- /dev/null
+++ b/tests/e2e/Email/NetcoreTest.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace Utopia\Tests\Adapter\Email;
+
+use Utopia\Messaging\Adapter\Email\Netcore;
+use Utopia\Messaging\Messages\Email;
+use Utopia\Tests\Adapter\Base;
+
+class NetcoreTest extends Base
+{
+    public function testSendEmail(): void
+    {
+        $sender = new Netcore(\getenv('NETCORE_API_KEY'));
+
+        $message = new Email(
+            to: [\getenv('TEST_EMAIL')],
+            subject: 'Test Subject',
+            content: 'Test Content',
+        );
+
+        $response = $sender->send($message);
+
+        $this->assertResponse($response);
+    }
+}