@hasna/connectors 0.3.16 → 0.4.1

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

@@ -0,0 +1,116 @@
+import type { ClickUpConfig } from '../types';
+import { ClickUpApiError } from '../types';
+
+const DEFAULT_BASE_URL = 'https://api.clickup.com/api/v2';
+
+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>;
+}
+
+export class ClickUpClient {
+  private readonly apiKey: string;
+  private readonly baseUrl: string;
+
+  constructor(config: ClickUpConfig) {
+    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();
+  }
+
+  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': 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);
+
+    if (response.status === 204) {
+      return {} as T;
+    }
+
+    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();
+    }
+
+    if (!response.ok) {
+      const errorData = data as { err?: string; ECODE?: string } | null;
+      const errorMessage = errorData?.err || response.statusText;
+      throw new ClickUpApiError(errorMessage, response.status, errorData?.ECODE);
+    }
+
+    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 delete<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'DELETE', params });
+  }
+
+  getApiKeyPreview(): string {
+    if (this.apiKey.length > 10) {
+      return `${this.apiKey.substring(0, 6)}...${this.apiKey.substring(this.apiKey.length - 4)}`;
+    }
+    return '***';
+  }
+}

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

@@ -0,0 +1,400 @@
+// ClickUp Connector
+// Workspaces, spaces, folders, lists, and tasks management
+
+import { ClickUpClient } from './client';
+import type {
+  ClickUpConfig,
+  User,
+  Workspace,
+  Space,
+  Folder,
+  List,
+  Task,
+  Comment,
+  Tag,
+  Checklist,
+  TimeEntry,
+  Goal,
+  Webhook,
+  CreateSpaceInput,
+  CreateFolderInput,
+  CreateListInput,
+  CreateTaskInput,
+  UpdateTaskInput,
+  CreateCommentInput,
+  CreateChecklistInput,
+  CreateChecklistItemInput,
+  CreateWebhookInput,
+  TasksResponse,
+} from '../types';
+
+export { ClickUpClient } from './client';
+
+export class ClickUp {
+  private client: ClickUpClient;
+
+  constructor(config: ClickUpConfig) {
+    this.client = new ClickUpClient(config);
+  }
+
+  // ============================================
+  // User Operations
+  // ============================================
+
+  async getAuthorizedUser(): Promise<User> {
+    const result = await this.client.get<{ user: User }>('/user');
+    return result.user;
+  }
+
+  // ============================================
+  // Workspace (Team) Operations
+  // ============================================
+
+  async listWorkspaces(): Promise<Workspace[]> {
+    const result = await this.client.get<{ teams: Workspace[] }>('/team');
+    return result.teams;
+  }
+
+  // ============================================
+  // Space Operations
+  // ============================================
+
+  async listSpaces(teamId: string, options?: { archived?: boolean }): Promise<Space[]> {
+    const result = await this.client.get<{ spaces: Space[] }>(`/team/${teamId}/space`, {
+      archived: options?.archived,
+    });
+    return result.spaces;
+  }
+
+  async getSpace(spaceId: string): Promise<Space> {
+    return this.client.get<Space>(`/space/${spaceId}`);
+  }
+
+  async createSpace(teamId: string, input: CreateSpaceInput): Promise<Space> {
+    return this.client.post<Space>(`/team/${teamId}/space`, input);
+  }
+
+  async updateSpace(spaceId: string, input: Partial<CreateSpaceInput>): Promise<Space> {
+    return this.client.put<Space>(`/space/${spaceId}`, input);
+  }
+
+  async deleteSpace(spaceId: string): Promise<void> {
+    await this.client.delete(`/space/${spaceId}`);
+  }
+
+  // ============================================
+  // Folder Operations
+  // ============================================
+
+  async listFolders(spaceId: string, options?: { archived?: boolean }): Promise<Folder[]> {
+    const result = await this.client.get<{ folders: Folder[] }>(`/space/${spaceId}/folder`, {
+      archived: options?.archived,
+    });
+    return result.folders;
+  }
+
+  async getFolder(folderId: string): Promise<Folder> {
+    return this.client.get<Folder>(`/folder/${folderId}`);
+  }
+
+  async createFolder(spaceId: string, input: CreateFolderInput): Promise<Folder> {
+    return this.client.post<Folder>(`/space/${spaceId}/folder`, input);
+  }
+
+  async updateFolder(folderId: string, input: CreateFolderInput): Promise<Folder> {
+    return this.client.put<Folder>(`/folder/${folderId}`, input);
+  }
+
+  async deleteFolder(folderId: string): Promise<void> {
+    await this.client.delete(`/folder/${folderId}`);
+  }
+
+  // ============================================
+  // List Operations
+  // ============================================
+
+  async listLists(folderId: string, options?: { archived?: boolean }): Promise<List[]> {
+    const result = await this.client.get<{ lists: List[] }>(`/folder/${folderId}/list`, {
+      archived: options?.archived,
+    });
+    return result.lists;
+  }
+
+  async listFolderlessLists(spaceId: string, options?: { archived?: boolean }): Promise<List[]> {
+    const result = await this.client.get<{ lists: List[] }>(`/space/${spaceId}/list`, {
+      archived: options?.archived,
+    });
+    return result.lists;
+  }
+
+  async getList(listId: string): Promise<List> {
+    return this.client.get<List>(`/list/${listId}`);
+  }
+
+  async createList(folderId: string, input: CreateListInput): Promise<List> {
+    return this.client.post<List>(`/folder/${folderId}/list`, input);
+  }
+
+  async createFolderlessList(spaceId: string, input: CreateListInput): Promise<List> {
+    return this.client.post<List>(`/space/${spaceId}/list`, input);
+  }
+
+  async updateList(listId: string, input: Partial<CreateListInput>): Promise<List> {
+    return this.client.put<List>(`/list/${listId}`, input);
+  }
+
+  async deleteList(listId: string): Promise<void> {
+    await this.client.delete(`/list/${listId}`);
+  }
+
+  // ============================================
+  // Task Operations
+  // ============================================
+
+  async listTasks(listId: string, options?: {
+    archived?: boolean;
+    page?: number;
+    order_by?: string;
+    reverse?: boolean;
+    subtasks?: boolean;
+    statuses?: string[];
+    include_closed?: boolean;
+    assignees?: string[];
+    due_date_gt?: number;
+    due_date_lt?: number;
+    date_created_gt?: number;
+    date_created_lt?: number;
+    date_updated_gt?: number;
+    date_updated_lt?: number;
+  }): Promise<TasksResponse> {
+    return this.client.get<TasksResponse>(`/list/${listId}/task`, options);
+  }
+
+  async getTask(taskId: string, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+    include_subtasks?: boolean;
+  }): Promise<Task> {
+    return this.client.get<Task>(`/task/${taskId}`, options);
+  }
+
+  async createTask(listId: string, input: CreateTaskInput): Promise<Task> {
+    return this.client.post<Task>(`/list/${listId}/task`, input);
+  }
+
+  async updateTask(taskId: string, input: UpdateTaskInput, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+  }): Promise<Task> {
+    return this.client.put<Task>(`/task/${taskId}`, input, options);
+  }
+
+  async deleteTask(taskId: string, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+  }): Promise<void> {
+    await this.client.delete(`/task/${taskId}`, options);
+  }
+
+  // ============================================
+  // Comment Operations
+  // ============================================
+
+  async listTaskComments(taskId: string, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+    start?: number;
+    start_id?: string;
+  }): Promise<Comment[]> {
+    const result = await this.client.get<{ comments: Comment[] }>(`/task/${taskId}/comment`, options);
+    return result.comments;
+  }
+
+  async createTaskComment(taskId: string, input: CreateCommentInput, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+  }): Promise<Comment> {
+    return this.client.post<Comment>(`/task/${taskId}/comment`, input, options);
+  }
+
+  async listListComments(listId: string): Promise<Comment[]> {
+    const result = await this.client.get<{ comments: Comment[] }>(`/list/${listId}/comment`);
+    return result.comments;
+  }
+
+  async createListComment(listId: string, input: CreateCommentInput): Promise<Comment> {
+    return this.client.post<Comment>(`/list/${listId}/comment`, input);
+  }
+
+  async updateComment(commentId: string, input: { comment_text: string; assignee?: number; resolved?: boolean }): Promise<Comment> {
+    return this.client.put<Comment>(`/comment/${commentId}`, input);
+  }
+
+  async deleteComment(commentId: string): Promise<void> {
+    await this.client.delete(`/comment/${commentId}`);
+  }
+
+  // ============================================
+  // Tag Operations
+  // ============================================
+
+  async listSpaceTags(spaceId: string): Promise<Tag[]> {
+    const result = await this.client.get<{ tags: Tag[] }>(`/space/${spaceId}/tag`);
+    return result.tags;
+  }
+
+  async createSpaceTag(spaceId: string, tag: { name: string; tag_fg?: string; tag_bg?: string }): Promise<Tag> {
+    return this.client.post<Tag>(`/space/${spaceId}/tag`, { tag });
+  }
+
+  async addTagToTask(taskId: string, tagName: string, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+  }): Promise<void> {
+    await this.client.post(`/task/${taskId}/tag/${tagName}`, {}, options);
+  }
+
+  async removeTagFromTask(taskId: string, tagName: string, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+  }): Promise<void> {
+    await this.client.delete(`/task/${taskId}/tag/${tagName}`, options);
+  }
+
+  // ============================================
+  // Checklist Operations
+  // ============================================
+
+  async createChecklist(taskId: string, input: CreateChecklistInput, options?: {
+    custom_task_ids?: boolean;
+    team_id?: string;
+  }): Promise<Checklist> {
+    const result = await this.client.post<{ checklist: Checklist }>(`/task/${taskId}/checklist`, input, options);
+    return result.checklist;
+  }
+
+  async updateChecklist(checklistId: string, input: { name?: string; position?: number }): Promise<Checklist> {
+    const result = await this.client.put<{ checklist: Checklist }>(`/checklist/${checklistId}`, input);
+    return result.checklist;
+  }
+
+  async deleteChecklist(checklistId: string): Promise<void> {
+    await this.client.delete(`/checklist/${checklistId}`);
+  }
+
+  async createChecklistItem(checklistId: string, input: CreateChecklistItemInput): Promise<Checklist> {
+    const result = await this.client.post<{ checklist: Checklist }>(`/checklist/${checklistId}/checklist_item`, input);
+    return result.checklist;
+  }
+
+  async updateChecklistItem(checklistId: string, checklistItemId: string, input: {
+    name?: string;
+    assignee?: number | null;
+    resolved?: boolean;
+    parent?: string | null;
+  }): Promise<Checklist> {
+    const result = await this.client.put<{ checklist: Checklist }>(`/checklist/${checklistId}/checklist_item/${checklistItemId}`, input);
+    return result.checklist;
+  }
+
+  async deleteChecklistItem(checklistId: string, checklistItemId: string): Promise<void> {
+    await this.client.delete(`/checklist/${checklistId}/checklist_item/${checklistItemId}`);
+  }
+
+  // ============================================
+  // Time Entry Operations
+  // ============================================
+
+  async listTimeEntries(teamId: string, options?: {
+    start_date?: number;
+    end_date?: number;
+    assignee?: number;
+    include_task_tags?: boolean;
+    include_location_names?: boolean;
+    space_id?: string;
+    folder_id?: string;
+    list_id?: string;
+    task_id?: string;
+  }): Promise<TimeEntry[]> {
+    const result = await this.client.get<{ data: TimeEntry[] }>(`/team/${teamId}/time_entries`, options);
+    return result.data;
+  }
+
+  async getTimeEntry(teamId: string, timerId: string): Promise<TimeEntry> {
+    const result = await this.client.get<{ data: TimeEntry }>(`/team/${teamId}/time_entries/${timerId}`);
+    return result.data;
+  }
+
+  // ============================================
+  // Goal Operations
+  // ============================================
+
+  async listGoals(teamId: string, options?: { include_completed?: boolean }): Promise<Goal[]> {
+    const result = await this.client.get<{ goals: Goal[] }>(`/team/${teamId}/goal`, options);
+    return result.goals;
+  }
+
+  async getGoal(goalId: string): Promise<Goal> {
+    const result = await this.client.get<{ goal: Goal }>(`/goal/${goalId}`);
+    return result.goal;
+  }
+
+  async createGoal(teamId: string, input: {
+    name: string;
+    due_date: number;
+    description?: string;
+    multiple_owners?: boolean;
+    owners?: number[];
+    color?: string;
+  }): Promise<Goal> {
+    const result = await this.client.post<{ goal: Goal }>(`/team/${teamId}/goal`, input);
+    return result.goal;
+  }
+
+  async updateGoal(goalId: string, input: {
+    name?: string;
+    due_date?: number;
+    description?: string;
+    color?: string;
+    add_owners?: number[];
+    rem_owners?: number[];
+  }): Promise<Goal> {
+    const result = await this.client.put<{ goal: Goal }>(`/goal/${goalId}`, input);
+    return result.goal;
+  }
+
+  async deleteGoal(goalId: string): Promise<void> {
+    await this.client.delete(`/goal/${goalId}`);
+  }
+
+  // ============================================
+  // Webhook Operations
+  // ============================================
+
+  async listWebhooks(teamId: string): Promise<Webhook[]> {
+    const result = await this.client.get<{ webhooks: Webhook[] }>(`/team/${teamId}/webhook`);
+    return result.webhooks;
+  }
+
+  async createWebhook(teamId: string, input: CreateWebhookInput): Promise<Webhook> {
+    const result = await this.client.post<{ webhook: Webhook }>(`/team/${teamId}/webhook`, input);
+    return result.webhook;
+  }
+
+  async updateWebhook(webhookId: string, input: Partial<CreateWebhookInput>): Promise<Webhook> {
+    const result = await this.client.put<{ webhook: Webhook }>(`/webhook/${webhookId}`, input);
+    return result.webhook;
+  }
+
+  async deleteWebhook(webhookId: string): Promise<void> {
+    await this.client.delete(`/webhook/${webhookId}`);
+  }
+
+  // ============================================
+  // Utility Methods
+  // ============================================
+
+  getClient(): ClickUpClient {
+    return this.client;
+  }
+}