@skillful-ai/piece-clickup-extended 0.1.3 → 0.1.5

package/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillful-ai/piece-clickup-extended",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -20,4 +20,4 @@
     "tslib": "^2.3.0",
     "zod": "3.25.76"
   }
-}
+}

package/project.json

@@ -0,0 +1,51 @@
+{
+  "name": "pieces-clickup-extended",
+  "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/pieces/custom/clickup-extended/src",
+  "projectType": "library",
+  "release": {
+    "version": {
+      "manifestRootsToUpdate": [
+        "dist/{projectRoot}"
+      ],
+      "currentVersionResolver": "git-tag",
+      "fallbackCurrentVersionResolver": "disk"
+    }
+  },
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": [
+        "{options.outputPath}"
+      ],
+      "options": {
+        "outputPath": "dist/packages/pieces/custom/clickup-extended",
+        "tsConfig": "packages/pieces/custom/clickup-extended/tsconfig.lib.json",
+        "packageJson": "packages/pieces/custom/clickup-extended/package.json",
+        "main": "packages/pieces/custom/clickup-extended/src/index.ts",
+        "assets": [
+          "packages/pieces/custom/clickup-extended/*.md",
+          {
+            "input": "packages/pieces/custom/clickup-extended/src/i18n",
+            "output": "./src/i18n",
+            "glob": "**/!(i18n.json)"
+          }
+        ],
+        "buildableProjectDepsInPackageJsonType": "dependencies",
+        "updateBuildableProjectDepsInPackageJson": false
+      }
+    },
+    "nx-release-publish": {
+      "options": {
+        "packageRoot": "dist/{projectRoot}"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": [
+        "{options.outputFile}"
+      ]
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,124 @@
+import { createCustomApiCallAction } from '@activepieces/pieces-common';
+import {
+  PieceAuth,
+  createPiece,
+} from '@activepieces/pieces-framework';
+import { PieceCategory } from '@activepieces/shared';
+import { createClickupTaskComment} from './lib/actions/comments/create-task-comment';
+import { getClickupTaskComments } from './lib/actions/comments/get-task-comments';
+import { getClickupAccessibleCustomFields } from './lib/actions/custom-fields/get-accessible-custom-fields';
+import { setClickupCustomFieldValue } from './lib/actions/custom-fields/set-custom-fields-value';
+import { createClickupFolderlessList } from './lib/actions/lists/create-folderless-list';
+import { getClickupList } from './lib/actions/lists/get-list';
+import { getClickupSpace } from './lib/actions/spaces/get-space';
+import { getClickupSpaces } from './lib/actions/spaces/get-spaces';
+import { createClickupSubtask } from './lib/actions/tasks/create-subtask';
+import { createClickupTask } from './lib/actions/tasks/create-task';
+import { createClickupTaskFromTemplate } from './lib/actions/tasks/create-task-from-template';
+import { deleteClickupTask } from './lib/actions/tasks/delete-task';
+import { filterClickupWorkspaceTasks } from './lib/actions/tasks/filter-workspace-tasks';
+import { filterClickupWorkspaceTimeEntries } from './lib/actions/tasks/filter-workspace-time-entries';
+import { getClickupTask } from './lib/actions/tasks/get-task';
+import { updateClickupTask } from './lib/actions/tasks/update-task';
+import { clickupTriggers as triggers } from './lib/triggers';
+import { getClickupChannels } from './lib/actions/chat/get-channels';
+import { getClickupChannelMessages } from './lib/actions/chat/get-channel-messages';
+import { createClickupChannel } from './lib/actions/chat/create-channel';
+import { createClickupChannelInSpaceFolderOrList } from './lib/actions/chat/create-channel-in-space-folder-list';
+import { getClickupChannel } from './lib/actions/chat/get-channel';
+import { createClickupMessage } from './lib/actions/chat/create-message';
+import { createClickupMessageReply } from './lib/actions/chat/create-message-reply';
+import { createClickupMessageReaction } from './lib/actions/chat/create-message-reaction';
+import { getClickupMessageReactions } from './lib/actions/chat/get-message-reactions';
+import { getClickupMessageReplies } from './lib/actions/chat/get-message-replies';
+import { updateClickupMessage } from './lib/actions/chat/update-message';
+import { deleteClickupMessage } from './lib/actions/chat/delete-message';
+import { deleteClickupMessageReaction } from './lib/actions/chat/delete-message-reaction';
+import { getClickupTaskByName } from './lib/actions/tasks/get-task-by-name';
+// New extended actions
+import { getClickupFolders } from './lib/actions/folders/get-folders';
+import { createClickupFolder } from './lib/actions/folders/create-folder';
+import { getClickupListsInFolder } from './lib/actions/lists/get-lists-in-folder';
+import { createClickupListInFolder } from './lib/actions/lists/create-list-in-folder';
+import { getClickupTasksInList } from './lib/actions/tasks/get-tasks-in-list';
+import { createClickupTaskAttachment } from './lib/actions/attachments/create-task-attachment';
+import { getClickupTeams } from './lib/actions/teams/get-teams';
+
+export const clickupAuth = PieceAuth.SecretText({
+  displayName: 'Personal API Token',
+  description:
+    'Your ClickUp Personal API Token. Go to ClickUp > Settings > Apps to generate one.',
+  required: true,
+});
+
+export const clickupExtended = createPiece({
+  displayName: 'ClickUp Extended',
+  description: 'All-in-one productivity platform with extended folder, list, and attachment actions',
+  minimumSupportedRelease: '0.0.0',
+  logoUrl: 'https://cdn.activepieces.com/pieces/clickup.png',
+  categories: [PieceCategory.PRODUCTIVITY],
+  auth: clickupAuth,
+  actions: [
+    // Discovery actions (no required props — agent-friendly)
+    getClickupTeams,
+    // Original actions
+    createClickupTask,
+    createClickupTaskFromTemplate,
+    createClickupFolderlessList,
+    createClickupTaskComment,
+    createClickupSubtask,
+    createClickupChannel,
+    createClickupChannelInSpaceFolderOrList,
+    createClickupMessage,
+    createClickupMessageReaction,
+    createClickupMessageReply,
+    getClickupList,
+    getClickupTask,
+    getClickupTaskByName,
+    getClickupSpace,
+    getClickupSpaces,
+    getClickupTaskComments,
+    getClickupChannel,
+    getClickupChannels,
+    getClickupChannelMessages,
+    getClickupMessageReactions,
+    getClickupMessageReplies,
+    filterClickupWorkspaceTasks,
+    filterClickupWorkspaceTimeEntries,
+    updateClickupTask,
+    updateClickupMessage,
+    deleteClickupMessage,
+    deleteClickupMessageReaction,
+    deleteClickupTask,
+    getClickupAccessibleCustomFields,
+    setClickupCustomFieldValue,
+    // New extended actions
+    getClickupFolders,
+    createClickupFolder,
+    getClickupListsInFolder,
+    createClickupListInFolder,
+    getClickupTasksInList,
+    createClickupTaskAttachment,
+    createCustomApiCallAction({
+      auth: clickupAuth,
+      baseUrl: () => {
+        return 'https://api.clickup.com/api/v2/';
+      },
+      authMapping: async (auth) => {
+        return {
+          Authorization: `${auth as string}`,
+        };
+      },
+    }),
+  ],
+  authors: [
+    'kanarelo',
+    'kishanprmr',
+    'MoShizzle',
+    'khaledmashaly',
+    'abuaboud',
+    'AbdulTheActivePiecer',
+    'skillful-ai',
+  ],
+  triggers,
+});

package/src/lib/actions/attachments/create-task-attachment.ts

@@ -0,0 +1,78 @@
+import { Property, createAction } from '@activepieces/pieces-framework';
+import axios from 'axios';
+import { clickupCommon } from '../../common';
+import { clickupAuth } from '../../../';
+
+export const createClickupTaskAttachment = createAction({
+  auth: clickupAuth,
+  name: 'create_task_attachment',
+  description:
+    'Uploads a file attachment to a ClickUp task. Accepts either a direct file upload or a URL to download the file from.',
+  displayName: 'Create Task Attachment',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    space_id: clickupCommon.space_id(),
+    folder_id: clickupCommon.folder_id(),
+    list_id: clickupCommon.list_id(),
+    task_id: clickupCommon.task_id(),
+    file: Property.File({
+      displayName: 'File',
+      description:
+        'The file to attach (binary upload or URL). When called by an agent, provide the image/file URL.',
+      required: false,
+    }),
+    file_url: Property.ShortText({
+      displayName: 'File URL',
+      description:
+        'URL to download the file from (alternative to File property). Use this when you have a direct URL to the image or document.',
+      required: false,
+    }),
+    file_name: Property.ShortText({
+      displayName: 'File Name',
+      description:
+        'The name for the attachment file (including extension, e.g. screenshot.png)',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const { task_id, file, file_url, file_name } = context.propsValue;
+    const accessToken = context.auth as string;
+
+    let fileBuffer: Buffer;
+
+    if (file && file.data) {
+      // Option 1: File was provided directly (or auto-downloaded by engine from URL)
+      fileBuffer = file.data;
+    } else if (file_url) {
+      // Option 2: Download from explicit URL
+      const downloadResponse = await axios.get(file_url, {
+        responseType: 'arraybuffer',
+        timeout: 30000,
+      });
+      fileBuffer = Buffer.from(downloadResponse.data);
+    } else {
+      throw new Error(
+        'Either a file or a file_url must be provided to create an attachment.'
+      );
+    }
+
+    // Build multipart form data manually for axios
+    // Using FormData with Blob — axios handles Content-Type automatically
+    const formData = new FormData();
+    const blob = new Blob([fileBuffer]);
+    formData.append('attachment', blob, file_name);
+
+    const response = await axios.post(
+      `https://api.clickup.com/api/v2/task/${task_id}/attachment`,
+      formData,
+      {
+        headers: {
+          Authorization: accessToken,
+        },
+        timeout: 60000,
+      }
+    );
+
+    return response.data;
+  },
+});

package/src/lib/actions/chat/create-channel-in-space-folder-list.ts

@@ -0,0 +1,80 @@
+import { Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { callClickUpApi3, clickupCommon } from '../../common';
+import { clickupAuth } from '../../..';
+import { createAction } from '@activepieces/pieces-framework';
+
+export const createClickupChannelInSpaceFolderOrList = createAction({
+  auth: clickupAuth,
+  name: 'create_channel_in_space_folder_list',
+  description:
+    'Creates a channel in a ClickUp workspace in a space, folder or list',
+  displayName: 'Create Channel in Space/Folder/List',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    description: Property.ShortText({
+      description: 'Description of the channel',
+      displayName: 'Channel Description',
+      required: false,
+      defaultValue: '',
+    }),
+    topic: Property.ShortText({
+      description: 'Topic of the channel',
+      displayName: 'Channel Topic',
+      required: false,
+      defaultValue: '',
+    }),
+    locationType: Property.StaticDropdown({
+      description: 'Type of location',
+      displayName: 'Location Type',
+      required: true,
+      options: {
+        options: [
+          { label: 'Folder', value: 'folder' },
+          { label: 'Space', value: 'space' },
+          { label: 'List', value: 'list' },
+        ],
+      },
+      defaultValue: 'folder',
+    }),
+    locationId: Property.ShortText({
+      description: 'ID of the location',
+      displayName: 'Location ID',
+      required: true,
+    }),
+    // TODO: add user ids
+    visibility: Property.StaticDropdown({
+      description: 'Visibility of the channel',
+      displayName: 'Channel Visibility',
+      required: true,
+      options: {
+        options: [
+          { label: 'Public', value: 'PUBLIC' },
+          { label: 'Private', value: 'PRIVATE' },
+        ],
+      },
+      defaultValue: 'public',
+    }),
+  },
+
+  async run(configValue) {
+    const { workspace_id, description, visibility, locationType, locationId,topic } =
+      configValue.propsValue;
+    const response = await callClickUpApi3(
+      HttpMethod.POST,
+      `workspaces/${workspace_id}/chat/channels/location`,
+      (configValue.auth as string),
+      {
+        topic,
+        description,
+        visibility,
+        location: {
+          id: locationId,
+          type: locationType,
+        },
+      },
+      {}
+    );
+    return response.body;
+  },
+});

package/src/lib/actions/chat/create-channel.ts

@@ -0,0 +1,64 @@
+import { Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { callClickUpApi3, clickupCommon } from '../../common';
+import { clickupAuth } from '../../../';
+import { createAction } from '@activepieces/pieces-framework';
+
+export const createClickupChannel = createAction({
+  auth: clickupAuth,
+  name: 'create_channel',
+  description: 'Creates a channel in a ClickUp workspace',
+  displayName: 'Create Channel',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    name: Property.ShortText({
+      description: 'Name of the channel',
+      displayName: 'Channel Name',
+      required: true,
+      defaultValue: '',
+    }),
+    description: Property.ShortText({
+      description: 'Description of the channel',
+      displayName: 'Channel Description',
+      required: false,
+      defaultValue: '',
+    }),
+    topic: Property.ShortText({
+      description: 'Topic of the channel',
+      displayName: 'Channel Topic',
+      required: false,
+      defaultValue: '',
+    }),
+    // TODO: add user ids
+    visibility: Property.StaticDropdown({
+      description: 'Visibility of the channel',
+      displayName: 'Channel Visibility',
+      required: true,
+      options: {
+        options: [
+          { label: 'Public', value: 'PUBLIC' },
+          { label: 'Private', value: 'PRIVATE' },
+        ],
+      },
+      defaultValue: 'public',
+    }),
+  },
+
+  async run(configValue) {
+    const { workspace_id, name, description, visibility,topic } =
+      configValue.propsValue;
+    const response = await callClickUpApi3(
+      HttpMethod.POST,
+      `workspaces/${workspace_id}/chat/channels`,
+      (configValue.auth as string),
+      {
+        name,
+        topic,
+        description,
+        visibility,
+      },
+      {}
+    );
+    return response.body;
+  },
+});

package/src/lib/actions/chat/create-message-reaction.ts

@@ -0,0 +1,37 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { callClickUpApi3, clickupCommon } from '../../common';
+import { clickupAuth } from '../../../';
+
+export const createClickupMessageReaction = createAction({
+  auth: clickupAuth,
+  name: 'create_message_reaction',
+  description: 'Creates a reaction to a message in a ClickUp channel',
+  displayName: 'Create Message Reaction',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    message_id: Property.ShortText({
+      description: 'ID of the message to create reaction for',
+      displayName: 'Message ID',
+      required: true,
+    }),
+    emoji: Property.ShortText({
+      description: 'Emoji to react with',
+      displayName: 'Emoji',
+      required: true,
+    }),
+  },
+
+  async run(configValue) {
+    const { workspace_id, message_id, emoji } = configValue.propsValue;
+    const response = await callClickUpApi3(
+      HttpMethod.POST,
+      `workspaces/${workspace_id}/chat/messages/${message_id}/reactions`,
+      (configValue.auth as string),
+      { emoji },
+      {}
+    );
+    return response.body;
+  },
+});

package/src/lib/actions/chat/create-message-reply.ts

@@ -0,0 +1,52 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { callClickUpApi3, clickupCommon } from '../../common';
+import { clickupAuth } from '../../../';
+
+export const createClickupMessageReply = createAction({
+  auth: clickupAuth,
+  name: 'create_message_reply',
+  description: 'Creates a reply to a message in a ClickUp channel',
+  displayName: 'Create Message Reply',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    message_id: Property.ShortText({
+      description: 'ID of the message to reply to',
+      displayName: 'Message ID',
+      required: true,
+    }),
+    content: Property.LongText({
+      description: 'Content of the message',
+      displayName: 'Message Content',
+      required: true,
+    }),
+    type: Property.StaticDropdown({
+      description: 'Type of the message',
+      displayName: 'Message Type',
+      required: true,
+      options: {
+        options: [
+          { label: 'Message', value: 'message' },
+          { label: 'Post', value: 'post' },
+        ],
+      },
+      defaultValue: 'message',
+    }),
+  },
+
+  async run(configValue) {
+    const { workspace_id, message_id, content, type } = configValue.propsValue;
+    const response = await callClickUpApi3(
+      HttpMethod.POST,
+      `workspaces/${workspace_id}/chat/messages/${message_id}/replies`,
+      (configValue.auth as string),
+      {
+        content,
+        type,
+      },
+      {}
+    );
+    return response.body;
+  },
+});

