@pipedream/zoom 0.10.1 → 0.11.0

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

@@ -0,0 +1,62 @@
+import zoom from "../../zoom.app.mjs";
+
+export default {
+  key: "zoom-get-meeting-summary",
+  name: "Get Meeting Summary",
+  description: "Retrieve the summary of a meeting or webinar. [See the documentation](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/Getameetingsummary)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    zoom,
+    // eslint-disable-next-line pipedream/props-label, pipedream/props-description
+    info: {
+      type: "alert",
+      alertType: "info",
+      content: `
+- The host must have a Pro, Business, or higher subscription plan.
+- For meetings - the host's Meeting Summary with AI Companion user setting must be enabled.
+- For webinars - the host's Webinar Summary with AI Companion user setting must be enabled.
+- End-to-End Encrypted (E2EE) meetings do not support summaries.
+
+Learn more about [enabling or disabling AI Companion meeting summaries](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0057960&_ics=1771446392860&irclickid=~ae~a521XQPMHICGKIJzGxnovBDKLGwCvzrhab340WULKDzsmda90).`,
+    },
+    meetingId: {
+      propDefinition: [
+        zoom,
+        "meetingId",
+        () => ({
+          type: "previous_meetings",
+        }),
+      ],
+      description: "The meeting ID or meeting UUID to retrieve the AI summary for. Only past meetings are listed.",
+      optional: false,
+    },
+  },
+  async run({ $: step }) {
+    const {
+      zoom,
+      meetingId,
+    } = this;
+
+    try {
+      const summary = await zoom.getMeetingSummary({
+        step,
+        meetingId,
+      });
+
+      step.export("$summary", `Successfully retrieved AI summary for meeting ${meetingId}`);
+      return summary;
+    } catch (error) {
+      const code = error?.response?.data?.code ?? error?.data?.code ?? error?.code;
+      if (code === 3322) {
+        throw new Error(`No AI summary found for meeting "${meetingId}". Ensure the meeting has ended and AI Companion was enabled before the meeting started.`);
+      }
+      throw error;
+    }
+  },
+};

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

@@ -1,10 +1,13 @@
+import {
+  axios, ConfigurationError,
+} from "@pipedream/platform";
 import zoom from "../../zoom.app.mjs";
 
 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.9",
+  description: "Get the transcript of a past meeting. Fetches the VTT file server-side using your OAuth token and returns speaker-attributed plain text alongside the original authenticated URL. [See the documentation](https://developers.zoom.us/docs/api/meetings/#tag/cloud-recording/get/meetings/{meetingId}/transcript)",
+  version: "0.1.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -21,17 +24,119 @@ export default {
           type: "previous_meetings",
         }),
       ],
-      description: "The meeting ID to get the transcript for",
+      description: "The ID of a past meeting to retrieve the transcript for. Only meetings with cloud recording and audio transcription enabled will have transcripts available.",
       optional: false,
     },
   },
+  methods: {
+    fetchTranscriptContent({
+      step, url,
+    }) {
+      return axios(step, {
+        url,
+        headers: this.zoom._getHeaders(),
+        responseType: "text",
+      });
+    },
+    parseVtt(vttContent) {
+      const normalized = vttContent
+        .replace(/\r\n/g, "\n")
+        .replace(/\r/g, "\n")
+        .trim();
+      const blocks = normalized.split(/\n{2,}/);
+      const result = [];
+      for (const block of blocks) {
+        const lines = block.trim().split("\n");
+        if (lines[0]?.trim().startsWith("WEBVTT")) continue;
+
+        const timestampIdx = lines.findIndex((l) => l.includes(" --> "));
+        if (timestampIdx === -1) continue;
+
+        const textLines = lines.slice(timestampIdx + 1);
+        if (!textLines.length) continue;
+
+        let currentSpeaker = null;
+        const textParts = textLines
+          .map((line) => {
+            const speakerMatch = line.match(/<v\s+([^>]+)>/);
+            if (speakerMatch) {
+              currentSpeaker = speakerMatch[1].trim();
+            }
+            const cleanText = line.replace(/<[^>]+>/g, "").trim();
+            if (!cleanText) {
+              return null;
+            }
+            return currentSpeaker
+              ? `${currentSpeaker}: ${cleanText}`
+              : cleanText;
+          })
+          .filter((t) => t);
+
+        if (!textParts.length) continue;
+
+        result.push(...textParts);
+      }
+      return result.join("\n");
+    },
+  },
   async run({ $: step }) {
-    const transcript = await this.zoom.getMeetingTranscript({
-      step,
-      meetingId: this.meetingId,
-    });
+    let transcriptResponse;
+    try {
+      transcriptResponse = await this.zoom.getMeetingTranscript({
+        step,
+        meetingId: this.meetingId,
+      });
+    } catch (error) {
+      if (error?.response?.status === 404 || error?.status === 404) {
+        throw new ConfigurationError(
+          "No recording found for this meeting. Ensure cloud recording was enabled before the meeting started.",
+        );
+      }
+      throw error;
+    }
+
+    const transcriptUrl = transcriptResponse?.download_url;
+    if (!transcriptUrl) {
+      throw new ConfigurationError(
+        "No transcript found for this meeting. Ensure audio transcription is enabled in the host's Zoom account settings before the meeting starts.",
+      );
+    }
+
+    let vttContent;
+    try {
+      vttContent = await this.fetchTranscriptContent({
+        step,
+        url: transcriptUrl,
+      });
+    } catch (error) {
+      if (error?.response?.status === 404 || error?.status === 404) {
+        throw new ConfigurationError(
+          transcriptUrl
+            ? "Transcript is still being processed. Please try again shortly."
+            : "Transcript file could not be retrieved. It may have expired or been deleted.",
+        );
+      }
+      throw error;
+    }
+
+    const trimmed = vttContent?.trim() ?? "";
+    if (!trimmed || trimmed === "WEBVTT") {
+      throw new ConfigurationError(
+        "Transcript is still being processed. Please try again shortly.",
+      );
+    }
+
+    const transcriptText = this.parseVtt(vttContent);
+    if (!transcriptText) {
+      throw new ConfigurationError(
+        "Transcript is still being processed. Please try again shortly.",
+      );
+    }
 
     step.export("$summary", `Retrieved transcript for meeting ${this.meetingId}`);
-    return transcript;
+    return {
+      transcript_url: transcriptUrl,
+      transcript_text: transcriptText,
+    };
   },
 };

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

