@hasna/connectors 0.4.0 → 0.4.2

package/connectors/connect-hubspot/src/api/client.ts

@@ -0,0 +1,136 @@
+import type { HubSpotConfig, OutputFormat } from '../types';
+import { HubSpotApiError } from '../types';
+
+// HubSpot API base URL
+const DEFAULT_BASE_URL = 'https://api.hubapi.com';
+
+export interface RequestOptions {
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  params?: Record<string, string | number | boolean | undefined>;
+  body?: Record<string, unknown> | unknown[] | string;
+  headers?: Record<string, string>;
+  format?: OutputFormat;
+}
+
+export class HubSpotClient {
+  private readonly apiKey: string;
+  private readonly baseUrl: string;
+
+  constructor(config: HubSpotConfig) {
+    if (!config.apiKey) {
+      throw new Error('API key is required');
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+  }
+
+  private buildUrl(path: string, params?: Record<string, string | number | boolean | undefined>): string {
+    const url = new URL(`${this.baseUrl}${path}`);
+
+    if (params) {
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null && value !== '') {
+          url.searchParams.append(key, String(value));
+        }
+      });
+    }
+
+    return url.toString();
+  }
+
+  /**
+   * Make an authenticated request to the HubSpot API
+   * HubSpot uses Bearer token authentication with private app access tokens
+   */
+  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {
+    const { method = 'GET', params, body, headers = {} } = options;
+
+    const url = this.buildUrl(path, params);
+
+    const requestHeaders: Record<string, string> = {
+      'Authorization': `Bearer ${this.apiKey}`,
+      'Accept': 'application/json',
+      ...headers,
+    };
+
+    if (body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+      requestHeaders['Content-Type'] = 'application/json';
+    }
+
+    const fetchOptions: RequestInit = {
+      method,
+      headers: requestHeaders,
+    };
+
+    if (body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+      fetchOptions.body = typeof body === 'string' ? body : JSON.stringify(body);
+    }
+
+    const response = await fetch(url, fetchOptions);
+
+    // Handle 204 No Content
+    if (response.status === 204) {
+      return {} as T;
+    }
+
+    // Parse response
+    let data: unknown;
+    const contentType = response.headers.get('content-type') || '';
+
+    if (contentType.includes('application/json')) {
+      const text = await response.text();
+      if (text) {
+        try {
+          data = JSON.parse(text);
+        } catch {
+          data = text;
+        }
+      }
+    } else {
+      data = await response.text();
+    }
+
+    // Handle errors
+    if (!response.ok) {
+      const errorData = data as { message?: string; category?: string; errors?: Array<{ message: string }> };
+      throw new HubSpotApiError(
+        errorData?.message || `HubSpot API error: ${response.status}`,
+        response.status,
+        errorData?.category,
+        errorData?.errors
+      );
+    }
+
+    return data as T;
+  }
+
+  async get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'GET', params });
+  }
+
+  async post<T>(path: string, body?: Record<string, unknown> | unknown[] | string | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'POST', body: body as Record<string, unknown>, params });
+  }
+
+  async put<T>(path: string, body?: Record<string, unknown> | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'PUT', body: body as Record<string, unknown>, params });
+  }
+
+  async patch<T>(path: string, body?: Record<string, unknown> | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'PATCH', body: body as Record<string, unknown>, params });
+  }
+
+  async delete<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'DELETE', params });
+  }
+
+  /**
+   * Get a preview of the API key (for display/debugging)
+   */
+  getApiKeyPreview(): string {
+    if (this.apiKey.length > 10) {
+      return `${this.apiKey.substring(0, 6)}...${this.apiKey.substring(this.apiKey.length - 4)}`;
+    }
+    return '***';
+  }
+}

package/connectors/connect-hubspot/src/api/index.ts

