cufinder-ruby 0.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9f06c87746a02b9f3ba1003f43e859f96549c67061db0d66465ce919324400f
-  data.tar.gz: e304713de973c2cfa7de842e9788a2d49a17383dc540a9c7520ff6205f50dfcd
+  metadata.gz: 933505a753cc67ab4e2311cb44741da6ce2c89f186e2eaa36efad0adc2044a63
+  data.tar.gz: 8025f9c7eb01e26078c870967aba4d68af22ecab84242c93706279735620f555
 SHA512:
-  metadata.gz: 65e625f7ac41c7b61af9b3f672d5a4c9cae6243a28a62c099feb13dc8bfecefd3c388790d355c5b6c7a47ec544676ccee0da857b89a23d7fc8de05ef745ab7d6
-  data.tar.gz: a35579b44987e8aa8c2bb5a8ecad07da0c6dc4585cf3c0a08626b2202253e77da1b60000e7d6481bac5c11e906c84e8bba3e61685fddc008efd90ca4555eeb5b
+  metadata.gz: dcde541a1672ea1b08e82dade2fa76f5c7c5a2aecc81dff9900875b7acd15794e58ffc8b3bbea0aca6e71cafb23e230bd097c767b9665cd6da1c6f78115ded29
+  data.tar.gz: 2c6b4ff7797fe5b818d57673fcd06c9c3ea810f909ff1598763424bdb281d85c79ca44933f40a123ca20f35fce8870d5cfcbe6e670e63d198b025312ee433203

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Cufinder Ruby SDK Changelog
+
+
+## 1.1.0 (February 01, 2026)
+
+#### Features
+- **New V2 API services**: Add new V2 services including `BCD`, `CCP`, `ISC`, `CBC`, `CSC`, `CSN`, `NAO` and `NAA`
+
+
+#### Documentation
+- **Updated README.md**: Add API reference for all new services

data/README.md

@@ -1,6 +1,19 @@
 # CUFinder Ruby SDK
 
