@pipedream/slack_v2 1.3.0 → 1.5.0

package/actions/add-emoji-reaction/add-emoji-reaction.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-add-emoji-reaction",
   name: "Add Emoji Reaction",
   description: "Add an emoji reaction to a message. [See the documentation](https://api.slack.com/methods/reactions.add)",
-  version: "0.0.29",
+  version: "0.0.31",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/add-reaction/add-reaction.mjs

@@ -11,7 +11,7 @@ export default {
     + " Use **Get Channel History** or **Search** to find the message timestamp."
     + " Emoji name should be without colons (e.g. `thumbsup`, `fire`, `heart`)."
     + " [See the documentation](https://api.slack.com/methods/reactions.add)",
-  version: "0.0.9",
+  version: "0.0.11",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/archive-channel/archive-channel.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-archive-channel",
   name: "Archive Channel",
   description: "Archive a public or private channel. Direct messages and group DMs can't be archived — pass a channel ID (e.g. `C1234567890`), not a user or group ID. [See the documentation](https://api.slack.com/methods/conversations.archive)",
-  version: "0.0.37",
+  version: "0.0.39",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/browse-files/browse-files.mjs

@@ -11,7 +11,7 @@ export default {
     + " Filter by file type (e.g. `images`, `pdfs`, `snippets`)."
     + " Returns file metadata including name, type, size, and download URL."
     + " [See the documentation](https://api.slack.com/methods/files.list)",
-  version: "0.0.9",
+  version: "0.0.11",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/create-channel/create-channel.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-create-channel",
   name: "Create a Channel",
   description: "Create a new channel. [See the documentation](https://api.slack.com/methods/conversations.create)",
-  version: "0.0.37",
+  version: "0.0.39",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/create-reminder/create-reminder.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-create-reminder",
   name: "Create Reminder",
   description: "Create a reminder. [See the documentation](https://api.slack.com/methods/reminders.add)",
-  version: "0.0.38",
+  version: "0.0.40",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

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

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-delete-file",
   name: "Delete File",
   description: "Delete a file. [See the documentation](https://api.slack.com/methods/files.delete)",
-  version: "0.0.37",
+  version: "0.0.39",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/delete-message/delete-message.mjs

@@ -14,7 +14,7 @@ export default {
     + " lets an identity delete its own messages, so this deletes as whichever identity posted:"
     + " it retries automatically with the other identity if the first attempt returns"
     + " `cant_delete_message`. [See the documentation](https://api.slack.com/methods/chat.delete)",
-  version: "0.2.7",
+  version: "0.2.9",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -0,0 +1,83 @@
+import path from "path";
+import slack from "../../slack_v2.app.mjs";
+import constants from "../../common/constants.mjs";
+
+export default {
+  key: "slack_v2-download-file",
+  name: "Download File",
+  description: "Download the content of a Slack file (e.g. an image, PDF or snippet shared in a channel) to the file-stash directory, returning the saved path plus the file metadata (`name`, `mimetype`, `size`). Canvases download as HTML. Get the file ID from a message's `files[].id` via **Get Channel History**, or from **List Files** / **Browse Files**. Works for files in private channels the authenticated user is a member of. Example: passing `file` `F0123456789` downloads `diagram.png` to `/tmp/F0123456789-diagram.png` and returns `{ \"filedata\": [\"F0123456789-diagram.png\", \"/tmp/F0123456789-diagram.png\"], \"file\": { \"id\": \"F0123456789\", \"name\": \"diagram.png\", \"mimetype\": \"image/png\", \"size\": 84213 } }`. [See the documentation](https://docs.slack.dev/reference/objects/file-object#access)",
+  version: "0.0.2",
+  type: "action",
+  ai: "optimized",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    slack,
+    file: {
+      propDefinition: [
+        slack,
+        "file",
+      ],
+      description: "The file's ID (e.g. `F1234567890`). Run **Get Channel History** (a message's `files[].id`), **List Files** or **Browse Files** first to obtain it.",
+    },
+    syncDir: {
+      type: "dir",
+      accessMode: "write",
+      sync: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      response: { file: metadata }, asBot,
+    } = await this.slack.makeFilesReadRequest({
+      method: "files.info",
+      file: this.file,
+    });
+
+    const url = metadata.url_private_download || metadata.url_private;
+    if (!url) {
+      throw new Error(`File "${this.file}" has no downloadable content. Slack only hosts content for files uploaded to Slack and canvases, so external files (e.g. Google Drive links) and deleted files can't be downloaded.`);
+    }
+    if (metadata.size > constants.MAX_DOWNLOAD_SIZE_BYTES) {
+      throw new Error(`File "${metadata.name}" is ${metadata.size} bytes, which exceeds the ${constants.MAX_DOWNLOAD_SIZE_BYTES}-byte (2GB) /tmp disk limit for this execution, so it cannot be downloaded.`);
+    }
+
+    let safeFilename = path.basename(metadata.name ?? "");
+    if (!safeFilename || safeFilename === "." || safeFilename === "..") {
+      throw new Error(`Invalid filename "${metadata.name}" returned by Slack.`);
+    }
+    if (metadata.filetype === constants.CANVAS_FILETYPE && !path.extname(safeFilename)) {
+      safeFilename += ".html";
+    }
+    const savedFilename = `${metadata.id}-${safeFilename}`;
+    const stashDir = process.env.STASH_DIR || "/tmp";
+    const downloadedFilepath = path.join(stashDir, savedFilename);
+
+    const bytesWritten = await this.slack.downloadFileContent({
+      $,
+      url,
+      asBot,
+      filepath: downloadedFilepath,
+    });
+
+    $.export("$summary", `Downloaded ${metadata.name} (${bytesWritten} bytes)`);
+
+    return {
+      filedata: [
+        savedFilename,
+        downloadedFilepath,
+      ],
+      file: {
+        id: metadata.id,
+        name: metadata.name,
+        title: metadata.title,
+        mimetype: metadata.mimetype,
+        filetype: metadata.filetype,
+        size: bytesWritten,
+      },
+    };
+  },
+};

package/actions/edit-message/edit-message.mjs

@@ -11,7 +11,7 @@ export default {
     + " Requires the message timestamp (`ts`) from **Get Channel History** or **Post Message**."
     + " You can only edit messages posted by the same token/user."
     + " [See the documentation](https://api.slack.com/methods/chat.update)",
-  version: "0.0.10",
+  version: "0.0.12",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/find-message/find-message.mjs

@@ -15,7 +15,7 @@ export default {
     + " omitted when no mention carried a name."
     + " Do NOT splice a name back inline: Slack renders `<@U123|Name>` as literal text, not a mention."
     + " [See the documentation](https://api.slack.com/methods/assistant.search.context)",
-  version: "0.2.4",
+  version: "0.2.6",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-user-by-email/find-user-by-email.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-find-user-by-email",
   name: "Find User by Email",
   description: "Find a user by matching against their email. [See the documentation](https://api.slack.com/methods/users.lookupByEmail)",
-  version: "0.0.36",
+  version: "0.0.38",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/find-user-by-id/find-user-by-id.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-find-user-by-id",
   name: "Find User by ID",
   description: "Find a user by their ID — including a specific user you already have the Slack ID for, whether or not it's your own. Returns user profile information including name, email (requires `users:read.email` scope), timezone, and status. If you only have an email address, use **Find User by Email** instead. [See the documentation](https://api.slack.com/methods/users.info)",
-  version: "0.0.13",
+  version: "0.0.15",
   type: "action",
   ai: "optimized",
   annotations: {

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

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-get-channel-details",
   name: "Get Channel Details",
   description: "Retrieve details for a Slack channel, specified by ID (preferred — resolves instantly) or by name (resolved by scanning the workspace's channel list, which can be slow). [See the documentation](https://api.slack.com/methods/conversations.info)",
-  version: "0.1.7",
+  version: "0.1.9",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/get-channel-history/get-channel-history.mjs

@@ -17,7 +17,7 @@ export default {
     + " messages carry blocks, attachments and edit metadata, so a busy channel can run to tens"
     + " of thousands of characters and be truncated before you see any of it."
     + " [See the documentation](https://api.slack.com/methods/conversations.history)",
-  version: "0.2.6",
+  version: "0.2.8",
   type: "action",
   ai: "optimized",
   annotations: {

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

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-get-current-user",
   name: "Get Current User",
   description: "Do NOT use for a plain \"who am I\" / \"what's my user ID\" question — call **Get User Details** for that; it answers the same question with a far smaller payload. Do NOT use to look up a DIFFERENT, specifically-identified user (by ID or email) — this only ever describes the authenticated caller; use **Find User by ID** / **Find User by Email** for someone else. Do NOT use to enumerate multiple teams/workspaces (e.g. Enterprise Grid) — use **List Teams** for that; this returns only the caller's own current team. Use this ONLY when you specifically need the full member profile: locale, timezone, presence/status, admin and owner flags, name variants, or workspace domain and enterprise metadata. Combines `auth.test`, `users.info`, `users.profile.get` and `team.info`. [See Slack API docs](https://api.slack.com/methods/auth.test).",
-  version: "0.0.12",
+  version: "0.0.14",
   type: "action",
   ai: "optimized",
   annotations: {

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

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-get-file",
   name: "Get File",
   description: "Return information about a file. [See the documentation](https://api.slack.com/methods/files.info)",
-  version: "0.1.12",
+  version: "0.1.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-thread-replies/get-thread-replies.mjs

@@ -17,7 +17,7 @@ export default {
     + " Slack messages carry blocks, attachments and edit metadata, so a long thread can run"
     + " to tens of thousands of characters and be truncated before you see any of it."
     + " [See the documentation](https://api.slack.com/methods/conversations.replies)",
-  version: "0.1.7",
+  version: "0.1.9",
   type: "action",
   ai: "optimized",
   annotations: {

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

@@ -13,7 +13,7 @@ export default {
     + " Prefer this over **Get Current User**, which returns a much larger payload and is only"
     + " needed for full profile detail (locale, status, admin flags)."
     + " [See the documentation](https://api.slack.com/methods/auth.test)",
-  version: "0.0.9",
+  version: "0.0.11",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/invite-user-to-channel/invite-user-to-channel.mjs

@@ -5,7 +5,7 @@ export default {
   key: "slack_v2-invite-user-to-channel",
   name: "Invite User to Channel",
   description: "Invite one or more users to an existing channel. Accepts a channel ID (preferred — resolves instantly) or NAME (resolved by scanning up to 5 pages, ~5,000 channels, of the workspace's channel list — a name beyond that bound will not be found), and a user ID, EMAIL address or display name — all resolved automatically. Pass several users as a comma-separated list. [See the documentation](https://api.slack.com/methods/conversations.invite)",
-  version: "0.1.7",
+  version: "0.1.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/kick-user/kick-user.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-kick-user",
   name: "Kick User",
   description: "Remove a user from a conversation. [See the documentation](https://api.slack.com/methods/conversations.kick)",
-  version: "0.0.37",
+  version: "0.0.39",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/leave-channel/leave-channel.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-leave-channel",
   name: "Leave Channel",
   description: "Remove the authenticated user from a public or private channel. Leaving a channel the user is not a member of is a no-op, reported as `not_in_channel: true`. To leave several channels (e.g. every channel matching a pattern), use **List Channels** with `memberOnly: true` to find them, then call this action once per channel ID. [See the documentation](https://docs.slack.dev/reference/methods/conversations.leave/)",
-  version: "0.0.1",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-channels/list-channels.mjs

@@ -18,7 +18,7 @@ export default {
     + " fetched — when you see that, raise `numPages` (or pass `cursor`) before answering"
     + " any 'how many' or 'list every' question, otherwise your answer is silently incomplete."
     + " [See the documentation](https://api.slack.com/methods/conversations.list)",
-  version: "0.4.1",
+  version: "0.4.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-emojis/list-emojis.mjs

@@ -5,7 +5,7 @@ export default {
   name: "List Emojis",
   description:
     "List all available emojis in the Slack workspace. Optionally include emoji image URLs. [See the documentation](https://api.slack.com/methods/emoji.list)",
-  version: "0.0.11",
+  version: "0.0.13",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

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

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-files",
   name: "List Files",
   description: "Return a list of files within a team. [See the documentation](https://api.slack.com/methods/files.list)",
-  version: "0.1.12",
+  version: "0.1.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-group-conversations/list-group-conversations.mjs

@@ -10,7 +10,7 @@ export default {
     + " Returns `has_more: true` and `next_cursor` when more conversations exist than were"
     + " fetched — raise `numPages` (or pass `cursor`) to see the rest."
     + " [See the documentation](https://api.slack.com/methods/conversations.list)",
-  version: "0.0.6",
+  version: "0.0.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-group-members/list-group-members.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-group-members",
   name: "List Group Members",
   description: "List all users in a User Group. [See the documentation](https://api.slack.com/methods/usergroups.users.list)",
-  version: "0.0.21",
+  version: "0.0.23",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-icon-emoji-options/list-icon-emoji-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-icon-emoji-options",
   name: "List Icon (emoji) Options",
   description: "Retrieves available options for the Icon (emoji) field. [See the documentation](https://api.slack.com/methods/emoji.list)",
-  version: "0.0.9",
+  version: "0.0.11",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/list-members-in-channel/list-members-in-channel.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-members-in-channel",
   name: "List Members in Channel",
   description: "Retrieve members of a channel. Accepts a channel ID (preferred — resolves instantly) or NAME (e.g. general or #general), resolved by scanning up to 5 pages (~5,000 channels) of the workspace's channel list — a name beyond that bound will not be found. [See the documentation](https://api.slack.com/methods/conversations.members)",
-  version: "0.1.7",
+  version: "0.1.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-messages/list-messages.mjs

@@ -9,7 +9,7 @@ export default {
     + " selection to keep responses small, and returns the same message data."
     + " This legacy tool remains only for existing workflows: it accepts a raw conversation ID and"
     + " returns full, untrimmed message objects. [See the documentation](https://api.slack.com/methods/conversations.history)",
-  version: "0.0.12",
+  version: "0.0.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-reminder-options/list-reminder-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-reminder-options",
   name: "List Reminder Options",
   description: "Retrieves available options for the Reminder field. [See the documentation](https://docs.slack.dev/reference/methods/reminders.list)",
-  version: "0.0.9",
+  version: "0.0.11",
   type: "action",
   ai: "optimized",
   annotations: {

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

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-replies",
   name: "List Replies",
   description: "Retrieve a thread of messages posted to a conversation. [See the documentation](https://api.slack.com/methods/conversations.replies)",
-  version: "0.0.37",
+  version: "0.0.39",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-teams/list-teams.mjs

@@ -14,7 +14,7 @@ export default {
     + " Returns `has_more: true` and `next_cursor` when more teams exist than were"
     + " fetched — raise `numPages` (or pass `cursor`) to see the rest."
     + " [See the documentation](https://api.slack.com/methods/auth.teams.list)",
-  version: "0.0.6",
+  version: "0.0.8",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-user-group-options/list-user-group-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-user-group-options",
   name: "List User Group Options",
   description: "Retrieves available options for the User Group field. [See the documentation](https://docs.slack.dev/reference/methods/usergroups.list)",
-  version: "0.0.9",
+  version: "0.0.11",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/list-users/list-users.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-list-users",
   name: "List Users",
   description: "Return a list of all users in a workspace. [See the documentation](https://api.slack.com/methods/users.list)",
-  version: "0.0.36",
+  version: "0.0.38",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/post-message/post-message.mjs

@@ -12,7 +12,7 @@ export default {
     + " Supports plain text with Slack mrkdwn formatting and Block Kit blocks."
     + " Posts as the authenticated user by default; set `sendAsBot` to `true` to post as the Slack app's bot user instead."
     + " [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.1.1",
+  version: "0.1.3",
   type: "action",
   ai: "optimized",
   annotations: {

package/actions/reply-to-a-message/reply-to-a-message.mjs

@@ -13,7 +13,7 @@ export default {
     + " (e.g. `1403051575.000407`); get it from **Get Channel History** or an incoming event's"
     + " `ts` field. For a plain, non-threaded message use **Post Message** instead."
     + " [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.2.12",
+  version: "0.2.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/search/search.mjs

@@ -1,3 +1,5 @@
+import { ConfigurationError } from "@pipedream/platform";
+import constants from "../../common/constants.mjs";
 import utils from "../../common/utils.mjs";
 import slack from "../../slack_v2.app.mjs";
 
@@ -5,16 +7,25 @@ export default {
   key: "slack_v2-search",
   name: "Search",
   description:
-    "Search Slack messages and files using the Real-Time Search API."
+    "Search Slack messages, files, channels, and users using the Real-Time Search API."
     + " Supports keyword and semantic search across public and private channels."
     + " Use **Get User Details** first to find your user ID for filtering by 'my' messages."
-    + " Returns matching messages with channel context, timestamps, and permalinks."
+    + " Set `contentTypes` to choose what to search: any combination of `messages` (default), `files`, `channels`, `users`."
+    + " Returns a single array; each item has a `content_type` of `message`, `file`, `channel`, or `user`."
+    + " Messages include channel context, timestamps, and permalinks;"
+    + " files, channels, and users are returned as Slack sends them"
+    + " (files include `file_id`, `title`, `file_type`, `author_name`, `date_created`, `permalink`, and extracted `content`;"
+    + " channels additionally include `channel_id`, extracted from `permalink` for use with other channel actions)."
+    + " `Max Results` applies per content type, so selecting more types can return proportionally more items."
+    + ` \`Max Results\` is capped at ${constants.MAX_SEARCH_RESULTS}.`
+    + " Paging for a content type stops as soon as a page returns fewer than a full page of it,"
+    + " and paging overall stops after a fixed page budget, so a sparse type can come back with fewer than `Max Results`."
     + " User mentions come back in the canonical `<@U123>` form; echo it verbatim to post a real mention."
     + " Display names are returned separately as `mentions`, an array of `{ id, name }` objects,"
     + " omitted when no mention carried a name."
     + " Do NOT splice a name back inline: Slack renders `<@U123|Name>` as literal text, not a mention."
     + " [See the documentation](https://api.slack.com/methods/assistant.search.context)",
-  version: "0.1.4",
+  version: "0.2.0",
   type: "action",
   ai: "optimized",
   annotations: {
@@ -36,30 +47,121 @@ export default {
       default: "public_channel,private_channel",
       optional: true,
     },
+    contentTypes: {
+      type: "string[]",
+      label: "Content Types",
+      description: "Which kinds of results to return. Select any combination of `messages`, `files`, `channels`, `users`, e.g. `[\"messages\", \"files\"]`. Default: `messages`.",
+      options: [
+        "messages",
+        "files",
+        "channels",
+        "users",
+      ],
+      default: [
+        "messages",
+      ],
+      optional: true,
+    },
     limit: {
       type: "integer",
       label: "Max Results",
-      description: "Maximum number of results to return.",
+      description: `Maximum number of results to return per content type, up to ${constants.MAX_SEARCH_RESULTS}, e.g. \`20\`.`,
       default: 20,
+      min: 1,
+      max: constants.MAX_SEARCH_RESULTS,
       optional: true,
     },
   },
   async run({ $ }) {
     const maxResults = Math.max(this.limit ?? 20, 1);
-    const matches = [];
+    if (maxResults > constants.MAX_SEARCH_RESULTS) {
+      throw new ConfigurationError(`\`Max Results\` must be ${constants.MAX_SEARCH_RESULTS} or less.`);
+    }
+    const contentTypes = this.contentTypes?.length
+      ? this.contentTypes
+      : [
+        "messages",
+      ];
+    const wantMessages = contentTypes.includes("messages");
+    const wantFiles = contentTypes.includes("files");
+    const wantChannels = contentTypes.includes("channels");
+    const wantUsers = contentTypes.includes("users");
+    const messages = [];
+    const files = [];
+    const channels = [];
+    const users = [];
+    // Marks a content type done once a page returns less than a full page of
+    // it, since that means Slack has no more results of that type — without
+    // this, a sparse type (e.g. files) below `Max Results` would keep the
+    // whole loop paging through an already-exhausted type until the page
+    // budget ran out.
+    const exhausted = {};
+    let pages = 0;
     let cursor;
 
+    const needsMore = (want, list, type) => want && !exhausted[type] && list.length < maxResults;
+
     do {
       const response = await this.slack.assistantSearch({
         query: this.query,
         channel_types: this.channelTypes,
+        content_types: contentTypes.join(","),
         cursor,
       });
-      matches.push(...(response.results?.messages || []));
+
+      const newMessages = response.results?.messages || [];
+      const newFiles = response.results?.files || [];
+      const newChannels = response.results?.channels || [];
+      const newUsers = response.results?.users || [];
+
+      if (wantMessages) {
+        messages.push(...newMessages);
+        exhausted.messages ||= newMessages.length < constants.SEARCH_PAGE_SIZE;
+      }
+      if (wantFiles) {
+        files.push(...newFiles);
+        exhausted.files ||= newFiles.length < constants.SEARCH_PAGE_SIZE;
+      }
+      if (wantChannels) {
+        channels.push(...newChannels);
+        exhausted.channels ||= newChannels.length < constants.SEARCH_PAGE_SIZE;
+      }
+      if (wantUsers) {
+        users.push(...newUsers);
+        exhausted.users ||= newUsers.length < constants.SEARCH_PAGE_SIZE;
+      }
+
       cursor = response.response_metadata?.next_cursor;
-    } while (cursor && matches.length < maxResults);
+      pages++;
+    } while (
+      cursor
+      && pages < constants.MAX_SEARCH_PAGES
+      && (needsMore(wantMessages, messages, "messages")
+        || needsMore(wantFiles, files, "files")
+        || needsMore(wantChannels, channels, "channels")
+        || needsMore(wantUsers, users, "users"))
+    );
 
-    const results = utils.normalizeSearchMessages(matches.slice(0, maxResults));
+    const results = [
+      ...utils.normalizeSearchMessages(messages.slice(0, maxResults))
+        .map((message) => ({
+          ...message,
+          content_type: "message",
+        })),
+      ...files.slice(0, maxResults).map((file) => ({
+        ...file,
+        content_type: "file",
+      })),
+      ...channels.slice(0, maxResults).map((channel) => ({
+        ...channel,
+        channel_id: utils.channelIdFromPermalink(channel.permalink),
+        content_type: "channel",
+      })),
+      ...users.slice(0, maxResults).map((user) => ({
+        ...user,
+        content_type: "user",
+      })),
+    ];
 
     $.export("$summary", `Found ${results.length} result${results.length === 1
       ? ""

package/actions/send-block-kit-message/send-block-kit-message.mjs

@@ -7,7 +7,7 @@ export default {
   key: "slack_v2-send-block-kit-message",
   name: "Build and Send a Block Kit Message",
   description: "Configure custom blocks and send to a channel, group, or user. [See the documentation](https://api.slack.com/tools/block-kit-builder).",
-  version: "0.5.12",
+  version: "0.5.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/send-large-message/send-large-message.mjs

@@ -5,7 +5,7 @@ export default {
   key: "slack_v2-send-large-message",
   name: "Send a Large Message (3000+ characters)",
   description: "Send a large message (more than 3000 characters) to a channel, group or user. See [postMessage](https://api.slack.com/methods/chat.postMessage) or [scheduleMessage](https://api.slack.com/methods/chat.scheduleMessage) docs here",
-  version: "0.1.12",
+  version: "0.1.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/send-message/send-message.mjs

@@ -6,7 +6,7 @@ export default {
   key: "slack_v2-send-message",
   name: "Send Message",
   description: "Send a message to a user, group, private channel or public channel. [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.2.5",
+  version: "0.2.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/send-message-advanced/send-message-advanced.mjs

@@ -8,7 +8,7 @@ export default {
   key: "slack_v2-send-message-advanced",
   name: "Send Message (Advanced)",
   description: "Customize advanced settings and send a message to a channel, group or user. See [postMessage](https://api.slack.com/methods/chat.postMessage) or [scheduleMessage](https://api.slack.com/methods/chat.scheduleMessage) docs here",
-  version: "0.1.12",
+  version: "0.1.14",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/send-message-to-channel/send-message-to-channel.mjs

@@ -11,7 +11,7 @@ export default {
     + " replies and unfurl settings. Use this tool only if a workflow specifically needs to"
     + " target a channel exclusively, without the user/group support **Post Message** offers."
     + " [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.2.5",
+  version: "0.2.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/send-message-to-user-or-group/send-message-to-user-or-group.mjs

@@ -6,7 +6,7 @@ export default {
   key: "slack_v2-send-message-to-user-or-group",
   name: "Send Message to User or Group",
   description: "Send a message to a user or group. [See the documentation](https://api.slack.com/methods/chat.postMessage)",
-  version: "0.2.5",
+  version: "0.2.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/set-channel-description/set-channel-description.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-set-channel-description",
   name: "Set Channel Description",
   description: "Change the description or purpose of a channel. [See the documentation](https://api.slack.com/methods/conversations.setPurpose)",
-  version: "0.0.22",
+  version: "0.0.24",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/set-channel-topic/set-channel-topic.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-set-channel-topic",
   name: "Set Channel Topic",
   description: "Set the topic on a channel, specified by ID (preferred — resolves instantly) or by name (resolved by scanning up to 5 pages, ~5,000 channels, of the workspace's channel list — a name beyond that bound will not be found). [See the documentation](https://api.slack.com/methods/conversations.setTopic)",
-  version: "0.1.7",
+  version: "0.1.9",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/set-status/set-status.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-set-status",
   name: "Set Status",
   description: "Set the current status for a user. [See the documentation](https://api.slack.com/methods/users.profile.set)",
-  version: "0.0.21",
+  version: "0.0.23",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/update-group-members/update-group-members.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-update-group-members",
   name: "Update Group Members",
   description: "Update the list of users for a User Group. [See the documentation](https://api.slack.com/methods/usergroups.users.update)",
-  version: "0.0.22",
+  version: "0.0.24",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/update-message/update-message.mjs

@@ -4,7 +4,7 @@ export default {
   key: "slack_v2-update-message",
   name: "Update Message",
   description: "Update a message. [See the documentation](https://api.slack.com/methods/chat.update)",
-  version: "0.2.12",
+  version: "0.2.14",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/update-profile/update-profile.mjs

@@ -5,7 +5,7 @@ export default {
   key: "slack_v2-update-profile",
   name: "Update Profile",
   description: "Update basic profile field such as name or title. [See the documentation](https://api.slack.com/methods/users.profile.set)",
-  version: "0.0.37",
+  version: "0.0.39",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

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

@@ -8,7 +8,7 @@ export default {
   key: "slack_v2-upload-file",
   name: "Upload File",
   description: "Upload a file. [See the documentation](https://api.slack.com/messaging/files#uploading_files)",
-  version: "0.1.16",
+  version: "0.1.18",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/verify-slack-signature/verify-slack-signature.mjs

@@ -5,7 +5,7 @@ export default {
   key: "slack_v2-verify-slack-signature",
   name: "Verify Slack Signature",
   description: "Verifying requests from Slack, slack signs its requests using a secret that's unique to your app. `Request Body` must be the raw request body as a string (not a parsed object) — Slack computes its signature over the exact raw bytes it sent, so re-serializing a parsed object will not match. [See the documentation](https://api.slack.com/authentication/verifying-requests-from-slack)",
-  version: "1.0.5",
+  version: "1.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/common/constants.mjs

@@ -9,6 +9,25 @@ const MAX_NAME_LOOKUP_PAGES = 5;
 // that doesn't exist (typo, wrong workspace) forces a full workspace scan —
 // on a large workspace that alone can exhaust conversations.list's rate limit.
 const MAX_CHANNEL_RESOLVE_PAGES = 5;
+// Page budget for `assistant.search.context` in the Search action. When several
+// content types are selected, one sparse type (e.g. files) would otherwise keep
+// the loop paging through the other type until the cursor runs out, and this
+// method rate-limits readily. Slack returns at most SEARCH_PAGE_SIZE items per
+// page, so Max Results is capped at what the budget can fill for one type.
+const MAX_SEARCH_PAGES = 5;
+const SEARCH_PAGE_SIZE = 20;
+const MAX_SEARCH_RESULTS = MAX_SEARCH_PAGES * SEARCH_PAGE_SIZE;
+// User-token errors on which file reads retry with the bot token.
+const FILES_READ_BOT_FALLBACK_ERRORS = [
+  "missing_scope",
+  "file_not_found",
+  "channel_not_found",
+  "not_in_channel",
+];
+// Pipedream's /tmp limit: https://pipedream.com/docs/workflows/limits#disk
+const MAX_DOWNLOAD_SIZE_BYTES = 2 * 1024 * 1024 * 1024;
+const STREAM_RESPONSE_TYPE = "stream";
+const CANVAS_FILETYPE = "quip";
 
 const CHANNEL_TYPE = {
   PUBLIC: "public_channel",
@@ -51,6 +70,13 @@ export default {
   LIMIT,
   MAX_NAME_LOOKUP_PAGES,
   MAX_CHANNEL_RESOLVE_PAGES,
+  MAX_SEARCH_PAGES,
+  SEARCH_PAGE_SIZE,
+  MAX_SEARCH_RESULTS,
+  FILES_READ_BOT_FALLBACK_ERRORS,
+  MAX_DOWNLOAD_SIZE_BYTES,
+  STREAM_RESPONSE_TYPE,
+  CANVAS_FILETYPE,
   CHANNEL_TYPE,
   CHANNEL_TYPE_OPTIONS,
   BLOCK_TYPES,

package/common/utils.mjs

@@ -140,10 +140,26 @@ export function normalizeSearchMessages(messages) {
   });
 }
 
+/**
+ * Channel search results carry no `id` field, only a `permalink` like
+ * `https://workspace.slack.com/archives/C0123456789`. Extracting it here lets
+ * callers pass the result straight into other channel actions the same way
+ * file/user results already do with `file_id`/`user_id`.
+ *
+ * @param {string} permalink - the channel's permalink
+ * @returns {string|undefined} the channel ID, or undefined if it can't be parsed
+ */
+export function channelIdFromPermalink(permalink) {
+  return typeof permalink === "string"
+    ? permalink.split("/archives/")[1]?.split("/")[0]
+    : undefined;
+}
+
 export default {
   parseFields,
   pickFields,
   projectFields,
   normalizeUserMentions,
   normalizeSearchMessages,
+  channelIdFromPermalink,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/slack_v2",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Pipedream Slack_v2 Components",
   "main": "slack_v2.app.mjs",
   "keywords": [

package/slack_v2.app.mjs

@@ -3,7 +3,12 @@ import { WebClient } from "@slack/web-api";
 import constants from "./common/constants.mjs";
 import get from "lodash/get.js";
 import retry from "async-retry";
-import { ConfigurationError } from "@pipedream/platform";
+import fs from "fs";
+import { Transform } from "stream";
+import { pipeline } from "stream/promises";
+import {
+  ConfigurationError, axios,
+} from "@pipedream/platform";
 
 export default {
   type: "app",
@@ -682,16 +687,50 @@ export default {
         ...args,
       });
     },
-    listFiles(args = {}) {
+    async listFiles(args = {}) {
       args.count ||= constants.LIMIT;
+      const {
+        response, asBot,
+      } = await this.makeFilesReadRequest({
+        method: "files.list",
+        ...args,
+      });
+      // files.list returns no files, not an error, for channels the user can't see
+      if (asBot
+        || !args.channel
+        || args.page > 1
+        || response.files?.length
+        || await this._userCanSeeChannel(args.channel)) {
+        return response;
+      }
+      const notVisibleError = new ConfigurationError(`Channel "${args.channel}" was not found, or neither the connected user nor the bot is a member of it.`);
+      if (!this.getBotToken()) {
+        throw notVisibleError;
+      }
       return this.makeRequest({
         method: "files.list",
-        // Use bot token, if available, since the required `files:read` scope
-        // is only requested for bot tokens in the Pipedream app.
-        asBot: true,
         ...args,
+        asBot: true,
+      }).catch((error) => {
+        if (constants.FILES_READ_BOT_FALLBACK_ERRORS.some((code) => `${error}`.includes(code))) {
+          throw notVisibleError;
+        }
+        throw error;
       });
     },
+    async _userCanSeeChannel(channel) {
+      try {
+        await this.conversationsInfo({
+          channel,
+        });
+        return true;
+      } catch (error) {
+        if (error?.data?.error === "channel_not_found") {
+          return false;
+        }
+        throw error;
+      }
+    },
     listGroupMembers(args = {}) {
       args.limit ||= constants.LIMIT;
       return this.makeRequest({
@@ -699,14 +738,98 @@ export default {
         ...args,
       });
     },
-    getFileInfo(args = {}) {
-      return this.makeRequest({
+    async getFileInfo(args = {}) {
+      const { response } = await this.makeFilesReadRequest({
         method: "files.info",
-        // Use bot token, if available, since the required `files:read` scope
-        // is only requested for bot tokens in the Pipedream app.
-        asBot: true,
         ...args,
       });
+      return response;
+    },
+    // User token first, so files in private channels the bot hasn't joined resolve
+    async makeFilesReadRequest(args = {}) {
+      let userError;
+      try {
+        const response = await this.makeRequest({
+          ...args,
+          asBot: false,
+        });
+        return {
+          response,
+          asBot: false,
+        };
+      } catch (error) {
+        if (!this.getBotToken()
+          || !constants.FILES_READ_BOT_FALLBACK_ERRORS.includes(error?.data?.error)) {
+          throw error;
+        }
+        userError = error;
+      }
+      try {
+        const response = await this.makeRequest({
+          ...args,
+          asBot: true,
+        });
+        return {
+          response,
+          asBot: true,
+        };
+      } catch (error) {
+        throw userError.data.error === "missing_scope"
+          ? error
+          : userError;
+      }
+    },
+    _makeDownloadRequest({
+      $, url, asBot,
+    }) {
+      return axios($, {
+        url,
+        headers: {
+          Authorization: `Bearer ${this.getToken({
+            asBot,
+          })}`,
+        },
+        responseType: constants.STREAM_RESPONSE_TYPE,
+        // Slack redirects unauthorized downloads to its sign-in page
+        maxRedirects: 0,
+      }).catch((error) => {
+        const status = error?.response?.status;
+        if (status >= 300 && status < 400) {
+          throw new Error(`Slack redirected the download to its sign-in page (HTTP ${status}): the connected account's ${asBot
+            ? "bot"
+            : "user"} token can't access this file's content.`);
+        }
+        throw error;
+      });
+    },
+    async downloadFileContent({
+      $, url, asBot, filepath,
+    }) {
+      const contentStream = await this._makeDownloadRequest({
+        $,
+        url,
+        asBot,
+      });
+      let bytesWritten = 0;
+      const enforceSizeLimit = new Transform({
+        transform(chunk, encoding, callback) {
+          bytesWritten += chunk.length;
+          if (bytesWritten > constants.MAX_DOWNLOAD_SIZE_BYTES) {
+            callback(new Error(`File exceeds the ${constants.MAX_DOWNLOAD_SIZE_BYTES}-byte (2GB) /tmp disk limit for this execution.`));
+            return;
+          }
+          callback(null, chunk);
+        },
+      });
+      try {
+        await pipeline(contentStream, enforceSizeLimit, fs.createWriteStream(filepath));
+      } catch (error) {
+        await fs.promises.rm(filepath, {
+          force: true,
+        }).catch(() => {});
+        throw error;
+      }
+      return bytesWritten;
     },
     getUserProfile(args = {}) {
       return this.makeRequest({

package/sources/new-channel-created/new-channel-created.mjs

@@ -5,7 +5,7 @@ export default {
   ...common,
   key: "slack_v2-new-channel-created",
   name: "New Channel Created (Instant)",
-  version: "0.0.21",
+  version: "0.0.23",
   description: "Emit new event when a new channel is created.",
   type: "source",
   dedupe: "unique",

package/sources/new-interaction-event-received/new-interaction-event-received.mjs

@@ -3,7 +3,7 @@ import sampleEmit from "./test-event.mjs";
 
 export default {
   name: "New Interaction Events (Instant)",
-  version: "0.0.32",
+  version: "0.0.34",
   key: "slack_v2-new-interaction-event-received",
   description: "Emit new events on new Slack [interactivity events](https://api.slack.com/interactivity) sourced from [Block Kit interactive elements](https://api.slack.com/interactivity/components), [Slash commands](https://api.slack.com/interactivity/slash-commands), or [Shortcuts](https://api.slack.com/interactivity/shortcuts).",
   type: "source",

package/sources/new-keyword-mention/new-keyword-mention.mjs

@@ -7,7 +7,7 @@ export default {
   ...common,
   key: "slack_v2-new-keyword-mention",
   name: "New Keyword Mention (Instant)",
-  version: "0.1.11",
+  version: "0.1.13",
   description: "Emit new event when a specific keyword is mentioned in a channel",
   type: "source",
   dedupe: "unique",

package/sources/new-message-in-channels/new-message-in-channels.mjs

@@ -7,7 +7,7 @@ export default {
   ...common,
   key: "slack_v2-new-message-in-channels",
   name: "New Message In Channels (Instant)",
-  version: "1.1.11",
+  version: "1.1.13",
   description: "Emit new event when a new message is posted to one or more channels",
   type: "source",
   dedupe: "unique",

package/sources/new-private-channel-created/new-private-channel-created.mjs

@@ -4,7 +4,7 @@ export default {
   ...common,
   key: "slack_v2-new-private-channel-created",
   name: "New Private Channel Created",
-  version: "0.0.11",
+  version: "0.0.13",
   description: "Emit new event when a new private channel is created. [See the documentation](https://api.slack.com/methods/conversations.list)",
   type: "source",
   dedupe: "unique",

package/sources/new-reaction-added/new-reaction-added.mjs

@@ -5,7 +5,7 @@ export default {
   ...common,
   key: "slack_v2-new-reaction-added",
   name: "New Reaction Added (Instant)",
-  version: "1.2.11",
+  version: "1.2.13",
   description: "Emit new event when a member has added an emoji reaction to a message",
   type: "source",
   dedupe: "unique",

package/sources/new-saved-message/new-saved-message.mjs

@@ -5,7 +5,7 @@ export default {
   ...common,
   key: "slack_v2-new-saved-message",
   name: "New Saved Message (Instant)",
-  version: "0.0.17",
+  version: "0.0.19",
   description: "Emit new event when a message is saved. Note: The endpoint is marked as deprecated, and Slack might shut this off at some point down the line.",
   type: "source",
   dedupe: "unique",

package/sources/new-user-added/new-user-added.mjs

@@ -5,7 +5,7 @@ export default {
   ...common,
   key: "slack_v2-new-user-added",
   name: "New User Added (Instant)",
-  version: "0.0.15",
+  version: "0.0.17",
   description: "Emit new event when a new member joins a workspace.",
   type: "source",
   dedupe: "unique",

package/sources/new-user-mention/new-user-mention.mjs

@@ -7,7 +7,7 @@ export default {
   ...common,
   key: "slack_v2-new-user-mention",
   name: "New User Mention (Instant)",
-  version: "0.1.11",
+  version: "0.1.13",
   description: "Emit new event when a username or specific keyword is mentioned in a channel",
   type: "source",
   dedupe: "unique",