@kb-labs/clickup-entry 2.96.0

package/dist/rest/handlers/task-delete-handler.js

@@ -0,0 +1,58 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { requireApiKey, deleteTask, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/rest/handlers/task-delete-handler.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function rethrowForRest(err) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    const restErr = Object.assign(new Error(err.message), {
+      statusCode: err.status,
+      code: err.code,
+      details: { hint }
+    });
+    throw restErr;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isEnvMissing) {
+    throw Object.assign(new Error(message), {
+      statusCode: 400,
+      code: "ENV_MISSING",
+      details: { hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables" }
+    });
+  }
+  throw err;
+}
+
+// src/rest/handlers/task-delete-handler.ts
+var task_delete_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const apiKey = requireApiKey();
+      const taskId = input.params?.taskId;
+      if (!taskId) throw new Error("taskId is required");
+      await deleteTask(apiKey, taskId);
+      return { deleted: true, taskId };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { task_delete_handler_default as default };
+//# sourceMappingURL=task-delete-handler.js.map
+//# sourceMappingURL=task-delete-handler.js.map

package/dist/rest/handlers/task-delete-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/task-delete-handler.ts"],"names":[],"mappings":";;;;AAKA,SAAS,QAAQ,GAAA,EAA8B;AAC7C,EAAA,QAAQ,IAAI,MAAA;AAAQ,IAClB,KAAK,GAAA;AAAK,MAAA,OAAO,kFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,oFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,+FAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,2DAAA;AAAA,IACjB;AAAU,MAAA,OAAO,8BAAA;AAAA;AAErB;AA+CO,SAAS,eAAe,GAAA,EAAqB;AAClD,EAAA,IAAI,eAAe,eAAA,EAAiB;AAClC,IAAA,MAAM,IAAA,GAAO,QAAQ,GAAG,CAAA;AACxB,IAAA,MAAM,UAAU,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA,EAAG;AAAA,MACpD,YAAY,GAAA,CAAI,MAAA;AAAA,MAChB,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,OAAA,EAAS,EAAE,IAAA;AAAK,KACjB,CAAA;AACD,IAAA,MAAM,OAAA;AAAA,EACR;AACA,EAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,YAAA,GAAe,iCAAA,CAAkC,IAAA,CAAK,OAAO,CAAA;AACnE,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,MAAM,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAO,CAAA,EAAG;AAAA,MACtC,UAAA,EAAY,GAAA;AAAA,MACZ,IAAA,EAAM,aAAA;AAAA,MACN,OAAA,EAAS,EAAE,IAAA,EAAM,2FAAA;AAA4F,KAC9G,CAAA;AAAA,EACH;AACA,EAAA,MAAM,GAAA;AACR;;;AC5EA,IAAO,8BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,IAAA,EACA,KAAA,EACA;AACA,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,aAAA,EAAc;AAC7B,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,EAAQ,MAAA;AAC7B,MAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAEjD,MAAA,MAAM,UAAA,CAAW,QAAQ,MAAM,CAAA;AAC/B,MAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,MAAA,EAAO;AAAA,IACjC,SAAS,GAAA,EAAK;AACZ,MAAA,cAAA,CAAe,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACF,CAAC","file":"task-delete-handler.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { requireApiKey, deleteTask } from '@kb-labs/clickup-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\nexport default defineHandler({\n  async execute(\n    _ctx: PluginContextV3,\n    input: RestInput<Record<string, never>, never, { taskId: string }>,\n  ) {\n    try {\n      const apiKey = requireApiKey();\n      const taskId = input.params?.taskId;\n      if (!taskId) throw new Error('taskId is required');\n\n      await deleteTask(apiKey, taskId);\n      return { deleted: true, taskId };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/task-get-handler.d.ts

