@pipedream/microsoft_outlook_calendar 0.4.0 → 0.5.0

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

@@ -0,0 +1,59 @@
+import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
+import { ConfigurationError } from "@pipedream/platform";
+
+export default {
+  type: "action",
+  key: "microsoft_outlook_calendar-delete-recurring-event-instance",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: true,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  name: "Delete Recurring Event Instance",
+  description: "Delete an individual instance of a recurring event in the user's default calendar. [See the documentation](https://learn.microsoft.com/en-us/graph/api/event-delete?view=graph-rest-1.0&tabs=http)",
+  props: {
+    microsoftOutlook,
+    recurringEventId: {
+      propDefinition: [
+        microsoftOutlook,
+        "recurringEventId",
+      ],
+    },
+    startDateTime: {
+      type: "string",
+      label: "Start Date Time",
+      description: "The start of the time range to find instances, in ISO 8601 format (e.g., `2024-01-01T00:00:00Z`)",
+    },
+    endDateTime: {
+      type: "string",
+      label: "End Date Time",
+      description: "The end of the time range to find instances, in ISO 8601 format (e.g., `2024-12-31T23:59:59Z`)",
+    },
+    instanceId: {
+      propDefinition: [
+        microsoftOutlook,
+        "instanceId",
+        (c) => ({
+          recurringEventId: c.recurringEventId,
+          startDateTime: c.startDateTime,
+          endDateTime: c.endDateTime,
+        }),
+      ],
+    },
+  },
+  async run({ $ }) {
+    if (new Date(this.startDateTime) >= new Date(this.endDateTime)) {
+      throw new ConfigurationError("`Start Date Time` must be before `End Date Time`");
+    }
+
+    const response = await this.microsoftOutlook.deleteCalendarEvent({
+      $,
+      eventId: this.instanceId,
+    });
+
+    $.export("$summary", `Successfully deleted recurring event instance with ID ${this.instanceId}`);
+
+    return response;
+  },
+};

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

