@pipedream/trello 0.3.14 → 0.4.1

package/actions/create-board/create-board.mjs

@@ -1,49 +1,60 @@
-// legacy_hash_id: a_Nqi0GV
-import { axios } from "@pipedream/platform";
+import app from "../../trello.app.mjs";
+import constants from "../../common/constants.mjs";
 
 export default {
   key: "trello-create-board",
   name: "Create a Board",
-  description: "Creates a new Trello board.",
-  version: "0.1.3",
+  description: "Create a new Trello board or copy from an existing one. [See the documentation](https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-post).",
+  version: "0.2.1",
   type: "action",
   props: {
-    trello: {
-      type: "app",
-      app: "trello",
-    },
+    app,
     name: {
       type: "string",
+      label: "Name",
       description: "The new name for the board. 1 to 16384 characters long.",
     },
     defaultLabels: {
       type: "boolean",
+      label: "Default Labels",
       description: "Determines whether to use the default set of labels.",
       optional: true,
     },
     defaultLists: {
       type: "boolean",
+      label: "Default Lists",
       description: "Determines whether to add the default set of lists to a board (To Do, Doing, Done). It is ignored if idBoardSource is provided.",
       optional: true,
     },
     desc: {
       type: "string",
+      label: "Description",
       description: "A new description for the board, 0 to 16384 characters long",
       optional: true,
     },
     idOrganization: {
       type: "string",
+      label: "Organization ID",
       description: "The id or name of the team the board should belong to.",
-      optional: true,
+      optional: false,
+      propDefinition: [
+        app,
+        "idOrganizations",
+      ],
     },
     idBoardSource: {
-      type: "string",
+      label: "Board Source ID",
       description: "The id of a board to copy into the new board.",
       optional: true,
+      propDefinition: [
+        app,
+        "board",
+      ],
     },
     keepFromSource: {
       type: "string",
-      description: "To keep cards from the original board pass in the value \"cards\".",
+      label: "Keep From Source",
+      description: "To keep cards from the original board pass in the value `cards`.",
       optional: true,
       options: [
         "none",
@@ -52,124 +63,111 @@ export default {
     },
     powerUps: {
       type: "string",
-      description: "The Power-Ups that should be enabled on the new board. One of: all, calendar, cardAging, recap, voting.",
+      label: "Power-Ups",
+      description: "The Power-Ups that should be enabled on the new board. One of: `all`, `calendar`, `cardAging`, `recap`, `voting`.",
       optional: true,
+      options: constants.POWER_UPS,
     },
-    prefs_permissionLevel: {
+    prefsPermissionLevel: {
       type: "string",
       description: "The permissions level of the board. One of: org, private, public.",
+      label: "Prefs Permission Level",
       optional: true,
-      options: [
-        "org",
-        "private",
-        "public",
-      ],
+      options: constants.PREFS_PERMISSION_LEVELS,
     },
-    prefs_voting: {
+    prefsVoting: {
       type: "string",
       label: "Prefs Voting",
       description: "Who can vote on this board. One of disabled, members, observers, org, public.",
       optional: true,
-      options: [
-        "disabled",
-        "members",
-        "observers",
-        "org",
-        "public",
-      ],
+      options: constants.PREFS_VOTING,
     },
-    prefs_comments: {
+    prefsComments: {
       type: "string",
       label: "Prefs Comments",
       description: "Who can comment on cards on this board. One of: disabled, members, observers, org, public.",
       optional: true,
-      options: [
-        "disabled",
-        "members",
-        "observers",
-        "org",
-        "public",
-      ],
+      options: constants.PREFS_COMMENTS,
     },
-    prefs_invitations: {
+    prefsInvitations: {
       type: "string",
       label: "Prefs Invitations",
       description: "Determines what types of members can invite users to join. One of: admins, members.",
       optional: true,
-      options: [
-        "admins",
-        "members",
-      ],
+      options: constants.PREFS_INVITATIONS,
     },
-    prefs_selfJoin: {
+    prefsSelfJoin: {
       type: "boolean",
+      label: "Prefs Self Join",
       description: "Determines whether users can join the boards themselves or whether they have to be invited.",
       optional: true,
     },
-    prefs_cardCovers: {
+    prefsCardCovers: {
       type: "boolean",
+      label: "Prefs Card Covers",
       description: "Determines whether card covers are enabled.",
       optional: true,
     },
-    prefs_background: {
+    prefsBackground: {
       type: "string",
       label: "Prefs Background",
-      description: "The id of a custom background or one of: blue, orange, green, red, purple, pink, lime, sky, grey.",
+      description: "The id of a custom background or one of: `blue`, `orange`, `green`, `red`, `purple`, `pink`, `lime`, `sky`, `grey`.",
       optional: true,
+      options: constants.PREFS_BACKGROUNDS,
     },
-    prefs_cardAging: {
+    prefsCardAging: {
       type: "string",
+      label: "Prefs Card Aging",
       description: "Determines the type of card aging that should take place on the board if card aging is enabled. One of: pirate, regular.",
       optional: true,
-      options: [
-        "pirate",
-        "regular",
-      ],
+      options: constants.PREFS_CARD_AGING,
     },
   },
   async run({ $ }) {
-    const oauthSignerUri = this.trello.$auth.oauth_signer_uri;
-
-    const trelloParams = [
-      "name",
-      "defaultLabels",
-      "defaultLists",
-      "desc",
-      "idOrganization",
-      "idBoardSource",
-      "keepFromSource",
-      "powerUps",
-      "prefs_permissionLevel",
-      "prefs_voting",
-      "prefs_comments",
-      "prefs_invitations",
-      "prefs_selfJoin",
-      "prefs_cardCovers",
-      "prefs_background",
-      "prefs_cardAging",
-    ];
-    let p = this;
-
-    const queryString = trelloParams.filter((param) => p[param]).map((param) => `${param}=${p[param]}`)
-      .join("&");
-
-    const config = {
-      url: `https://api.trello.com/1/boards?${queryString}`,
-      method: "POST",
-      data: "",
-    };
+    const {
+      app,
+      name,
+      defaultLabels,
+      defaultLists,
+      desc,
+      idOrganization,
+      idBoardSource,
+      keepFromSource,
+      powerUps,
+      prefsPermissionLevel,
+      prefsVoting,
+      prefsComments,
+      prefsInvitations,
+      prefsSelfJoin,
+      prefsCardCovers,
+      prefsBackground,
+      prefsCardAging,
+    } = this;
 
-    const token = {
-      key: this.trello.$auth.oauth_access_token,
-      secret: this.trello.$auth.oauth_refresh_token,
-    };
+    const response = await app.createBoard({
+      $,
+      params: {
+        name,
+        defaultLabels,
+        defaultLists,
+        desc,
+        idOrganization,
+        idBoardSource,
+        keepFromSource,
+        powerUps,
+        prefs_permissionLevel: prefsPermissionLevel,
+        prefs_voting: prefsVoting,
+        prefs_comments: prefsComments,
+        prefs_invitations: prefsInvitations,
+        prefs_selfJoin: prefsSelfJoin,
+        prefs_cardCovers: prefsCardCovers,
+        prefs_background: prefsBackground,
+        prefs_cardAging: prefsCardAging,
+      },
+    });
 
-    const signConfig = {
-      token,
-      oauthSignerUri,
-    };
+    $.export("$summary", `Successfully created board with ID \`${response.id}\`.`);
 
-    const resp = await axios($, config, signConfig);
-    return resp;
+    return response;
   },
 };

package/actions/create-card/create-card.mjs

@@ -1,23 +1,26 @@
-import common from "../common.mjs";
+import app from "../../trello.app.mjs";
+import fs from "fs";
+import FormData from "form-data";
+import { ConfigurationError } from "@pipedream/platform";
+import constants from "../../common/constants.mjs";
 
 export default {
-  ...common,
   key: "trello-create-card",
   name: "Create Card",
-  description: "Creates a new card. [See the documentation](https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-post)",
-  version: "0.0.3",
+  description: "Creates a new card. [See the documentation](https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-post).",
+  version: "0.1.1",
   type: "action",
   props: {
-    ...common.props,
+    app,
     board: {
       propDefinition: [
-        common.props.trello,
+        app,
         "board",
       ],
     },
     name: {
       propDefinition: [
-        common.props.trello,
+        app,
         "name",
       ],
       description: "The name of the card.",
@@ -25,31 +28,32 @@ export default {
     },
     desc: {
       propDefinition: [
-        common.props.trello,
+        app,
         "desc",
       ],
     },
     pos: {
       propDefinition: [
-        common.props.trello,
+        app,
         "pos",
       ],
+      description: "The position of the new card. `top`, `bottom`, or a positive float",
     },
     due: {
       propDefinition: [
-        common.props.trello,
+        app,
         "due",
       ],
     },
     dueComplete: {
       propDefinition: [
-        common.props.trello,
+        app,
         "dueComplete",
       ],
     },
     idList: {
       propDefinition: [
-        common.props.trello,
+        app,
         "lists",
         (c) => ({
           board: c.board,
@@ -62,7 +66,7 @@ export default {
     },
     idMembers: {
       propDefinition: [
-        common.props.trello,
+        app,
         "member",
         (c) => ({
           board: c.board,
@@ -75,7 +79,7 @@ export default {
     },
     idLabels: {
       propDefinition: [
-        common.props.trello,
+        app,
         "label",
         (c) => ({
           board: c.board,
@@ -86,28 +90,38 @@ export default {
       description: "Array of labelIDs to add to the card",
       optional: true,
     },
+    fileType: {
+      propDefinition: [
+        app,
+        "fileType",
+      ],
+      optional: true,
+      reloadProps: true,
+    },
     urlSource: {
       propDefinition: [
-        common.props.trello,
+        app,
         "url",
       ],
-      optional: true,
+      hidden: true,
     },
-    fileSource: {
-      type: "string",
-      label: "File Attachment Contents",
-      description: "Value must be in binary format",
-      optional: true,
+    file: {
+      propDefinition: [
+        app,
+        "file",
+      ],
+      hidden: true,
     },
     mimeType: {
       propDefinition: [
-        common.props.trello,
+        app,
         "mimeType",
       ],
+      hidden: true,
     },
     idCardSource: {
       propDefinition: [
-        common.props.trello,
+        app,
         "cards",
         (c) => ({
           board: c.board,
@@ -115,45 +129,38 @@ export default {
       ],
       type: "string",
       label: "Copy Card",
-      description: "Specify an existing card to copy contents from",
+      description: "Specify an existing card to copy contents from. Keep in mind that if you copy a card, the **File Attachment Path**, **File Attachment URL** and **File Attachment Type** fields will be ignored.",
+      reloadProps: true,
     },
     keepFromSource: {
       type: "string[]",
       label: "Copy From Source",
       description: "Specify which properties to copy from the source card",
-      options: [
-        "all",
-        "attachments",
-        "checklists",
-        "comments",
-        "due",
-        "labels",
-        "members",
-        "stickers",
-      ],
+      options: constants.CARD_KEEP_FROM_SOURCE_PROPERTIES,
       optional: true,
+      hidden: true,
     },
     address: {
       propDefinition: [
-        common.props.trello,
+        app,
         "address",
       ],
     },
     locationName: {
       propDefinition: [
-        common.props.trello,
+        app,
         "locationName",
       ],
     },
     coordinates: {
       propDefinition: [
-        common.props.trello,
+        app,
         "coordinates",
       ],
     },
     customFieldIds: {
       propDefinition: [
-        common.props.trello,
+        app,
         "customFieldIds",
         (c) => ({
           boardId: c.board,
@@ -162,13 +169,24 @@ export default {
       reloadProps: true,
     },
   },
-  async additionalProps() {
+  async additionalProps(existingProps) {
     const props = {};
+
+    const attachmentIsPath = this.fileType === "path";
+    const attachmentIsUrl = this.fileType === "url";
+    existingProps.file.hidden = !attachmentIsPath;
+    existingProps.mimeType.hidden = !attachmentIsPath;
+    existingProps.urlSource.hidden = !attachmentIsUrl;
+
+    existingProps.keepFromSource.hidden = !this.idCardSource;
+
     if (!this.customFieldIds?.length) {
       return props;
     }
     for (const customFieldId of this.customFieldIds) {
-      const customField = await this.trello.getCustomField(customFieldId);
+      const customField = await this.app.getCustomField({
+        customFieldId,
+      });
       props[customFieldId] = {
         type: "string",
         label: `Value for Custom Field - ${customField.name}`,
@@ -183,11 +201,13 @@ export default {
     return props;
   },
   methods: {
-    ...common.methods,
     async getCustomFieldItems($) {
       const customFieldItems = [];
       for (const customFieldId of this.customFieldIds) {
-        const customField = await this.trello.getCustomField(customFieldId, $);
+        const customField = await this.app.getCustomField({
+          $,
+          customFieldId,
+        });
         const customFieldItem = {
           idCustomField: customFieldId,
         };
@@ -218,8 +238,8 @@ export default {
       idMembers,
       idLabels,
       urlSource,
-      fileSource,
       mimeType,
+      file,
       idCardSource,
       keepFromSource,
       address,
@@ -227,7 +247,9 @@ export default {
       coordinates,
       customFieldIds,
     } = this;
-    const res = await this.trello.createCard({
+
+    let response;
+    const params = {
       name,
       desc,
       pos,
@@ -236,25 +258,52 @@ export default {
       idList,
       idMembers,
       idLabels,
-      urlSource,
-      fileSource,
       mimeType,
       idCardSource,
       keepFromSource: keepFromSource?.join(","),
       address,
       locationName,
       coordinates,
-    }, $);
+    };
+
+    if (file && !file?.startsWith("/tmp")) {
+      throw new ConfigurationError("The file path must be in the `/tmp` directory");
+    }
+
+    if (file) {
+      const form = new FormData();
+      form.append("fileSource", fs.createReadStream(file));
+
+      response = await this.app.createCard({
+        $,
+        params,
+        headers: form.getHeaders(),
+        data: form,
+      });
+    } else {
+      response = await this.app.createCard({
+        $,
+        params: {
+          ...params,
+          urlSource,
+        },
+      });
+    }
 
     if (customFieldIds) {
       const customFieldItems = await this.getCustomFieldItems($);
-      const customFields = await this.trello.updateCustomFields(res.id, {
-        customFieldItems,
-      }, $);
-      res.customFields = customFields;
+      const customFields = await this.app.updateCustomFields({
+        $,
+        cardId: response.id,
+        data: {
+          customFieldItems,
+        },
+      });
+      response.customFields = customFields;
     }
 
-    $.export("$summary", `Successfully created card ${res.id}`);
-    return res;
+    $.export("$summary", `Successfully created card \`${response.id}\`.`);
+
+    return response;
   },
 };

package/actions/create-checklist-item/create-checklist-item.mjs

@@ -1,67 +1,82 @@
-// legacy_hash_id: a_bKiP4j
-import { axios } from "@pipedream/platform";
+import app from "../../trello.app.mjs";
 
 export default {
   key: "trello-create-checklist-item",
   name: "Create a Checklist Item",
-  description: "Creates a new checklist item in a card.",
-  version: "0.1.3",
+  description: "Creates a new checklist item in a card. [See the documentation](https://developer.atlassian.com/cloud/trello/rest/api-group-checklists/#api-checklists-id-checkitems-post).",
+  version: "0.2.1",
   type: "action",
   props: {
-    trello: {
-      type: "app",
-      app: "trello",
+    app,
+    board: {
+      propDefinition: [
+        app,
+        "board",
+      ],
     },
-    id: {
+    card: {
+      propDefinition: [
+        app,
+        "cards",
+        ({ board }) => ({
+          board,
+          checklistCardsOnly: true,
+        }),
+      ],
       type: "string",
+      label: "Card",
+      description: "The ID of the Card that the checklist item should be added to",
+      optional: false,
+    },
+    checklistId: {
+      label: "Checklist ID",
       description: "ID of a checklist.",
+      propDefinition: [
+        app,
+        "checklist",
+        ({ card }) => ({
+          card,
+        }),
+      ],
     },
     name: {
       type: "string",
+      label: "Name",
       description: "The name of the new check item on the checklist. Should be a string of length 1 to 16384.",
     },
     pos: {
-      type: "string",
-      description: "The position of the check item in the checklist. One of: top, bottom, or a positive number.",
-      optional: true,
+      propDefinition: [
+        app,
+        "pos",
+      ],
     },
     checked: {
       type: "boolean",
+      label: "Checked",
       description: "Determines whether the check item is already checked when created.",
       optional: true,
     },
   },
   async run({ $ }) {
-    const oauthSignerUri = this.trello.$auth.oauth_signer_uri;
-
-    let id = this.id;
-    const trelloParams = [
-      "name",
-      "pos",
-      "checked",
-    ];
-    let p = this;
-
-    const queryString = trelloParams.filter((param) => p[param]).map((param) => `${param}=${p[param]}`)
-      .join("&");
-
-    const config = {
-      url: `https://api.trello.com/1/checklists/${id}/checkItems?${queryString}`,
-      method: "POST",
-      data: "",
-    };
+    const {
+      checklistId,
+      name,
+      pos,
+      checked,
+    } = this;
 
-    const token = {
-      key: this.trello.$auth.oauth_access_token,
-      secret: this.trello.$auth.oauth_refresh_token,
-    };
+    const response = await this.app.createChecklistItem({
+      $,
+      checklistId,
+      params: {
+        name,
+        pos,
+        checked,
+      },
+    });
 
-    const signConfig = {
-      token,
-      oauthSignerUri,
-    };
+    $.export("$summary", `Successfully created a checklist item with ID: ${response.id}`);
 
-    const resp = await axios($, config, signConfig);
-    return resp;
+    return response;
   },
 };