sisimai 5.0.3 → 5.2.0

data/lib/sisimai/rhost/gsuite.rb

@@ -0,0 +1,42 @@
+module Sisimai
+  module Rhost
+    # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument
+    # of find() method when the value of "rhost" of the object is "*.googlemail.com". This class is
+    # called only from Sisimai::Fact class.
+    module GSuite
+      class << self
+        MessagesOf = {
+          "hostunknown"  => [" responded with code NXDOMAIN", "Domain name not found"],
+          "networkerror" => [" had no relevant answers.", "responded with code NXDOMAIN", "Domain name not found"],
+          "notaccept"    => ["Null MX"],
+          "userunknown"  => ["because the address couldn't be found. Check for typos or unnecessary spaces and try again."],
+        }.freeze
+
+        # Detect bounce reason from Gsuite Mail: https://www.aol.com
+        # @param    [Sisimai::Fact] argvs   Decoded email object
+        # @return   [String]                The bounce reason for Gsuite
+        # @since v5.2.0
+        def find(argvs)
+          return "" if argvs["diagnosticcode"].empty?
+          statuscode = ""; statuscode = argvs["deliverystatus"][0, 1] if argvs["deliverystatus"].empty? == false
+          esmtpreply = ""; esmtpreply = argvs["replycode"][0, 1]      if argvs["replycode"].empty?      == false
+          reasontext = ""
+
+          MessagesOf.each_key do |e|
+            # Try to match the error message with message patterns defined in $MessagesOf
+            next unless MessagesOf[e].any? { |a| argvs["diagnosticcode"].include?(a) }
+            next if e == "networkerror" && (statuscode == "5" || esmtpreply == "5")
+            next if e == "hostunknown"  && (statuscode == "4" || statuscode == "")
+            next if e == "hostunknown"  && (esmtpreply == "4" || esmtpreply == "")
+            reasontext = e
+            break
+          end
+
+          return reasontext
+        end
+
+      end
+    end
+  end
+end
+

data/lib/sisimai/rhost/iua.rb

@@ -1,12 +1,12 @@
 module Sisimai
   module Rhost
     # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument
-    # of get() method when the value of "rhost" of the object is "*.email.ua". This class is called
+    # of find() method when the value of "rhost" of the object is "*.email.ua". This class is called
     # only Sisimai::Fact class.
     module IUA
       class << self
         ErrorCodes = {
-          # http://mail.i.ua/err/$(CODE)
+          # https://mail.i.ua/err/$(CODE)
           '1'  => 'norelaying',  # The use of SMTP as mail gate is forbidden.
           '2'  => 'userunknown', # User is not found.
           '3'  => 'suspend',     # Mailbox was not used for more than 3 months
@@ -20,10 +20,10 @@ module Sisimai
         }.freeze
 
         # Detect bounce reason from https://www.i.ua/
-        # @param    [Sisimai::Fact] argvs   Parsed email object
+        # @param    [Sisimai::Fact] argvs   Decoded email object
         # @return   [String]                The bounce reason at https://www.i.ua/
-        def get(argvs)
-          return argvs['reason'] unless argvs['reason'].empty?
+        def find(argvs)
+          return "" if argvs["diagnosticcode"].empty?
           issuedcode = argvs['diagnosticcode'].downcase
           codenumber = issuedcode.index('.i.ua/err/') > 0 ? issuedcode[issuedcode.index('/err/') + 5, 2] : 0
           codenumber = codenumber[0, 1] if codenumber.index('/') == 1

data/lib/sisimai/rhost/kddi.rb

@@ -1,25 +1,27 @@
 module Sisimai
   module Rhost
     # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument
-    # of get() method when the value of "rhost" of the object is "lsean.ezweb.ne.jp" or "msmx.au.com".
+    # of find() method when the value of "rhost" of the object is "lsean.ezweb.ne.jp" or "msmx.au.com".
     # This class is called only Sisimai::Fact class.
     module KDDI
       class << self
         MessagesOf = {
-          'filtered'    => '550 : User unknown',  # The response was: 550 : User unknown
-          'userunknown' => '>: User unknown',     # The response was: 550 <...>: User unknown
+          'filtered'    => '550 : user unknown',  # The response was: 550 : User unknown
+          'userunknown' => '>: user unknown',     # The response was: 550 <...>: User unknown
         }.freeze
 
         # Detect bounce reason from au (KDDI)
