@pipedream/microsoft_outlook_calendar 8.0.1 → 8.2.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

@@ -4,7 +4,7 @@ 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.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-event/get-event.mjs

@@ -0,0 +1,54 @@
+import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
+
+export default {
+  type: "action",
+  key: "microsoft_outlook_calendar-get-event",
+  name: "Get Event",
+  description: "Retrieve a calendar event by its Microsoft Graph event ID. Pass the `id` from **List Events** when you need full details (for example `body`, `attendees`, or `recurrence`) that list responses may omit or truncate. [See the documentation](https://learn.microsoft.com/en-us/graph/api/event-get?view=graph-rest-1.0&tabs=http)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    microsoftOutlook,
+    eventId: {
+      propDefinition: [
+        microsoftOutlook,
+        "eventId",
+      ],
+      description: "The Microsoft Graph event ID — the `id` field on each object returned by **List Events** (including occurrences from calendar view when **Include Recurring** is enabled).",
+    },
+    select: {
+      type: "string",
+      label: "Properties to return ($select)",
+      description: "Optional. Comma-separated Microsoft Graph [event](https://learn.microsoft.com/en-us/graph/api/resources/event) property names (for example `subject,body,bodyPreview,start,end,attendees,organizer,location`). When empty, the API returns its default property set.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const normalizedSelect = this.select?.trim()
+      ? this.select.split(",")
+        .map((p) => p.trim())
+        .filter(Boolean)
+        .join(",")
+      : "";
+
+    const params = normalizedSelect
+      ? {
+        $select: normalizedSelect,
+      }
+      : {};
+
+    const event = await this.microsoftOutlook.getCalendarEvent({
+      $,
+      eventId: this.eventId,
+      params,
+    });
+
+    const label = event?.subject ?? this.eventId;
+    $.export("$summary", `Successfully retrieved event "${label}"`);
+    return event;
+  },
+};

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.1",
+  "version": "8.2.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,