diff --git a/src/Appwrite/Platform/Services/Workers.php b/src/Appwrite/Platform/Services/Workers.php
index fa77725f7a..8b4925c5a5 100644
--- a/src/Appwrite/Platform/Services/Workers.php
+++ b/src/Appwrite/Platform/Services/Workers.php
@@ -7,7 +7,6 @@ use Appwrite\Platform\Workers\Certificates;
use Appwrite\Platform\Workers\Deletes;
use Appwrite\Platform\Workers\Executions;
use Appwrite\Platform\Workers\Functions;
-use Appwrite\Platform\Workers\Mails;
use Appwrite\Platform\Workers\Messaging;
use Appwrite\Platform\Workers\Migrations;
use Appwrite\Platform\Workers\StatsResources;
@@ -26,8 +25,8 @@ class Workers extends Service
->addAction(Deletes::getName(), new Deletes())
->addAction(Executions::getName(), new Executions())
->addAction(Functions::getName(), new Functions())
- ->addAction(Mails::getName(), new Mails())
->addAction(Messaging::getName(), new Messaging())
+ ->addAction(Notifications::getName(), new Notifications())
->addAction(Webhooks::getName(), new Webhooks())
->addAction(StatsUsage::getName(), new StatsUsage())
->addAction(Migrations::getName(), new Migrations())
diff --git a/src/Appwrite/Platform/Workers/Notifications.php b/src/Appwrite/Platform/Workers/Notifications.php
new file mode 100644
index 0000000000..b38f3dde1c
--- /dev/null
+++ b/src/Appwrite/Platform/Workers/Notifications.php
@@ -0,0 +1,369 @@
+
+ */
+ protected array $richTextParams = [
+ 'b' => '',
+ '/b' => '',
+ ];
+
+ public static function getName(): string
+ {
+ return 'notifications';
+ }
+
+ public function __construct()
+ {
+ $this
+ ->desc('Notifications worker')
+ ->inject('message')
+ ->inject('project')
+ ->inject('register')
+ ->inject('dbForProject')
+ ->inject('log')
+ ->callback($this->action(...));
+ }
+
+ public function action(Message $message, Document $project, Registry $register, Database $dbForProject, Log $log): void
+ {
+ Runtime::setHookFlags(SWOOLE_HOOK_ALL ^ SWOOLE_HOOK_TCP);
+ $payload = $message->getPayload();
+
+ if (empty($payload)) {
+ throw new Exception('Missing payload');
+ }
+
+ $dedupKey = $payload['dedupKey'] ?? '';
+ $messageId = $dedupKey !== '' ? \md5($dedupKey) : '';
+
+ if ($messageId !== '' && $this->alreadyDelivered($dbForProject, $messageId)) {
+ $log->addTag('dedup', 'hit');
+ return;
+ }
+
+ $recipients = $this->resolveRecipients($payload);
+ if (empty($recipients)) {
+ throw new Exception('No recipients in payload');
+ }
+
+ foreach ($recipients as $recipient) {
+ $channel = $recipient['channel'];
+ try {
+ $this->dispatch($channel, $recipient['address'], $payload, $register, $dbForProject, $log);
+ if ($messageId !== '') {
+ $this->persistAlert($dbForProject, $messageId, $channel, $recipient['address'], $payload);
+ }
+ } catch (Throwable $error) {
+ $log->addTag('channel', $channel);
+ $log->addTag('error', $error->getMessage());
+ throw $error;
+ }
+ }
+ }
+
+ /**
+ * @return array
+ */
+ private function resolveRecipients(array $payload): array
+ {
+ $recipients = $payload['recipients'] ?? [];
+ if (!empty($recipients)) {
+ return $recipients;
+ }
+
+ $address = $payload['recipient'] ?? '';
+ if ($address === '') {
+ return [];
+ }
+
+ return [['address' => $address, 'channel' => NOTIFICATION_CHANNEL_EMAIL]];
+ }
+
+ private function alreadyDelivered(Database $database, string $messageId): bool
+ {
+ try {
+ $existing = $database->getDocument('alerts', $messageId);
+ return !$existing->isEmpty();
+ } catch (Throwable) {
+ return false;
+ }
+ }
+
+ private function dispatch(string $channel, string $address, array $payload, Registry $register, Database $database, Log $log): void
+ {
+ switch ($channel) {
+ case NOTIFICATION_CHANNEL_EMAIL:
+ $this->dispatchEmail($address, $payload, $register, $log);
+ return;
+ case NOTIFICATION_CHANNEL_CONSOLE:
+ $this->dispatchConsole($address, $payload, $database);
+ return;
+ case NOTIFICATION_CHANNEL_WEBHOOK:
+ $this->dispatchWebhook($address, $payload);
+ return;
+ default:
+ throw new Exception('Unsupported notification channel: ' . $channel);
+ }
+ }
+
+ private function dispatchEmail(string $address, array $payload, Registry $register, Log $log): void
+ {
+ $smtp = $payload['smtp'] ?? [];
+ if (empty($smtp) && empty(System::getEnv('_APP_SMTP_HOST'))) {
+ throw new Exception('Skipped email notification. No SMTP configuration has been set.');
+ }
+
+ $type = empty($smtp) ? 'cloud' : 'smtp';
+ $log->addTag('type', $type);
+
+ $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https';
+ $hostname = System::getEnv('_APP_CONSOLE_DOMAIN');
+
+ $subject = $payload['subject'] ?? '';
+ $variables = $payload['variables'] ?? [];
+ $variables = \array_merge($variables, $payload['templateParams'] ?? []);
+ $variables['host'] = $protocol . '://' . $hostname;
+ $name = $payload['name'] ?? '';
+ $body = $payload['body'] ?? '';
+ $preview = $payload['preview'] ?? '';
+
+ $variables['subject'] = $subject;
+ $variables['heading'] = $variables['heading'] ?? $subject;
+ $variables['year'] = date('Y');
+
+ $attachment = $payload['attachment'] ?? [];
+ $bodyTemplate = $payload['bodyTemplate'] ?? '';
+ if (empty($bodyTemplate)) {
+ $bodyTemplate = $payload['template'] ?? '';
+ }
+ if (empty($bodyTemplate)) {
+ $bodyTemplate = __DIR__ . '/../../../../app/config/locale/templates/email-base.tpl';
+ }
+
+ $bodyTemplate = Template::fromFile($bodyTemplate);
+ $bodyTemplate->setParam('{{body}}', $body, escapeHtml: false);
+ foreach ($variables as $key => $value) {
+ $bodyTemplate->setParam('{{' . $key . '}}', $value, escapeHtml: $key !== 'redirect');
+ }
+ foreach ($this->richTextParams as $key => $value) {
+ $bodyTemplate->setParam('{{' . $key . '}}', $value, escapeHtml: false);
+ }
+
+ $previewWhitespace = '';
+ if (!empty($preview)) {
+ $previewTemplate = Template::fromString($preview);
+ foreach ($variables as $key => $value) {
+ $previewTemplate->setParam('{{' . $key . '}}', $value);
+ }
+ $preview = \strip_tags($previewTemplate->render());
+
+ $previewLen = \strlen($preview);
+ if ($previewLen < $this->previewMaxLen) {
+ $previewWhitespace = \str_repeat($this->whitespaceCodes, $this->previewMaxLen - $previewLen);
+ }
+ }
+
+ $bodyTemplate->setParam('{{preview}}', $preview);
+ $bodyTemplate->setParam('{{previewWhitespace}}', $previewWhitespace, false);
+
+ $body = $bodyTemplate->render();
+
+ $subjectTemplate = Template::fromString($subject);
+ foreach ($variables as $key => $value) {
+ $subjectTemplate->setParam('{{' . $key . '}}', $value);
+ }
+ $subject = \strip_tags($subjectTemplate->render());
+
+ /** @var EmailAdapter $adapter */
+ $adapter = empty($smtp)
+ ? $register->get('smtp')
+ : new SMTP(
+ host: $smtp['host'],
+ port: (int) $smtp['port'],
+ username: $smtp['username'] ?? '',
+ password: $smtp['password'] ?? '',
+ smtpSecure: $smtp['secure'] ?? '',
+ smtpAutoTLS: false,
+ xMailer: 'Appwrite Mailer',
+ timeout: 10,
+ keepAlive: true,
+ timelimit: 30,
+ );
+
+ $defaultFromEmail = System::getEnv('_APP_SYSTEM_EMAIL_ADDRESS', APP_EMAIL_TEAM);
+ $defaultFromName = \urldecode(System::getEnv('_APP_SYSTEM_EMAIL_NAME', APP_NAME . ' Server'));
+
+ $fromEmail = !empty($smtp) ? ($smtp['senderEmail'] ?? $defaultFromEmail) : $defaultFromEmail;
+ $fromName = !empty($smtp) ? ($smtp['senderName'] ?? $defaultFromName) : $defaultFromName;
+ $replyTo = $defaultFromEmail;
+ $replyToName = $defaultFromName;
+
+ $customMailOptions = $payload['customMailOptions'] ?? [];
+
+ if (!empty($customMailOptions['senderEmail'])) {
+ $fromEmail = $customMailOptions['senderEmail'];
+ }
+ if (!empty($customMailOptions['senderName'])) {
+ $fromName = $customMailOptions['senderName'];
+ }
+
+ if (!empty($customMailOptions['replyToEmail']) || !empty($customMailOptions['replyToName'])) {
+ $replyTo = $customMailOptions['replyToEmail'] ?? $replyTo;
+ $replyToName = $customMailOptions['replyToName'] ?? $replyToName;
+ } elseif (!empty($smtp)) {
+ $smtpReplyToEmail = $smtp['replyToEmail'] ?? $smtp['replyTo'] ?? '';
+ $replyTo = !empty($smtpReplyToEmail) ? $smtpReplyToEmail : ($smtp['senderEmail'] ?? $replyTo);
+ $replyToName = !empty($smtp['replyToName']) ? $smtp['replyToName'] : ($smtp['senderName'] ?? $replyToName);
+ }
+
+ $attachments = null;
+ if (!empty($attachment['content'] ?? '')) {
+ $attachments = [
+ new Attachment(
+ name: $attachment['filename'] ?? 'unknown.file',
+ path: '',
+ type: $attachment['type'] ?? 'plain/text',
+ content: \base64_decode($attachment['content']),
+ ),
+ ];
+ }
+
+ $emailMessage = new EmailMessage(
+ to: [['email' => $address, 'name' => $name]],
+ subject: $subject,
+ content: $body,
+ fromName: $fromName,
+ fromEmail: $fromEmail,
+ replyToName: $replyToName,
+ replyToEmail: $replyTo,
+ attachments: $attachments,
+ html: true,
+ );
+
+ try {
+ $adapter->send($emailMessage);
+ } catch (\Throwable $error) {
+ if ($type === 'smtp') {
+ throw new Exception('Error sending notification: ' . $error->getMessage(), 401);
+ }
+ throw new Exception('Error sending notification: ' . $error->getMessage(), 500);
+ }
+ }
+
+ private function dispatchConsole(string $address, array $payload, Database $database): void
+ {
+ $project = $payload['project'] ?? null;
+ $projectId = \is_array($project) ? ($project['$id'] ?? null) : null;
+
+ $title = $payload['subject'] ?? '';
+ $body = $payload['body'] ?? '';
+ $params = $payload['templateParams'] ?? ($payload['variables'] ?? []);
+ if ($title !== '' && !empty($params)) {
+ $rendered = Template::fromString($title);
+ foreach ($params as $key => $value) {
+ $rendered->setParam('{{' . $key . '}}', (string) $value);
+ }
+ $title = \strip_tags($rendered->render());
+ }
+
+ $recipients = [['userId' => $address]];
+
+ $dedupKey = $payload['dedupKey'] ?? '';
+ $messageId = $dedupKey !== '' ? \md5($dedupKey) : null;
+
+ $consoleMessage = new ConsoleMessage(
+ recipients: $recipients,
+ title: $title,
+ body: $body,
+ type: 'info',
+ messageId: $messageId,
+ projectId: $projectId,
+ );
+
+ $adapter = new ConsoleAdapter($database);
+ $adapter->send($consoleMessage);
+ }
+
+ private function dispatchWebhook(string $address, array $payload): void
+ {
+ $body = [
+ 'subject' => $payload['subject'] ?? '',
+ 'body' => $payload['body'] ?? '',
+ 'template' => $payload['template'] ?? '',
+ 'params' => $payload['templateParams'] ?? [],
+ 'project' => \is_array($payload['project'] ?? null) ? ($payload['project']['$id'] ?? null) : null,
+ 'dedupKey' => $payload['dedupKey'] ?? '',
+ 'events' => $payload['events'] ?? [],
+ ];
+
+ $secret = System::getEnv('_APP_NOTIFICATIONS_WEBHOOK_SECRET', '') ?: null;
+
+ $message = new WebhookMessage(
+ urls: [$address],
+ payload: $body,
+ signingSecret: $secret,
+ );
+
+ $adapter = new WebhookAdapter();
+ $result = $adapter->send($message);
+
+ if (($result['deliveredTo'] ?? 0) === 0) {
+ $error = $result['results'][0]['error'] ?? 'Unknown error';
+ throw new Exception('Webhook delivery failed: ' . $error);
+ }
+ }
+
+ private function persistAlert(Database $database, string $messageId, string $channel, string $address, array $payload): void
+ {
+ $project = $payload['project'] ?? null;
+ $projectId = \is_array($project) ? ($project['$id'] ?? null) : null;
+ $permissions = $payload['permissions'] ?? [];
+
+ $document = new Document([
+ '$id' => $messageId . '_' . \substr(\md5($channel . $address), 0, 8),
+ '$permissions' => $permissions,
+ 'messageId' => $messageId,
+ 'type' => 'info',
+ 'channel' => $channel,
+ 'userId' => $channel === NOTIFICATION_CHANNEL_CONSOLE ? $address : null,
+ 'projectId' => $projectId,
+ 'title' => $payload['subject'] ?? '',
+ 'body' => $payload['body'] ?? '',
+ ]);
+
+ try {
+ $database->createDocument('alerts', $document);
+ } catch (DuplicateException) {
+ // Idempotent — duplicate persistence is fine
+ }
+ }
+}