-        # @param    [Sisimai::Fact] argvs   Parsed email object
+        # @param    [Sisimai::Fact] argvs   Decoded email object
         # @return   [String]                The bounce reason for au.com or ezweb.ne.jp
-        def get(argvs)
-          statusmesg = argvs['diagnosticcode']
+        # @since v4.22.6
+        def find(argvs)
+          return "" if argvs["diagnosticcode"].empty?
+          issuedcode = argvs['diagnosticcode'].downcase
           reasontext = ''
 
           MessagesOf.each_key do |e|
             # Try to match the error message with message patterns defined in $MessagesOf
-            next unless statusmesg.include?(MessagesOf[e])
+            next unless issuedcode.include?(MessagesOf[e])
             reasontext = e
             break
           end

data/lib/sisimai/rhost/messagelabs.rb

@@ -0,0 +1,37 @@
+module Sisimai
+  module Rhost
+    # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument
+    # of find() method when the value of "rhost" of the object is "*.messagelabs.com". This class is
+    # called only from Sisimai::Fact class.
+    module MessageLabs
+      class << self
+        MessagesOf = {
+          "securityerror" => ["Please turn on SMTP Authentication in your mail client"],
+          "userunknown"   => ["542 ", " Rejected", "No such user"],
+        }.freeze
+
+        # Detect bounce reason from Email Security (formerly MessageLabs.com)
+        # @param    [Sisimai::Fact] argvs   Decoded email object
+        # @return   [String]                The bounce reason for MessageLabs
+        # @see https://www.broadcom.com/products/cybersecurity/email
+        # @since v5.2.0
+        def find(argvs)
+          return "" if argvs["diagnosticcode"].empty?
+          issuedcode = argvs["diagnosticcode"]
+          reasontext = ""
+
+          MessagesOf.each_key do |e|
+            # Try to match the error message with message patterns defined in $MessagesOf
+            next unless MessagesOf[e].any? { |a| issuedcode.include?(a) }
+            reasontext = e
+            break
+          end
+
+          return reasontext
+        end
+
+      end
+    end
+  end
+end
+

data/lib/sisimai/rhost/microsoft.rb

@@ -1,7 +1,7 @@
 module Sisimai
   module Rhost
     # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument
-    # of get() method when the value of "rhost" of the object is *.protection.outlook.com. This class
+    # of find() method when the value of "rhost" of the object is *.protection.outlook.com. This class
     # is called only Sisimai::Fact class.
     #
     # https://technet.microsoft.com/en-us/library/bb232118
@@ -16,43 +16,10 @@ module Sisimai
             # - The sending message sent over IPv6 must pass either SPF or DKIM.
             ['4.7.26', 0, 0, 'must pass either spf or dkim validation, this message is not signed'],
 
-            # - Records are DNSSEC authentic, but one or multiple of these scenarios occurred:
-            #   - The destination mail server's certificate doesn't match with what is expected per
-            #     the authentic TLSA record.
-            #   - Authentic TLSA record is misconfigured.
-            #   - Destination domain is being attacked.
-            #   - Any other DANE failure.
-            # - This message usually indicates an issue on the destination email server. Check the
-            #   validity of recipient address and determine if the destination server is configured
-            #   correctly to receive messages. 
-            # - For more information about DANE, see: https://datatracker.ietf.org/doc/html/rfc7671
-            ['4.7.323', 0, 0, 'tlsa-invalid: The domain failed dane validation'],
-            ['5.7.323', 0, 0, 'tlsa-invalid: The domain failed dane validation'],
-
-            # - The destination domain indicated it was DNSSEC-authentic, but Exchange Online was 
-            #   not able to verify it as DNSSEC-authentic.
-            ['4.7.324', 0, 0, 'dnssec-invalid: destination domain returned invalid dnssec records'],
-            ['5.7.324', 0, 0, 'dnssec-invalid: destination domain returned invalid dnssec records'],
-
-            # - This happens when the presented certificate identities (CN and SAN) of a destina-
-            #   tion SMTP target host don't match any of the domains or MX host.
-            # - This message usually indicates an issue on the destination email server. Check the
-            #   validity of recipient address and determine if the destination server is configured
-            #   correctly to receive messages. For more information, see How SMTP DNS-based Authen-
-            #   tication of Named Entities (DANE) works to secure email communications.
-            ['4.7.325', 0, 0, 'certificate-host-mismatch: remote certificate must have a common name or subject alternative name matching the hostname (dane)'],
-            ['5.7.325', 0, 0, 'certificate-host-mismatch: remote certificate must have a common name or subject alternative name matching the hostname (dane)'],
-
             # - The destination email system uses SPF to validate inbound mail, and there's a prob-
             #   lem with your SPF configuration.
             ['5.7.23', 0, 0, 'the message was rejected because of sender policy framework violation'],
 
