Add MailToFile Sender

README.md

@@ -214,9 +214,13 @@ Environment variables can also be used to set endpoints:
 Buggregator Trap provides a variety of "senders" that dictate where the dumps will be sent. Currently, the available
 sender options include:
 
-- `console`: This option displays dumps directly in the console.
-- `server`: With this choice, dumps are sent to a remote Buggregator server.
-- `file`: This allows for dumps to be stored in a file for future reference.
+- `console`: Shows dumps directly in the console.
+- `server`: Sends dumps to a remote Buggregator server.
+- `file`: Saves dumps in a file for later use.
+- `mail-to-file`: Creates a folder for each recipient and saves each message as a JSON file. Useful for testing mails.
+If you send a mail `To: [email protected], [email protected]`, the following folders will be created:
+  - `runtime/mail/[email protected]`
+  - `runtime/mail/[email protected]`
 
 By default, the Trap server is set to display dumps in the console. However, you can easily select your preferred
 senders using the `-s` option.

src/Command/Run.php

@@ -1,4 +1,4 @@
 <?php
 
 declare(strict_types=1);
 
@@ -83,6 +83,7 @@
         $registry->register('console', Sender\ConsoleSender::create($output));
         $registry->register('file', new Sender\EventsToFileSender());
         $registry->register('file-body', new Sender\BodyToFileSender());
