cufinder-ruby 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c9f06c87746a02b9f3ba1003f43e859f96549c67061db0d66465ce919324400f
+  data.tar.gz: e304713de973c2cfa7de842e9788a2d49a17383dc540a9c7520ff6205f50dfcd
+SHA512:
+  metadata.gz: 65e625f7ac41c7b61af9b3f672d5a4c9cae6243a28a62c099feb13dc8bfecefd3c388790d355c5b6c7a47ec544676ccee0da857b89a23d7fc8de05ef745ab7d6
+  data.tar.gz: a35579b44987e8aa8c2bb5a8ecad07da0c6dc4585cf3c0a08626b2202253e77da1b60000e7d6481bac5c11e906c84e8bba3e61685fddc008efd90ca4555eeb5b

data/.gitignore

@@ -0,0 +1,59 @@
+# Ruby
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Bundler
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# Documentation
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+# Environment
+/.env
+/.env.local
+/.env.development.local
+/.env.test.local
+/.env.production.local
+
+# IDE
+/.vscode/
+/.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+
+# Coverage reports
+/coverage/
+
+# RSpec
+.rspec_status
+
+# Temporary files
+*.tmp
+*.temp

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in cufinder-ruby.gemspec
+gemspec
+
+group :development, :test do
+  gem "rspec", "~> 3.12"
+  gem "webmock", "~> 3.18"
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CUFinder
+
+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.

data/README.md

