[FEATURE] New Trello action

Author: jcortes

components/trello/actions/get-board/get-board.mjs

@@ -0,0 +1,167 @@
+import common from "../common/common.mjs";
+import fields from "../../common/fields.mjs";
+
+export default {
+  ...common,
+  key: "trello-get-board",
+  name: "Get Board",
+  description: "Request a single board. [See the documentation](https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-get).",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    ...common.props,
+    boardId: {
+      propDefinition: [
+        common.props.app,
+        "board",
+      ],
+      label: "Board ID",
+      description: "The ID of the board to retrieve",
+    },
+    actions: {
+      propDefinition: [
+        common.props.app,
+        "actions",
+      ],
+    },
+    boardStars: {
+      type: "string",
+      label: "Board Stars",
+      description: "Valid values are one of: `mine` or `none`. Default is `none`.",
+      options: [
+        "mine",
+        "none",
+      ],
+      optional: true,
+    },
+    cardPluginData: {
+      type: "boolean",
+      label: "Card Plugin Data",
+      description: "Use with the cards param to include card pluginData with the response. Default is `none`.",
+      optional: true,
+    },
+    customFields: {
+      type: "boolean",
+      label: "Custom Fields",
+      description: "This is a nested resource. Include custom fields in the response.",
+      default: false,
+      optional: true,
+    },
+    fields: {
+      type: "string[]",
+      label: "Fields",
+      description: "The fields of the board to be included in the response. Valid values: all or a comma-separated list of specific fields.",
+      options: fields.board,
+      optional: true,
+    },
+    labels: {
+      type: "string",
+      label: "Labels",
+      description: "This is a nested resource. Specify what labels to include in the response. One of: `all` or `none`",
+      optional: true,
+      options: [
+        "all",
+        "none",
+      ],
+    },
+    lists: {
+      description: "This is a nested resource. Specify what lists to include in the response.",
+      propDefinition: [
+        common.props.app,
+        "lists",
+        ({ boardId }) => ({
+          board: boardId,
+        }),
+      ],
+    },
+    members: {
+      propDefinition: [
+        common.props.app,
+        "members",
+        ({ boardId }) => ({
+          boardId,
+        }),
+      ],
+    },
+    pluginData: {
+      type: "boolean",
+      label: "Plugin Data",
+      description: "Determines whether the pluginData for this board should be returned.",
+      optional: true,
+    },
+    organization: {
+      type: "boolean",
+      label: "Organization",
+      description: "This is a nested resource. Include organization information in the response.",
+      optional: true,
+    },
+    organizationPluginData: {
+      type: "boolean",
+      label: "Organization Plugin Data",
+      description: "Use with the organization param to include organization pluginData with the response",
+      optional: true,
+    },
+    myPrefs: {
+      type: "boolean",
+      label: "My Preferences",
+      description: "Include the user's preferences for this board in the response.",
+      optional: true,
+    },
+    tags: {
+      type: "boolean",
+      label: "Tags",
+      description: "Also known as collections, tags, refer to the collection(s) that a Board belongs to.",
+      optional: true,
+    },
+  },
+  methods: {
+    getCommaSeparatedString(array) {
+      return Array.isArray(array)
+        ? array.join(",")
+        : array;
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      getCommaSeparatedString,
+      boardId,
+      actions,
+      boardStars,
+      cardPluginData,
+      customFields,
+      fields,
+      labels,
+      lists,
+      members,
+      pluginData,
+      organization,
+      organizationPluginData,
+      myPrefs,
+      tags,
+    } = this;
+
+    const response = await app.getBoard({
+      $,
+      boardId,
+      params: {
+        actions: getCommaSeparatedString(actions),
+        boardStars,
+        card_pluginData: cardPluginData,
+        customFields,
+        fields: getCommaSeparatedString(fields),
+        labels: getCommaSeparatedString(labels),
+        lists: getCommaSeparatedString(lists),
+        members: getCommaSeparatedString(members),
+        pluginData,
+        organization,
+        organizationPluginData,
+        myPrefs,
+        tags,
+      },
+    });
+
+    $.export("$summary", `Successfully retrieved board with ID \`${response.id}\``);
+    return response;
+  },
+};

components/trello/trello.app.mjs

@@ -2,6 +2,7 @@ import { axios } from "@pipedream/platform";
 import fields from "./common/fields.mjs";
 import constants from "./common/constants.mjs";
 import mime from "mime/types/standard.js";
+import actions from "./sources/common/actions.mjs";
 
 export default {
   type: "app",
@@ -338,6 +339,48 @@ export default {
         "url",
       ],
     },
+    actions: {
+      type: "string[]",
+      label: "Actions",
+      description: "This is a nested resource. Specify what actions to include in the response. Default is `all`.",
+      optional: true,
+      options: actions,
+    },
+    labels: {
+      type: "string[]",
+      label: "Labels",
+      description: "This is a nested resource. Specify what labels to include in the response.",
+      optional: true,
+      async options({ boardId }) {
+        if (!boardId) {
+          return [];
+        }
+        const labels = await this.findLabel({
+          boardId,
+        });
+        return labels.map(({ name }) => name);
+      },
+    },
+    members: {
+      type: "string[]",
+      label: "Members",
+      description: "This is a nested resource. Specify what members to include in the response.",
+      optional: true,
+      async options({ boardId }) {
+        if (!boardId) {
+          return [];
+        }
+        const members = await this.listMembers({
+          boardId,
+        });
+        return members.map(({
+          fullName: label, id: value,
+        }) => ({
+          label,
+          value,
+        }));
+      },
+    },
   },
   methods: {
     getSignerUri() {