@pipedream/trello 0.3.2 → 0.3.5

package/trello.app.js

@@ -1,113 +1,250 @@
-const axios = require("axios");
-var crypto = require("crypto");
-const events = [
-  { label: "Add Attachment To Card", value: `addAttachmentToCard` },
-  { label: "Add Checklist To Card", value: `addChecklistToCard` },
-  { label: "Add Label To Card", value: `addLabelToCard` },
-  { label: "Add Member To Board", value: `addMemberToBoard` },
-  { label: "Add Member To Card", value: `addMemberToCard` },
-  { label: "Comment Card", value: `commentCard` },
-  {
-    label: "Convert To Card From Check Item",
-    value: `convertToCardFromCheckItem`,
-  },
-  { label: "Copy Card", value: `copyCard` },
-  { label: "Create Card", value: `createCard` },
-  { label: "Create Check Item", value: `createCheckItem` },
-  { label: "Create Label", value: `createLabel` },
-  { label: "Create List", value: `createList` },
-  { label: "Delete Attachment From Card", value: `deleteAttachmentFromCard` },
-  { label: "Delete Card", value: `deleteCard` },
-  { label: "Delete Check Item", value: `deleteCheckItem` },
-  { label: "Delete Comment", value: `deleteComment` },
-  { label: "Delete Label", value: `deleteLabel` },
-  { label: "Email Card", value: `emailCard` },
-  { label: "Move Card From Board", value: `moveCardFromBoard` },
-  { label: "Move Card To Board", value: `moveCardToBoard` },
-  { label: "Move List From Board", value: `moveListFromBoard` },
-  { label: "Move List To Board", value: `moveListToBoard` },
-  { label: "Remove Checklist From Card", value: `removeChecklistFromCard` },
-  { label: "Remove Label From Card", value: `removeLabelFromCard` },
-  { label: "Remove Member From Board", value: `removeMemberFromBoard` },
-  { label: "Remove Member From Card", value: `removeMemberFromCard` },
-  { label: "Update Board", value: `updateBoard` },
-  { label: "Update Card", value: `updateCard` },
-  { label: "Update Check Item", value: `updateCheckItem` },
-  {
-    label: "Update Check Item State On Card",
-    value: `updateCheckItemStateOnCard`,
-  },
-  { label: "Update Checklist", value: `updateChecklist` },
-  { label: "Update Comment", value: `updateComment` },
-  { label: "Update Label", value: `updateLabel` },
-  { label: "Update List", value: `updateList` },
-];
+const { axios } = require("@pipedream/platform");
+const crypto = require("crypto");
+const events = require("./common/events.js");
+const fields = require("./common/fields.js");
+const mime = require("mime");
 
 module.exports = {
   type: "app",
   app: "trello",
+  description: "Pipedream Trello Components",
   propDefinitions: {
-    cardIds: {
-      // after should be array + assume after apps
+    cards: {
       type: "string[]",
       label: "Cards",
+      description: "The Trello cards you wish to select",
       optional: true,
-      // options needs to support standardized opts for pagination
       async options(opts) {
-        const cards = await this.getCards(opts.boardId);
-        // XXX short hand where value and label are same value
-        return cards.map((card) => {
-          return { label: card.name, value: card.id };
-        });
+        const cards = await this.getCards(opts.board);
+        return cards.map((card) => ({
+          label: card.name,
+          value: card.id,
+        }));
       },
     },
-    boardId: {
-      // after should be array + assume after apps
+    board: {
       type: "string",
       label: "Board",
-      // options needs to support standardized opts for pagination
-      async options(opts) {
-        const boards = await this.getBoards(this.$auth.oauth_uid);
-        // XXX short hand where value and label are same value
+      description: "The Trello board you wish to select",
+      async options() {
+        const boards = await this.getBoards();
         const activeBoards = boards.filter((board) => board.closed === false);
-        return activeBoards.map((board) => {
-          return { label: board.name, value: board.id };
-        });
+        return activeBoards.map((board) => ({
+          label: board.name,
+          value: board.id,
+        }));
       },
-      // XXX validate
+    },
+    boardFields: {
+      type: "string[]",
+      label: "Boards Fields",
+      description: "`all` or a list of board [fields](https://developer.atlassian.com/cloud/trello/guides/rest-api/object-definitions/#board-object)",
+      options: fields.board,
+      default: [
+        "name",
+        "idOrganization",
+      ],
+    },
+    cardFields: {
+      type: "string[]",
+      label: "Cards Fields",
+      description: "`all` or a list of card [fields](https://developer.atlassian.com/cloud/trello/guides/rest-api/object-definitions/#card-object)",
+      options: fields.card,
+      default: [
+        "all",
+      ],
     },
     eventTypes: {
-      // after should be array + assume after apps
       type: "string[]",
       label: "Event Types",
       optional: true,
-      description:
-        "Only emit events for the selected event types (e.g., `updateCard`).",
-      // options needs to support standardized opts for pagination
+      description: "Only emit events for the selected event types (e.g., `updateCard`).",
       options: events,
-      // XXX validate
     },
-    listIds: {
-      // after should be array + assume after apps
+    lists: {
       type: "string[]",
       label: "Lists",
+      description: "The Trello lists you wish to select",
       optional: true,
-      // options needs to support standardized opts for pagination
       async options(opts) {
-        const lists = await this.getLists(opts.boardId);
-        // XXX short hand where value and label are same value
-        return lists.map((list) => {
-          return { label: list.name, value: list.id };
-        });
+        const lists = await this.getLists(opts.board);
+        return lists.map((list) => ({
+          label: list.name,
+          value: list.id,
+        }));
+      },
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "The search query with a length of 1 to 16384 characters",
+    },
+    idOrganizations: {
+      type: "string[]",
+      label: "Organization IDs",
+      description: "Specify the organizations to search for boards in",
+      async options() {
+        const orgs = await this.listOrganizations(this.$auth.oauth_uid);
+        return orgs.map((org) => ({
+          label: org.name || org.id,
+          value: org.id,
+        }));
       },
-      // XXX validate
+      optional: true,
+    },
+    modelTypes: {
+      type: "string",
+      label: "Model Types",
+      description: "The type or types of Trello objects you want to search. `all` or a comma-separated list of: `actions`, `boards`, `cards`, `members`, `organizations`",
+      default: "all",
+    },
+    partial: {
+      type: "boolean",
+      label: "Partial Search?",
+      description: "Specifying partial to be true means that Trello will search for content that starts with any of the words in `query`. When searching for an object titled \"My Development Status Report\", by default a solution is to search for \"Development\". If partial is enabled, a search for \"dev\" is possible, however, a search for \"velopment\" is not possible.",
+      default: false,
+    },
+    label: {
+      type: "string",
+      label: "Label",
+      description: "The ID of the Label to be added to the card",
+      async options(opts) {
+        const labels = await this.findLabel(opts.board);
+        return labels.map((label) => ({
+          label: label.name,
+          value: label.id,
+        }));
+      },
+    },
+    member: {
+      type: "string",
+      label: "Member",
+      description: "The ID of the Member to be added to the card",
+      async options(opts) {
+        const members = await this.listMembers(opts.board);
+        return members.map((member) => ({
+          label: member.fullName,
+          value: member.id,
+        }));
+      },
+    },
+    checklist: {
+      type: "string",
+      label: "Checklist",
+      description: "The ID of a checklist to copy into the new checklist",
+      async options(opts) {
+        const {
+          board,
+          card,
+        } = opts;
+        const checklists = card ?
+          await this.listCardChecklists(card) :
+          await this.listBoardChecklists(board);
+        return checklists.map((checklist) => ({
+          label: checklist.name,
+          value: checklist.id,
+        }));
+      },
+    },
+    mimeType: {
+      type: "string",
+      label: "File Attachment Type",
+      description: "Not required for URL attachment",
+      optional: true,
+      options() {
+        return Object.values(mime._types);
+      },
+    },
+    name: {
+      type: "string",
+      label: "Name",
+      description: "The name of the attachment",
+      optional: true,
+    },
+    url: {
+      type: "string",
+      label: "File Attachment URL",
+      description: "URL must start with `http://` or `https://`",
+    },
+    desc: {
+      type: "string",
+      label: "Description",
+      description: "The description for the card",
+      optional: true,
+    },
+    pos: {
+      type: "string",
+      label: "Position",
+      description: "The position of the new card, can be `top`, `bottom`, or a positive number",
+      options: [
+        "top",
+        "bottom",
+      ],
+      optional: true,
+    },
+    due: {
+      type: "string",
+      label: "Due Date",
+      description: "Card due date in ISO format",
+      optional: true,
+    },
+    dueComplete: {
+      type: "boolean",
+      label: "Due Complete",
+      description: "Flag that indicates if `dueDate` expired",
+      optional: true,
+    },
+    address: {
+      type: "string",
+      label: "Address",
+      description: "For use with/by the Map Power-Up",
+      optional: true,
+    },
+    locationName: {
+      type: "string",
+      label: "Location Name",
+      description: "For use with/by the Map Power-Up",
+      optional: true,
+    },
+    coordinates: {
+      type: "string",
+      label: "Coordinates",
+      description: "Latitude, longitude coordinates. For use with/by the Map Power-Up. Should take the form `lat, long`.",
+      optional: true,
+    },
+    cardFilter: {
+      type: "string",
+      label: "Card Filter",
+      description: "Filter to apply to Cards. Valid values: `all`, `closed`, `none`, `open`, `visible`",
+      options: [
+        "all",
+        "closed",
+        "none",
+        "open",
+        "visible",
+      ],
+      default: "all",
+    },
+    listFilter: {
+      type: "string",
+      label: "List Filter",
+      description: "Type of list to search for",
+      options: [
+        "all",
+        "closed",
+        "none",
+        "open",
+      ],
+      default: "all",
     },
   },
   methods: {
-    async _getBaseUrl() {
-      return "https://api.trello.com/1"
+    _getBaseUrl() {
+      return "https://api.trello.com/1/";
     },
-    async _getAuthorizationHeader({ data, method, url }) {
+    async _getAuthorizationHeader({
+      data, method, url,
+    }, $) {
       const requestData = {
         data,
         method,
@@ -117,103 +254,352 @@ module.exports = {
         key: this.$auth.oauth_access_token,
         secret: this.$auth.oauth_refresh_token,
       };
-      return (
-        await axios({
-          method: "POST",
-          url: this.$auth.oauth_signer_uri,
-          data: {
-            requestData,
-            token,
-          },
-        })
-      ).data;
-    },
-    async _makeRequest(config) {
-      if (!config.headers) config.headers = {};
-      const authorization = await this._getAuthorizationHeader(config);
-      config.headers.authorization = authorization;
+      return axios($ ?? this, {
+        method: "POST",
+        url: this.$auth.oauth_signer_uri,
+        data: {
+          requestData,
+          token,
+        },
+      });
+    },
+    async _makeRequest(args, $) {
+      const {
+        method = "GET",
+        path,
+        ...otherArgs
+      } = args;
+      const config = {
+        method,
+        url: `${this._getBaseUrl()}${path}`,
+        ...otherArgs,
+      };
+      const authorization = await this._getAuthorizationHeader(config, $);
+      config.headers = {
+        ...config.headers,
+        authorization,
+      };
       try {
-        return await axios(config);
+        return await axios($ ?? this, config);
       } catch (err) {
-        console.log(err); // TODO
+        console.log(err);
       }
-    }, 
-    async verifyTrelloWebhookRequest(request, callbackURL) {
-      let secret = this.$auth.oauth_refresh_token;
-      var base64Digest = function (s) {
-        return crypto.createHmac("sha1", secret).update(s).digest("base64");
+    },
+    /**
+     * Archives a card.
+     *
+     * @param {string} idCard - the ID of the Card to archive.
+     * @returns an updated card object with `closed` (archived) property set to true.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-put
+     */
+    async archiveCard(idCard, $) {
+      const config = {
+        path: `cards/${idCard}`,
+        method: "PUT",
+        data: {
+          closed: true,
+        },
       };
-      var content = JSON.stringify(request.body) + callbackURL;
-      var doubleHash = base64Digest(content);
-      var headerHash = request.headers["x-trello-webhook"];
-      return doubleHash === headerHash;
+      return this._makeRequest(config, $);
     },
-    async getBoard(id) {
+    /**
+     * Create an Attachment to a Card
+     *
+     * @param {string} idCard - the ID of the Card to move.
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns {array} an string array with the ID of all the Card's Attachments.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-attachments-post
+     */
+    async addAttachmentToCardViaUrl(idCard, params, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/boards/${id}`,
+        path: `cards/${idCard}/attachments`,
+        method: "POST",
+        params,
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getBoards(id) {
+    /**
+     * Adds an existing label to the specified card.
+     *
+     * @param {string} idCard - the ID of the Card to move.
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns {array} an string array with the ID of all the Card's Labels.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-idlabels-post
+     */
+    async addExistingLabelToCard(idCard, params, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/members/${id}/boards`,
+        path: `cards/${idCard}/idLabels`,
+        method: "POST",
+        params,
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getCard(id) {
+    /**
+     * Add a member to a card
+     *
+     * @param {string} idCard - the ID of the Card to move.
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns {array} an string array with the ID of all the Card's Members.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-idmembers-post
+     */
+    async addMemberToCard(idCard, params, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/cards/${id}`,
+        path: `cards/${idCard}/idMembers`,
+        method: "POST",
+        params,
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getCards(id) {
+    /**
+     * Creates a checklist on the specified card.
+     *
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns an object with the created checklist.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-checklists/#api-checklists-post
+     */
+    async createChecklist(params, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/boards/${id}/cards`,
+        path: "checklists",
+        method: "POST",
+        params,
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getChecklist(id) {
+    /**
+     * Creates a comment on a card.
+     *
+     * @param {string} idCard - the ID of the Card that the comment should be created on.
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns a object containing a summary of the related card, members, and other Trello
+     * entities related to the newly created comment.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-actions-comments-post
+     */
+    async createCommentOnCard(idCard, comment, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/checklists/${id}`,
+        path: `cards/${idCard}/actions/comments`,
+        method: "POST",
+        params: {
+          text: comment,
+        },
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getLabel(id) {
+    /**
+     * Closes a board.
+     *
+     * @param {string} boardId - the ID of the Board to close.
+     * @returns the updated board object with the `closed` property set to true.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-put
+     */
+    async closeBoard(boardId, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/labels/${id}`,
+        path: `boards/${boardId}`,
+        method: "PUT",
+        data: {
+          closed: true,
+        },
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getList(id) {
+    /**
+     * Creates a new card.
+     *
+     * @param {Object} opts - an object containing data for the API request
+     * @returns the created card object. See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-post
+     */
+    async createCard(opts, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/lists/${id}`,
+        path: "cards",
+        method: "post",
+        data: opts,
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getLists(id) {
+    /**
+     * Deletes the specified checklist.
+     *
+     * @param {string} idChecklist - the ID of the checklist to delete.
+     * @returns {object} an empty `limits` object indicating the operation completed successfully.
+     */
+    async deleteChecklist(idChecklist, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/boards/${id}/lists`,
+        path: `checklists/${idChecklist}`,
+        method: "DELETE",
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getNotifications(id, params) {
+    /**
+     * Finds a label on a specific board.
+     *
+     * @param {string} boardId - unique identifier of the board to search for labels.
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns {array} an array with label objects complying with the specified parameters.
+     */
+    async findLabel(boardId, params, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/members/${id}/notifications`,
+        path: `boards/${boardId}/labels`,
         params,
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
     },
-    async getMember(id) {
+    /**
+     * Finds a list in the specified board.
+     *
+     * @param {string} - boardId unique identifier of the board to search for lists.
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns {array} an array with list objects conforming with the specified parameters.
+     */
+    async findList(boardId, params, $) {
+      const config = {
+        path: `boards/${boardId}/lists`,
+        params,
+      };
+      return this._makeRequest(config, $);
+    },
+    /**
+     * Moves a card to the specified board/list pair.
+     *
+     * @param {string} idCard the ID of the Card to move.
+     * @param {Object} data - an object containing data for the API request
+     * @returns an updated card object set to the specified board and list ids.
+     * See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-put
+     */
+    async moveCardToList(idCard, data, $) {
       const config = {
-        url: `${await this._getBaseUrl()}/members/${id}`,
+        path: `cards/${idCard}`,
+        method: "PUT",
+        data,
       };
-      return (await this._makeRequest(config)).data;
+      return this._makeRequest(config, $);
+    },
+    async verifyTrelloWebhookRequest(request, callbackURL) {
+      let secret = this.$auth.oauth_refresh_token;
+      const base64Digest = function (s) {
+        return crypto.createHmac("sha1", secret).update(s)
+          .digest("base64");
+      };
+      const content = JSON.stringify(request.body) + callbackURL;
+      const doubleHash = base64Digest(content);
+      const headerHash = request.headers["x-trello-webhook"];
+      return doubleHash === headerHash;
+    },
+    async getBoardActivity(boardId, filter = null) {
+      return this._makeRequest({
+        path: `boards/${boardId}/actions`,
+        params: {
+          filter,
+        },
+      });
+    },
+    async getCardActivity(cardId, filter = null) {
+      return this._makeRequest({
+        path: `cards/${cardId}/actions`,
+        params: {
+          filter,
+        },
+      });
+    },
+    async getBoard(id) {
+      return this._makeRequest({
+        path: `boards/${id}`,
+      });
+    },
+    async getBoards(id = this.$auth.oauth_uid) {
+      return this._makeRequest({
+        path: `members/${id}/boards`,
+      });
+    },
+    /**
+     * Gets details of a card.
+     *
+     * @param {string} id - the ID of the card to get details of.
+     * @returns  {object} a card object. See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-post
+     */
+    async getCard(id) {
+      return this._makeRequest({
+        path: `cards/${id}`,
+      });
+    },
+    async getCards(id) {
+      return this._makeRequest({
+        path: `boards/${id}/cards`,
+      });
+    },
+    async getFilteredCards(boardId, filter) {
+      return this._makeRequest({
+        path: `boards/${boardId}/cards`,
+        params: {
+          filter,
+        },
+      });
+    },
+    async getCardsInList(listId) {
+      return this._makeRequest({
+        path: `lists/${listId}/cards`,
+      });
+    },
+    async getMemberCards(userId) {
+      return this._makeRequest({
+        path: `members/${userId}/cards`,
+      });
+    },
+    async getChecklist(id) {
+      return this._makeRequest({
+        path: `checklists/${id}`,
+      });
+    },
+    async getLabel(id) {
+      return this._makeRequest({
+        path: `labels/${id}`,
+      });
+    },
+    async getList(id) {
+      return this._makeRequest({
+        path: `lists/${id}`,
+      });
+    },
+    async getLists(id) {
+      return this._makeRequest({
+        path: `boards/${id}/lists`,
+      });
+    },
+    async getNotifications(id, params) {
+      return this._makeRequest({
+        path: `members/${id}/notifications`,
+        params,
+      });
+    },
+    async getMember(id) {
+      return this._makeRequest({
+        path: `members/${id}`,
+      });
     },
-    async createHook({ id, endpoint }) {
-      console.log(`id: ${id}`);
+    async getAttachment(cardId, attachmentId) {
+      return this._makeRequest({
+        path: `cards/${cardId}/attachments/${attachmentId}`,
+      });
+    },
+    async getCardList(cardId) {
+      return this._makeRequest({
+        path: `cards/${cardId}/list`,
+      });
+    },
+    async createHook({
+      id, endpoint,
+    }) {
       const resp = await this._makeRequest({
         method: "post",
-        url: `${await this._getBaseUrl()}/webhooks/`,
+        path: "webhooks/",
         headers: {
           "Content-Type": "applicaton/json",
         },
@@ -223,16 +609,132 @@ module.exports = {
           callbackURL: endpoint,
         },
       });
-
-      console.log(resp);
-
-      return resp.data;
+      return resp;
     },
     async deleteHook({ hookId }) {
-      return await this._makeRequest({
+      return this._makeRequest({
         method: "delete",
-        url: `${await this._getBaseUrl()}/webhooks/${hookId}`,
+        path: `webhooks/${hookId}`,
+      });
+    },
+    /**
+     * Removes an existing label from the specified card.
+     *
+     * @param {string} idCard - the ID of the Card to remove the Label from.
+     * @param {string} idLabel - the ID of the Label to be removed from the card.
+     * @returns {object} an object with the null valued property `_value` indicating that
+     * there were no errors
+     */
+    async removeLabelFromCard(idCard, idLabel, $) {
+      const config = {
+        path: `cards/${idCard}/idLabels/${idLabel}`,
+        method: "DELETE",
+      };
+      return this._makeRequest(config, $);
+    },
+    /**
+     * Renames the specified list
+     *
+     * @param {string} listId - the ID of the List to rename.
+     * @param {Object} data - an object containing data for the API request
+     * @returns {object} a list object with the `closed` property, indicated if the list is
+     * closed or archived, `id` the id of the renamed List, `idBoard` the id of the Board parent
+     * to the List, `name` with the new name of the List, and `pos` with the position of the List
+     * in the Board.
+     */
+    async renameList(listId, data, $) {
+      const config = {
+        path: `lists/${listId}`,
+        method: "PUT",
+        data,
+      };
+      return this._makeRequest(config, $);
+    },
+    /**
+     * Searches for members, cards, boards, and/or organizations matching the specified query.
+     *
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns {cards: array, options: object} an array with the `cards` objects matching the
+     * specified `query`, and an object with the `options` for the search, such as `modelTypes` (in
+     * this case "cards"), `partial` the search `terms` as included in `query`, and other
+     * `modifiers`.
+     */
+    async search(params, $) {
+      const config = {
+        path: "search",
+        params,
+      };
+      return this._makeRequest(config, $);
+    },
+    /**
+     * Searches for boards matching the specified query.
+     *
+     * @param {Object} opts - an object containing data for the API request
+     * @returns {cards: array, options: object} an array with the `cards` objects matching the
+     * specified `query`, and an object with the `options` for the search, such as `modelTypes` (in
+     * this case "cards"), `partial` the search `terms` as included in `query`, and other
+     * `modifiers`.
+     */
+    async searchBoards(opts, $) {
+      const params = {
+        ...opts,
+        idOrganizations: opts.idOrganizations?.join(","),
+      };
+      return this.search(params, $);
+    },
+    /**
+     * Searches for cards matching the specified query.
+     *
+     * @param {Object} opts - an object containing data for the API request
+     * @returns {cards: array, options: object} an array with the `cards` objects matching the
+     * specified `query`, and an object with the `options` for the search, such as `modelTypes` (in
+     * this case "cards"), `partial` the search `terms` as included in `query`, and other
+     * `modifiers`.
+     */
+    async searchCards(opts, $) {
+      const params = {
+        ...opts,
+        idOrganizations: opts.idOrganizations?.join(","),
+        idCards: opts.idCards?.join(","),
+      };
+      return this.search(params, $);
+    },
+    /**
+     * Updates a card.
+     *
+     * @param {string} idCard - the ID of the card to update
+     * @param {Object} params - an object containing parameters for the API request
+     * @returns the updated card object. See more at the API docs:
+     * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-post
+     */
+    async updateCard(idCard,
+      params, $) {
+      const config = {
+        path: `cards/${idCard}`,
+        method: "PUT",
+        params,
+      };
+      return this._makeRequest(config, $);
+    },
+    async listMembers(board) {
+      return this._makeRequest({
+        path: `boards/${board}/members`,
+      });
+    },
+    async listBoardChecklists(board) {
+      return this._makeRequest({
+        path: `boards/${board}/checklists`,
+      });
+    },
+    async listCardChecklists(card) {
+      return this._makeRequest({
+        path: `cards/${card}/checklists`,
+      });
+    },
+    async listOrganizations(id) {
+      return this._makeRequest({
+        path: `members/${id}/organizations?fields="id,name"`,
       });
     },
   },
-};
+};