@@ -0,0 +1,111 @@
+import constants from "../../common/constants.mjs";
+import zoom from "../../zoom.app.mjs";
+
+export default {
+  key: "zoom-list-all-recordings",
+  name: "List All Recordings",
+  description: "List all cloud recordings for a user. [See the documentation](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/recordingsList)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    zoom,
+    // eslint-disable-next-line pipedream/props-label, pipedream/props-description
+    info: {
+      type: "alert",
+      alertType: "info",
+      content: `
+- Must have a Pro or a higher plan.
+- Must enable Cloud Recording on the user's account. Learn more about [enabling cloud recordings](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0063923&_ics=1771436993341&irclickid=~ae~a521XQPMHICGKIJzGxnovBDKLGwCvzrhab3431UMLKGzsjgd6) and [managing cloud recording settings](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0065362&_ics=1771436993341&irclickid=~ae~a521XQPMHICGKIJzGxnovBDKLGwCvzrhab3431UMLKGzsjgd6).`,
+    },
+    userId: {
+      type: "string",
+      label: "User ID",
+      description: "The user ID or email address of the user. Use `me` to retrieve recordings for the current user.",
+      optional: true,
+      default: "me",
+    },
+    from: {
+      type: "string",
+      label: "From",
+      description: "Start date in `yyyy-MM-dd` UTC format. The maximum date range is a month. Defaults to the current date if not provided.",
+      optional: true,
+    },
+    to: {
+      type: "string",
+      label: "To",
+      description: "End date in `yyyy-MM-dd` UTC format.",
+      optional: true,
+    },
+    mc: {
+      type: "string",
+      label: "MC",
+      description: "Query metadata of recording if an On-Premise Meeting Connector was used for the meeting.",
+      optional: true,
+    },
+    trash: {
+      type: "boolean",
+      label: "Trash",
+      description: "If `true`, list recordings from trash.",
+      optional: true,
+    },
+    trashType: {
+      type: "string",
+      label: "Trash Type",
+      description: "The type of Cloud recording to retrieve from trash. Should be used together with **Trash**.",
+      optional: true,
+      options: constants.CLOUD_RECORD_TRASH_TYPE_OPTIONS,
+    },
+    max: {
+      propDefinition: [
+        zoom,
+        "max",
+      ],
+    },
+  },
+  async run({ $: step }) {
+    const {
+      userId,
+      from,
+      to,
+      mc,
+      trash,
+      trashType,
+      max,
+    } = this;
+
+    const recordings = [];
+
+    const results = this.zoom.getResourcesStream({
+      resourceFn: this.zoom.listRecordings,
+      resourceFnArgs: {
+        step,
+        userId: userId || "me",
+        params: {
+          page_size: 300,
+          from,
+          to,
+          mc,
+          trash,
+          trash_type: trashType,
+        },
+      },
+      resourceName: "meetings",
+      max,
+    });
+
+    for await (const recording of results) {
+      recordings.push(recording);
+    }
+
+    step.export("$summary", `Successfully retrieved ${recordings.length} recording${recordings.length === 1
+      ? ""
+      : "s"}`);
+
+    return recordings;
+  },
+};

package/common/constants.mjs

@@ -21,9 +21,21 @@ const MEETING_TYPES = [
   },
 ];
 
+const CLOUD_RECORD_TRASH_TYPE_OPTIONS = [
+  {
+    label: "List all meeting recordings from the trash",
+    value: "meeting_recordings",
+  },
+  {
+    label: "List all individual recording files from the trash",
+    value: "recording_file",
+  },
+];
+
 export default {
   BASE_URL,
   VERSION_PATH,
   MAX_RESOURCES,
   MEETING_TYPES,
+  CLOUD_RECORD_TRASH_TYPE_OPTIONS,
 };

package/package.json

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

package/zoom.app.mjs

@@ -323,9 +323,11 @@ export default {
         ...args,
       });
     },
-    listRecordings(args = {}) {
+    listRecordings({
+      userId = "me", ...args
+    } = {}) {
       return this._makeRequest({
-        path: "/users/me/recordings",
+        path: `/users/${userId}/recordings`,
         ...args,
       });
     },
@@ -391,6 +393,14 @@ export default {
         ...args,
       });
     },
+    getMeetingSummary({
+      meetingId, ...args
+    }) {
+      return this._makeRequest({
+        path: `/meetings/${utils.doubleEncode(meetingId)}/meeting_summary`,
+        ...args,
+      });
+    },
     async *getResourcesStream({
       resourceFn,
       resourceFnArgs,