Monday usability improvements

components/monday/actions/common/common-create-item.mjs

@@ -11,7 +11,7 @@ export default {
         }),
       ],
       type: "string[]",
-      description: "Select columns to fill",
+      description: "Select which item columns to set values for.",
       reloadProps: true,
     },
   },
@@ -23,11 +23,11 @@ export default {
     for (const column of this.columns) {
       let description;
       if (column === "status") {
-        description = "Value for status. [Status Index Value Map](https://view.monday.com/1073554546-ad9f20a427a16e67ded630108994c11b?r=use1)";
+        description = "The status of the item. [See more about status values here](https://view.monday.com/1073554546-ad9f20a427a16e67ded630108994c11b?r=use1).";
       } else if (column === "person") {
-        description = "The ID of the person/user to add to item";
+        description = "The ID of a person/user.";
       } else if (column === "date4") {
-        description = "Enter date of item in YYYY-MM-DD format. Eg. `2022-09-02`";
+        description = "A date string in `YYYY-MM-DD` format, e.g. `2022-09-02`.";
       } else {
         description = `Value for column ${column}. See the [Column Type Reference](https://developer.monday.com/api-reference/docs/column-types-reference) to learn more about entering column type values.`;
       }

components/monday/actions/create-board/create-board.mjs

@@ -4,9 +4,9 @@ import monday from "../../monday.app.mjs";
 export default {
   key: "monday-create-board",
   name: "Create Board",
-  description: "Creates a new board. [See the documentation](https://api.developer.monday.com/docs/boards#create-a-board)",
+  description: "Creates a new board. [See the documentation](https://developer.monday.com/api-reference/reference/boards#create-a-board)",
   type: "action",
-  version: "0.0.7",
+  version: "0.0.8",
   props: {
     monday,
     boardName: {

components/monday/actions/create-column/create-column.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Create Column",
   description: "Creates a column. [See the documentation](https://developer.monday.com/api-reference/reference/columns#create-a-column)",
   type: "action",
-  version: "0.0.8",
+  version: "0.0.9",
   props: {
     monday,
     boardId: {
@@ -18,19 +18,19 @@ export default {
     title: {
       type: "string",
       label: "Title",
-      description: "The new column's title.",
+      description: "The title of the new column.",
     },
     columnType: {
       type: "string",
       label: "Column Type",
-      description: "The new column's title",
+      description: "The type of the new column.",
       options: constants.COLUMN_TYPE_OPTIONS,
       reloadProps: true,
     },
     description: {
       type: "string",
       label: "Description",
-      description: "The column's description.",
+      description: "The description of the new column.",
       optional: true,
     },
   },
@@ -39,7 +39,7 @@ export default {
     const defaults = {
       type: "string",
       label: "Defaults",
-      description: "The new column's defaults. For use with column types `status` or `dropdown`. [See the documentation](https://developer.monday.com/api-reference/reference/columns#create-a-status-or-dropdown-column-with-custom-labels) for additional information.",
+      description: "The new column's defaults. For use with column types `status` or `dropdown`. [See the documentation](https://developer.monday.com/api-reference/reference/columns#create-a-status-or-dropdown-column-with-custom-labels) for more information.",
       optional: true,
     };
     if (this.columnType === "status") {

components/monday/actions/create-group/create-group.mjs

@@ -3,9 +3,9 @@ import monday from "../../monday.app.mjs";
 export default {
   key: "monday-create-group",
   name: "Create Group",
-  description: "Creates a new group in a specific board. [See the documentation](https://api.developer.monday.com/docs/groups-queries#create-a-group)",
+  description: "Creates a new group in a specific board. [See the documentation](https://developer.monday.com/api-reference/reference/groups#create-a-group)",
   type: "action",
-  version: "0.0.8",
+  version: "0.0.9",
   props: {
     monday,
     boardId: {

components/monday/actions/create-item/create-item.mjs

@@ -6,9 +6,9 @@ export default {
   ...commonCreateItem,
   key: "monday-create-item",
   name: "Create Item",
-  description: "Creates an item. [See the documentation](https://api.developer.monday.com/docs/items-queries#create-an-item)",
+  description: "Creates an item. [See the documentation](https://developer.monday.com/api-reference/reference/items#create-an-item)",
   type: "action",
-  version: "0.0.10",
+  version: "0.0.11",
   props: {
     monday,
     boardId: {

components/monday/actions/create-subitem/create-subitem.mjs

@@ -8,7 +8,7 @@ export default {
   name: "Create Subitem",
   description: "Creates a subitem. [See the documentation](https://developer.monday.com/api-reference/reference/subitems#create-a-subitem)",
   type: "action",
-  version: "0.0.3",
+  version: "0.0.4",
   props: {
     monday,
     boardId: {
@@ -26,14 +26,14 @@ export default {
         }),
       ],
       optional: false,
-      description: "The parent item's unique identifier",
+      description: "Select a parent item or provide an item ID.",
     },
     itemName: {
       propDefinition: [
         monday,
         "itemName",
       ],
-      description: "The new subitem's name",
+      description: "The new subitem's name.",
     },
     ...commonCreateItem.props,
   },

components/monday/actions/create-update/create-update.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Create an Update",
   description: "Creates a new update. [See the documentation](https://developer.monday.com/api-reference/reference/updates#create-an-update)",
   type: "action",
-  version: "0.0.10",
+  version: "0.0.11",
   props: {
     monday,
     updateBody: {
@@ -33,7 +33,7 @@ export default {
     },
     parentId: {
       label: "Parent Update ID",
-      description: "The parent post identifier",
+      description: "Select a parent update or provide an update ID.",
       propDefinition: [
         monday,
         "updateId",

components/monday/actions/get-column-values/get-column-values.mjs

@@ -4,8 +4,8 @@ export default {
   ...common,
   key: "monday-get-column-values",
   name: "Get Column Values",
-  description: "Return values of a specific column or columns for a board item. [See the documentation](https://developer.monday.com/api-reference/docs/column-values-v2)",
-  version: "0.0.5",
+  description: "Return values of specific column(s) for a board item. [See the documentation](https://developer.monday.com/api-reference/docs/column-values-v2)",
+  version: "0.0.6",
   type: "action",
   props: {
     ...common.props,
@@ -29,7 +29,7 @@ export default {
       ],
       type: "string[]",
       label: "Columns",
-      description: "Return data from the specified column(s)",
+      description: "Select the column(s) to return data from.",
       optional: true,
     },
   },
@@ -49,7 +49,7 @@ export default {
       throw new Error(response.errors[0].message);
     }
 
-    $.export("$summary", `Successfully retrieved column values for item with ID ${this.itemId}.`);
+    $.export("$summary", `Successfully retrieved column values for item with ID ${this.itemId}`);
 
     return this.formatColumnValues(response.data.items);
   },

components/monday/actions/get-items-by-column-value/get-items-by-column-value.mjs

@@ -5,7 +5,7 @@ export default {
   key: "monday-get-items-by-column-value",
   name: "Get Items By Column Value",
   description: "Searches a column for items matching a value. [See the documentation](https://developer.monday.com/api-reference/docs/items-page-by-column-values)",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     ...common.props,
@@ -22,7 +22,7 @@ export default {
     value: {
       type: "string",
       label: "Value",
-      description: "The value to serach for. [See documentation](https://developer.monday.com/api-reference/docs/items-by-column-values#supported-limited-support-and-unsupported-columns) for additional information about column values.",
+      description: "The value to search for. [See the documentation](https://developer.monday.com/api-reference/docs/items-by-column-values#supported-limited-support-and-unsupported-columns) for additional information about column values.",
     },
   },
   async run({ $ }) {

components/monday/actions/update-column-values/update-column-values.mjs

@@ -8,13 +8,17 @@
   key: "monday-update-column-values",
   name: "Update Column Values",
   description: "Update multiple column values of an item. [See the documentation](https://developer.monday.com/api-reference/docs/columns#change-multiple-column-values)",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "action",
   props: {
     ...common.props,
+    updateInfoBox: {
+      type: "alert",
+      alertType: "info",
+      content: "See the [Column types reference](https://developer.monday.com/api-reference/docs/column-types-reference) to find the proper data structures for supported column types.",
+    },
     boardId: {
       ...common.props.boardId,
-      description: "The board's unique identifier. See the [Column types reference](https://developer.monday.com/api-reference/docs/column-types-reference) to find the proper data structures for supported column types.",
       reloadProps: true,
     },
     itemId: {

components/monday/actions/update-item-name/update-item-name.mjs

@@ -3,9 +3,9 @@ import monday from "../../monday.app.mjs";
 export default {
   key: "monday-update-item-name",
   name: "Update Item Name",
-  description: "Update an item's name. [See the documentation](https://api.developer.monday.com/docs/item-name)",
+  description: "Update an item's name. [See the documentation](https://developer.monday.com/api-reference/reference/columns#change-multiple-column-values)",
   type: "action",
-  version: "0.0.9",
+  version: "0.0.10",
   props: {
     monday,
     boardId: {

components/monday/monday.app.mjs

@@ -13,7 +13,7 @@ export default {
     boardId: {
       type: "string",
       label: "Board ID",
-      description: "The board's unique identifier",
+      description: "Select a board, or provide a board ID.",
       async options({ page }) {
         return this.listBoardsOptions({
           page: page + 1,
@@ -23,18 +23,18 @@ export default {
     boardName: {
       type: "string",
       label: "Board Name",
-      description: "The board's name",
+      description: "The new board's name",
     },
     boardKind: {
       type: "string",
       label: "Board Kind",
-      description: "The board's kind (`public` / `private` / `share`)",
+      description: "The new board's kind (`public` / `private` / `share`)",
       options: constants.BOARD_KIND_OPTIONS,
     },
     folderId: {
       type: "integer",
       label: "Folder ID",
-      description: "Board folder ID",
+      description: "Optionally select a folder to create the board in, or provide a folder ID.",
       optional: true,
       async options({ workspaceId }) {
         return this.listFolderOptions({
@@ -45,7 +45,7 @@ export default {
     workspaceId: {
       type: "integer",
       label: "Workspace ID",
-      description: "Board workspace ID. If you don't specify this field, the board will be created in the **Main Workspace**",
+      description: "Select a workspace to create the board in, or provide a workspace ID. If not specified, the **Main Workspace** will be used.",
       optional: true,
       async options() {
         return this.listWorkspacesOptions();
@@ -54,18 +54,18 @@ export default {
     templateId: {
       type: "integer",
       label: "Board Template ID",
-      description: "Board ID saved as a custom template. The ID can be obteined from the url in browser selecting the corresponding board (e.g. `https://{subdomain}.monday.com/boards/2419687965`) where `2419687965` is the ID of the template",
+      description: "The board's template ID. You can obtain it from the URL when selecting the desired board (e.g. `https://{subdomain}.monday.com/boards/2419687965`) where `2419687965` is the template ID. [See the documentation](https://developer.monday.com/api-reference/reference/boards#create-a-board) for more information.",
       optional: true,
     },
     groupName: {
       type: "string",
       label: "Group Name",
-      description: "The name of the new group",
+      description: "The name of the new group.",
     },
     groupId: {
       type: "string",
       label: "Group ID",
-      description: "The group's unique identifier",
+      description: "Select a group or provide a group ID.",
       optional: true,
       async options({ boardId }) {
         return this.listGroupsOptions({
@@ -76,7 +76,7 @@ export default {
     itemName: {
       type: "string",
       label: "Item Name",
-      description: "The item's name",
+      description: "The new item's name",
     },
     itemColumnValues: {
       type: "object",
@@ -98,7 +98,7 @@ export default {
     itemId: {
       type: "string",
       label: "Item ID",
-      description: "The item's unique identifier",
+      description: "Select an item or provide an item ID.",
       optional: true,
       async options({
         boardId, prevContext,
@@ -112,7 +112,7 @@ export default {
     updateId: {
       type: "string",
       label: "Update ID",
-      description: "The update's unique identifier",
+      description: "Select an update or provide an update ID.",
       optional: true,
       async options({
         page, boardId,
@@ -126,7 +126,7 @@ export default {
     column: {
       type: "string",
       label: "Column",
-      description: "Column to watch for changes",
+      description: "Select a column to watch for changes.",
       async options({ boardId }) {
         const columns = await this.listColumns({
           boardId: +boardId,

components/monday/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/monday",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Pipedream Monday Components",
   "main": "monday.app.mjs",
   "keywords": [

components/monday/sources/column-value-updated/column-value-updated.mjs

@@ -3,17 +3,25 @@
 export default {
   ...common,
   key: "monday-column-value-updated",
-  name: "New Column Value Updated (Instant)",
-  description: "Emit new event when a column value is updated on a board in Monday. For changes to Name, use the Name Updated Trigger.",
+  name: "Column Value Updated (Instant)",
+  description: "Emit new event when a column value is updated on a board. [See the documentation](https://developer.monday.com/api-reference/reference/webhooks#sample-payload-for-webhook-events)",
   type: "source",
-  version: "0.0.7",
+  version: "0.0.8",
   dedupe: "unique",
   hooks: {
     ...common.hooks,
     async deploy() {
       await this.commonDeploy();
     },
   },
+  props: {
+    ...common.props,
+    alertBox: {
+      type: "alert",
+      alertType: "warning",
+      content: "For changes to `Name`, use the **Name Updated** trigger.",
+    },
+  },
   methods: {
     ...common.methods,
     getWebhookArgs() {

components/monday/sources/name-updated/name-updated.mjs

@@ -3,10 +3,10 @@
 export default {
   ...common,
   key: "monday-name-updated",
-  name: "New Name Updated (Instant)",
-  description: "Emit new event when an item's Name is updated on a board in Monday.",
+  name: "Name Updated (Instant)",
+  description: "Emit new event when an item's name is updated. [See the documentation](https://developer.monday.com/api-reference/reference/webhooks#sample-payload-for-webhook-events)",
   type: "source",
-  version: "0.0.7",
+  version: "0.0.8",
   dedupe: "unique",
   hooks: {
     ...common.hooks,

components/monday/sources/new-board/new-board.mjs

@@ -3,18 +3,18 @@ import common from "../common/common-polling.mjs";
 export default {
   ...common,
   key: "monday-new-board",
-  name: "New Board",
-  description: "Emit new event when a new board is created in Monday.",
+  name: "New Board Created",
+  description: "Emit new event when a board is created in Monday. [See the documentation](https://developer.monday.com/api-reference/reference/webhooks#sample-payload-for-webhook-events)",
   type: "source",
-  version: "0.0.8",
+  version: "0.0.9",
   dedupe: "unique",
   props: {
     ...common.props,
     maxRequests: {
       type: "integer",
       min: 1,
       label: "Max API Requests per Execution",
-      description: "The maximum number of API requests to make per execution (e.g., multiple requests are required to retrieve paginated results)",
+      description: "The maximum number of API requests to make per execution (multiple requests are required to retrieve paginated results)",
       optional: true,
       default: 1,
     },