package/src/lib/actions/chat/create-message.ts

@@ -0,0 +1,48 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { callClickUpApi3, clickupCommon } from '../../common';
+import { clickupAuth } from '../../../';
+
+export const createClickupMessage = createAction({
+  auth: clickupAuth,
+  name: 'create_message',
+  description: 'Creates a message in a ClickUp channel',
+  displayName: 'Create Message',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    channel_id: clickupCommon.channel_id(),
+    content: Property.LongText({
+      description: 'Content of the message',
+      displayName: 'Message Content',
+      required: true,
+    }),
+    type: Property.StaticDropdown({
+      description: 'Type of the message',
+      displayName: 'Message Type',
+      required: true,
+      options: {
+        options: [
+          { label: 'Message', value: 'message' },
+          { label: 'Post', value: 'post' },
+        ],
+      },
+      defaultValue: 'message',
+    }),
+  },
+
+  async run(configValue) {
+    const { workspace_id, channel_id, content, type } = configValue.propsValue;
+    const response = await callClickUpApi3(
+      HttpMethod.POST,
+      `workspaces/${workspace_id}/chat/channels/${channel_id}/messages`,
+      (configValue.auth as string),
+      {
+        content,
+        type,
+      },
+      {}
+    );
+    return response.body;
+  },
+});

