@pipedream/microsoft_outlook_calendar 8.0.0 → 8.1.0

package/actions/create-calendar-event/create-calendar-event.mjs

@@ -9,7 +9,7 @@ import {
 export default {
   type: "action",
   key: "microsoft_outlook_calendar-create-calendar-event",
-  version: "0.0.13",
+  version: "0.0.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/delete-calendar-event/delete-calendar-event.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook_calendar-delete-calendar-event",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/delete-recurring-event-instance/delete-recurring-event-instance.mjs

@@ -4,7 +4,7 @@ import { ConfigurationError } from "@pipedream/platform";
 export default {
   type: "action",
   key: "microsoft_outlook_calendar-delete-recurring-event-instance",
-  version: "0.0.5",
+  version: "0.0.6",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/find-meeting-times/find-meeting-times.mjs

@@ -0,0 +1,256 @@
+import { ConfigurationError } from "@pipedream/platform";
+import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
+import utils from "../../common/utils.mjs";
+
+export default {
+  key: "microsoft_outlook_calendar-find-meeting-times",
+  name: "Find Meeting Times",
+  description: "Suggest meeting times and locations based on organizer and attendee availability. [See the documentation](https://learn.microsoft.com/en-us/graph/api/user-findmeetingtimes?view=graph-rest-1.0)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    microsoftOutlook,
+    userId: {
+      type: "string",
+      label: "User ID or UPN",
+      description: "Optional. If set, runs the request for a specific user (`/users/{id|userPrincipalName}/findMeetingTimes`). If unset, uses the signed-in user (`/me/findMeetingTimes`).",
+      optional: true,
+    },
+    attendees: {
+      type: "string[]",
+      label: "Attendees",
+      description: "Optional. A list of attendee email addresses.",
+      optional: true,
+    },
+    resourceAttendees: {
+      type: "string[]",
+      label: "Resource Attendees",
+      description: "Optional. A list of resource email addresses (for example, rooms/equipment).",
+      optional: true,
+    },
+    start: {
+      propDefinition: [
+        microsoftOutlook,
+        "start",
+      ],
+    },
+    end: {
+      propDefinition: [
+        microsoftOutlook,
+        "end",
+      ],
+    },
+    timeZone: {
+      propDefinition: [
+        microsoftOutlook,
+        "timeZone",
+      ],
+    },
+    activityDomain: {
+      type: "string",
+      label: "Activity Domain",
+      description: "Optional. Restrict suggestions to work hours, personal hours, or unrestricted.",
+      options: [
+        "work",
+        "personal",
+        "unrestricted",
+      ],
+      default: "work",
+      optional: true,
+    },
+    duration: {
+      type: "integer",
+      label: "Duration (Minutes)",
+      description: "Optional. Meeting duration in minutes. Defaults to 30.",
+      optional: true,
+      default: 30,
+      min: 1,
+    },
+    maxResults: {
+      type: "integer",
+      label: "Max Results",
+      description: "Optional. Maximum number of meeting time suggestions to return (default: 20, max: 50).",
+      optional: true,
+      min: 1,
+      max: 50,
+      default: 20,
+    },
+    minimumAttendeePercentage: {
+      type: "integer",
+      label: "Minimum Attendee Percentage",
+      description: "Optional. Minimum confidence (0-100) for a suggestion to be returned.",
+      optional: true,
+      min: 0,
+      max: 100,
+    },
+    isOrganizerOptional: {
+      type: "boolean",
+      label: "Is Organizer Optional",
+      description: "Optional. Set to true if the organizer doesn't necessarily have to attend.",
+      optional: true,
+    },
+    returnSuggestionReasons: {
+      type: "boolean",
+      label: "Return Suggestion Reasons",
+      description: "Optional. Set to true to include a reason for each suggestion in the response.",
+      optional: true,
+      default: true,
+    },
+    suggestLocation: {
+      type: "boolean",
+      label: "Suggest Location",
+      description: "Optional. Set to true to ask Microsoft Graph to suggest meeting locations.",
+      optional: true,
+    },
+    locations: {
+      type: "string[]",
+      label: "Locations",
+      description: "Optional. A list of location display names to constrain suggestions (for example, conference room names).",
+      optional: true,
+    },
+    isLocationRequired: {
+      type: "boolean",
+      label: "Location Required",
+      description: "Optional. Set to true if a location is required for the suggestion.",
+      optional: true,
+    },
+  },
+  methods: {
+    _toAttendeeBase(address, type) {
+      return {
+        type,
+        emailAddress: {
+          address,
+        },
+      };
+    },
+  },
+  async run({ $ }) {
+    const userId = this.userId?.trim();
+
+    const cleanedAttendees = utils.normalizeStringArray(this.attendees);
+    const cleanedResourceAttendees = utils.normalizeStringArray(this.resourceAttendees);
+    const cleanedLocations = utils.normalizeStringArray(this.locations);
+    const startMs = Date.parse(this.start);
+    const endMs = Date.parse(this.end);
+    if (!Number.isFinite(startMs) || !Number.isFinite(endMs) || startMs >= endMs) {
+      throw new Error("`start` must be before `end` and both must be valid date-time strings.");
+    }
+
+    const attendees = [
+      ...cleanedAttendees.map((address) => this._toAttendeeBase(address, "required")),
+      ...cleanedResourceAttendees.map((address) => this._toAttendeeBase(address, "resource")),
+    ];
+    if (!attendees.length) {
+      throw new ConfigurationError("Provide at least one attendee or resource attendee email address.");
+    }
+
+    const durationMinutes = utils.clampInt(this.duration, {
+      min: 1,
+      max: 24 * 60,
+    }) ?? 30;
+    const meetingDuration = `PT${durationMinutes}M`;
+
+    const maxCandidates = utils.clampInt(this.maxResults, {
+      min: 1,
+      max: 50,
+    }) ?? 20;
+
+    const body = {
+      ...(attendees.length
+        ? {
+          attendees,
+        }
+        : {}),
+      ...(this.isOrganizerOptional !== undefined
+        ? {
+          isOrganizerOptional: this.isOrganizerOptional,
+        }
+        : {}),
+      maxCandidates,
+      meetingDuration,
+      ...(this.minimumAttendeePercentage !== undefined
+        ? {
+          minimumAttendeePercentage: this.minimumAttendeePercentage,
+        }
+        : {}),
+      returnSuggestionReasons: this.returnSuggestionReasons ?? true,
+      timeConstraint: {
+        activityDomain: this.activityDomain,
+        timeSlots: [
+          {
+            start: {
+              dateTime: this.start,
+              timeZone: this.timeZone,
+            },
+            end: {
+              dateTime: this.end,
+              timeZone: this.timeZone,
+            },
+          },
+        ],
+      },
+      ...(this.suggestLocation !== undefined
+        || cleanedLocations.length
+        || this.isLocationRequired !== undefined
+        ? {
+          locationConstraint: {
+            ...(this.isLocationRequired !== undefined
+              ? {
+                isRequired: this.isLocationRequired,
+              }
+              : {}),
+            ...(this.suggestLocation !== undefined
+              ? {
+                suggestLocation: this.suggestLocation,
+              }
+              : {}),
+            ...(cleanedLocations.length
+              ? {
+                locations: cleanedLocations.map((displayName) => ({
+                  resolveAvailability: false,
+                  displayName,
+                })),
+              }
+              : {}),
+          },
+        }
+        : {}),
+    };
+
+    const graphResponse = await this.microsoftOutlook.findMeetingTimes({
+      $,
+      userId,
+      timeZone: this.timeZone,
+      data: body,
+    });
+
+    const suggestionCount = graphResponse?.meetingTimeSuggestions?.length ?? 0;
+    $.export("$summary", suggestionCount
+      ? `Successfully found ${suggestionCount} meeting time suggestion${suggestionCount === 1
+        ? ""
+        : "s"}`
+      : `No meeting time suggestions found${graphResponse?.emptySuggestionsReason
+        ? ` (${graphResponse.emptySuggestionsReason})`
+        : ""}`);
+
+    const meetingTimesData = (graphResponse?.meetingTimeSuggestions ?? []).map((time) => ({
+      confidence: time.confidence,
+      organizerAvailability: time.organizerAvailability,
+      attendeeAvailability: time.attendeeAvailability,
+      meetingTimeSlot: time.meetingTimeSlot,
+      suggestionReason: time.suggestionReason,
+      locations: time.locations,
+    }));
+
+    return {
+      data: meetingTimesData,
+    };
+  },
+};
+

package/actions/get-current-user/get-current-user.mjs

@@ -0,0 +1,33 @@
+import microsoftOutlookCalendar from "../../microsoft_outlook_calendar.app.mjs";
+
+export default {
+  key: "microsoft_outlook_calendar-get-current-user",
+  name: "Get Current User",
+  description: "Returns the authenticated Microsoft user's ID, display name, email, and principal name via Microsoft Graph. Call this first when the user says 'my calendar', 'my events', or needs to identify themselves as organizer/attendee. Use `id` or `mail` to filter results from **List Events** or set the organizer in **Create Calendar Event**. [See the documentation](https://learn.microsoft.com/en-us/graph/api/user-get).",
+  version: "0.0.2",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    microsoftOutlookCalendar,
+  },
+  async run({ $ }) {
+    const user = await this.microsoftOutlookCalendar.client()
+      .api("/me")
+      .select("id,displayName,mail,userPrincipalName")
+      .get();
+
+    const summaryName = user.displayName || user.mail || user.id;
+    $.export("$summary", `Retrieved user ${summaryName}`);
+
+    return {
+      id: user.id,
+      displayName: user.displayName,
+      mail: user.mail,
+      userPrincipalName: user.userPrincipalName,
+    };
+  },
+};

package/actions/get-schedule/get-schedule.mjs

@@ -8,7 +8,7 @@ export default {
   key: "microsoft_outlook_calendar-get-schedule",
   name: "Get Free/Busy Schedule",
   description: "Get the free/busy availability information for a collection of users, distributions lists, or resources (rooms or equipment) for a specified time period. [See the documentation](https://learn.microsoft.com/en-us/graph/api/calendar-getschedule)",
-  version: "0.0.10",
+  version: "0.0.11",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-events/list-events.mjs

@@ -5,7 +5,7 @@ export default {
   key: "microsoft_outlook_calendar-list-events",
   name: "List Events",
   description: "Get a list of event objects in the user's mailbox. [See the documentation](https://learn.microsoft.com/en-us/graph/api/user-list-events)",
-  version: "0.0.11",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/search-contacts/search-contacts.mjs

@@ -4,7 +4,7 @@ export default {
   key: "microsoft_outlook_calendar-search-contacts",
   name: "Search Contacts",
   description: "Search for contacts by name from your saved contacts list and retrieve their email addresses. [See the documentation](https://learn.microsoft.com/en-us/graph/api/user-list-contacts)",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/search-people/search-people.mjs

@@ -4,7 +4,7 @@ export default {
   key: "microsoft_outlook_calendar-search-people",
   name: "Search People",
   description: "Retrieve a collection of person objects ordered by their relevance to the user, based on communication and collaboration patterns and business relationships. [See the documentation](https://learn.microsoft.com/en-us/graph/api/user-list-people)",
-  version: "0.0.4",
+  version: "0.0.5",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/update-calendar-event/update-calendar-event.mjs

@@ -3,7 +3,7 @@ import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
 export default {
   type: "action",
   key: "microsoft_outlook_calendar-update-calendar-event",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/update-recurring-event-instance/update-recurring-event-instance.mjs

@@ -4,7 +4,7 @@ import { ConfigurationError } from "@pipedream/platform";
 export default {
   type: "action",
   key: "microsoft_outlook_calendar-update-recurring-event-instance",
-  version: "0.0.5",
+  version: "0.0.6",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/common/utils.mjs

@@ -35,4 +35,19 @@ export default {
       String(input),
     ];
   },
+  normalizeStringArray(values) {
+    return (values ?? [])
+      .map((v) => v?.toString?.().trim())
+      .filter(Boolean);
+  },
+  clampInt(value, {
+    min,
+    max,
+  }) {
+    if (value === null || value === undefined) return undefined;
+    const n = Number(value);
+    if (!Number.isFinite(n)) return undefined;
+    const rounded = Math.round(n);
+    return Math.max(min, Math.min(max, rounded));
+  },
 };

package/microsoft_outlook_calendar.app.mjs

@@ -281,5 +281,19 @@ export default {
         .header("Prefer", `outlook.timezone="${timeZone}"`)
         .post(data);
     },
+    async findMeetingTimes({
+      userId,
+      timeZone,
+      data = {},
+    } = {}) {
+      const basePath = userId
+        ? `/users/${encodeURIComponent(userId)}`
+        : "/me";
+      let request = this.client().api(`${basePath}/findMeetingTimes`);
+      if (timeZone) {
+        request = request.header("Prefer", `outlook.timezone="${timeZone}"`);
+      }
+      return await request.post(data);
+    },
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/microsoft_outlook_calendar",
-  "version": "8.0.0",
+  "version": "8.1.0",
   "description": "Pipedream Microsoft Outlook Calendar Components",
   "main": "microsoft_outlook_calendar.app.mjs",
   "keywords": [

package/sources/new-calendar-event/new-calendar-event.mjs

@@ -5,7 +5,7 @@ export default {
   key: "microsoft_outlook_calendar-new-calendar-event",
   name: "New Calendar Event (Instant)",
   description: "Emit new event when a new Calendar event is created",
-  version: "0.0.13",
+  version: "0.0.14",
   type: "source",
   hooks: {
     ...common.hooks,

package/sources/new-upcoming-event/new-upcoming-event.mjs

@@ -6,7 +6,7 @@ export default {
   key: "microsoft_outlook_calendar-new-upcoming-event",
   name: "New Upcoming Calendar Event",
   description: "Emit new event when a Calendar event is upcoming, this source is using `reminderMinutesBeforeStart` property of the event to determine the time it should emit.",
-  version: "0.0.9",
+  version: "0.0.10",
   type: "source",
   props: {
     ...common.props,

package/sources/new-upcoming-event-polling/new-upcoming-event-polling.mjs

@@ -5,7 +5,7 @@ export default {
   key: "microsoft_outlook_calendar-new-upcoming-event-polling",
   name: "New Upcoming Calendar Event (Polling)",
   description: "Emit new event based on a time interval before an upcoming calendar event. [See the documentation](https://docs.microsoft.com/en-us/graph/api/user-list-events)",
-  version: "0.0.5",
+  version: "0.0.6",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/updated-calendar-event/updated-calendar-event.mjs

@@ -5,7 +5,7 @@ export default {
   key: "microsoft_outlook_calendar-updated-calendar-event",
   name: "New Calendar Event Update (Instant)",
   description: "Emit new event when a Calendar event is updated",
-  version: "0.0.13",
+  version: "0.0.14",
   type: "source",
   hooks: {
     ...common.hooks,