Merge branch 'release/v1.4.0'

Author: MortezaHeydari97

CHANGELOG.md

@@ -1,9 +1,20 @@
 # Cufinder TypeScript SDK Changelog
 
+## 1.4.0 (January 29, 2025)
+
+#### 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
+
+
+
 ## 1.3.1 (November 5, 2025)
 
 #### Documentation
-- **Updated README.md**: Added API reference for all services
+- **Updated README.md**: Add API reference for all services
 
 
 
@@ -38,7 +49,7 @@
 - **Directory structure**: Changed from `src/` to `lib/` and `test/` to `tests/`
 
 #### Features
-- **Comprehensive V2 API services**: Added all V2 services including CUF, LCUF, DTC, DTE, TEP, CSE, PSE, LBS, and more
+- **Comprehensive V2 API services**: Added all V2 services including `CUF`, `LCUF`, `DTC`, `DTE`, `TEP`, `CSE`, `PSE`, `LBS`, and more
 - **Enhanced type safety**: All services now use explicit `Promise<ResponseType>` return types
 - **Extensive JSDoc documentation**: Added complete `@example` sections for all service methods and main client
 - **Improved error handling**: Better response parsing with automatic handling of API response wrapper format

README.md

@@ -65,6 +65,14 @@ This SDK covers all 20 Cufinder API (v2) endpoints:
 - **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**