-            # - DNSSEC checks have passed, yet upon establishing the connection the destination
-            #   mail server provides a certificate that is expired.
-            # - A valid X.509 certificate that isn't expired must be presented. X.509 certificates
-            #   must be renewed after their expiration, commonly annually.
-            ['5.7.322', 0, 0, "certificate-expired: destination mail server's certificate is expired"],
-
             # - Access denied, sending domain [$SenderDomain] does not pass DMARC verification
             # - The sender's domain in the 5322.From address doesn't pass DMARC.
             ['5.7.509', 0, 0, 'does not pass dmarc verification'],
@@ -136,7 +103,6 @@ module Sisimai
 
             # Previous versions of Exchange Server ------------------------------------------------
             ['5.5.4',  0, 0, 'invalid domain name'],
-            ['5.7.51', 0, 0, 'restrictdomainstoipaddresses or restrictdomainstocertificate'],
 
             # Undocumented error messages ---------------------------------------------------------
             # - 550 5.7.1 Unfortunately, messages from [10.0.2.5] weren't sent. Please contact your
@@ -216,6 +182,53 @@ module Sisimai
             #   couldn't be delivered to the original sender.
             ['5.4.300', 0, 0, 'message expired'],
           ],
+          'failedstarttls' => [
+            # Exchange Online ---------------------------------------------------------------------
+            # - DNSSEC checks have passed, yet upon connection, destination mail server doesn't re-
+            #   spond to the STARTTLS command. The destination server responds to the STARTTLS com-
+            #   mand, but the TLS handshake fails.
+            # - This message usually indicates an issue on the destination email server. Check the
+            #   validity of the recipient address. Determine if the destination server is configur-
+            #   ed correctly to receive the messages.
+            ['4.4.317', 0, 0, 'starttls is required to send mail'],
+            ['5.4.317', 0, 0, 'starttls is required to send mail'],
+
+            # - DNSSEC checks have passed, yet upon establishing the connection the destination
+            #   mail server provides a certificate that is expired.
+            # - A valid X.509 certificate that isn't expired must be presented. X.509 certificates
+            #   must be renewed after their expiration, commonly annually.
+            ['5.7.51',  0, 0, 'restrictdomainstoipaddresses or restrictdomainstocertificate'],
+            ['4.7.321', 0, 0, 'starttls-not-supported: destination mail server must support tls to receive mail'],
+            ['5.7.321', 0, 0, 'starttls-not-supported: destination mail server must support tls to receive mail'],
+            ['5.7.322', 0, 0, "certificate-expired: destination mail server's certificate is expired"],
+
+            # - Records are DNSSEC authentic, but one or multiple of these scenarios occurred:
+            #   - The destination mail server's certificate doesn't match with what is expected per
+            #     the authentic TLSA record.
+            #   - Authentic TLSA record is misconfigured.
+            #   - Destination domain is being attacked.
+            #   - Any other DANE failure.
+            # - This message usually indicates an issue on the destination email server. Check the
+            #   validity of recipient address and determine if the destination server is configured
+            #   correctly to receive messages. 
+            # - For more information about DANE, see: https://datatracker.ietf.org/doc/html/rfc7671
+            ['4.7.323', 0, 0, 'tlsa-invalid: The domain failed dane validation'],
+            ['5.7.323', 0, 0, 'tlsa-invalid: The domain failed dane validation'],
+
+            # - The destination domain indicated it was DNSSEC-authentic, but Exchange Online was 
+            #   not able to verify it as DNSSEC-authentic.
+            ['4.7.324', 0, 0, 'dnssec-invalid: destination domain returned invalid dnssec records'],
+            ['5.7.324', 0, 0, 'dnssec-invalid: destination domain returned invalid dnssec records'],
+
+            # - This happens when the presented certificate identities (CN and SAN) of a destina-
+            #   tion SMTP target host don't match any of the domains or MX host.
+            # - This message usually indicates an issue on the destination email server. Check the
+            #   validity of recipient address and determine if the destination server is configured
+            #   correctly to receive messages. For more information, see How SMTP DNS-based Authen-
+            #   tication of Named Entities (DANE) works to secure email communications.
+            ['4.7.325', 0, 0, 'certificate-host-mismatch: remote certificate must have a common name or subject alternative name matching the hostname (dane)'],
+            ['5.7.325', 0, 0, 'certificate-host-mismatch: remote certificate must have a common name or subject alternative name matching the hostname (dane)'],
+          ],
           'mailboxfull' => [
             # Exchange Server 2019 ----------------------------------------------------------------
             # - The recipient's mailbox has exceeded its storage quota and is no longer able to ac-
@@ -328,6 +341,7 @@ module Sisimai
           ],
           'notaccept' => [
             ['4.3.2', 0, 0, 'system not accepting network messages'],
+            ['4.4.4', 0, 0, 'hosted tenant which has no mail-enabled subscriptions'],
 
             # Exchange Server 2019 ----------------------------------------------------------------
             # - You're using the ABP Routing agent, and the recipient isn't a member of the global
@@ -448,19 +462,6 @@ module Sisimai
             ['5.7.3', 0, 0, 'cannot achieve exchange server authentication'],
             ['5.7.3', 0, 0, 'not authorized'],
 
-            # Exchange Online ---------------------------------------------------------------------
-            # - DNSSEC checks have passed, yet upon connection, destination mail server doesn't re-
-            #   spond to the STARTTLS command. The destination server responds to the STARTTLS com-
-            #   mand, but the TLS handshake fails.
-            # - This message usually indicates an issue on the destination email server. Check the
-            #   validity of the recipient address. Determine if the destination server is configur-
-            #   ed correctly to receive the messages.
-            ['4.4.317', 0, 0, 'starttls is required to send mail'],
-            ['5.4.317', 0, 0, 'starttls is required to send mail'],
-
-            ['4.7.321', 0, 0, 'starttls-not-supported: destination mail server must support tls to receive mail'],
-            ['5.7.321', 0, 0, 'starttls-not-supported: destination mail server must support tls to receive mail'],
-
             # - The sending email system didn't authenticate with the receiving email system. The
             #   receiving email system requires authentication before message submission.
             # - This error occurs when the receiving server must be authenticated before message
@@ -644,6 +645,12 @@ module Sisimai
             #   envelope recipients into smaller chunks (chunking) and resend the message.
             ['4.5.3', 0, 0, 'too many recipients'],
 
+            # - 451 4.7.652 The mail server [192.0.2.251] has exceeded the maximum number of
+            #   connections. (S3115) [Name=Protocol Filter Agent][AGT=PFA][MxId=11BA9B3FA168ABBF]
+            #   [BN3PEPF0000B370.namprd21.prod.outlook.com 2025-02-20T14:30:32.425Z 08DD4D9FD5AFF45C]
+            #   (in reply to MAIL FROM command))
+            ["4.7.652", 0, 0, "has exceeded the maximum number of connections"],
+
             # Previous versions of Exchange Server ------------------------------------------------
             ['5.2.122', 0, 0, 'the recipient has exceeded their limit for'],
           ],
