@pipedream/google_drive 1.12.1 → 2.0.0

package/actions/add-comment/add-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-add-comment",
   name: "Add Comment",
   description: "Add an unanchored comment to a Google Doc (general feedback, no text highlighting). [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/create)",
-  version: "0.1.7",
+  version: "0.1.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/add-file-sharing-preference/add-file-sharing-preference.mjs

@@ -20,7 +20,7 @@ export default {
   name: "Share File or Folder",
   description:
     "Add a [sharing permission](https://support.google.com/drive/answer/7166529) to the sharing preferences of a file or folder and provide a sharing URL. [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/create)",
-  version: "0.2.15",
+  version: "0.2.16",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/copy-file/copy-file.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-copy-file",
   name: "Copy File",
   description: "Create a copy of the specified file. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/copy) for more information",
-  version: "0.1.22",
+  version: "0.1.23",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-file-from-template/create-file-from-template.mjs

@@ -9,7 +9,7 @@ export default {
   key: "google_drive-create-file-from-template",
   name: "Create New File From Template",
   description: "Create a new Google Docs file from a template. Optionally include placeholders in the template document that will get replaced from this action. [See documentation](https://www.npmjs.com/package/google-docs-mustaches)",
-  version: "0.1.25",
+  version: "0.1.26",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-create-file-from-text",
   name: "Create New File From Text",
   description: "Create a new file from plain text. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create) for more information",
-  version: "0.2.15",
+  version: "0.2.16",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

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

@@ -13,7 +13,7 @@ export default {
   key: "google_drive-create-folder",
   name: "Create Folder",
   description: "Create a new empty folder. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-shared-drive/create-shared-drive.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-create-shared-drive",
   name: "Create Shared Drive",
   description: "Create a new shared drive. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/create) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

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

@@ -12,7 +12,7 @@ export default {
     + " `mimeType = 'application/vnd.google-apps.folder'` to find the folder ID first."
     + " Supported content formats: plain text, Markdown, HTML, Rich Text, CSV."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/delete-comment/delete-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-delete-comment",
   name: "Delete Comment",
   description: "Delete a specific comment (Requires ownership or permissions). [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/delete)",
-  version: "0.0.11",
+  version: "0.0.12",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -5,7 +5,7 @@ export default {
   name: "Delete File",
   description:
     "Permanently delete a file or folder without moving it to the trash. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/delete) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/delete-reply/delete-reply.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-delete-reply",
   name: "Delete Reply",
   description: "Delete a reply on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/delete) for more information",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/delete-shared-drive/delete-shared-drive.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-delete-shared-drive",
   name: "Delete Shared Drive",
   description: "Delete a shared drive without any content. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/delete) for more information",
-  version: "0.1.22",
+  version: "0.1.23",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -1,3 +1,4 @@
+import { ConfigurationError } from "@pipedream/platform";
 import fs from "fs";
 import stream from "stream";
 import { promisify } from "util";
@@ -24,14 +25,15 @@ const SHORTCUT_MIME_TYPE = "application/vnd.google-apps.shortcut";
 export default {
   key: "google_drive-download-file",
   name: "Download File",
-  description: "Download a file from Google Drive to the `/tmp` directory or return its contents as a buffer."
+  description: "Download one or more files from Google Drive to the `/tmp` directory or return their contents as buffers."
+    + " Select multiple files to download a batch in a single run."
     + " Use to fetch a file's contents for processing in downstream steps — e.g., parsing a CSV, extracting text from a PDF, or re-uploading to another service."
     + " For Google Workspace files (Docs, Sheets, Slides, Drawings, Apps Script), exports to an Office-compatible format by default:"
     + " Docs → `.docx`, Sheets → `.xlsx`, Slides → `.pptx`, Drawings → PNG, Apps Script → JSON."
     + " Pass `mimeType` to force a specific format. Shortcuts are resolved to their target automatically."
     + " Folders, Forms, and My Maps cannot be downloaded via this action."
     + " [See the documentation](https://developers.google.com/drive/api/v3/manage-downloads)",
-  version: "0.1.26",
+  version: "0.2.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -48,6 +50,19 @@ export default {
       description: "The shared drive the file is in, if any. Leave empty for files in My Drive.",
       optional: true,
     },
+    fileIds: {
+      propDefinition: [
+        googleDrive,
+        "fileId",
+        (c) => ({
+          drive: c.drive,
+        }),
+      ],
+      type: "string[]",
+      label: "Files",
+      description: "The Google Drive file(s) to download. Select one or more files to download a batch in a single run. Accepts file IDs (opaque Drive identifiers). Shortcuts are resolved to their target automatically.",
+      optional: true,
+    },
     fileId: {
       propDefinition: [
         googleDrive,
@@ -56,7 +71,8 @@ export default {
           drive: c.drive,
         }),
       ],
-      description: "The Google Drive file to download. Accepts a file ID (opaque Drive identifier). If a shortcut is passed, the target file is resolved and downloaded automatically.",
+      description: "A single Google Drive file to download. Kept for backwards compatibility — prefer `Files` for new configurations. If both are set, this file is included alongside the ones in `Files`.",
+      optional: true,
     },
     filePath: {
       type: "string",
@@ -82,7 +98,7 @@ export default {
       `),
       optional: true,
       async options() {
-        const fileId = this.fileId;
+        const fileId = this.fileId ?? this.fileIds?.[0];
         if (!fileId) {
           return googleWorkspaceExportFormats;
         }
@@ -127,104 +143,150 @@ export default {
     },
   },
   async run({ $ }) {
-    let fileMetadata = await this.googleDrive.getFile(this.fileId, {
-      fields: "name,mimeType,shortcutDetails,webViewLink",
-    });
-
-    // Shortcuts point at a target file; resolve and download the target instead.
-    let downloadFileId = this.fileId;
-    let resolvedFromShortcut = false;
-    if (fileMetadata.mimeType === SHORTCUT_MIME_TYPE) {
-      const targetId = fileMetadata.shortcutDetails?.targetId;
-      if (!targetId) {
-        throw new Error(`Shortcut "${fileMetadata.name}" has no target file and cannot be downloaded.`);
-      }
-      downloadFileId = targetId;
-      resolvedFromShortcut = true;
-      fileMetadata = await this.googleDrive.getFile(targetId, {
-        fields: "name,mimeType,webViewLink",
-      });
-    }
+    // Combine the batch input (`fileIds`) with the legacy single `fileId`, keeping
+    // order and dropping duplicates so the same file isn't downloaded twice.
+    const requestedIds = [
+      ...(this.fileIds ?? []),
+      ...(this.fileId
+        ? [
+          this.fileId,
+        ]
+        : []),
+    ];
+    const fileIds = [
+      ...new Set(requestedIds),
+    ];
 
-    const sourceMimeType = fileMetadata.mimeType;
-
-    if (unsupportedWorkspaceMimes[sourceMimeType]) {
-      throw new Error(
-        `Cannot download file of type "${sourceMimeType}": ${unsupportedWorkspaceMimes[sourceMimeType]}`,
-      );
+    if (fileIds.length === 0) {
+      throw new ConfigurationError("Select at least one file to download (`Files` or `File`).");
+    }
+    if (fileIds.length > 1 && this.filePath) {
+      throw new ConfigurationError("`Destination File Path` can only be used when downloading a single file. Remove it to download multiple files (each saves to `/tmp/<file name>`).");
     }
 
-    const isWorkspaceDocument = sourceMimeType.includes(GOOGLE_DRIVE_MIME_TYPE_PREFIX);
+    const pipeline = promisify(stream.pipeline);
+
+    // Downloads a single file (resolving shortcuts + Workspace export formats),
+    // either writing it to /tmp or returning its contents as a buffer.
+    const downloadOne = async (requestedFileId) => {
+      let fileMetadata = await this.googleDrive.getFile(requestedFileId, {
+        fields: "name,mimeType,shortcutDetails,webViewLink",
+      });
 
-    // Fallback: user value -> static default -> runtime getExportFormats().
-    let effectiveMimeType = this.mimeType;
-    if (isWorkspaceDocument && !effectiveMimeType) {
-      effectiveMimeType = defaultExportMimeBySource[sourceMimeType];
-      if (!effectiveMimeType) {
-        const exportFormats = await this.googleDrive.getExportFormats();
-        effectiveMimeType = exportFormats[sourceMimeType]?.[0];
+      // Shortcuts point at a target file; resolve and download the target instead.
+      let downloadFileId = requestedFileId;
+      let resolvedFromShortcut = false;
+      if (fileMetadata.mimeType === SHORTCUT_MIME_TYPE) {
+        const targetId = fileMetadata.shortcutDetails?.targetId;
+        if (!targetId) {
+          throw new Error(`Shortcut "${fileMetadata.name}" has no target file and cannot be downloaded.`);
+        }
+        downloadFileId = targetId;
+        resolvedFromShortcut = true;
+        fileMetadata = await this.googleDrive.getFile(targetId, {
+          fields: "name,mimeType,webViewLink",
+        });
       }
-      if (!effectiveMimeType) {
+
+      const sourceMimeType = fileMetadata.mimeType;
+
+      if (unsupportedWorkspaceMimes[sourceMimeType]) {
         throw new Error(
-          `No export format available for "${sourceMimeType}". Set Conversion Format explicitly.`,
+          `Cannot download file of type "${sourceMimeType}": ${unsupportedWorkspaceMimes[sourceMimeType]}`,
         );
       }
-    }
 
-    // See https://developers.google.com/drive/api/v3/mime-types for Google MIME types.
-    const file = isWorkspaceDocument
-      ? await this.googleDrive.downloadWorkspaceFile(downloadFileId, {
-        mimeType: effectiveMimeType,
-      })
-      : await this.googleDrive.getFile(downloadFileId, {
-        alt: "media",
-      });
+      const isWorkspaceDocument = sourceMimeType.includes(GOOGLE_DRIVE_MIME_TYPE_PREFIX);
+
+      // Fallback: user value -> static default -> runtime getExportFormats().
+      let effectiveMimeType = this.mimeType;
+      if (isWorkspaceDocument && !effectiveMimeType) {
+        effectiveMimeType = defaultExportMimeBySource[sourceMimeType];
+        if (!effectiveMimeType) {
+          const exportFormats = await this.googleDrive.getExportFormats();
+          effectiveMimeType = exportFormats[sourceMimeType]?.[0];
+        }
+        if (!effectiveMimeType) {
+          throw new Error(
+            `No export format available for "${sourceMimeType}". Set Conversion Format explicitly.`,
+          );
+        }
+      }
 
-    const summaryPrefix = resolvedFromShortcut
-      ? "Resolved shortcut and downloaded"
-      : "Successfully downloaded";
+      // See https://developers.google.com/drive/api/v3/mime-types for Google MIME types.
+      const file = isWorkspaceDocument
+        ? await this.googleDrive.downloadWorkspaceFile(downloadFileId, {
+          mimeType: effectiveMimeType,
+        })
+        : await this.googleDrive.getFile(downloadFileId, {
+          alt: "media",
+        });
 
-    if (this.getBufferResponse) {
-      $.export("$summary", `${summaryPrefix} raw content for file "${fileMetadata.name}"`);
+      if (this.getBufferResponse) {
+        const chunks = [];
+        for await (const chunk of file) {
+          chunks.push(chunk);
+        }
+        const buffer = Buffer.concat(chunks);
 
-      const chunks = [];
-      for await (const chunk of file) {
-        chunks.push(chunk);
+        return {
+          fileId: requestedFileId,
+          fileMetadata,
+          webViewLink: fileMetadata.webViewLink,
+          content: buffer,
+          resolvedFromShortcut,
+        };
       }
-      const buffer = Buffer.concat(chunks);
+
+      let filePath;
+      if (this.filePath) {
+        filePath = this.filePath.includes("tmp/")
+          ? this.filePath
+          : `/tmp/${this.filePath}`;
+      } else {
+        let defaultName = fileMetadata.name;
+        if (isWorkspaceDocument) {
+          const ext = extensionByMime[effectiveMimeType];
+          if (ext && !defaultName.toLowerCase().endsWith(`.${ext.toLowerCase()}`)) {
+            defaultName = `${defaultName}.${ext}`;
+          }
+        }
+        filePath = `/tmp/${defaultName}`;
+      }
+
+      await pipeline(file, fs.createWriteStream(filePath));
 
       return {
-        fileId: this.fileId,
+        fileId: requestedFileId,
         fileMetadata,
         webViewLink: fileMetadata.webViewLink,
-        content: buffer,
+        filePath,
+        resolvedFromShortcut,
       };
-    }
+    };
 
-    let filePath;
-    if (this.filePath) {
-      filePath = this.filePath.includes("tmp/")
-        ? this.filePath
-        : `/tmp/${this.filePath}`;
-    } else {
-      let defaultName = fileMetadata.name;
-      if (isWorkspaceDocument) {
-        const ext = extensionByMime[effectiveMimeType];
-        if (ext && !defaultName.toLowerCase().endsWith(`.${ext.toLowerCase()}`)) {
-          defaultName = `${defaultName}.${ext}`;
-        }
-      }
-      filePath = `/tmp/${defaultName}`;
+    // Single-file downloads keep the original (non-array) return shape for
+    // backwards compatibility; batches return an array of per-file results.
+    if (fileIds.length === 1) {
+      const result = await downloadOne(fileIds[0]);
+      const verb = result.resolvedFromShortcut
+        ? "Resolved shortcut and downloaded"
+        : "Successfully downloaded";
+      const what = this.getBufferResponse
+        ? `raw content for file "${result.fileMetadata.name}"`
+        : `the file, "${result.fileMetadata.name}"`;
+      $.export("$summary", `${verb} ${what}`);
+      return result;
     }
 
-    const pipeline = promisify(stream.pipeline);
-    await pipeline(file, fs.createWriteStream(filePath));
-    $.export("$summary", `${summaryPrefix} the file, "${fileMetadata.name}"`);
+    const files = [];
+    for (const id of fileIds) {
+      files.push(await downloadOne(id));
+    }
+    $.export("$summary", `Successfully downloaded ${files.length} file(s).`);
     return {
-      fileId: this.fileId,
-      fileMetadata,
-      webViewLink: fileMetadata.webViewLink,
-      filePath,
+      files,
+      count: files.length,
     };
   },
 };

package/actions/find-file/find-file.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-find-file",
   name: "Find File",
   description: "Search for a specific file by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-folder/find-folder.mjs

@@ -7,7 +7,7 @@ export default {
   key: "google_drive-find-folder",
   name: "Find Folder",
   description: "Search for a specific folder by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-forms/find-forms.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-find-forms",
   name: "Find Forms",
   description: "List Google Form documents or search for a Form by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.0.24",
+  version: "0.0.25",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-spreadsheets/find-spreadsheets.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-find-spreadsheets",
   name: "Find Spreadsheets",
   description: "Search for a specific spreadsheet by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-comment/get-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-get-comment",
   name: "Get Comment By ID",
   description: "Get comment by ID on a specific file. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/get) for more information",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-current-user/get-current-user.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-get-current-user",
   name: "Get Current User",
   description: "Retrieve Google Drive account metadata for the authenticated user via `about.get`, including display name, email, permission ID, and storage quota. Useful when flows or agents need to confirm the active Google identity or understand available storage. [See the documentation](https://developers.google.com/drive/api/v3/reference/about/get).",
-  version: "0.0.9",
+  version: "0.0.10",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-file/get-file.mjs

@@ -11,7 +11,7 @@ export default {
     + "\n\nCommon fields: `id`, `name`, `mimeType`, `size`, `parents`, `webViewLink`, `webContentLink`,"
     + " `createdTime`, `modifiedTime`, `owners`, `permissions`, `description`, `trashed`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/get)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/get-file-by-id/get-file-by-id.mjs

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-get-file-by-id",
   name: "Get File By ID",
   description: "Get info on a specific file. [See the documentation](https://developers.google.com/drive/api/reference/rest/v3/files/get) for more information",
-  version: "0.0.19",
+  version: "0.0.20",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-folder-id-for-path/get-folder-id-for-path.mjs

@@ -12,7 +12,7 @@ export default {
   key: "google_drive-get-folder-id-for-path",
   name: "Get Folder ID for a Path",
   description: "Retrieve a folderId for a path. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.24",
+  version: "0.1.25",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-reply/get-reply.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-get-reply",
   name: "Get Reply By ID",
   description: "Get reply by ID on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/get) for more information",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-shared-drive/get-shared-drive.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-get-shared-drive",
   name: "Get Shared Drive",
   description: "Get metadata for one or all shared drives. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/get) for more information",
-  version: "0.1.22",
+  version: "0.1.23",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-user-details/get-user-details.mjs

@@ -10,7 +10,7 @@ export default {
     + " When the user says 'my files' or 'my documents', call this first to get the owner email,"
     + " then pass it to **Search Files** with a query like `'user@example.com' in owners`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/about/get)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/is-folder-ancestor/is-folder-ancestor.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-is-folder-ancestor",
   name: "Is Folder Ancestor",
   description: "Check if a specific folder is anywhere in the parent hierarchy of a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/files/get)",
-  version: "0.0.3",
+  version: "0.0.4",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-access-proposals/list-access-proposals.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-list-access-proposals",
   name: "List Access Proposals",
   description: "List access proposals for a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/accessproposals/list)",
-  version: "0.0.15",
+  version: "0.0.16",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-comments/list-comments.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-list-comments",
   name: "List Comments",
   description: "List all comments on a file. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/list)",
-  version: "0.0.11",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-files/list-files.mjs

@@ -3,12 +3,13 @@ import {
   getListFilesOpts, isMyDrive,
 } from "../../common/utils.mjs";
 import googleDrive from "../../google_drive.app.mjs";
+import { PAGINATION_TOKEN_FIELD } from "../../common/constants.mjs";
 
 export default {
   key: "google_drive-list-files",
   name: "List Files",
-  description: "List files from a specific folder. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/list) for more information",
-  version: "0.3.0",
+  description: "List files from a specific folder. Set `Max Results` to cap how many files are returned per run, then pass the returned `nextPageToken` back in as `Page Token` on the next run to page through a large folder in fixed-size batches. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/list) for more information",
+  version: "1.0.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -46,7 +47,7 @@ export default {
     fields: {
       type: "string",
       label: "Fields",
-      description: "The fields you want included in the response [(see the documentation for available fields)](https://developers.google.com/drive/api/reference/rest/v3/files). If not specified, the response includes a default set of fields specific to this method. For development you can use the special value `*` to return all fields, but you'll achieve greater performance by only selecting the fields you need.\n\n**eg:** `files(id,mimeType,name,webContentLink,webViewLink)`",
+      description: "The fields you want included in the response [(see the documentation for available fields)](https://developers.google.com/drive/api/reference/rest/v3/files). If not specified, the response includes a default set of fields specific to this method. For development you can use the special value `*` to return all fields, but you'll achieve greater performance by only selecting the fields you need.\n\n**Important:** when supplying a custom mask scoped to `files(...)`, the top-level `nextPageToken` field must also be present (e.g. `nextPageToken,files(id,name)`) or pagination silently stops after the first page. This action automatically prepends `nextPageToken` to your mask when it is absent so all pages are returned.\n\n**eg:** `files(id,mimeType,name,createdTime,modifiedTime)`",
       optional: true,
     },
     filterText: {
@@ -54,7 +55,17 @@ export default {
       description: "Filter by file name that contains a specific text",
       type: "string",
       optional: true,
-      reloadProps: true,
+    },
+    filterType: {
+      type: "string",
+      label: "Filter Type",
+      description: "Whether to return files with names containing the Filter Text or files with names that match the Filter Text exactly. Defaults to \"CONTAINS\". Not relevant unless `Filter Text` is entered.",
+      options: [
+        "CONTAINS",
+        "EXACT MATCH",
+      ],
+      default: "CONTAINS",
+      optional: true,
     },
     trashed: {
       label: "Trashed",
@@ -62,22 +73,19 @@ export default {
       description: "If `true`, list **only** trashed files. If `false`, list **only** non-trashed files. Keep it empty to include both.",
       optional: true,
     },
-  },
-  async additionalProps() {
-    const props = {};
-    if (this.filterText) {
-      props.filterType = {
-        type: "string",
-        label: "Filter Type",
-        description: "Whether to return files with names containing the Filter Text or files with names that match the Filter Text exactly. Defaults to \"CONTAINS\"",
-        options: [
-          "CONTAINS",
-          "EXACT MATCH",
-        ],
-        default: "CONTAINS",
-      };
-    }
-    return props;
+    maxResults: {
+      label: "Max Results",
+      type: "integer",
+      description: "The maximum number of files to return per run. Leave empty to return every file in the folder. Combine with `Page Token` to page through a large folder in fixed-size batches across multiple runs.",
+      optional: true,
+      min: 1,
+    },
+    pageToken: {
+      label: "Page Token",
+      type: "string",
+      description: "A cursor for resuming a previous run. Pass the `nextPageToken` returned by an earlier run to continue listing from where it stopped instead of starting over. Leave empty to start from the beginning of the folder.",
+      optional: true,
+    },
   },
   async run({ $ }) {
     if (this.limitToMyDrive && this.drive && !isMyDrive(this.drive)) {
@@ -103,18 +111,61 @@ export default {
         : ""}trashed=${this.trashed}`;
     }
     if (this.fields) {
-      opts.fields = this.fields;
+      // Auto-append nextPageToken at the top level when the user's custom mask
+      // omits it; without it the do/while loop exits after the first page.
+      let fieldsValue = this.fields;
+      if (!fieldsValue.includes(PAGINATION_TOKEN_FIELD)) {
+        fieldsValue = `${PAGINATION_TOKEN_FIELD},${fieldsValue}`;
+      }
+      opts.fields = fieldsValue;
+    }
+
+    const maxResults = this.maxResults === undefined
+      ? undefined
+      : Number(this.maxResults);
+    if (maxResults !== undefined && (!Number.isInteger(maxResults) || maxResults < 1)) {
+      throw new ConfigurationError("`Max Results` must be a positive integer.");
     }
+
+    const startToken = this.pageToken;
     const allFiles = [];
-    let pageToken;
+    let pageToken = startToken;
     do {
+      const pageOpts = {
+        ...opts,
+      };
+      if (maxResults) {
+        // Request exactly as many as we still need (Drive caps pageSize at 1000).
+        // Aligning pageSize to the remaining count means the returned
+        // nextPageToken points right after the last file we keep, so no files
+        // are skipped when resuming — we never over-fetch and discard.
+        pageOpts.pageSize = Math.min(maxResults - allFiles.length, 1000);
+      }
       const {
-        files, nextPageToken,
-      }  = await this.googleDrive.listFilesInPage(pageToken, opts);
+        files = [], nextPageToken,
+      } = await this.googleDrive.listFilesInPage(pageToken, pageOpts);
       allFiles.push(...files);
       pageToken = nextPageToken;
-    } while (pageToken);
-    $.export("$summary", `Successfully found ${allFiles.length} file(s).`);
-    return allFiles;
+    } while (pageToken && (!maxResults || allFiles.length < maxResults));
+
+    const isComplete = !pageToken;
+    const resumed = Boolean(startToken);
+    let summary = `${resumed
+      ? "Resumed and returned"
+      : "Successfully found"} ${allFiles.length} file(s).`;
+    // Only surface batch state when the caller is actually paging.
+    if (maxResults || startToken || !isComplete) {
+      summary += isComplete
+        ? " Reached the end of the folder."
+        : " More results remain — pass `nextPageToken` as `Page Token` on the next run to continue.";
+    }
+    $.export("$summary", summary);
+
+    return {
+      files: allFiles,
+      count: allFiles.length,
+      nextPageToken: pageToken ?? null,
+      isComplete,
+    };
   },
 };

package/actions/list-mime-type-options/list-mime-type-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-list-mime-type-options",
   name: "List Mime Type Options",
   description: "Retrieves available options for the Mime Type field.",
-  version: "0.0.2",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-permissions/list-permissions.mjs

@@ -10,7 +10,7 @@ export default {
     + " Use this tool when the user asks 'who has access to this file?' or needs to audit sharing."
     + " Pass permission IDs from this response to **Remove Sharing** to revoke access."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/list)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-replies/list-replies.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-list-replies",
   name: "List Replies",
   description: "List replies to a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/list) for more information",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-shared-drives/list-shared-drives.mjs

@@ -10,7 +10,7 @@ export default {
     + " Pass a drive ID to **Search Files** `driveId` parameter to search within a specific shared drive."
     + " Optionally filter by name using the `query` parameter (e.g., `name contains 'Engineering'`)."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/list)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-theme-id-options/list-theme-id-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-list-theme-id-options",
   name: "List Theme ID Options",
   description: "Retrieves available options for the Theme ID field.",
-  version: "0.0.2",
+  version: "0.0.3",
   type: "action",
   annotations: {
     destructiveHint: false,

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

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-move-file",
   name: "Move File",
   description: "Move a file from one folder to another. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update) for more information",
-  version: "0.1.22",
+  version: "0.1.23",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/move-file-to-trash/move-file-to-trash.mjs

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-move-file-to-trash",
   name: "Move File to Trash",
   description: "Move a file or folder to trash. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update) for more information",
-  version: "0.1.22",
+  version: "0.1.23",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/remove-file-sharing-permission/remove-file-sharing-permission.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Remove File Sharing Permission",
   description:
     "Remove a [sharing permission](https://support.google.com/drive/answer/7166529) from the sharing preferences of a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/permissions/delete)",
-  version: "0.0.7",
+  version: "0.0.8",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/remove-sharing/remove-sharing.mjs

@@ -10,7 +10,7 @@ export default {
     + " The owner permission cannot be removed."
     + " Use **Search Files** to find the file ID by name if needed."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/delete)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: true,

package/actions/reply-to-comment/reply-to-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-reply-to-comment",
   name: "Reply to Comment",
   description: "Add a reply to an existing comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/create)",
-  version: "0.0.11",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/resolve-access-proposal/resolve-access-proposal.mjs

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-resolve-access-proposal",
   name: "Resolve Access Proposals",
   description: "Accept or deny a request for access to a file or folder in Google Drive. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/accessproposals/resolve)",
-  version: "0.0.15",
+  version: "0.0.16",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/resolve-comment/resolve-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-resolve-comment",
   name: "Resolve Comment",
   description: "Mark a comment as resolved. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/update)",
-  version: "0.0.11",
+  version: "0.0.12",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -22,7 +22,7 @@ export default {
     + "\n\nWhen the user says 'my files', use **Get User Details** first to get the owner email."
     + " To scope to a shared drive, pass the `driveId` from **List Shared Drives**."
     + " [See the documentation](https://developers.google.com/drive/api/v3/search-files)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/search-shared-drives/search-shared-drives.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-search-shared-drives",
   name: "Search for Shared Drives",
   description: "Search for shared drives with query options. [See the documentation](https://developers.google.com/drive/api/v3/search-shareddrives) for more information",
-  version: "0.1.23",
+  version: "0.1.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/share-file/share-file.mjs

@@ -15,7 +15,7 @@ export default {
     + "\n\n**Roles:** `reader` (view only), `commenter` (can comment), `writer` (can edit)."
     + " Use **List Permissions** to see existing sharing on a file."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/create)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/trash-file/trash-file.mjs

@@ -10,7 +10,7 @@ export default {
     + " Use this instead of permanent deletion as the safer default."
     + " To find trashed files, use **Search Files** with `trashed = true`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: true,

package/actions/update-comment/update-comment.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-update-comment",
   name: "Update Comment",
   description: "Update the content of a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/update) for more information",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/update-file/update-file.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-update-file",
   name: "Update File",
   description: "Update a file's metadata and/or content. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update) for more information",
-  version: "2.0.14",
+  version: "2.0.15",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/update-reply/update-reply.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-update-reply",
   name: "Update Reply",
   description: "Update a reply on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/update) for more information",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/update-shared-drive/update-shared-drive.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_drive-update-shared-drive",
   name: "Update Shared Drive",
   description: "Update an existing shared drive. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/update) for more information",
-  version: "0.1.22",
+  version: "0.1.23",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -13,7 +13,7 @@ export default {
   key: "google_drive-upload-file",
   name: "Upload File",
   description: "Upload a file to Google Drive. [See the documentation](https://developers.google.com/drive/api/v3/manage-uploads) for more information",
-  version: "2.0.15",
+  version: "2.0.16",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/common/constants.mjs

@@ -141,6 +141,14 @@ const WEBHOOK_SUBSCRIPTION_RENEWAL_SECONDS =
  */
 const MAX_FILE_OPTION_PATH_SEGMENTS = 3;
 
+/**
+ * The API response field name that carries the cursor to the next page of results in a
+ * `files.list` response. When a caller supplies a custom partial-response `fields` mask
+ * (e.g. `files(id,name)`) this field must also be present at the top level of the mask or
+ * the do/while pagination loop silently exits after the first page.
+ */
+const PAGINATION_TOKEN_FIELD = "nextPageToken";
+
 /**
  * The MIME type prefix of Google Drive MIME types as defined by the [Google
  * Drive API docs](https://developers.google.com/drive/api/v3/mime-types)
@@ -241,6 +249,7 @@ export {
   WEBHOOK_SUBSCRIPTION_EXPIRATION_TIME_MILLISECONDS,
   WEBHOOK_SUBSCRIPTION_RENEWAL_SECONDS,
   MAX_FILE_OPTION_PATH_SEGMENTS,
+  PAGINATION_TOKEN_FIELD,
   GOOGLE_DRIVE_MIME_TYPE_PREFIX,
   GOOGLE_DRIVE_FOLDER_MIME_TYPE,
   GOOGLE_DRIVE_UPLOAD_TYPES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/google_drive",
-  "version": "1.12.1",
+  "version": "2.0.0",
   "description": "Pipedream Google_drive Components",
   "main": "google_drive.app.mjs",
   "keywords": [

package/sources/changes-to-files-in-drive/changes-to-files-in-drive.mjs

@@ -14,7 +14,7 @@ export default {
   key: "google_drive-changes-to-files-in-drive",
   name: "Changes to Files in Drive",
   description: "Emit new event when a change is made to one of the specified files. [See the documentation](https://developers.google.com/drive/api/v3/reference/changes/watch)",
-  version: "0.0.11",
+  version: "0.0.12",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/changes-to-specific-files/changes-to-specific-files.mjs

@@ -16,7 +16,7 @@ export default {
   key: "google_drive-changes-to-specific-files",
   name: "Changes to Specific Files",
   description: "Watches for changes to specific files, emitting an event when a change is made to one of those files. To watch for changes to [shared drive](https://support.google.com/a/users/answer/9310351) files, use the **Changes to Specific Files (Shared Drive)** source instead.",
-  version: "0.3.9",
+  version: "0.3.10",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/changes-to-specific-files-shared-drive/changes-to-specific-files-shared-drive.mjs

@@ -29,7 +29,7 @@ export default {
   key: "google_drive-changes-to-specific-files-shared-drive",
   name: "Changes to Specific Files (Shared Drive)",
   description: "Watches for changes to specific files in a shared drive, emitting an event when a change is made to one of those files",
-  version: "0.3.11",
+  version: "0.3.12",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-access-proposal/new-access-proposal.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-new-access-proposal",
   name: "New Access Proposal",
   description: "Emit new event when a new access proposal is requested in Google Drive",
-  version: "0.0.14",
+  version: "0.0.15",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-files-instant/new-files-instant.mjs

@@ -11,7 +11,7 @@ export default {
   key: "google_drive-new-files-instant",
   name: "New Files (Instant)",
   description: "Emit new event when a new file is added in your linked Google Drive",
-  version: "0.2.11",
+  version: "0.2.12",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-files-instant-polling/new-files-instant-polling.mjs

@@ -8,7 +8,7 @@ export default {
   key: "google_drive-new-files-instant-polling",
   name: "New Files (Polling)",
   description: "Emit new event when a new file is added in your linked Google Drive",
-  version: "0.0.9",
+  version: "0.0.10",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-files-shared-drive/new-files-shared-drive.mjs

@@ -7,7 +7,7 @@ export default {
   key: "google_drive-new-files-shared-drive",
   name: "New Files (Shared Drive)",
   description: "Emit new event when a new file is added in your shared Google Drive",
-  version: "0.1.11",
+  version: "0.1.12",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-or-modified-comments/new-or-modified-comments.mjs

@@ -18,7 +18,7 @@ export default {
   name: "New or Modified Comments (Instant)",
   description:
     "Emit new event when a comment is created or modified in the selected file",
-  version: "1.0.20",
+  version: "1.0.21",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-or-modified-comments-polling/new-or-modified-comments-polling.mjs

@@ -7,7 +7,7 @@ export default {
   key: "google_drive-new-or-modified-comments-polling",
   name: "New or Modified Comments (Polling)",
   description: "Emit new event when a comment is created or modified in the selected file",
-  version: "0.0.9",
+  version: "0.0.10",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-or-modified-files/new-or-modified-files.mjs

@@ -26,7 +26,7 @@ export default {
   key: "google_drive-new-or-modified-files",
   name: "New or Modified Files (Instant)",
   description: "Emit new event when a file in the selected Drive is created, modified or trashed.",
-  version: "0.4.11",
+  version: "0.4.12",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-or-modified-files-polling/new-or-modified-files-polling.mjs

@@ -9,7 +9,7 @@ export default {
   key: "google_drive-new-or-modified-files-polling",
   name: "New or Modified Files (Polling)",
   description: "Emit new event when a file in the selected Drive is created, modified or trashed. [See the documentation](https://developers.google.com/drive/api/v3/reference/changes/list)",
-  version: "0.0.11",
+  version: "0.0.12",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-or-modified-folders/new-or-modified-folders.mjs

@@ -21,7 +21,7 @@ export default {
   key: "google_drive-new-or-modified-folders",
   name: "New or Modified Folders (Instant)",
   description: "Emit new event when a folder is created or modified in the selected Drive",
-  version: "0.2.14",
+  version: "0.2.15",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-or-modified-folders-polling/new-or-modified-folders-polling.mjs

@@ -12,7 +12,7 @@ export default {
   key: "google_drive-new-or-modified-folders-polling",
   name: "New or Modified Folders (Polling)",
   description: "Emit new event when a folder is created or modified in the selected Drive",
-  version: "0.0.10",
+  version: "0.0.11",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-shared-drive/new-shared-drive.mjs

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-new-shared-drive",
   name: "New Shared Drive",
   description: "Emits a new event any time a shared drive is created.",
-  version: "0.1.21",
+  version: "0.1.22",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-spreadsheet/new-spreadsheet.mjs

@@ -6,7 +6,7 @@ export default {
   type: "source",
   name: "New Spreadsheet (Instant)",
   description: "Emit new event when a new spreadsheet is created in a drive.",
-  version: "0.1.24",
+  version: "0.1.25",
   props: {
     googleDrive: newFilesInstant.props.googleDrive,
     db: newFilesInstant.props.db,

package/sources/new-spreadsheet-polling/new-spreadsheet-polling.mjs

@@ -8,7 +8,7 @@ export default {
   key: "google_drive-new-spreadsheet-polling",
   name: "New Spreadsheet (Polling)",
   description: "Emit new event when a new spreadsheet is created in a drive.",
-  version: "0.0.9",
+  version: "0.0.10",
   type: "source",
   dedupe: "unique",
   props: {