@@ -0,0 +1,379 @@
+// HubSpot Connector
+// CRM contacts, companies, deals, and tickets
+
+import { HubSpotClient } from './client';
+import type {
+  HubSpotConfig,
+  HubSpotListResponse,
+  Contact,
+  CreateContactInput,
+  UpdateContactInput,
+  Company,
+  CreateCompanyInput,
+  UpdateCompanyInput,
+  Deal,
+  CreateDealInput,
+  UpdateDealInput,
+  Ticket,
+  CreateTicketInput,
+  UpdateTicketInput,
+  Owner,
+  Note,
+  CreateNoteInput,
+  SearchRequest,
+  SearchResponse,
+} from '../types';
+
+export { HubSpotClient } from './client';
+
+export class HubSpot {
+  private client: HubSpotClient;
+
+  constructor(config: HubSpotConfig) {
+    this.client = new HubSpotClient(config);
+  }
+
+  // ============================================
+  // Contacts
+  // ============================================
+
+  /**
+   * List all contacts
+   */
+  async listContacts(params?: {
+    limit?: number;
+    after?: string;
+    properties?: string[];
+  }): Promise<HubSpotListResponse<Contact>> {
+    return this.client.get('/crm/v3/objects/contacts', {
+      limit: params?.limit,
+      after: params?.after,
+      properties: params?.properties?.join(','),
+    });
+  }
+
+  /**
+   * Get a contact by ID
+   */
+  async getContact(contactId: string, properties?: string[]): Promise<Contact> {
+    return this.client.get(`/crm/v3/objects/contacts/${contactId}`, {
+      properties: properties?.join(','),
+    });
+  }
+
+  /**
+   * Create a contact
+   */
+  async createContact(data: CreateContactInput): Promise<Contact> {
+    return this.client.post('/crm/v3/objects/contacts', data);
+  }
+
+  /**
+   * Update a contact
+   */
+  async updateContact(contactId: string, data: UpdateContactInput): Promise<Contact> {
+    return this.client.patch(`/crm/v3/objects/contacts/${contactId}`, data);
+  }
+
+  /**
+   * Delete a contact
+   */
+  async deleteContact(contactId: string): Promise<void> {
+    await this.client.delete(`/crm/v3/objects/contacts/${contactId}`);
+  }
+
+  /**
+   * Search contacts
+   */
+  async searchContacts(request: SearchRequest): Promise<SearchResponse<Contact>> {
+    return this.client.post('/crm/v3/objects/contacts/search', request);
+  }
+
+  // ============================================
+  // Companies
+  // ============================================
+
+  /**
+   * List all companies
+   */
+  async listCompanies(params?: {
+    limit?: number;
+    after?: string;
+    properties?: string[];
+  }): Promise<HubSpotListResponse<Company>> {
+    return this.client.get('/crm/v3/objects/companies', {
+      limit: params?.limit,
+      after: params?.after,
+      properties: params?.properties?.join(','),
+    });
+  }
+
+  /**
+   * Get a company by ID
+   */
+  async getCompany(companyId: string, properties?: string[]): Promise<Company> {
+    return this.client.get(`/crm/v3/objects/companies/${companyId}`, {
+      properties: properties?.join(','),
+    });
+  }
+
+  /**
+   * Create a company
+   */
+  async createCompany(data: CreateCompanyInput): Promise<Company> {
+    return this.client.post('/crm/v3/objects/companies', data);
+  }
+
+  /**
+   * Update a company
+   */
+  async updateCompany(companyId: string, data: UpdateCompanyInput): Promise<Company> {
+    return this.client.patch(`/crm/v3/objects/companies/${companyId}`, data);
+  }
+
+  /**
+   * Delete a company
+   */
+  async deleteCompany(companyId: string): Promise<void> {
+    await this.client.delete(`/crm/v3/objects/companies/${companyId}`);
+  }
+
+  /**
+   * Search companies
+   */
+  async searchCompanies(request: SearchRequest): Promise<SearchResponse<Company>> {
+    return this.client.post('/crm/v3/objects/companies/search', request);
+  }
+
+  // ============================================
+  // Deals
+  // ============================================
+
+  /**
+   * List all deals
+   */
+  async listDeals(params?: {
+    limit?: number;
+    after?: string;
+    properties?: string[];
+  }): Promise<HubSpotListResponse<Deal>> {
+    return this.client.get('/crm/v3/objects/deals', {
+      limit: params?.limit,
+      after: params?.after,
+      properties: params?.properties?.join(','),
+    });
+  }
+
+  /**
+   * Get a deal by ID
+   */
+  async getDeal(dealId: string, properties?: string[]): Promise<Deal> {
+    return this.client.get(`/crm/v3/objects/deals/${dealId}`, {
+      properties: properties?.join(','),
+    });
+  }
+
+  /**
+   * Create a deal
+   */
+  async createDeal(data: CreateDealInput): Promise<Deal> {
+    return this.client.post('/crm/v3/objects/deals', data);
+  }
+
+  /**
+   * Update a deal
+   */
+  async updateDeal(dealId: string, data: UpdateDealInput): Promise<Deal> {
+    return this.client.patch(`/crm/v3/objects/deals/${dealId}`, data);
+  }
+
+  /**
+   * Delete a deal
+   */
+  async deleteDeal(dealId: string): Promise<void> {
+    await this.client.delete(`/crm/v3/objects/deals/${dealId}`);
+  }
+
+  /**
+   * Search deals
+   */
+  async searchDeals(request: SearchRequest): Promise<SearchResponse<Deal>> {
+    return this.client.post('/crm/v3/objects/deals/search', request);
+  }
+
+  // ============================================
+  // Tickets
+  // ============================================
+
+  /**
+   * List all tickets
+   */
+  async listTickets(params?: {
+    limit?: number;
+    after?: string;
+    properties?: string[];
+  }): Promise<HubSpotListResponse<Ticket>> {
+    return this.client.get('/crm/v3/objects/tickets', {
+      limit: params?.limit,
+      after: params?.after,
+      properties: params?.properties?.join(','),
+    });
+  }
+
+  /**
+   * Get a ticket by ID
+   */
+  async getTicket(ticketId: string, properties?: string[]): Promise<Ticket> {
+    return this.client.get(`/crm/v3/objects/tickets/${ticketId}`, {
+      properties: properties?.join(','),
+    });
+  }
+
+  /**
+   * Create a ticket
+   */
+  async createTicket(data: CreateTicketInput): Promise<Ticket> {
+    return this.client.post('/crm/v3/objects/tickets', data);
+  }
+
+  /**
+   * Update a ticket
+   */
+  async updateTicket(ticketId: string, data: UpdateTicketInput): Promise<Ticket> {
+    return this.client.patch(`/crm/v3/objects/tickets/${ticketId}`, data);
+  }
+
+  /**
+   * Delete a ticket
+   */
+  async deleteTicket(ticketId: string): Promise<void> {
+    await this.client.delete(`/crm/v3/objects/tickets/${ticketId}`);
+  }
+
+  /**
+   * Search tickets
+   */
+  async searchTickets(request: SearchRequest): Promise<SearchResponse<Ticket>> {
+    return this.client.post('/crm/v3/objects/tickets/search', request);
+  }
+
+  // ============================================
+  // Owners
+  // ============================================
+
+  /**
+   * List all owners
+   */
+  async listOwners(params?: {
+    limit?: number;
+    after?: string;
+    email?: string;
+  }): Promise<HubSpotListResponse<Owner>> {
+    return this.client.get('/crm/v3/owners', {
+      limit: params?.limit,
+      after: params?.after,
+      email: params?.email,
+    });
+  }
+
+  /**
+   * Get an owner by ID
+   */
+  async getOwner(ownerId: string): Promise<Owner> {
+    return this.client.get(`/crm/v3/owners/${ownerId}`);
+  }
+
+  // ============================================
+  // Notes
+  // ============================================
+
+  /**
+   * List all notes
+   */
+  async listNotes(params?: {
+    limit?: number;
+    after?: string;
+    properties?: string[];
+  }): Promise<HubSpotListResponse<Note>> {
+    return this.client.get('/crm/v3/objects/notes', {
+      limit: params?.limit,
+      after: params?.after,
+      properties: params?.properties?.join(','),
+    });
+  }
+
+  /**
+   * Get a note by ID
+   */
+  async getNote(noteId: string, properties?: string[]): Promise<Note> {
+    return this.client.get(`/crm/v3/objects/notes/${noteId}`, {
+      properties: properties?.join(','),
+    });
+  }
+
+  /**
+   * Create a note
+   */
+  async createNote(data: CreateNoteInput): Promise<Note> {
+    return this.client.post('/crm/v3/objects/notes', data);
+  }
+
+  /**
+   * Delete a note
+   */
+  async deleteNote(noteId: string): Promise<void> {
+    await this.client.delete(`/crm/v3/objects/notes/${noteId}`);
+  }
+
+  // ============================================
+  // Associations
+  // ============================================
+
+  /**
+   * Create association between objects
+   */
+  async createAssociation(
+    fromObjectType: string,
+    fromObjectId: string,
+    toObjectType: string,
+    toObjectId: string,
+    associationType: string
+  ): Promise<void> {
+    await this.client.put(
+      `/crm/v3/objects/${fromObjectType}/${fromObjectId}/associations/${toObjectType}/${toObjectId}/${associationType}`
+    );
+  }
+
+  /**
+   * Delete association between objects
+   */
+  async deleteAssociation(
+    fromObjectType: string,
+    fromObjectId: string,
+    toObjectType: string,
+    toObjectId: string,
+    associationType: string
+  ): Promise<void> {
+    await this.client.delete(
+      `/crm/v3/objects/${fromObjectType}/${fromObjectId}/associations/${toObjectType}/${toObjectId}/${associationType}`
+    );
+  }
+
+  /**
+   * Get associations for an object
+   */
+  async getAssociations(
+    objectType: string,
+    objectId: string,
+    toObjectType: string
+  ): Promise<{ results: { id: string; type: string }[] }> {
+    return this.client.get(`/crm/v3/objects/${objectType}/${objectId}/associations/${toObjectType}`);
+  }
+
+  /**
+   * Get API key preview for debugging
+   */
+  getApiKeyPreview(): string {
+    return this.client.getApiKeyPreview();
+  }
+}