SMTPTest.php

<?php

namespace Utopia\Tests\Adapter\Email;

use Utopia\Messaging\Adapter\Email\SMTP;
use Utopia\Messaging\Messages\Email;
use Utopia\Messaging\Messages\Email\Attachment;
use Utopia\Tests\Adapter\Base;

class SMTPTest extends Base
{
    public function testSendEmail(): void
    {
        $sender = new SMTP(
            host: 'maildev',
            port: 1025,
        );

        $to = 'tester@localhost.test';
        $subject = 'Test Subject';
        $content = 'Test Content';
        $fromName = 'Test Sender';
        $fromEmail = 'sender@localhost.test';

        $message = new Email(
            to: [$to],
            subject: $subject,
            content: $content,
            fromName: $fromName,
            fromEmail: $fromEmail,
        );

        $response = $sender->send($message);

        $lastEmail = $this->getLastEmail();

        $this->assertResponse($response);
        $this->assertEquals($to, $lastEmail['to'][0]['address']);
        $this->assertEquals($fromEmail, $lastEmail['from'][0]['address']);
        $this->assertEquals($subject, $lastEmail['subject']);
        $this->assertEquals($content, \trim($lastEmail['text']));
    }

    public function testSendEmailWithAttachment(): void
    {
        $sender = new SMTP(
            host: 'maildev',
            port: 1025,
        );

        $to = 'tester@localhost.test';
        $subject = 'Test Subject';
        $content = 'Test Content';
        $fromName = 'Test Sender';
        $fromEmail = 'sender@localhost.test';

        $message = new Email(
            to: [$to],
            subject: $subject,
            content: $content,
            fromName: $fromName,
            fromEmail: $fromEmail,
            attachments: [new Attachment(
                name: 'image.png',
                path: __DIR__ . '/../../../assets/image.png',
                type: 'image/png'
            )],
        );

        $response = $sender->send($message);

        $lastEmail = $this->getLastEmail();

        $this->assertResponse($response);
        $this->assertEquals($to, $lastEmail['to'][0]['address']);
        $this->assertEquals($fromEmail, $lastEmail['from'][0]['address']);
        $this->assertEquals($subject, $lastEmail['subject']);
        $this->assertEquals($content, \trim($lastEmail['text']));
    }

    public function testSendEmailOnlyBCC(): void
    {
        $sender = new SMTP(
            host: 'maildev',
            port: 1025,
        );

        $subject = 'Test Subject';
        $content = 'Test Content';
        $fromName = 'Test Sender';
        $fromEmail = 'sender@localhost.test';
        $bcc = [
            [
                'email' => 'tester2@localhost.test',
                'name' => 'Test Recipient 2',
            ],
        ];

        $message = new Email(
            to: [],
            subject: $subject,
            content: $content,
            fromName: $fromName,
            fromEmail: $fromEmail,
            bcc: $bcc,
        );

        $response = $sender->send($message);

        $lastEmail = $this->getLastEmail();

        $this->assertResponse($response);
        $this->assertEquals($fromEmail, $lastEmail['from'][0]['address']);
        $this->assertEquals($subject, $lastEmail['subject']);
        $this->assertEquals($content, \trim($lastEmail['text']));
    }

    public function testAttachmentWithStringContent(): void
    {
        $content = 'Hello, this is raw file content.';
        $attachment = new Attachment(
            name: 'readme.txt',
            path: '',
            type: 'text/plain',
            content: $content,
        );

        $this->assertEquals('readme.txt', $attachment->getName());
        $this->assertEquals('', $attachment->getPath());
        $this->assertEquals('text/plain', $attachment->getType());
        $this->assertEquals($content, $attachment->getContent());
    }

    public function testAttachmentWithoutStringContentDefaultsToNull(): void
    {
        $attachment = new Attachment(
            name: 'image.png',
            path: '/tmp/image.png',
            type: 'image/png',
        );

        $this->assertNull($attachment->getContent());
    }

    public function testSMTPConstructorWithKeepAliveAndTimelimit(): void
    {
        $sender = new SMTP(
            host: 'maildev',
            port: 1025,
            keepAlive: true,
            timelimit: 60,
        );

        $this->assertInstanceOf(SMTP::class, $sender);
        $this->assertEquals('SMTP', $sender->getName());
    }

    public function testSMTPConstructorDefaultsAreBackwardsCompatible(): void
    {
        // Existing call signature still works without new params
        $sender = new SMTP(
            host: 'maildev',
            port: 1025,
        );

        $this->assertInstanceOf(SMTP::class, $sender);
    }

    public function testSendEmailWithStringAttachment(): void
    {
        $sender = new SMTP(
            host: 'maildev',
            port: 1025,
        );

        $to = 'tester@localhost.test';
        $subject = 'String Attachment Test';
        $content = 'Test with string attachment';
        $fromName = 'Test Sender';
        $fromEmail = 'sender@localhost.test';

        $message = new Email(
            to: [$to],
            subject: $subject,
            content: $content,
            fromName: $fromName,
            fromEmail: $fromEmail,
            attachments: [new Attachment(
                name: 'note.txt',
                path: '',
                type: 'text/plain',
                content: 'This is inline content',
            )],
        );

        $response = $sender->send($message);

        $lastEmail = $this->getLastEmail();

        $this->assertResponse($response);
        $this->assertEquals($to, $lastEmail['to'][0]['address']);
        $this->assertEquals($subject, $lastEmail['subject']);
    }

    public function testSendEmailWithKeepAlive(): void
    {
        $sender = new SMTP(
            host: 'maildev',
            port: 1025,
            keepAlive: true,
            timelimit: 15,
        );

        $to = 'tester@localhost.test';
        $fromEmail = 'sender@localhost.test';

        // Send first message
        $message1 = new Email(
            to: [$to],
            subject: 'KeepAlive Test 1',
            content: 'First message',
            fromName: 'Test',
            fromEmail: $fromEmail,
        );

        $response1 = $sender->send($message1);
        $this->assertResponse($response1);

        // Send second message — should reuse the PHPMailer instance
        $message2 = new Email(
            to: [$to],
            subject: 'KeepAlive Test 2',
            content: 'Second message',
            fromName: 'Test',
            fromEmail: $fromEmail,
        );

        $response2 = $sender->send($message2);
        $this->assertResponse($response2);
    }
}