package/src/lib/actions/chat/delete-message-reaction.ts

@@ -0,0 +1,37 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { callClickUpApi3, clickupCommon } from '../../common';
+import { clickupAuth } from '../../../';
+
+export const deleteClickupMessageReaction = createAction({
+  auth: clickupAuth,
+  name: 'delete_message_reaction',
+  description: 'Deletes a reaction from a message in a ClickUp channel',
+  displayName: 'Delete Message Reaction',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    message_id: Property.ShortText({
+      description: 'ID of the message to delete reaction from',
+      displayName: 'Message ID',
+      required: true,
+    }),
+    reaction_id: Property.ShortText({
+      description: 'ID of the reaction to delete',
+      displayName: 'Reaction ID',
+      required: true,
+    }),
+  },
+
+  async run(configValue) {
+    const { workspace_id, message_id, reaction_id } = configValue.propsValue;
+    const response = await callClickUpApi3(
+      HttpMethod.DELETE,
+      `workspaces/${workspace_id}/chat/messages/${message_id}/reactions/${reaction_id}`,
+      (configValue.auth as string),
+      {},
+      {}
+    );
+    return response.body;
+  },
+});

package/src/lib/actions/chat/delete-message.ts

@@ -0,0 +1,32 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { callClickUpApi3, clickupCommon } from '../../common';
+import { clickupAuth } from '../../../';
+
+export const deleteClickupMessage = createAction({
+  auth: clickupAuth,
+  name: 'delete_message',
+  description: 'Deletes a message in a ClickUp channel',
+  displayName: 'Delete Message',
+  props: {
+    workspace_id: clickupCommon.workspace_id(),
+    message_id: Property.ShortText({
+      description: 'ID of the message to delete',
+      displayName: 'Message ID',
+      required: true,
+    }),
+  },
+
+  async run(configValue) {
+    const { workspace_id, message_id } = configValue.propsValue;
+    const response = await callClickUpApi3(
+      HttpMethod.DELETE,
+      `workspaces/${workspace_id}/chat/messages/${message_id}`,
+      (configValue.auth as string),
+      {},
+      {}
+    );
+    return response.body;
+  },
+});