@pipedream/dropbox 0.3.18 → 0.3.20

package/README.md

@@ -1,15 +1,11 @@
 # Overview
 
-With the Dropbox API, you can build a variety of applications that range from
-simple file sharing to complex content management systems. Some examples of
-what you can build using the Dropbox API include:
-
-- A file sharing application that allows users to share and sync files across
-  devices
-- A content management system that allows users to manage and share files and
-  folders
-- A note taking application that allows users to sync notes across devices
-- A task management application that allows users to manage and share tasks and
-  files
-- A document management application that allows users to manage and share
-  documents and files
+The Dropbox API on Pipedream enables you to automate file and folder operations, streamlining workflows that involve storing, syncing, and sharing content. With this API, you can programmatically manage files, set up event-driven triggers based on changes within Dropbox, and leverage Pipedream's capabilities to connect with hundreds of other apps for extended automation scenarios. It's ideal for building custom file management solutions, archiving systems, or collaborative content workflows without writing extensive code.
+
+# Example Use Cases
+
+- **Automated Backup to Dropbox**: Whenever a new file is uploaded to an FTP server, trigger a Pipedream workflow that automatically uploads this file to a specified Dropbox folder. This can serve as an off-site backup system for important documents or media files, ensuring they are safe and accessible from anywhere.
+
+- **Content Approval Workflow**: Create a system where new files added to a specific Dropbox folder trigger a Pipedream workflow, sending an approval request via Slack to a designated approver. Once the approver responds with approval, the workflow moves the file to a 'Published' folder within Dropbox, or if rejected, sends a notification back to the submitter with feedback.
+
+- **Dropbox to Google Sheets Logging**: Every time a new file is added to a Dropbox folder, a Pipedream workflow extracts relevant metadata (like filename, size, and upload date) and appends it to a Google Sheets spreadsheet. This creates an ongoing log for tracking uploads, which is particularly useful for teams needing to maintain records of content updates and revisions.

package/actions/create-a-text-file/create-a-text-file.mjs

@@ -2,23 +2,26 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "Create a Text File",
-  description: "Creates a brand new text file from plain text content you specify. [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesUpload__anchor)",
+  description: "Creates a brand new text file from plain text content you specify. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesUpload__anchor)",
   key: "dropbox-create-a-text-file",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     name: {
       type: "string",
-      label: "File name",
-      description: "Your new file name.",
+      label: "File Name",
+      description: "Your new file name. Example: `textfile.txt`",
     },
     path: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
