deliverable 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6939d9e02d7269dc2704b727f9aaf27b2374e271d88c03e48c126bfe6695132a
-  data.tar.gz: e0eca76ecdfc1478bfe3c507555c4b59054ac898a658499a573b86478f87c684
+  metadata.gz: 789cda6bdfbcd5cbd6f552775c78227c1901fba7c7f792e97e9d87f1f0f0411e
+  data.tar.gz: 5d63aee7ce38ad7b098022909a025d688624eef3bfec1f7418085086eac2eb9b
 SHA512:
-  metadata.gz: 101133007279b3c6610dcad60d8c9dcb0a86a8ff9d5f7aa215d29cbe3cba1d0daf53bcd75f32afdc07ac56e154f019fd537dc4b6b15a7f2670cacaa9ae474c58
-  data.tar.gz: d7af7df7bb8ac409e211103eca6851ab63142cc9dc38fece9ae7cd9e3b2d00fea250466c97e8ea69ebc9702712bece6f1e5f0b182b2e42e971bc6adc862c7aba
+  metadata.gz: b1ec53c65f23b78024ef0b4ef4741f8cd55f57f3ab85405ae1376fcb6988220985a1655bcf36ca18996bcfa8e30f63048d6b2a010a9149cc19e8047a0a2a900d
+  data.tar.gz: e663054eba78bfe71a4638e1e07bd098e17850d32d2de5cdebe96bad7721f897c5bcbc05976126a54ed46d52e0d7f0e74baa6e6f7be821f15d19483492faeb98

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.0
+
+- Add `smtp_response` to the result: the SMTP code and message returned by
+  the destination MX (e.g. `{ code: "421", message: "Greylisted, try again" }`).
+  `nil` when no SMTP probe was made or no response was received.
+- Add `retryable` boolean to the result. `true` when the verifier hit a
+  transient signal (4xx response, server-busy, timeout, connection refused, or
+  a transient DNS error) and the result is `risky`. Callers can use this to
+  decide whether to enqueue a follow-up verification.
+
 ## 0.1.0
 
 - Initial release.

data/lib/deliverable/result.rb

@@ -1,8 +1,8 @@
 module Deliverable
   class Result
-    attr_reader :email, :score, :score_details, :errors, :warnings, :checks
+    attr_reader :email, :score, :score_details, :errors, :warnings, :checks, :smtp_response
 
-    def initialize(email:, score:, score_details:, classification:, errors:, warnings:, checks:)
+    def initialize(email:, score:, score_details:, classification:, errors:, warnings:, checks:, smtp_response: nil, retryable: false)
       @email = email
       @score = score
       @score_details = score_details
@@ -10,6 +10,8 @@ module Deliverable
       @errors = errors
       @warnings = warnings
       @checks = checks
+      @smtp_response = smtp_response
+      @retryable = retryable
     end
 
     def valid?
@@ -20,6 +22,11 @@ module Deliverable
       @classification
     end
 
+    def retryable?
+      @retryable
+    end
+    alias_method :retryable, :retryable?
+
     def to_h
       {
         email: @email,
@@ -29,6 +36,8 @@ module Deliverable
         score_details: @score_details,
         errors: @errors,
         warnings: @warnings,
+        retryable: @retryable,
+        smtp_response: @smtp_response,
         checks: @checks
       }
     end

data/lib/deliverable/verifier.rb

@@ -44,18 +44,23 @@ module Deliverable
         accepts_any_email: false
       }
       @accepts_any_email = nil
+      @smtp_response = nil
+      @smtp_retryable = false
     end
 
     def call
       ok = run_checks
       score = calculate_score
