Decode MIME-encoded names in Address constructor

Author: stevebauman

src/Address.php

@@ -2,6 +2,7 @@
 
 namespace DirectoryTree\ImapEngine;
 
+use DirectoryTree\ImapEngine\Support\Str;
 use Illuminate\Contracts\Support\Arrayable;
 use JsonSerializable;
 
@@ -13,7 +14,9 @@ class Address implements Arrayable, JsonSerializable
     public function __construct(
         protected string $email,
         protected string $name,
-    ) {}
+    ) {
+        $this->name = Str::decodeMimeHeader($this->name);
+    }
 
     /**
      * Get the address's email.

src/Support/Str.php

@@ -260,7 +260,7 @@ public static function toImapUtf7(string $string): string
     /**
      * Determine if a given string matches a given pattern.
      */
-    public static function is(array|string $pattern, string $value, bool $ignoreCase = false)
+    public static function is(array|string $pattern, string $value, bool $ignoreCase = false): bool
     {
         if (! is_iterable($pattern)) {
             $pattern = [$pattern];
@@ -294,4 +294,20 @@ public static function is(array|string $pattern, string $value, bool $ignoreCase
 
         return false;
     }
+
+    /**
+     * Decode MIME-encoded header values.
+     */
+    public static function decodeMimeHeader(string $value): string
+    {
+        if (! str_contains($value, '=?')) {
+            return $value;
+        }
+
+        if ($decoded = iconv_mime_decode($value, ICONV_MIME_DECODE_CONTINUE_ON_ERROR, 'UTF-8')) {
+            return $decoded;
+        }
+
+        return $value;
+    }
 }