-      description: "The file path in the user's Dropbox to create the file. If not filled, it will be created in the root folder.",
+      description: "Type the folder name to search for it in the user's Dropbox. If not filled, it will be created in the root folder.",
     },
     content: {
       type: "string",
@@ -33,9 +36,13 @@ export default {
       path,
     } = this;
 
+    const filename = name.includes(".txt")
+      ? name
+      : `${name}.txt`;
+
     const res = await this.dropbox.uploadFile({
       contents: Buffer.from(content),
-      path: this.dropbox.getNormalizedPath(path, true) + name,
+      path: this.dropbox.getNormalizedPath(path, true) + filename,
       autorename: true,
     });
 

package/actions/create-folder/create-folder.mjs

@@ -2,24 +2,27 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "Create folder",
-  description: "Create a folder. [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesCreateFolderV2__anchor)",
+  description: "Create a Folder. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesCreateFolderV2__anchor)",
   key: "dropbox-create-folder",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     name: {
       type: "string",
-      label: "Folder name",
+      label: "Folder Name",
       description: "Your new folder name.",
     },
     path: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
       optional: true,
-      description: "The file path in the user's Dropbox to create the folder. If not filled, it will be created in the root folder.",
+      description: "Type the folder name to search for it in the user's Dropbox. If not filled, it will be created in the root folder.",
     },
     autorename: {
       type: "boolean",

package/actions/create-or-append-to-a-text-file/create-or-append-to-a-text-file.mjs

@@ -2,24 +2,27 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "Create or Append to a Text File",
-  description: "Adds a new line to an existing text file, or creates a file if it doesn't exist. [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesUpload__anchor)",
+  description: "Adds a new line to an existing text file, or creates a file if it doesn't exist. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesUpload__anchor)",
   key: "dropbox-create-or-append-to-a-text-file",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     name: {
       type: "string",
-      label: "File name",
+      label: "File Name",
       description: "Your new file name",
     },
     path: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
       optional: true,
-      description: "The file path in the user's Dropbox to create the file. If not filled, it will be created in the root folder.",
+      description: "Type the folder name to search for it in the user's Dropbox. If not filled, it will be created in the root folder.",
     },
     content: {
       type: "string",

package/actions/create-update-share-link/common.mjs

@@ -0,0 +1,10 @@
+import dropbox from "../../dropbox.app.mjs";
+
+export default {
+  props: {
+    dropbox: {
+      ...dropbox,
+      reloadProps: true,
+    },
+  },
+};

package/actions/create-update-share-link/create-update-share-link.mjs

@@ -1,60 +1,80 @@
-import dropbox from "../../dropbox.app.mjs";
+import common from "./common.mjs";
 import consts from "../../common/consts.mjs";
 
 export default {
   name: "Create/Update a Share Link",
-  description: "Creates or updates a public share link to the file or folder (It allows to share the file or folder with anyone). [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#sharingCreateSharedLinkWithSettings__anchor)",
+  description: "Creates or updates a public share link to the file or folder (It allows you to share the file or folder with anyone). [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#sharingCreateSharedLinkWithSettings__anchor)",
   key: "dropbox-create-update-share-link",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
-    dropbox,
+    ...common.props,
+    alert: {
+      type: "alert",
+      alertType: "warning",
+      content: `Dropbox Free and Basic users are able to create a publicly-available share link which allows downloads.
+        \nIn order to utilize advanced link sharing functionality, you must be on a Dropbox Essentials plan or higher. See the Dropbox pricing [page](https://www.dropbox.com/plans?trigger=nr#:~:text=Collaborative%20sharing) for more details.`,
+    },
     path: {
       propDefinition: [
-        dropbox,
-        "pathFileFolder",
+        common.props.dropbox,
+        "path",
         () => ({
-          omitRootFolder: true,
+          initialOptions: [],
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => [
+            "file",
+            "folder",
+          ].includes(type),
         }),
       ],
-      description: "The path to be shared by the shared link.",
-    },
-    requirePassword: {
-      type: "boolean",
-      label: "Require password",
-      description: "Boolean flag to enable or disable password protection.",
-      default: false,
-    },
-    linkPassword: {
-      type: "string",
-      label: "Link password",
-      description: "If `require_password` is `true`, this is needed to specify the password to access the link.",
-      optional: true,
-    },
-    allowDownload: {
-      type: "boolean",
-      label: "Allow downloads",
-      description: "Boolean flag to allow or not allow capabilities for shared links.",
+      description: "Type the file or folder name to search for it in the user's Dropbox.",
     },
-    expires: {
-      type: "string",
-      label: "Expires",
-      description: "Expiration time of the shared link. By default the link never expires. Make sure to use a valid [timestamp](https://dropbox.github.io/dropbox-sdk-js/global.html#Timestamp) value.",
-      optional: true,
-    },
-    audience: {
-      type: "string",
-      label: "Audience",
-      description: "The new audience who can benefit from the access level specified by the link's access level specified in the `link_access_level` field of `LinkPermissions`. This is used in conjunction with team policies and shared folder policies to determine the final effective audience type in the `effective_audience` field of `LinkPermissions.",
-      optional: true,
-      options: consts.CREATE_SHARED_LINK_AUDIENCE_OPTIONS,
-    },
-    access: {
-      type: "string",
-      label: "Access",
-      description: "Requested access level you want the audience to gain from this link. Note, modifying access level for an existing link is not supported.",
-      optional: true,
-      options: consts.CREATE_SHARED_LINK_ACCESS_OPTIONS,
+  },
+  async additionalProps() {
+    const props = {};
+
+    const accountType = await this.getCurrentAccount();
+    if (accountType !== "basic") {
+      props.requirePassword = {
+        type: "boolean",
+        label: "Require Password",
+        description: "Boolean flag to enable or disable password protection.",
+        default: false,
+        reloadProps: true,
+      };
+      props.linkPassword = {
+        type: "string",
+        label: "Link Password",
+        description: "If `require_password` is `true`, this is needed to specify the password to access the link.",
+        hidden: !this.requirePassword,
+      };
+      props.allowDownload = {
+        type: "boolean",
+        label: "Allow Downloads",
+        description: "Boolean flag to allow or not allow capabilities for shared links.",
+      };
+      props.expires = {
+        type: "string",
+        label: "Expires",
+        description: "Expiration time of the shared link. By default the link never expires. Make sure to use a valid [timestamp](https://dropbox.github.io/dropbox-sdk-js/global.html#Timestamp) value. Example: `2024-07-18T20:00:00Z`",
+        optional: true,
+      };
+      props.access = {
+        type: "string",
+        label: "Access",
+        description: "Requested access level you want the audience to gain from this link. Note, modifying access level for an existing link is not supported.",
+        optional: true,
+        options: consts.CREATE_SHARED_LINK_ACCESS_OPTIONS,
+      };
+    }
+
+    return props;
+  },
+  methods: {
+    async getCurrentAccount() {
+      const dpx = await this.dropbox.sdk();
+      const { result: { account_type: accountType } } = await dpx.usersGetCurrentAccount();
+      return accountType[".tag"];
     },
   },
   async run({ $ }) {
@@ -63,29 +83,31 @@ export default {
       requirePassword,
       linkPassword,
       expires,
-      audience,
       access,
-      requestedVisibility,
-      allowDownload,
-      removeExpiration,
     } = this;
 
+    const accountType = await this.getCurrentAccount();
+    const allowDownload = accountType === "basic"
+      ? true
+      : this.allowDownload;
+
     if (requirePassword && !linkPassword) {
       throw new Error("Since the password is required, please add a linkPassword");
     }
 
+    if (expires && Date.parse(expires) < Date.now()) {
+      throw new Error("Expire date must be later than the current datetime");
+    }
+
     const res = await this.dropbox.createSharedLink({
       path: this.dropbox.getPath(path),
       settings: {
         require_password: requirePassword,
         link_password: linkPassword,
         expires,
-        audience,
         access,
-        requested_visibility: requestedVisibility,
         allow_download: allowDownload,
       },
-      remove_expiration: removeExpiration,
     });
     $.export("$summary", `Shared link for "${path?.label || path}" successfully created`);
     return res;

package/actions/delete-file-folder/delete-file-folder.mjs

@@ -2,21 +2,25 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "Delete a File/Folder",
-  description: "Permanently removes a file/folder from the server. [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesDeleteV2__anchor)",
+  description: "Permanently removes a file/folder from the server. [See documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesDeleteV2__anchor)",
   key: "dropbox-delete-file-folder",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     path: {
       propDefinition: [
         dropbox,
-        "pathFileFolder",
+        "path",
         () => ({
-          omitRootFolder: true,
+          initialOptions: [],
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => [
+            "file",
+            "folder",
+          ].includes(type),
         }),
       ],
-      description: "Path in the user's Dropbox to delete.",
+      description: "Type the file or folder name to search for it in the user's Dropbox.",
     },
   },
   async run({ $ }) {

package/actions/download-file-to-tmp/download-file-to-tmp.mjs

@@ -6,20 +6,22 @@ export default {
   name: "Download File to TMP",
   description: "Download a specific file to the temporary directory. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesDownload__anchor).",
   key: "dropbox-download-file-to-tmp",
-  version: "0.0.4",
+  version: "0.0.6",
   type: "action",
   props: {
     dropbox,
     path: {
       propDefinition: [
         dropbox,
-        "pathFile",
+        "path",
+        () => ({
+          initialOptions: [],
+        }),
       ],
-      description: "The file path in the user's Dropbox to download.",
     },
     name: {
       type: "string",
-      label: "File name",
+      label: "File Name",
       description: "The new name of the file to be saved, including it's extension. e.g: `myFile.csv`",
       optional: true,
     },
@@ -33,16 +35,18 @@ export default {
       path, cleanup,
     } = await file();
 
+    const extension = result.name.split(".").pop();
+
     const tmpPath = this.name
       ? `/tmp/${this.name}`
-      : path;
+      : `${path}.${extension}`;
 
     await fs.promises.appendFile(tmpPath, Buffer.from(result.fileBinary));
     await cleanup();
 
     delete result.fileBinary;
 
-    $.export("$summary", `File successfully saved in "/tmp/${this.name}"`);
+    $.export("$summary", `File successfully saved in "${tmpPath}"`);
 
     return {
       tmpPath,

package/actions/list-file-folders-in-a-folder/list-file-folders-in-a-folder.mjs

@@ -2,18 +2,22 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "List All Files/Subfolders in a Folder",
-  description: "Retrieves a list of files or subfolders in a specified folder [See the docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesListFolder__anchor)",
+  description: "Retrieves a list of files or subfolders in a specified folder [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesListFolder__anchor)",
   key: "dropbox-list-file-folders-in-a-folder",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     path: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          initialOptions: [],
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
-      description: "Scopes the search to a path in the user's Dropbox.",
+      description: "Type the folder name to search for it in the user's Dropbox.",
     },
     recursive: {
       type: "boolean",
@@ -23,7 +27,7 @@ export default {
     },
     includeDeleted: {
       type: "boolean",
-      label: "Include deleted",
+      label: "Include Deleted",
       description: "If `true`, the results will include files and folders that used to exist but were deleted.",
       default: false,
     },

package/actions/list-file-revisions/list-file-revisions.mjs

@@ -3,23 +3,25 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "List File Revisions",
-  description: "Retrieves a list of file revisions needed to recover previous content. [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesListRevisions__anchor)",
+  description: "Retrieves a list of file revisions needed to recover previous content. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesListRevisions__anchor)",
   key: "dropbox-list-file-revisions",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     path: {
       propDefinition: [
         dropbox,
-        "pathFile",
+        "path",
+        () => ({
+          initialOptions: [],
+        }),
       ],
-      description: "The file path for the file whose revisions you'd like to list.",
     },
     mode: {
       type: "string",
       label: "Mode",
-      description: "Determines the behavior of the API in listing the revisions for a given file path or id.",
+      description: "Determines the behavior of the API in listing the revisions for a given file path or id. In `path` (default) mode, all revisions at the same file path as the latest file entry are returned. If revisions with the same file id are desired, then mode must be set to `id`.",
       optional: true,
       options: consts.LIST_FILE_REVISIONS_OPTIONS,
     },

package/actions/move-file-folder/move-file-folder.mjs

@@ -2,30 +2,37 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "Move a File/Folder",
-  description: "Moves a file or folder to a different location in the user's Dropbox [See the docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesMoveV2__anchor)",
+  description: "Moves a file or folder to a different location in the user's Dropbox [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesMoveV2__anchor)",
   key: "dropbox-move-file-folder",
-  version: "0.0.9",
+  version: "0.0.11",
   type: "action",
   props: {
     dropbox,
     pathFrom: {
       propDefinition: [
         dropbox,
-        "pathFileFolder",
+        "path",
         () => ({
-          omitRootFolder: true,
+          initialOptions: [],
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => [
+            "file",
+            "folder",
+          ].includes(type),
         }),
       ],
-      label: "Path from",
-      description: "The file/folder that you want to move.",
+      label: "Path From",
+      description: "Type the file or folder name to search for it in the user's Dropbox.",
     },
     pathTo: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
-      label: "Path to",
-      description: "The new path of your file/folder",
+      label: "Path To",
+      description: "Type the folder name to search for it in the user's Dropbox.",
     },
     autorename: {
       type: "boolean",
@@ -35,7 +42,7 @@ export default {
     },
     allowOwnershipTransfer: {
       type: "boolean",
-      label: "Allow ownership transfer",
+      label: "Allow Ownership Transfer",
       description: "Allow moves by owner even if it would result in an ownership transfer for the content being moved. This does not apply to copies.",
       optional: true,
     },

package/actions/rename-file-folder/rename-file-folder.mjs

@@ -2,22 +2,26 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "Rename a File/Folder",
-  description: "Renames a file or folder in the user's Dropbox [See the docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesMoveV2__anchor)",
+  description: "Renames a file or folder in the user's Dropbox [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesMoveV2__anchor)",
   key: "dropbox-rename-file-folder",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     pathFrom: {
       propDefinition: [
         dropbox,
-        "pathFileFolder",
+        "path",
         () => ({
-          omitRootFolder: true,
+          initialOptions: [],
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => [
+            "file",
+            "folder",
+          ].includes(type),
         }),
       ],
       label: "Path From",
-      description: "The file that you want to rename.",
+      description: "Type the file or folder name to search for it in the user's Dropbox.",
     },
     newName: {
       type: "string",

package/actions/restore-a-file/restore-a-file.mjs

@@ -2,21 +2,21 @@ import dropbox from "../../dropbox.app.mjs";
 
 export default {
   name: "Restore a File",
-  description: "Restores a previous file version. [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesRestore__anchor)",
+  description: "Restores a previous file version. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesRestore__anchor)",
   key: "dropbox-restore-a-file",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
     path: {
       propDefinition: [
         dropbox,
-        "pathFile",
+        "path",
         () => ({
-          omitRootFolder: true,
+          initialOptions: [],
         }),
       ],
-      description: "The path to save the restored file.",
+      description: "Type the file name to search for it in the user's Dropbox.",
     },
     rev: {
       propDefinition: [

package/actions/search-files-folders/search-files-folders.mjs

@@ -4,9 +4,9 @@ import consts from "../../common/consts.mjs";
 
 export default {
   name: "Search files and folders",
-  description: "Searches for files and folders by name. [See the docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesSearchV2__anchor)",
+  description: "Searches for files and folders by name. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesSearchV2__anchor)",
   key: "dropbox-search-files-folders",
-  version: "0.0.8",
+  version: "0.0.10",
   type: "action",
   props: {
     dropbox,
@@ -19,47 +19,49 @@ export default {
     path: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
-      optional: true,
-      description: "Scopes the search to a path in the user's Dropbox. Searches the entire Dropbox if not specified.",
+      description: "Type the folder name to search for it in the user's Dropbox.",
     },
     orderBy: {
       type: "string",
-      label: "Order by",
+      label: "Order By",
       description: "By default, results are sorted by relevance.",
       optional: true,
       options: consts.SEARCH_FILE_FOLDER_ORDER_BY_OPTIONS,
     },
     fileStatus: {
       type: "string",
-      label: "File status",
+      label: "File Status",
       description: "Restricts search to the given file status.",
       optional: true,
       options: consts.SEARCH_FILE_FOLDER_STATUS_OPTIONS,
     },
     filenameOnly: {
       type: "boolean",
-      label: "Filename only",
+      label: "Filename Only",
       description: "Restricts search to only match on filenames.",
       optional: true,
     },
     fileCategories: {
       type: "string[]",
-      label: "File categories",
+      label: "File Categories",
       description: "Restricts search to only the file categories specified. Only supported for active file search.",
       optional: true,
       options: consts.FILES_CATEGORIES_OPTIONS,
     },
     fileExtensions: {
       type: "string[]",
-      label: "File extensions",
+      label: "File Extensions",
       description: "Restricts search to only the extensions specified. Only supported for active file search.",
       optional: true,
     },
     includeHighlights: {
       type: "boolean",
-      label: "Include highlights",
+      label: "Include Highlights",
       description: "Whether to include highlight span from file title.",
       optional: true,
     },

package/actions/upload-file/upload-file.mjs

@@ -2,26 +2,30 @@ import dropbox from "../../dropbox.app.mjs";
 import consts from "../../common/consts.mjs";
 import fs from "fs";
 import got from "got";
+import { ConfigurationError } from "@pipedream/platform";
 
 export default {
   name: "Upload a File",
-  description: "Uploads a file to a selected folder. [See docs here](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesUpload__anchor)",
+  description: "Uploads a file to a selected folder. [See the documentation](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesUpload__anchor)",
   key: "dropbox-upload-file",
-  version: "0.0.11",
+  version: "0.0.13",
   type: "action",
   props: {
     dropbox,
     path: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
-      description: "The file path in the user's Dropbox to create the file. If not filled, it will be created in the root folder.",
+      description: "Type the folder name to search for it in the user's Dropbox. If not filled, it will be created in the root folder.",
     },
     name: {
       type: "string",
-      label: "File name",
-      description: "The name of your new file.",
+      label: "File Name",
+      description: "The name of your new file (make sure to include the file extension).",
     },
     fileUrl: {
       type: "string",
@@ -74,6 +78,10 @@ export default {
       clientModified,
     } = this;
 
+    if (!fileUrl && !filePath) {
+      throw new ConfigurationError("Must specify either File URL or File Path.");
+    }
+
     const contents = fileUrl
       ? await got.stream(fileUrl)
       : fs.createReadStream(filePath);

package/common/config.mjs

@@ -1,6 +1,6 @@
 export default {
   SEARCH_FILE_FOLDERS: {
-    DEFAULT_MAX_RESULTS: 100,
+    DEFAULT_MAX_RESULTS: 1000,
   },
   LIST_FILES_IN_FOLDER: {
     DEFAULT_MAX_RESULTS: 100,

package/common/consts.mjs

@@ -23,7 +23,6 @@ export default {
   LIST_FILE_REVISIONS_OPTIONS: [
     "path",
     "id",
-    "other",
   ],
   CREATE_SHARED_LINK_AUDIENCE_OPTIONS: [
     "public",
@@ -34,10 +33,22 @@ export default {
     "other",
   ],
   CREATE_SHARED_LINK_ACCESS_OPTIONS: [
-    "viewer",
-    "editor",
-    "max",
-    "other",
+    {
+      value: "viewer",
+      label: "Users who use the link can view and comment on the content",
+    },
+    {
+      value: "editor",
+      label: "Users who use the link can edit, view and comment on the content. Note, not all file types support edit links yet.",
+    },
+    {
+      value: "max",
+      label: "Request for the maximum access level you can set the link to",
+    },
+    {
+      value: "default",
+      label: "Request for the default access level the user has set",
+    },
   ],
   CREATE_SHARED_LINK_REQUESTED_VISIBILITY_OPTIONS: [
     "public",

package/dropbox.app.mjs

@@ -12,78 +12,90 @@ export default {
   type: "app",
   app: "dropbox",
   propDefinitions: {
-    pathFolder: {
+    path: {
       type: "string",
       label: "Path",
-      description: "The folder path. (Please use a valid path to filter the values and type at least 2 characters after the latest '/' to perform the search.)",
+      description: "Type the file name to search for it in the user's Dropbox.",
       useQuery: true,
       withLabel: true,
       async options({
-        prevContext,
-        query,
-        returnSimpleString,
-        omitRootFolder,
-      }) {
-        if (prevContext?.reachedLastPage) {
-          return [];
-        }
-        return this.getPathOptions(
-          query,
+        query, prevContext: { cursor },
+        params,
+        initialOptions = [
           {
-            omitFiles: true,
-            returnSimpleString,
-            omitRootFolder,
+            label: "Root Folder",
+            value: "",
           },
-        );
-      },
-    },
-    pathFile: {
-      type: "string",
-      label: "Path",
-      description: "The file path. (Please use a valid path to filter the values)",
-      useQuery: true,
-      withLabel: true,
-      async options({
-        prevContext,
-        query,
-        returnSimpleString,
-        omitRootFolder,
+        ],
+        filter = ({ metadata: { metadata: { [".tag"]: type } } }) => type === "file",
+        mapper = ({ metadata: { metadata } }) => ({
+          label: metadata.path_display,
+          value: metadata.path_lower,
+        }),
       }) {
-        if (prevContext?.reachedLastPage) {
-          return [];
-        }
-        return this.getPathOptions(
-          query,
-          {
-            omitFolders: true,
-            returnSimpleString,
-            omitRootFolder,
-          },
-        );
-      },
-    },
-    pathFileFolder: {
-      type: "string",
-      label: "Path",
-      description: "The file or folder path. (Please use a valid path to filter the values)",
-      useQuery: true,
-      withLabel: true,
-      async options({
-        prevContext,
-        query,
-        returnSimpleString,
-        omitRootFolder,
-      }) {
-        if (prevContext?.reachedLastPage) {
+        try {
+          const dpx = await this.sdk();
+
+          if (cursor === null) {
+            return [];
+          }
+
+          if (cursor) {
+            const {
+              result: {
+                matches,
+                cursor: nextCursor,
+                has_more: hasMore,
+              },
+            } = await dpx.filesSearchContinueV2({
+              cursor,
+            });
+
+            return {
+              options: matches
+                .filter(filter)
+                .map(mapper),
+              context: {
+                cursor: hasMore
+                  ? nextCursor
+                  : null,
+              },
+            };
+          }
+
+          const {
+            result: {
+              matches,
+              cursor: nextCursor,
+              has_more: hasMore,
+            },
+          } = await dpx.filesSearchV2({
+            ...params,
+            query: query || "text",
+            options: {
+              path: params?.path || "",
+              max_results: config.SEARCH_FILE_FOLDERS.DEFAULT_MAX_RESULTS,
+              ...params?.options,
+            },
+          });
+
+          return {
+            options: initialOptions.concat(
+              matches
+                .filter(filter)
+                .map(mapper),
+            ),
+            context: {
+              cursor: hasMore
+                ? nextCursor
+                : null,
+            },
+          };
+
+        } catch (error) {
+          console.log("Error searching for files/folders", error);
           return [];
         }
-        return this.getPathOptions(
-          query,
-          {
-            returnSimpleString,
-            omitRootFolder,
-          },
-        );
       },
     },
     fileRevision: {
@@ -178,7 +190,7 @@ export default {
         const revisions = await dpx.filesListRevisions({
           path,
           mode: {
-            ".tag": "id",
+            ".tag": "path",
           },
         });
         return revisions.result?.entries?.map((revision) => ({
@@ -189,106 +201,6 @@ export default {
         this.normalizeError(err);
       }
     },
-    async getPathOptions(path, opts = {}) {
-      try {
-        const {
-          omitFolders,
-          omitFiles,
-          omitRootFolder,
-        } = opts;
-
-        let data = [];
-        path = path === "/" || path === null
-          ? ""
-          : path;
-
-        if (path.length > 0 && !path.startsWith("/")) {
-          path = "/" + path;
-        }
-
-        if (path === "") {
-          const entries = await this.listFilesFolders({
-            path,
-            recursive: true,
-            include_mounted_folders: true,
-          });
-
-          data = entries.map((item) => ({
-            path: item.path_display,
-            type: item[".tag"],
-          }));
-
-        } else {
-          let subpath = "";
-          let query = path;
-          if ((path.match(/\//g) || []).length > 1) {
-            const splitPath = path.split("/");
-            query = splitPath.pop();
-            subpath = splitPath.join("/");
-          }
-          const res = await this.searchFilesFolders({
-            query,
-            options: {
-              path: subpath,
-            },
-          });
-
-          data = res.map(({ metadata }) => ({
-            path: metadata.metadata.path_display,
-            type: metadata.metadata[".tag"],
-          }));
-
-          const folders = data.filter((item) => item.type !== "file");
-          for (const folder of folders) {
-            const entries = await this.listFilesFolders({
-              path: folder.path,
-              recursive: true,
-              include_mounted_folders: true,
-            });
-            const folderData = entries?.map((item) => ({
-              path: item.path_display,
-              type: item[".tag"],
-            }));
-            data.push(...folderData);
-          }
-        }
-
-        if (omitFiles) {
-          data = data.filter((item) => item.type !== "file");
-        }
-
-        if (omitFolders) {
-          data = data.filter((item) => item.type !== "folder");
-        }
-
-        data = data.map((item) => ({
-          label: item.path,
-          value: item.path,
-        }));
-
-        if (path === "" && !omitFolders && !omitRootFolder) {
-          data = [
-            {
-              label: "Root Folder",
-              value: "",
-            },
-            ...data,
-          ];
-        }
-
-        data.sort((a, b) => {
-          return a > b ?
-            1 :
-            -1;
-        });
-
-        return data;
-
-      } catch (err) {
-        console.log(err);
-        return [];
-      }
-    },
     async initState(context) {
       const {
         path,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/dropbox",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "description": "Pipedream Dropbox Components",
   "main": "dropbox.app.mjs",
   "keywords": [

package/sources/all-updates/all-updates.mjs

@@ -1,4 +1,5 @@
 import common from "../common/common.mjs";
+import sampleEmit from "./test-event.mjs";
 
 export default {
   ...common,
@@ -6,7 +7,7 @@ export default {
   type: "source",
   key: "dropbox-all-updates",
   name: "New or Modified File or Folder",
-  version: "0.0.15",
+  version: "0.0.17",
   description: "Emit new event when a file or folder is added or modified. Make sure the number of files/folders in the watched folder does not exceed 4000.",
   props: {
     ...common.props,
@@ -25,14 +26,20 @@ export default {
   },
   hooks: {
     async activate() {
-      await this.getHistoricalEvents([
-        "file",
-        "folder",
-      ]);
+      await this.getHistoricalEvents(this.getFileTypes());
       const state = await this.dropbox.initState(this);
       this._setDropboxState(state);
     },
   },
+  methods: {
+    ...common.methods,
+    getFileTypes() {
+      return [
+        "file",
+        "folder",
+      ];
+    },
+  },
   async run() {
     const state = this._getDropboxState();
     const {
@@ -43,10 +50,14 @@ export default {
       let file = {
         ...update,
       };
-      if (this.includeMediaInfo) {
+      const fileTypes = this.getFileTypes();
+      if (!fileTypes.includes(file[".tag"])) {
+        continue;
+      }
+      if (this.includeMediaInfo && file[".tag"] === "file") {
         file = await this.getMediaInfo(update);
       }
-      if (this.includeLink) {
+      if (this.includeLink && file[".tag"] === "file") {
         file.link = await this.getTemporaryLink(update);
       }
       // new unique identification from merging the file id and the last file revision
@@ -56,4 +67,5 @@ export default {
       this.$emit(file, this.getMeta(id, file.path_display || file.id));
     }
   },
+  sampleEmit,
 };

package/sources/all-updates/test-event.mjs

@@ -0,0 +1,14 @@
+export default {
+  ".tag": "file",
+  "name": "Document.docx",
+  "path_lower": "/document.docx",
+  "path_display": "/Document.docx",
+  "id": "id:yVswVBnnL7cAAAAAAAAAdg",
+  "client_modified": "2023-04-27T17:50:32Z",
+  "server_modified": "2023-07-17T19:28:05Z",
+  "rev": "01600b3cc31f26000000002574cf900",
+  "size": 10468,
+  "is_downloadable": true,
+  "content_hash": "065e09a66c9bb9264a6657083c9e7a06f8e2e9bc6a5420900c737250ed108147",
+  "link": "https://uc2aea9ca1ec13663730d4f924d1.dl.dropboxusercontent.com/cd/0/get/CWzN/file"
+}

package/sources/common/common.mjs

@@ -7,8 +7,12 @@ export default {
     path: {
       propDefinition: [
         dropbox,
-        "pathFolder",
+        "path",
+        () => ({
+          filter: ({ metadata: { metadata: { [".tag"]: type } } }) => type === "folder",
+        }),
       ],
+      description: "Type the folder name to search for it in the user's Dropbox.",
     },
     recursive: {
       propDefinition: [
@@ -40,7 +44,7 @@ export default {
         if (!fileTypes.includes(file[".tag"])) {
           continue;
         }
-        if (this.includeLink) {
+        if (this.includeLink && file[".tag"] === "file") {
           file.link = await this.getTemporaryLink(file);
         }
         this.$emit(file, this.getMeta(file.id, file.path_display || file.id));

package/sources/new-file/new-file.mjs

@@ -7,7 +7,7 @@ export default {
   type: "source",
   key: "dropbox-new-file",
   name: "New File",
-  version: "0.0.16",
+  version: "0.0.18",
   description: "Emit new event when a new file is added to your account or a specific folder. Make sure the number of files/folders in the watched folder does not exceed 4000.",
   props: {
     ...common.props,

package/sources/new-folder/new-folder.mjs

@@ -1,4 +1,5 @@
 import common from "../common/common.mjs";
+import sampleEmit from "./test-event.mjs";
 
 export default {
   ...common,
@@ -6,7 +7,7 @@ export default {
   type: "source",
   key: "dropbox-new-folder",
   name: "New Folder",
-  version: "0.0.15",
+  version: "0.0.17",
   description: "Emit new event when a new folder is created. Make sure the number of files/folders in the watched folder does not exceed 4000.",
   hooks: {
     async activate() {
@@ -30,4 +31,5 @@ export default {
       this.$emit(update, this.getMeta(update.id, update.path_display || update.id));
     }
   },
+  sampleEmit,
 };

package/sources/new-folder/test-event.mjs

@@ -0,0 +1,14 @@
+export default {
+  ".tag": "folder",
+  "name": "Clients",
+  "path_lower": "/clients",
+  "path_display": "/Clients",
+  "id": "id:yVswVBnnL7cAAAAAAAAAbQ",
+  "shared_folder_id": "4005125857",
+  "sharing_info": {
+    "read_only": false,
+    "shared_folder_id": "4005125857",
+    "traverse_only": false,
+    "no_access": false
+  }
+}