@pipedream/zoom 0.8.0 → 0.9.1

package/actions/add-meeting-registrant/add-meeting-registrant.mjs

@@ -1,10 +1,12 @@
 import app from "../../zoom.app.mjs";
+import { ConfigurationError } from "@pipedream/platform";
+import constants from "../../common/utils.mjs";
 
 export default {
   key: "zoom-add-meeting-registrant",
   name: "Add Meeting Registrant",
-  description: "Registers a participant for a meeting. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/meetingRegistrantCreate)",
-  version: "0.3.6",
+  description: "Registers a participant or multiple participants for a meeting. [See the documentation](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/meetingRegistrantCreate)",
+  version: "0.3.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -18,6 +20,7 @@ export default {
         app,
         "meetingId",
       ],
+      optional: false,
     },
     occurrenceIds: {
       propDefinition: [
@@ -127,6 +130,33 @@ export default {
         "customQuestions",
       ],
     },
+    registrants: {
+      type: "object",
+      label: "Registrants",
+      description: `Use this field to enter multiple registrants at once. Will override the single registrant fields if provided. Each registrant should be an object with at least the following properties: email, first_name, last_name. Example:
+      \`[
+        {
+          "email": "test@example.com",
+          "first_name": "John",
+          "last_name": "Doe"
+        }
+      ]\``,
+      optional: true,
+      reloadProps: true,
+    },
+  },
+  additionalProps(props) {
+    // Don't require email, firstName, lastName if registrants array is provided
+    props.email.optional = this.registrants
+      ? true
+      : false;
+    props.firstName.optional = this.registrants
+      ? true
+      : false;
+    props.lastName.optional = this.registrants
+      ? true
+      : false;
+    return {};
   },
   methods: {
     addMeetingRegistrant({
@@ -161,37 +191,62 @@ export default {
       customQuestions,
     } = this;
 
-    const response = await this.addMeetingRegistrant({
-      step,
-      meetingId,
-      params: {
-        occurrence_ids: occurrenceIds,
-      },
-      data: {
-        email,
-        first_name: firstName,
-        last_name: lastName,
-        address,
-        city,
-        country,
-        zip,
-        state,
-        phone,
-        industry,
-        org,
-        job_title: jobTitle,
-        purchasing_time_frame: purchasingTimeFrame,
-        role_in_purchase_process: roleInPurchaseProcess,
-        no_of_employees: noOfEmployees,
-        comments,
-        custom_questions: typeof(customQuestions) === "undefined"
-          ? customQuestions
-          : JSON.parse(customQuestions),
-      },
-    });
+    // If registrants array is provided, use it. Otherwise, use the single registrant fields.
+    let registrants = constants.parseArray(this.registrants);
+    if (!registrants?.length) {
+      registrants = [
+        {
+          email,
+          first_name: firstName,
+          last_name: lastName,
+          address,
+          city,
+          country,
+          zip,
+          state,
+          phone,
+          industry,
+          org,
+          job_title: jobTitle,
+          purchasing_time_frame: purchasingTimeFrame,
+          role_in_purchase_process: roleInPurchaseProcess,
+          no_of_employees: noOfEmployees,
+          comments,
+          custom_questions: typeof(customQuestions) === "undefined"
+            ? customQuestions
+            : JSON.parse(customQuestions),
+        },
+      ];
+    }
+
+    if (registrants.length > 10) {
+      throw new ConfigurationError("You can only add up to 10 registrants at once.");
+    }
 
-    step.export("$summary", `Successfully added registrant to meeting with ID \`${response.id}\``);
+    // Add each registrant to the meeting
+    const responses = [];
+    for (const registrant of registrants) {
+      try {
+        const registration = await this.addMeetingRegistrant({
+          step,
+          meetingId,
+          params: {
+            occurrence_ids: occurrenceIds,
+          },
+          data: registrant,
+        });
+        responses.push(registration);
+      } catch (error) {
+        throw new ConfigurationError(`Added ${responses.length} registrants before encountering an error: ${error.message}`);
+      }
+    }
 
-    return response;
+    if (registrants.length > 1) {
+      step.export("$summary", `Successfully added ${registrants.length} registrants to meeting with ID \`${meetingId}\``);
+      return responses;
+    } else {
+      step.export("$summary", `Successfully added registrant to meeting with ID \`${meetingId}\``);
+      return responses[0];
+    }
   },
 };

package/actions/add-webinar-registrant/add-webinar-registrant.mjs

@@ -4,7 +4,7 @@ export default {
   key: "zoom-add-webinar-registrant",
   name: "Add Webinar Registrant",
   description: "Registers a participant for a webinar. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/webinars/webinarregistrantcreate).",
-  version: "0.3.6",
+  version: "0.3.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/delete-meeting/delete-meeting.mjs

@@ -4,7 +4,7 @@ export default {
   key: "zoom-delete-meeting",
   name: "Delete Meeting",
   description: "Delete a meeting. [See the documentation](https://developers.zoom.us/docs/api/meetings/#tag/meetings/delete/meetings/{meetingId})",
-  version: "0.0.1",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: true,

package/actions/get-meeting-details/get-meeting-details.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-get-meeting-details",
   name: "Get Meeting Details",
   description: "Retrieves the details of a meeting.",
-  version: "0.3.6",
+  version: "0.3.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-meeting-transcript/get-meeting-transcript.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-get-meeting-transcript",
   name: "Get Meeting Transcript",
   description: "Get the transcript of a meeting. [See the documentation](https://developers.zoom.us/docs/api/meetings/#tag/cloud-recording/get/meetings/{meetingId}/transcript)",
-  version: "0.0.4",
+  version: "0.0.6",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-webinar-details/get-webinar-details.mjs

@@ -4,7 +4,7 @@ export default {
   key: "zoom-get-webinar-details",
   name: "Get Webinar Details",
   description: "Gets details of a scheduled webinar. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/webinar).",
-  version: "0.3.6",
+  version: "0.3.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-call-recordings/list-call-recordings.mjs

@@ -4,7 +4,7 @@ export default {
   name: "List Call Recordings",
   description: "Get your account's call recordings. [See the documentation](https://developers.zoom.us/docs/api/rest/reference/phone/methods/#operation/getPhoneRecordings)",
   key: "zoom-list-call-recordings",
-  version: "0.0.4",
+  version: "0.0.6",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-meetings/list-meetings.mjs

@@ -0,0 +1,125 @@
+import zoom from "../../zoom.app.mjs";
+import constants from "../../common/constants.mjs";
+
+export default {
+  name: "List Meetings",
+  description: "List meetings for a user. [See the documentation](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/meetings)",
+  key: "zoom-list-meetings",
+  version: "0.0.2",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    zoom,
+    userId: {
+      propDefinition: [
+        zoom,
+        "meetingUserId",
+      ],
+    },
+    type: {
+      type: "string",
+      label: "Type",
+      description: "The type of meetings to list. Defaults to `scheduled`",
+      optional: true,
+      options: constants.MEETING_TYPES,
+    },
+    from: {
+      type: "string",
+      label: "From",
+      description: "The start date and time of the meetings to list. Example: `2023-01-01`",
+      optional: true,
+    },
+    to: {
+      type: "string",
+      label: "To",
+      description: "The end date and time of the meetings to list. Example: `2023-01-01`",
+      optional: true,
+    },
+    timezone: {
+      type: "string",
+      label: "Timezone",
+      description: "The timezone to use for the `from` and `to` dates. Example: `America/New_York`",
+      optional: true,
+    },
+    titleSearch: {
+      type: "string",
+      label: "Title Search",
+      description: "The title of the meetings to search for",
+      optional: true,
+    },
+    createdAfter: {
+      type: "string",
+      label: "Created After",
+      description: "The date and time to filter meetings created after. Example: `2023-01-01`",
+      optional: true,
+    },
+    createdBefore: {
+      type: "string",
+      label: "Created Before",
+      description: "The date and time to filter meetings created before. Example: `2023-01-01`",
+      optional: true,
+    },
+    max: {
+      propDefinition: [
+        zoom,
+        "max",
+      ],
+    },
+  },
+  methods: {
+    isRelevant(meeting) {
+      if (this.titleSearch) {
+        if (!meeting.topic?.toLowerCase().includes(this.titleSearch.toLowerCase())) {
+          return false;
+        }
+      }
+      if (this.createdAfter && Date.parse(meeting.created_at) < Date.parse(this.createdAfter)) {
+        return false;
+      }
+      if (this.createdBefore && Date.parse(meeting.created_at) > Date.parse(this.createdBefore)) {
+        return false;
+      }
+      return true;
+    },
+  },
+  async run({ $ }) {
+    const meetings = [];
+    let count = 0;
+
+    const results = this.zoom.getResourcesStream({
+      resourceFn: this.zoom.listUserMeetings,
+      resourceFnArgs: {
+        $,
+        userId: this.userId,
+        params: {
+          type: this.type,
+          from: this.from,
+          to: this.to,
+          timezone: this.timezone,
+        },
+      },
+      resourceName: "meetings",
+    });
+
+    for await (const meeting of results) {
+      if (!this.isRelevant(meeting)) {
+        continue;
+      }
+      meetings.push(meeting);
+      count++;
+      if (count >= this.max) {
+        break;
+      }
+    }
+
+    $.export("$summary", `Successfully retrieved ${count} meeting${count === 1
+      ? ""
+      : "s"}`);
+
+    return meetings;
+  },
+};

package/actions/list-past-meeting-participants/list-past-meeting-participants.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-list-past-meeting-participants",
   name: "List Past Meeting Participants",
   description: "Retrieve information on participants from a past meeting. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/pastMeetingParticipants).",
-  version: "0.2.6",
+  version: "0.2.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-past-webinar-qa/list-past-webinar-qa.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-list-past-webinar-qa",
   name: "List Past Webinar Q&A",
   description: "The  feature for Webinars allows attendees to ask questions during the Webinar and for the panelists, co-hosts and host to answer their questions. Use this API to list Q&A of a specific Webinar.",
-  version: "0.1.6",
+  version: "0.1.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-user-call-logs/list-user-call-logs.mjs

@@ -4,7 +4,7 @@ export default {
   name: "List User's Call Logs",
   description: "Gets a user's Zoom phone call logs. [See the documentation](https://developers.zoom.us/docs/zoom-phone/apis/#operation/phoneUserCallLogs)",
   key: "zoom-list-user-call-logs",
-  version: "0.0.6",
+  version: "0.0.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-webinar-participants-report/list-webinar-participants-report.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-list-webinar-participants-report",
   name: "List Webinar Participants Report",
   description: "Retrieves detailed report on each webinar attendee. You can get webinar participant reports for the last 6 months. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/reportWebinarParticipants).",
-  version: "0.0.7",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/update-meeting/update-meeting.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-update-meeting",
   name: "Update Meeting",
   description: "Updates an existing Zoom meeting",
-  version: "0.1.6",
+  version: "0.1.7",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/update-webinar/update-webinar.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-update-webinar",
   name: "Update Webinar",
   description: "Update a webinar's topic, start time, or other settings",
-  version: "0.1.6",
+  version: "0.1.7",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/common/constants.mjs

@@ -2,8 +2,28 @@ const BASE_URL = "https://api.zoom.us";
 const VERSION_PATH = "/v2";
 const MAX_RESOURCES = 300;
 
+const MEETING_TYPES = [
+  {
+    value: "scheduled",
+    label: "All valid previous (unexpired) meetings, live meetings, and upcoming scheduled meetings",
+  },
+  {
+    value: "live",
+    label: "All ongoing meetings",
+  },
+  {
+    value: "upcoming",
+    label: "All upcoming meetings, including live meetings",
+  },
+  {
+    value: "previous_meetings",
+    label: "All the previous meetings",
+  },
+];
+
 export default {
   BASE_URL,
   VERSION_PATH,
   MAX_RESOURCES,
+  MEETING_TYPES,
 };

package/common/utils.mjs

@@ -1,3 +1,5 @@
+import { ConfigurationError } from "@pipedream/platform";
+
 async function streamIterator(stream) {
   const resources = [];
   for await (const resource of stream) {
@@ -21,8 +23,27 @@ function doubleEncode(value) {
   return value;
 }
 
+function parseArray(value) {
+  if (!value) {
+    return undefined;
+  }
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch {
+      throw new ConfigurationError(`Could not parse as array: ${value}`);
+    }
+  }
+  if (Array.isArray(value)) {
+    return value;
+  } else {
+    throw new ConfigurationError(`Expected a string or array, got ${typeof value}`);
+  }
+}
+
 export default {
   streamIterator,
   summaryEnd,
   doubleEncode,
+  parseArray,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/zoom",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Pipedream Zoom Components",
   "main": "zoom.app.mjs",
   "keywords": [

package/sources/custom-event/custom-event.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-custom-event",
   name: "Custom Events (Instant)",
   description: "Emit new events tied to your Zoom user or resources you own",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-created/meeting-created.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-created",
   name: "Meeting Created (Instant)",
   description: "Emit new event each time a meeting is created where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-deleted/meeting-deleted.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-deleted",
   name: "Meeting Deleted (Instant)",
   description: "Emit new event each time a meeting is deleted where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-ended/meeting-ended.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-ended",
   name: "Meeting Ended (Instant)",
   description: "Emit new event each time a meeting ends where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-started/meeting-started.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-started",
   name: "Meeting Started (Instant)",
   description: "Emit new event each time a meeting starts where you're the host",
-  version: "0.1.6",
+  version: "0.1.8",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-updated/meeting-updated.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-updated",
   name: "Meeting Updated (Instant)",
   description: "Emit new event each time a meeting is updated where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-recording-transcript-completed/new-recording-transcript-completed.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-new-recording-transcript-completed",
   name: "New Recording Transcript Completed (Instant)",
   description: "Emit new event each time a recording transcript is completed",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/phone-event/phone-event.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-phone-event",
   name: "Zoom Phone Events (Instant)",
   description: "Emit new Zoom Phone event tied to your Zoom user or resources you own",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   props: {
     ...common.props,

package/sources/recording-completed/recording-completed.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-recording-completed",
   name: "Recording Completed (Instant)",
   description: "Emit new event each time a new recording completes for a meeting or webinar where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-created/webinar-created.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-created",
   name: "Webinar Created (Instant)",
   description: "Emit new event each time a webinar is created where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-deleted/webinar-deleted.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-deleted",
   name: "Webinar Deleted (Instant)",
   description: "Emit new event each time a webinar is deleted where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-ended/webinar-ended.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-ended",
   name: "Webinar Ended (Instant)",
   description: "Emit new event each time a webinar ends where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-started/webinar-started.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-started",
   name: "Webinar Started (Instant)",
   description: "Emit new event each time a webinar starts where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-updated/webinar-updated.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-updated",
   name: "Webinar Updated (Instant)",
   description: "Emit new event each time a webinar is updated where you're the host",
-  version: "0.1.5",
+  version: "0.1.7",
   type: "source",
   dedupe: "unique",
   props: {

package/zoom.app.mjs

@@ -96,6 +96,31 @@ export default {
         };
       },
     },
+    meetingUserId: {
+      type: "string",
+      label: "User ID",
+      description: "The user ID or email address of the user to list meetings for",
+      async options({ prevContext }) {
+        const { nextPageToken } = prevContext;
+        const response = await this.listAllUsers({
+          params: {
+            next_page_token: nextPageToken,
+          },
+        });
+        const options = response.users.map(({
+          id: value, display_name, email,
+        }) => ({
+          label: `${display_name} - ${email}`,
+          value,
+        }));
+        return {
+          options,
+          context: {
+            nextPageToken: response.next_page_token,
+          },
+        };
+      },
+    },
     includeAudioRecordings: {
       type: "boolean",
       label: "Include Audio Recordings",
@@ -273,6 +298,14 @@ export default {
         ...args,
       });
     },
+    listUserMeetings({
+      userId, ...args
+    }) {
+      return this._makeRequest({
+        path: `/users/${userId}/meetings`,
+        ...args,
+      });
+    },
     listWebinars({
       userId = "me", ...args
     } = {}) {
@@ -299,6 +332,12 @@ export default {
         ...opts,
       });
     },
+    listAllUsers(opts = {}) {
+      return this._makeRequest({
+        path: "/users",
+        ...opts,
+      });
+    },
     listCallLogs({
       userId, ...args
     }) {