-Official Ruby SDK for accessing CUFinder's comprehensive business intelligence and lead generation services.
+[![](https://img.shields.io/badge/repo%20status-Active-28a745)](https://github.com/cufinder/cufinder-ruby)
+[![License: MIT](https://img.shields.io/badge/License-MIT-514BEE.svg)](https://opensource.org/licenses/MIT)
+[![Gem Version](https://img.shields.io/gem/v/cufinder-ruby.svg)](https://rubygems.org/gems/cufinder-ruby)
+
+A Ruby SDK for the CUFinder API that provides access to all company and person enrichment services.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [API Reference](#api-reference)
+- [Error Handling](#error-handling)
+- [Types](#types)
+- [Support](#support)
 
 ## Installation
 
@@ -24,183 +37,439 @@ 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')
+# Initialize the client
+client = Cufinder::Client.new(api_key: 'your-api-key-here')
+
+# Initialize with more options
+client = Cufinder::Client.new(
+  api_key: 'your-api-key-here',
+  timeout: 60,
+  max_retries: 3
+)
+```
+
+## API Reference
+
+This SDK covers all 28 Cufinder API (v2) endpoints:
+
+- **CUF** - [Company Name to Domain](https://apidoc.cufinder.io/apis/company-name-to-domain)
+- **LCUF** - [LinkedIn Company URL Finder](https://apidoc.cufinder.io/apis/company-linkedin-url-finder)
+- **DTC** - [Domain to Company Name](https://apidoc.cufinder.io/apis/domain-to-company-name)
+- **DTE** - [Company Email Finder](https://apidoc.cufinder.io/apis/company-email-finder)
+- **NTP** - [Company Phone Finder](https://apidoc.cufinder.io/apis/company-phone-finder)
+- **REL** - [Reverse Email Lookup](https://apidoc.cufinder.io/apis/reverse-email-lookup)
+- **FCL** - [Company Lookalikes Finder](https://apidoc.cufinder.io/apis/company-lookalikes-finder)
+- **ELF** - [Company Fundraising](https://apidoc.cufinder.io/apis/company-fundraising)
+- **CAR** - [Company Revenue Finder](https://apidoc.cufinder.io/apis/company-revenue-finder)
+- **FCC** - [Company Subsidiaries Finder](https://apidoc.cufinder.io/apis/company-subsidiaries-finder)
+- **FTS** - [Company Tech Stack Finder](https://apidoc.cufinder.io/apis/company-tech-stack-finder)
+- **EPP** - [LinkedIn Profile Enrichment](https://apidoc.cufinder.io/apis/linkedin-profile-enrichment)
+- **FWE** - [LinkedIn Profile Email Finder](https://apidoc.cufinder.io/apis/linkedin-profile-email-finder)
+- **TEP** - [Person Enrichment](https://apidoc.cufinder.io/apis/person-enrichment)
+- **ENC** - [Company Enrichment](https://apidoc.cufinder.io/apis/company-enrichment)
+- **CEC** - [Company Employee Count](https://apidoc.cufinder.io/apis/company-employee-count)
+- **CLO** - [Company Locations](https://apidoc.cufinder.io/apis/company-locations)
+- **CSE** - [Company Search](https://apidoc.cufinder.io/apis/company-search)
+- **PSE** - [Person Search](https://apidoc.cufinder.io/apis/person-search)
+- **LBS** - [Local Business Search (Google Maps Search API)](https://apidoc.cufinder.io/apis/local-business-search-google-maps-search-api)
+- **BCD** - [B2B Customers Finder](https://apidoc.cufinder.io/apis/b2b-customers-finder)
+- **CCP** - [Company Career Page Finder](https://apidoc.cufinder.io/apis/company-career-page-finder)
+- **ISC** - [Company Saas Checker](https://apidoc.cufinder.io/apis/company-saas-checker)
+- **CBC** - [Company B2B or B2C Checker](https://apidoc.cufinder.io/apis/company-b2b-or-b2c-checker)
+- **CSC** - [Company Mission Statement](https://apidoc.cufinder.io/apis/company-mission-statement)
+- **CSN** - [Company Snapshot](https://apidoc.cufinder.io/apis/company-snapshot)
+- **NAO** - [Phone Number Normalizer](https://apidoc.cufinder.io/apis/phone-number-normalizer)
+- **NAA** - [Address Normalizer](https://apidoc.cufinder.io/apis/address-normalizer)
+
+
+**CUF - Company Name to Domain**
+
+Returns the official website URL of a company based on its name.
+
+```ruby
+result = client.cuf(company_name: 'cufinder', country_code: 'US')
+puts result
 ```
 
-### Available Services
+**LCUF - LinkedIn Company URL Finder**
 
-The SDK provides access to all CUFinder API services:
+Finds the official LinkedIn company profile URL from a company name.
 
-#### 1. CUF - Company URL Finder
 ```ruby
-result = sdk.cuf(company_name: "Apple Inc", country_code: "US")
-puts result.domain  # => "apple.com"
+result = client.lcuf(company_name: 'cufinder')
+puts result
 ```
 
-#### 2. LCUF - LinkedIn Company URL Finder
+**DTC - Domain to Company Name**
+
+Retrieves the registered company name associated with a given website domain.
+
 ```ruby
-result = sdk.lcuf(company_name: "Apple Inc")
-puts result.linkedin_url  # => "linkedin.com/company/apple"
+result = client.dtc(company_website: 'cufinder.io')
+puts result
 ```
 
-#### 3. DTC - Domain to Company
+**DTE - Company Email Finder**
+
+Returns up to five general or role-based business email addresses for a company.
+
 ```ruby
-result = sdk.dtc(company_website: "apple.com")
-puts result.company_name  # => "Apple Inc"
+result = client.dte(company_website: 'cufinder.io')
+puts result
 ```
 
-#### 4. DTE - Domain to Emails
+**NTP - Company Phone Finder**
+
+Returns up to two verified phone numbers for a company.
+
+```ruby
+result = client.ntp(company_name: 'apple')
+puts result
+```
+
+**REL - Reverse Email Lookup**
+
+Enriches an email address with detailed person and company information.
+
 ```ruby
-result = sdk.dte(company_website: "apple.com")
-puts result.emails  # => ["contact@apple.com", "info@apple.com"]
+result = client.rel(email: 'iain.mckenzie@stripe.com')
+puts result
 ```
 
-#### 5. NTP - Name to Phones
+**FCL - Company Lookalikes Finder**
+
+Provides a list of similar companies based on an input company's profile.
+
+```ruby
+result = client.fcl(query: 'apple')
+puts result
+```
+
+**ELF - Company Fundraising**
+
+Returns detailed funding information about a company.
+
+```ruby
+result = client.elf(query: 'cufinder')
+puts result
+```
+
+**CAR - Company Revenue Finder**
+
+Estimates a company's annual revenue based on name.
+
+```ruby
+result = client.car(query: 'apple')
+puts result
+```
+
+**FCC - Company Subsidiaries Finder**
+
+Identifies known subsidiaries of a parent company.
+
+```ruby
+result = client.fcc(query: 'amazon')
+puts result
+```
+
+**FTS - Company Tech Stack Finder**
+
+Detects the technologies a company uses.
+
+```ruby
+result = client.fts(query: 'cufinder')
+puts result
+```
+
+**EPP - LinkedIn Profile Enrichment**
+
+Takes a LinkedIn profile URL and returns enriched person and company data.
+
+```ruby
+result = client.epp(linkedin_url: 'linkedin.com/in/iain-mckenzie')
+puts result
+```
+
+**FWE - LinkedIn Profile Email Finder**
+
+Extracts a verified business email address from a LinkedIn profile URL.
+
 ```ruby
-result = sdk.ntp(company_name: "Apple Inc")
-puts result.phones  # => ["+1-408-996-1010"]
+result = client.fwe(linkedin_url: 'linkedin.com/in/iain-mckenzie')
+puts result
 ```
 
-#### 6. REL - Reverse Email Lookup
+**TEP - Person Enrichment**
+
+Returns enriched person data based on full name and company name.
+
 ```ruby
-result = sdk.rel(email: "tim.cook@apple.com")
-puts result.person.full_name  # => "Tim Cook"
+result = client.tep(full_name: 'iain mckenzie', company: 'stripe')
+puts result
 ```
 
-#### 7. FCL - Find Company Lookalikes
+**ENC - Company Enrichment**
+
+Provides a complete company profile from a company name.
+
 ```ruby
-result = sdk.fcl(query: "tech startup")
-puts result.companies.length  # => 10
+result = client.enc(query: 'cufinder')
+puts result
 ```
 
-#### 8. ELF - Enrich LinkedIn Fundraising
+**CEC - Company Employee Count**
+
+Returns an estimated number of employees for a company.
+
 ```ruby
-result = sdk.elf(query: "tech company")
-puts result.fundraising.funding_money_raised  # => "$5M"
+result = client.cec(query: 'cufinder')
+puts result
 ```
 
-#### 9. CAR - Company Annual Revenue
+**CLO - Company Locations**
+
+Returns the known physical office locations of a company.
+
 ```ruby
-result = sdk.car(query: "Apple Inc")
-puts result.revenue  # => "$394.3B"
+result = client.clo(query: 'apple')
+puts result
 ```
 
-#### 10. FCC - Find Company Children
+**CSE - Company Search**
+
+Search for companies by keyword, partial name, industry, location, or other filters.
+
 ```ruby
-result = sdk.fcc(query: "Apple Inc")
-puts result.subsidiaries  # => ["Beats Electronics", "Shazam"]
+result = client.cse(
+  name: 'cufinder',
+  country: 'germany',
+  state: 'hamburg',
+  city: 'hamburg'
+)
+puts result
 ```
 
-#### 11. FTS - Find Tech Stack
+**PSE - Person Search**
+
+Search for people by name, company, job title, location, or other filters.
+
 ```ruby
-result = sdk.fts(query: "web development")
-puts result.technologies  # => ["React", "Node.js", "Python"]
+result = client.pse(
+  full_name: 'iain mckenzie',
+  company_name: 'stripe'
+)
+puts result
 ```
 
-#### 12. EPP - Enrich Person Profile
+**LBS - Local Business Search (Google Maps Search API)**
+
+Search for local businesses by location, industry, or name.
+
 ```ruby
-result = sdk.epp(linkedin_url: "linkedin.com/in/tim-cook")
-puts result.person.full_name  # => "Tim Cook"
+result = client.lbs(
+  country: 'united states',
+  state: 'california',
+  page: 1
+)
+puts result
 ```
 
-#### 13. FWE - Find Work Email
+**BCD - B2B Customers Finder**
+
+Returns company's careers page
+
 ```ruby
-result = sdk.fwe(linkedin_url: "linkedin.com/in/tim-cook")
-puts result.email  # => "tim.cook@apple.com"
+result = client.bcd(url: "stripe.com")
+puts result
 ```
 
-#### 14. TEP - Title Email Phone
+**CCP - Company Career Page Finder**
+
+Returns is company SaaS or not
+
 ```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"
+result = client.ccp(url: "stripe.com")
+puts result
 ```
 
-#### 15. ENC - Enrich Company
+**ISC - Company Saas Checker**
+
+Returns is company SaaS or not
+
 ```ruby
-result = sdk.enc(query: "Apple Inc")
-puts result.company.employee_count  # => 164000
+result = client.isc(url: "stripe.com")
+puts result
 ```
 
-#### 16. CEC - Company Employee Count
+**CBC - Company B2B or B2C Checker**
+
+Returns company's business type
+
 ```ruby
-result = sdk.cec(query: "Apple Inc")
-puts result.countries  # => {"US" => 100000, "CA" => 5000}
+result = client.cbc(url: "stripe.com")
+puts result
 ```
 
-#### 17. CLO - Company Locations
+**CSC - Company Mission Statement**
+
+Returns company's mission statement
+
 ```ruby
-result = sdk.clo(query: "Apple Inc")
-puts result.locations.first.city  # => "Cupertino"
+result = client.csc(url: "stripe.com")
+puts result
 ```
 
-#### 18. CSE - Company Search Engine
+**CSN - Company Snapshot**
+
+Returns company's snapshot information
+
 ```ruby
-result = sdk.cse(name: "tech", country: "US", industry: "software")
-puts result.companies.length  # => 50
+result = client.csn(url: "stripe.com")
+puts result
 ```
 
-#### 19. PSE - Person Search Engine
+**NAO - Phone Number Normalizer**
+
+Returns normalized phone
+
 ```ruby
-result = sdk.pse(full_name: "John", country: "US", company_name: "Apple")
-puts result.peoples.length  # => 25
+result = client.nao(phone: "+18006676389")
+puts result
 ```
 
-#### 20. LBS - Local Business Search
+**NAA - Address Normalizer**
+
+Returns normalized address
+
 ```ruby
-result = sdk.lbs(name: "restaurant", city: "New York")
-puts result.companies.length  # => 100
+result = client.naa(address: "1095 avenue of the Americas, 6th Avenue ny 10036")
+puts result
 ```
 
-### Error Handling
+## Error Handling
 
-The SDK provides comprehensive error handling:
+The SDK provides comprehensive error handling with custom error types:
 
 ```ruby
+require 'cufinder_ruby'
+
 begin
-  result = sdk.cuf(company_name: "Apple Inc", country_code: "US")
-rescue CufinderRuby::AuthenticationError => e
+  result = client.cuf(company_name: 'cufinder', country_code: 'US')
+rescue Cufinder::AuthenticationError => e
+  # 401 - Invalid API key
   puts "Authentication failed: #{e.message}"
-rescue CufinderRuby::RateLimitError => e
+rescue Cufinder::CreditLimitError => e
+  # 400 - Not enough credit
+  puts "Not enough credit: #{e.message}"
+rescue Cufinder::NotFoundError => e
+  # 404 - Not found result
+  puts "Not found result: #{e.message}"
+rescue Cufinder::PayloadError => e
+  # 422 - Error in the payload
+  puts "Payload error: #{e.message}"
+rescue Cufinder::RateLimitError => e
+  # 429 - Rate limit exceeded
   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
+rescue Cufinder::ServerError => e
+  # 500, 501, ... - Server errors
+  puts "Server error (#{e.status}): #{e.message}"
+rescue Cufinder::NetworkError => e
+  puts "Network error: #{e.message}"
+rescue Cufinder::ValidationError => e
   puts "Validation error: #{e.message}"
+rescue Cufinder::ApiError => e
+  puts "Unknown error: #{e.message}"
 end
 ```
 
-### Configuration
+## Types
 
-You can configure the SDK with custom settings:
+The SDK exports comprehensive Ruby classes for all API requests and responses:
 
 ```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
-)
-```
+# Response classes
+class BaseResponse
+  attr_reader :query, :credit_count
+end
+
+# Model classes
+class Company
+  # The Company class contains all returned company data.
+  attr_reader :name, :domain, :website, :linkedin_url
+  attr_reader :country, :state, :city, :address
+  attr_reader :industry, :company_size, :revenue
+  attr_reader :employee_count, :subsidiaries, :tech_stack
+  attr_reader :emails, :phones, :description
+  attr_reader :locations, :founded_year, :logo_url
+end
 
-## Development
+class Person
+  # The Person class contains all returned person data.
+  attr_reader :full_name, :first_name, :last_name
+  attr_reader :company_name, :company_domain, :job_title
+  attr_reader :country, :state, :city
+  attr_reader :email, :phone, :description, :linkedin_url
+end
 
-After checking out the repo, run `bundle install` to install dependencies. Then, run `rake spec` to run the tests.
+class LookalikeCompany
+  # The LookalikeCompany class contains all returned lookalike company data.
+  attr_reader :name, :domain, :website, :linkedin_url
+  attr_reader :country, :state, :city, :address
+  attr_reader :industry, :company_size, :revenue
+  attr_reader :employee_count, :subsidiaries, :tech_stack
+  attr_reader :emails, :phones, :description
+  attr_reader :locations, :founded_year, :logo_url
+end
 
-To install this gem onto your local machine, run `bundle exec rake install`.
+class FundraisingInfo
+  attr_reader :funding_last_round_type
+  attr_reader :funding_ammount_currency_code
+  attr_reader :funding_money_raised
+  attr_reader :funding_last_round_investors_url
+end
 
-## Contributing
+class CompanyLocation
+  # The CompanyLocation class contains all returned company location data.
+  attr_reader :country, :state, :city, :postal_code
+  attr_reader :line1, :line2, :latitude, :longitude
+end
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/cufinder/cufinder-ruby.
+class CompanySearchResult
+  attr_reader :companies, :total_results, :page
+  attr_reader :query, :credit_count
+end
+
+class PersonSearchResult
+  attr_reader :peoples, :total_results, :page
+  attr_reader :query, :credit_count
+end
+
+class LocalBusinessResult
+  attr_reader :businesses, :total_results, :page
+  attr_reader :query, :credit_count
+end
+
+# Configuration
+class ClientConfig
+  attr_accessor :api_key, :base_url, :timeout, :max_retries
+end
+
+# Error classes
+class CufinderError < StandardError; end
+class AuthenticationError < CufinderError; end
+class CreditLimitError < CufinderError; end
+class NotFoundError < CufinderError; end
+class PayloadError < CufinderError; end
+class RateLimitError < CufinderError; end
+class ServerError < CufinderError; end
+class NetworkError < CufinderError; end
+class ValidationError < CufinderError; end
+class ApiError < CufinderError; end
+```
 
-## License
+## Support
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+For support, please open an issue on the [GitHub repository](https://github.com/cufinder/cufinder-ruby/issues).

data/cufinder-ruby.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "cufinder-ruby"
-  spec.version       = "0.0.1"
+  spec.version       = "1.1.0"
   spec.authors       = ["CUFinder Team"]
   spec.email         = ["support@cufinder.io"]
 

data/lib/cufinder_ruby/base_api_client.rb

@@ -0,0 +1,84 @@
+require "httparty"
+require "json"
+require "cufinder_ruby/errors"
+
+module Cufinder
+  class BaseApiClient
+    include HTTParty
+    
+    attr_reader :api_key, :base_url, :timeout, :max_retries
+    
+    def initialize(api_key:, timeout: 30, max_retries: 3)
+      @api_key = api_key
+      @base_url = "https://api.cufinder.io/v2"
+      @timeout = timeout
+      @max_retries = max_retries
+      
+      self.class.base_uri @base_url
+      self.class.headers "User-Agent" => "cufinder-ruby/#{Cufinder::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"
+        },
+        timeout: @timeout
+      )
+      
+      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/client.rb

@@ -1,84 +1,145 @@
-require "httparty"
-require "json"
-require "cufinder_ruby/errors"
+require "cufinder_ruby/base_api_client"
+require "cufinder_ruby/services"
 
-module CufinderRuby
+module Cufinder
+  # Main client class for interacting with the CUFinder API
+  # 
+  # This is the primary entry point for all API operations.
+  # It provides convenient methods for each service and handles
+  # authentication and HTTP communication internally.
+  #
+  # @example Basic usage
+  #   client = Cufinder::Client.new(api_key: 'your-api-key')
+  #   result = client.cuf(company_name: 'Example Corp', country_code: 'US')
+  #
   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"
-        }
+    attr_reader :client, :services
+    
+    # Initialize a new CUFinder client
+    #
+    # @param api_key [String] Your CUFinder API key
+    # @param timeout [Integer] Request timeout in seconds (default: 30)
+    # @param max_retries [Integer] Maximum number of retries (default: 3)
+    def initialize(api_key:, timeout: 30, max_retries: 3)
+      @client = BaseApiClient.new(
+        api_key: api_key,
+        timeout: timeout,
+        max_retries: max_retries
       )
-      
-      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
+      @services = Services.new(@client)
+    end
+    
+    # Service methods - Each method corresponds to a CUFinder API 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
+
+    def bcd(url:)
+      @services.extract_b2b_customers(url: url)
+    end
+
+    def ccp(url:)
+      @services.find_company_careers_page(url: url)
+    end
+
+    def isc(url:)
+      @services.is_saas(url: url)
+    end
+
+    def cbc(url:)
+      @services.get_company_business_type(url: url)
+    end
+
+    def csc(url:)
+      @services.get_company_mission_statement(url: url)
+    end
+
+    def csn(url:)
+      @services.get_company_snapshot(url: url)
+    end
+
+    def nao(phone:)
+      @services.normalize_phone(phone: phone)
+    end
+
+    def naa(address:)
+      @services.normalize_address(address: address)
     end
   end
 end

data/lib/cufinder_ruby/errors.rb

@@ -1,4 +1,4 @@
-module CufinderRuby
+module Cufinder
   class Error < StandardError; end
   
   class AuthenticationError < Error; end

data/lib/cufinder_ruby/services.rb

@@ -1,8 +1,8 @@
-require "cufinder_ruby/client"
+require "cufinder_ruby/base_api_client"
 require "cufinder_ruby/types"
 require "cufinder_ruby/errors"
 
-module CufinderRuby
+module Cufinder
   class Services
     def initialize(client)
       @client = client
@@ -164,6 +164,70 @@ module CufinderRuby
       response = @client.post("/lbs", params)
       LbsResponse.new(response)
     end
+
+    # BCD Service - B2B Customers Finder
+    def extract_b2b_customers(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/bcd", params)
+      BcdResponse.new(response)
+    end
+
+    # CCP Service - Company Career Page Finder
+    def find_company_careers_page(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/ccp", params)
+      CcpResponse.new(response)
+    end
+
+    # ISC Service - Company Saas Checker
+    def is_saas(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/isc", params)
+      IscResponse.new(response)
+    end
+
+    # CBC Service - Company B2B or B2C Checker
+    def get_company_business_type(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/cbc", params)
+      CbcResponse.new(response)
+    end
+
+    # CSC Service - Company Mission Statement
+    def get_company_mission_statement(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/csc", params)
+      CscResponse.new(response)
+    end
+
+    # CSN Service - Company Snapshot
+    def get_company_snapshot(params)
+      validate_required(params, [:url])
+      
+      response = @client.post("/csn", params)
+      CsnResponse.new(response)
+    end
+
+    # Nao Service - Phone Number Normalizer
+    def normalize_phone(params)
+      validate_required(params, [:phone])
+      
+      response = @client.post("/nao", params)
+      NaoResponse.new(response)
+    end
+
+    # Naa Service - Address Normalizer
+    def normalize_address(params)
+      validate_required(params, [:address])
+      
+      response = @client.post("/naa", params)
+      NaaResponse.new(response)
+    end
     
     private
     

data/lib/cufinder_ruby/types.rb

@@ -1,4 +1,4 @@
-module CufinderRuby
+module Cufinder
   # Base response structure for all CUFinder API responses
   class BaseResponse
     attr_accessor :query, :credit_count, :meta_data, :confidence_level
@@ -518,4 +518,87 @@ module CufinderRuby
       @companies = (data["companies"] || []).map { |c| Company.new(c) }
     end
   end
+  
+  class BcdResponse < BaseResponse
+    attr_accessor :customers
+    
+    def initialize(data = {})
+      super(data)
+      @customers = data["customers"] || []
+    end
+  end
+  
+  class CcpResponse < BaseResponse
+    attr_accessor :customers
+    
+    def initialize(data = {})
+      super(data)
+      @careers_page_url = data["careers_page_url"]
+    end
+  end
+  
+  class IscResponse < BaseResponse
+    attr_accessor :is_saas
+    
+    def initialize(data = {})
+      super(data)
+      @is_saas = data["is_saas"]
+    end
+  end
+  
+  class CbcResponse < BaseResponse
+    attr_accessor :business_type
+    
+    def initialize(data = {})
+      super(data)
+      @business_type = data["business_type"]
+    end
+  end
+  
+  class CscResponse < BaseResponse
+    attr_accessor :mission_statement
+    
+    def initialize(data = {})
+      super(data)
+      @mission_statement = data["mission_statement"]
+    end
+  end
+
+  class CsnSnapshotInfo
+    attr_accessor :icp, :target_industries, :target_personas, :value_proposition
+    
+    def initialize(data = {})
+      @icp = data["icp"]
+      @target_industries = data["target_industries"] || []
+      @target_personas = data["target_personas"]
+      @value_proposition = data["value_proposition"]
+    end
+  end
+
+  class CsnResponse < BaseResponse
+    attr_accessor :company_snapshot
+    
+    def initialize(data = {})
+      super(data)
+      @company_snapshot = data["company_snapshot"] ? CsnSnapshotInfo.new(data["company_snapshot"]) : nil
+    end
+  end
+
+  class NaoResponse < BaseResponse
+    attr_accessor :phone
+    
+    def initialize(data = {})
+      super(data)
+      @phone = data["phone"]
+    end
+  end
+
+  class NaaResponse < BaseResponse
+    attr_accessor :address
+    
+    def initialize(data = {})
+      super(data)
+      @address = data["address"]
+    end
+  end
 end

data/lib/cufinder_ruby/version.rb

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

data/lib/cufinder_ruby.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cufinder-ruby
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - CUFinder Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-12 00:00:00.000000000 Z
+date: 2026-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -89,15 +89,16 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - README.md
 - Rakefile
 - cufinder-ruby.gemspec
 - lib/cufinder_ruby.rb
+- lib/cufinder_ruby/base_api_client.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

data/lib/cufinder_ruby/sdk.rb

@@ -1,99 +0,0 @@
-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