Merge pull request #70 from dniccum/master

Adds support for BCC emails.

Author: mpociot

.gitignore

@@ -2,4 +2,5 @@ build
 composer.lock
 vendor
 coverage
-.phpunit.result.cache
+.phpunit.result.cache
+.idea

src/InboundEmail.php

@@ -114,6 +114,14 @@ public function cc(): array
         return $this->convertAddressHeader($this->message()->getHeader('Cc'));
     }
 
+    /**
+     * @return AddressPart[]
+     */
+    public function bcc(): array
+    {
+        return $this->convertAddressHeader($this->message()->getHeader('Bcc'));
+    }
+
     protected function convertAddressHeader($header): array
     {
         if ($header instanceof AddressHeader) {

src/Routing/Route.php

@@ -21,6 +21,7 @@ class Route
     const FROM = 'from';
     const TO = 'to';
     const CC = 'cc';
+    const BCC = 'bcc';
     const SUBJECT = 'subject';
     const FALLBACK = 'fallback';
     const CATCH_ALL = 'catch-all';
@@ -89,6 +90,9 @@ protected function gatherMatchSubjectsFromMessage(InboundEmail $message)
             case self::CC:
                 return $this->convertMessageAddresses($message->cc());
             break;
+            case self::BCC:
+                return $this->convertMessageAddresses($message->bcc());
+                break;
             case self::SUBJECT:
                 return [$message->subject()];
             break;

src/Routing/Router.php

@@ -46,6 +46,11 @@ public function cc(string $pattern, $action): Route
         return $this->addRoute(Route::CC, $pattern, $action);
     }
 
+    public function bcc(string $pattern, $action): Route
+    {
+        return $this->addRoute(Route::BCC, $pattern, $action);
+    }
+
     public function subject(string $pattern, $action): Route
     {
         return $this->addRoute(Route::SUBJECT, $pattern, $action);

tests/MailboxRouteTest.php

@@ -70,6 +70,24 @@ public function it_matches_cc_mails($ccMail, $successfulPattern, $failingPattern
         $this->assertFalse($route->matches($message));
     }
 
+    /**
+     * @test
+     * @dataProvider emailDataProvider
+     */
+    public function it_matches_bcc_mails($bccMail, $successfulPattern, $failingPattern)
+    {
+        $testMail = (new TestMail())
+            ->setBcc($bccMail);
+
+        $message = new InboundEmail(['message' => $testMail->toString()]);
+
+        $route = new Route(Route::BCC, $successfulPattern, 'SomeAction@handle');
+        $this->assertTrue($route->matches($message));
+
+        $route = new Route(Route::BCC, $failingPattern, 'SomeAction@handle');
+        $this->assertFalse($route->matches($message));
+    }
+
     /**
      * @test
      * @dataProvider subjectDataProvider