davexbaileys 2.5.17 → 2.5.18

package/lib/Socket/groups.js

@@ -10,30 +10,57 @@ const WABinary_1 = require("../WABinary");
 const chats_1 = require("./chats");
 
   /**
-   * Detect if a message mentions any group JID (@g.us)
-   * — "antiGroupMention" prevents users from tagging groups inside private chats or status updates.
-   * Works on text, extendedText, image captions, video captions, etc.
-   * @param message - the WebMessageInfo object
-   * @returns array of group JIDs that were mentioned (empty array = no group mentions)
+   * Extract all group JIDs (@g.us) mentioned in a message's contextInfo.mentionedJid list.
+   *
+   * WHAT "antiGroupMention" means in WhatsApp bots:
+   *   When someone sends a message and @-tags a GROUP (not a person), WhatsApp puts that
+   *   group's JID (ending in @g.us) inside contextInfo.mentionedJid.
+   *   "Anti group mention" = detect & action messages where someone is tagging/promoting
+   *   ANOTHER GROUP inside your group — e.g. sharing group invite links or pinging rival groups.
+   *   It is NOT about messages coming FROM a group; it is about messages that CONTAIN a @group mention.
+   *
+   * HOW it works (official Baileys source — Utils/messages.js):
+   *   key.contextInfo.mentionedJid = message.mentions;
+   *   Each entry is either a user JID (@s.whatsapp.net) or a group JID (@g.us).
+   *
+   * FIX (v2.5.18): previous version used  `getAllMentioned(ctx) || getAllMentioned(next)`.
+   *   An empty array [] is truthy in JS, so the || chain ALWAYS stopped at the first call
+   *   even when that message type didn't exist. Now we chain on contextInfo objects (which
+   *   are undefined when absent = falsy) so the || correctly falls through.
+   *
+   * @param message - WebMessageInfo object (sock.ev.on('messages.upsert') message)
+   * @returns array of group JIDs (@g.us) mentioned — empty array means no group mentions
    */
   const getGroupMentions = (message) => {
-      var _a, _b, _c, _d, _e, _f, _g, _h;
-      const getAllMentioned = (contextInfo) => {
-          return (contextInfo === null || contextInfo === void 0 ? void 0 : contextInfo.mentionedJid) || [];
-      };
-      const msg = message === null || message === void 0 ? void 0 : message.message;
+      const msg = (message === null || message === void 0 ? void 0 : message.message) || null;
       if (!msg) return [];
-      const mentioned =
-          getAllMentioned((_b = (_a = msg.extendedTextMessage) === null || _a === void 0 ? void 0 : _a.contextInfo) !== null && _b !== void 0 ? _b : null) ||
-          getAllMentioned((_d = (_c = msg.imageMessage) === null || _c === void 0 ? void 0 : _c.contextInfo) !== null && _d !== void 0 ? _d : null) ||
-          getAllMentioned((_f = (_e = msg.videoMessage) === null || _e === void 0 ? void 0 : _e.contextInfo) !== null && _f !== void 0 ? _f : null) ||
-          getAllMentioned((_h = (_g = msg.documentMessage) === null || _g === void 0 ? void 0 : _g.contextInfo) !== null && _h !== void 0 ? _h : null) ||
-          [];
-      return mentioned.filter(jid => typeof jid === 'string' && jid.endsWith('@g.us'));
+      // Chain on contextInfo OBJECTS (undefined = falsy → || falls through correctly)
+      const contextInfo =
+          msg.extendedTextMessage?.contextInfo ||
+          msg.imageMessage?.contextInfo ||
+          msg.videoMessage?.contextInfo ||
+          msg.documentMessage?.contextInfo ||
+          msg.audioMessage?.contextInfo ||
+          msg.stickerMessage?.contextInfo ||
+          null;
+      const mentionedJids = (contextInfo === null || contextInfo === void 0 ? void 0 : contextInfo.mentionedJid) || [];
+      return mentionedJids.filter(jid => typeof jid === 'string' && jid.endsWith('@g.us'));
   };
   /**
-   * Returns true if the message contains any group mention (@g.us JID)
-   * Use this to enforce "antiGroupMention" policy in private chats or status updates.
+   * Returns true if the message @-mentions any group JID (@g.us).
+   * Use to enforce "anti group mention" — remove or warn members who tag other groups
+   * inside your group to prevent spam or promotion of rival groups.
+   *
+   * Usage:
+   *   sock.ev.on('messages.upsert', async ({ messages }) => {
+   *     for (const msg of messages) {
+   *       if (isAntiGroupMention(msg)) {
+   *         const groups = getGroupMentions(msg); // array of @g.us JIDs they tagged
+   *         await sock.sendMessage(msg.key.remoteJid, { text: 'No group mentions allowed!' });
+   *         await sock.groupParticipantsUpdate(msg.key.remoteJid, [msg.key.participant], 'remove');
+   *       }
+   *     }
+   *   });
    */
   const isAntiGroupMention = (message) => {
       return getGroupMentions(message).length > 0;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "davexbaileys",
-    "version": "2.5.17",
+    "version": "2.5.18",
     "description": "A lightweight, full-featured WhatsApp Web API library for Node.js — maintained by Dave Tech",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",