refactor: clarify config $from property

Author: innocenzi

packages/mailer/src/EmailToSymfonyEmailMapper.php

@@ -43,8 +43,8 @@ public function map(mixed $from, mixed $to): SymfonyEmail
 
         if ($email->envelope->from) {
             $symfonyEmail->from(...$this->convertAddresses($email->envelope->from));
-        } elseif ($this->mailerConfig->from) {
-            $symfonyEmail->from($this->mailerConfig->from);
+        } elseif ($this->mailerConfig->defaultExpeditor) {
+            $symfonyEmail->from($this->mailerConfig->defaultExpeditor);
         } else {
             throw new ExpeditorWasMissing();
         }

packages/mailer/src/MailerConfig.php

@@ -2,12 +2,15 @@
 
 namespace Tempest\Mail;
 
+use Symfony\Component\Mailer\Transport;
 use Symfony\Component\Mailer\Transport\TransportInterface;
 
 interface MailerConfig
 {
     /**
      * The transport class.
+     *
+     * @param class-string<Transport>
      */
     public string $transport {
         get;
@@ -16,7 +19,7 @@ interface MailerConfig
     /**
      * The default address from which emails will be sent.
      */
-    public null|string|Address $from {
+    public null|string|Address $defaultExpeditor {
         get;
     }
 

packages/mailer/src/Transports/Postmark/PostmarkConfig.php

@@ -42,7 +42,7 @@ public function __construct(
         /**
          * Address from which emails are sent by default.
          */
-        public null|string|Address $from = null,
+        public null|string|Address $defaultExpeditor = null,
 
         /**
          * Whether to use Postmark's API or SMTP server.

packages/mailer/src/Transports/Ses/SesMailerConfig.php

@@ -54,7 +54,7 @@ public function __construct(
         /**
          * Address from which emails are sent by default.
          */
-        public null|string|Address $from = null,
+        public null|string|Address $defaultExpeditor = null,
 
         /**
          * Whether to use Amazon SES's API or async HTTP transport.

packages/mailer/src/Transports/Smtp/SmtpMailerConfig.php

@@ -46,7 +46,7 @@ public function __construct(
         /**
          * The default address from which emails will be sent.
          */
-        public null|string|Address $from = null,
+        public null|string|Address $defaultExpeditor = null,
 
         /**
          * Whether to use TLS for this connection.