verifalia 1.2.0 → 2.1.0

data/lib/verifalia/email_validation/entry_status.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Verifalia
+  module EmailValidations
+    # Provides values for the supported validation statuses for a job +entry+.
+    module EntryStatus
+      # The at sign symbol (@), used to separate the local part from the domain part of the address, has not been found.
+      AT_SIGN_NOT_FOUND = 'AtSignNotFound'
+
+      # A connection error occurred while verifying the external mail exchanger rejects nonexistent email addresses.
+      CATCH_ALL_CONNECTION_FAILURE = 'CatchAllConnectionFailure'
+
+      # A timeout occurred while verifying fake e-mail address rejection for the mail server.
+      CATCH_ALL_VALIDATION_TIMEOUT = 'CatchAllValidationTimeout'
+
+      # Verification failed because of a socket connection error occurred while querying the DNS server.
+      DNS_CONNECTION_FAILURE = 'DnsConnectionFailure'
+
+      # A timeout has occurred while querying the DNS server(s) for records about the email address domain.
+      DNS_QUERY_TIMEOUT = 'DnsQueryTimeout'
+
+      # The domain of the email address does not exist.
+      DOMAIN_DOES_NOT_EXIST = 'DomainDoesNotExist'
+
+      # The domain has a NULL MX (RFC 7505) resource record and can't thus accept email messages.
+      DOMAIN_HAS_NULL_MX = 'DomainHasNullMx'
+
+      # The domain of the email address does not have any valid DNS record and couldn't accept messages from another
+      # host on the Internet.
+      DOMAIN_IS_MISCONFIGURED = 'DomainIsMisconfigured'
+
+      # The email address is provided by a well-known disposable email address provider (DEA).
+      DOMAIN_IS_WELL_KNOWN_DEA = 'DomainIsWellKnownDea'
+
+      # The domain part of the email address is not compliant with the IETF standards.
+      DOMAIN_PART_COMPLIANCY_FAILURE = 'DomainPartCompliancyFailure'
+
+      # An invalid sequence of two adjacent dots has been found.
+      DOUBLE_DOT_SEQUENCE = 'DoubleDotSequence'
+
+      # The item is a duplicate of another email address in the list.
+      # To find out the entry this item is a duplicate of, check the +duplicate_of+ property for the +entry+  instance which exposes this status code.
+      DUPLICATE = 'Duplicate'
+
+      # The email address has an invalid total length.
+      INVALID_ADDRESS_LENGTH = 'InvalidAddressLength'
+
+      # An invalid character has been detected in the provided sequence.
+      INVALID_CHARACTER_IN_SEQUENCE = 'InvalidCharacterInSequence'
+
+      # An invalid quoted word with no content has been found.
+      INVALID_EMPTY_QUOTED_WORD = 'InvalidEmptyQuotedWord'
+
+      # An invalid folding white space (FWS) sequence has been found.
+      INVALID_FOLDING_WHITE_SPACE_SEQUENCE = 'InvalidFoldingWhiteSpaceSequence'
+
+      # The local part of the e-mail address has an invalid length.
+      INVALID_LOCAL_PART_LENGTH = 'InvalidLocalPartLength'
+
+      # A new word boundary start has been detected at an invalid position.
+      INVALID_WORD_BOUNDARY_START = 'InvalidWordBoundaryStart'
+
+      # The email address is not compliant with the additional syntax rules of the email service provider
+      # which should eventually manage it.
+      ISP_SPECIFIC_SYNTAX_FAILURE = 'IspSpecificSyntaxFailure'
+
+      # The external mail exchanger responsible for the email address under test rejected the local endpoint, probably
+      # because of its own policy rules.
+      LOCAL_END_POINT_REJECTED = 'LocalEndPointRejected'
+
+      # The local part of the email address is a well-known role account.
+      LOCAL_PART_IS_WELL_KNOWN_ROLE_ACCOUNT = 'LocalPartIsWellKnownRoleAccount'
+
+      # The external mail exchanger rejected the validation request.
+      LOCAL_SENDER_ADDRESS_REJECTED = 'LocalSenderAddressRejected'
+
+      # A connection error occurred while validating the mailbox for the e-mail address.
+      MAILBOX_CONNECTION_FAILURE = 'MailboxConnectionFailure'
+
+      # The mailbox for the e-mail address does not exist.
+      MAILBOX_DOES_NOT_EXIST = 'MailboxDoesNotExist'
+
+      # The requested mailbox is currently over quota.
+      MAILBOX_HAS_INSUFFICIENT_STORAGE = 'MailboxHasInsufficientStorage'
+
+      # While both the domain and the mail exchanger for the email address being tested are not from a well-known
+      # disposable email address provider (DEA), the mailbox is actually disposable.
+      MAILBOX_IS_DEA = 'MailboxIsDea'
+
+      # The requested mailbox is temporarily unavailable; it could be experiencing technical issues or some other
+      # transient problem.
+      MAILBOX_TEMPORARILY_UNAVAILABLE = 'MailboxTemporarilyUnavailable'
+
+      # A timeout occurred while verifying the existence of the mailbox.
+      MAILBOX_VALIDATION_TIMEOUT = 'MailboxValidationTimeout'
+
+      # The mail exchanger responsible for the email address under test hides a honeypot / spam trap.
+      MAIL_EXCHANGER_IS_HONEYPOT = 'MailExchangerIsHoneypot'
+
+      # The mail exchanger responsible for the email address is parked / inactive.
+      MAIL_EXCHANGER_IS_PARKED = 'MailExchangerIsParked'
+
+      # The mail exchanger being tested is a well-known disposable email address provider (DEA).
+      MAIL_EXCHANGER_IS_WELL_KNOWN_DEA = 'MailExchangerIsWellKnownDea'
+
+      # The system assigned a user-defined classification because the input data met the criteria specified in a
+      # custom classification override rule.
+      OVERRIDE_MATCH = 'OverrideMatch'
+
+      # The external mail exchanger does not support international mailbox names. To support this feature, mail
+      # exchangers must comply with RFC 5336 and support and announce both the 8BITMIME and the UTF8SMTP protocol
+      # extensions.
+      SERVER_DOES_NOT_SUPPORT_INTERNATIONAL_MAILBOXES = 'ServerDoesNotSupportInternationalMailboxes'
+
+      # The external mail exchanger accepts fake, non existent, email addresses; therefore the provided email address
+      # MAY be nonexistent too.
+      SERVER_IS_CATCH_ALL = 'ServerIsCatchAll'
+
+      # The mail exchanger responsible for the email address under test is temporarily unavailable.
+      SERVER_TEMPORARILY_UNAVAILABLE = 'ServerTemporaryUnavailable'
+
+      # A socket connection error occurred while connecting to the mail exchanger which serves the email address domain.
+      SMTP_CONNECTION_FAILURE = 'SmtpConnectionFailure'
+
+      # A timeout has occurred while connecting to the mail exchanger which serves the email address domain.
+      SMTP_CONNECTION_TIMEOUT = 'SmtpConnectionTimeout'
+
+      # The mail exchanger responsible for the email address under test replied one or more non-standard SMTP replies
+      # which caused the SMTP session to be aborted.
+      SMTP_DIALOG_ERROR = 'SmtpDialogError'
+
+      # The email address has been successfully validated.
+      SUCCESS = 'Success'
+
+      # The domain literal of the email address couldn't accept messages from the Internet.
+      UNACCEPTABLE_DOMAIN_LITERAL = 'UnacceptableDomainLiteral'
+
+      # The number of parenthesis used to open comments is not equal to the one used to close them.
+      UNBALANCED_COMMENT_PARENTHESIS = 'UnbalancedCommentParenthesis'
+
+      # An unexpected quoted pair sequence has been found within a quoted word.
+      UNEXPECTED_QUOTED_PAIR_SEQUENCE = 'UnexpectedQuotedPairSequence'
+
+      # One or more unhandled exceptions have been thrown during the verification process and something went wrong
+      # on the Verifalia side.
+      UNHANDLED_EXCEPTION = 'UnhandledException'
+
+      # A quoted pair within a quoted word is not closed properly.
+      UNMATCHED_QUOTED_PAIR = 'UnmatchedQuotedPair'
+    end
+  end
+end

