@pipedream/microsoft_outlook_calendar 8.1.0 → 8.2.1

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.14",
+  version: "0.0.15",
   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.9",
+  version: "0.0.10",
   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.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

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

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.2",
+  version: "0.0.3",
   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.2",
+  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.11",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

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

@@ -1,11 +1,13 @@
 import { ConfigurationError } from "@pipedream/platform";
 import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
 
+const PAGE_SIZE = 100;
+
 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.12",
+  version: "0.1.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -17,7 +19,7 @@ export default {
     filter: {
       type: "string",
       label: "Filter",
-      description: "Filters results. For example, `contains(subject, 'meet for lunch?')` will include events whose title contains ‘meet for lunch?’. [See documentation](https://learn.microsoft.com/en-us/graph/filter-query-parameter) for the full list of operations.",
+      description: "Filters results using OData syntax. For example, `contains(subject, 'meet for lunch?')` will include events whose title contains 'meet for lunch?'. [See documentation](https://learn.microsoft.com/en-us/graph/filter-query-parameter) for the full list of operations. Note: filtering on the `recurrence` property is not supported by the API.",
       optional: true,
     },
     orderBy: {
@@ -32,55 +34,117 @@ export default {
       label: "Max Results",
       description: "The maximum number of results to return",
       optional: true,
+      min: 0,
     },
     includeRecurring: {
       type: "boolean",
       label: "Include Recurring",
-      description: "Must set to true to include recurring events in results. When true, you must also provide `Start Date Time` and `End Date Time`. Set to false to return only non-recurring events.",
+      description: "When `true`, uses the calendar view endpoint which expands each occurrence of a recurring event into its own individual result. Requires `Start Date Time` and `End Date Time`. When `false` or unset, the events endpoint is used instead, which returns recurring series as a single master entry — these are excluded from the results. `Start Date Time` and `End Date Time` can still be used to filter by date range.",
       optional: true,
     },
     startDateTime: {
       type: "string",
       label: "Start Date Time",
-      description: "Required when `Include Recurring` is true. The start date and time of the time range in ISO 8601 format (e.g. `2019-11-08T19:00:00-08:00`).",
+      description: "Filter events that start at or after this date and time, in ISO 8601 format (e.g. `2019-11-08T19:00:00-08:00`). Required when `Include Recurring` is `true`. When `Include Recurring` is `false` or unset, this adds a `start/dateTime ge` filter to the events endpoint.",
       optional: true,
     },
     endDateTime: {
       type: "string",
       label: "End Date Time",
-      description: "Required when `Include Recurring` is true. The end date and time of the time range in ISO 8601 format (e.g. `2019-11-08T20:00:00-08:00`).",
+      description: "Filter events that end at or before this date and time, in ISO 8601 format (e.g. `2019-11-08T20:00:00-08:00`). Required when `Include Recurring` is `true`. When `Include Recurring` is `false` or unset, this adds an `end/dateTime le` filter to the events endpoint.",
       optional: true,
     },
   },
   async run({ $ }) {
+    const {
+      includeRecurring, startDateTime, endDateTime, maxResults,
+    } = this;
+
+    if (includeRecurring && (!startDateTime || !endDateTime)) {
+      throw new ConfigurationError("`Start Date Time` and `End Date Time` are required when `Include Recurring` is true");
+    }
+
+    if (maxResults < 0) {
+      throw new ConfigurationError(`\`Max Results\` is set to "${maxResults}" but must be a positive integer`);
+    }
+
+    if (includeRecurring) {
+      const params = {
+        "$orderby": this.orderBy,
+        "$filter": this.filter,
+        "$top": PAGE_SIZE,
+        startDateTime,
+        endDateTime,
+      };
+
+      const events = [];
+      let nextLink = null;
+
+      do {
+        const response = nextLink
+          ? await this.microsoftOutlook.listCalendarEventsPage({
+            $,
+            url: nextLink,
+          })
+          : await this.microsoftOutlook.listCalendarView({
+            $,
+            params,
+          });
+
+        for (const event of (response.value ?? [])) {
+          events.push(event);
+          if (maxResults && events.length >= maxResults) break;
+        }
+
+        nextLink = (maxResults && events.length >= maxResults)
+          ? null
+          : response["@odata.nextLink"];
+      } while (nextLink);
+
+      $.export("$summary", `Successfully retrieved ${events.length} event${events.length === 1
+        ? ""
+        : "s"}`);
+      return events;
+    }
+
+    const filterParts = [];
+    if (this.filter) filterParts.push(`(${this.filter})`);
+    if (startDateTime) filterParts.push(`start/dateTime ge '${startDateTime}'`);
+    if (endDateTime) filterParts.push(`end/dateTime le '${endDateTime}'`);
+
     const params = {
       "$orderby": this.orderBy,
-      "$filter": this.filter,
-      "$top": this.maxResults,
+      "$filter": filterParts.length
+        ? filterParts.join(" and ")
+        : undefined,
+      "$top": PAGE_SIZE,
     };
 
-    const { includeRecurring } = this;
-    if (includeRecurring && (!this.startDateTime || !this.endDateTime)) {
-      throw new ConfigurationError("`Start Date Time` and `End Date Time` are required when `Include Recurring` is true");
-    }
+    const events = [];
+    let nextLink = null;
+
+    do {
+      const response = nextLink
+        ? await this.microsoftOutlook.listCalendarEventsPage({
+          $,
+          url: nextLink,
+        })
+        : await this.microsoftOutlook.listCalendarEvents({
+          $,
+          params,
+        });
+
+      for (const event of (response.value ?? [])) {
+        if (!event.recurrence) {
+          events.push(event);
+          if (maxResults && events.length >= maxResults) break;
+        }
+      }
 
-    const { value = [] } = !includeRecurring
-      ? await this.microsoftOutlook.listCalendarEvents({
-        $,
-        params,
-      })
-      : await this.microsoftOutlook.listCalendarView({
-        $,
-        params: {
-          ...params,
-          startDateTime: this.startDateTime,
-          endDateTime: this.endDateTime,
-        },
-      });
-
-    const events = !includeRecurring
-      ? value.filter((event) => !event.recurrence)
-      : value;
+      nextLink = (maxResults && events.length >= maxResults)
+        ? null
+        : response["@odata.nextLink"];
+    } while (nextLink);
 
     $.export("$summary", `Successfully retrieved ${events.length} event${events.length === 1
       ? ""

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.5",
+  version: "0.0.6",
   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.5",
+  version: "0.0.6",
   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.9",
+  version: "0.0.10",
   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.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/microsoft_outlook_calendar.app.mjs

@@ -245,6 +245,10 @@ export default {
         .query(pickBy(params))
         .get();
     },
+    async listCalendarEventsPage({ url } = {}) {
+      return await this.client().api(url)
+        .get();
+    },
     async getCalendarEvent({
       eventId, params = {},
     } = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/microsoft_outlook_calendar",
-  "version": "8.1.0",
+  "version": "8.2.1",
   "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.14",
+  version: "0.0.15",
   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.10",
+  version: "0.0.11",
   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.6",
+  version: "0.0.7",
   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.14",
+  version: "0.0.15",
   type: "source",
   hooks: {
     ...common.hooks,