@@ -711,16 +718,15 @@ module Sisimai
         }.freeze
 
         # Detect bounce reason from Exchange Server 2019 or older and Exchange Online
-        # @param    [Sisimai::Fact] argvs   Parsed email object
+        # @param    [Sisimai::Fact] argvs   Decoded email object
         # @return   [String]                The bounce reason for Exchange Online
-        def get(argvs)
-          return argvs['reason'] unless argvs['reason'].empty?
-          return '' if argvs['diagnosticcode'].empty?
+        # @since v4.17.2
+        def find(argvs)
           return '' if argvs['deliverystatus'].empty?
           return '' unless Sisimai::SMTP::Status.test(argvs['deliverystatus'])
 
           statuscode = argvs['deliverystatus']
-          esmtperror = argvs['diagnosticcode'].downcase
+          issuedcode = argvs['diagnosticcode'].downcase
           thirddigit = statuscode.split('.')[-1].to_i
           reasontext = ''
 
@@ -738,7 +744,7 @@ module Sisimai
                 next if     thirddigit > f[2]
               end
 
-              next unless esmtperror.include?(f[3])
+              next unless issuedcode.include?(f[3])
               reasontext = e
               break
             end

data/lib/sisimai/rhost/mimecast.rb

@@ -1,7 +1,7 @@
 module Sisimai
   module Rhost
     # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argu-