data/lib/verifalia/email_validation/exported_entries_format.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Verifalia
+  module EmailValidations
+    # Represents the output formats which Verifalia can accept while exporting email validation entries.
+    module ExportedEntriesFormat
+      # Comma-separated values (.csv).
+      CSV = 'text/csv'
+
+      # Microsoft Excel 97-2003 Worksheet (.xls).
+      EXCEL_XLS = 'application/vnd.ms-excel'
+
+      # Microsoft Excel workbook (.xslx).
+      EXCEL_XLSX = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+    end
+  end
+end

data/lib/verifalia/email_validation/job.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'ipaddr'
+
+module Verifalia
+  module EmailValidations
+    # Represents a snapshot of an email validation job, along with its overview and eventually validated entries.
+    class Job
+      # Overview information for this email validation job.
+      attr_reader :overview
+
+      # The eventually validated items for this email validation job.
+      attr_reader :entries
+
+      def initialize(overview, entries)
+        @overview = overview
+        @entries = entries
+      end
+
+      # Parse a Job from a JSON string.
+      def self.from_json(data)
+        progress = nil
+
+        # Parse the eventual progress information
+
+        if data['overview'].respond_to?('progress')
+          progress = Progress.new data['overview']['progress']['percentage'].to_f,
+                                  data['overview']['estimatedTimeRemaining']
+        end
+
+        # Parse the job overview
+
+        overview = Overview.new data['overview']['id'],
+                                DateTime.iso8601(data['overview']['submittedOn']),
+                                (if data['overview'].key?('completedOn')
+                                   DateTime.iso8601(data['overview']['completedOn'])
+                                 end),
+                                data['overview']['priority'],
+                                data['overview']['name'],
+                                data['overview']['owner'],
+                                IPAddr.new(data['overview']['clientIP']),
+                                DateTime.iso8601(data['overview']['createdOn']),
+                                data['overview']['quality'],
+                                data['overview']['retention'],
+                                data['overview']['deduplication'],
+                                data['overview']['status'],
+                                data['overview']['noOfEntries'],
+                                progress
+
+        # Parse the eventual entries
+
+        if data.key?('entries')
+          entries = data['entries']['data'].map do |entry|
+            Entry.new entry['inputData'],
+                      entry['classification'],
+                      entry['status'],
+                      entry['emailAddress'],
+                      entry['emailAddressLocalPart'],
+                      entry['emailAddressDomainPart'],
+                      (entry['hasInternationalMailboxName'] if entry.key?('hasInternationalMailboxName')),
+                      (entry['hasInternationalDomainName'] if entry.key?('hasInternationalDomainName')),
+                      (entry['isDisposableEmailAddress'] if entry.key?('isDisposableEmailAddress')),
+                      (entry['isRoleAccount'] if entry.key?('isRoleAccount')),
+                      (entry['isFreeEmailAddress'] if entry.key?('isFreeEmailAddress')),
+                      (entry['syntaxFailureIndex'] if entry.key?('syntaxFailureIndex')),
+                      entry['custom'],
+                      (entry['duplicateOf'] if entry.key?('duplicateOf')),
+                      DateTime.iso8601(entry['completedOn']),
+                      entry['asciiEmailAddressDomainPart'],
+                      (entry['suggestions'] if entry.key?('suggestions')) || []
+          end
+        end
+
+        Job.new overview, entries
+      end
+    end
+  end
+end

