@divyacon/piece-clickup 0.0.0-stage → 0.1.0

package/src/lib/triggers/register-trigger.ts

@@ -0,0 +1,142 @@
+import { TriggerStrategy, createTrigger } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+  AuthenticationType,
+} from '@agnocon/pieces-common';
+import { callClickupGetTask, clickupCommon } from '../common';
+import { ClickupEventType, ClickupWebhookPayload } from '../common/models';
+import { clickupAuth } from '../auth';
+import { clickupTriggerOutputSchemas } from '../output-schemas';
+
+export const clickupRegisterTrigger = ({
+  name,
+  displayName,
+  eventType,
+  description,
+  aiMetadata,
+  sampleData,
+}: {
+  name: string;
+  displayName: string;
+  eventType: ClickupEventType;
+  description: string;
+  aiMetadata?: { description: string };
+  sampleData: unknown;
+}) =>
+  createTrigger({
+    auth: clickupAuth,
+    name: `clickup_trigger_${name}`,
+    displayName,
+    description,
+    aiMetadata,
+    props: {
+      workspace_id: clickupCommon.workspace_id(true),
+      space_id: clickupCommon.space_id(false), // Optional, depends on workspace
+      folder_id: clickupCommon.folder_id(false), // Optional, depends on space
+      list_id: clickupCommon.list_id(false), // Optional, depends on folder or space
+      task_id: clickupCommon.task_id(false), // Optional, depends on list
+    },
+    outputSchema: clickupTriggerOutputSchemas[name],
+    sampleData,
+    type: TriggerStrategy.WEBHOOK,
+    async onEnable(context) {
+      const { workspace_id, space_id, folder_id, list_id, task_id } =
+        context.propsValue;
+
+      const requestBody: Record<string, unknown> = {
+        endpoint: context.webhookUrl,
+        events: [eventType],
+      };
+
+      // Add scope narrowing properties to the webhook request body
+      if (space_id) requestBody.space_id = space_id;
+      if (folder_id) requestBody.folder_id = folder_id;
+      if (list_id) requestBody.list_id = list_id;
+      if (task_id) requestBody.task_id = task_id;
+
+      const request: HttpRequest = {
+        method: HttpMethod.POST,
+        url: `https://api.clickup.com/api/v2/team/${workspace_id}/webhook`,
+        body: requestBody,
+        authentication: {
+          type: AuthenticationType.BEARER_TOKEN,
+          token: context.auth.access_token,
+        },
+        queryParams: {},
+      };
+
+      const response = await httpClient.sendRequest<WebhookInformation>(
+        request
+      );
+
+      await context.store.put<WebhookInformation>(
+        `clickup_${name}_trigger`,
+        response.body
+      );
+    },
+    async onDisable(context) {
+      const webhook = await context.store.get<WebhookInformation>(
+        `clickup_${name}_trigger`
+      );
+      if (webhook != null) {
+        const request: HttpRequest = {
+          method: HttpMethod.DELETE,
+          url: `https://api.clickup.com/api/v2/webhook/${webhook.id}`,
+          authentication: {
+            type: AuthenticationType.BEARER_TOKEN,
+            token: context.auth['access_token'],
+          },
+        };
+        await httpClient.sendRequest(request);
+      }
+    },
+    async run(context) {
+      const payload = context.payload.body as ClickupWebhookPayload;
+
+      if (
+        [
+          ClickupEventType.TASK_CREATED,
+          ClickupEventType.TASK_UPDATED,
+          ClickupEventType.TASK_COMMENT_POSTED,
+          ClickupEventType.TASK_COMMENT_UPDATED,
+        ].includes(eventType)
+      ) {
+        const enriched = [
+          {
+            ...payload,
+            task: await callClickupGetTask(
+              context.auth['access_token'],
+              payload.task_id
+            ),
+          },
+        ];
+
+        return enriched;
+      }
+
+      return [context.payload.body];
+    },
+  });
+
+interface WebhookInformation {
+  id: string;
+  webhook: {
+    id: string;
+    userid: number;
+    team_id: number;
+    endpoint: string;
+    client_id: string;
+    events: ClickupEventType[];
+    task_id?: string;
+    list_id?: string;
+    folder_id?: string;
+    space_id?: string;
+    health: {
+      status: string;
+      fail_count: number;
+    };
+    secret: string;
+  };
+}

