@pipedream/zoom 0.10.2 → 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/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.2",
+  "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,