davexbaileys 2.5.16 → 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/lib/Utils/message-type-utils.js

@@ -1,6 +1,6 @@
 "use strict";
   Object.defineProperty(exports, "__esModule", { value: true });
-  exports.getMessageType = exports.generateLinkPreview = exports.isAntiFiles = exports.isAntiBug = exports.isAntiViewOnce = exports.isAntiDocument = exports.isAntiVideo = exports.isAntiAudio = exports.isAntiImage = exports.isAntiSticker = exports.isAntiLink = exports.isViewOnce = exports.isDocument = exports.isVideo = exports.isAudio = exports.isImage = exports.isSticker = exports.isGif = exports.isReaction = exports.isPoll = exports.isLocation = exports.isContact = exports.isLiveLocation = exports.isButton = exports.isForwarded = exports.hasLink = exports.LINK_REGEX = void 0;
+  exports.isIncomingCall = exports.isVideoCall = exports.isAntiCall = exports.isGroupCall = exports.getActionParticipants = exports.isAntiDemote = exports.isAntiPromote = exports.getMessageType = exports.generateLinkPreview = exports.isAntiFiles = exports.isAntiBug = exports.isAntiViewOnce = exports.isAntiDocument = exports.isAntiVideo = exports.isAntiAudio = exports.isAntiImage = exports.isAntiSticker = exports.isAntiLink = exports.isViewOnce = exports.isDocument = exports.isVideo = exports.isAudio = exports.isImage = exports.isSticker = exports.isGif = exports.isReaction = exports.isPoll = exports.isLocation = exports.isContact = exports.isLiveLocation = exports.isButton = exports.isForwarded = exports.hasLink = exports.LINK_REGEX = void 0;
 
   /**
    * Regex to detect URLs/links in messages (same pattern as official Baileys internals)
@@ -212,4 +212,172 @@
       };
   };
   exports.generateLinkPreview = generateLinkPreview;
+
+  // ─── group action detectors ──────────────────────────────────────────────────
+
+  /**
+   * Detect if a group-participants.update event is a PROMOTE action
+   * Usage:
+   *   sock.ev.on('group-participants.update', update => {
+   *     if (isAntiPromote(update)) { // someone was made admin }
+   *   });
+   * @param update - the group-participants.update event object { id, participants, action }
+   * @returns true if action === 'promote'
+   */
+  const isAntiPromote = (update) => {
+      return (update === null || update === void 0 ? void 0 : update.action) === 'promote';
+  };
+  exports.isAntiPromote = isAntiPromote;
+
+  /**
+   * Detect if a group-participants.update event is a DEMOTE action
+   * @param update - the group-participants.update event object
+   * @returns true if action === 'demote'
+   */
+  const isAntiDemote = (update) => {
+      return (update === null || update === void 0 ? void 0 : update.action) === 'demote';
+  };
+  exports.isAntiDemote = isAntiDemote;
+
+  /**
+   * Detect if a call is happening in a group (group anticall)
+   * Usage:
+   *   sock.ev.on('call', async (calls) => {
+   *     for (const call of calls) {
+   *       if (isGroupCall(call) && call.status === 'offer') {
+   *         // end the call, warn or remove the caller
+   *       }
+   *     }
+   *   });
+   * @param call - a call event object from the 'call' event
+   * @returns true if the call originates from a group JID
+   */
+  const isGroupCall = (call) => {
+      const from = (call === null || call === void 0 ? void 0 : call.from) || (call === null || call === void 0 ? void 0 : call.chatId) || '';
+      return typeof from === 'string' && from.endsWith('@g.us');
+  };
+  exports.isGroupCall = isGroupCall;
+
+  /** Alias — same as isGroupCall, for antiCall naming convention */
+  const isAntiCall = isGroupCall;
+  exports.isAntiCall = isAntiCall;
+
+  /**
+   * Get participants affected by a group action (promote/demote/add/remove)
+   * @param update - group-participants.update event
+   * @returns array of JIDs
+   */
+  const getActionParticipants = (update) => {
+      return (update === null || update === void 0 ? void 0 : update.participants) || [];
+  };
+  exports.getActionParticipants = getActionParticipants;
+
+  // ─── group action detectors (from official Baileys) ─────────────────────────
+  //
+  // How group-participants.update works (from process-message.js):
+  //   ev.emit('group-participants.update', { id, author, participants, action })
+  //   action: 'promote' | 'demote' | 'add' | 'remove' | 'leave' | 'modify'
+  //   participants: string[]  — array of JIDs affected
+  //   author: string          — JID of who did the action
+  //   id: string              — group JID
+
+  /**
+   * Detect a PROMOTE action from a group-participants.update event.
+   * Returns true when a member has been made admin.
+   * Usage:
+   *   sock.ev.on('group-participants.update', update => {
+   *     if (isAntiPromote(update)) {
+   *       // update.participants = array of newly promoted JIDs
+   *       // update.author = who promoted them
+   *       // update.id = group JID
+   *     }
+   *   });
+   */
+  const isAntiPromote = (update) => {
+      return (update === null || update === void 0 ? void 0 : update.action) === 'promote';
+  };
+  exports.isAntiPromote = isAntiPromote;
+
+  /**
+   * Detect a DEMOTE action from a group-participants.update event.
+   * Returns true when an admin has been removed from admin status.
+   * Usage:
+   *   sock.ev.on('group-participants.update', update => {
+   *     if (isAntiDemote(update)) {
+   *       // update.participants = array of demoted JIDs
+   *       // update.author = who demoted them
+   *       // update.id = group JID
+   *     }
+   *   });
+   */
+  const isAntiDemote = (update) => {
+      return (update === null || update === void 0 ? void 0 : update.action) === 'demote';
+  };
+  exports.isAntiDemote = isAntiDemote;
+
+  /**
+   * Get the participants affected by a group action (add/remove/promote/demote)
+   * @param update - group-participants.update event
+   * @returns array of JIDs
+   */
+  const getActionParticipants = (update) => {
+      return (update === null || update === void 0 ? void 0 : update.participants) || [];
+  };
+  exports.getActionParticipants = getActionParticipants;
+
+  // ─── call detectors (from official Baileys) ──────────────────────────────────
+  //
+  // How the call event works (from messages-recv.js handleCall):
+  //   ev.emit('call', [call])
+  //   call.chatId    — JID of where the call came from (group or person)
+  //   call.from      — caller JID
+  //   call.id        — unique call ID
+  //   call.status    — 'offer' | 'accept' | 'reject' | 'timeout' | 'terminate'
+  //   call.isVideo   — true if video call
+  //   call.isGroup   — true if the call is from a GROUP
+  //   call.groupJid  — group JID (if isGroup)
+  //   call.offline   — true if received while offline
+  //
+  // To reject a call: await sock.rejectCall(call.id, call.from)
+
+  /**
+   * Returns true if the call is a GROUP call.
+   * This is the official antiGroupCall check — mirrors how official Baileys
+   * sets call.isGroup from the binary node attribute 'group-jid'.
+   * Usage:
+   *   sock.ev.on('call', async (calls) => {
+   *     for (const call of calls) {
+   *       if (isGroupCall(call) && call.status === 'offer') {
+   *         await sock.rejectCall(call.id, call.from);
+   *         // optionally remove caller from group:
+   *         // await sock.groupParticipantsUpdate(call.groupJid, [call.from], 'remove');
+   *       }
+   *     }
+   *   });
+   */
+  const isGroupCall = (call) => {
+      return !!(call === null || call === void 0 ? void 0 : call.isGroup);
+  };
+  exports.isGroupCall = isGroupCall;
+
+  /** Alias — same as isGroupCall, matching antiCall naming convention */
+  const isAntiCall = isGroupCall;
+  exports.isAntiCall = isAntiCall;
+
+  /**
+   * Returns true if the call is a VIDEO call (group or private)
+   */
+  const isVideoCall = (call) => {
+      return !!(call === null || call === void 0 ? void 0 : call.isVideo);
+  };
+  exports.isVideoCall = isVideoCall;
+
+  /**
+   * Returns true if the call is incoming (status === 'offer')
+   * Use this to filter only new calls (not accept/reject/timeout)
+   */
+  const isIncomingCall = (call) => {
+      return (call === null || call === void 0 ? void 0 : call.status) === 'offer';
+  };
+  exports.isIncomingCall = isIncomingCall;
   

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "davexbaileys",
-    "version": "2.5.16",
+    "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",