@pipedream/google_drive 1.10.0 → 1.12.0

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

@@ -0,0 +1,50 @@
+import googleDrive from "../../google_drive.app.mjs";
+
+export default {
+  key: "google_drive-remove-sharing",
+  name: "Remove Sharing",
+  description:
+    "Remove a sharing permission from a file or folder in Google Drive."
+    + " This revokes access for the specified permission."
+    + " Use **List Permissions** first to find the permission ID to remove."
+    + " 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",
+  type: "action",
+  annotations: {
+    destructiveHint: true,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    googleDrive,
+    fileId: {
+      type: "string",
+      label: "File ID",
+      description:
+        "The ID of the file or folder to remove the sharing permission from."
+        + " Use **Search Files** to find the file ID by name.",
+    },
+    permissionId: {
+      type: "string",
+      label: "Permission ID",
+      description:
+        "The ID of the permission to remove."
+        + " Use **List Permissions** to find the permission ID.",
+    },
+  },
+  async run({ $ }) {
+    await this.googleDrive.deletePermission({
+      fileId: this.fileId,
+      permissionId: this.permissionId,
+    });
+
+    $.export("$summary", `Removed permission ${this.permissionId} from file ${this.fileId}`);
+    return {
+      success: true,
+      fileId: this.fileId,
+      permissionId: this.permissionId,
+    };
+  },
+};

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.10",
+  version: "0.0.11",
   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.14",
+  version: "0.0.15",
   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.10",
+  version: "0.0.11",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -0,0 +1,82 @@
+import { getListFilesOpts } from "../../common/utils.mjs";
+import googleDrive from "../../google_drive.app.mjs";
+
+export default {
+  key: "google_drive-search-files",
+  name: "Search Files",
+  description:
+    "Search for files and folders in Google Drive using the Drive query language."
+    + " This is the primary tool for finding files, folders, spreadsheets, forms, and any other Drive item."
+    + " Returns matching files with their IDs, names, MIME types, and parent folder IDs."
+    + "\n\n**Query syntax** — pass a Drive search query string. Examples:"
+    + "\n- Find by name: `name contains 'Budget'`"
+    + "\n- Exact name match: `name = 'Q4 Report'`"
+    + "\n- Folders only: `mimeType = 'application/vnd.google-apps.folder'`"
+    + "\n- Google Docs: `mimeType = 'application/vnd.google-apps.document'`"
+    + "\n- Spreadsheets: `mimeType = 'application/vnd.google-apps.spreadsheet'`"
+    + "\n- Files in a folder: `'FOLDER_ID' in parents`"
+    + "\n- Not trashed: `trashed = false`"
+    + "\n- Modified after date: `modifiedTime > '2024-01-01T00:00:00'`"
+    + "\n- Combine with AND: `name contains 'Report' and mimeType = 'application/vnd.google-apps.document'`"
+    + "\n- Owner filter: `'user@example.com' in owners`"
+    + "\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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleDrive,
+    query: {
+      type: "string",
+      label: "Query",
+      description:
+        "A Drive search query string. See the tool description for syntax examples."
+        + " Common queries: `name contains 'keyword'`, `mimeType = 'application/vnd.google-apps.folder'`,"
+        + " `'FOLDER_ID' in parents`, `trashed = false`.",
+    },
+    driveId: {
+      type: "string",
+      label: "Drive ID",
+      description:
+        "Optional. Scope the search to a specific shared drive."
+        + " Use **List Shared Drives** to find available drive IDs."
+        + " Omit to search My Drive.",
+      optional: true,
+    },
+    includeItemsFromAllDrives: {
+      type: "boolean",
+      label: "Include Items From All Drives",
+      description:
+        "If true, include results from all drives (My Drive and shared drives)."
+        + " Defaults to false.",
+      optional: true,
+      default: false,
+    },
+  },
+  async run({ $ }) {
+    const opts = getListFilesOpts(this.driveId, {
+      q: this.query,
+      includeItemsFromAllDrives: this.includeItemsFromAllDrives,
+    });
+
+    const allFiles = [];
+    let pageToken;
+    do {
+      const {
+        files, nextPageToken,
+      } = await this.googleDrive.listFilesInPage(pageToken, opts);
+      allFiles.push(...files);
+      pageToken = nextPageToken;
+    } while (pageToken);
+
+    $.export("$summary", `Found ${allFiles.length} file${allFiles.length === 1
+      ? ""
+      : "s"} matching query "${this.query}"`);
+    return allFiles;
+  },
+};

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.22",
+  version: "0.1.23",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

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

