@naturalcycles/nodejs-lib 15.82.0 → 15.82.1

package/dist/slack/slack.service.js

@@ -82,7 +82,7 @@ export class SlackService {
             text = '```' + text + '```';
         }
         if (msg.mentions?.length) {
-            text += '\n' + msg.mentions.map(s => `<@${s}>`).join(' ');
+            text += '\n' + msg.mentions.map(formatSlackMention).join(' ');
         }
         const prefix = await messagePrefixHook(msg);
         if (prefix === null)
@@ -139,3 +139,12 @@ export function slackDefaultMessagePrefixHook(msg) {
     }
     return tokens.filter(Boolean);
 }
+// Formats a Slack mention based on the ID type:
+// - User IDs (U...) and Bot IDs (B...) use: <@ID>
+// - User Group IDs (S...) use: <!subteam^ID>
+function formatSlackMention(id) {
+    if (id.startsWith('S')) {
+        return `<!subteam^${id}>`;
+    }
+    return `<@${id}>`;
+}

package/dist/slack/slack.service.model.d.ts

@@ -42,9 +42,10 @@ export interface SlackMessage<CTX = any> extends SlackMessageProps {
      */
     kv?: AnyObject;
     /**
-     * Slack Member IDs to mention at the end of the message.
-     * Use Member IDs (e.g., 'U1234567890'), not usernames.
-     * To find a Member ID: click on their profile in Slack → "..." → "Copy member ID".
+     * Slack IDs to mention at the end of the message.
+     * Supports:
+     * - User IDs (e.g., 'U1234567890') - click profile → "..." → "Copy member ID"
+     * - User Group IDs (e.g., 'S1234567890') - from user group settings
      */
     mentions?: string[];
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.82.0",
+  "version": "15.82.1",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@types/js-yaml": "^4",

package/src/slack/slack.service.model.ts

@@ -51,9 +51,10 @@ export interface SlackMessage<CTX = any> extends SlackMessageProps {
   kv?: AnyObject
 
   /**
-   * Slack Member IDs to mention at the end of the message.
-   * Use Member IDs (e.g., 'U1234567890'), not usernames.
-   * To find a Member ID: click on their profile in Slack → "..." → "Copy member ID".
+   * Slack IDs to mention at the end of the message.
+   * Supports:
+   * - User IDs (e.g., 'U1234567890') - click profile → "..." → "Copy member ID"
+   * - User Group IDs (e.g., 'S1234567890') - from user group settings
    */
   mentions?: string[]
 

package/src/slack/slack.service.ts

@@ -109,7 +109,7 @@ export class SlackService<CTX = any> {
     }
 
     if (msg.mentions?.length) {
-      text += '\n' + msg.mentions.map(s => `<@${s}>`).join(' ')
+      text += '\n' + msg.mentions.map(formatSlackMention).join(' ')
     }
 
     const prefix = await messagePrefixHook(msg)
@@ -191,3 +191,13 @@ export function slackDefaultMessagePrefixHook(msg: SlackMessage): string[] {
 
   return tokens.filter(Boolean)
 }
+
+// Formats a Slack mention based on the ID type:
+// - User IDs (U...) and Bot IDs (B...) use: <@ID>
+// - User Group IDs (S...) use: <!subteam^ID>
+function formatSlackMention(id: string): string {
+  if (id.startsWith('S')) {
+    return `<!subteam^${id}>`
+  }
+  return `<@${id}>`
+}