fix: drop laminas-mail dev dep for PHP 8.4, clarify README testing

- Replace Laminas test MIME builder with TestMimeMessage helper
- Restructure README Testing/Changelog out from under Herd section
- Note zbateson/mail-mime-parser as inbound parser in Testing section

Made-with: Cursor

Author: mechelon

README.md

@@ -36,14 +36,15 @@ The email service organizes emails into distinct inboxes for each application, e
 
 ![image](https://github.com/user-attachments/assets/6417907c-119d-43ac-9cf6-5638bafae24f)
 
+## Testing
 
-### Testing
+Inbound messages are parsed with [zbateson/mail-mime-parser](https://mail-mime-parser.org) (see the docs on [handling inbound email](https://docs.beyondco.de/laravel-mailbox/basic-usage/handling)). Run the package test suite with:
 
-``` bash
+```bash
 composer test
 ```
 
-### Changelog
+## Changelog
 
 Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
 

composer.json

@@ -26,7 +26,6 @@
         "zbateson/mail-mime-parser": "^2.4|^3.0|^4.0"
     },
     "require-dev": {
-        "laminas/laminas-mail": "^2.13",
         "mockery/mockery": "^1.2",
         "orchestra/testbench": "^8.0|^9.0|^10.0|^11.0",
         "phpunit/phpunit": "^10.5|^11.0|^12.0"

tests/MailboxRouteCollectionTest.php

@@ -5,7 +5,6 @@
 use BeyondCode\Mailbox\InboundEmail;
 use BeyondCode\Mailbox\Routing\Route;
 use BeyondCode\Mailbox\Routing\RouteCollection;
-use Laminas\Mail\Message as TestMail;
 use PHPUnit\Framework\Attributes\Test;
 
 class MailboxRouteCollectionTest extends TestCase
@@ -19,7 +18,7 @@ public function it_returns_all_matching_mailbox_routes()
         $collection->add(new Route(Route::FROM, '{from}@beyondco.de', ''));
         $collection->add(new Route(Route::FROM, 'different@laravel.com', ''));
 
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setFrom('hello@beyondco.de');
 
         $message = new InboundEmail(['message' => $testMail->toString()]);

tests/MailboxRouteTest.php

@@ -4,7 +4,6 @@
 
 use BeyondCode\Mailbox\InboundEmail;
 use BeyondCode\Mailbox\Routing\Route;
-use Laminas\Mail\Message as TestMail;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
 
@@ -22,7 +21,7 @@ public static function emailDataProvider()
     #[DataProvider('emailDataProvider')]
     public function it_matches_from_mails($fromMail, $successfulPattern, $failingPattern)
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setFrom($fromMail);
 
         $message = new InboundEmail(['message' => $testMail->toString()]);
@@ -38,7 +37,7 @@ public function it_matches_from_mails($fromMail, $successfulPattern, $failingPat
     #[DataProvider('emailDataProvider')]
     public function it_matches_to_mails($toMail, $successfulPattern, $failingPattern)
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setTo($toMail);
 
         $message = new InboundEmail(['message' => $testMail->toString()]);
@@ -54,7 +53,7 @@ public function it_matches_to_mails($toMail, $successfulPattern, $failingPattern
     #[DataProvider('emailDataProvider')]
     public function it_matches_cc_mails($ccMail, $successfulPattern, $failingPattern)
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setCc($ccMail);
 
         $message = new InboundEmail(['message' => $testMail->toString()]);
@@ -70,7 +69,7 @@ public function it_matches_cc_mails($ccMail, $successfulPattern, $failingPattern
     #[DataProvider('emailDataProvider')]
     public function it_matches_bcc_mails($bccMail, $successfulPattern, $failingPattern)
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setBcc($bccMail);
 
         $message = new InboundEmail(['message' => $testMail->toString()]);
@@ -86,7 +85,7 @@ public function it_matches_bcc_mails($bccMail, $successfulPattern, $failingPatte
     #[DataProvider('subjectDataProvider')]
     public function it_matches_subjects($subject, $successfulPattern, $failingPattern)
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setSubject($subject);
 
         $message = new InboundEmail(['message' => $testMail->toString()]);
@@ -101,7 +100,7 @@ public function it_matches_subjects($subject, $successfulPattern, $failingPatter
     #[Test]
     public function it_matches_requirements()
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setFrom('abc@domain.com');
 
         $message = new InboundEmail(['message' => $testMail->toString()]);
@@ -150,7 +149,7 @@ public function it_returns_parameter_names()
     #[Test]
     public function it_returns_parameter_values()
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setFrom('my-email@foo.com')
             ->setSubject('ABC/DEF/GEH');
 
@@ -190,7 +189,7 @@ public function it_returns_parameter_values()
     #[Test]
     public function it_runs_callables()
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setFrom('marcel@beyondco.de');
 
         $message = new InboundEmail(['message' => $testMail->toString()]);
@@ -207,7 +206,7 @@ public function it_runs_callables()
     #[Test]
     public function it_passes_parameters_to_callables()
     {
-        $testMail = (new TestMail())
+        $testMail = (new TestMimeMessage())
             ->setFrom('marcel@beyondco.de');
 
         $message = new InboundEmail(['message' => $testMail->toString()]);

tests/TestMimeMessage.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace BeyondCode\Mailbox\Tests;
+
+/** Builds minimal MIME strings for route tests (inbound parsing uses zbateson/mail-mime-parser). */
+final class TestMimeMessage
+{
+    /** @var array<string, string> */
+    private array $headers = [];
+
+    public function setFrom(string $email): self
+    {
+        $this->headers['From'] = $email;
+
+        return $this;
+    }
+
+    public function setTo(string $email): self
+    {
+        $this->headers['To'] = $email;
+
+        return $this;
+    }
+
+    public function setCc(string $email): self
+    {
+        $this->headers['Cc'] = $email;
+
+        return $this;
+    }
+
+    public function setBcc(string $email): self
+    {
+        $this->headers['Bcc'] = $email;
+
+        return $this;
+    }
+
+    public function setSubject(string $subject): self
+    {
+        $this->headers['Subject'] = $subject;
+
+        return $this;
+    }
+
+    public function toString(): string
+    {
+        $lines = [];
+        foreach (['From', 'To', 'Cc', 'Bcc', 'Subject'] as $name) {
+            if (isset($this->headers[$name])) {
+                $lines[] = $name.': '.$this->headers[$name];
+            }
+        }
+        $lines[] = 'MIME-Version: 1.0';
+        $lines[] = 'Content-Type: text/plain; charset=UTF-8';
+        $lines[] = '';
+        $lines[] = '';
+
+        return implode("\r\n", $lines);
+    }
+}