Configure file stash sync for Zoho CRM components (#17267)

Add dir props to the Zoho CRM Download Attachment and Upload Attachment
actions to indicate that a stash ID should be passed when running these
actions via the Connect API. This allows files written to the ephemeral
/tmp directory in one action to be read by another, separately executed
action since both can sync /tmp with the same File Stash directory.

The prop is optional in the Zoho CRM Upload Attachment action since the
file reference used as input can be a file URL rather than local file
path. If a file URL is used, then the /tmp <-> File Stash sync is not
needed and a stash ID is not required.

The prop is also optional in the Zoho CRM Download Attachment action
since the file content is returned directly from the `run` method of the
action, in addition to being written to a file. So the action can be
used in Connect without persisting the file for later use.

Author: js07

components/zoho_crm/actions/download-attachment/download-attachment.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoho_crm-download-attachment",
   name: "Download Attachment",
   description: "Downloads an attachment file from Zoho CRM, saves it in the temporary file system and exports the file path for use in a future step.",
-  version: "0.2.1",
+  version: "0.2.2",
   type: "action",
   props: {
     zohoCrm,
@@ -34,6 +34,16 @@ export default {
         }),
       ],
     },
+    // This prop indicates that the otherwise ephemeral /tmp directory is automatically synced to a
+    // remote directory (if configured for the execution context), making files written by this
+    // action accessible for future executions.  Only files located in STASH_DIR or, for legacy
+    // action support, whose /tmp file paths are explicitly returned by `run` will be synced.
+    syncDir: {
+      type: "dir",
+      accessMode: "write",
+      sync: true,
+      optional: true,
+    },
   },
   async run({ $ }) {
     const file = await this.zohoCrm.downloadAttachment(
@@ -43,7 +53,7 @@ export default {
       $,
     );
 
-    const filePath = "/tmp/" + this.attachmentId;
+    const filePath = (process.env.STASH_DIR || "/tmp") + "/" + this.attachmentId;
     fs.writeFileSync(filePath, file);
 
     $.export("$summary", "Successfully downloaded attachment");

components/zoho_crm/actions/upload-attachment/upload-attachment.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoho_crm-upload-attachment",
   name: "Upload Attachment",
   description: "Uploads an attachment file to Zoho CRM from a URL or file path. [See the documentation](https://www.zoho.com/crm/developer/docs/api/v3/upload-attachment.html)",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "action",
   props: {
     zohoCrm,
@@ -30,6 +30,15 @@ export default {
       label: "File Path or URL",
       description: "The file to upload. Provide either a file URL or a path to a file in the `/tmp` directory (for example, `/tmp/myFile.txt`)",
     },
+    // This prop indicates that a remote directory (if configured for the execution context) is
+    // automatically synced to the /tmp directory before the action runs, making files in that
+    // directory accessible for use in this action via the file system.
+    syncDir: {
+      type: "dir",
+      accessMode: "read",
+      sync: true,
+      optional: true,
+    },
   },
   async run({ $ }) {
     const data = new FormData();

components/zoho_crm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/zoho_crm",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Pipedream Zoho CRM Components",
   "main": "zoho_crm.app.mjs",
   "keywords": [