@kb-labs/clickup-core 2.96.0

package/README.md

@@ -0,0 +1,5 @@
+# @kb-labs/clickup-core
+
+> Part of [KB Labs](https://github.com/KirillBaranov/kb-labs) ecosystem.
+
+Business logic for the ClickUp plugin. Pure, testable in isolation.

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { ClickUpComment, CreateFolderInput, ClickUpFolder, CreateListInput, ClickUpList, CreateSpaceInput, ClickUpSpaceDetail, CreateTaskInput, ClickUpTask, ClickUpStatus, ClickUpWorkspace, UpdateFolderInput, UpdateListInput, UpdateSpaceInput, UpdateTaskInput } from '@kb-labs/clickup-contracts';
+
+declare function requireApiKey(): string;
+declare function requireTeamId(): string;
+
+declare class ClickUpApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+declare function clickupFetch<T>(path: string, apiKey: string, options?: RequestInit): Promise<T>;
+
+declare function getWorkspaceHierarchy(apiKey: string, teamId: string): Promise<ClickUpWorkspace>;
+interface SearchTasksParams {
+    query?: string;
+    list_ids?: string[];
+    statuses?: string[];
+    assignees?: string[];
+    limit?: number;
+    page?: number;
+    include_closed?: boolean;
+}
+declare function searchTasks(apiKey: string, teamId: string, params?: SearchTasksParams): Promise<ClickUpTask[]>;
+declare function getTask(apiKey: string, taskId: string): Promise<ClickUpTask>;
+declare function createTask(apiKey: string, listId: string, body: CreateTaskInput): Promise<ClickUpTask>;
+declare function updateTask(apiKey: string, taskId: string, body: UpdateTaskInput): Promise<ClickUpTask>;
+declare function deleteTask(apiKey: string, taskId: string): Promise<void>;
+interface ListTasksParams {
+    statuses?: string[];
+    assignees?: string[];
+    limit?: number;
+    page?: number;
+    include_closed?: boolean;
+}
+declare function getListTasks(apiKey: string, listId: string, params?: ListTasksParams): Promise<ClickUpTask[]>;
+declare function getListStatuses(apiKey: string, listId: string): Promise<ClickUpStatus[]>;
+declare function getTaskComments(apiKey: string, taskId: string): Promise<ClickUpComment[]>;
+declare function addTaskComment(apiKey: string, taskId: string, commentText: string, options?: {
+    assignee?: number;
+    notifyAll?: boolean;
+}): Promise<ClickUpComment>;
+declare function createSpace(apiKey: string, teamId: string, body: CreateSpaceInput): Promise<ClickUpSpaceDetail>;
+declare function updateSpace(apiKey: string, spaceId: string, body: UpdateSpaceInput): Promise<ClickUpSpaceDetail>;
+declare function deleteSpace(apiKey: string, spaceId: string): Promise<void>;
+declare function createFolder(apiKey: string, spaceId: string, body: CreateFolderInput): Promise<ClickUpFolder>;
+declare function updateFolder(apiKey: string, folderId: string, body: UpdateFolderInput): Promise<ClickUpFolder>;
+declare function deleteFolder(apiKey: string, folderId: string): Promise<void>;
+declare function createListInFolder(apiKey: string, folderId: string, body: CreateListInput): Promise<ClickUpList>;
+declare function createListInSpace(apiKey: string, spaceId: string, body: CreateListInput): Promise<ClickUpList>;
+declare function updateList(apiKey: string, listId: string, body: UpdateListInput): Promise<ClickUpList>;
+declare function deleteList(apiKey: string, listId: string): Promise<void>;
+
+export { ClickUpApiError, type ListTasksParams, type SearchTasksParams, addTaskComment, clickupFetch, createFolder, createListInFolder, createListInSpace, createSpace, createTask, deleteFolder, deleteList, deleteSpace, deleteTask, getListStatuses, getListTasks, getTask, getTaskComments, getWorkspaceHierarchy, requireApiKey, requireTeamId, searchTasks, updateFolder, updateList, updateSpace, updateTask };

package/dist/index.js

@@ -0,0 +1,244 @@
+import { useEnv } from '@kb-labs/sdk';
+
+// src/env.ts
+function requireApiKey() {
+  const key = useEnv("CLICKUP_API_KEY");
+  if (!key) {
+    throw new Error("CLICKUP_API_KEY is not set");
+  }
+  return key;
+}
+function requireTeamId() {
+  const id = useEnv("CLICKUP_TEAM_ID");
+  if (!id) {
+    throw new Error("CLICKUP_TEAM_ID is not set");
+  }
+  return id;
+}
+
+// src/client.ts
+var BASE_URL = "https://api.clickup.com/api/v2";
+var ClickUpApiError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "ClickUpApiError";
+  }
+  status;
+  code;
+};
+async function clickupFetch(path, apiKey, options = {}) {
+  const url = `${BASE_URL}${path}`;
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      "Authorization": apiKey,
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+  if (!res.ok) {
+    let code = "UNKNOWN";
+    let message = `ClickUp API error ${res.status}`;
+    try {
+      const body = await res.json();
+      if (body.err) {
+        message = body.err;
+      }
+      if (body.ECODE) {
+        code = body.ECODE;
+      }
+    } catch {
+    }
+    throw new ClickUpApiError(res.status, code, message);
+  }
+  const text = await res.text();
+  if (!text) {
+    return {};
+  }
+  return JSON.parse(text);
+}
+
+// src/api.ts
+async function resolveTeam(apiKey, teamIdHint) {
+  const res = await clickupFetch("/team", apiKey);
+  const team = res.teams.find((t) => t.id === teamIdHint) ?? res.teams[0];
+  if (!team) {
+    throw new Error(`No ClickUp team found for CLICKUP_TEAM_ID=${teamIdHint}`);
+  }
+  return team;
+}
+async function getWorkspaceHierarchy(apiKey, teamId) {
+  const team = await resolveTeam(apiKey, teamId);
+  const spacesRes = await clickupFetch(
+    `/team/${team.id}/space?archived=false`,
+    apiKey
+  );
+  const spaces = await Promise.all(
+    spacesRes.spaces.map(async (space) => {
+      const [foldersRes, listsRes] = await Promise.all([
+        clickupFetch(`/space/${space.id}/folder?archived=false`, apiKey),
+        clickupFetch(`/space/${space.id}/list?archived=false`, apiKey)
+      ]);
+      const folders = await Promise.all(
+        foldersRes.folders.map(async (folder) => {
+          const folderListsRes = await clickupFetch(
+            `/folder/${folder.id}/list?archived=false`,
+            apiKey
+          );
+          return { ...folder, lists: folderListsRes.lists };
+        })
+      );
+      return { ...space, folders, lists: listsRes.lists };
+    })
+  );
+  return { id: team.id, name: team.name, spaces };
+}
+async function searchTasks(apiKey, teamId, params = {}) {
+  const qs = new URLSearchParams();
+  if (params.query) {
+    qs.set("query", params.query);
+  }
+  if (params.list_ids?.length) {
+    params.list_ids.forEach((id) => qs.append("list_ids[]", id));
+  }
+  if (params.statuses?.length) {
+    params.statuses.forEach((s) => qs.append("statuses[]", s));
+  }
+  if (params.assignees?.length) {
+    params.assignees.forEach((a) => qs.append("assignees[]", a));
+  }
+  qs.set("page", String(params.page ?? 0));
+  qs.set("limit", String(Math.min(params.limit ?? 20, 100)));
+  if (params.include_closed) {
+    qs.set("include_closed", "true");
+  }
+  qs.set("subtasks", "true");
+  const team = await resolveTeam(apiKey, teamId);
+  const res = await clickupFetch(
+    `/team/${team.id}/task?${qs}`,
+    apiKey
+  );
+  return res.tasks;
+}
+async function getTask(apiKey, taskId) {
+  return clickupFetch(
+    `/task/${taskId}?include_subtasks=true`,
+    apiKey
+  );
+}
+async function createTask(apiKey, listId, body) {
+  return clickupFetch(`/list/${listId}/task`, apiKey, {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function updateTask(apiKey, taskId, body) {
+  return clickupFetch(`/task/${taskId}`, apiKey, {
+    method: "PUT",
+    body: JSON.stringify(body)
+  });
+}
+async function deleteTask(apiKey, taskId) {
+  await clickupFetch(`/task/${taskId}`, apiKey, { method: "DELETE" });
+}
+async function getListTasks(apiKey, listId, params = {}) {
+  const qs = new URLSearchParams();
+  if (params.statuses?.length) {
+    params.statuses.forEach((s) => qs.append("statuses[]", s));
+  }
+  if (params.assignees?.length) {
+    params.assignees.forEach((a) => qs.append("assignees[]", a));
+  }
+  qs.set("page", String(params.page ?? 0));
+  if (params.include_closed) {
+    qs.set("include_closed", "true");
+  }
+  qs.set("subtasks", "true");
+  const res = await clickupFetch(
+    `/list/${listId}/task?${qs}`,
+    apiKey
+  );
+  return res.tasks;
+}
+async function getListStatuses(apiKey, listId) {
+  const res = await clickupFetch(
+    `/list/${listId}`,
+    apiKey
+  );
+  return res.statuses ?? [];
+}
+async function getTaskComments(apiKey, taskId) {
+  const res = await clickupFetch(
+    `/task/${taskId}/comment`,
+    apiKey
+  );
+  return res.comments ?? [];
+}
+async function addTaskComment(apiKey, taskId, commentText, options = {}) {
+  return clickupFetch(`/task/${taskId}/comment`, apiKey, {
+    method: "POST",
+    body: JSON.stringify({
+      comment_text: commentText,
+      assignee: options.assignee,
+      notify_all: options.notifyAll ?? false
+    })
+  });
+}
+async function createSpace(apiKey, teamId, body) {
+  const team = await resolveTeam(apiKey, teamId);
+  return clickupFetch(`/team/${team.id}/space`, apiKey, {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function updateSpace(apiKey, spaceId, body) {
+  return clickupFetch(`/space/${spaceId}`, apiKey, {
+    method: "PUT",
+    body: JSON.stringify(body)
+  });
+}
+async function deleteSpace(apiKey, spaceId) {
+  await clickupFetch(`/space/${spaceId}`, apiKey, { method: "DELETE" });
+}
+async function createFolder(apiKey, spaceId, body) {
+  return clickupFetch(`/space/${spaceId}/folder`, apiKey, {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function updateFolder(apiKey, folderId, body) {
+  return clickupFetch(`/folder/${folderId}`, apiKey, {
+    method: "PUT",
+    body: JSON.stringify(body)
+  });
+}
+async function deleteFolder(apiKey, folderId) {
+  await clickupFetch(`/folder/${folderId}`, apiKey, { method: "DELETE" });
+}
+async function createListInFolder(apiKey, folderId, body) {
+  return clickupFetch(`/folder/${folderId}/list`, apiKey, {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function createListInSpace(apiKey, spaceId, body) {
+  return clickupFetch(`/space/${spaceId}/list`, apiKey, {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+}
+async function updateList(apiKey, listId, body) {
+  return clickupFetch(`/list/${listId}`, apiKey, {
+    method: "PUT",
+    body: JSON.stringify(body)
+  });
+}
+async function deleteList(apiKey, listId) {
+  await clickupFetch(`/list/${listId}`, apiKey, { method: "DELETE" });
+}
+
+export { ClickUpApiError, addTaskComment, clickupFetch, createFolder, createListInFolder, createListInSpace, createSpace, createTask, deleteFolder, deleteList, deleteSpace, deleteTask, getListStatuses, getListTasks, getTask, getTaskComments, getWorkspaceHierarchy, requireApiKey, requireTeamId, searchTasks, updateFolder, updateList, updateSpace, updateTask };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/env.ts","../src/client.ts","../src/api.ts"],"names":[],"mappings":";;;AAEO,SAAS,aAAA,GAAwB;AACtC,EAAA,MAAM,GAAA,GAAM,OAAO,iBAAiB,CAAA;AACpC,EAAA,IAAI,CAAC,GAAA,EAAK;AAAE,IAAA,MAAM,IAAI,MAAM,4BAA4B,CAAA;AAAA,EAAG;AAC3D,EAAA,OAAO,GAAA;AACT;AAEO,SAAS,aAAA,GAAwB;AACtC,EAAA,MAAM,EAAA,GAAK,OAAO,iBAAiB,CAAA;AACnC,EAAA,IAAI,CAAC,EAAA,EAAI;AAAE,IAAA,MAAM,IAAI,MAAM,4BAA4B,CAAA;AAAA,EAAG;AAC1D,EAAA,OAAO,EAAA;AACT;;;ACZA,IAAM,QAAA,GAAW,gCAAA;AAEV,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA,EACzC,WAAA,CACkB,MAAA,EACA,IAAA,EAChB,OAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAJG,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AACA,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAIhB,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AAAA,EANkB,MAAA;AAAA,EACA,IAAA;AAMpB;AAEA,eAAsB,YAAA,CACpB,IAAA,EACA,MAAA,EACA,OAAA,GAAuB,EAAC,EACZ;AACZ,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,QAAQ,CAAA,EAAG,IAAI,CAAA,CAAA;AAC9B,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,IAC3B,GAAG,OAAA;AAAA,IACH,OAAA,EAAS;AAAA,MACP,eAAA,EAAiB,MAAA;AAAA,MACjB,cAAA,EAAgB,kBAAA;AAAA,MAChB,GAAG,OAAA,CAAQ;AAAA;AACb,GACD,CAAA;AAED,EAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,IAAA,IAAI,IAAA,GAAO,SAAA;AACX,IAAA,IAAI,OAAA,GAAU,CAAA,kBAAA,EAAqB,GAAA,CAAI,MAAM,CAAA,CAAA;AAC7C,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,MAAA,IAAI,KAAK,GAAA,EAAK;AAAE,QAAA,OAAA,GAAU,IAAA,CAAK,GAAA;AAAA,MAAK;AACpC,MAAA,IAAI,KAAK,KAAA,EAAO;AAAE,QAAA,IAAA,GAAO,IAAA,CAAK,KAAA;AAAA,MAAO;AAAA,IACvC,CAAA,CAAA,MAAQ;AAAA,IAER;AACA,IAAA,MAAM,IAAI,eAAA,CAAgB,GAAA,CAAI,MAAA,EAAQ,MAAM,OAAO,CAAA;AAAA,EACrD;AAEA,EAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,EAAA,IAAI,CAAC,IAAA,EAAM;AAAE,IAAA,OAAO,EAAC;AAAA,EAAQ;AAC7B,EAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AACxB;;;ACtBA,eAAe,WAAA,CACb,QACA,UAAA,EACuC;AACvC,EAAA,MAAM,GAAA,GAAM,MAAM,YAAA,CAA6D,OAAA,EAAS,MAAM,CAAA;AAC9F,EAAA,MAAM,IAAA,GAAO,GAAA,CAAI,KAAA,CAAM,IAAA,CAAK,CAAA,CAAA,KAAK,CAAA,CAAE,EAAA,KAAO,UAAU,CAAA,IAAK,GAAA,CAAI,KAAA,CAAM,CAAC,CAAA;AACpE,EAAA,IAAI,CAAC,IAAA,EAAM;AAAE,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,0CAAA,EAA6C,UAAU,CAAA,CAAE,CAAA;AAAA,EAAG;AACzF,EAAA,OAAO,IAAA;AACT;AAEA,eAAsB,qBAAA,CACpB,QACA,MAAA,EAC2B;AAC3B,EAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,MAAA,EAAQ,MAAM,CAAA;AAE7C,EAAA,MAAM,YAAY,MAAM,YAAA;AAAA,IACtB,CAAA,MAAA,EAAS,KAAK,EAAE,CAAA,qBAAA,CAAA;AAAA,IAChB;AAAA,GACF;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,GAAA;AAAA,IAC3B,SAAA,CAAU,MAAA,CAAO,GAAA,CAAI,OAAM,KAAA,KAAS;AAClC,MAAA,MAAM,CAAC,UAAA,EAAY,QAAQ,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,QAC/C,YAAA,CAA2C,CAAA,OAAA,EAAU,KAAA,CAAM,EAAE,0BAA0B,MAAM,CAAA;AAAA,QAC7F,YAAA,CAAuC,CAAA,OAAA,EAAU,KAAA,CAAM,EAAE,wBAAwB,MAAM;AAAA,OACxF,CAAA;AAED,MAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,GAAA;AAAA,QAC5B,UAAA,CAAW,OAAA,CAAQ,GAAA,CAAI,OAAM,MAAA,KAAU;AACrC,UAAA,MAAM,iBAAiB,MAAM,YAAA;AAAA,YAC3B,CAAA,QAAA,EAAW,OAAO,EAAE,CAAA,oBAAA,CAAA;AAAA,YACpB;AAAA,WACF;AACA,UAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,KAAA,EAAO,eAAe,KAAA,EAAM;AAAA,QAClD,CAAC;AAAA,OACH;AAEA,MAAA,OAAO,EAAE,GAAG,KAAA,EAAO,OAAA,EAAS,KAAA,EAAO,SAAS,KAAA,EAAM;AAAA,IACpD,CAAC;AAAA,GACH;AAEA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,CAAK,IAAI,IAAA,EAAM,IAAA,CAAK,MAAM,MAAA,EAAO;AAChD;AAcA,eAAsB,WAAA,CACpB,MAAA,EACA,MAAA,EACA,MAAA,GAA4B,EAAC,EACL;AACxB,EAAA,MAAM,EAAA,GAAK,IAAI,eAAA,EAAgB;AAC/B,EAAA,IAAI,OAAO,KAAA,EAAO;AAAE,IAAA,EAAA,CAAG,GAAA,CAAI,OAAA,EAAS,MAAA,CAAO,KAAK,CAAA;AAAA,EAAG;AACnD,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,EAAQ;AAAE,IAAA,MAAA,CAAO,SAAS,OAAA,CAAQ,CAAA,EAAA,KAAM,GAAG,MAAA,CAAO,YAAA,EAAc,EAAE,CAAC,CAAA;AAAA,EAAG;AAC3F,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,EAAQ;AAAE,IAAA,MAAA,CAAO,SAAS,OAAA,CAAQ,CAAA,CAAA,KAAK,GAAG,MAAA,CAAO,YAAA,EAAc,CAAC,CAAC,CAAA;AAAA,EAAG;AACzF,EAAA,IAAI,MAAA,CAAO,WAAW,MAAA,EAAQ;AAAE,IAAA,MAAA,CAAO,UAAU,OAAA,CAAQ,CAAA,CAAA,KAAK,GAAG,MAAA,CAAO,aAAA,EAAe,CAAC,CAAC,CAAA;AAAA,EAAG;AAC5F,EAAA,EAAA,CAAG,IAAI,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,IAAA,IAAQ,CAAC,CAAC,CAAA;AACvC,EAAA,EAAA,CAAG,GAAA,CAAI,OAAA,EAAS,MAAA,CAAO,IAAA,CAAK,GAAA,CAAI,OAAO,KAAA,IAAS,EAAA,EAAI,GAAG,CAAC,CAAC,CAAA;AACzD,EAAA,IAAI,OAAO,cAAA,EAAgB;AAAE,IAAA,EAAA,CAAG,GAAA,CAAI,kBAAkB,MAAM,CAAA;AAAA,EAAG;AAC/D,EAAA,EAAA,CAAG,GAAA,CAAI,YAAY,MAAM,CAAA;AAEzB,EAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,MAAA,EAAQ,MAAM,CAAA;AAC7C,EAAA,MAAM,MAAM,MAAM,YAAA;AAAA,IAChB,CAAA,MAAA,EAAS,IAAA,CAAK,EAAE,CAAA,MAAA,EAAS,EAAE,CAAA,CAAA;AAAA,IAC3B;AAAA,GACF;AACA,EAAA,OAAO,GAAA,CAAI,KAAA;AACb;AAEA,eAAsB,OAAA,CAAQ,QAAgB,MAAA,EAAsC;AAClF,EAAA,OAAO,YAAA;AAAA,IACL,SAAS,MAAM,CAAA,sBAAA,CAAA;AAAA,IACf;AAAA,GACF;AACF;AAEA,eAAsB,UAAA,CACpB,MAAA,EACA,MAAA,EACA,IAAA,EACsB;AACtB,EAAA,OAAO,YAAA,CAA0B,CAAA,MAAA,EAAS,MAAM,CAAA,KAAA,CAAA,EAAS,MAAA,EAAQ;AAAA,IAC/D,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,UAAA,CACpB,MAAA,EACA,MAAA,EACA,IAAA,EACsB;AACtB,EAAA,OAAO,YAAA,CAA0B,CAAA,MAAA,EAAS,MAAM,CAAA,CAAA,EAAI,MAAA,EAAQ;AAAA,IAC1D,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,UAAA,CAAW,QAAgB,MAAA,EAA+B;AAC9E,EAAA,MAAM,YAAA,CAAmB,SAAS,MAAM,CAAA,CAAA,EAAI,QAAQ,EAAE,MAAA,EAAQ,UAAU,CAAA;AAC1E;AAYA,eAAsB,YAAA,CACpB,MAAA,EACA,MAAA,EACA,MAAA,GAA0B,EAAC,EACH;AACxB,EAAA,MAAM,EAAA,GAAK,IAAI,eAAA,EAAgB;AAC/B,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,EAAQ;AAAE,IAAA,MAAA,CAAO,SAAS,OAAA,CAAQ,CAAA,CAAA,KAAK,GAAG,MAAA,CAAO,YAAA,EAAc,CAAC,CAAC,CAAA;AAAA,EAAG;AACzF,EAAA,IAAI,MAAA,CAAO,WAAW,MAAA,EAAQ;AAAE,IAAA,MAAA,CAAO,UAAU,OAAA,CAAQ,CAAA,CAAA,KAAK,GAAG,MAAA,CAAO,aAAA,EAAe,CAAC,CAAC,CAAA;AAAA,EAAG;AAC5F,EAAA,EAAA,CAAG,IAAI,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,IAAA,IAAQ,CAAC,CAAC,CAAA;AACvC,EAAA,IAAI,OAAO,cAAA,EAAgB;AAAE,IAAA,EAAA,CAAG,GAAA,CAAI,kBAAkB,MAAM,CAAA;AAAA,EAAG;AAC/D,EAAA,EAAA,CAAG,GAAA,CAAI,YAAY,MAAM,CAAA;AAEzB,EAAA,MAAM,MAAM,MAAM,YAAA;AAAA,IAChB,CAAA,MAAA,EAAS,MAAM,CAAA,MAAA,EAAS,EAAE,CAAA,CAAA;AAAA,IAC1B;AAAA,GACF;AACA,EAAA,OAAO,GAAA,CAAI,KAAA;AACb;AAEA,eAAsB,eAAA,CACpB,QACA,MAAA,EAC0B;AAC1B,EAAA,MAAM,MAAM,MAAM,YAAA;AAAA,IAChB,SAAS,MAAM,CAAA,CAAA;AAAA,IACf;AAAA,GACF;AACA,EAAA,OAAO,GAAA,CAAI,YAAY,EAAC;AAC1B;AAIA,eAAsB,eAAA,CACpB,QACA,MAAA,EAC2B;AAC3B,EAAA,MAAM,MAAM,MAAM,YAAA;AAAA,IAChB,SAAS,MAAM,CAAA,QAAA,CAAA;AAAA,IACf;AAAA,GACF;AACA,EAAA,OAAO,GAAA,CAAI,YAAY,EAAC;AAC1B;AAEA,eAAsB,eACpB,MAAA,EACA,MAAA,EACA,WAAA,EACA,OAAA,GAAsD,EAAC,EAC9B;AACzB,EAAA,OAAO,YAAA,CAA6B,CAAA,MAAA,EAAS,MAAM,CAAA,QAAA,CAAA,EAAY,MAAA,EAAQ;AAAA,IACrE,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,MACnB,YAAA,EAAc,WAAA;AAAA,MACd,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,UAAA,EAAY,QAAQ,SAAA,IAAa;AAAA,KAClC;AAAA,GACF,CAAA;AACH;AAIA,eAAsB,WAAA,CACpB,MAAA,EACA,MAAA,EACA,IAAA,EAC6B;AAC7B,EAAA,MAAM,IAAA,GAAO,MAAM,WAAA,CAAY,MAAA,EAAQ,MAAM,CAAA;AAC7C,EAAA,OAAO,YAAA,CAAiC,CAAA,MAAA,EAAS,IAAA,CAAK,EAAE,UAAU,MAAA,EAAQ;AAAA,IACxE,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,WAAA,CACpB,MAAA,EACA,OAAA,EACA,IAAA,EAC6B;AAC7B,EAAA,OAAO,YAAA,CAAiC,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,MAAA,EAAQ;AAAA,IACnE,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,WAAA,CAAY,QAAgB,OAAA,EAAgC;AAChF,EAAA,MAAM,YAAA,CAAmB,UAAU,OAAO,CAAA,CAAA,EAAI,QAAQ,EAAE,MAAA,EAAQ,UAAU,CAAA;AAC5E;AAIA,eAAsB,YAAA,CACpB,MAAA,EACA,OAAA,EACA,IAAA,EACwB;AACxB,EAAA,OAAO,YAAA,CAA4B,CAAA,OAAA,EAAU,OAAO,CAAA,OAAA,CAAA,EAAW,MAAA,EAAQ;AAAA,IACrE,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,YAAA,CACpB,MAAA,EACA,QAAA,EACA,IAAA,EACwB;AACxB,EAAA,OAAO,YAAA,CAA4B,CAAA,QAAA,EAAW,QAAQ,CAAA,CAAA,EAAI,MAAA,EAAQ;AAAA,IAChE,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,YAAA,CAAa,QAAgB,QAAA,EAAiC;AAClF,EAAA,MAAM,YAAA,CAAmB,WAAW,QAAQ,CAAA,CAAA,EAAI,QAAQ,EAAE,MAAA,EAAQ,UAAU,CAAA;AAC9E;AAIA,eAAsB,kBAAA,CACpB,MAAA,EACA,QAAA,EACA,IAAA,EACsB;AACtB,EAAA,OAAO,YAAA,CAA0B,CAAA,QAAA,EAAW,QAAQ,CAAA,KAAA,CAAA,EAAS,MAAA,EAAQ;AAAA,IACnE,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,iBAAA,CACpB,MAAA,EACA,OAAA,EACA,IAAA,EACsB;AACtB,EAAA,OAAO,YAAA,CAA0B,CAAA,OAAA,EAAU,OAAO,CAAA,KAAA,CAAA,EAAS,MAAA,EAAQ;AAAA,IACjE,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,UAAA,CACpB,MAAA,EACA,MAAA,EACA,IAAA,EACsB;AACtB,EAAA,OAAO,YAAA,CAA0B,CAAA,MAAA,EAAS,MAAM,CAAA,CAAA,EAAI,MAAA,EAAQ;AAAA,IAC1D,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AACH;AAEA,eAAsB,UAAA,CAAW,QAAgB,MAAA,EAA+B;AAC9E,EAAA,MAAM,YAAA,CAAmB,SAAS,MAAM,CAAA,CAAA,EAAI,QAAQ,EAAE,MAAA,EAAQ,UAAU,CAAA;AAC1E","file":"index.js","sourcesContent":["import { useEnv } from '@kb-labs/sdk';\n\nexport function requireApiKey(): string {\n  const key = useEnv('CLICKUP_API_KEY');\n  if (!key) { throw new Error('CLICKUP_API_KEY is not set'); }\n  return key;\n}\n\nexport function requireTeamId(): string {\n  const id = useEnv('CLICKUP_TEAM_ID');\n  if (!id) { throw new Error('CLICKUP_TEAM_ID is not set'); }\n  return id;\n}\n","const BASE_URL = 'https://api.clickup.com/api/v2';\n\nexport class ClickUpApiError extends Error {\n  constructor(\n    public readonly status: number,\n    public readonly code: string,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'ClickUpApiError';\n  }\n}\n\nexport async function clickupFetch<T>(\n  path: string,\n  apiKey: string,\n  options: RequestInit = {},\n): Promise<T> {\n  const url = `${BASE_URL}${path}`;\n  const res = await fetch(url, {\n    ...options,\n    headers: {\n      'Authorization': apiKey,\n      'Content-Type': 'application/json',\n      ...options.headers,\n    },\n  });\n\n  if (!res.ok) {\n    let code = 'UNKNOWN';\n    let message = `ClickUp API error ${res.status}`;\n    try {\n      const body = await res.json() as { err?: string; ECODE?: string };\n      if (body.err) { message = body.err; }\n      if (body.ECODE) { code = body.ECODE; }\n    } catch {\n      // ignore parse error\n    }\n    throw new ClickUpApiError(res.status, code, message);\n  }\n\n  const text = await res.text();\n  if (!text) { return {} as T; }\n  return JSON.parse(text) as T;\n}\n","import { clickupFetch } from './client.js';\nimport type {\n  ClickUpWorkspace,\n  ClickUpSpace,\n  ClickUpSpaceDetail,\n  ClickUpFolder,\n  ClickUpList,\n  ClickUpTask,\n  ClickUpComment,\n  ClickUpStatus,\n  CreateTaskInput,\n  UpdateTaskInput,\n  CreateSpaceInput,\n  UpdateSpaceInput,\n  CreateFolderInput,\n  UpdateFolderInput,\n  CreateListInput,\n  UpdateListInput,\n} from '@kb-labs/clickup-contracts';\n\n// ── Workspace / Hierarchy ────────────────────────────────────────────────────\n\nasync function resolveTeam(\n  apiKey: string,\n  teamIdHint: string,\n): Promise<{ id: string; name: string }> {\n  const res = await clickupFetch<{ teams: Array<{ id: string; name: string }> }>('/team', apiKey);\n  const team = res.teams.find(t => t.id === teamIdHint) ?? res.teams[0];\n  if (!team) { throw new Error(`No ClickUp team found for CLICKUP_TEAM_ID=${teamIdHint}`); }\n  return team;\n}\n\nexport async function getWorkspaceHierarchy(\n  apiKey: string,\n  teamId: string,\n): Promise<ClickUpWorkspace> {\n  const team = await resolveTeam(apiKey, teamId);\n\n  const spacesRes = await clickupFetch<{ spaces: ClickUpSpace[] }>(\n    `/team/${team.id}/space?archived=false`,\n    apiKey,\n  );\n\n  const spaces = await Promise.all(\n    spacesRes.spaces.map(async space => {\n      const [foldersRes, listsRes] = await Promise.all([\n        clickupFetch<{ folders: ClickUpFolder[] }>(`/space/${space.id}/folder?archived=false`, apiKey),\n        clickupFetch<{ lists: ClickUpList[] }>(`/space/${space.id}/list?archived=false`, apiKey),\n      ]);\n\n      const folders = await Promise.all(\n        foldersRes.folders.map(async folder => {\n          const folderListsRes = await clickupFetch<{ lists: ClickUpList[] }>(\n            `/folder/${folder.id}/list?archived=false`,\n            apiKey,\n          );\n          return { ...folder, lists: folderListsRes.lists };\n        }),\n      );\n\n      return { ...space, folders, lists: listsRes.lists };\n    }),\n  );\n\n  return { id: team.id, name: team.name, spaces };\n}\n\n// ── Tasks ────────────────────────────────────────────────────────────────────\n\nexport interface SearchTasksParams {\n  query?: string;\n  list_ids?: string[];\n  statuses?: string[];\n  assignees?: string[];\n  limit?: number;\n  page?: number;\n  include_closed?: boolean;\n}\n\nexport async function searchTasks(\n  apiKey: string,\n  teamId: string,\n  params: SearchTasksParams = {},\n): Promise<ClickUpTask[]> {\n  const qs = new URLSearchParams();\n  if (params.query) { qs.set('query', params.query); }\n  if (params.list_ids?.length) { params.list_ids.forEach(id => qs.append('list_ids[]', id)); }\n  if (params.statuses?.length) { params.statuses.forEach(s => qs.append('statuses[]', s)); }\n  if (params.assignees?.length) { params.assignees.forEach(a => qs.append('assignees[]', a)); }\n  qs.set('page', String(params.page ?? 0));\n  qs.set('limit', String(Math.min(params.limit ?? 20, 100)));\n  if (params.include_closed) { qs.set('include_closed', 'true'); }\n  qs.set('subtasks', 'true');\n\n  const team = await resolveTeam(apiKey, teamId);\n  const res = await clickupFetch<{ tasks: ClickUpTask[] }>(\n    `/team/${team.id}/task?${qs}`,\n    apiKey,\n  );\n  return res.tasks;\n}\n\nexport async function getTask(apiKey: string, taskId: string): Promise<ClickUpTask> {\n  return clickupFetch<ClickUpTask>(\n    `/task/${taskId}?include_subtasks=true`,\n    apiKey,\n  );\n}\n\nexport async function createTask(\n  apiKey: string,\n  listId: string,\n  body: CreateTaskInput,\n): Promise<ClickUpTask> {\n  return clickupFetch<ClickUpTask>(`/list/${listId}/task`, apiKey, {\n    method: 'POST',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function updateTask(\n  apiKey: string,\n  taskId: string,\n  body: UpdateTaskInput,\n): Promise<ClickUpTask> {\n  return clickupFetch<ClickUpTask>(`/task/${taskId}`, apiKey, {\n    method: 'PUT',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function deleteTask(apiKey: string, taskId: string): Promise<void> {\n  await clickupFetch<void>(`/task/${taskId}`, apiKey, { method: 'DELETE' });\n}\n\n// ── List ─────────────────────────────────────────────────────────────────────\n\nexport interface ListTasksParams {\n  statuses?: string[];\n  assignees?: string[];\n  limit?: number;\n  page?: number;\n  include_closed?: boolean;\n}\n\nexport async function getListTasks(\n  apiKey: string,\n  listId: string,\n  params: ListTasksParams = {},\n): Promise<ClickUpTask[]> {\n  const qs = new URLSearchParams();\n  if (params.statuses?.length) { params.statuses.forEach(s => qs.append('statuses[]', s)); }\n  if (params.assignees?.length) { params.assignees.forEach(a => qs.append('assignees[]', a)); }\n  qs.set('page', String(params.page ?? 0));\n  if (params.include_closed) { qs.set('include_closed', 'true'); }\n  qs.set('subtasks', 'true');\n\n  const res = await clickupFetch<{ tasks: ClickUpTask[] }>(\n    `/list/${listId}/task?${qs}`,\n    apiKey,\n  );\n  return res.tasks;\n}\n\nexport async function getListStatuses(\n  apiKey: string,\n  listId: string,\n): Promise<ClickUpStatus[]> {\n  const res = await clickupFetch<{ statuses: ClickUpStatus[] }>(\n    `/list/${listId}`,\n    apiKey,\n  );\n  return res.statuses ?? [];\n}\n\n// ── Comments ─────────────────────────────────────────────────────────────────\n\nexport async function getTaskComments(\n  apiKey: string,\n  taskId: string,\n): Promise<ClickUpComment[]> {\n  const res = await clickupFetch<{ comments: ClickUpComment[] }>(\n    `/task/${taskId}/comment`,\n    apiKey,\n  );\n  return res.comments ?? [];\n}\n\nexport async function addTaskComment(\n  apiKey: string,\n  taskId: string,\n  commentText: string,\n  options: { assignee?: number; notifyAll?: boolean } = {},\n): Promise<ClickUpComment> {\n  return clickupFetch<ClickUpComment>(`/task/${taskId}/comment`, apiKey, {\n    method: 'POST',\n    body: JSON.stringify({\n      comment_text: commentText,\n      assignee: options.assignee,\n      notify_all: options.notifyAll ?? false,\n    }),\n  });\n}\n\n// ── Spaces ────────────────────────────────────────────────────────────────────\n\nexport async function createSpace(\n  apiKey: string,\n  teamId: string,\n  body: CreateSpaceInput,\n): Promise<ClickUpSpaceDetail> {\n  const team = await resolveTeam(apiKey, teamId);\n  return clickupFetch<ClickUpSpaceDetail>(`/team/${team.id}/space`, apiKey, {\n    method: 'POST',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function updateSpace(\n  apiKey: string,\n  spaceId: string,\n  body: UpdateSpaceInput,\n): Promise<ClickUpSpaceDetail> {\n  return clickupFetch<ClickUpSpaceDetail>(`/space/${spaceId}`, apiKey, {\n    method: 'PUT',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function deleteSpace(apiKey: string, spaceId: string): Promise<void> {\n  await clickupFetch<void>(`/space/${spaceId}`, apiKey, { method: 'DELETE' });\n}\n\n// ── Folders ───────────────────────────────────────────────────────────────────\n\nexport async function createFolder(\n  apiKey: string,\n  spaceId: string,\n  body: CreateFolderInput,\n): Promise<ClickUpFolder> {\n  return clickupFetch<ClickUpFolder>(`/space/${spaceId}/folder`, apiKey, {\n    method: 'POST',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function updateFolder(\n  apiKey: string,\n  folderId: string,\n  body: UpdateFolderInput,\n): Promise<ClickUpFolder> {\n  return clickupFetch<ClickUpFolder>(`/folder/${folderId}`, apiKey, {\n    method: 'PUT',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function deleteFolder(apiKey: string, folderId: string): Promise<void> {\n  await clickupFetch<void>(`/folder/${folderId}`, apiKey, { method: 'DELETE' });\n}\n\n// ── Lists (create/update/delete) ──────────────────────────────────────────────\n\nexport async function createListInFolder(\n  apiKey: string,\n  folderId: string,\n  body: CreateListInput,\n): Promise<ClickUpList> {\n  return clickupFetch<ClickUpList>(`/folder/${folderId}/list`, apiKey, {\n    method: 'POST',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function createListInSpace(\n  apiKey: string,\n  spaceId: string,\n  body: CreateListInput,\n): Promise<ClickUpList> {\n  return clickupFetch<ClickUpList>(`/space/${spaceId}/list`, apiKey, {\n    method: 'POST',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function updateList(\n  apiKey: string,\n  listId: string,\n  body: UpdateListInput,\n): Promise<ClickUpList> {\n  return clickupFetch<ClickUpList>(`/list/${listId}`, apiKey, {\n    method: 'PUT',\n    body: JSON.stringify(body),\n  });\n}\n\nexport async function deleteList(apiKey: string, listId: string): Promise<void> {\n  await clickupFetch<void>(`/list/${listId}`, apiKey, { method: 'DELETE' });\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@kb-labs/clickup-core",
+  "version": "2.96.0",
+  "type": "module",
+  "description": "Business logic for clickup (pure, testable in isolation).",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@kb-labs/sdk": "2.21.2",
+    "@kb-labs/clickup-contracts": "2.96.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.6",
+    "@kb-labs/devkit": "2.96.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}