@@ -0,0 +1,12 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_clickup_contracts from '@kb-labs/clickup-contracts';
+import { RestInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Record<string, never>, never, {
+    taskId: string;
+}>, {
+    task: _kb_labs_clickup_contracts.ClickUpTask;
+    comments: _kb_labs_clickup_contracts.ClickUpComment[];
+}>;
+
+export { _default as default };

package/dist/rest/handlers/task-get-handler.js

@@ -0,0 +1,61 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { requireApiKey, getTask, getTaskComments, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/rest/handlers/task-get-handler.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function rethrowForRest(err) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    const restErr = Object.assign(new Error(err.message), {
+      statusCode: err.status,
+      code: err.code,
+      details: { hint }
+    });
+    throw restErr;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isEnvMissing) {
+    throw Object.assign(new Error(message), {
+      statusCode: 400,
+      code: "ENV_MISSING",
+      details: { hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables" }
+    });
+  }
+  throw err;
+}
+
+// src/rest/handlers/task-get-handler.ts
+var task_get_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const apiKey = requireApiKey();
+      const taskId = input.params?.taskId;
+      if (!taskId) throw new Error("taskId is required");
+      const [task, comments] = await Promise.all([
+        getTask(apiKey, taskId),
+        getTaskComments(apiKey, taskId)
+      ]);
+      return { task, comments };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { task_get_handler_default as default };
+//# sourceMappingURL=task-get-handler.js.map
+//# sourceMappingURL=task-get-handler.js.map

package/dist/rest/handlers/task-get-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/task-get-handler.ts"],"names":[],"mappings":";;;;AAKA,SAAS,QAAQ,GAAA,EAA8B;AAC7C,EAAA,QAAQ,IAAI,MAAA;AAAQ,IAClB,KAAK,GAAA;AAAK,MAAA,OAAO,kFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,oFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,+FAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,2DAAA;AAAA,IACjB;AAAU,MAAA,OAAO,8BAAA;AAAA;AAErB;AA+CO,SAAS,eAAe,GAAA,EAAqB;AAClD,EAAA,IAAI,eAAe,eAAA,EAAiB;AAClC,IAAA,MAAM,IAAA,GAAO,QAAQ,GAAG,CAAA;AACxB,IAAA,MAAM,UAAU,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA,EAAG;AAAA,MACpD,YAAY,GAAA,CAAI,MAAA;AAAA,MAChB,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,OAAA,EAAS,EAAE,IAAA;AAAK,KACjB,CAAA;AACD,IAAA,MAAM,OAAA;AAAA,EACR;AACA,EAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,YAAA,GAAe,iCAAA,CAAkC,IAAA,CAAK,OAAO,CAAA;AACnE,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,MAAM,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAO,CAAA,EAAG;AAAA,MACtC,UAAA,EAAY,GAAA;AAAA,MACZ,IAAA,EAAM,aAAA;AAAA,MACN,OAAA,EAAS,EAAE,IAAA,EAAM,2FAAA;AAA4F,KAC9G,CAAA;AAAA,EACH;AACA,EAAA,MAAM,GAAA;AACR;;;AC5EA,IAAO,2BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,IAAA,EAAuB,KAAA,EAAoE;AACvG,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,aAAA,EAAc;AAC7B,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,EAAQ,MAAA;AAC7B,MAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAEjD,MAAA,MAAM,CAAC,IAAA,EAAM,QAAQ,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,QACzC,OAAA,CAAQ,QAAQ,MAAM,CAAA;AAAA,QACtB,eAAA,CAAgB,QAAQ,MAAM;AAAA,OAC/B,CAAA;AAED,MAAA,OAAO,EAAE,MAAM,QAAA,EAAS;AAAA,IAC1B,SAAS,GAAA,EAAK;AACZ,MAAA,cAAA,CAAe,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACF,CAAC","file":"task-get-handler.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { requireApiKey, getTask, getTaskComments } from '@kb-labs/clickup-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<Record<string, never>, never, { taskId: string }>) {\n    try {\n      const apiKey = requireApiKey();\n      const taskId = input.params?.taskId;\n      if (!taskId) throw new Error('taskId is required');\n\n      const [task, comments] = await Promise.all([\n        getTask(apiKey, taskId),\n        getTaskComments(apiKey, taskId),\n      ]);\n\n      return { task, comments };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/task-update-handler.d.ts

@@ -0,0 +1,19 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_clickup_contracts from '@kb-labs/clickup-contracts';
+import { RestInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Record<string, never>, {
+    name?: string | undefined;
+    markdown_content?: string | undefined;
+    status?: string | undefined;
+    priority?: number | null | undefined;
+    assignees?: {
+        add?: number[] | undefined;
+        rem?: number[] | undefined;
+    } | undefined;
+    due_date?: number | null | undefined;
+}, {
+    taskId: string;
+}>, _kb_labs_clickup_contracts.ClickUpTask>;
+
+export { _default as default };

package/dist/rest/handlers/task-update-handler.js

@@ -0,0 +1,58 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { requireApiKey, updateTask, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/rest/handlers/task-update-handler.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function rethrowForRest(err) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    const restErr = Object.assign(new Error(err.message), {
+      statusCode: err.status,
+      code: err.code,
+      details: { hint }
+    });
+    throw restErr;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isEnvMissing) {
+    throw Object.assign(new Error(message), {
+      statusCode: 400,
+      code: "ENV_MISSING",
+      details: { hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables" }
+    });
+  }
+  throw err;
+}
+
+// src/rest/handlers/task-update-handler.ts
+var task_update_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const apiKey = requireApiKey();
+      const taskId = input.params?.taskId;
+      if (!taskId) throw new Error("taskId is required");
+      if (!input.body) throw new Error("body is required");
+      return updateTask(apiKey, taskId, input.body);
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { task_update_handler_default as default };
+//# sourceMappingURL=task-update-handler.js.map
+//# sourceMappingURL=task-update-handler.js.map

package/dist/rest/handlers/task-update-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/task-update-handler.ts"],"names":[],"mappings":";;;;AAKA,SAAS,QAAQ,GAAA,EAA8B;AAC7C,EAAA,QAAQ,IAAI,MAAA;AAAQ,IAClB,KAAK,GAAA;AAAK,MAAA,OAAO,kFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,oFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,+FAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,2DAAA;AAAA,IACjB;AAAU,MAAA,OAAO,8BAAA;AAAA;AAErB;AA+CO,SAAS,eAAe,GAAA,EAAqB;AAClD,EAAA,IAAI,eAAe,eAAA,EAAiB;AAClC,IAAA,MAAM,IAAA,GAAO,QAAQ,GAAG,CAAA;AACxB,IAAA,MAAM,UAAU,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA,EAAG;AAAA,MACpD,YAAY,GAAA,CAAI,MAAA;AAAA,MAChB,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,OAAA,EAAS,EAAE,IAAA;AAAK,KACjB,CAAA;AACD,IAAA,MAAM,OAAA;AAAA,EACR;AACA,EAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,YAAA,GAAe,iCAAA,CAAkC,IAAA,CAAK,OAAO,CAAA;AACnE,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,MAAM,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAO,CAAA,EAAG;AAAA,MACtC,UAAA,EAAY,GAAA;AAAA,MACZ,IAAA,EAAM,aAAA;AAAA,MACN,OAAA,EAAS,EAAE,IAAA,EAAM,2FAAA;AAA4F,KAC9G,CAAA;AAAA,EACH;AACA,EAAA,MAAM,GAAA;AACR;;;AC3EA,IAAO,8BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,IAAA,EACA,KAAA,EACA;AACA,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,aAAA,EAAc;AAC7B,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,EAAQ,MAAA;AAC7B,MAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,MAAM,oBAAoB,CAAA;AACjD,MAAA,IAAI,CAAC,KAAA,CAAM,IAAA,EAAM,MAAM,IAAI,MAAM,kBAAkB,CAAA;AAEnD,MAAA,OAAO,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,KAAA,CAAM,IAAI,CAAA;AAAA,IAC9C,SAAS,GAAA,EAAK;AACZ,MAAA,cAAA,CAAe,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACF,CAAC","file":"task-update-handler.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { requireApiKey, updateTask } from '@kb-labs/clickup-core';\nimport type { UpdateTaskInput } from '@kb-labs/clickup-contracts';\nimport { rethrowForRest } from '../../utils/error.js';\n\nexport default defineHandler({\n  async execute(\n    _ctx: PluginContextV3,\n    input: RestInput<Record<string, never>, UpdateTaskInput, { taskId: string }>,\n  ) {\n    try {\n      const apiKey = requireApiKey();\n      const taskId = input.params?.taskId;\n      if (!taskId) throw new Error('taskId is required');\n      if (!input.body) throw new Error('body is required');\n\n      return updateTask(apiKey, taskId, input.body);\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/workspace-handler.d.ts

@@ -0,0 +1,6 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_clickup_contracts from '@kb-labs/clickup-contracts';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, unknown, _kb_labs_clickup_contracts.ClickUpWorkspace>;
+
+export { _default as default };

package/dist/rest/handlers/workspace-handler.js

@@ -0,0 +1,56 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { requireApiKey, requireTeamId, getWorkspaceHierarchy, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/rest/handlers/workspace-handler.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function rethrowForRest(err) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    const restErr = Object.assign(new Error(err.message), {
+      statusCode: err.status,
+      code: err.code,
+      details: { hint }
+    });
+    throw restErr;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isEnvMissing) {
+    throw Object.assign(new Error(message), {
+      statusCode: 400,
+      code: "ENV_MISSING",
+      details: { hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables" }
+    });
+  }
+  throw err;
+}
+
+// src/rest/handlers/workspace-handler.ts
+var workspace_handler_default = defineHandler({
+  async execute(_ctx) {
+    try {
+      const apiKey = requireApiKey();
+      const teamId = requireTeamId();
+      return getWorkspaceHierarchy(apiKey, teamId);
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { workspace_handler_default as default };
+//# sourceMappingURL=workspace-handler.js.map
+//# sourceMappingURL=workspace-handler.js.map

package/dist/rest/handlers/workspace-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/workspace-handler.ts"],"names":[],"mappings":";;;;AAKA,SAAS,QAAQ,GAAA,EAA8B;AAC7C,EAAA,QAAQ,IAAI,MAAA;AAAQ,IAClB,KAAK,GAAA;AAAK,MAAA,OAAO,kFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,oFAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,+FAAA;AAAA,IACjB,KAAK,GAAA;AAAK,MAAA,OAAO,2DAAA;AAAA,IACjB;AAAU,MAAA,OAAO,8BAAA;AAAA;AAErB;AA+CO,SAAS,eAAe,GAAA,EAAqB;AAClD,EAAA,IAAI,eAAe,eAAA,EAAiB;AAClC,IAAA,MAAM,IAAA,GAAO,QAAQ,GAAG,CAAA;AACxB,IAAA,MAAM,UAAU,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA,EAAG;AAAA,MACpD,YAAY,GAAA,CAAI,MAAA;AAAA,MAChB,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,OAAA,EAAS,EAAE,IAAA;AAAK,KACjB,CAAA;AACD,IAAA,MAAM,OAAA;AAAA,EACR;AACA,EAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,YAAA,GAAe,iCAAA,CAAkC,IAAA,CAAK,OAAO,CAAA;AACnE,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,MAAM,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAO,CAAA,EAAG;AAAA,MACtC,UAAA,EAAY,GAAA;AAAA,MACZ,IAAA,EAAM,aAAA;AAAA,MACN,OAAA,EAAS,EAAE,IAAA,EAAM,2FAAA;AAA4F,KAC9G,CAAA;AAAA,EACH;AACA,EAAA,MAAM,GAAA;AACR;;;AC5EA,IAAO,4BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,QAAQ,IAAA,EAAuB;AACnC,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,aAAA,EAAc;AAC7B,MAAA,MAAM,SAAS,aAAA,EAAc;AAC7B,MAAA,OAAO,qBAAA,CAAsB,QAAQ,MAAM,CAAA;AAAA,IAC7C,SAAS,GAAA,EAAK;AACZ,MAAA,cAAA,CAAe,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACF,CAAC","file":"workspace-handler.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import { defineHandler, type PluginContextV3 } from '@kb-labs/sdk';\nimport { requireApiKey, requireTeamId, getWorkspaceHierarchy } from '@kb-labs/clickup-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3) {\n    try {\n      const apiKey = requireApiKey();\n      const teamId = requireTeamId();\n      return getWorkspaceHierarchy(apiKey, teamId);\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kb-labs/clickup-entry",
+  "version": "2.96.0",
+  "type": "module",
+  "description": "V3 manifest + CLI handlers for clickup",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin-manifest": {
+      "import": "./dist/manifest.js",
+      "types": "./dist/manifest.d.ts"
+    }
+  },
+  "kb": {
+    "manifest": "./dist/manifest.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@kb-labs/sdk": "2.21.2",
+    "@kb-labs/shared-command-kit": "2.96.0",
+    "@kb-labs/clickup-core": "2.96.0",
+    "@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",
+    "@kb-labs/shared-testing-e2e": "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",
+    "test:cli": "vitest run --config vitest.cli.config.ts --passWithNoTests"
+  }
+}