@@ -0,0 +1,206 @@
+# CUFinder Ruby SDK
+
+Official Ruby SDK for accessing CUFinder's comprehensive business intelligence and lead generation services.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'cufinder-ruby'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install cufinder-ruby
+```
+
+## Usage
+
+### Basic Setup
+
+```ruby
+require 'cufinder_ruby'
+
+# Initialize the SDK with your API key
+sdk = CufinderRuby::SDK.new(api_key: 'your-api-key-here')
+```
+
+### Available Services
+
+The SDK provides access to all CUFinder API services:
+
+#### 1. CUF - Company URL Finder
+```ruby
+result = sdk.cuf(company_name: "Apple Inc", country_code: "US")
+puts result.domain  # => "apple.com"
+```
+
+#### 2. LCUF - LinkedIn Company URL Finder
+```ruby
+result = sdk.lcuf(company_name: "Apple Inc")
+puts result.linkedin_url  # => "linkedin.com/company/apple"
+```
+
+#### 3. DTC - Domain to Company
+```ruby
+result = sdk.dtc(company_website: "apple.com")
+puts result.company_name  # => "Apple Inc"
+```
+
+#### 4. DTE - Domain to Emails
+```ruby
+result = sdk.dte(company_website: "apple.com")
+puts result.emails  # => ["contact@apple.com", "info@apple.com"]
+```
+
+#### 5. NTP - Name to Phones
+```ruby
+result = sdk.ntp(company_name: "Apple Inc")
+puts result.phones  # => ["+1-408-996-1010"]
+```
+
+#### 6. REL - Reverse Email Lookup
+```ruby
+result = sdk.rel(email: "tim.cook@apple.com")
+puts result.person.full_name  # => "Tim Cook"
+```
+
+#### 7. FCL - Find Company Lookalikes
+```ruby
+result = sdk.fcl(query: "tech startup")
+puts result.companies.length  # => 10
+```
+
+#### 8. ELF - Enrich LinkedIn Fundraising
+```ruby
+result = sdk.elf(query: "tech company")
+puts result.fundraising.funding_money_raised  # => "$5M"
+```
+
+#### 9. CAR - Company Annual Revenue
+```ruby
+result = sdk.car(query: "Apple Inc")
+puts result.revenue  # => "$394.3B"
+```
+
+#### 10. FCC - Find Company Children
+```ruby
+result = sdk.fcc(query: "Apple Inc")
+puts result.subsidiaries  # => ["Beats Electronics", "Shazam"]
+```
+
+#### 11. FTS - Find Tech Stack
+```ruby
+result = sdk.fts(query: "web development")
+puts result.technologies  # => ["React", "Node.js", "Python"]
+```
+
+#### 12. EPP - Enrich Person Profile
+```ruby
+result = sdk.epp(linkedin_url: "linkedin.com/in/tim-cook")
+puts result.person.full_name  # => "Tim Cook"
+```
+
+#### 13. FWE - Find Work Email
+```ruby
+result = sdk.fwe(linkedin_url: "linkedin.com/in/tim-cook")
+puts result.email  # => "tim.cook@apple.com"
+```
+
+#### 14. TEP - Title Email Phone
+```ruby
+result = sdk.tep(full_name: "Tim Cook", company: "Apple Inc")
+puts result.person.email  # => "tim.cook@apple.com"
+puts result.person.phone  # => "+1-408-996-1010"
+```
+
+#### 15. ENC - Enrich Company
+```ruby
+result = sdk.enc(query: "Apple Inc")
+puts result.company.employee_count  # => 164000
+```
+
+#### 16. CEC - Company Employee Count
+```ruby
+result = sdk.cec(query: "Apple Inc")
+puts result.countries  # => {"US" => 100000, "CA" => 5000}
+```
+
+#### 17. CLO - Company Locations
+```ruby
+result = sdk.clo(query: "Apple Inc")
+puts result.locations.first.city  # => "Cupertino"
+```
+
+#### 18. CSE - Company Search Engine
+```ruby
+result = sdk.cse(name: "tech", country: "US", industry: "software")
+puts result.companies.length  # => 50
+```
+
+#### 19. PSE - Person Search Engine
+```ruby
+result = sdk.pse(full_name: "John", country: "US", company_name: "Apple")
+puts result.peoples.length  # => 25
+```
+
+#### 20. LBS - Local Business Search
+```ruby
+result = sdk.lbs(name: "restaurant", city: "New York")
+puts result.companies.length  # => 100
+```
+
+### Error Handling
+
+The SDK provides comprehensive error handling:
+
+```ruby
+begin
+  result = sdk.cuf(company_name: "Apple Inc", country_code: "US")
+rescue CufinderRuby::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+rescue CufinderRuby::RateLimitError => e
+  puts "Rate limit exceeded: #{e.message}"
+rescue CufinderRuby::CreditLimitError => e
+  puts "Credit limit exceeded: #{e.message}"
+rescue CufinderRuby::ApiError => e
+  puts "API error #{e.status}: #{e.message}"
+rescue CufinderRuby::ValidationError => e
+  puts "Validation error: #{e.message}"
+end
+```
+
+### Configuration
+
+You can configure the SDK with custom settings:
+
+```ruby
+sdk = CufinderRuby::SDK.new(
+  api_key: 'your-api-key',
+  base_url: 'https://api.cufinder.io/v2',  # Default
+  timeout: 30,                              # Default
+  max_retries: 3                           # Default
+)
+```
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies. Then, run `rake spec` to run the tests.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/cufinder/cufinder-ruby.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/cufinder-ruby.gemspec

@@ -0,0 +1,29 @@
+Gem::Specification.new do |spec|
+  spec.name          = "cufinder-ruby"
+  spec.version       = "0.0.1"
+  spec.authors       = ["CUFinder Team"]
+  spec.email         = ["support@cufinder.io"]
+
+  spec.summary       = "Ruby SDK for the CUFinder API"
+  spec.description   = "Official Ruby SDK for accessing CUFinder's services"
+  spec.homepage      = "https://github.com/cufinder/cufinder-ruby"
+  spec.license       = "MIT"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/cufinder/cufinder-ruby"
+  spec.metadata["changelog_uri"] = "https://github.com/cufinder/cufinder-ruby/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "httparty", "~> 0.21"
+  spec.add_dependency "json", "~> 2.6"
+
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "webmock", "~> 3.18"
+  spec.add_development_dependency "rake", "~> 13.0"
+end

data/lib/cufinder_ruby/client.rb

@@ -0,0 +1,84 @@
+require "httparty"
+require "json"
+require "cufinder_ruby/errors"
+
+module CufinderRuby
+  class Client
+    include HTTParty
+    
+    attr_reader :api_key, :base_url, :timeout, :max_retries
+    
+    def initialize(api_key:, base_url: "https://api.cufinder.io/v2", timeout: 30, max_retries: 3)
+      @api_key = api_key
+      @base_url = base_url
+      @timeout = timeout
+      @max_retries = max_retries
+      
+      self.class.base_uri base_url
+      self.class.timeout timeout
+      self.class.headers "User-Agent" => "cufinder-ruby/#{CufinderRuby::VERSION}"
+    end
+    
+    def post(endpoint, data)
+      response = self.class.post(
+        endpoint,
+        body: form_encode(data),
+        headers: {
+          "x-api-key" => api_key,
+          "Content-Type" => "application/x-www-form-urlencoded"
+        }
+      )
+      
+      handle_response(response)
+    end
+    
+    private
+    
+    def form_encode(data)
+      return "" if data.nil? || data.empty?
+      
+      data.map do |key, value|
+        next if value.nil?
+        
+        if value.is_a?(Array)
+          value.map { |v| "#{key}=#{CGI.escape(v.to_s)}" }.join("&")
+        else
+          "#{key}=#{CGI.escape(value.to_s)}"
+        end
+      end.compact.join("&")
+    end
+    
+    def handle_response(response)
+      case response.code
+      when 200..299
+        extract_data(response.parsed_response)
+      when 401
+        raise AuthenticationError, response.body
+      when 402
+        raise CreditLimitError, response.body
+      when 429
+        raise RateLimitError, response.body
+      else
+        raise ApiError.new(response.code, response.body)
+      end
+    rescue JSON::ParserError => e
+      raise HttpError, "Failed to parse response: #{e.message}"
+    rescue HTTParty::Error => e
+      raise HttpError, "HTTP request failed: #{e.message}"
+    end
+    
+    def extract_data(response_data)
+      # Extract data from wrapper if present (similar to Go SDK's mapToStruct)
+      if response_data.is_a?(Hash) && response_data.key?("data")
+        data = response_data["data"]
+        # Add meta_data if it exists in the outer response
+        if response_data.key?("meta_data")
+          data["meta_data"] = response_data["meta_data"]
+        end
+        data
+      else
+        response_data
+      end
+    end
+  end
+end

data/lib/cufinder_ruby/errors.rb

@@ -0,0 +1,19 @@
+module CufinderRuby
+  class Error < StandardError; end
+  
+  class AuthenticationError < Error; end
+  class RateLimitError < Error; end
+  class CreditLimitError < Error; end
+  class ApiError < Error
+    attr_reader :status, :message
+    
+    def initialize(status, message)
+      @status = status
+      @message = message
+      super("API Error #{status}: #{message}")
+    end
+  end
+  
+  class HttpError < Error; end
+  class ValidationError < Error; end
+end

data/lib/cufinder_ruby/sdk.rb

@@ -0,0 +1,99 @@
+require "cufinder_ruby/client"
+require "cufinder_ruby/services"
+
+module CufinderRuby
+  class SDK
+    attr_reader :client, :services
+    
+    def initialize(api_key:, base_url: "https://api.cufinder.io/v2", timeout: 30, max_retries: 3)
+      @client = Client.new(
+        api_key: api_key,
+        base_url: base_url,
+        timeout: timeout,
+        max_retries: max_retries
+      )
+      @services = Services.new(@client)
+    end
+    
+    # Convenience methods for each service
+    def cuf(company_name:, country_code:)
+      @services.get_domain(company_name: company_name, country_code: country_code)
+    end
+    
+    def lcuf(company_name:)
+      @services.get_linkedin_url(company_name: company_name)
+    end
+    
+    def dtc(company_website:)
+      @services.get_company_name(company_website: company_website)
+    end
+    
+    def dte(company_website:)
+      @services.get_emails(company_website: company_website)
+    end
+    
+    def ntp(company_name:)
+      @services.get_phones(company_name: company_name)
+    end
+    
+    def rel(email:)
+      @services.get_person_by_email(email: email)
+    end
+    
+    def fcl(query:)
+      @services.find_company_lookalikes(query: query)
+    end
+    
+    def elf(query:)
+      @services.enrich_linkedin_fundraising(query: query)
+    end
+    
+    def car(query:)
+      @services.get_annual_revenue(query: query)
+    end
+    
+    def fcc(query:)
+      @services.find_company_children(query: query)
+    end
+    
+    def fts(query:)
+      @services.find_tech_stack(query: query)
+    end
+    
+    def epp(linkedin_url:)
+      @services.enrich_person_profile(linkedin_url: linkedin_url)
+    end
+    
+    def fwe(linkedin_url:)
+      @services.find_work_email(linkedin_url: linkedin_url)
+    end
+    
+    def tep(full_name:, company:)
+      @services.get_title_email_phone(full_name: full_name, company: company)
+    end
+    
+    def enc(query:)
+      @services.enrich_company(query: query)
+    end
+    
+    def cec(query:)
+      @services.get_company_employee_count(query: query)
+    end
+    
+    def clo(query:)
+      @services.get_company_locations(query: query)
+    end
+    
+    def cse(**params)
+      @services.search_companies(params)
+    end
+    
+    def pse(**params)
+      @services.search_people(params)
+    end
+    
+    def lbs(**params)
+      @services.search_local_businesses(params)
+    end
+  end
+end

data/lib/cufinder_ruby/services.rb

@@ -0,0 +1,178 @@
+require "cufinder_ruby/client"
+require "cufinder_ruby/types"
+require "cufinder_ruby/errors"
+
+module CufinderRuby
+  class Services
+    def initialize(client)
+      @client = client
+    end
+    
+    # CUF Service - Company URL Finder
+    def get_domain(params)
+      validate_required(params, [:company_name, :country_code])
+      
+      response = @client.post("/cuf", params)
+      CufResponse.new(response)
+    end
+    
+    # LCUF Service - LinkedIn Company URL Finder
+    def get_linkedin_url(params)
+      validate_required(params, [:company_name])
+      
+      response = @client.post("/lcuf", params)
+      LcufResponse.new(response)
+    end
+    
+    # DTC Service - Domain to Company
+    def get_company_name(params)
+      validate_required(params, [:company_website])
+      
+      response = @client.post("/dtc", params)
+      DtcResponse.new(response)
+    end
+    
+    # DTE Service - Domain to Emails
+    def get_emails(params)
+      validate_required(params, [:company_website])
+      
+      response = @client.post("/dte", params)
+      DteResponse.new(response)
+    end
+    
+    # NTP Service - Name to Phones
+    def get_phones(params)
+      validate_required(params, [:company_name])
+      
+      response = @client.post("/ntp", params)
+      NtpResponse.new(response)
+    end
+    
+    # REL Service - Reverse Email Lookup
+    def get_person_by_email(params)
+      validate_required(params, [:email])
+      
+      response = @client.post("/rel", params)
+      RelResponse.new(response)
+    end
+    
+    # FCL Service - Find Company Lookalikes
+    def find_company_lookalikes(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/fcl", params)
+      FclResponse.new(response)
+    end
+    
+    # ELF Service - Enrich LinkedIn Fundraising
+    def enrich_linkedin_fundraising(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/elf", params)
+      ElfResponse.new(response)
+    end
+    
+    # CAR Service - Company Annual Revenue
+    def get_annual_revenue(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/car", params)
+      CarResponse.new(response)
+    end
+    
+    # FCC Service - Find Company Children
+    def find_company_children(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/fcc", params)
+      FccResponse.new(response)
+    end
+    
+    # FTS Service - Find Tech Stack
+    def find_tech_stack(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/fts", params)
+      FtsResponse.new(response)
+    end
+    
+    # EPP Service - Enrich Person Profile
+    def enrich_person_profile(params)
+      validate_required(params, [:linkedin_url])
+      
+      response = @client.post("/epp", params)
+      EppResponse.new(response)
+    end
+    
+    # FWE Service - Find Work Email
+    def find_work_email(params)
+      validate_required(params, [:linkedin_url])
+      
+      response = @client.post("/fwe", params)
+      FweResponse.new(response)
+    end
+    
+    # TEP Service - Title Email Phone
+    def get_title_email_phone(params)
+      validate_required(params, [:full_name, :company])
+      
+      response = @client.post("/tep", params)
+      TepResponse.new(response)
+    end
+    
+    # ENC Service - Enrich Company
+    def enrich_company(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/enc", params)
+      EncResponse.new(response)
+    end
+    
+    # CEC Service - Company Employee Count
+    def get_company_employee_count(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/cec", params)
+      CecResponse.new(response)
+    end
+    
+    # CLO Service - Company Locations
+    def get_company_locations(params)
+      validate_required(params, [:query])
+      
+      response = @client.post("/clo", params)
+      CloResponse.new(response)
+    end
+    
+    # CSE Service - Company Search Engine
+    def search_companies(params)
+      # All parameters are optional for CSE
+      response = @client.post("/cse", params)
+      CseResponse.new(response)
+    end
+    
+    # PSE Service - Person Search Engine
+    def search_people(params)
+      # All parameters are optional for PSE
+      response = @client.post("/pse", params)
+      PseResponse.new(response)
+    end
+    
+    # LBS Service - Local Business Search
+    def search_local_businesses(params)
+      # All parameters are optional for LBS
+      response = @client.post("/lbs", params)
+      LbsResponse.new(response)
+    end
+    
+    private
+    
+    def validate_required(params, required_fields)
+      missing_fields = required_fields.select { |field| params[field].nil? || params[field].to_s.strip.empty? }
+      
+      unless missing_fields.empty?
+        raise ValidationError, "Missing required fields: #{missing_fields.join(', ')}"
+      end
+    end
+  end
+end

data/lib/cufinder_ruby/types.rb

@@ -0,0 +1,521 @@
+module CufinderRuby
+  # Base response structure for all CUFinder API responses
+  class BaseResponse
+    attr_accessor :query, :credit_count, :meta_data, :confidence_level
+    
+    def initialize(data = {})
+      @query = data["query"]
+      @credit_count = data["credit_count"]
+      @meta_data = data["meta_data"]
+      @confidence_level = data["confidence_level"]
+    end
+  end
+  
+  # Company main location
+  class MainLocation
+    attr_accessor :geo, :country, :state, :city, :address, :continent, :postal_code
+    
+    def initialize(data = {})
+      @geo = data["geo"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @address = data["address"]
+      @continent = data["continent"]
+      @postal_code = data["postal_code"]
+    end
+  end
+  
+  # Company social media information
+  class CompanySocial
+    attr_accessor :facebook, :linkedin, :twitter, :youtube, :instagram
+    
+    def initialize(data = {})
+      @facebook = data["facebook"]
+      @linkedin = data["linkedin"]
+      @twitter = data["twitter"]
+      @youtube = data["youtube"]
+      @instagram = data["instagram"]
+    end
+  end
+  
+  # Company employee information
+  class CompanyEmployees
+    attr_accessor :range, :count
+    
+    def initialize(data = {})
+      @range = data["range"]
+      @count = data["count"]
+    end
+  end
+  
+  # Company information model
+  class Company
+    attr_accessor :name, :domain, :linkedin_url, :industry, :overview, :type, :size,
+                  :main_location, :location, :description, :founded, :revenue,
+                  :employees, :website, :phone, :email, :social, :technologies,
+                  :subsidiaries, :headquarters, :country, :state, :city, :zip_code, :address
+    
+    def initialize(data = {})
+      @name = data["name"]
+      @domain = data["domain"]
+      @linkedin_url = data["linkedin_url"]
+      @industry = data["industry"]
+      @overview = data["overview"]
+      @type = data["type"]
+      @size = data["size"]
+      @main_location = data["main_location"] ? MainLocation.new(data["main_location"]) : nil
+      @location = data["location"]
+      @description = data["description"]
+      @founded = data["founded"]
+      @revenue = data["revenue"]
+      @employees = data["employees"] ? CompanyEmployees.new(data["employees"]) : nil
+      @website = data["website"]
+      @phone = data["phone"]
+      @email = data["email"]
+      @social = data["social"] ? CompanySocial.new(data["social"]) : nil
+      @technologies = data["technologies"]
+      @subsidiaries = data["subsidiaries"]
+      @headquarters = data["headquarters"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @zip_code = data["zip_code"]
+      @address = data["address"]
+    end
+  end
+  
+  # Person location information
+  class PersonLocation
+    attr_accessor :country, :state, :city
+    
+    def initialize(data = {})
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+    end
+  end
+  
+  # Person social media information
+  class PersonSocial
+    attr_accessor :linkedin_username, :linkedin_connections, :linkedin, :twitter, :facebook, :github
+    
+    def initialize(data = {})
+      @linkedin_username = data["linkedin_username"]
+      @linkedin_connections = data["linkedin_connections"]
+      @linkedin = data["linkedin"]
+      @twitter = data["twitter"]
+      @facebook = data["facebook"]
+      @github = data["github"]
+    end
+  end
+  
+  # Current job information
+  class CurrentJob
+    attr_accessor :title, :role, :level
+    
+    def initialize(data = {})
+      @title = data["title"]
+      @role = data["role"]
+      @level = data["level"]
+    end
+  end
+  
+  # Person information model
+  class Person
+    attr_accessor :first_name, :last_name, :full_name, :logo, :overview, :experience,
+                  :connections, :interests, :skills, :educations, :experiences,
+                  :certifications, :company, :location, :current_job, :social
+    
+    def initialize(data = {})
+      @first_name = data["first_name"]
+      @last_name = data["last_name"]
+      @full_name = data["full_name"]
+      @logo = data["logo"]
+      @overview = data["overview"]
+      @experience = data["experience"]
+      @connections = data["connections"]
+      @interests = data["interests"]
+      @skills = data["skills"]
+      @educations = data["educations"]
+      @experiences = data["experiences"]
+      @certifications = data["certifications"]
+      @company = data["company"] ? Company.new(data["company"]) : nil
+      @location = data["location"] ? PersonLocation.new(data["location"]) : nil
+      @current_job = data["current_job"] ? CurrentJob.new(data["current_job"]) : nil
+      @social = data["social"] ? PersonSocial.new(data["social"]) : nil
+    end
+  end
+  
+  # Response types for each service
+  class CufResponse < BaseResponse
+    attr_accessor :domain
+    
+    def initialize(data = {})
+      super(data)
+      @domain = data["domain"]
+    end
+  end
+  
+  class LcufResponse < BaseResponse
+    attr_accessor :linkedin_url
+    
+    def initialize(data = {})
+      super(data)
+      @linkedin_url = data["linkedin_url"]
+    end
+  end
+  
+  class DtcResponse < BaseResponse
+    attr_accessor :company_name
+    
+    def initialize(data = {})
+      super(data)
+      @company_name = data["company_name"]
+    end
+  end
+  
+  class DteResponse < BaseResponse
+    attr_accessor :emails
+    
+    def initialize(data = {})
+      super(data)
+      @emails = data["emails"] || []
+    end
+  end
+  
+  class NtpResponse < BaseResponse
+    attr_accessor :phones
+    
+    def initialize(data = {})
+      super(data)
+      @phones = data["phones"] || []
+    end
+  end
+  
+  # REL Person
+  class RelPerson
+    attr_accessor :full_name, :first_name, :last_name, :linkedin_url, :summary,
+                  :linkedin_followers, :facebook, :twitter, :avatar, :country,
+                  :state, :city, :job_title, :job_title_categories, :company_name,
+                  :company_linkedin, :company_website, :company_size, :company_industry,
+                  :company_facebook, :company_twitter, :company_country, :company_state, :company_city
+    
+    def initialize(data = {})
+      @full_name = data["full_name"]
+      @first_name = data["first_name"]
+      @last_name = data["last_name"]
+      @linkedin_url = data["linkedin_url"]
+      @summary = data["summary"]
+      @linkedin_followers = data["linkedin_followers"]
+      @facebook = data["facebook"]
+      @twitter = data["twitter"]
+      @avatar = data["avatar"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @job_title = data["job_title"]
+      @job_title_categories = data["job_title_categories"]
+      @company_name = data["company_name"]
+      @company_linkedin = data["company_linkedin"]
+      @company_website = data["company_website"]
+      @company_size = data["company_size"]
+      @company_industry = data["company_industry"]
+      @company_facebook = data["company_facebook"]
+      @company_twitter = data["company_twitter"]
+      @company_country = data["company_country"]
+      @company_state = data["company_state"]
+      @company_city = data["company_city"]
+    end
+  end
+  
+  class RelResponse < BaseResponse
+    attr_accessor :person
+    
+    def initialize(data = {})
+      super(data)
+      @person = data["person"] ? RelPerson.new(data["person"]) : nil
+    end
+  end
+  
+  # FCL Company
+  class FclCompany
+    attr_accessor :name, :website, :employee_count, :size, :industry, :description,
+                  :linkedin_url, :domain, :country, :state, :city, :address,
+                  :founded_year, :logo_url, :followers_count
+    
+    def initialize(data = {})
+      @name = data["name"]
+      @website = data["website"]
+      @employee_count = data["employee_count"]
+      @size = data["size"]
+      @industry = data["industry"]
+      @description = data["description"]
+      @linkedin_url = data["linkedin_url"]
+      @domain = data["domain"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @address = data["address"]
+      @founded_year = data["founded_year"]
+      @logo_url = data["logo_url"]
+      @followers_count = data["followers_count"]
+    end
+  end
+  
+  class FclResponse < BaseResponse
+    attr_accessor :companies
+    
+    def initialize(data = {})
+      super(data)
+      @companies = (data["companies"] || []).map { |c| FclCompany.new(c) }
+    end
+  end
+  
+  # ELF Fundraising
+  class ElfFundraising
+    attr_accessor :funding_last_round_type, :funding_ammount_currency_code,
+                  :funding_money_raised, :funding_last_round_investors_url
+    
+    def initialize(data = {})
+      @funding_last_round_type = data["funding_last_round_type"]
+      @funding_ammount_currency_code = data["funding_ammount_currency_code"]
+      @funding_money_raised = data["funding_money_raised"]
+      @funding_last_round_investors_url = data["funding_last_round_investors_url"]
+    end
+  end
+  
+  class ElfResponse < BaseResponse
+    attr_accessor :fundraising
+    
+    def initialize(data = {})
+      super(data)
+      @fundraising = data["fundraising_info"] ? ElfFundraising.new(data["fundraising_info"]) : nil
+    end
+  end
+  
+  class CarResponse < BaseResponse
+    attr_accessor :revenue
+    
+    def initialize(data = {})
+      super(data)
+      @revenue = data["annual_revenue"]
+    end
+  end
+  
+  class FccResponse < BaseResponse
+    attr_accessor :subsidiaries
+    
+    def initialize(data = {})
+      super(data)
+      @subsidiaries = data["subsidiaries"] || []
+    end
+  end
+  
+  class FtsResponse < BaseResponse
+    attr_accessor :technologies
+    
+    def initialize(data = {})
+      super(data)
+      @technologies = data["technologies"] || []
+    end
+  end
+  
+  # EPP Person
+  class EppPerson
+    attr_accessor :full_name, :first_name, :last_name, :linkedin_url, :summary,
+                  :linkedin_followers, :facebook, :twitter, :avatar, :country,
+                  :state, :city, :job_title, :job_title_categories, :company_name,
+                  :company_linkedin, :company_website, :company_size, :company_industry,
+                  :company_facebook, :company_twitter, :company_country, :company_state, :company_city
+    
+    def initialize(data = {})
+      @full_name = data["full_name"]
+      @first_name = data["first_name"]
+      @last_name = data["last_name"]
+      @linkedin_url = data["linkedin_url"]
+      @summary = data["summary"]
+      @linkedin_followers = data["linkedin_followers"]
+      @facebook = data["facebook"]
+      @twitter = data["twitter"]
+      @avatar = data["avatar"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @job_title = data["job_title"]
+      @job_title_categories = data["job_title_categories"]
+      @company_name = data["company_name"]
+      @company_linkedin = data["company_linkedin"]
+      @company_website = data["company_website"]
+      @company_size = data["company_size"]
+      @company_industry = data["company_industry"]
+      @company_facebook = data["company_facebook"]
+      @company_twitter = data["company_twitter"]
+      @company_country = data["company_country"]
+      @company_state = data["company_state"]
+      @company_city = data["company_city"]
+    end
+  end
+  
+  class EppResponse < BaseResponse
+    attr_accessor :person
+    
+    def initialize(data = {})
+      super(data)
+      @person = data["person"] ? EppPerson.new(data["person"]) : nil
+    end
+  end
+  
+  class FweResponse < BaseResponse
+    attr_accessor :email
+    
+    def initialize(data = {})
+      super(data)
+      @email = data["work_email"]
+    end
+  end
+  
+  # TEP Person
+  class TepPerson
+    attr_accessor :full_name, :first_name, :last_name, :linkedin_url, :summary,
+                  :linkedin_followers, :facebook, :twitter, :avatar, :country,
+                  :state, :city, :job_title, :job_title_categories, :company_name,
+                  :company_linkedin, :company_website, :company_size, :company_industry,
+                  :company_facebook, :company_twitter, :company_country, :company_state,
+                  :company_city, :email, :phone
+    
+    def initialize(data = {})
+      @full_name = data["full_name"]
+      @first_name = data["first_name"]
+      @last_name = data["last_name"]
+      @linkedin_url = data["linkedin_url"]
+      @summary = data["summary"]
+      @linkedin_followers = data["linkedin_followers"]
+      @facebook = data["facebook"]
+      @twitter = data["twitter"]
+      @avatar = data["avatar"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @job_title = data["job_title"]
+      @job_title_categories = data["job_title_categories"]
+      @company_name = data["company_name"]
+      @company_linkedin = data["company_linkedin"]
+      @company_website = data["company_website"]
+      @company_size = data["company_size"]
+      @company_industry = data["company_industry"]
+      @company_facebook = data["company_facebook"]
+      @company_twitter = data["company_twitter"]
+      @company_country = data["company_country"]
+      @company_state = data["company_state"]
+      @company_city = data["company_city"]
+      @email = data["email"]
+      @phone = data["phone"]
+    end
+  end
+  
+  class TepResponse < BaseResponse
+    attr_accessor :person
+    
+    def initialize(data = {})
+      super(data)
+      @person = data["person"] ? TepPerson.new(data["person"]) : nil
+    end
+  end
+  
+  # ENC Company
+  class EncCompany
+    attr_accessor :name, :website, :employee_count, :industry, :size, :description,
+                  :linkedin_url, :type, :domain, :country, :state, :city, :address,
+                  :founded_year, :logo_url, :followers_count
+    
+    def initialize(data = {})
+      @name = data["name"]
+      @website = data["website"]
+      @employee_count = data["employee_count"]
+      @industry = data["industry"]
+      @size = data["size"]
+      @description = data["description"]
+      @linkedin_url = data["linkedin_url"]
+      @type = data["type"]
+      @domain = data["domain"]
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @address = data["address"]
+      @founded_year = data["founded_year"]
+      @logo_url = data["logo_url"]
+      @followers_count = data["followers_count"]
+    end
+  end
+  
+  class EncResponse < BaseResponse
+    attr_accessor :company
+    
+    def initialize(data = {})
+      super(data)
+      @company = data["company"] ? EncCompany.new(data["company"]) : nil
+    end
+  end
+  
+  class CecResponse < BaseResponse
+    attr_accessor :countries
+    
+    def initialize(data = {})
+      super(data)
+      @countries = data["countries"]
+    end
+  end
+  
+  # CLO Location
+  class CloLocation
+    attr_accessor :country, :state, :city, :postal_code, :line1, :line2, :latitude, :longitude
+    
+    def initialize(data = {})
+      @country = data["country"]
+      @state = data["state"]
+      @city = data["city"]
+      @postal_code = data["postal_code"]
+      @line1 = data["line1"]
+      @line2 = data["line2"]
+      @latitude = data["latitude"]
+      @longitude = data["longitude"]
+    end
+  end
+  
+  class CloResponse < BaseResponse
+    attr_accessor :locations
+    
+    def initialize(data = {})
+      super(data)
+      @locations = (data["locations"] || []).map { |l| CloLocation.new(l) }
+    end
+  end
+  
+  class CseResponse < BaseResponse
+    attr_accessor :companies
+    
+    def initialize(data = {})
+      super(data)
+      @companies = (data["companies"] || []).map { |c| Company.new(c) }
+    end
+  end
+  
+  class PseResponse < BaseResponse
+    attr_accessor :peoples
+    
+    def initialize(data = {})
+      super(data)
+      @peoples = (data["peoples"] || []).map { |p| Person.new(p) }
+    end
+  end
+  
+  class LbsResponse < BaseResponse
+    attr_accessor :companies
+    
+    def initialize(data = {})
+      super(data)
+      @companies = (data["companies"] || []).map { |c| Company.new(c) }
+    end
+  end
+end

data/lib/cufinder_ruby/version.rb

@@ -0,0 +1,3 @@
+module CufinderRuby
+  VERSION = "0.0.1"
+end

data/lib/cufinder_ruby.rb

@@ -0,0 +1,8 @@
+require "cufinder_ruby/version"
+require "cufinder_ruby/client"
+require "cufinder_ruby/sdk"
+require "cufinder_ruby/errors"
+
+module CufinderRuby
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: cufinder-ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- CUFinder Team
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-10-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Official Ruby SDK for accessing CUFinder's services
+email:
+- support@cufinder.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- cufinder-ruby.gemspec
+- lib/cufinder_ruby.rb
+- lib/cufinder_ruby/client.rb
+- lib/cufinder_ruby/errors.rb
+- lib/cufinder_ruby/sdk.rb
+- lib/cufinder_ruby/services.rb
+- lib/cufinder_ruby/types.rb
+- lib/cufinder_ruby/version.rb
+homepage: https://github.com/cufinder/cufinder-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/cufinder/cufinder-ruby
+  source_code_uri: https://github.com/cufinder/cufinder-ruby
+  changelog_uri: https://github.com/cufinder/cufinder-ruby/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: Ruby SDK for the CUFinder API
+test_files: []