Add initial draft of ReplyTo feature

Author: marickvantuil

.gitignore

@@ -2,4 +2,5 @@
 vendor/
 .DS_Store
 composer.lock
-.phpunit.result.cache
+.phpunit.result.cache
+.phpunit.cache

README.md

@@ -109,6 +109,17 @@ Email::compose()
     ->bcc(['[email protected]', '[email protected]']);
 ```
 
+### Reply-To
+
+```php
+<?php
+
+use Stackkit\LaravelDatabaseEmails\Email;
+
+Email::compose()
+    ->replyTo(['[email protected]', '[email protected]']);
+```
+
 ### Using mailables
 
 You may also pass a mailable to the e-mail composer.

composer.json

@@ -54,6 +54,9 @@
         "l6": [
             "composer require laravel/framework:8.* orchestra/testbench:6.* --no-interaction --no-update",
             "composer update --prefer-stable --prefer-dist --no-interaction"
+        ],
+        "test": [
+            "CI_DB_DRIVER=sqlite CI_DB_DATABASE=:memory: phpunit"
         ]
     }
 }

database/migrations/2021_12_02_21000_add_reply_to_to_emails_table.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+class AddReplyToToEmailsTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::table('emails', function (Blueprint $table) {
+            $table->binary('reply_to')->nullable()->after('bcc');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        //
+    }
+}

src/Email.php

@@ -15,6 +15,7 @@
  * @property $from
  * @property $cc
  * @property $bcc
+ * @property $reply_to
  * @property $subject
  * @property $view
  * @property $variables
@@ -190,6 +191,26 @@ public function getBccAttribute()
         return $this->bcc;
     }
 
+    /**
+     * Get the e-mail reply-to addresses.
+     *
+     * @return array|string
+     */
+    public function getReplyTo()
+    {
+        return $this->reply_to;
+    }
+
+    /**
+     * Get the e-mail reply-to addresses.
+     *
+     * @return array|string
+     */
+    public function getReplyToAttribute()
+    {
+        return $this->reply_to;
+    }
+
     /**
      * Get the e-mail subject.
      *
@@ -388,6 +409,16 @@ public function hasBcc(): bool
         return strlen($this->getRawDatabaseValue('bcc')) > 0;
     }
 
+    /**
+     * Determine if the e-mail should sent with reply-to.
+     *
+     * @return bool
+     */
+    public function hasReplyTo(): bool
+    {
+        return strlen($this->getRawDatabaseValue('reply_to') ?: '') > 0;
+    }
+
     /**
      * Determine if the e-mail is scheduled to be sent later.
      *

src/EmailComposer.php

@@ -139,6 +139,17 @@ public function bcc($bcc): self
         return $this->setData('bcc', $bcc);
     }
 
+    /**
+     * Define the reply-to address(es).
+     *
+     * @param string|array $replyTo
+     * @return self
+     */
+    public function replyTo($replyTo): self
+    {
+        return $this->setData('reply_to', $replyTo);
+    }
+
     /**
      * Set the e-mail subject.
      *

src/Encrypter.php

@@ -17,6 +17,8 @@ public function encrypt(EmailComposer $composer): void
 
         $this->encryptRecipients($composer);
 
+        $this->encryptReplyTo($composer);
+
         $this->encryptFrom($composer);
 
         $this->encryptSubject($composer);
@@ -36,6 +38,20 @@ private function setEncrypted(EmailComposer $composer): void
         $composer->getEmail()->setAttribute('encrypted', 1);
     }
 
+    /**
+     * Encrypt the e-mail reply-to.
+     *
+     * @param EmailComposer $composer
+     */
+    private function encryptReplyTo(EmailComposer $composer): void
+    {
+        $email = $composer->getEmail();
+
+        $email->fill([
+            'reply_to' => $composer->hasData('reply_to') ? encrypt($email->reply_to) : '',
+        ]);
+    }
+
     /**
      * Encrypt the e-mail addresses of the recipients.
      *

src/HasEncryptedAttributes.php

@@ -18,6 +18,7 @@ trait HasEncryptedAttributes
         'from',
         'cc',
         'bcc',
+        'reply_to',
         'subject',
         'variables',
         'body',
@@ -33,6 +34,7 @@ trait HasEncryptedAttributes
         'from',
         'cc',
         'bcc',
+        'reply_to',
         'variables',
     ];
 

src/MailableReader.php

@@ -34,6 +34,8 @@ public function read(EmailComposer $composer): void
 
         $this->readBcc($composer);
 
+        $this->readReplyTo($composer);
+
         $this->readSubject($composer);
 
         $this->readBody($composer);
@@ -115,6 +117,20 @@ private function readBcc(EmailComposer $composer): void
         $composer->bcc($bcc);
     }
 
+    /**
+     * Read the mailable reply-to to the email composer.
+     *
+     * @param EmailComposer $composer
+     */
+    private function readReplyTo(EmailComposer $composer): void
+    {
+        $replyTo = $this->convertMailableAddresses(
+            $composer->getData('mailable')->replyTo
+        );
+
+        $composer->replyTo($replyTo);
+    }
+
     /**
      * Read the mailable subject to the email composer.
      *

src/Preparer.php

@@ -25,6 +25,8 @@ public function prepare(EmailComposer $composer): void
 
         $this->prepareBcc($composer);
 
+        $this->prepareReplyTo($composer);
+
         $this->prepareSubject($composer);
 
         $this->prepareView($composer);
@@ -118,6 +120,18 @@ private function prepareBcc(EmailComposer $composer): void
         ]);
     }
 
+    /**
+     * Prepare the reply-to for database storage.
+     *
+     * @param EmailComposer $composer
+     */
+    private function prepareReplyTo(EmailComposer $composer): void
+    {
+        $composer->getEmail()->fill([
+            'reply_to' => json_encode($composer->getData('reply_to', [])),
+        ]);
+    }
+
     /**
      * Prepare the subject for database storage.
      *