-    # ment of get() method when the value of "rhost" of the object is "*.mimecast.com". This class
+    # ment of find() method when the value of "rhost" of the object is "*.mimecast.com". This class
     # is called only Sisimai::Fact class.
     module Mimecast
       class << self
@@ -67,6 +67,41 @@ module Sisimai
             #   the associated IP address from the RBL.
             #[550, '< details of RBL >'], NEED AN ACTUAL ERROR MESSAGE STRING
           ],
+          'expired' => [
+            # - Journal messages past the expiration
+            # - Attempts are being made to journal mail past the set expiry threshold.
+            #   A retry response will replace the failure because the message is marked for retry
+            #   if rejected, causing the journal queue to grow.
+            # - Check to confirm there are no significant time discrepancies on the mail server.
+            #   Discontinue journaling old messages past the expiry threshold.
+            [550, 'Journal messages past the expiration'],
+          ],
+          'failedstarttls' => [
+            # - This email has been sent using SMTP, but TLS is required by policy.
+            # - Delete or change the Secure Receipt or Secure Delivery policy enforcing TLS.
+            #   Alternatively, ensure the certificates on the mail server haven't expired. If using
+            #   a proxy server, ensure it isn't intercepting the traffic and modifying encryption
+            #   parameters.
+            [553, 'this route requires encryption (tls)'],
+
+            # - A TLS connection has been attempted using a TLS version that is lower than TLS 1.2.
+            # - Delete or change the Secure Receipt or Secure Delivery policy enforcing TLS.
+            #   Alternatively, ensure the mail server attempting to connect is using the appropri-
+            #   ate version of TLS.
+            [553, 'this route requires tls version 1.2 or greater'],
+
+            # - A secure connection was attempted using ciphers that do not meet the configured ci-
+            #   pher strength.
+            # - Delete or change the Secure Receipt or Secure Delivery policy enforcing TLS. Alter-
+            #   natively, ensure the certificates on the mail server haven't expired. If using a
+            #   proxy server, ensure it isn't intercepting the traffic and modifying encryption
+            #   parameters.
+            [553, 'this route requires high-strength ciphers'],
+
+            # - Validation on your umbrella account's domain name does not conform to your DNS.
+            # - Check you DNS has the required umbrella accounts listed as comma-separated values.
+            [554, 'configuration is invalid for this certificate'],
+          ],
           'mesgtoobig' => [
             # - The email size either exceeds an Email Size Limit policy or is larger than the
             #   Mimecast service limit. The default is 100 MB for the Legacy MTA, and 200 MB for
@@ -96,6 +131,7 @@ module Sisimai
             # - Mimecast customers should contact Mimecast Support to add the Authorized Outbound
             #   address, or to take other remedial action.
             [451, 'open relay not allowed'],
+            [451, 'open relay is not allowed'],
           ],
           'notaccept' => [
             # - The customer account Inbound emails are disabled in the Administration Console.
@@ -133,6 +169,7 @@ module Sisimai
             # - The message has triggered a Geographical Restriction policy.
             # - Delete or amend the policy.
             [554, 'host network not allowed'],
+            [554, 'host network, not allowed'],
           ],
           'rejected' => [
             # - The sender's email address or domain has triggered a Blocked Senders Policy or
@@ -160,31 +197,7 @@ module Sisimai
             #   sage on SMTP port 25.
             [535, 'incorrect authentication data'],
             [550, 'submitter failed to disabled'],
-
-            # - This email has been sent using SMTP, but TLS is required by policy.
-            # - Delete or change the Secure Receipt or Secure Delivery policy enforcing TLS.
-            #   Alternatively, ensure the certificates on the mail server haven't expired. If using
-            #   a proxy server, ensure it isn't intercepting the traffic and modifying encryption
-            #   parameters.
-            [553, 'this route requires encryption (tls)'],
-
-            # - A TLS connection has been attempted using a TLS version that is lower than TLS 1.2.
-            # - Delete or change the Secure Receipt or Secure Delivery policy enforcing TLS.
-            #   Alternatively, ensure the mail server attempting to connect is using the appropri-
-            #   ate version of TLS.
-            [553, 'this route requires tls version 1.2 or greater'],
-
-            # - A secure connection was attempted using ciphers that do not meet the configured ci-
-            #   pher strength.
-            # - Delete or change the Secure Receipt or Secure Delivery policy enforcing TLS. Alter-
-            #   natively, ensure the certificates on the mail server haven't expired. If using a
-            #   proxy server, ensure it isn't intercepting the traffic and modifying encryption
-            #   parameters.
-            [553, 'this route requires high-strength ciphers'],
-
-            # - Validation on your umbrella account's domain name does not conform to your DNS.
-            # - Check you DNS has the required umbrella accounts listed as comma-separated values.
-            [554, 'configuration is invalid for this certificate'],
+            [550, 'submitter failed to authenticate'],
           ],
           'systemerror' => [
             # - The Mimecast server is under maximum load.
@@ -267,13 +280,13 @@ module Sisimai
         }.freeze
 
         # Detect bounce reason from Mimecast