data/lib/verifalia/email_validation/job_status.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Verifalia
+  module EmailValidations
+    # Provides values for the supported statuses for a +job+.
+    module JobStatus
+      # The email validation job has been completed and its results are available.
+      COMPLETED = 'Completed'
+
+      # The email validation job has either been deleted.
+      DELETED = 'Deleted'
+
+      # The email validation job is expired.
+      EXPIRED = 'Expired'
+
+      # The email validation job is being processed by Verifalia.
+      IN_PROGRESS = 'InProgress'
+    end
+  end
+end

data/lib/verifalia/email_validation/overview.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Verifalia
+  module EmailValidations
+    # Overview information for an email validation job.
+    class Overview
+      # The unique identifier for the validation job.
+      attr_reader :id
+
+      # The processing status for the validation job. See +JobStatus+ for a list of the values supported at the time
+      # this SDK has been released.
+      attr_reader :status
+
+      # The date and time this validation job has been submitted to Verifalia.
+      attr_reader :submitted_on
+
+      # The date and time this validation job has been eventually completed.
+      attr_reader :completed_on
+
+      # The eventual priority (speed) of the validation job, relative to the parent Verifalia account. In the event of
+      # an account with many concurrent validation jobs, this value allows to increase the processing speed of a job
+      # with respect to the others.
+      #
+      # The allowed range of values spans from +0+ - lowest priority, to +255+ - highest priority, where the midway
+      # value +127+ means normal priority; if not specified, Verifalia processes all the concurrent validation jobs for
+      # an account using the same priority.
+      attr_reader :priority
+
+      # An optional user-defined name for the validation job, for your own reference.
+      attr_reader :name
+
+      # The unique ID of the Verifalia user who submitted the validation job.
+      attr_reader :owner
+
+      # The IP address of the client which submitted the validation job.
+      attr_reader :client_ip
+
+      # The date and time the validation job was created.
+      attr_reader :created_on
+
+      # A reference to the results quality level this job was validated against.
+      attr_reader :quality
+
+      # The maximum data retention period Verifalia observes for this verification job, after which the job will be
+      # automatically deleted.
+      #
+      # A verification job can be deleted anytime prior to its retention period through the +delete()+ method.
+      attr_reader :retention
+
+      # A deduplication mode option which affected the way Verifalia eventually marked entries as duplicates upon
+      # processing.
+      attr_reader :deduplication
+
+      # The number of entries the validation job contains.
+      attr_reader :no_of_entries
+
+      # The eventual completion progress for the validation job.
+      attr_reader :progress
+
+      def initialize(id, submitted_on, completed_on, priority, name, owner, client_ip, created_on, quality, retention,
+                     deduplication, status, no_of_entries, progress)
+        @id = id
+        @status = status
+        @submitted_on = submitted_on
+        @completed_on = completed_on
+        @priority = priority
+        @name = name
+        @owner = owner
+        @client_ip = client_ip
+        @created_on = created_on
+        @quality = quality
+        @retention = retention
+        @deduplication = deduplication
+        @no_of_entries = no_of_entries
+        @progress = progress
+      end
+    end
+  end
+end

