@pipedream/google_calendar 0.3.11 → 0.3.13

package/README.md

@@ -18,5 +18,3 @@ include:
   to see their tasks and events in one place.
 - A reminder application that uses Google Calendar data to remind users of
   upcoming events.
-
-Pipedream's use and transfer of information received from Google APIs to any other app will adhere to the [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy#additional_requirements_for_specific_api_scopes), including the Limited Use requirements.

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

@@ -0,0 +1,117 @@
+import googleCalendar from "../../google_calendar.app.mjs";
+
+export default {
+  props: ({ isUpdate }) => (
+    {
+      summary: {
+        label: "Event Title",
+        type: "string",
+        description: "Enter a title for the event, (e.g., `My event`)",
+        optional: true,
+      },
+      location: {
+        label: "Event Location",
+        type: "string",
+        description: "Specify the location of the event",
+        optional: true,
+      },
+      description: {
+        label: "Event Description",
+        type: "string",
+        description: "Enter a description for the event",
+        optional: true,
+      },
+      attendees: {
+        label: "Attendees",
+        type: "string[]",
+        description: "Enter an array of email addresses for any attendees",
+        optional: true,
+      },
+      eventStartDate: {
+        label: "Event Start Date",
+        type: "string",
+        description: "For all-day events, enter the Event day in the format `yyyy-mm-dd`. For events with time, format according to [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-1): `yyyy-mm-ddThh:mm:ss+01:00`. A time zone offset is required unless a time zone is explicitly specified in timeZone.",
+        optional: isUpdate,
+      },
+      eventEndDate: {
+        label: "Event End Date",
+        type: "string",
+        description: "For all-day events, enter the Event day in the format `yyyy-mm-dd`. For events with time, format according to [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-1): `yyyy-mm-ddThh:mm:ss+01:00`. A time zone offset is required unless a time zone is explicitly specified in timeZone.",
+        optional: isUpdate,
+      },
+      timeZone: {
+        propDefinition: [
+          googleCalendar,
+          "timeZone",
+        ],
+      },
+      sendUpdates: {
+        propDefinition: [
+          googleCalendar,
+          "sendUpdates",
+        ],
+      },
+      sendNotifications: {
+        propDefinition: [
+          googleCalendar,
+          "sendNotifications",
+        ],
+      },
+    }
+  ),
+  methods: {
+    async getTimeZone(selectedTimeZone) {
+      /**
+      * Based on the IINA Time Zone DB
+      * http://www.iana.org/time-zones
+      */
+      const { value: timeZone } = selectedTimeZone ?? await this.googleCalendar.getSettings({
+        setting: "timezone",
+      });
+      return timeZone;
+    },
+    formatAttendees(selectedAttendees, currentAttendees) {
+      /**
+      * Format for the attendees
+      *
+      * [
+      *   { "email": "lpage@example.com",},
+      *   { "email": "sbrin@example.com",},
+      * ]
+      */
+      let attendees = [];
+      if (selectedAttendees && Array.isArray(selectedAttendees)) {
+        attendees = selectedAttendees.map((email) => ({
+          email,
+        }));
+      } else if (currentAttendees && Array.isArray(currentAttendees)) {
+        return currentAttendees.map((attendee) => ({
+          email: attendee.email,
+        }));
+      }
+      return attendees;
+    },
+    checkDateOrDateTimeInput(date, type) {
+      if (type === "date") {
+        return date && date.length <= 10
+          ? date
+          : undefined;
+      }
+      if (type === "dateTime") {
+        return date && date.length > 10
+          ? date
+          : undefined;
+      }
+    },
+    getDateParam({
+      date,
+      timeZone,
+    }) {
+      return {
+        date: this.checkDateOrDateTimeInput(date, "date"),
+        dateTime: this.checkDateOrDateTimeInput(date, "dateTime"),
+        timeZone,
+      };
+    },
+  },
+};

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

@@ -1,10 +1,11 @@
 import googleCalendar from "../../google_calendar.app.mjs";
