@pipedream/microsoft_outlook 1.0.2 → 1.0.4

package/README.md

@@ -1,9 +1,11 @@
 # Overview
 
-With the Microsoft Outlook API, you can build a wide range of applications and
-services that work with Outlook. Here are some examples:
+The Microsoft Outlook API on Pipedream allows you to automate email-related tasks, manage calendars, and handle contacts effortlessly. With the API, you can trigger workflows on new emails, send emails programmatically, and synchronize calendars across platforms, among other functions. Pipedream's serverless platform facilitates the connection between Outlook and a myriad of other apps for efficient automation workflows.
 
-- A service that helps you keep track of your to-do list and get things done
-- A service that helps you monitor your email and respond to messages
-- A service that helps you find and connect with people in your network
-- A service that helps you stay up to date on the latest news and information
+# Example Use Cases
+
+- **Email Event to Slack Notification**: When receiving an email from a specific sender or with certain keywords, you can automatically post a message to a Slack channel. This keeps teams informed of important communications without manual monitoring of inboxes.
+
+- **Calendar Sync with Google Calendar**: Upon the creation of a new event in Outlook Calendar, sync this event to Google Calendar. This is ideal for individuals who use multiple calendar services and want to ensure consistency across platforms without manual duplication of events.
+
+- **Automated Email Responses**: Set up a workflow that sends an automated response to emails that meet specific criteria, such as out-of-office replies or acknowledging receipt of customer inquiries. This helps maintain communication with contacts even when you're not actively managing your inbox.