+        $registry->register('mail-to-file', new Sender\MailToFileSender());
         $registry->register(
             'server',
             new Sender\RemoteSender(

src/Proto/Frame/Http.php

@@ -37,7 +37,7 @@ public function __construct(
 
     public static function fromString(string $payload, \DateTimeImmutable $time): static
     {
-        $payload = \json_decode($payload, true, \JSON_THROW_ON_ERROR);
+        $payload = \json_decode($payload, true, 64, \JSON_THROW_ON_ERROR);
 
         $request = new ServerRequest(
             $payload['method'] ?? 'GET',

src/Proto/Frame/Smtp.php

@@ -27,9 +27,9 @@ public function __construct(
 
     public static function fromString(string $payload, \DateTimeImmutable $time): static
     {
-        /** @var TArrayData $payload */
-        $payload = \json_decode($payload, true, \JSON_THROW_ON_ERROR);
-        $message = Message\Smtp::fromArray($payload);
+        /** @var TArrayData $data */
+        $data = \json_decode($payload, true, 64, \JSON_THROW_ON_ERROR);
+        $message = Message\Smtp::fromArray($data);
 
         return new self($message, $time);
     }

src/Sender/BodyToFileSender.php

@@ -5,7 +5,9 @@
 namespace Buggregator\Trap\Sender;
 
 use Buggregator\Trap\Proto\Frame;
+use Buggregator\Trap\Proto\StreamCarrier;
 use Buggregator\Trap\Sender;
+use Buggregator\Trap\Support\FileSystem;
 use Buggregator\Trap\Support\StreamHelper;
 use Nyholm\Psr7\Stream;
 
@@ -23,9 +25,7 @@ public function __construct(
         string $path = 'runtime/body',
     ) {
         $this->path = \rtrim($path, '/\\');
-        if (!\is_dir($path) && !\mkdir($path, 0o777, true) && !\is_dir($path)) {
-            throw new \RuntimeException(\sprintf('Directory "%s" was not created', $path));
-        }
+        FileSystem::mkdir($path);
     }
 
     public function send(iterable $frames): void
@@ -35,7 +35,7 @@ public function send(iterable $frames): void
 
         /** @var Frame $frame */
         foreach ($frames as $frame) {
-            if (!$frame instanceof \Buggregator\Trap\Proto\StreamCarrier) {
+            if (!$frame instanceof StreamCarrier) {
                 continue;
             }
 

src/Sender/EventsToFileSender.php

@@ -6,6 +6,7 @@
 
 use Buggregator\Trap\Proto\Frame;
 use Buggregator\Trap\Sender;
+use Buggregator\Trap\Support\FileSystem;
 
 /**
  * Store event groups to files.
@@ -21,9 +22,7 @@ public function __construct(
         string $path = 'runtime',
     ) {
         $this->path = \rtrim($path, '/\\');
-        if (!\is_dir($path) && !\mkdir($path, 0o777, true) && !\is_dir($path)) {
-            throw new \RuntimeException(\sprintf('Directory "%s" was not created', $path));
-        }
+        FileSystem::mkdir($path);
     }
 
     public function send(iterable $frames): void

src/Sender/MailToFileSender.php

@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Buggregator\Trap\Sender;
+
+use Buggregator\Trap\Proto\Frame;
+use Buggregator\Trap\Proto\Frame\Smtp;
+use Buggregator\Trap\Sender;
+use Buggregator\Trap\Support\FileSystem;
+use Buggregator\Trap\Traffic\Message;
+use Buggregator\Trap\Traffic\Message\Smtp\Contact;
+
+/**
+ * @internal
+ */
+class MailToFileSender implements Sender
+{
+    private readonly string $path;
+
+    public function __construct(
+        string $path = 'runtime/mail',
+    ) {
+        $this->path = \rtrim($path, '/\\');
+        FileSystem::mkdir($path);
+    }
+
+    public function send(iterable $frames): void
+    {
+        /** @var Frame $frame */
+        foreach ($frames as $frame) {
+            if (!$frame instanceof Smtp) {
+                continue;
+            }
+
+            foreach (self::fetchDirectories($frame->message) as $dirName) {
+                $path = $this->path . DIRECTORY_SEPARATOR . $dirName;
+                FileSystem::mkdir($path);
+                $filepath = \sprintf("%s/%s.json", $path, $frame->time->format('Y-m-d-H-i-s-v'));
+
+                \assert(!\file_exists($filepath));
+                \file_put_contents($filepath, \json_encode($frame->message, \JSON_PRETTY_PRINT | \JSON_THROW_ON_ERROR));
+            }
+        }
+    }
+
+    /**
+     * Get normalized email address for file or directory name.
+     *
+     * @return non-empty-string
+     */
+    private static function normalizeEmail(string $email): string
+    {
+        return \preg_replace(
+            ['/[^a-z0-9.\\- @]/i', '/\s+/'],
+            ['!', '_'],
+            $email,
+        );
+    }
+
+    /**
+     * @return list<non-empty-string>
+     */
+    private static function fetchDirectories(Message\Smtp $message): array
+    {
+        return
+            \array_filter(
+                \array_unique(
+                    \array_map(
+                        static fn(Contact $c) => self::normalizeEmail($c->email),
+                        \array_merge($message->getBcc(), $message->getTo()),
+                    ),
+                ),
+            );
+    }
+}

src/Support/FileSystem.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Buggregator\Trap\Support;
+
+/**
+ * @internal
+ * @psalm-internal Buggregator\Trap
+ */
+final class FileSystem
+{
+    public static function mkdir(string $path, int $mode = 0777, bool $recursive = true): void
+    {
+        \is_dir($path) or \mkdir($path, $mode, $recursive) or \is_dir($path) or throw new \RuntimeException(
+            \sprintf('Directory "%s" was not created.', $path),
+        );
+    }
+}

src/Traffic/Message/Smtp.php

@@ -141,15 +141,15 @@
      */
     public function getTo(): array
     {
-        return \array_map([$this, 'parseContact'], $this->getHeader('To'));
+        return $this->normalizeAddressList($this->getHeader('To'));
     }
 
     /**
      * @return Contact[]
      */
     public function getCc(): array
     {
-        return \array_map([$this, 'parseContact'], $this->getHeader('Cc'));
+        return $this->normalizeAddressList($this->getHeader('Cc'));
     }
 
     /**
@@ -160,15 +160,15 @@
      */
     public function getBcc(): array
     {
-        return \array_map([$this, 'parseContact'], $this->protocol['BCC'] ?? []);
+        return $this->normalizeAddressList($this->protocol['BCC'] ?? []);
     }
 
     /**
      * @return Contact[]
      */
     public function getReplyTo(): array
     {
-        return \array_map([$this, 'parseContact'], $this->getHeader('Reply-To'));
+        return $this->normalizeAddressList($this->getHeader('Reply-To'));
     }
 
     public function getSubject(): string
@@ -189,10 +189,43 @@
 
     private function parseContact(string $line): Contact
     {
-        if (\preg_match('/^\s*(?<name>.*)\s*<(?<email>.*)>\s*$/', $line, $matches) === 1) {
-            return new Contact($matches['name'] ?: null, $matches['email'] ?: null);
+        if (\preg_match('/^\s*+(?<name>.*?)\s*<(?<email>.*)>\s*$/', $line, $matches) === 1) {
+            $name = match (true) {
+                \preg_match('/^".*?"$/', $matches['name']) === 1 => \str_replace('\\"', '"', \substr($matches['name'], 1, -1)),
+                $matches['name'] === '' => null,
+                default => $matches['name'],
+            };
+
+            return new Contact(
+                $name,
+                $matches['email'] === '' ? null : \trim($matches['email']),
+            );
         }
 
         return new Contact(null, $line);
     }
+
+    /**
+     * @return array<Contact>
+     */
+    private function parseDestinationAddress(string $line): array
+    {
+        // if this is a group recipient
+        if (\preg_match('/^[^"]+:(.*);$/', $line, $matches) === 1) {
+            $line = $matches[1];
+        }
+
+        $emailList = \array_map('trim', \explode(',', $line));
+        return \array_map([$this, 'parseContact'], $emailList);
+    }
+
+    /**
+     * @return array<Contact>
+     */
+    private function normalizeAddressList(array $param): array
+    {
+        return \array_merge(
+            ...\array_map([$this, 'parseDestinationAddress'], $param),
+        );
+    }
 }

tests/Unit/Sender/MailToFileSenderTest.php

@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Buggregator\Trap\Tests\Unit\Sender;
+
+use Buggregator\Trap\Info;
+use Buggregator\Trap\Proto\Frame\Smtp as SmtpFrame;
+use Buggregator\Trap\Sender\MailToFileSender;
+use Buggregator\Trap\Traffic\Message\Smtp as SmtpMessage;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * @coversDefaultClass \Buggregator\Trap\Sender\MailToFileSender
+ */
+final class MailToFileSenderTest extends TestCase
+{
+    /** @var list<non-empty-string> */
+    private array $cleanupFolders = [];
+
+    public function testForSmtp(): void
+    {
+        $this->cleanupFolders[] = $root = Info::TRAP_ROOT . '/runtime/tests/mail-to-file-sender';
+
+        $message = SmtpMessage::create(
+            protocol: [
+                'FROM' => ['<[email protected]>'],
+                'BCC' => [
+                    '<[email protected]>',
+                    '<[email protected]>',
+                ],
+            ],
+            headers: [
+                'From' => ['Some User <[email protected]>'],
+                'To' => [
+                    'User1 <[email protected]>',
+                    '[email protected]',
+                    'User without email', // no email
+                    'User3 <[email protected]>, User4 <[email protected]>, [email protected]',
+                ],
+                'Subject' => ['Very important theme'],
+                'Content-Type' => ['text/plain'],
+            ],
+        );
+        $frame = new SmtpFrame($message);
+        $sender = new MailToFileSender($root);
+        $sender->send([$frame]);
+
+        $this->assertRecipient("$root/[email protected]");
+        $this->assertRecipient("$root/[email protected]");
+        $this->assertRecipient("$root/[email protected]");
+        $this->assertRecipient("$root/[email protected]");
+        $this->assertRecipient("$root/[email protected]");
+    }
+
+    protected function tearDown(): void
+    {
+        foreach ($this->cleanupFolders as $folder) {
+            \array_map('unlink', \glob("$folder/*/*.*"));
+            \array_map('rmdir', \glob("$folder/*"));
+            \rmdir($folder);
+        }
+    }
+
+    private function assertRecipient(string $folder): void
+    {
+        self::assertDirectoryExists($folder);
+        $files = \glob(\str_replace('[', '[[]', "$folder/*.json"));
+        self::assertCount(1, $files);
+        $arr = \json_decode(\file_get_contents($files[0]), true, \JSON_THROW_ON_ERROR);
+        self::assertArrayHasKey('protocol', $arr);
+        self::assertArrayHasKey('headers', $arr);
+        self::assertArrayHasKey('messages', $arr);
+        self::assertArrayHasKey('attachments', $arr);
+    }
+}