verifalia 1.2.0 → 2.1.0

data/lib/verifalia/email_validation/wait_options.rb

@@ -0,0 +1,82 @@
+# 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 WaitOptions
+      @@default = nil
+      @@no_wait = nil
+
+      attr_reader :submission_wait_time, :poll_wait_time, :progress
+
+      def initialize(submission_wait_time, poll_wait_time, progress: nil)
+        @submission_wait_time = submission_wait_time
+        @poll_wait_time = poll_wait_time
+        @progress = progress
+      end
+
+      def self.default
+        @@default = WaitOptions.new 30 * 1000, 30 * 1000 if @@default.nil?
+        @@default
+      end
+
+      def self.no_wait
+        @@no_wait = WaitOptions.new 0, 0 if @@no_wait.nil?
+        @@no_wait
+      end
+
+      def wait_for_next_poll(job)
+        # Observe the ETA if we have one, otherwise a delay given the following formula:
+        # delay = max(0.5, min(30, 2^(log(noOfEntries, 10) - 1)))
+
+        if !job.overview.progress.nil? && !job.overview.progress.estimated_time_remaining.nil?
+          # Convert the ETA format (dd.)HH:mm:ss into the number of remaining seconds
+
+          eta_match = /((\d*)\.)?(\d{1,2}):(\d{1,2}):(\d{1,2})/.match(job.overview.progress.estimated_time_remaining)
+
+          days = (eta_match[2] || '0').to_i
+          hours = eta_match[3].to_i
+          minutes = eta_match[4].to_i
+          seconds = eta_match[5].to_i
+
+          delay = days * 24 * 60 * 60 +
+                  hours * 60 * 60 +
+                  minutes * 60 +
+                  seconds
+        else
+          delay = [0.5, [30, 2**(Math.log10(job.overview.no_of_entries) - 1)].min].max
+        end
+
+        sleep(delay)
+      end
+    end
+  end
+end

data/lib/verifalia/rest/client.rb

