Improvements to transformation options

Author: GTFalcao

components/cloudinary/actions/resource-transformation/resource-transformation.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)}`);
+    }
+  },
+};

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

@@ -62,6 +62,31 @@ export default {
       label: "Additional Transformations",
       description: "Additional transformations to apply to the resource. [See the documentation](https://cloudinary.com/documentation/transformation_reference) for all available transformations. Example: `{ \"angle\": 90, \"color_space\": \"srgb\"}`",
     },
+    transformationString: {
+      type: "string",
+      label: "Transformation String",
+      description: "A string representing the transformation to apply to the resource. You can use the [Cloudinary Transformation Builder](https://tx.cloudinary.com/) to create and preview the transformation, then copy the string here. Example: `c_fill,h_500,w_500` is the transformation string in the URL `https://res.cloudinary.com/demo/video/upload/c_fill,h_500,w_500/samples/cld-sample-video.mp4`",
+      optional: true,
+    },
+    namedTransformation: {
+      type: "string",
+      label: "Named Transformation",
+      description: "Select a pre-configured named transformation to apply to the resource. You can create and manage transformations in the [Cloudinary Transformation Builder](https://tx.cloudinary.com).",
+      optional: true,
+      async options({ prevContext: { cursor } }) {
+        const {
+          transformations, next_cursor,
+        } = await this.getTransformations({
+          next_cursor: cursor,
+        });
+        return {
+          options: transformations?.filter?.((t) => t.named).map((t) => t.name.replace(/^t_/, "")),
+          context: {
+            cursor: next_cursor,
+          },
+        };
+      },
+    },
   },
   methods: {
     _client() {
@@ -85,5 +110,8 @@ export default {
     async uploadMedia(file, options) {
       return this._client().uploader.upload(file, options);
     },
+    async getTransformations(args) {
+      return this._client().api.transformations(args);
+    },
   },
 };