Cloudinary usability improvements

components/acronis_cyber_protect_cloud/acronis_cyber_protect_cloud.app.mjs

@@ -8,4 +8,4 @@ export default {
       console.log(Object.keys(this.$auth));
     },
   },
-};
+};

components/bitdefender_gravityzone/bitdefender_gravityzone.app.mjs

@@ -8,4 +8,4 @@ export default {
       console.log(Object.keys(this.$auth));
     },
   },
-};
+};

components/cloudinary/actions/get-account-usage-details/get-account-usage-details.mjs

@@ -3,15 +3,20 @@
 export default {
   key: "cloudinary-get-account-usage-details",
   name: "Get Account Usage Details",
-  description: "Enables you to get a report on the status of your Cloudinary account usage details, including storage, credits, bandwidth, requests, number of resources, and add-on usage. [See the documentation](https://cloudinary.com/documentation/admin_api#usage)",
-  version: "0.1.2",
+  description: "Gets a report of your Cloudinary account usage details, including storage, credits, bandwidth, requests, number of resources, and add-on usage. [See the documentation](https://cloudinary.com/documentation/admin_api#usage)",
+  version: "0.2.0",
   type: "action",
   props: {
     cloudinary,
+    dateInfo: {
+      type: "alert",
+      alertType: "info",
+      content: "If `Date` is not specified, it defaults to the current date.",
+    },
     date: {
       type: "string",
       label: "Date",
-      description: "The date for the usage report. Must be within the last 3 months and given in the format: `dd-mm-yyyy`. Default: the current date",
+      description: "The date for the usage report, in the `yyyy-mm-dd` format, e.g. `2019-07-21`. Must be between yesterday and the last 3 months.",
       optional: true,
     },
   },
@@ -20,12 +25,17 @@
       date: this.date,
     };
 
-    const response = await this.cloudinary.getUsage(options);
+    try {
+      const response = await this.cloudinary.getUsage(options);
 
-    if (response) {
-      $.export("$summary", "Successfully retrieved usage details.");
-    }
+      if (response) {
+        $.export("$summary", "Successfully retrieved usage details");
+      }
 
-    return response;
+      return response;
+    }
+    catch (err) {
+      throw new Error(`Cloudinary error response: ${err.error?.message ?? JSON.stringify(err)}`);
+    }
   },
 };

components/cloudinary/actions/get-resources/get-resources.mjs

@@ -4,7 +4,7 @@ export default {
   key: "cloudinary-get-resources",
   name: "Get Resources",
   description: "Lists resources (assets) uploaded to your product environment. [See the documentation](https://cloudinary.com/documentation/admin_api#get_resources)",
-  version: "0.0.1",
+  version: "0.1.0",
   type: "action",
   props: {
     cloudinary,
@@ -22,28 +22,35 @@ export default {
     },
     prefix: {
       type: "string",
-      label: "Prefix",
-      description: "Find all assets with a public ID that starts with the specified prefix",
+      label: "Filter by Prefix",
+      description: "Find all assets with a public ID that starts with the specified prefix.",
       optional: true,
     },
     tags: {
       type: "boolean",
-      label: "Tags",
-      description: "Whether to include the list of tag names assigned to each asset",
+      label: "Include Tags",
+      description: "Whether to include the list of tag names assigned to each asset.",
       default: false,
       optional: true,
     },
     context: {
       type: "boolean",
-      label: "Context",
-      description: "Whether to include key-value pairs of contextual metadata associated with each asset",
+      label: "Include Context",
+      description: "Whether to include key-value pairs of contextual metadata associated with each asset.",
+      default: false,
+      optional: true,
+    },
+    metadata: {
+      type: "boolean",
+      label: "Include Metadata",
+      description: "Whether to include the structured metadata fields and values assigned to each asset.",
       default: false,
       optional: true,
     },
     moderation: {
       type: "boolean",
-      label: "Moderation",
-      description: "Whether to include the image moderation status of each asset",
+      label: "Include Moderation",
+      description: "Whether to include the image moderation status of each asset.",
       default: false,
       optional: true,
     },
@@ -66,22 +73,27 @@ export default {
     };
 
     const resources = [];
-    let next;
-    do {
-      const response = await this.cloudinary.getResources(options);
-      resources.push(...response.resources);
-      next = response.next_cursor;
-      options.next_cursor = next;
-    } while (next && resources.length < this.maxResults);
+    try {
+      let next;
+      do {
+        const response = await this.cloudinary.getResources(options);
+        resources.push(...response.resources);
+        next = response.next_cursor;
+        options.next_cursor = next;
+      } while (next && resources.length < this.maxResults);
 
-    if (resources.length > this.maxResults) {
-      resources.length = this.maxResults;
-    }
+      if (resources.length > this.maxResults) {
+        resources.length = this.maxResults;
+      }
 
-    $.export("$summary", `Found ${resources.length} resource${resources.length === 1
-      ? ""
-      : "s"}.`);
+      $.export("$summary", `Retrieved ${resources.length} resource${resources.length === 1
+        ? ""
+        : "s"}`);
 
-    return resources;
+      return resources;
+    }
+    catch (err) {
+      throw new Error(`Cloudinary error response: ${err.error?.message ?? JSON.stringify(err)}`);
+    }
   },
 };

components/cloudinary/actions/transform-resource/transform-resource.mjs

@@ -0,0 +1,65 @@
+import { ConfigurationError } from "@pipedream/platform";
+import cloudinary from "../../cloudinary.app.mjs";
+
+export default {
+  key: "cloudinary-transform-resource",
+  name: "Transform Resource",
+  description: "Transform an image, video or audio asset on-the-fly with several options. [See the documentation](https://cloudinary.com/documentation/video_manipulation_and_delivery)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    cloudinary,
+    assetId: {
+      propDefinition: [
+        cloudinary,
+        "assetId",
+      ],
+    },
+    info: {
+      type: "alert",
+      alertType: "info",
+      content: `You can either select a pre-configured transformation or pass a transformation string. Both can be managed in the [Cloudinary Transformation Builder](https://tx.cloudinary.com/).
+\\
+If both are specified, the transformation string will be ignored.`,
+    },
+    namedTransformation: {
+      propDefinition: [
+        cloudinary,
+        "namedTransformation",
+      ],
+    },
+    transformationString: {
+      propDefinition: [
+        cloudinary,
+        "transformationString",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const {
+      cloudinary, assetId, namedTransformation, transformationString,
+    } = this;
+
+    if (!namedTransformation && !transformationString) {
+      throw new ConfigurationError("Either `Named Transformation` or `Transformation String` are required");
+    }
+
+    try {
+      const response = await cloudinary.transformAsset(assetId, namedTransformation
+        ? {
+          transformation: namedTransformation,
+        }
+        : {
+          raw_transformation: transformationString,
+        });
+
+      if (response) {
+        $.export("$summary", "Successfully transformed resource");
+      }
+
+      return response;
+    } catch (err) {
+      throw new Error(`Cloudinary error response: ${err.error?.message ?? JSON.stringify(err)}`);
+    }
+  },
+};