@@ -0,0 +1,86 @@
+import googleDrive from "../../google_drive.app.mjs";
+
+export default {
+  key: "google_drive-share-file",
+  name: "Share File",
+  description:
+    "Share a file or folder in Google Drive by creating a sharing permission."
+    + " Supports sharing with a specific user, a group, an entire domain, or anyone with the link."
+    + " Use **Search Files** first to find the file ID by name."
+    + "\n\n**Sharing types:**"
+    + "\n- `user` — share with a specific person (requires `emailAddress`)"
+    + "\n- `group` — share with a Google Group (requires `emailAddress`)"
+    + "\n- `domain` — share with everyone in a Google Workspace domain (requires `domain`)"
+    + "\n- `anyone` — share with anyone who has the link (no email/domain needed)"
+    + "\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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    googleDrive,
+    fileId: {
+      type: "string",
+      label: "File ID",
+      description:
+        "The ID of the file or folder to share."
+        + " Use **Search Files** to find the file ID by name.",
+    },
+    type: {
+      type: "string",
+      label: "Type",
+      description:
+        "The type of grantee: `user`, `group`, `domain`, or `anyone`.",
+      options: [
+        "user",
+        "group",
+        "domain",
+        "anyone",
+      ],
+    },
+    role: {
+      type: "string",
+      label: "Role",
+      description:
+        "The access level to grant: `reader` (view), `commenter` (comment), or `writer` (edit).",
+      options: [
+        "reader",
+        "commenter",
+        "writer",
+      ],
+    },
+    emailAddress: {
+      type: "string",
+      label: "Email Address",
+      description:
+        "The email address of the user or group to share with."
+        + " Required when type is `user` or `group`. Ignored for `domain` and `anyone`.",
+      optional: true,
+    },
+    domain: {
+      type: "string",
+      label: "Domain",
+      description:
+        "The Google Workspace domain to share with (e.g., `example.com`)."
+        + " Required when type is `domain`. Ignored for other types.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const resp = await this.googleDrive.createPermission(this.fileId, {
+      role: this.role,
+      type: this.type,
+      emailAddress: this.emailAddress,
+      domain: this.domain,
+    });
+
+    const target = this.emailAddress || this.domain || this.type;
+    $.export("$summary", `Shared file with ${target} as ${this.role}`);
+    return resp;
+  },
+};

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

@@ -0,0 +1,41 @@
+import googleDrive from "../../google_drive.app.mjs";
+
+export default {
+  key: "google_drive-trash-file",
+  name: "Trash File",
+  description:
+    "Move a file or folder to the trash in Google Drive."
+    + " This is a reversible operation — the file can be restored from trash within 30 days."
+    + " Use **Search Files** first to find the file ID by name."
+    + " 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",
+  type: "action",
+  annotations: {
+    destructiveHint: true,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    googleDrive,
+    fileId: {
+      type: "string",
+      label: "File ID",
+      description:
+        "The ID of the file or folder to move to trash."
+        + " Use **Search Files** to find the file ID by name.",
+    },
+  },
+  async run({ $ }) {
+    const resp = await this.googleDrive.updateFile(this.fileId, {
+      requestBody: {
+        trashed: true,
+      },
+      fields: "*",
+    });
+
+    $.export("$summary", `Moved to trash: ${resp.name} (${resp.id})`);
+    return resp;
+  },
+};

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.7",
+  version: "0.0.8",
   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.13",