package/src/lib/triggers/task-tag-updated.ts

@@ -0,0 +1,132 @@
+import {
+  TriggerStrategy, createTrigger
+} from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+  AuthenticationType,
+} from "@agnocon/pieces-common";
+import { callClickupGetTask, clickupCommon } from '../common';
+import { ClickupEventType, ClickupWebhookPayload } from '../common/models';
+import { clickupAuth } from '../auth';
+import { taskEventTriggerOutputSchema } from '../output-schemas';
+
+export const triggerTaskTagUpdated = createTrigger({
+  auth: clickupAuth,
+  name: 'task_tag_updated',
+  displayName: 'Task Tag Updated',
+  description: 'Triggered when a tag is added or removed or renamed on a task.',
+  aiMetadata: {
+    description:
+      'Fires when a tag on a ClickUp task changes — a tag is added to the task, removed from it, or renamed. The event represents the updated tag state for that task, useful for reacting to tag-based categorization or status labeling in the selected workspace and space.',
+  },
+  sampleData: {
+    "event": "taskTagUpdated",
+    "history_items": [
+      {
+        "id": "2800797048554170804",
+        "type": 1,
+        "date": "1642736652800",
+        "field": "tag",
+        "parent_id": "162641062",
+        "data": {},
+        "source": null,
+        "user": {
+          "id": 183,
+          "username": "John",
+          "email": "john@company.com",
+          "color": "#7b68ee",
+          "initials": "J",
+          "profilePicture": null
+        },
+        "before": null,
+        "after": [
+          {
+            "name": "def",
+            "tag_fg": "#FF4081",
+            "tag_bg": "#FF4081",
+            "creator": 2770032
+          }
+        ]
+      }
+    ],
+    "task_id": "1vj38vv",
+    "webhook_id": "7fa3ec74-69a8-4530-a251-8a13730bd204"
+  },
+  props: {
+    workspace_id: clickupCommon.workspace_id(true),
+    space_id: clickupCommon.space_id(true),
+    list_id: clickupCommon.list_id(false),
+    task_id: clickupCommon.task_id(false),
+  },
+  outputSchema: taskEventTriggerOutputSchema,
+  type: TriggerStrategy.WEBHOOK,
+  async onEnable(context) {
+    const { workspace_id } = context.propsValue
+
+    const request: HttpRequest = {
+      method: HttpMethod.POST,
+      url: `https://api.clickup.com/api/v2/team/${workspace_id}/webhook`,
+      body: {
+        endpoint: context.webhookUrl,
+        events: [ClickupEventType.TASK_TAG_UPDATED]
+      },
+      authentication: {
+        type: AuthenticationType.BEARER_TOKEN,
+        token: context.auth.access_token
+      },
+      queryParams: {},
+    }
+
+    const response = await httpClient.sendRequest<WebhookInformation>(request);
+
+    await context.store.put<WebhookInformation>(`clickup_task_tag_updated_trigger`, response.body);
+  },
+  async onDisable(context) {
+    const webhook = await context.store.get<WebhookInformation>(`clickup_task_tag_updated_trigger`);
+    if (webhook != null) {
+      const request: HttpRequest = {
+        method: HttpMethod.DELETE,
+        url: `https://api.clickup.com/api/v2/webhook/${webhook.id}`,
+        authentication: {
+          type: AuthenticationType.BEARER_TOKEN,
+          token: context.auth['access_token'],
+        },
+      };
+      await httpClient.sendRequest(request);
+    }
+  },
+  async run(context) {
+    const payload = context.payload.body as ClickupWebhookPayload
+
+    return [{
+      ...payload,
+      task: await callClickupGetTask(
+        context.auth['access_token'],
+        payload.task_id
+      )
+    }];
+  }
+});
+
+interface WebhookInformation {
+  id: string
+  webhook: {
+    id: string
+    userid: number
+    team_id: number
+    endpoint: string
+    client_id: string
+    events: ClickupEventType[]
+    task_id: string
+    list_id: string
+    folder_id: string
+    space_id: string
+    health: {
+      status: string
+      fail_count: number
+    },
+    secret: string
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.