[feature][BC BREAK] SentEmails is now a collection of TestEmail's

src/SentEmailMixin.php

@@ -53,9 +53,9 @@ public function assertEmailSentTo(string $expectedTo, $callback): self
             if (\in_array($expectedTo, $toAddresses, true)) {
                 // address matches
                 Callback::createFor($callback)->invoke(Parameter::union(
-                    Parameter::untyped(Parameter::factory(fn() => new TestEmail($email))),
-                    Parameter::typed(Email::class, $email),
-                    Parameter::typed(TestEmail::class, Parameter::factory(fn(string $class) => new $class($email)))
+                    Parameter::untyped($email),
+                    Parameter::typed(Email::class, $email->inner()),
+                    Parameter::typed(TestEmail::class, Parameter::factory(fn(string $class) => $email->as($class)))
                 ));
 
                 return $this;

src/SentEmails.php

@@ -13,10 +13,10 @@
  */
 final class SentEmails implements \IteratorAggregate, \Countable
 {
-    /** @var Email[] */
+    /** @var TestEmail[] */
     private array $emails;
 
-    public function __construct(Email ...$emails)
+    public function __construct(TestEmail ...$emails)
     {
         $this->emails = $emails;
     }
@@ -45,15 +45,30 @@ public static function fromEvents(MessageEvents $events): self
         // remove non Email messages
         $messages = \array_filter($messages, static fn(RawMessage $message) => $message instanceof Email);
 
+        // convert to TestEmails
+        $messages = \array_map(static fn(Email $email) => new TestEmail($email), $messages);
+
         return new self(...$messages);
     }
 
+    /**
+     * @template T
+     *
+     * @param class-string $class
+     *
+     * @return TestEmail[]|T[]
+     */
+    public function all(string $class = TestEmail::class): array
+    {
+        return \array_map(static fn(TestEmail $email) => $email->as($class), $this->emails);
+    }
+
     /**
      * @return Email[]
      */
-    public function all(): array
+    public function raw(): array
     {
-        return $this->emails;
+        return \array_map(static fn(TestEmail $email) => $email->inner(), $this->emails);
     }
 
     public function assertCount(int $expected): self
@@ -80,7 +95,7 @@ public function ensureSome(): self
     }
 
     /**
-     * @return \Traversable|Email[]
+     * @return \Traversable|TestEmail[]
      */
     public function getIterator(): \Traversable
     {

src/TestEmail.php

@@ -26,6 +26,31 @@ final public function __call($name, $arguments)
         return $this->email->{$name}(...$arguments);
     }
 
+    /**
+     * @template T
+     *
+     * @param class-string $class
+     *
+     * @return T
+     */
+    final public function as(string $class): self
+    {
+        if (self::class === $class) {
+            return $this;
+        }
+
+        if (!\is_a($class, self::class, true)) {
+            throw new \InvalidArgumentException(\sprintf('$class must be a class that\'s an instance of "%s".', self::class));
+        }
+
+        return new $class($this->inner());
+    }
+
+    final public function inner(): Email
+    {
+        return $this->email;
+    }
+
     /**
      * @return string|null The first {@see TagHeader} value found or null if none
      */

tests/InteractsWithMailerTest.php

@@ -128,7 +128,7 @@ public function can_access_sent_test_emails(string $environment): void
 
         self::$container->get('mailer')->send(new Email1());
 
-        $this->assertInstanceOf(TestEmail::class, $this->mailer()->sentTestEmails()[0]);
+        $this->assertInstanceOf(TestEmail::class, $this->mailer()->sentEmails()->all()[0]);
     }
 
     /**
@@ -141,7 +141,7 @@ public function can_access_sent_test_emails_with_custom_test_email_class(string
 
         self::$container->get('mailer')->send(new Email1());
 
-        $this->assertInstanceOf(CustomTestEmail::class, $this->mailer()->sentTestEmails(CustomTestEmail::class)[0]);
+        $this->assertInstanceOf(CustomTestEmail::class, $this->mailer()->sentEmails()->all(CustomTestEmail::class)[0]);
     }
 
     /**