From e94334b4f192e2c4559ec618d6fc2b1a98047c1a Mon Sep 17 00:00:00 2001
From: David Garcia <david.garcia@deralia.com>
Date: Fri, 8 Dec 2017 01:03:47 +0000
Subject: [PATCH] Provide new Assert to validate an email address

---
 src/Assert.php | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/src/Assert.php b/src/Assert.php
index 19c1b7f..083bf88 100644
--- a/src/Assert.php
+++ b/src/Assert.php
@@ -11,6 +11,10 @@ declare(strict_types=1);
 
 namespace Mailgun;
 
+use Egulias\EmailValidator\EmailValidator;
+use Egulias\EmailValidator\Validation\DNSCheckValidation;
+use Egulias\EmailValidator\Validation\RFCValidation;
+use Egulias\EmailValidator\Validation\SpoofCheckValidation;
 use Mailgun\Exception\InvalidArgumentException;
 
 /**
@@ -20,6 +24,44 @@ use Mailgun\Exception\InvalidArgumentException;
  */
 final class Assert extends \Webmozart\Assert\Assert
 {
+    /**
+     * Validates the given email address.
+     *
+     * @param string $address
+     */
+    public static function email($address)
+    {
+        // Validates the given value as a string with a minimum and maximum length.
+        self::stringNotEmpty($address, 'Email address must be a non-empty string.');
+        self::minLength($address, 3, 'Minimum length for the email address is 3 characters.');
+        self::maxLength($address, 512, 'Maximum length for the email address is 512 chatacters.');
+
+        // Provides an initial email validation based on `egulias/EmailValidator` library
+        $validator = new EmailValidator();
+
+        if (!$validator->isValid($address, new RFCValidation())) {
+            static::reportInvalidArgument(sprintf(
+                'Email address `%s` has thrown an error when processing a RFC Validation',
+                $address
+            ));
+        } elseif (!$validator->isValid($address, new DNSCheckValidation())) {
+            static::reportInvalidArgument(sprintf(
+                'Email address `%s` has thrown an error when processing a DNS Check Validation',
+                $address
+            ));
+        } elseif (!$validator->isValid($address, new SpoofCheckValidation())) {
+            static::reportInvalidArgument(sprintf(
+                'Email address `%s` has thrown an error when processing a Spoof Check Validation',
+                $address
+            ));
+        }
+    }
+
+    /**
+     * Overwrites the existing `reportInvalidArgument` method in order to thrown a Mailgun Exception.
+     *
+     * @param string $message
+     */
     protected static function reportInvalidArgument($message)
     {
         throw new InvalidArgumentException($message);