+import createEventCommon from "../common/create-event-common.mjs";
 
 export default {
   key: "google_calendar-create-event",
   name: "Create Event",
-  description: "Create an event to the Google Calendar. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#insert)",
-  version: "0.1.5",
+  description: "Create an event to the Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#insert)",
+  version: "0.1.6",
   type: "action",
   props: {
     googleCalendar,
@@ -14,114 +15,38 @@ export default {
         "calendarId",
       ],
     },
-    summary: {
-      label: "Event Title",
-      type: "string",
-      description: "Enter a title for the event",
-      optional: true,
-    },
-    location: {
-      label: "Event Location",
-      type: "string",
-      description: "Specify the location of the event",
-      optional: true,
-    },
-    description: {
-      label: "Event Description",
-      type: "string",
-      description: "Enter a description for the event",
-      optional: true,
-    },
-    attendees: {
-      label: "Attendees",
-      type: "string[]",
-      description: "Enter an array of email addresses for any attendees",
-      optional: true,
-    },
-    eventStartDate: {
-      label: "Event Date",
-      type: "string",
-      description: "For all-day events, enter the Event day in the format `yyyy-mm-dd`. For events with time, format according to [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-1): `yyyy-mm-ddThh:mm:ss+01:00`. A time zone offset is required unless a time zone is explicitly specified in timeZone.",
-    },
-    eventEndDate: {
-      label: "Event End Date",
-      type: "string",
-      description: "For all-day events, enter the Event day in the format `yyyy-mm-dd`. For events with time, format according to [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-1): `yyyy-mm-ddThh:mm:ss+01:00`. A time zone offset is required unless a time zone is explicitly specified in timeZone.",
-    },
-    sendUpdates: {
-      label: "Send Updates",
-      type: "string",
-      description: "Configure whether to send notifications about the creation of the new event",
-      optional: true,
-      options: [
-        "all",
-        "externalOnly",
-        "none",
-      ],
-    },
-    timeZone: {
-      propDefinition: [
-        googleCalendar,
-        "timeZone",
-      ],
-    },
+    ...createEventCommon.props({
+      isUpdate: false,
+    }),
+  },
+  methods: {
+    ...createEventCommon.methods,
   },
   async run({ $ }) {
-    /**
-     * Based on the IINA Time Zone DB
-     * http://www.iana.org/time-zones
-     */
-    const { value: timeZone } = this.timeZone ?? await this.googleCalendar.getSettings({
-      setting: "timezone",
-    });
-
-    /**
-     * Format for the attendees
-     *
-     * [
-     *   { "email": "lpage@example.com",},
-     *   { "email": "sbrin@example.com",},
-     * ]
-     */
-
-    let attendees = [];
-
-    if (this.attendees && Array.isArray(this.attendees)) {
-      attendees = this.attendees.map((email) => ({
-        email,
-      }));
-    }
+    const timeZone = this.getTimeZone(this.timeZone);
+    const attendees = this.formatAttendees(this.attendees);
 
     const response = await this.googleCalendar.createEvent({
       calendarId: this.calendarId,
       sendUpdates: this.sendUpdates,
+      sendNotifications: this.sendNotifications,
       resource: {
         summary: this.summary,
         location: this.location,
         description: this.description,
-        start: {
-          date: this.eventStartDate.length <= 10
-            ? this.eventStartDate
-            : undefined,
-          dateTime: this.eventStartDate.length > 10
-            ? this.eventStartDate
-            : undefined,
+        start: this.getDateParam({
+          date: this.eventStartDate,
           timeZone,
-        },
-        end: {
-          date: this.eventEndDate.length <= 10
-            ? this.eventEndDate
-            : undefined,
-          dateTime: this.eventEndDate.length > 10
-            ? this.eventEndDate
-            : undefined,
+        }),
+        end: this.getDateParam({
+          date: this.eventEndDate,
           timeZone,
-        },
+        }),
         attendees,
       },
     });
 
-    $.export("$summary", `Successfully created event ${response.id}`);
+    $.export("$summary", `Successfully created event: "${response.id}"`);
 
     return response;
   },

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