+  version: "2.0.14",
   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.7",
+  version: "0.0.8",
   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.21",
+  version: "0.1.22",
   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.14",
+  version: "2.0.15",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/common/utils.mjs

@@ -48,23 +48,46 @@ function getListFilesOpts(drive, baseOpts = {}) {
   // empty or is "My Drive". Otherwise, use the "drive" corpus and include
   // `supportsAllDrives` param.
 
-  const opts = (!drive || isMyDrive(drive))
-    ? {
-      ...baseOpts,
+  const {
+    limitToMyDrive, ...rest
+  } = baseOpts;
+
+  if (drive && isMyDrive(drive)) {
+    return {
+      ...rest,
+      corpora: "user",
       supportsAllDrives: true,
-    }
-    : {
+    };
+  }
+
+  if (drive && !isMyDrive(drive)) {
+    return {
       // Google's `files.list` API requires `includeItemsFromAllDrives: true`
       // whenever `driveId` is set or `corpora` is `drive`/`allDrives`.
       // Placed before the spread so callers (e.g. list-files's
       // `limitToMyDrive` toggle) can still override.
       includeItemsFromAllDrives: true,
-      ...baseOpts,
+      ...rest,
       corpora: "drive",
       driveId: getDriveId(drive),
       supportsAllDrives: true,
     };
-  return opts;
+  }
+
+  if (limitToMyDrive) {
+    return {
+      ...rest,
+      supportsAllDrives: true,
+    };
+  }
+
+  // No specific drive selected — search across all drives by default.
+  return {
+    includeItemsFromAllDrives: true,
+    ...rest,
+    corpora: "allDrives",
+    supportsAllDrives: true,
+  };
 }
 
 function streamToBuffer(stream) {

package/google_drive.app.mjs

@@ -32,9 +32,8 @@ export default {
     watchedDrive: {
       type: "string",
       label: "Drive",
-      description: "Defaults to `My Drive`. To select a [Shared Drive](https://support.google.com/a/users/answer/9310351) instead, select it from this list.",
+      description: "Select a specific drive to search. Defaults to **All Drives** (My Drive and all Shared Drives you have access to) when no selection is made. To limit to your personal drive or a [Shared Drive](https://support.google.com/a/users/answer/9310351), select it from this list.",
       optional: true,
-      default: MY_DRIVE_VALUE,
       async options({ prevContext }) {
         const { nextPageToken } = prevContext;
         return this._listDriveOptions(nextPageToken);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/google_drive",
-  "version": "1.10.0",
+  "version": "1.12.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.9",
+  version: "0.0.10",
   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.8",
+  version: "0.3.9",
   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.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/common-webhook.mjs

@@ -19,7 +19,7 @@ export default {
         googleDrive,
         "watchedDrive",
       ],
-      description: "Defaults to My Drive. To select a [Shared Drive](https://support.google.com/a/users/answer/9310351) instead, select it from this list.",
+      description: "Defaults to **All Drives** (My Drive and all Shared Drives you have access to) when no selection is made. To limit to your personal drive or a [Shared Drive](https://support.google.com/a/users/answer/9310351), select it from this list.",
       optional: false,
     },
     timer: {

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.13",
+  version: "0.0.14",
   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.9",
+  version: "0.2.10",
   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.7",
+  version: "0.0.8",
   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.9",
+  version: "0.1.10",
   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.18",
+  version: "1.0.19",
   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.8",
+  version: "0.0.9",
   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.9",
+  version: "0.4.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/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.9",
+  version: "0.0.10",
   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.12",
+  version: "0.2.13",
   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.8",
+  version: "0.0.9",
   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.20",
+  version: "0.1.21",
   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.23",
+  version: "0.1.24",
   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.7",
+  version: "0.0.8",
   type: "source",
   dedupe: "unique",
   props: {