+      cls = classification(ok)
       Result.new(
         email: @email,
         score: score,
         score_details: @details.dup,
-        classification: classification(ok),
+        classification: cls,
         errors: @errors,
         warnings: @warnings,
+        smtp_response: @smtp_response,
+        retryable: retryable?(cls),
         checks: {
           syntax: @details[:syntax_valid],
           mx_record: @details[:mx_verified],
@@ -225,18 +230,32 @@ module Deliverable
         smtp.start(@sender_domain) do |conn|
           conn.mailfrom(@sender_email)
           begin
-            conn.rcptto(recipient)
+            response = conn.rcptto(recipient)
+            record_response(response.status, response.message) if response.respond_to?(:status)
             return :verified
           rescue Net::SMTPFatalError => e
+            record_error(e)
             classify_fatal(e.message)
-          rescue Net::SMTPServerBusy, Net::SMTPSyntaxError, Net::SMTPAuthenticationError
+          rescue Net::SMTPServerBusy => e
+            record_error(e, retryable: true)
+            return :assumed
+          rescue Net::SMTPSyntaxError, Net::SMTPAuthenticationError => e
+            record_error(e)
             return :assumed
           end
         end
       end
-    rescue Timeout::Error, Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Errno::ENETUNREACH
+    rescue Timeout::Error => e
+      record_transient(e.message)
+      :connection_failed
+    rescue Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Errno::ENETUNREACH => e
+      record_transient(e.message)
       :connection_failed
-    rescue Net::SMTPAuthenticationError, Net::SMTPServerBusy
+    rescue Net::SMTPAuthenticationError => e
+      record_error(e)
+      :assumed
+    rescue Net::SMTPServerBusy => e
+      record_error(e, retryable: true)
       :assumed
     rescue StandardError => e
       log "SMTP probe failed for #{recipient} on #{mail_server}:#{port}: #{e.message}"
@@ -244,18 +263,40 @@ module Deliverable
     end
 
     def classify_fatal(message)
-      msg = message.to_s.downcase
-      if msg.include?("550") || msg.include?("551") ||
-          msg.include?("user unknown") || msg.include?("recipient unknown") ||
-          msg.include?("mailbox unavailable")
+      code = extract_code(message)
+      case code&.[](0)
+      when "5"
         :invalid
-      elsif msg.include?("421") || msg.include?("450") || msg.include?("451") || msg.include?("temporary")
+      when "4"
+        @smtp_retryable = true
         :assumed
       else
+        if message.to_s.downcase.include?("temporary")
+          @smtp_retryable = true
+        end
         :assumed
       end
     end
 
+    def record_response(code, message)
+      @smtp_response = { code: code.to_s, message: message.to_s.strip }
+    end
+
+    def record_error(err, retryable: false)
+      code = extract_code(err.message)
+      @smtp_response = { code: code, message: err.message.to_s.strip }
+      @smtp_retryable = true if retryable || code&.start_with?("4")
+    end
+
+    def record_transient(message)
+      @smtp_response = { code: nil, message: message.to_s.strip }
+      @smtp_retryable = true
+    end
+
+    def extract_code(message)
+      message.to_s[/\b([45]\d{2})\b/, 1]
+    end
+
     def check_catch_all(mail_server)
       domain = extract_domain
       return unless domain
@@ -367,6 +408,11 @@ module Deliverable
       "valid"
     end
 
+    def retryable?(cls)
+      return false unless cls == "risky"
+      @smtp_retryable || @details[:dns_failed_assumption]
+    end
+
     def log(message)
       @logger&.warn(message)
     end

data/lib/deliverable/version.rb

@@ -1,3 +1,3 @@
 module Deliverable
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: deliverable
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Erik Strömberg
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-01 00:00:00.000000000 Z
+date: 2026-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: valid_email2
@@ -83,6 +84,7 @@ metadata:
   homepage_uri: https://github.com/peopledb/deliverable
   source_code_uri: https://github.com/peopledb/deliverable
   changelog_uri: https://github.com/peopledb/deliverable/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -97,7 +99,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.5.11
+signing_key:
 specification_version: 4
 summary: 'Honest email verification: syntax, MX, SMTP RCPT, and catch-all detection.'
 test_files: []