emailhunter 1.0.0 → 2.0.0

data/lib/email_hunter/leads.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'ostruct'
+
+module EmailHunter
+  class Leads
+    API_URL = 'https://api.hunter.io/v2/leads'
+
+    attr_reader :key, :params, :action, :lead_id, :data
+
+    def initialize(key, action: :list, lead_id: nil, data: nil, params: {})
+      @key = key
+      @action = action
+      @lead_id = lead_id
+      @data = data
+      @params = params
+    end
+
+    def hunt
+      case action
+      when :list
+        list_leads
+      when :create
+        create_lead
+      when :update
+        update_lead
+      when :delete
+        delete_lead
+      else
+        raise ArgumentError, "Unknown action: #{action}"
+      end
+    end
+
+    private
+
+    def list_leads
+      response_data = fetch_leads_data
+      return nil if response_data.empty?
+
+      # Convert nested data structure to OpenStruct
+      result = OpenStruct.new(
+        data: OpenStruct.new(response_data[:data] || {}),
+        meta: OpenStruct.new(response_data[:meta] || {})
+      )
+
+      # Convert leads array to OpenStruct objects
+      result.data.leads = result.data.leads.map { |lead| OpenStruct.new(lead) } if result.data.leads.is_a?(Array)
+
+      result
+    end
+
+    def create_lead
+      response_data = post_lead_data
+      return nil if response_data.empty?
+
+      OpenStruct.new(response_data)
+    end
+
+    def update_lead
+      response_data = put_lead_data
+      return nil if response_data.empty?
+
+      OpenStruct.new(response_data)
+    end
+
+    def delete_lead
+      response = delete_lead_data
+      response.success?
+    end
+
+    def fetch_leads_data
+      @fetch_leads_data ||= begin
+        connection = Faraday.new
+        request_params = {
+          api_key: key,
+          limit: params.fetch(:limit, 20),
+          offset: params.fetch(:offset, 0)
+        }
+
+        # Add optional filters
+        request_params[:leads_list_id] = params[:leads_list_id] if params[:leads_list_id]
+
+        response = connection.get(API_URL, request_params)
+
+        return {} unless response.success?
+
+        JSON.parse(response.body, symbolize_names: true)
+      end
+    end
+
+    def post_lead_data
+      connection = Faraday.new
+      request_data = data.merge(api_key: key)
+
+      response = connection.post(API_URL) do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = request_data.to_json
+      end
+
+      return {} unless response.success?
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def put_lead_data
+      connection = Faraday.new
+      url = "#{API_URL}/#{lead_id}"
+      request_data = data.merge(api_key: key)
+
+      response = connection.put(url) do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = request_data.to_json
+      end
+
+      return {} unless response.success?
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def delete_lead_data
+      connection = Faraday.new
+      url = "#{API_URL}/#{lead_id}"
+
+      connection.delete(url, api_key: key)
+    end
+  end
+end

data/lib/email_hunter/people.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'ostruct'
+
+module EmailHunter
+  class People
+    API_URL = 'https://api.hunter.io/v2/people/find'
+
+    attr_reader :email, :key
+
+    def initialize(email, key)
+      @email = email
+      @key = key
+    end
+
+    def hunt
+      response_data = fetch_people_data
+      return nil if response_data.empty?
+
+      # Convert nested data structure to a Struct
+      data = response_data[:data]
+      meta = response_data[:meta]
+
+      result = OpenStruct.new(
+        data: OpenStruct.new(data),
+        meta: OpenStruct.new(meta)
+      )
+
+      # Recursively convert nested hashes to OpenStructs for deeper access
+      convert_hash_to_struct(result.data, data)
+
+      result
+    end
+
+    private
+
+    def fetch_people_data
+      @fetch_people_data ||= begin
+        connection = Faraday.new
+        response = connection.get(API_URL, email: email, api_key: key)
+
+        return {} unless response.success?
+
+        JSON.parse(response.body, symbolize_names: true)
+      end
+    end
+
+    def convert_hash_to_struct(struct, hash)
+      hash.each do |key, value|
+        if value.is_a?(Hash)
+          struct[key] = OpenStruct.new(value)
+          convert_hash_to_struct(struct[key], value)
+        elsif value.is_a?(Array) && value.first.is_a?(Hash)
+          struct[key] = value.map { |item| OpenStruct.new(item) }
+        end
+      end
+    end
+  end
+end

data/lib/email_hunter/search.rb

@@ -3,11 +3,11 @@
 require 'faraday'
 require 'json'
 
-API_SEARCH_URL = 'https://api.hunter.io/v2/domain-search?'
-
 module EmailHunter
   class Search
-    attr_reader :meta, :webmail, :emails, :pattern, :domain, :params, :key
+    API_URL = 'https://api.hunter.io/v2/domain-search'
+
+    attr_reader :domain, :key, :params
 
     def initialize(domain, key, params = {})
       @domain = domain
