@pipedream/zoom 0.3.1 → 0.3.4

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

@@ -0,0 +1,59 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  key: "zoom-meeting-started",
+  name: "Meeting Started (Instant)",
+  description: "Emit new event each time a meeting starts where you're the host",
+  version: "0.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on meeting ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "meeting.started",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { meetings } = await this.zoom.listMeetings({
+        page_size: 25,
+        type: "previous_meetings",
+      });
+      if (!meetings || meetings.length === 0) {
+        return;
+      }
+      const objects = this.sortByDate(meetings, "start_time");
+      for (const object of objects) {
+        const startTime = Date.parse(object.start_time);
+        if (startTime < Date.now()) {
+          this.emitEvent({
+            object,
+            time_stamp: Date.now(),
+          }, object);
+        }
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "meeting.started",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: `Meeting ${object.topic} started`,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,55 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  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.0.4",
+  type: "source",
+  dedupe: "unique", // dedupe on the meeting ID + timestamp
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "meeting.updated",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { meetings } = await this.zoom.listMeetings({
+        page_size: 25,
+      });
+      if (!meetings || meetings.length === 0) {
+        return;
+      }
+      const objects = this.sortByDate(meetings, "created_at");
+      for (const object of objects) {
+        this.emitEvent({
+          object,
+          time_stamp: +new Date(object.start_time),
+        }, object);
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(payload, object);
+      this.$emit({
+        event: "meeting.updated",
+        payload,
+      }, meta);
+    },
+    generateMeta(payload, object) {
+      return {
+        id: `${object.id}-${payload.time_stamp}`,
+        summary: `Meeting ${object.id} updated`,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,33 @@
+import zoom from "../../zoom.app.mjs";
+import constants from "../common/constants.mjs";
+
+export default {
+  key: "zoom-phone-event",
+  name: "Zoom Phone Events (Instant)",
+  description: "Listen for any Zoom Phone events tied to your Zoom user or resources you own",
+  version: "0.0.2",
+  type: "source",
+  props: {
+    zoom,
+    eventNameOptions: {
+      label: "Zoom Events",
+      type: "string[]",
+      options: constants.PHONE_EVENT_TYPES,
+    },
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      async eventNames() {
+        return this.eventNameOptions;
+      },
+    },
+  },
+  async run(event) {
+    console.log(event);
+    this.$emit(event, {
+      id: event.payload?.object?.id,
+      summary: event.event,
+      ts: Date.now(),
+    });
+  },
+};

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

@@ -0,0 +1,129 @@
+import zoom from "../../zoom.app.mjs";
+import common from "../common/common.mjs";
+
+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.0.6",
+  type: "source",
+  dedupe: "unique",
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "recording.completed",
+      ],
+    },
+    meetingIds: {
+      propDefinition: [
+        zoom,
+        "meetingIds",
+      ],
+    },
+    includeAudioRecordings: {
+      propDefinition: [
+        zoom,
+        "includeAudioRecordings",
+      ],
+    },
+    includeChatTranscripts: {
+      propDefinition: [
+        zoom,
+        "includeChatTranscripts",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { meetings } = await this.zoom.listRecordings({
+        from: this.monthAgo(),
+        to: new Date().toISOString()
+          .slice(0, 10),
+        page_size: 25,
+      });
+      if (!meetings || meetings.length === 0) {
+        return;
+      }
+      for (const meeting of meetings) {
+        if (!this.isMeetingRelevant(meeting)) {
+          continue;
+        }
+        for (const file of meeting.recording_files) {
+          if (!this.isFileRelevant(file)) {
+            continue;
+          }
+          this.emitEvent(file, meeting);
+        }
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    isMeetingRelevant(meeting) {
+      const {
+        id, recording_files,
+      } = meeting;
+
+      if (!recording_files || recording_files.length === 0) {
+        console.log("No files in recording. Exiting");
+        return false;
+      }
+
+      if (this.meetingIds && this.meetingIds.length > 0 && !this.meetingIds.includes(id)) {
+        console.log("Meeting ID does not match the filter rules.");
+        return false;
+      }
+      return true;
+    },
+    isFileRelevant(file) {
+      return !((file.status !== "completed")
+        || (file.file_type === "M4A" && !this.includeAudioRecordings)
+        || (file.file_type === "CHAT" && !this.includeChatTranscripts));
+    },
+    emitEvent(file, meeting, downloadToken = null) {
+      this.$emit(
+        {
+          download_url_with_token: `${file.download_url}?access_token=${downloadToken}`,
+          download_token: downloadToken,
+          ...file,
+          meeting_id_long: meeting.id, // Long ID is necessary for certain API operations
+          meeting_topic: meeting.topic,
+          host_id: meeting.host_id,
+          host_email: meeting.host_email,
+        },
+        {
+          id: file.id,
+          summary: `${meeting.topic} — ${file.file_type}`,
+          ts: +new Date(file.recording_end),
+        },
+      );
+    },
+  },
+  async run(event) {
+    if (event.event !== "recording.completed") {
+      console.log("Not a recording.completed event. Exiting");
+      return;
+    }
+    const { payload } = event;
+    const {
+      object,
+      download_token: downloadToken,
+    } = payload;
+    const { recording_files: recordingFiles } = object;
+
+    if (!this.isMeetingRelevant(object)) {
+      return;
+    }
+
+    for (const file of recordingFiles) {
+      if (!this.isFileRelevant(file)) {
+        continue;
+      }
+
+      this.emitEvent(file, object, downloadToken);
+    }
+  },
+};

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

@@ -0,0 +1,55 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  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.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on webinar ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "webinar.created.by_me",
+        "webinar.created.for_me",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { webinars } = await this.zoom.listWebinars({
+        page_size: 25,
+      });
+      if (!webinars || webinars.length === 0) {
+        return;
+      }
+      const objects = this.sortByDate(webinars, "created_at");
+      for (const object of objects) {
+        this.emitEvent({
+          object,
+        }, object);
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "webinar.created",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: object.topic,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,38 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  key: "zoom-webinar-deleted",
+  name: "Webinar Deleted",
+  description: "Emit new event each time a webinar is deleted where you're the host",
+  version: "0.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on webinar ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "webinar.deleted.by_me",
+        "webinar.deleted.for_me",
+      ],
+    },
+  },
+  methods: {
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "webinar.deleted",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: object.topic,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,60 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  key: "zoom-webinar-ended",
+  name: "Webinar Ended (Instant)",
+  description: "Emit new event each time a webinar ends where you're the host",
+  version: "0.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on webinar ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "webinar.ended",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { webinars } = await this.zoom.listWebinarMetrics({
+        from: this.monthAgo(),
+        to: new Date().toISOString()
+          .slice(0, 10),
+        page_size: 25,
+      });
+      if (!webinars || webinars.length === 0) {
+        return;
+      }
+      const objects = this.sortByDate(webinars, "end_time");
+      for (const object of objects) {
+        const endTime = Date.parse(object.end_time);
+        if (endTime < Date.now()) {
+          this.emitEvent({
+            object,
+          }, object);
+        }
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "webinar.ended",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: object.topic,
+        ts: +new Date(object.end_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,58 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  key: "zoom-webinar-started",
+  name: "Webinar Started (Instant)",
+  description: "Emit new event each time a webinar starts where you're the host",
+  version: "0.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on webinar ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "webinar.started",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { webinars } = await this.zoom.listWebinars({
+        page_size: 25,
+      });
+      if (!webinars || webinars.length === 0) {
+        return;
+      }
+      const objects = this.sortByDate(webinars, "start_time");
+      for (const object of objects) {
+        const startTime = Date.parse(object.start_time);
+        if (startTime < Date.now()) {
+          this.emitEvent({
+            object,
+            time_stamp: startTime,
+          }, object);
+        }
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "webinar.started",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: object.topic,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,55 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  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.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on webinar ID & timestamp
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "webinar.updated",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { webinars } = await this.zoom.listWebinars({
+        page_size: 25,
+      });
+      if (!webinars || webinars.length === 0) {
+        return;
+      }
+      const objects = this.sortByDate(webinars, "created_at");
+      for (const object of objects) {
+        this.emitEvent({
+          object,
+          time_stamp: +new Date(object.start_time),
+        }, object);
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(payload, object);
+      this.$emit({
+        event: "webinar.updated",
+        payload,
+      }, meta);
+    },
+    generateMeta(payload, object) {
+      return {
+        id: `${object.id}-${payload.time_stamp}`,
+        summary: `Webinar ${object.id} updated`,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

package/zoom.app.mjs

@@ -0,0 +1,99 @@
+import { axios } from "@pipedream/platform";
+
+export default {
+  type: "app",
+  app: "zoom",
+  propDefinitions: {
+    meetingIds: {
+      type: "integer[]",
+      label: "Meeting Filter",
+      description: "Optionally filter for events for one or more meetings",
+      async options({ page }) {
+        const { meetings } = await this.listMeetings({
+          page_number: page + 1,
+        });
+        return meetings.map((meeting) => ({
+          label: `${meeting.topic} (${meeting.id})`,
+          value: meeting.id,
+        }));
+      },
+      optional: true,
+    },
+    includeAudioRecordings: {
+      type: "boolean",
+      label: "Include Audio Recordings",
+      description:
+        "This source emits video (MP4) recordings only by default. Set this prop to true to include audio recordings",
+      optional: true,
+      default: false,
+    },
+    includeChatTranscripts: {
+      type: "boolean",
+      label: "Include Chat Transcripts",
+      description:
+        "This source emits video (MP4) recordings only by default. Set this prop to `true` to include chat transcripts",
+      optional: true,
+      default: false,
+    },
+  },
+  methods: {
+    _baseUrl() {
+      return "https://api.zoom.us/v2/";
+    },
+    _getHeaders() {
+      return {
+        "Authorization": `Bearer ${this.$auth.oauth_access_token}`,
+        "Content-Type": "application/json",
+      };
+    },
+    async _makeRequest(args = {}) {
+      const {
+        method = "GET",
+        headers,
+        path,
+        $ = this,
+        ...otherArgs
+      } = args;
+      const config = {
+        method,
+        headers: {
+          ...headers,
+          ...this._getHeaders(),
+        },
+        url: `${this._baseUrl()}${path}`,
+        ...otherArgs,
+      };
+      return axios($, config);
+    },
+    async getPastMeetingDetails(meetingId, params) {
+      return this._makeRequest({
+        path: `past_meetings/${meetingId}`,
+        params,
+      });
+    },
+    async listMeetings(params) {
+      return this._makeRequest({
+        path: "users/me/meetings",
+        params,
+      });
+    },
+    async listWebinars(params) {
+      return this._makeRequest({
+        path: "users/me/webinars",
+        params,
+      });
+    },
+    async listWebinarMetrics(params) {
+      return this._makeRequest({
+        path: "metrics/webinars",
+        params,
+      });
+    },
+    async listRecordings(params) {
+      return this._makeRequest({
+        path: "users/me/recordings",
+        params,
+      });
+    },
+  },
+};