refactor: rename expeditor to sender

Author: innocenzi

packages/mailer/src/EmailToSymfonyEmailMapper.php

@@ -6,8 +6,8 @@
 
 use Symfony\Component\Mime\Address as SymfonyAddress;
 use Symfony\Component\Mime\Email as SymfonyEmail;
-use Tempest\Mail\Exceptions\ExpeditorWasMissing;
 use Tempest\Mail\Exceptions\RecipientWasMissing;
+use Tempest\Mail\Exceptions\SenderWasMissing;
 use Tempest\Mapper\Mapper;
 use Tempest\Support\Arr;
 use Tempest\View\View;
@@ -43,10 +43,10 @@ public function map(mixed $from, mixed $to): SymfonyEmail
 
         if ($email->envelope->from) {
             $symfonyEmail->from(...$this->convertAddresses($email->envelope->from));
-        } elseif ($this->mailerConfig->defaultExpeditor) {
-            $symfonyEmail->from($this->mailerConfig->defaultExpeditor);
+        } elseif ($this->mailerConfig->defaultSender) {
+            $symfonyEmail->from($this->mailerConfig->defaultSender);
         } else {
-            throw new ExpeditorWasMissing();
+            throw new SenderWasMissing();
         }
 
         if ($email->envelope->to) {

packages/mailer/src/Exceptions/ExpeditorWasMissing.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Tempest\Mail\Exceptions;
+
+use Exception;
+
+final class SenderWasMissing extends Exception implements MailerException
+{
+    public function __construct()
+    {
+        parent::__construct('No sender address provided.');
+    }
+}

packages/mailer/src/Exceptions/SenderWasMissing.php

@@ -19,7 +19,7 @@ interface MailerConfig
     /**
      * The default address from which emails will be sent.
      */
-    public null|string|Address $defaultExpeditor {
+    public null|string|Address $defaultSender {
         get;
     }
 

packages/mailer/src/MailerConfig.php

@@ -87,7 +87,7 @@ public function assertFrom(string|array $addresses): self
         return $this->assertAddressListContains(
             haystack: $this->symfonyEmail->getFrom(),
             needles: $addresses,
-            message: 'Failed asserting that the email was sent from [%s]. The expeditors are [%s].',
+            message: 'Failed asserting that the email was sent from [%s]. The senders are [%s].',
         );
     }
 
@@ -99,7 +99,7 @@ public function assertNotFrom(string|array $addresses): self
         return $this->assertAddressListDoesNotContain(
             haystack: $this->symfonyEmail->getFrom(),
             needles: $addresses,
-            message: 'Failed asserting that the email was not sent from [%s]. The expeditors are [%s].',
+            message: 'Failed asserting that the email was not sent from [%s]. The senders are [%s].',
         );
     }
 

packages/mailer/src/Testing/SentTestingEmail.php

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

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

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

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

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

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

@@ -4,8 +4,8 @@
 
 use Tempest\Mail\Content;
 use Tempest\Mail\Envelope;
-use Tempest\Mail\Exceptions\ExpeditorWasMissing;
 use Tempest\Mail\Exceptions\RecipientWasMissing;
+use Tempest\Mail\Exceptions\SenderWasMissing;
 use Tempest\Mail\GenericEmail;
 use Tempest\Mail\Mailer;
 use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
@@ -18,7 +18,7 @@ final class MailerTest extends FrameworkIntegrationTestCase
 
     public function test_sending_mail_requires_from(): void
     {
-        $this->expectException(ExpeditorWasMissing::class);
+        $this->expectException(SenderWasMissing::class);
 
         $this->mailer->send(new GenericEmail(
             envelope: new Envelope(