@@ -16,24 +16,38 @@ module EmailHunter
     end
 
     def hunt
-      Struct.new(*data.keys).new(*data.values)
+      response_data = fetch_search_data
+      return nil if response_data.empty?
+
+      Struct.new(*response_data.keys).new(*response_data.values)
     end
 
+    private
+
     def limit
-      params[:limit] || 10
+      params.fetch(:limit, 10).to_i
     end
 
     def offset
-      params[:offset] || 0
+      params.fetch(:offset, 0).to_i
     end
 
-    def data
-      @data ||= begin
-        response = Faraday.new("#{API_SEARCH_URL}domain=#{domain}&api_key=#{key}&type=#{params[:type]}&offset=#{offset}&limit=#{limit}").get
+    def fetch_search_data
+      @fetch_search_data ||= begin
+        connection = Faraday.new
+        request_params = {
+          domain: domain,
+          api_key: key,
+          offset: offset,
+          limit: limit
+        }
+
+        request_params[:type] = params[:type] if params[:type]
+        response = connection.get(API_URL, request_params)
 
         return {} unless response.success?
 
-        JSON.parse(response.body, { symbolize_names: true })
+        JSON.parse(response.body, symbolize_names: true)
       end
     end
   end

data/lib/email_hunter/verify.rb

@@ -3,12 +3,11 @@
 require 'faraday'
 require 'json'
 
-API_VERIFY_URL = 'https://api.hunter.io/v2/email-verifier?'
-
 module EmailHunter
   class Verify
-    attr_reader :result, :score, :regexp, :gibberish, :disposable, :webmail, :mx_records, :smtp_server, :smtp_check,
-                :accept_all, :sources, :meta, :key, :email
+    API_URL = 'https://api.hunter.io/v2/email-verifier'
+
+    attr_reader :email, :key
 
     def initialize(email, key)
       @email = email
@@ -16,16 +15,22 @@ module EmailHunter
     end
 
     def hunt
-      Struct.new(*data.keys).new(*data.values)
+      response_data = fetch_verify_data
+      return nil if response_data.empty?
+
+      Struct.new(*response_data.keys).new(*response_data.values)
     end
 
-    def data
-      @data ||= begin
-        response = Faraday.new("#{API_VERIFY_URL}email=#{email}&api_key=#{key}").get
+    private
+
+    def fetch_verify_data
+      @fetch_verify_data ||= begin
+        connection = Faraday.new
+        response = connection.get(API_URL, email: email, api_key: key)
 
-        return [] unless response.success?
+        return {} unless response.success?
 
-        JSON.parse(response.body, { symbolize_names: true })
+        JSON.parse(response.body, symbolize_names: true)
       end
     end
   end

data/lib/email_hunter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EmailHunter
-  VERSION = '1.0.0'
+  VERSION = '2.0.0'
 end

data/lib/emailhunter.rb

@@ -1 +1,3 @@
+# frozen_string_literal: true
+
 require File.expand_path(File.join(File.dirname(__FILE__), './email_hunter'))

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: emailhunter
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Davide Santangelo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-24 00:00:00.000000000 Z
+date: 2025-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -108,8 +108,10 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 'A tiny ruby wrapper around Hunter.io API. Hunter.io helps sales people
-  reach their targets and increase their sales. '
+description: |
+  EmailHunter is a minimalistic Ruby wrapper for the Hunter.io API.
+  It provides a straightforward interface to integrate Hunter.io's
+  email discovery capabilities into your sales and marketing workflows.
 email:
 - davide.santangelo@gmail.com
 executables: []
@@ -130,17 +132,26 @@ files:
 - lib/email_hunter.rb
 - lib/email_hunter/account.rb
 - lib/email_hunter/api.rb
+- lib/email_hunter/campaigns.rb
+- lib/email_hunter/combined_enrichment.rb
+- lib/email_hunter/company.rb
+- lib/email_hunter/company_enrichment.rb
 - lib/email_hunter/count.rb
+- lib/email_hunter/discover.rb
 - lib/email_hunter/exist.rb
 - lib/email_hunter/finder.rb
+- lib/email_hunter/lead_enrichment.rb
+- lib/email_hunter/leads.rb
+- lib/email_hunter/people.rb
 - lib/email_hunter/search.rb
 - lib/email_hunter/verify.rb
 - lib/email_hunter/version.rb
 - lib/emailhunter.rb
-homepage:
+homepage: https://github.com/davidesantangelo/emailhunter
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/davidesantangelo/emailhunter
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -149,15 +160,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.3.26
 signing_key:
 specification_version: 4
-summary: A tiny ruby wrapper around Hunter.io API
+summary: A tiny Ruby wrapper around the Hunter.io API
 test_files: []