tomba 1.0.1 → 1.1.0

data/lib/tomba/services/status.rb

@@ -1,45 +1,52 @@
-module Tomba
-    class Status < Service
-
-        def domain_status(domain:)
-            if domain.nil?
-                raise Tomba::Exception.new('Missing required parameter: "domain"')
-            end
-
-            path = '/domain-status'
-
-            params = {}
-
-            if !domain.nil?
-                params[:domain] = domain
-            end
-
-            return @client.call('get', path, {
-                'content-type' => 'application/json',
-            }, params);
-        end
-
-        def auto_complete(query:)
-            if query.nil?
-                raise Tomba::Exception.new('Missing required parameter: "query"')
-            end
+# frozen_string_literal: true
 
-            path = '/domains-suggestion'
-
-            params = {}
-
-            if !query.nil?
-                params[:query] = query
-            end
-
-            return @client.call('get', path, {
-                'content-type' => 'application/json',
-            }, params);
-        end
-
-
-        protected
-
-        private
-    end 
-end
+module Tomba
+  # Status service for domain status and autocomplete.
+  #
+  # Provides methods to check domain status and get domain suggestions.
+  #
+  # @see https://docs.tomba.io/api/status
+  class Status < Service
+    # Domain Status
+    #
+    # Returns the status of a domain, including whether it is webmail or disposable.
+    #
+    # @see https://docs.tomba.io/api/status#domain-status
+    # @param domain [String] the domain name to check
+    # @return [Hash] API response containing domain status
+    # @raise [Tomba::Exception]
+    def domain_status(domain:)
+      raise Tomba::Exception, 'Missing required parameter: "domain"' if domain.nil?
+
+      path = '/domain-status'
+
+      params = {}
+      params[:domain] = domain unless domain.nil?
+
+      @client.call('get', path, {
+                     'content-type' => 'application/json'
+                   }, params)
+    end
+
+    # Autocomplete
+    #
+    # Returns domain suggestions based on a search query.
+    #
+    # @see https://docs.tomba.io/api/status#domain-suggestions
+    # @param query [String] the search query for domain suggestions
+    # @return [Hash] API response containing domain suggestions
+    # @raise [Tomba::Exception]
+    def auto_complete(query:)
+      raise Tomba::Exception, 'Missing required parameter: "query"' if query.nil?
+
+      path = '/domain-suggestions'
+
+      params = {}
+      params[:query] = query unless query.nil?
+
+      @client.call('get', path, {
+                     'content-type' => 'application/json'
+                   }, params)
+    end
+  end
+end

data/lib/tomba/services/technology.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Tomba
+  # Technology service for detecting website technologies.
+  #
+  # Provides methods to discover the technologies used by a website.
+  #
+  # @see https://docs.tomba.io/api/domain#technology
+  class Technology < Service
+    # List Technologies
+    #
+    # Returns the technologies detected on a given domain.
+    #
+    # @see https://docs.tomba.io/api/domain#technology#list-technologies
+    # @param domain [String] the domain name to analyze
+    # @return [Hash] API response containing detected technologies
+    # @raise [Tomba::Exception]
+    def list(domain)
+      raise Tomba::Exception, 'Missing required parameter: "domain"' if domain.nil?
+
+      path = '/technology'
+
+      params = { domain: domain }
+
+      @client.call('get', path, {
+                     'content-type' => 'application/json'
+                   }, params)
+    end
+  end
+end

data/lib/tomba/services/usage.rb

@@ -1,19 +1,27 @@
-module Tomba
-    class Usage < Service
-
-        def get_usage()
-            path = '/usage'
-
-            params = {}
-
-            return @client.call('get', path, {
-                'content-type' => 'application/json',
-            }, params);
-        end
+# frozen_string_literal: true
 
+module Tomba
+  # Usage service for retrieving API usage statistics.
+  #
+  # Provides methods to get account usage information.
+  #
+  # @see https://docs.tomba.io/api/account#retrieve-api-usage
+  class Usage < Service
+    # Get Usage
+    #
+    # Returns the current API usage statistics for the account.
+    #
+    # @see https://docs.tomba.io/api/account#retrieve-api-usage#get-usage
+    # @return [Hash] API response containing usage statistics
+    # @raise [Tomba::Exception]
+    def get_usage
+      path = '/usage'
 
-        protected
+      params = {}
 
-        private
-    end 
-end
+      @client.call('get', path, {
+                     'content-type' => 'application/json'
+                   }, params)
+    end
+  end
+end