data/lib/verifalia/email_validation/progress.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Verifalia
+  module EmailValidations
+    class Progress
+      # The overall progress percentage for the job, with a value between 0 and 1.
+      attr_reader :percentage
+      # A string representing the estimated remaining time for completing the email validation job, expressed in the
+      # format +dd.hh:mm:ss+ (where dd: days, hh: hours, mm: minutes, ss: seconds); the initial dd. part is added only
+      # for huge lists requiring more than 24 hours to complete.
+      attr_reader :estimated_time_remaining
+
+      def initialize(percentage, estimated_time_remaining)
+        @percentage = percentage
+        @estimated_time_remaining = estimated_time_remaining
+      end
+    end
+  end
+end

data/lib/verifalia/email_validation/request.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Verifalia
+  module EmailValidations
+    class Request
+      attr_accessor :entries, :quality, :priority, :deduplication, :name, :retention, :callback
+
+      def initialize(entries, quality: nil, priority: nil, deduplication: nil, name: nil, retention: nil, callback: nil)
+        @entries = entries
+        @quality = quality
+        @priority = priority
+        @deduplication = deduplication
+        @name = name
+        @retention = retention
+        @callback = callback
+      end
+    end
+  end
+end

data/lib/verifalia/email_validation/request_entry.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Verifalia - Email list cleaning and real-time email verification service
+# https://verifalia.com/
+# support@verifalia.com
+#
+# Copyright (c) 2005-2024 Cobisi Research
+#
+# Cobisi Research
+# Via Della Costituzione, 31
+# 35010 Vigonza
+# Italy - European Union
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Verifalia
+  module EmailValidations
+    class RequestEntry
+      attr_accessor :input_data, :custom
+
+      def initialize(input_data, custom = nil)
+        @input_data = input_data
+        @custom = custom
+      end
+    end
+  end
+end