Adding card selection to 'create comment'

Author: GTFalcao

components/basecamp/actions/create-comment/create-comment.mjs

@@ -6,14 +6,22 @@ export default {
   name: "Create a Comment",
   description: "Creates a comment in a selected recording. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/comments.md#create-a-comment)",
   type: "action",
-  version: "0.0.8",
+  version: "0.1.0",
   props: {
     ...common.props,
+    recordingTypeAlert: {
+      type: "alert",
+      alertType: "info",
+      content: `You can select either a **Recording** (by selecting the recording type) or a **Card** (by selecting the card table and column) to create the comment on.
+\\
+If both are specified, the **Card** will take precedence.`,
+    },
     recordingType: {
       propDefinition: [
         app,
         "recordingType",
       ],
+      optional: true,
     },
     recordingId: {
       propDefinition: [
@@ -29,6 +37,49 @@ export default {
           recordingType,
         }),
       ],
+      optional: true,
+    },
+    cardTableId: {
+      propDefinition: [
+        app,
+        "cardTableId",
+        ({
+          accountId, projectId,
+        }) => ({
+          accountId,
+          projectId,
+        }),
+      ],
+      optional: true,
+    },
+    columnId: {
+      propDefinition: [
+        app,
+        "columnId",
+        ({
+          accountId, projectId, cardTableId,
+        }) => ({
+          accountId,
+          projectId,
+          cardTableId,
+        }),
+      ],
+      optional: true,
+    },
+    cardId: {
+      propDefinition: [
+        app,
+        "cardId",
+        ({
+          accountId, projectId, cardTableId, columnId,
+        }) => ({
+          accountId,
+          projectId,
+          cardTableId,
+          columnId,
+        }),
+      ],
+      optional: true,
     },
     content: {
       type: "string",
@@ -40,15 +91,14 @@ export default {
     const {
       accountId,
       projectId,
-      recordingId,
       content,
     } = this;
 
     const comment = await this.app.createComment({
       $,
       accountId,
       projectId,
-      recordingId,
+      recordingId: this.cardId ?? this.recordingId,
       data: {
         content,
       },

components/basecamp/basecamp.app.mjs

@@ -241,8 +241,8 @@ export default {
     },
     columnId: {
       type: "string",
-      label: "Column ID",
-      description: "Select a column or provide a column ID.",
+      label: "Card Column ID",
+      description: "Select a card column or provide a column ID.",
       async options({
         accountId, projectId, cardTableId,
       }) {
@@ -259,6 +259,26 @@ export default {
         }));
       },
     },
+    cardId: {
+      type: "string",
+      label: "Card ID",
+      description: "Select a card or provide a card ID.",
+      async options({
+        accountId, projectId, columnId,
+      }) {
+        const cards = await this.getCards({
+          accountId,
+          projectId,
+          columnId,
+        });
+        return cards.map(({
+          id: value, title: label,
+        }) => ({
+          value,
+          label,
+        }));
+      },
+    },
     botId: {
       type: "string",
       label: "Chatbot ID",
@@ -441,15 +461,17 @@ export default {
       const cardTables = dock.filter(({ name }) => name === "kanban_board");
       return cardTables;
     },
-    async getColumns({
-      accountId, projectId, cardTableId,
+    async getColumns(args) {
+      const { lists } = await this.getCardTable(args);
+      return lists;
+    },
+    async getCards({
+      projectId, columnId, ...args
     }) {
-      const { lists } = await this.getCardTable({
-        accountId,
-        projectId,
-        cardTableId: cardTableId,
+      return this.makeRequest({
+        path: `/buckets/${projectId}/card_tables/lists/${columnId}/cards.json`,
+        ...args,
       });
-      return lists;
     },
     getChatbot({
       projectId, campfireId, botId, ...args