@pipedream/monday 0.3.3 → 0.3.4

package/actions/create-group/create-group.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Create Group",
   description: "Creates a new group in a specific board. [See the docs here](https://api.developer.monday.com/docs/groups-queries#create-a-group)",
   type: "action",
-  version: "0.0.1",
+  version: "0.0.2",
   props: {
     monday,
     boardId: {

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

@@ -6,7 +6,7 @@ export default {
   name: "Create Item",
   description: "Creates an item. [See the docs here](https://api.developer.monday.com/docs/items-queries#create-an-item)",
   type: "action",
-  version: "0.0.1",
+  version: "0.0.3",
   props: {
     monday,
     boardId: {
@@ -30,11 +30,17 @@ export default {
         "itemName",
       ],
     },
-    columnValues: {
+    columns: {
       propDefinition: [
         monday,
-        "itemColumnValues",
+        "column",
+        (c) => ({
+          boardId: c.boardId,
+        }),
       ],
+      type: "string[]",
+      description: "Select columns to fill",
+      reloadProps: true,
     },
     createLabels: {
       propDefinition: [
@@ -43,7 +49,37 @@ export default {
       ],
     },
   },
+  async additionalProps() {
+    const props = {};
+    if (!this.columns) {
+      return props;
+    }
+    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)";
+      } else if (column === "person") {
+        description = "The ID of the person/user to add to item";
+      } else if (column === "date4") {
+        description = "Enter date of item in YYYY-MM-DD format. Eg. `2022-09-02`";
+      } else {
+        description = `Value for column ${column}`;
+      }
+      props[column] = {
+        type: "string",
+        label: column,
+        description,
+      };
+    }
+    return props;
+  },
   async run({ $ }) {
+    const columnValues = {};
+    if (this.columns?.length > 0) {
+      for (const column of this.columns) {
+        columnValues[column] = this[column];
+      }
+    }
     const {
       data,
       errors,
@@ -53,7 +89,7 @@ export default {
         boardId: +this.boardId,
         groupId: utils.emptyStrToUndefined(this.groupId),
         itemName: utils.emptyStrToUndefined(this.itemName),
-        columnValues: utils.strinfied(this.columnValues),
+        columnValues: utils.strinfied(columnValues),
         createLabels: utils.emptyStrToUndefined(this.createLabels),
       });
 

package/actions/create-update/create-update.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Create an Update",
   description: "Creates a new update. [See the docs here](https://api.developer.monday.com/docs/updates-queries#create-an-update)",
   type: "action",
-  version: "0.0.1",
+  version: "0.0.3",
   props: {
     monday,
     updateBody: {

package/actions/update-item-name/update-item-name.mjs

@@ -5,7 +5,7 @@ export default {
   name: "Update Item Name",
   description: "Update an item's name. [See the docs here](https://api.developer.monday.com/docs/item-name)",
   type: "action",
-  version: "0.0.1",
+  version: "0.0.3",
   props: {
     monday,
     boardId: {

package/common/mutations.mjs

@@ -80,4 +80,34 @@ export default {
       }
     }
   `,
+  createWebhook: `
+    mutation createWebhook (
+      $boardId: Int!
+      $url: String!
+      $event: WebhookEventType!
+      $config: JSON
+    ) {
+      create_webhook(
+        board_id: $boardId
+        url: $url
+        event: $event
+        config: $config
+      ) {
+        id
+        board_id
+      }
+    }
+  `,
+  deleteWebhook: `
+    mutation deleteWebhook (
+      $id: Int!
+    ) {
+      delete_webhook(
+        id: $id
+      ) {
+        id
+        board_id
+      }
+    }
+  `,
 };

package/common/queries.mjs

@@ -40,7 +40,9 @@ export default {
   listItemsBoard: `
     query listItems ($boardId: Int!) {
       boards (ids: [$boardId]) {
-        items {
+        items (
+          newest_first: true
+        ) {
           id
           name
         }
@@ -62,4 +64,116 @@ export default {
       }
     }
   `,
+  listColumns: `
+    query listColumns ($boardId: Int!) {
+      boards (ids: [$boardId]) {
+        columns {
+          id
+          title
+        }
+      }
+    }
+  `,
+  listUsers: `
+    query {
+      users (
+        newest_first: true
+      ) {
+        id
+        name
+        created_at
+      }
+    }
+  `,
+  getItem: `
+    query getItem ($id: Int!) {
+      items (ids: [$id]) {
+        id
+        name
+        board {
+          id
+        }
+        group {
+          id
+        }
+        created_at
+        creator_id
+        updated_at
+        parent_item {
+          id
+        }
+        column_values {
+          id
+          value
+        }
+        email
+      }
+    }
+  `,
+  getBoard: `
+    query getBoard($id: Int!) {
+      boards (ids: [$id]) {
+        id
+        name
+        board_folder_id
+        columns {
+          id
+        }
+        description
+        groups {
+          id
+        }
+        items {
+          id
+        }
+        owner {
+          id
+        }
+        permissions
+        tags {
+          id
+        }
+        type
+        updated_at
+        workspace_id
+      }
+    }
+  `,
+  getUser: `
+    query getUser($id: Int!) {
+      users (ids: [$id]) {
+        id
+        name
+        account {
+          id
+        }
+        birthday
+        country_code
+        created_at
+        join_date
+        email
+        is_admin
+        is_guest
+        is_pending
+        is_view_only
+        is_verified
+        location
+        mobile_phone
+        phone
+        photo_original
+        photo_small
+        photo_thumb
+        photo_thumb_small
+        photo_tiny
+        teams {
+          id
+        }
+        time_zone_identifier
+        title
+        url
+        utc_hours_diff
+        current_language
+      }
+    }
+  `,
 };

package/monday.app.mjs

@@ -11,7 +11,7 @@ export default {
   app: "monday",
   propDefinitions: {
     boardId: {
-      type: "integer",
+      type: "string",
       label: "Board ID",
       description: "The board's unique identifier",
       async options({ page }) {
@@ -91,7 +91,7 @@ export default {
       description: "The update text",
     },
     itemId: {
-      type: "integer",
+      type: "string",
       label: "Item ID",
       description: "The item's unique identifier",
       optional: true,
@@ -102,7 +102,7 @@ export default {
       },
     },
     updateId: {
-      type: "integer",
+      type: "string",
       label: "Update ID",
       description: "The update's unique identifier",
       optional: true,
@@ -115,6 +115,22 @@ export default {
         });
       },
     },
+    column: {
+      type: "string",
+      label: "Column",
+      description: "Column to watch for changes",
+      async options({ boardId }) {
+        const columns = await this.listColumns({
+          boardId: +boardId,
+        });
+        return columns
+          .filter((column) => column.id !== "name")
+          .map((column) => ({
+            label: column.title,
+            value: column.id,
+          }));
+      },
+    },
   },
   methods: {
     async makeRequest({
@@ -124,6 +140,49 @@ export default {
       monday.setToken(this.$auth.api_key);
       return monday.api(query, options);
     },
+    async createWebhook(variables) {
+      return this.makeRequest({
+        query: mutations.createWebhook,
+        options: {
+          variables,
+        },
+      });
+    },
+    async deleteWebhook(variables) {
+      return this.makeRequest({
+        query: mutations.deleteWebhook,
+        options: {
+          variables,
+        },
+      });
+    },
+    async getItem(variables) {
+      const { data } = await this.makeRequest({
+        query: queries.getItem,
+        options: {
+          variables,
+        },
+      });
+      return data?.items[0];
+    },
+    async getBoard(variables) {
+      const { data } = await this.makeRequest({
+        query: queries.getBoard,
+        options: {
+          variables,
+        },
+      });
+      return data?.boards[0];
+    },
+    async getUser(variables) {
+      const { data } = await this.makeRequest({
+        query: queries.getUser,
+        options: {
+          variables,
+        },
+      });
+      return data?.users[0];
+    },
     async createBoard(variables) {
       return this.makeRequest({
         query: mutations.createBoard,
@@ -201,6 +260,24 @@ export default {
         },
       });
     },
+    async listColumns(variables) {
+      const { data } = await this.makeRequest({
+        query: queries.listColumns,
+        options: {
+          variables,
+        },
+      });
+      return data?.boards[0]?.columns;
+    },
+    async listUsers(variables) {
+      const { data } = await this.makeRequest({
+        query: queries.listUsers,
+        options: {
+          variables,
+        },
+      });
+      return data?.users;
+    },
     async listBoardsOptions(variables) {
       const {
         data,

package/package.json

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

package/sources/column-value-updated/column-value-updated.mjs

@@ -0,0 +1,19 @@
+import common from "../common/common-webhook.mjs";
+
+export default {
+  ...common,
+  key: "monday-column-value-updated",
+  name: "Column Value Updated",
+  description: "Emit new event when a column value is updated on a board in Monday. For changes to Name, use the Name Updated Trigger.",
+  type: "source",
+  version: "0.0.1",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    getWebhookArgs() {
+      return {
+        event: "change_column_value",
+      };
+    },
+  },
+};

package/sources/common/common-polling.mjs

@@ -0,0 +1,31 @@
+import monday from "../../monday.app.mjs";
+
+export default {
+  props: {
+    monday,
+    db: "$.service.db",
+    timer: {
+      label: "Polling interval",
+      description: "Pipedream will poll the Monday API on this schedule",
+      type: "$.interface.timer",
+      default: {
+        intervalSeconds: 60 * 15, // every 15 minutes
+      },
+    },
+  },
+  methods: {
+    _getLastId() {
+      return this.db.get("lastId") || 0;
+    },
+    _setLastId(lastId) {
+      this.db.set("lastId", lastId);
+    },
+    emitEvent(item) {
+      const meta = this.generateMeta(item);
+      this.$emit(item, meta);
+    },
+    generateMeta() {
+      throw new Error("generateMeta is not implemented");
+    },
+  },
+};

package/sources/common/common-webhook.mjs

@@ -0,0 +1,93 @@
+import monday from "../../monday.app.mjs";
+
+export default {
+  props: {
+    monday,
+    db: "$.service.db",
+    http: {
+      type: "$.interface.http",
+      customResponse: true,
+    },
+    boardId: {
+      propDefinition: [
+        monday,
+        "boardId",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { items } = (await this.monday.listItemsBoard({
+        boardId: +this.boardId,
+      })).data.boards[0];
+      for (const item of items.slice(-25).reverse()) {
+        const itemData = await this.monday.getItem({
+          id: +item.id,
+        });
+        const meta = this.generateMeta(item);
+        this.$emit(itemData, meta);
+      }
+    },
+    async activate() {
+      const args = this.getWebhookArgs();
+      const { data } = await this.monday.createWebhook({
+        boardId: +this.boardId,
+        url: this.http.endpoint,
+        ...args,
+      });
+      const hookId = data?.create_webhook?.id;
+      if (!hookId) {
+        throw new Error ("Failed to establish webhook");
+      }
+      this._setHookId(data.create_webhook.id);
+    },
+    async deactivate() {
+      const hookId = this._getHookId();
+      await this.monday.deleteWebhook({
+        id: hookId,
+      });
+    },
+  },
+  methods: {
+    _getHookId() {
+      return this.db.get("hookId");
+    },
+    _setHookId(hookId) {
+      this.db.set("hookId", hookId);
+    },
+    getWebhookArgs() {
+      throw new Error("getEventType is not implemented");
+    },
+    generateMeta(item) {
+      return {
+        id: `${item.id}_${item.updated_at}`,
+        summary: item.name,
+        ts: Date.parse(item.updated_at),
+      };
+    },
+  },
+  async run(event) {
+    const { body } = event;
+
+    // verify the webhook
+    if (body?.challenge) {
+      await this.http.respond({
+        status: 200,
+        body,
+      });
+      return;
+    }
+
+    const itemId = body?.event?.pulseId;
+    if (!itemId) {
+      return;
+    }
+
+    const updatedItem = await this.monday.getItem({
+      id: itemId,
+    });
+
+    const meta = this.generateMeta(updatedItem);
+    this.$emit(updatedItem, meta);
+  },
+};

package/sources/name-updated/name-updated.mjs

@@ -0,0 +1,19 @@
+import common from "../common/common-webhook.mjs";
+
+export default {
+  ...common,
+  key: "monday-name-updated",
+  name: "Name Updated",
+  description: "Emit new event when an item's Name is updated on a board in Monday.",
+  type: "source",
+  version: "0.0.1",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    getWebhookArgs() {
+      return {
+        event: "change_name",
+      };
+    },
+  },
+};

package/sources/new-board/new-board.mjs

@@ -0,0 +1,63 @@
+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.",
+  type: "source",
+  version: "0.0.1",
+  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)",
+      optional: true,
+      default: 1,
+    },
+  },
+  methods: {
+    ...common.methods,
+    generateMeta(board) {
+      return {
+        id: board.id,
+        summary: board.name,
+        ts: Date.now(),
+      };
+    },
+  },
+  async run() {
+    const lastId = this._getLastId();
+
+    let maxId = lastId;
+    let done = false;
+    let page = 1;
+    do {
+      const { boards } = (await this.monday.listBoards({
+        page,
+      })).data;
+      for (const board of boards) {
+        if (+board.id <= lastId) {
+          done = true;
+          break;
+        }
+        if (+board.id > maxId) {
+          maxId = +board.id;
+        }
+        const boardData = await this.monday.getBoard({
+          id: +board.id,
+        });
+        this.emitEvent(boardData);
+      }
+      if (boards.length === 0) {
+        done = true;
+      }
+      page++;
+    } while (!done && page <= this.maxRequests);
+
+    this._setLastId(maxId);
+  },
+};

package/sources/new-item/new-item.mjs

@@ -0,0 +1,19 @@
+import common from "../common/common-webhook.mjs";
+
+export default {
+  ...common,
+  key: "monday-new-item",
+  name: "New Item",
+  description: "Emit new event when a new item is added to a board in Monday.",
+  type: "source",
+  version: "0.0.1",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    getWebhookArgs() {
+      return {
+        event: "create_item",
+      };
+    },
+  },
+};

package/sources/new-user/new-user.mjs

@@ -0,0 +1,41 @@
+import common from "../common/common-polling.mjs";
+
+export default {
+  ...common,
+  key: "monday-new-user",
+  name: "New User",
+  description: "Emit new event when a new user is created in Monday.",
+  type: "source",
+  version: "0.0.1",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    generateMeta(user) {
+      return {
+        id: user.id,
+        summary: user.name,
+        ts: Date.parse(user.created_at),
+      };
+    },
+  },
+  async run() {
+    const lastId = this._getLastId();
+    let maxId = lastId;
+
+    const users = await this.monday.listUsers();
+    for (const user of users) {
+      if (+user.id <= lastId) {
+        break;
+      }
+      if (+user.id > maxId) {
+        maxId = +user.id;
+      }
+      const userData = await this.monday.getUser({
+        id: +user.id,
+      });
+      this.emitEvent(userData);
+    }
+
+    this._setLastId(maxId);
+  },
+};

package/sources/specific-column-updated/specific-column-updated.mjs

@@ -0,0 +1,34 @@
+import common from "../common/common-webhook.mjs";
+
+export default {
+  ...common,
+  key: "monday-specific-column-updated",
+  name: "Specific Column Updated",
+  description: "Emit new event when a value in the specified column is updated on a board in Monday. For changes to Name, use the Name Updated Trigger.",
+  type: "source",
+  version: "0.0.1",
+  dedupe: "unique",
+  props: {
+    ...common.props,
+    column: {
+      propDefinition: [
+        common.props.monday,
+        "column",
+        (c) => ({
+          boardId: c.boardId,
+        }),
+      ],
+    },
+  },
+  methods: {
+    ...common.methods,
+    getWebhookArgs() {
+      return {
+        event: "change_specific_column_value",
+        config: JSON.stringify({
+          columnId: this.column,
+        }),
+      };
+    },
+  },
+};