@@ -259,6 +267,78 @@ const result = await client.lbs({
 console.log(result);
 ```
 
+**BCD - B2B Customers Finder**
+
+Returns company's careers page
+
+```typescript
+const result = await client.bcd('stripe.com');
+console.log(result);
+```
+
+**CCP - Company Career Page Finder**
+
+Returns is company SaaS or not
+
+```typescript
+const result = await client.ccp('stripe.com');
+console.log(result);
+```
+
+**ISC - Company Saas Checker**
+
+Returns is company SaaS or not
+
+```typescript
+const result = await client.isc('stripe.com')
+console.log(result.is_saas);
+```
+
+**CBC - Company B2B or B2C Checker**
+
+Returns company's business type
+
+```typescript
+const result = await client.cbc('stripe.com')
+console.log(result.business_type);
+```
+
+**CSC - Company Mission Statement**
+
+Returns company's mission statement
+
+```typescript
+const result = await client.csc('stripe.com')
+console.log(result.mission_statement);
+```
+
+**CSN - Company Snapshot**
+
+Returns company's snapshot information
+
+```typescript
+const result = await client.csn('stripe.com')
+console.log(result.company_snapshot);
+```
+
+**NAO - Phone Number Normalizer**
+
+Returns normalized phone
+
+```typescript
+const result = await client.nao('+18006676389')
+console.log(result.phone); // +1 800 667 6389
+```
+
+**NAA - Address Normalizer**
+
+Returns normalized address
+
+```typescript
+const result = await client.naa('1095 avenue of the Americas, 6th Avenue ny 10036')
+console.log(result.address); // 1095 AVENUE OF THE AMERICAS 6TH AVENUE NY 10036
+```
+
 ## Error Handling
 
 The SDK provides comprehensive error handling with custom error types:

lib/base_api_client.ts

@@ -38,7 +38,7 @@ export class BaseApiClient {
             headers: {
                 'x-api-key': config.apiKey,
                 'Content-Type': 'application/x-www-form-urlencoded',
-                'User-Agent': '@cufinder/cufinder-ts/1.3.1',
+                'User-Agent': '@cufinder/cufinder-ts/1.4.0',
             },
         });
 

lib/client.ts

@@ -1,9 +1,14 @@
 import { BaseApiClient } from './base_api_client';
 import {
+    BcdResponse,
     CarResponse,
+    CbcResponse,
+    CcpResponse,
     CecResponse,
     CloResponse,
+    CscResponse,
     CseResponse,
+    CsnResponse,
     CufResponse,
     DtcResponse,
     DteResponse,
@@ -14,8 +19,11 @@ import {
     FclResponse,
     FtsResponse,
     FweResponse,
+    IscResponse,
     LbsResponse,
     LcufResponse,
+    NaaResponse,
+    NaoResponse,
     NtpResponse,
     PseResponse,
     RelResponse,
@@ -25,10 +33,15 @@ import { CseParams, CufinderClientConfig, LbsParams, PseParams } from './shared/
 
 // Services
 import {
+    BcdService,
     CarService,
+    CbcService,
+    CcpService,
     CecService,
     CloService,
+    CscService,
     CseService,
+    CsnService,
     CufService,
     DtcService,
     DteService,
@@ -39,8 +52,11 @@ import {
     FclService,
     FtsService,
     FweService,
+    IscService,
     LbsService,
     LcufService,
+    NaaService,
+    NaoService,
     NtpService,
     PseService,
     RelService,
@@ -302,7 +318,7 @@ export class Cufinder {
     /**
      * Search for local businesses
      * @param params - Optional search parameters
-     * @returns Promise resolving to local business search results
+     * @returns The local business search results
      * @example
      * ```typescript
      * const result = await client.lbs({
@@ -315,6 +331,102 @@ export class Cufinder {
      */
     public readonly lbs: (params?: LbsParams) => Promise<LbsResponse>;
 
+    /**
+     * Extract B2B Customers From the Domain
+     * @param url - The domain to extract B2B customers for
+     * @returns List of business names
+     * @example
+     * ```typescript
+     * const result = await client.bcd('stripe.com');
+     * console.log(result);
+     * ```
+     */
+    public readonly bcd: (url: string) => Promise<BcdResponse>;
+
+    /**
+     * Find company careers page
+     * @param url - The company domain you want to find it's career page
+     * @returns Company's careers page
+     * @example
+     * ```typescript
+     * const result = await client.ccp('stripe.com');
+     * console.log(result);
+     * ```
+     */
+    public readonly ccp: (url: string) => Promise<CcpResponse>;
+
+    /**
+     * Check company you want to know is saas or not
+     * @param url - The company domain you want to check is saas or not
+     * @returns Is company SaaS or not
+     * @example
+     * ```typescript
+     * const result = await client.isc('stripe.com')
+     * console.log(result.is_saas);
+     * ```
+     */
+    public readonly isc: (url: string) => Promise<IscResponse>;
+
+    /**
+     * Get a company's business type
+     * @param url - The company domain you want to check
+     * @returns Company's business type
+     * @example
+     * ```typescript
+     * const result = await client.cbc('stripe.com')
+     * console.log(result.business_type);
+     * ```
+     */
+    public readonly cbc: (url: string) => Promise<CbcResponse>;
+
+    /**
+     * Get company mission statement
+     * @param url - The company domain you want to check
+     * @returns Company's mission statement
+     * @example
+     * ```typescript
+     * const result = await client.csc('stripe.com')
+     * console.log(result.mission_statement);
+     * ```
+     */
+    public readonly csc: (url: string) => Promise<CscResponse>;
+
+    /**
+     * Get company snapshot info
+     * @param url - The company domain you want to check
+     * @returns Company's snapshot information
+     * @example
+     * ```typescript
+     * const result = await client.csn('stripe.com')
+     * console.log(result.company_snapshot);
+     * ```
+     */
+    public readonly csn: (url: string) => Promise<CsnResponse>;
+
+    /**
+     * Normalize phone number
+     * @param phone - The phone number you want to normalize
+     * @returns Normalized phone
+     * @example
+     * ```typescript
+     * const result = await client.nao('+18006676389')
+     * console.log(result.phone); // +1 800 667 6389
+     * ```
+     */
+    public readonly nao: (phone: string) => Promise<NaoResponse>;
+
+    /**
+     * Get normalized address
+     * @param address - The address you want to normalize
+     * @returns Normalized address
+     * @example
+     * ```typescript
+     * const result = await client.naa('1095 avenue of the Americas, 6th Avenue ny 10036')
+     * console.log(result.address); // 1095 AVENUE OF THE AMERICAS 6TH AVENUE NY 10036
+     * ```
+     */
+    public readonly naa: (address: string) => Promise<NaaResponse>;
+
     constructor(apiKey: string, options?: CufinderClientConfig) {
         this.client = new BaseApiClient({ apiKey, ...options });
 
@@ -339,6 +451,14 @@ export class Cufinder {
         const cse = new CseService(this.client);
         const pse = new PseService(this.client);
         const lbs = new LbsService(this.client);
+        const bcd = new BcdService(this.client);
+        const ccp = new CcpService(this.client);
+        const isc = new IscService(this.client);
+        const cbc = new CbcService(this.client);
+        const csc = new CscService(this.client);
+        const csn = new CsnService(this.client);
+        const nao = new NaoService(this.client);
+        const naa = new NaaService(this.client);
 
         // Expose services as direct functions
         this.cuf = (companyName, countryCode) => cuf.getDomain(companyName, countryCode);
@@ -361,5 +481,13 @@ export class Cufinder {
         this.cse = params => cse.searchCompanies(params);
         this.pse = params => pse.searchPeople(params);
         this.lbs = params => lbs.searchLocalBusinesses(params);
+        this.bcd = url => bcd.extractB2BCustomers(url);
+        this.ccp = url => ccp.findCareersPage(url);
+        this.isc = url => isc.isSaas(url);
+        this.cbc = url => cbc.getCompanyBusinessType(url);
+        this.csc = url => csc.getCompanyMissionStatment(url);
+        this.csn = url => csn.getCompanySnapshot(url);
+        this.nao = phone => nao.normalizePhone(phone);
+        this.naa = address => naa.normalizeAddress(address);
     }
 }

lib/services/base.ts

@@ -3,7 +3,6 @@ import { CufinderError } from '../shared/types';
 
 /**
  * Base service class that provides common functionality for all services
- * Follows SOLID principles by providing a single responsibility base class
  */
 export abstract class BaseService {
     protected client: BaseApiClient;

lib/services/bcd.ts

@@ -0,0 +1,23 @@
+import { BaseService } from './base';
+import { BcdResponse } from '../shared/types';
+
+/**
+ * BCD - B2B Customers Finder API (V2)
+ */
+export class BcdService extends BaseService {
+    /**
+     * Extract B2B Customers From the Domain
+     * @param params - The domain to extract B2B customers for
+     */
+    public async extractB2BCustomers(url: string): Promise<BcdResponse> {
+        try {
+            const response = await this.client.post('/bcd', {
+                url: url.trim(),
+            });
+
+            return this.parseResponseData<BcdResponse>(response.data);
+        } catch (error) {
+            throw this.handleError(error, 'BCD Service');
+        }
+    }
+}

lib/services/car.ts

@@ -1,20 +1,13 @@
-import { CarResponse } from '../shared/types';
 import { BaseService } from './base';
+import { CarResponse } from '../shared/types';
 
 /**
  * CAR - Company Revenue Finder API (V2)
- * Estimates a company's annual revenue based on name
  */
 export class CarService extends BaseService {
     /**
      * Get company revenue
      * @param query - The company name to get revenue info for
-     * @returns Promise resolving to revenue data
-     * @example
-     * ```typescript
-     * const revenue = await client.car('apple');
-     * console.log(revenue.revenue.annual_revenue); // '$394.3B'
-     * ```
      */
     public async getRevenue(query: string): Promise<CarResponse> {
         try {