@@ -0,0 +1,111 @@
+# 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 'faraday'
+require 'json'
+
+module Verifalia
+  module Rest
+    BASE_URLS = %w[https://api-1.verifalia.com/v2.5 https://api-2.verifalia.com/v2.5 https://api-3.verifalia.com/v2.5].freeze
+    BASE_CCA_URLS = %w[https://api-cca-1.verifalia.com/v2.5 https://api-cca-2.verifalia.com/v2.5 https://api-cca-3.verifalia.com/v2.5].freeze
+
+    class Client
+      # Optional debug logger
+      attr_writer :logger
+
+      def initialize(authenticator, user_agent, base_urls)
+        @authenticator = authenticator
+        @user_agent = user_agent
+        @base_urls = base_urls.shuffle
+
+        @current_base_url_idx = 0
+      end
+
+      def invoke(method, resource, options = nil)
+        errors = []
+
+        # Performs a maximum of as many attempts as the number of configured base API endpoints, keeping track
+        # of the last used endpoint after each call, in order to try to distribute the load evenly across the
+        # available endpoints.
+
+        (0...@base_urls.length).each {
+          base_url = @base_urls[@current_base_url_idx % @base_urls.length]
+          @current_base_url_idx += 1
+
+          # Build the final URL
+
+          final_url = "#{base_url}/#{resource}"
+
+          @logger&.info("Invoking #{method.upcase} #{final_url}")
+
+          # Init the HTTP request
+
+          connection = Faraday.new(
+            headers: { 'User-Agent' => @user_agent }
+          )
+
+          request = connection.build_request(method)
+          request.url(final_url)
+
+          # Options
+
+          unless options.nil?
+            request.body = options[:body] unless options[:body].nil?
+            request.headers = request.headers.merge(options[:headers]) unless options[:headers].nil?
+          end
+
+          # Authenticate the underlying client, if needed
+
+          @authenticator.authenticate connection, request
+
+          begin
+            # Send the request to the Verifalia servers
+
+            connection.builder.build_response(connection, request).on_complete do |response|
+              if (500...599).include?(response.status)
+                raise "Server error (HTTP status #{response.status}) while invoking #{final_url}"
+              end
+
+              return response
+            end
+          rescue => e
+            @logger&.warn("Error while invoking #{method.upcase} #{final_url}. #{e.to_s}")
+            errors.append(e)
+          end
+        }
+
+        # Generate an error out of the potentially multiple invocation errors
+
+        raise "All the base URIs are unreachable:\n#{errors.map { |error| error.to_s }.join("\n")}"
+      end
+    end
+  end
+end

data/lib/verifalia/security/certificate_authenticator.rb

@@ -0,0 +1,50 @@
+# 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 Security
+    # Allows to authenticate to Verifalia with a client certificate.
+    class CertificateAuthenticator
+      def initialize(ssl_client_cert, ssl_client_key)
+        ssl_client_cert = OpenSSL::X509::Certificate.new(File.read(ssl_client_cert)) if ssl_client_cert.is_a?(String)
+        ssl_client_key = OpenSSL::PKey::RSA.new(File.read(ssl_client_key)) if ssl_client_key.is_a?(String) && !ssl_client_key.nil?
+
+        @ssl_client_cert = ssl_client_cert
+        @ssl_client_key = ssl_client_key
+      end
+
+      def authenticate(connection, request)
+        connection.ssl.client_cert = @ssl_client_cert
+        connection.ssl.client_key = @ssl_client_key
+      end
+    end
+  end
+end

data/lib/verifalia/security/username_password_authenticator.rb

@@ -0,0 +1,51 @@
+# 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 Security
+    # Allows to authenticate to Verifalia with a username and password pair.
+    class UsernamePasswordAuthenticator
+      def initialize(username, password = nil)
+        if username.nil? || username.strip.length == 0
+          raise ArgumentError, 'username is nil or empty: please visit https://verifalia.com/client-area to set up a new user, if you don\'t have one.'
+        end
+
+        @username = username
+        @password = password || ''
+      end
+
+      def authenticate(connection, request)
+        header = Faraday::Utils.basic_header_from(@username, @password)
+        request.headers[Faraday::Request::Authorization::KEY] = header
+      end
+    end
+  end
+end

data/lib/verifalia.rb

@@ -1,27 +1,55 @@
-require 'builder'
-require 'forwardable'
+# frozen_string_literal: true
 
-require 'verifalia/version'
-require 'verifalia/util/configuration'
+# 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 'rest/client'
+require_relative 'verifalia/client'
 
-module Verifalia
-  extend SingleForwardable
+require_relative 'verifalia/credits/balance'
+require_relative 'verifalia/credits/client'
 
-  def_delegators :configuration, :account_sid, :auth_token
+require_relative 'verifalia/email_validation/client'
+require_relative 'verifalia/email_validation/completion_callback'
+require_relative 'verifalia/email_validation/entry'
+require_relative 'verifalia/email_validation/entry_classification'
+require_relative 'verifalia/email_validation/entry_status'
+require_relative 'verifalia/email_validation/exported_entries_format'
+require_relative 'verifalia/email_validation/job'
+require_relative 'verifalia/email_validation/job_status'
+require_relative 'verifalia/email_validation/overview'
+require_relative 'verifalia/email_validation/progress'
+require_relative 'verifalia/email_validation/request'
+require_relative 'verifalia/email_validation/request_entry'
+require_relative 'verifalia/email_validation/wait_options'
 
-  ##
-  # Pre-configure with account SID and auth token so that you don't need to
-  # pass them to various initializers each time.
-  def self.configure(&block)
-    yield configuration
-  end
+require_relative 'verifalia/security/username_password_authenticator'
+require_relative 'verifalia/security/certificate_authenticator'
 
-  ##
-  # Returns an existing or instantiates a new configuration object.
-  def self.configuration
-    @configuration ||= Util::Configuration.new
-  end
-  private_class_method :configuration
-end
+module Verifalia
+end

data/sig/completion_callback.rbs

@@ -0,0 +1,5 @@
+class CompletionCallback
+  attr_accessor skip_server_certificate_validation: bool | nil
+  attr_accessor url: String
+  attr_accessor version: String | nil
+end

data/sig/verifalia/client.rbs

@@ -0,0 +1,11 @@
+module Verifalia
+  class Client
+    VERSION: String
+
+    @base_urls: Array[String]
+    @rest_client: Rest::Client
+
+    attr_reader credits: Credits::Client
+    attr_reader email_validations: EmailValidations::Client
+  end
+end

data/sig/verifalia/credits/balance.rbs

@@ -0,0 +1,11 @@
+module Verifalia
+  module Credits
+    class Balance
+      def self.from_json: (Hash[String, untyped]) -> Balance
+
+      attr_reader credit_packs: BigDecimal
+      attr_reader free_credits: BigDecimal | nil
+      attr_reader free_credits_reset_in: String | nil
+    end
+  end
+end

data/sig/verifalia/credits/client.rbs

@@ -0,0 +1,7 @@
+module Verifalia
+  module Credits
+    class Client
+      def get_balance: -> Balance
+    end
+  end
+end

data/sig/verifalia/email_validations/client.rbs

@@ -0,0 +1,24 @@
+module Verifalia
+  module EmailValidations
+    class Client
+      @rest_client: Rest::Client
+
+      def delete: (String) -> void
+      def export: (String, String) -> String
+      def get: (String, wait_options: WaitOptions) -> (Job | nil)
+      def submit: ((String | Array[String] | Array[RequestEntry] | Array[Hash[String, untyped]] | RequestEntry | Request),
+          quality: String,
+          priority: (Integer | nil),
+          deduplication: String,
+          name: String,
+          retention: String,
+          completion_callback: CompletionCallback | Hash[String, untyped] | nil,
+          wait_options: WaitOptions) -> (Job | nil)
+
+      private
+
+      def build_job: -> Job
+      def wait_for_completion: (Job, WaitOptions) -> (Job | nil)
+    end
+  end
+end

data/sig/verifalia/email_validations/entry.rbs

@@ -0,0 +1,24 @@
+module Verifalia
+  module EmailValidations
+    class Entry
+      attr_reader ascii_email_address_domain_part: String | nil
+      attr_reader completed_on: DateTime
+      attr_reader custom: String | nil
+      attr_reader duplicate_of: Integer | nil
+      attr_reader email_address: String | nil
+      attr_reader email_address_domain_part: String | nil
+      attr_reader email_address_local_part: String | nil
+      attr_reader has_international_domain_name: bool | nil
+      attr_reader has_international_mailbox_name: bool | nil
+      attr_reader index: Integer
+      attr_reader input_data: String
+      attr_reader classification: String
+      attr_reader is_disposable_email_address: bool | nil
+      attr_reader is_free_email_address: bool | nil
+      attr_reader is_role_account: bool | nil
+      attr_reader status: String
+      attr_reader suggestions: [String]
+      attr_reader syntax_failure_index: Integer | nil
+    end
+  end
+end

data/sig/verifalia/email_validations/entry_classification.rbs

@@ -0,0 +1,10 @@
+module Verifalia
+  module EmailValidations
+    module EntryClassification
+      DELIVERABLE: String
+      RISKY: String
+      UNDELIVERABLE: String
+      UNKNOWN: String
+    end
+  end
+end

data/sig/verifalia/email_validations/entry_status.rbs

@@ -0,0 +1,50 @@
+module Verifalia
+  module EmailValidations
+    module EntryStatus
+      AT_SIGN_NOT_FOUND: String
+      CATCH_ALL_CONNECTION_FAILURE: String
+      CATCH_ALL_VALIDATION_TIMEOUT: String
+      DNS_CONNECTION_FAILURE: String
+      DNS_QUERY_TIMEOUT: String
+      DOMAIN_DOES_NOT_EXIST: String
+      DOMAIN_HAS_NULL_MX: String
+      DOMAIN_IS_MISCONFIGURED: String
+      DOMAIN_IS_WELL_KNOWN_DEA: String
+      DOMAIN_PART_COMPLIANCY_FAILURE: String
+      DOUBLE_DOT_SEQUENCE: String
+      DUPLICATE: String
+      INVALID_ADDRESS_LENGTH: String
+      INVALID_CHARACTER_IN_SEQUENCE: String
+      INVALID_EMPTY_QUOTED_WORD: String
+      INVALID_FOLDING_WHITE_SPACE_SEQUENCE: String
+      INVALID_LOCAL_PART_LENGTH: String
+      INVALID_WORD_BOUNDARY_START: String
+      ISP_SPECIFIC_SYNTAX_FAILURE: String
+      LOCAL_END_POINT_REJECTED: String
+      LOCAL_PART_IS_WELL_KNOWN_ROLE_ACCOUNT: String
+      LOCAL_SENDER_ADDRESS_REJECTED: String
+      MAILBOX_CONNECTION_FAILURE: String
+      MAILBOX_DOES_NOT_EXIST: String
+      MAILBOX_HAS_INSUFFICIENT_STORAGE: String
+      MAILBOX_IS_DEA: String
+      MAILBOX_TEMPORARILY_UNAVAILABLE: String
+      MAILBOX_VALIDATION_TIMEOUT: String
+      MAIL_EXCHANGER_IS_HONEYPOT: String
+      MAIL_EXCHANGER_IS_PARKED: String
+      MAIL_EXCHANGER_IS_WELL_KNOWN_DEA: String
+      OVERRIDE_MATCH: String
+      SERVER_DOES_NOT_SUPPORT_INTERNATIONAL_MAILBOXES: String
+      SERVER_IS_CATCH_ALL: String
+      SERVER_TEMPORARILY_UNAVAILABLE: String
+      SMTP_CONNECTION_FAILURE: String
+      SMTP_CONNECTION_TIMEOUT: String
+      SMTP_DIALOG_ERROR: String
+      SUCCESS: String
+      UNACCEPTABLE_DOMAIN_LITERAL: String
+      UNBALANCED_COMMENT_PARENTHESIS: String
+      UNEXPECTED_QUOTED_PAIR_SEQUENCE: String
+      UNHANDLED_EXCEPTION: String
+      UNMATCHED_QUOTED_PAIR: String
+    end
+  end
+end

data/sig/verifalia/email_validations/exported_entries_format.rbs

@@ -0,0 +1,9 @@
+module Verifalia
+  module EmailValidations
+    module ExportedEntriesFormat
+      CSV: String
+      EXCEL_XLS: String
+      EXCEL_XLSX: String
+    end
+  end
+end

data/sig/verifalia/email_validations/job.rbs

@@ -0,0 +1,13 @@
+module Verifalia
+  module EmailValidations
+    class Job
+      @entries: Array[Entry]
+      @overview: Overview
+
+      def self.from_json: (Hash[String, untyped]) -> Job
+
+      attr_reader entries: Array[Entry]
+      attr_reader overview: Overview
+    end
+  end
+end

data/sig/verifalia/email_validations/job_status.rbs

@@ -0,0 +1,10 @@
+module Verifalia
+  module EmailValidations
+    module JobStatus
+      COMPLETED: String
+      DELETED: String
+      EXPIRED: String
+      IN_PROGRESS: String
+    end
+  end
+end

data/sig/verifalia/email_validations/overview.rbs

@@ -0,0 +1,20 @@
+module Verifalia
+  module EmailValidations
+    class Overview
+      attr_reader client_ip: IPAddr
+      attr_reader completed_on: (DateTime | nil)
+      attr_reader created_on: DateTime
+      attr_reader deduplication: String
+      attr_reader id: String
+      attr_reader name: String
+      attr_reader no_of_entries: Integer
+      attr_reader owner: String
+      attr_reader priority: (Integer | nil)
+      attr_reader progress: (Progress | nil)
+      attr_reader quality: String
+      attr_reader retention: String
+      attr_reader status: String
+      attr_reader submitted_on: DateTime
+    end
+  end
+end

data/sig/verifalia/email_validations/progress.rbs

@@ -0,0 +1,8 @@
+module Verifalia
+  module EmailValidations
+    class Progress
+      attr_reader estimated_time_remaining: String
+      attr_reader percentage: Float
+    end
+  end
+end

data/sig/verifalia/email_validations/request.rbs

@@ -0,0 +1,13 @@
+module Verifalia
+  module EmailValidations
+    class Request
+      attr_accessor callback: CompletionCallback | nil
+      attr_accessor deduplication: String | nil
+      attr_accessor entries: Array[RequestEntry]
+      attr_accessor name: String | nil
+      attr_accessor priority: Integer | nil
+      attr_accessor quality: String | nil
+      attr_accessor retention: String | nil
+    end
+  end
+end

data/sig/verifalia/email_validations/request_entry.rbs

@@ -0,0 +1,8 @@
+module Verifalia
+  module EmailValidations
+    class RequestEntry
+      attr_accessor custom: String
+      attr_accessor input_data: String
+    end
+  end
+end

data/sig/verifalia/email_validations/wait_options.rbs

@@ -0,0 +1,20 @@
+module Verifalia
+  module EmailValidations
+    class WaitOptions
+      @@default: WaitOptions
+      @@no_wait: WaitOptions
+      @submission_wait_time: Integer
+      @poll_wait_time: Integer
+
+      def self.default: -> WaitOptions
+      def self.no_wait: -> WaitOptions
+
+      attr_reader poll_wait_time: Integer
+      attr_reader progress: (^(Overview) -> void) | nil
+      attr_reader submission_wait_time: Integer
+
+      def initialize: (Integer, Integer) -> WaitOptions
+      def wait_for_next_poll: (Job) -> void
+    end
+  end
+end

data/sig/verifalia/rest/client.rbs

@@ -0,0 +1,12 @@
+module Verifalia
+  module Rest
+    class Client
+      @base_urls: Array[String]
+      @current_base_url_idx: Integer
+
+      @user_agent: String
+
+      def invoke: (String, String, (Hash[String, untyped] | nil)) -> untyped # Faraday::Response
+    end
+  end
+end

data/sig/verifalia/rest.rbs

@@ -0,0 +1,6 @@
+module Verifalia
+  module Rest
+    BASE_CCA_URLS: Array[String]
+    BASE_URLS: Array[String]
+  end
+end

data/sig/verifalia/security/certificate_authenticator.rbs

@@ -0,0 +1,8 @@
+module Verifalia
+  module Security
+    class CertificateAuthenticator
+      @ssl_client_cert: String | OpenSSL::X509::Certificate
+      @ssl_client_key: String | OpenSSL::PKey::RSA
+    end
+  end
+end