package/actions/create-contact/create-contact.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook-create-contact",
-  version: "0.0.6",
+  version: "0.0.7",
   name: "Create Contact",
   description: "Add a contact to the root Contacts folder, [See the docs](https://docs.microsoft.com/en-us/graph/api/user-post-contacts)",
   props: {

package/actions/create-draft-email/create-draft-email.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook-create-draft-email",
-  version: "0.0.6",
+  version: "0.0.7",
   name: "Create Draft Email",
   description: "Create a draft email, [See the docs](https://docs.microsoft.com/en-us/graph/api/user-post-messages)",
   props: {

package/actions/find-contacts/find-contacts.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook-find-contacts",
-  version: "0.0.6",
+  version: "0.0.7",
   name: "Find Contacts",
   description: "Finds contacts with given search string",
   props: {

package/actions/list-contacts/list-contacts.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook-list-contacts",
-  version: "0.0.6",
+  version: "0.0.7",
   name: "List Contacts",
   description: "Get a contact collection from the default contacts folder, [See the docs](https://docs.microsoft.com/en-us/graph/api/user-list-contacts)",
   props: {

package/actions/send-email/send-email.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook-send-email",
-  version: "0.0.7",
+  version: "0.0.8",
   name: "Send Email",
   description: "Send an email to one or multiple recipients, [See the docs](https://docs.microsoft.com/en-us/graph/api/user-sendmail)",
   props: {

package/actions/update-contact/update-contact.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook-update-contact",
-  version: "0.0.6",
+  version: "0.0.7",
   name: "Update Contact",
   description: "Add a contact to the root Contacts folder, [See the docs](https://docs.microsoft.com/en-us/graph/api/user-post-contacts)",
   props: {

package/microsoft_outlook.app.mjs

@@ -12,23 +12,28 @@ export default {
       label: "Recipients",
       description: "Array of email addresses",
       type: "string[]",
+      optional: true,
+      default: [],
     },
     ccRecipients: {
       label: "CC Recipients",
       description: "Array of email addresses",
       type: "string[]",
       optional: true,
+      default: [],
     },
     bccRecipients: {
       label: "BCC Recipients",
       description: "Array of email addresses",
       type: "string[]",
       optional: true,
+      default: [],
     },
     subject: {
       label: "Subject",
       description: "Subject of the email",
       type: "string",
+      optional: true,
     },
     contentType: {
       label: "Content Type",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/microsoft_outlook",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Pipedream Microsoft Outlook Components",
   "main": "microsoft_outlook.app.mjs",
   "keywords": [
@@ -14,6 +14,7 @@
   "dependencies": {
     "axios": "^0.21.1",
     "js-base64": "^3.7.2",
+    "md5": "^2.3.0",
     "mime-types": "^2.1.35"
   },
   "publishConfig": {

package/sources/new-contact/new-contact.mjs

@@ -5,7 +5,7 @@ export default {
   key: "microsoft_outlook-new-contact",
   name: "New Contact Event (Instant)",
   description: "Emit new event when a new Contact is created",
-  version: "0.0.7",
+  version: "0.0.8",
   type: "source",
   hooks: {
     ...common.hooks,

package/sources/new-email/new-email.mjs

@@ -1,19 +1,53 @@
 import common from "../common.mjs";
+import md5 from "md5";
 import sampleEmit from "./test-event.mjs";
 
 export default {
   ...common,
   key: "microsoft_outlook-new-email",
   name: "New Email Event (Instant)",
-  description: "Emit new event when an email received",
-  version: "0.0.8",
+  description: "Emit new event when an email is received in specified folders.",
+  version: "0.0.10",
   type: "source",
+  dedupe: "unique",
+  props: {
+    ...common.props,
+    folderIds: {
+      type: "string[]",
+      label: "Folder IDs to Monitor",
+      description: "Specify the folder IDs or names in Outlook that you want to monitor for new emails. Leave empty to monitor all folders (excluding \"Sent Items\" and \"Drafts\").",
+      optional: true,
+      async options() {
+        const { value: folders } = await this.listFolders();
+        return folders?.map(({
+          id: value, displayName: label,
+        }) => ({
+          value,
+          label,
+        })) || [];
+      },
+    },
+  },
   hooks: {
     ...common.hooks,
+    async deploy() {
+      this.db.set("sentItemFolderId", await this.getFolderIdByName("Sent Items"));
+      this.db.set("draftsFolderId", await this.getFolderIdByName("Drafts"));
+
+      const events = await this.getSampleEvents({
+        pageSize: 25,
+      });
+      if (!events || events.length == 0) {
+        return;
+      }
+      for (const item of events) {
+        this.emitEvent(item);
+      }
+    },
     async activate() {
       await this.activate({
         changeType: "created",
-        resource: "/me/mailfolders('inbox')/messages",
+        resource: "/me/messages",
       });
     },
     async deactivate() {
@@ -22,37 +56,86 @@ export default {
   },
   methods: {
     ...common.methods,
-    async getSampleEvents({ pageSize }) {
-      return this.microsoftOutlook.listMessages({
-        params: {
-          $top: pageSize,
-          $orderby: "createdDateTime desc",
-        },
+    listFolders() {
+      return this.microsoftOutlook._makeRequest({
+        path: "/me/mailFolders",
       });
     },
+    async getFolderIdByName(name) {
+      const { value: folders } = await this.listFolders();
+      const { id } = folders.find(({ displayName }) => displayName === name);
+      return id;
+    },
+    async getSampleEvents({ pageSize }) {
+      const folders = this.folderIds?.length
+        ? this.folderIds.map((id) => `/me/mailFolders/${id}/messages`)
+        : [
+          "/me/messages",
+        ];
+
+      const results = [];
+      for (const folder of folders) {
+        const { value: messages } = await this.microsoftOutlook.listMessages({
+          resource: folder,
+          params: {
+            $top: pageSize,
+            $orderby: "createdDateTime desc",
+          },
+        });
+        results.push(...messages);
+      }
+      return results;
+    },
+    isRelevant(item) {
+      if (this.folderIds?.length) {
+        return this.folderIds.includes(item.parentFolderId);
+      }
+      // if no folderIds are specified, filter out items in Sent Items & Drafts
+      const sentItemFolderId = this.db.get("sentItemFolderId");
+      const draftsFolderId = this.db.get("draftsFolderId");
+      return item.parentFolderId !== sentItemFolderId && item.parentFolderId !== draftsFolderId;
+    },
     emitEvent(item) {
-      this.$emit({
-        email: item,
-      }, this.generateMeta(item));
+      if (this.isRelevant(item)) {
+        this.$emit(
+          {
+            email: item,
+          },
+          this.generateMeta(item),
+        );
+      }
     },
     generateMeta(item) {
       return {
-        id: item.id,
+        id: md5(item.id), // id > 64 characters, so dedupe on hash of id
         summary: `New email (ID:${item.id})`,
         ts: Date.parse(item.createdDateTime),
       };
     },
   },
   async run(event) {
-    await this.run({
-      event,
-      emitFn: async ({ resourceId } = {}) => {
-        const item = await this.microsoftOutlook.getMessage({
-          messageId: resourceId,
-        });
-        this.emitEvent(item);
-      },
-    });
+    const folders = this.folderIds?.length
+      ? this.folderIds.map((id) => `/me/mailFolders/${id}/messages`)
+      : [
+        "/me/messages",
+      ];
+
+    for (const folder of folders) {
+      await this.run({
+        event,
+        emitFn: async ({ resourceId } = {}) => {
+          try {
+            const item = await this.microsoftOutlook.getMessage({
+              resource: folder,
+              messageId: resourceId,
+            });
+            this.emitEvent(item);
+          } catch {
+            console.log(`Could not fetch message with ID: ${resourceId}`);
+          }
+        },
+      });
+    }
   },
   sampleEmit,
 };