-        # @param    [Sisimai::Fact] argvs   Parsed email object
+        # @param    [Sisimai::Fact] argvs   Decoded email object
         # @return   [String]                The bounce reason for mimecast.com
-        def get(argvs)
+        def find(argvs)
+          return argvs['reason'] unless argvs['reason'].empty?
           return '' unless Sisimai::SMTP::Reply.test(argvs['replycode'])
-          return '' unless argvs['diagnosticcode']
 
-          esmtperror = argvs['diagnosticcode'].downcase || ''
+          issuedcode = argvs['diagnosticcode'].downcase || ''
           esmtpreply = argvs['replycode'].to_i
           reasontext = ''
 
@@ -282,7 +295,7 @@ module Sisimai
             MessagesOf[e].each do |f|
               # Find an error reason
               next unless esmtpreply == f[0]
-              next unless esmtperror.include?(f[1])
+              next unless issuedcode.include?(f[1])
               reasontext = e
               break
             end

data/lib/sisimai/rhost/nttdocomo.rb

@@ -1,7 +1,7 @@
 module Sisimai
   module Rhost
     # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument
-    # of get() method when the value of "rhost" of the object is "mfsmax.docomo.ne.jp". This class
+    # of find() method when the value of "rhost" of the object is "mfsmax.docomo.ne.jp". This class
     # is called only Sisimai::Fact class.
     module NTTDOCOMO
       class << self
@@ -12,11 +12,12 @@ module Sisimai
         }.freeze
 
         # Detect bounce reason from NTT DOCOMO
-        # @param    [Sisimai::Fact] argvs   Parsed email object
+        # @param    [Sisimai::Fact] argvs   Decoded email object
         # @return   [String]                The bounce reason for docomo.ne.jp
-        def get(argvs)
+        def find(argvs)
+          return argvs['reason'] unless argvs['reason'].empty?
           statuscode = argvs['deliverystatus']          || ''
-          thecommand = argvs['smtpcommand']             || ''
+          thecommand = argvs['command']                 || ''
           esmtperror = argvs['diagnosticcode'].downcase || ''
           reasontext = ''
 

data/lib/sisimai/rhost/outlook.rb

@@ -0,0 +1,36 @@
+module Sisimai
+  module Rhost
+    # Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument
+    # of find() method when the value of "rhost" of the object is "*.hotmail.com". This class is called
+    # only from Sisimai::Fact class.
+    module Outlook
+      class << self
+        MessagesOf = {
+          "hostunknown" => ["The mail could not be delivered to the recipient because the domain is not reachable"],
+          "userunknown" => ["Requested action not taken: mailbox unavailable"],
+        }.freeze
+
+        # Detect bounce reason from Microsoft Outlook.com: https://www.outlook.com/
+        # @param    [Sisimai::Fact] argvs   Decoded email object
+        # @return   [String]                The bounce reason for Outlook
+        # @since v5.2.0
+        def find(argvs)
+          return "" if argvs["diagnosticcode"].empty?
+          issuedcode = argvs["diagnosticcode"]
+          reasontext = ""
+
+          MessagesOf.each_key do |e|
+            # Try to match the error message with message patterns defined in $MessagesOf
+            next unless MessagesOf[e].any? { |a| issuedcode.include?(a) }
+            reasontext = e
+            break
+          end
+
+          return reasontext
+        end
+
+      end
+    end
+  end
+end
+