@@ -0,0 +1,186 @@
+import microsoftOutlook from "../../microsoft_outlook_calendar.app.mjs";
+import { ConfigurationError } from "@pipedream/platform";
+
+export default {
+  type: "action",
+  key: "microsoft_outlook_calendar-update-recurring-event-instance",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  name: "Update Recurring Event Instance",
+  description: "Update an individual instance of a recurring event in the user's default calendar. [See the documentation](https://learn.microsoft.com/en-us/graph/api/event-update?view=graph-rest-1.0&tabs=http)",
+  props: {
+    microsoftOutlook,
+    recurringEventId: {
+      propDefinition: [
+        microsoftOutlook,
+        "recurringEventId",
+      ],
+    },
+    startDateTime: {
+      type: "string",
+      label: "Start Date Time",
+      description: "The start of the time range to find instances, in ISO 8601 format (e.g., `2024-01-01T00:00:00Z`)",
+    },
+    endDateTime: {
+      type: "string",
+      label: "End Date Time",
+      description: "The end of the time range to find instances, in ISO 8601 format (e.g., `2024-12-31T23:59:59Z`)",
+    },
+    instanceId: {
+      propDefinition: [
+        microsoftOutlook,
+        "instanceId",
+        (c) => ({
+          recurringEventId: c.recurringEventId,
+          startDateTime: c.startDateTime,
+          endDateTime: c.endDateTime,
+        }),
+      ],
+    },
+    subject: {
+      label: "Subject",
+      description: "Subject of the event instance",
+      type: "string",
+      optional: true,
+    },
+    contentType: {
+      propDefinition: [
+        microsoftOutlook,
+        "contentType",
+      ],
+      optional: true,
+    },
+    content: {
+      propDefinition: [
+        microsoftOutlook,
+        "content",
+      ],
+      description: "Content",
+      optional: true,
+    },
+    timeZone: {
+      propDefinition: [
+        microsoftOutlook,
+        "timeZone",
+      ],
+      optional: true,
+    },
+    start: {
+      propDefinition: [
+        microsoftOutlook,
+        "start",
+      ],
+      description: "New start date-time for this instance (yyyy-MM-ddThh:mm:ss). Requires **Time Zone** to be set.",
+      optional: true,
+    },
+    end: {
+      propDefinition: [
+        microsoftOutlook,
+        "end",
+      ],
+      description: "New end date-time for this instance (yyyy-MM-ddThh:mm:ss). Requires **Time Zone** to be set.",
+      optional: true,
+    },
+    attendees: {
+      propDefinition: [
+        microsoftOutlook,
+        "attendees",
+      ],
+      optional: true,
+    },
+    location: {
+      propDefinition: [
+        microsoftOutlook,
+        "location",
+      ],
+      optional: true,
+    },
+    isOnlineMeeting: {
+      propDefinition: [
+        microsoftOutlook,
+        "isOnlineMeeting",
+      ],
+      optional: true,
+    },
+    expand: {
+      propDefinition: [
+        microsoftOutlook,
+        "expand",
+      ],
+      description: "Additional event details. [See object definition](https://docs.microsoft.com/en-us/graph/api/resources/event)",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    if (new Date(this.startDateTime) >= new Date(this.endDateTime)) {
+      throw new ConfigurationError("`Start Date Time` must be before `End Date Time`");
+    }
+
+    const data = {
+      ...this.expand,
+    };
+
+    if (this.subject) {
+      data.subject = this.subject;
+    }
+
+    if (this.isOnlineMeeting !== undefined) {
+      data.isOnlineMeeting = this.isOnlineMeeting;
+    }
+
+    if (this.location) {
+      data.location = {
+        displayName: this.location,
+      };
+    }
+
+    if (this.content) {
+      data.body = {
+        contentType: this.contentType ?? "text",
+        content: this.content,
+      };
+    }
+
+    if ((this.start || this.end) && !this.timeZone) {
+      throw new ConfigurationError("Time Zone is required when updating start or end times");
+    }
+    if (this.start && this.timeZone) {
+      data.start = {
+        dateTime: this.start,
+        timeZone: this.timeZone,
+      };
+    }
+    if (this.end && this.timeZone) {
+      data.end = {
+        dateTime: this.end,
+        timeZone: this.timeZone,
+      };
+    }
+
+    if (this.attendees) {
+      data.attendees = this.attendees.map((at) => ({
+        emailAddress: {
+          address: at,
+        },
+      }));
+    }
+
+    if (!Object.keys(data).length) {
+      throw new ConfigurationError("At least one field must be provided to update the event instance");
+    }
+
+    const response = await this.microsoftOutlook.updateCalendarEvent({
+      $,
+      eventId: this.instanceId,
+      data,
+    });
+
+    $.export("$summary", `Successfully updated recurring event instance with ID ${response?.id ?? this.instanceId}`);
+
+    return response;
+  },
+};

package/microsoft_outlook_calendar.app.mjs

@@ -17,6 +17,45 @@ export default {
         }));
       },
     },
+    recurringEventId: {
+      label: "Recurring Event ID",
+      description: "The ID of the recurring event series",
+      type: "string",
+      async options() {
+        const { value: events } = await this.listCalendarEvents();
+
+        return events
+          .filter((event) => event.recurrence)
+          .map((event) => ({
+            label: event.subject,
+            value: event.id,
+          }));
+      },
+    },
+    instanceId: {
+      label: "Instance ID",
+      description: "The ID of the specific occurrence of the recurring event",
+      type: "string",
+      async options({
+        recurringEventId, startDateTime, endDateTime,
+      }) {
+        if (!recurringEventId || !startDateTime || !endDateTime) {
+          return [];
+        }
+        const { value: instances } = await this.listEventInstances({
+          eventId: recurringEventId,
+          params: {
+            startDateTime,
+            endDateTime,
+          },
+        });
+
+        return instances.map((instance) => ({
+          label: `${instance.subject} - ${instance.start?.dateTime}`,
+          value: instance.id,
+        }));
+      },
+    },
     contentType: {
       label: "Content Type",
       description: "Content type (default `text`)",
@@ -188,5 +227,14 @@ export default {
         ...args,
       });
     },
+    async listEventInstances({
+      eventId, ...args
+    }) {
+      return this._makeRequest({
+        method: "GET",
+        path: `/me/events/${eventId}/instances`,
+        ...args,
+      });
+    },
   },
 };

package/package.json

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