@@ -3,8 +3,8 @@ import googleCalendar from "../../google_calendar.app.mjs";
 export default {
   key: "google_calendar-delete-event",
   name: "Delete an Event",
-  description: "Delete an event to the Google Calendar. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#delete)",
-  version: "0.1.1",
+  description: "Delete an event to the Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#delete)",
+  version: "0.1.2",
   type: "action",
   props: {
     googleCalendar,
@@ -28,9 +28,10 @@ export default {
     const response = await this.googleCalendar.deleteEvent({
       calendarId: this.calendarId,
       eventId: this.eventId,
+      returnOnlyData: false,
     });
 
-    $.export("$summary", `Successfully deleted event ${response}`);
+    $.export("$summary", `Successfully deleted event: "${this.eventId}"`);
 
     return response;
   },

package/actions/get-calendar/get-calendar.mjs

@@ -3,8 +3,8 @@ import googleCalendar from "../../google_calendar.app.mjs";
 export default {
   key: "google_calendar-get-calendar",
   name: "Retrieve Calendar Details",
-  description: "Retrieve Calendar details of a Google Calendar. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Calendars.html#get)",
-  version: "0.1.2",
+  description: "Retrieve calendar details of a Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Calendars.html#get)",
+  version: "0.1.3",
   type: "action",
   props: {
     googleCalendar,
@@ -20,7 +20,7 @@ export default {
       calendarId: this.calendarId,
     });
 
-    $.export("$summary", `Successfully retrieved calendar ${response.id}`);
+    $.export("$summary", `Successfully retrieved calendar: "${response.id}"`);
 
     return response;
   },

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

@@ -3,8 +3,8 @@ import googleCalendar from "../../google_calendar.app.mjs";
 export default {
   key: "google_calendar-get-event",
   name: "Retrieve Event Details",
-  description: "Retrieve event details from the Google Calendar. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#get)",
-  version: "0.1.2",
+  description: "Retrieve event details from Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#get)",
+  version: "0.1.3",
   type: "action",
   props: {
     googleCalendar,
@@ -30,7 +30,7 @@ export default {
       eventId: this.eventId,
     });
 
-    $.export("$summary", `Successfully retrieved event ${response.id}`);
+    $.export("$summary", `Successfully retrieved event: "${response.id}"`);
 
     return response;
   },

package/actions/list-calendars/list-calendars.mjs

@@ -2,9 +2,9 @@ import googleCalendar from "../../google_calendar.app.mjs";
 
 export default {
   key: "google_calendar-list-calendars",
-  name: "List calendars from user account",
-  description: "Retrieve calendars from the user account. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Calendarlist.html#list)",
-  version: "0.1.2",
+  name: "List Calendars",
+  description: "Retrieve a list of calendars from Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Calendarlist.html#list)",
+  version: "0.1.3",
   type: "action",
   props: {
     googleCalendar,
@@ -12,7 +12,7 @@ export default {
   async run({ $ }) {
     const { items: calendars } = await this.googleCalendar.listCalendars();
 
-    $.export("$summary", `Successfully listed ${calendars.length} calendars`);
+    $.export("$summary", `Successfully retrieved ${calendars.length} calendar(s)`);
 
     return calendars;
   },

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

@@ -3,8 +3,8 @@ import googleCalendar from "../../google_calendar.app.mjs";
 export default {
   key: "google_calendar-list-events",
   name: "List Events",
-  description: "Retrieve a list of event from the Google Calendar. [See the docs here](https://developers.google.com/calendar/api/v3/reference/events/list)",
-  version: "0.0.2",
+  description: "Retrieve a list of event from the Google Calendar. [See the documentation](https://developers.google.com/calendar/api/v3/reference/events/list)",
+  version: "0.0.3",
   type: "action",
   props: {
     googleCalendar,

package/actions/query-free-busy-calendars/query-free-busy-calendars.mjs

@@ -3,31 +3,56 @@ import googleCalendar from "../../google_calendar.app.mjs";
 export default {
   key: "google_calendar-query-free-busy-calendars",
   name: "Retrieve Free/Busy Calendar Details",
-  description: "Retrieve Free/Busy Calendar Details from the user account. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Freebusy.html#query)",
-  version: "0.1.2",
+  description: "Retrieve free/busy calendar details from Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Freebusy.html#query)",
+  version: "0.1.3",
   type: "action",
   props: {
     googleCalendar,
+    calendarId: {
+      propDefinition: [
+        googleCalendar,
+        "calendarId",
+      ],
+      optional: false,
+      description: "Select a calendar to retrieve free/busy details",
+    },
     timeMin: {
-      type: "string",
-      label: "Time Min",
-      description: "The start of the interval for the query formatted as per RFC3339. (eg. `2022-02-20T19:27:40Z`)",
+      propDefinition: [
+        googleCalendar,
+        "timeMin",
+      ],
+      optional: false,
     },
     timeMax: {
-      type: "string",
-      label: "Time Max",
-      description: "The end of the interval for the query formatted as per RFC3339. (eg. `2022-04-20T19:27:40Z`)",
+      propDefinition: [
+        googleCalendar,
+        "timeMax",
+      ],
+      optional: false,
+    },
+    timeZone: {
+      propDefinition: [
+        googleCalendar,
+        "timeZone",
+      ],
+      description: "Specify the preferred time zone to be used on the response",
     },
   },
   async run({ $ }) {
-    const response = await this.googleCalendar.queryFreebusy({
+    const response = await this.googleCalendar.queryFreeBusy({
       requestBody: {
         timeMin: this.timeMin,
         timeMax: this.timeMax,
+        timeZone: this.timeZone,
+        items: [
+          {
+            id: this.calendarId,
+          },
+        ],
       },
     });
 
-    $.export("$summary", "Successfully retrieved free/busy calendar info");
+    $.export("$summary", `Successfully retrieved free/busy calendar details from ${this.timeMin} to ${this.timeMax}`);
 
     return response;
   },

package/actions/quick-add-event/quick-add-event.mjs

@@ -3,8 +3,8 @@ import googleCalendar from "../../google_calendar.app.mjs";
 export default {
   key: "google_calendar-quick-add-event",
   name: "Add Quick Event",
-  description: "Create an event to the Google Calendar. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#quickAdd)",
-  version: "0.1.1",
+  description: "Create a quick event to the Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#quickAdd)",
+  version: "0.1.2",
   type: "action",
   props: {
     googleCalendar,
@@ -17,7 +17,7 @@ export default {
     text: {
       label: "Event Title",
       type: "string",
-      description: "Enter static text (e.g., `hello world`) for the event name",
+      description: "Enter a title for the event, (e.g., `My event`)",
     },
   },
   async run({ $ }) {
@@ -26,7 +26,7 @@ export default {
       text: this.text,
     });
 
-    $.export("$summary", `Successfully quick added event ${response.id}`);
+    $.export("$summary", `Successfully added a quick event: "${response.id}"`);
 
     return response;
   },

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

@@ -1,10 +1,11 @@
 import googleCalendar from "../../google_calendar.app.mjs";
+import createEventCommon from "../common/create-event-common.mjs";
 
 export default {
   key: "google_calendar-update-event",
   name: "Update Event",
-  description: "Update an event to the Google Calendar. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#update)",
-  version: "0.0.2",
+  description: "Update an event from Google Calendar. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#update)",
+  version: "0.0.3",
   type: "action",
   props: {
     googleCalendar,
@@ -23,114 +24,44 @@ export default {
         }),
       ],
     },
-    summary: {
-      label: "Event Title",
-      type: "string",
-      description: "Enter static text (e.g., `hello world`) for the event name",
-      optional: true,
-    },
-    location: {
-      label: "Event Venue",
-      type: "string",
-      description: "Enter static text (e.g., `hello world`) for the event venue",
-      optional: true,
-    },
-    description: {
-      label: "Event Description",
-      type: "string",
-      description: "Enter detailed event description",
-      optional: true,
-    },
-    attendees: {
-      label: "Attendees",
-      type: "string[]",
-      description: "Enter the EmailId of the attendees",
-      optional: true,
-    },
-    eventStartDate: {
-      label: "Event Date",
-      type: "string",
-      description: "For all-day events, enter the Event day in the format 'yyyy-mm-dd'. For events with time, format according to [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-1): 'yyyy-mm-ddThh:mm:ss+01:00'. A time zone offset is required unless a time zone is explicitly specified in timeZone.",
-    },
-    eventEndDate: {
-      label: "Event End Date",
-      type: "string",
-      description: "For all-day events, enter the Event day in the format 'yyyy-mm-dd'. For events with time, format according to [RFC3339](https://www.rfc-editor.org/rfc/rfc3339.html#section-1): 'yyyy-mm-ddThh:mm:ss+01:00'. A time zone offset is required unless a time zone is explicitly specified in timeZone.",
-    },
-    sendUpdates: {
-      label: "Send Updates",
-      type: "string",
-      description: "Whether to send notifications about the creation of the new event.",
-      optional: true,
-      options: [
-        "all",
-        "externalOnly",
-        "none",
-      ],
-    },
-    timeZone: {
-      propDefinition: [
-        googleCalendar,
-        "timeZone",
-      ],
-    },
+    ...createEventCommon.props({
+      isUpdate: true,
+    }),
+  },
+  methods: {
+    ...createEventCommon.methods,
   },
   async run({ $ }) {
-    /**
-     * Based on the IINA Time Zone DB
-     * http://www.iana.org/time-zones
-     */
-    const { value: timeZone } = this.timeZone ?? await this.googleCalendar.getSettings({
-      setting: "timezone",
+    const currentEvent = await this.googleCalendar.getEvent({
+      calendarId: this.calendarId,
+      eventId: this.eventId,
     });
 
-    /**
-     * Format for the attendees
-     *
-     * [
-     *   { "email": "lpage@example.com",},
-     *   { "email": "sbrin@example.com",},
-     * ]
-     */
-
-    let attendees = [];
-
-    if (this.attendees && Array.isArray(this.attendees)) {
-      attendees = this.attendees.map((email) => ({
-        email,
-      }));
-    }
+    const timeZone = this.getTimeZone(this.timeZone || currentEvent.start.timeZone);
+    const attendees = this.formatAttendees(this.attendees, currentEvent.attendees);
 
     const response = await this.googleCalendar.updateEvent({
       calendarId: this.calendarId,
       eventId: this.eventId,
+      sendUpdates: this.sendUpdates,
+      sendNotifications: this.sendNotifications,
       requestBody: {
-        summary: this.summary,
-        location: this.location,
-        description: this.description,
-        start: {
-          date: this.eventStartDate.length <= 10
-            ? this.eventStartDate
-            : undefined,
-          dateTime: this.eventStartDate.length > 10
-            ? this.eventStartDate
-            : undefined,
-          timeZone,
-        },
-        end: {
-          date: this.eventEndDate.length <= 10
-            ? this.eventEndDate
-            : undefined,
-          dateTime: this.eventEndDate.length > 10
-            ? this.eventEndDate
-            : undefined,
-          timeZone,
-        },
+        summary: this.summary || currentEvent.summary,
+        location: this.location || currentEvent.location,
+        description: this.description || currentEvent.description,
+        start: this.getDateParam({
+          date: this.eventStartDate || currentEvent.start.dateTime,
+          timeZone: timeZone || currentEvent.start.timeZone,
+        }),
+        end: this.getDateParam({
+          date: this.eventEndDate || currentEvent.end.dateTime,
+          timeZone: timeZone || currentEvent.end.timeZone,
+        }),
         attendees,
       },
     });
 
-    $.export("$summary", `Successfully updated event ${response.id}`);
+    $.export("$summary", `Successfully updated event: "${response.id}"`);
 
     return response;
   },

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

@@ -3,8 +3,8 @@ import googleCalendar from "../../google_calendar.app.mjs";
 export default {
   key: "google_calendar-update-event-attendees",
   name: "Update attendees of an event",
-  description: "Update attendees of an existing event. [See the docs here](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#update)",
-  version: "0.1.1",
+  description: "Update attendees of an existing event. [See the documentation](https://googleapis.dev/nodejs/googleapis/latest/calendar/classes/Resource$Events.html#update)",
+  version: "0.1.2",
   type: "action",
   props: {
     googleCalendar,
@@ -24,51 +24,52 @@ export default {
       ],
     },
     attendees: {
-      type: "string[]",
       label: "Attendees",
-      description: "Array of selected email addresses or a comma separated list of email addresses of attendees. (eg. `a@domain.com,b@domain.com`)",
-      async options() {
-        const { attendees = [] } =
-          await this.googleCalendar.getEvent({
-            eventId: this.eventId,
-            calendarId: this.calendarId,
-          });
-        return attendees.map(({ email }) => ({
-          label: email,
-          value: email,
+      type: "string[]",
+      description: "Enter an array of email addresses for any attendees",
+    },
+    sendUpdates: {
+      propDefinition: [
+        googleCalendar,
+        "sendUpdates",
+      ],
+    },
+    sendNotifications: {
+      propDefinition: [
+        googleCalendar,
+        "sendNotifications",
+      ],
+    },
+  },
+  methods: {
+    formatAttendees(selectedAttendees) {
+      let attendees = [];
+      if (selectedAttendees && Array.isArray(selectedAttendees)) {
+        attendees = selectedAttendees.map((email) => ({
+          email,
         }));
-      },
+      }
+      return attendees;
     },
   },
   async run({ $ }) {
-    const { attendees = [] } = this;
-    const {
-      // eslint-disable-next-line no-unused-vars
-      attendees: ignored,
-      ...body
-    } = await this.googleCalendar.getEvent({
+    const updatedAttendees = this.formatAttendees(this.attendees);
+    const currentEvent = await this.googleCalendar.getEvent({
       eventId: this.eventId,
       calendarId: this.calendarId,
     });
-
-    const updatedAttendees =
-      Array.isArray(this.attendees)
-        ? attendees
-        : attendees.split(",");
-
     const response = await this.googleCalendar.updateEvent({
       calendarId: this.calendarId,
       eventId: this.eventId,
+      sendUpdates: this.sendUpdates,
+      sendNotifications: this.sendNotifications,
       requestBody: {
-        ...body,
-        attendees: updatedAttendees.map((email) => ({
-          email: email.trim(),
-        })),
+        ...currentEvent,
+        attendees: updatedAttendees,
       },
     });
 
-    $.export("$summary", `Successfully updated event attendees ${response.id}`);
-
+    $.export("$summary", `Successfully updated event attendees: "${response.id}"`);
     return response;
   },
 };

package/google_calendar.app.mjs

@@ -7,9 +7,9 @@ export default {
   app: "google_calendar",
   propDefinitions: {
     calendarId: {
-      label: "Calendar",
+      label: "Calendar ID",
       type: "string",
-      description: "Optionally select the calendar you'd like to use (defaults to the primary calendar for the logged-in user)",
+      description: "Optionally select the calendar, defaults to the primary calendar for the logged-in user",
       default: "primary",
       optional: true,
       async options({ prevContext }) {
@@ -33,9 +33,9 @@ export default {
       },
     },
     eventId: {
-      label: "Event Name",
+      label: "Event ID",
       type: "string",
-      description: "Event identifier. To retreive event Ids from a calender.",
+      description: "Select an event from Google Calendar.",
       async options({
         calendarId, prevContext,
       }) {
@@ -143,14 +143,14 @@ export default {
       type: "string",
     },
     timeMax: {
-      label: "Max start time",
-      description: "Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ignored. If timeMin is set, timeMax must be greater than timeMin.",
+      label: "Max time",
+      description: "Upper bound (exclusive) for an event's time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ignored. Must be greater than Min Time.",
       optional: true,
       type: "string",
     },
     timeMin: {
-      label: "Minimum end time",
-      description: "Lower bound (exclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ignored. If timeMax is set, timeMin must be smaller than timeMax.",
+      label: "Min time",
+      description: "Lower bound (exclusive) for an event's time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ignored. Must be smaller than Max Time.",
       optional: true,
       type: "string",
     },
@@ -244,6 +244,23 @@ export default {
       description: "The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type 'default'",
       optional: true,
     },
+    sendUpdates: {
+      label: "Send Updates",
+      type: "string",
+      description: "Configure whether to send notifications about the event",
+      optional: true,
+      options: [
+        "all",
+        "externalOnly",
+        "none",
+      ],
+    },
+    sendNotifications: {
+      label: "Send Notifications",
+      type: "boolean",
+      description: "Whether to send notifications about the event update",
+      optional: true,
+    },
   },
   methods: {
     _tokens() {
@@ -426,7 +443,7 @@ export default {
         args,
       });
     },
-    async queryFreebusy(args = {}) {
+    async queryFreeBusy(args = {}) {
       return this.requestHandler({
         api: constants.API.FREEBUSY.NAME,
         method: constants.API.FREEBUSY.METHOD.QUERY,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/google_calendar",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Pipedream Google_calendar Components",
   "main": "google_calendar.app.mjs",
   "keywords": [

package/sources/{common.mjs → common/common.mjs}

@@ -1,21 +1,26 @@
-import googleCalendar from "../google_calendar.app.mjs";
+import googleCalendar from "../../google_calendar.app.mjs";
 import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
 
 export default {
-  props: {
-    googleCalendar,
-    calendarId: {
-      propDefinition: [
-        googleCalendar,
-        "calendarId",
-      ],
-    },
-    timer: {
-      type: "$.interface.timer",
-      default: {
-        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
+  props: ({ useCalendarId }) => {
+    const props = {
+      googleCalendar,
+      timer: {
+        type: "$.interface.timer",
+        default: {
+          intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
+        },
       },
-    },
+    };
+    if (useCalendarId) {
+      props.calendarId = {
+        propDefinition: [
+          googleCalendar,
+          "calendarId",
+        ],
+      };
+    }
+    return props;
   },
   hooks: {
     async activate() {

package/sources/event-cancelled/event-cancelled.mjs

@@ -1,15 +1,18 @@
-import common from "../common.mjs";
+import common from "../common/common.mjs";
 
 export default {
   ...common,
   key: "google_calendar-event-cancelled",
-  // eslint-disable-next-line pipedream/source-name
-  name: "Event Cancelled",
-  // eslint-disable-next-line pipedream/source-description
-  description: "Emits when an event is cancelled or deleted",
-  version: "0.1.3",
+  name: "New Cancelled Event",
+  description: "Emit new event when a Google Calendar event is cancelled or deleted",
+  version: "0.1.4",
   type: "source",
-  dedupe: "unique", // Dedupe events based on the Google Calendar event ID
+  dedupe: "unique",
+  props: {
+    ...common.props({
+      useCalendarId: true,
+    }),
+  },
   methods: {
     ...common.methods,
     getConfig({

package/sources/event-ended/event-ended.mjs

@@ -1,15 +1,18 @@
-import common from "../common.mjs";
+import common from "../common/common.mjs";
 
 export default {
   ...common,
   key: "google_calendar-event-ended",
-  // eslint-disable-next-line pipedream/source-name
-  name: "Event Ended",
-  // eslint-disable-next-line pipedream/source-description
-  description: "Emits when an event ends",
-  version: "0.1.3",
+  name: "New Ended Event",
+  description: "Emit new event when a Google Calendar event ends",
+  version: "0.1.4",
   type: "source",
-  dedupe: "unique", // Dedupe events based on the Google Calendar event ID
+  dedupe: "unique",
+  props: {
+    ...common.props({
+      useCalendarId: true,
+    }),
+  },
   methods: {
     ...common.methods,
     getConfig({

package/sources/event-start/event-start.mjs

@@ -1,15 +1,18 @@
-import common from "../common.mjs";
+import common from "../common/common.mjs";
 
 export default {
   ...common,
   key: "google_calendar-event-start",
-  // eslint-disable-next-line pipedream/source-name
-  name: "Event Start",
-  // eslint-disable-next-line pipedream/source-description
-  description: "Emits a specified time before an event starts",
-  version: "0.1.3",
+  name: "New Event Start",
+  description: "Emit new event when the specified time before the Google Calendar event starts",
+  version: "0.1.4",
   type: "source",
-  dedupe: "unique", // Dedupe events based on the Google Calendar event ID
+  dedupe: "unique",
+  props: {
+    ...common.props({
+      useCalendarId: true,
+    }),
+  },
   methods: {
     ...common.methods,
     getConfig({

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

@@ -1,26 +1,19 @@
-import googleCalendar from "../../google_calendar.app.mjs";
-import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
+import common from "../common/common.mjs";
 
 export default {
   key: "google_calendar-new-calendar",
-  name: "New Calendar",
-  // eslint-disable-next-line pipedream/source-description
-  description: "Emit an event when a calendar is created.",
-  version: "0.1.3",
+  name: "New Calendar Created",
+  description: "Emit new event when a calendar is created.",
+  version: "0.1.4",
   type: "source",
   props: {
+    ...common.props({
+      useCalendarId: false,
+    }),
     db: "$.service.db",
-    googleCalendar,
-    timer: {
-      type: "$.interface.timer",
-      default: {
-        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
-      },
-    },
   },
   hooks: {
     async activate() {
-      // get list of calendars
       const { items: calendars = [] } = await this.googleCalendar.listCalendars();
       this.emitNewCalendars(calendars);
       const calendarIds = calendars.map((item) => item.id);

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

@@ -1,13 +1,18 @@
-import common from "../common.mjs";
+import common from "../common/common.mjs";
 
 export default {
   ...common,
   key: "google_calendar-new-event",
-  name: "New Event",
-  description: "Emits when an event is created",
-  version: "0.1.3",
+  name: "New Event Created",
+  description: "Emit new event when a Google Calendar event is created",
+  version: "0.1.4",
   type: "source",
-  dedupe: "unique", // Dedupe events based on the Google Calendar event ID
+  dedupe: "unique",
+  props: {
+    ...common.props({
+      useCalendarId: true,
+    }),
+  },
   methods: {
     ...common.methods,
     getConfig({ past }) {

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

@@ -1,20 +1,20 @@
-import common from "../common.mjs";
+import common from "../common/common.mjs";
 
 export default {
   ...common,
   key: "google_calendar-new-event-search",
-  // eslint-disable-next-line pipedream/source-name
-  name: "Event Search",
-  // eslint-disable-next-line pipedream/source-description
-  description: "Emit when an event is created that matches a search",
-  version: "0.1.3",
+  name: "New Event Matching a Search",
+  description: "Emit new event when a Google Calendar event is created that matches a search",
+  version: "0.1.4",
   type: "source",
-  dedupe: "unique", // Dedupe events based on the Google Calendar event ID
+  dedupe: "unique",
   props: {
-    ...common.props,
+    ...common.props({
+      useCalendarId: true,
+    }),
     q: {
       propDefinition: [
-        common.props.googleCalendar,
+        common.props({}).googleCalendar,
         "q",
       ],
     },

package/sources/new-or-updated-event/new-or-updated-event.mjs

@@ -1,14 +1,18 @@
-import common from "../common.mjs";
+import common from "../common/common.mjs";
 
 export default {
   ...common,
   key: "google_calendar-new-or-updated-event",
-  name: "New or Updated Event",
-  // eslint-disable-next-line pipedream/source-description
-  description: "Emits when an event is created or updated (except when it's cancelled)",
-  version: "0.1.3",
+  name: "New Created or Updated Event",
+  description: "Emit new event when a Google Calendar events is created or updated (does not emit cancelled events)",
+  version: "0.1.4",
   type: "source",
-  dedupe: "unique", // Dedupe events based on the Google Calendar event ID
+  dedupe: "unique",
+  props: {
+    ...common.props({
+      useCalendarId: true,
+    }),
+  },
   methods: {
     ...common.methods,
     getConfig({ past }) {

package/sources/new-or-updated-event-instant/new-or-updated-event-instant.mjs

@@ -5,9 +5,9 @@ import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
 export default {
   key: "google_calendar-new-or-updated-event-instant",
   type: "source",
-  name: "New or Updated Event (Instant)",
-  description: "Emit new calendar events when an event is created or updated (does not emit cancelled events)",
-  version: "0.1.6",
+  name: "New Created or Updated Event (Instant)",
+  description: "Emit new event when a Google Calendar events is created or updated (does not emit cancelled events)",
+  version: "0.1.8",
   dedupe: "unique",
   props: {
     googleCalendar,
@@ -18,13 +18,16 @@ export default {
         "calendarId",
       ],
       type: "string[]",
+      default: [
+        "primary",
+      ],
       label: "Calendars",
-      description: "Select one or more calendars to watch",
+      description: "Select one or more calendars to watch (defaults to the primary calendar)",
     },
     newOnly: {
-      label: "New events only?",
+      label: "Emit only for new events",
       type: "boolean",
-      description: "Emit new events only, and not updates to existing events",
+      description: "Emit new events only, and not updates to existing events (defaults to `false`)",
       optional: true,
       default: false,
     },

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

@@ -2,15 +2,13 @@ import taskScheduler from "../../../pipedream/sources/new-scheduled-tasks/new-sc
 import googleCalendar from "../../google_calendar.app.mjs";
 import { axios } from "@pipedream/platform";
 
-const docLink = "https://pipedream.com/docs/examples/waiting-to-execute-next-step-of-workflow/#step-1-create-a-task-scheduler-event-source";
-
 export default {
   key: "google_calendar-upcoming-event-alert",
-  // eslint-disable-next-line pipedream/source-name
-  name: "Upcoming Event Alert",
-  description: `Triggers based on a time interval before an upcoming event in the calendar. This source uses Pipedream's Task Scheduler.
-    [See here](${docLink}) for more information and instructions for connecting your Pipedream account.`,
-  version: "0.0.2",
+  name: "New Upcoming Event Alert",
+  description: `Emit new event based on a time interval before an upcoming event in the calendar. This source uses Pipedream's Task Scheduler.
+    [See the documentation](https://pipedream.com/docs/examples/waiting-to-execute-next-step-of-workflow/#step-1-create-a-task-scheduler-event-source) 
+    for more information and instructions for connecting your Pipedream account.`,
+  version: "0.0.3",
   type: "source",
   props: {
     pipedream: taskScheduler.props.pipedream,