data/lib/tomba/services/verifier.rb

@@ -1,24 +1,33 @@
-module Tomba
-    class Verifier < Service
-
-        def email_verifier(email:)
-            if email.nil?
-                raise Tomba::Exception.new('Missing required parameter: "email"')
-            end
-
-            path = '/email-verifier/{email}'
-                .gsub('{email}', email)
+# frozen_string_literal: true
 
-            params = {}
-
-            return @client.call('get', path, {
-                'content-type' => 'application/json',
-            }, params);
-        end
+module Tomba
+  # Verifier service for email verification.
+  #
+  # Provides methods to verify if an email address is valid and deliverable.
+  #
+  # @see https://docs.tomba.io/api/verifier
+  class Verifier < Service
+    # Email Verifier
+    #
+    # Verifies the deliverability of an email address.
+    #
+    # @see https://docs.tomba.io/api/verifier#email-verifier
+    # @param email [String] the email address to verify
+    # @param webhook_url [String, nil] webhook URL for async notifications
+    # @return [Hash] API response containing verification results
+    # @raise [Tomba::Exception]
+    def email_verifier(email:, webhook_url: nil)
+      raise Tomba::Exception, 'Missing required parameter: "email"' if email.nil?
 
+      path = '/email-verifier'
 
-        protected
+      params = {}
+      params[:email] = email unless email.nil?
+      params[:webhook_url] = webhook_url unless webhook_url.nil?
 
-        private
-    end 
-end
+      @client.call('get', path, {
+                     'content-type' => 'application/json'
+                   }, params)
+    end
+  end
+end

data/lib/tomba/version.rb

@@ -1,4 +1,5 @@
+# frozen_string_literal: true
 
 module Tomba
-    VERSION = '1.0.1'
+  VERSION = '1.1.0'
 end

data/lib/tomba.rb

@@ -1,9 +1,14 @@
+# frozen_string_literal: true
+
 require 'net/http'
 require 'uri'
 require 'json'
+require_relative 'tomba/version'
 require_relative 'tomba/client'
 require_relative 'tomba/service'
 require_relative 'tomba/exception'
+
+# Existing services
 require_relative 'tomba/services/account'
 require_relative 'tomba/services/domain'
 require_relative 'tomba/services/finder'
@@ -16,3 +21,15 @@ require_relative 'tomba/services/logs'
 require_relative 'tomba/services/keys'
 require_relative 'tomba/services/leads-lists'
 require_relative 'tomba/services/leads-attributes'
+
+# New services
+require_relative 'tomba/services/phone'
+require_relative 'tomba/services/format'
+require_relative 'tomba/services/similar'
+require_relative 'tomba/services/technology'
+require_relative 'tomba/services/location'
+require_relative 'tomba/services/enrichment'
+require_relative 'tomba/services/reveal'
+require_relative 'tomba/services/flag'
+require_relative 'tomba/services/leads'
+require_relative 'tomba/services/bulk'

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: tomba
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Mohamed Ben rebia
 - Tomba technology web service LLC
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-02 00:00:00.000000000 Z
+date: 2026-08-31 00:00:00.000000000 Z
 dependencies: []
 description: official Ruby library for Tomba
 email:
@@ -24,23 +24,34 @@ files:
 - lib/tomba/exception.rb
 - lib/tomba/service.rb
 - lib/tomba/services/account.rb
+- lib/tomba/services/bulk.rb
 - lib/tomba/services/count.rb
 - lib/tomba/services/domain.rb
+- lib/tomba/services/enrichment.rb
 - lib/tomba/services/finder.rb
+- lib/tomba/services/flag.rb
+- lib/tomba/services/format.rb
 - lib/tomba/services/keys.rb
 - lib/tomba/services/leads-attributes.rb
 - lib/tomba/services/leads-lists.rb
+- lib/tomba/services/leads.rb
+- lib/tomba/services/location.rb
 - lib/tomba/services/logs.rb
+- lib/tomba/services/phone.rb
+- lib/tomba/services/reveal.rb
+- lib/tomba/services/similar.rb
 - lib/tomba/services/sources.rb
 - lib/tomba/services/status.rb
+- lib/tomba/services/technology.rb
 - lib/tomba/services/usage.rb
 - lib/tomba/services/verifier.rb
 - lib/tomba/version.rb
 homepage: https://tomba.io
 licenses:
 - Apache-2.0
-metadata: {}
-post_install_message: 
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -55,8 +66,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Tomba.io is an Email Finder for B2B sales and email marketing
 test_files: []