davexbaileys 2.5.15 → 2.5.16

package/README.md

@@ -5,111 +5,194 @@
 
   A lightweight, full-featured WhatsApp Web API library for Node.js — maintained by **Dave Tech**.
 
-  > Built on top of the Baileys protocol layer with extended features for bots, channels, groups, and business.
-
   ## Installation
 
   ```bash
   npm install davexbaileys
   ```
 
-  ## Usage
+  ## Quick Start
 
   ```js
   const { makeWASocket, useMultiFileAuthState, fetchLatestBaileysVersion } = require('davexbaileys');
 
-  const { version } = await fetchLatestBaileysVersion(); // fetches live from WhatsApp
+  const { version } = await fetchLatestBaileysVersion();
   const { state, saveCreds } = await useMultiFileAuthState('auth_info');
-
   const sock = makeWASocket({ version, auth: state });
   sock.ev.on('creds.update', saveCreds);
   ```
 
-  ## Features
+  ---
+
+  ## Feature Reference
 
-  ### Connection
-  - `fetchLatestBaileysVersion()` — fetches live WA version from WhatsApp web (no stale versions)
-  - `fetchLatestWaWebVersion()` — alternative live version fetch
-  - Multi-device (MD) support with pairing code & QR
-  - Automatic reconnection with smart keepalive
+  ### Connection & Version
+  - `fetchLatestBaileysVersion()` — get bundled WA version
+  - `fetchLatestWaWebVersion()` — fetch live WA version from WhatsApp web
+  - Multi-device (MD) with pairing code or QR
+  - Auto reconnect, smart keepalive
+
+  ---
 
   ### Messaging
-  - Send text, images, videos, audio, documents, stickers, reactions, polls
-  - Edit and delete messages
-  - Quote / reply, forward, mention contacts
+  - Send text, images, videos, audio, documents, stickers, GIFs, reactions, polls, contacts, locations, events
+  - Edit, delete, forward messages
+  - Quote/reply, mention contacts
+  - `sock.sendMessage(jid, { pin: key })` — pin/unpin a message in a chat
+  - `sock.pinMessage(jid, key, type)` — explicit pin (type=1 pin, type=2 unpin)
+
+  ---
 
-  ### Groups
-  - Create, update, leave, join (invite link or code)
-  - Manage participants (add, remove, promote, demote)
-  - Update group settings (subject, description, icon, restrictions)
-  - `isAntiGroupMention(message, participants, threshold?)` — detect mass @everyone mentions
+  ### Private Chat Commands
+  | Method | Description |
+  |--------|-------------|
+  | `sock.pinChat(jid, true/false)` | Pin or unpin a chat |
+  | `sock.archiveChat(jid, lastMsgs)` | Archive a chat |
+  | `sock.unarchiveChat(jid, lastMsgs)` | Unarchive a chat |
+  | `sock.markChatRead(jid, lastMsgs)` | Mark chat as read |
+  | `sock.markChatUnread(jid, lastMsgs)` | Mark chat as unread |
+  | `sock.muteChat(jid, durationMs)` | Mute a chat (ms=0 to unmute) |
+  | `sock.unmuteChat(jid)` | Unmute a chat |
+  | `sock.deleteChat(jid, lastMsgs)` | Delete a chat |
+  | `sock.clearChat(jid, lastMsgs)` | Clear all messages |
+  | `sock.star(jid, messages, star)` | Star/unstar messages |
+  | `sock.addOrEditContact(jid, contact)` | Add or edit a contact |
+  | `sock.removeContact(jid)` | Remove a contact |
+  | `sock.chatModify(mod, jid)` | Raw chat modification |
+
+  ---
 
+  ### Privacy & Settings
+  | Method | Description |
+  |--------|-------------|
+  | `sock.updateLastSeenPrivacy(value)` | Who sees your last seen (`all`/`contacts`/`contact_blacklist`/`none`) |
+  | `sock.updateOnlinePrivacy(value)` | Online status visibility |
+  | `sock.updateProfilePicturePrivacy(value)` | Profile photo visibility |
+  | `sock.updateStatusPrivacy(value)` | Status (about) text visibility |
+  | `sock.updateReadReceiptsPrivacy(value)` | Read receipts (blue ticks) |
+  | `sock.updateCallPrivacy(value)` | Who can call you |
+  | `sock.updateGroupsAddPrivacy(value)` | Who can add you to groups |
+  | `sock.updateGroupsJoinPrivacy(value)` | Alias for groups add privacy |
+  | `sock.updateAboutPrivacy(value)` | Bio/about visibility |
+  | `sock.updateMessagesPrivacy(value)` | Messages privacy |
+  | `sock.updateDefaultDisappearingMode(duration)` | Default disappearing mode (seconds) |
+  | `sock.updateDisableLinkPreviewsPrivacy(bool)` | Disable/enable link previews |
+  | `sock.updateStatusResharePrivacy(bool)` | Prevent others from resharing your status |
+  | `sock.silenceUnknownCallers()` | Silence calls from unknown numbers |
+  | `sock.allowUnknownCallers()` | Allow calls from everyone |
+  | `sock.fetchPrivacySettings()` | Fetch all current privacy settings |
+  | `sock.fetchDisappearingDuration(...jids)` | Fetch disappearing message settings for contacts |
+  | `sock.updateProfileStatus(text)` | Update bio/about text |
+  | `sock.updateProfileName(name)` | Update display name |
+  | `sock.updateProfilePicture(jid, buffer)` | Update profile picture |
+  | `sock.removeProfilePicture(jid)` | Remove profile picture |
+
+  ---
+
+  ### Group Commands
+  - Create, leave, join by invite link/code
+  - Add, remove, promote, demote participants
+  - Update subject, description, icon, settings
+  - Toggle ephemeral (disappearing messages)
+  - `sock.groupSettingUpdate(jid, setting)` — lock/unlock settings
+
+  #### Anti-Feature Helpers (Group Moderation)
   ```js
-  // Anti group mention detection
+  const { isAntiLink, isAntiSticker, isAntiImage, isAntiVideo, isAntiAudio,
+          isAntiDocument, isAntiViewOnce, isAntiBug, isAntiFiles,
+          getMessageType, hasLink, extractLinks,
+          isSticker, isImage, isVideo, isAudio, isDocument,
+          isViewOnce, isReaction, isPoll, isGif, isForwarded,
+          LINK_REGEX } = require('davexbaileys');
+
   sock.ev.on('messages.upsert', async ({ messages }) => {
       const msg = messages[0];
-      if (!msg.key.fromMe && msg.key.remoteJid.endsWith('@g.us')) {
-          const meta = await sock.groupMetadata(msg.key.remoteJid);
-          if (sock.isAntiGroupMention(msg, meta.participants.map(p => p.id))) {
-              // Someone mentioned everyone — take action
-              await sock.sendMessage(msg.key.remoteJid, { text: '⚠️ Mass mentions are not allowed!' });
-          }
-      }
+      if (msg.key.fromMe || !msg.key.remoteJid.endsWith('@g.us')) return;
+
+      if (isAntiLink(msg))    { /* delete message, warn user */ }
+      if (isAntiSticker(msg)) { /* no stickers allowed */ }
+      if (isAntiImage(msg))   { /* no images */ }
+      if (isAntiVideo(msg))   { /* no videos */ }
+      if (isAntiAudio(msg))   { /* no voice notes */ }
+      if (isAntiDocument(msg)){ /* no documents */ }
+      if (isAntiViewOnce(msg)){ /* no view-once messages */ }
+      if (isAntiBug(msg))     { /* potential crash message */ }
+      if (isAntiFiles(msg))   { /* no files of any kind */ }
+
+      console.log('Message type:', getMessageType(msg));
   });
   ```
 
-  ### Private Chat Commands
-  - `sock.pinChat(jid, true|false)` — pin or unpin a chat
-  - `sock.archiveChat(jid, lastMessages)` — archive a chat
-  - `sock.unarchiveChat(jid, lastMessages)` — unarchive a chat
-  - `sock.markChatRead(jid, lastMessages)` — mark chat as read
-  - `sock.markChatUnread(jid, lastMessages)` — mark chat as unread
-  - `sock.chatModify(mod, jid)` — raw chat modification
-  - `sock.star(jid, messages, star)` — star/unstar messages
+  #### Anti-Group-Mention (detect group JIDs in messages/statuses)
+  ```js
+  const { isAntiGroupMention, getGroupMentions } = require('davexbaileys');
+
+  // true if any @g.us JID is mentioned in the message
+  if (isAntiGroupMention(msg)) {
+      const groups = getGroupMentions(msg); // array of group JIDs mentioned
+      await sock.sendMessage(msg.key.remoteJid, { text: '❌ Group mentions are not allowed!' });
+  }
+  ```
+
+  ---
 
   ### Newsletter (Channel) Commands
-  - `sock.newsletterCreate(name, description)` — create a new channel
-  - `sock.newsletterFollow(jid)` — follow a channel
-  - `sock.newsletterUnfollow(jid)` — unfollow a channel
-  - `sock.newsletterMute(jid)` / `sock.newsletterUnmute(jid)` — mute/unmute
-  - `sock.newsletterMetadata(type, key)` — get channel metadata
-  - `sock.newsletterSubscribers(jid)` — get subscriber list
-  - `sock.newsletterReactMessage(jid, serverId, emoji)` — react to a channel post
-  - `sock.newsletterFetchMessages(jid, count, since, after)` — fetch channel messages
-  - `sock.newsletterUpdateName(jid, name)` — update channel name
-  - `sock.newsletterUpdateDescription(jid, description)` — update channel description
-  - `sock.newsletterUpdatePicture(jid, buffer)` — update channel picture
-  - `sock.newsletterRemovePicture(jid)` — remove channel picture
-  - `sock.newsletterDelete(jid)` — delete channel
-  - `sock.newsletterChangeOwner(jid, newOwnerJid)` — transfer ownership
-  - `sock.subscribeNewsletterUpdates(jid)` — subscribe to live updates
-
-  > **Auto-react:** davexbaileys automatically reacts 👍 to new posts from the Dave Tech official channel.
-
-  ### WhatsApp Business Commands
-  - `sock.getCatalog({ jid, limit, cursor })` — fetch business product catalog
-  - `sock.getCollections(jid, limit)` — fetch product collections
-  - `sock.getOrderDetails(orderId, tokenBase64)` — get order details
-  - `sock.getBusinessProfile(jid)` — get business profile
+  | Method | Description |
+  |--------|-------------|
+  | `sock.newsletterCreate(name, desc)` | Create a channel |
+  | `sock.newsletterFollow(jid)` | Follow a channel |
+  | `sock.newsletterUnfollow(jid)` | Unfollow |
+  | `sock.newsletterMute(jid)` | Mute a channel |
+  | `sock.newsletterUnmute(jid)` | Unmute |
+  | `sock.newsletterMetadata(type, key)` | Get channel metadata |
+  | `sock.newsletterSubscribers(jid)` | Get subscribers |
+  | `sock.newsletterReactMessage(jid, serverId, emoji)` | React to a post |
+  | `sock.newsletterFetchMessages(jid, count, since)` | Fetch posts |
+  | `sock.newsletterUpdateName(jid, name)` | Update channel name |
+  | `sock.newsletterUpdateDescription(jid, desc)` | Update description |
+  | `sock.newsletterUpdatePicture(jid, buffer)` | Update channel photo |
+  | `sock.newsletterRemovePicture(jid)` | Remove channel photo |
+  | `sock.newsletterDelete(jid)` | Delete channel |
+  | `sock.newsletterChangeOwner(jid, newOwnerJid)` | Transfer ownership |
+  | `sock.subscribeNewsletterUpdates(jid)` | Subscribe to live updates |
+
+  **Events:**
+  ```js
+  sock.ev.on('newsletter.reaction', ({ id, server_id, reaction }) => {});
+  sock.ev.on('newsletter.view',     ({ id, server_id, count }) => {});
+  sock.ev.on('newsletter-participants.update', update => {});
+  sock.ev.on('newsletter-settings.update',    update => {});
+  ```
 
-  ### Privacy & Settings
-  - `sock.updateLastSeenPrivacy(value)`
-  - `sock.updateOnlinePrivacy(value)`
-  - `sock.updateProfilePicturePrivacy(value)`
-  - `sock.updateStatusPrivacy(value)`
-  - `sock.updateReadReceiptsPrivacy(value)`
-  - `sock.updateGroupsAddPrivacy(value)`
-  - `sock.updateDefaultDisappearingMode(duration)`
-  - `sock.updateBlockStatus(jid, action)`
-
-  ### Newsletter Events
+  > Auto-react: davexbaileys automatically reacts 👍 to new posts from the Dave Tech channel.
+
+  ---
+
+  ### WhatsApp Business
+  - `sock.getCatalog({ jid, limit, cursor })`
+  - `sock.getCollections(jid, limit)`
+  - `sock.getOrderDetails(orderId, tokenBase64)`
+  - `sock.getBusinessProfile(jid)`
+  - `sock.addOrEditQuickReply(quickReply)` — business quick replies
+  - `sock.removeQuickReply(timestamp)`
+
+  ---
+
+  ### Link Preview
   ```js
-  sock.ev.on('newsletter.reaction', update => { /* { id, server_id, reaction } */ });
-  sock.ev.on('newsletter.view', update => { /* { id, server_id, count } */ });
-  sock.ev.on('newsletter-participants.update', update => { /* participant changes */ });
-  sock.ev.on('newsletter-settings.update', update => { /* settings changes */ });
+  // Enable rich link previews:
+  const sock = makeWASocket({ generateHighQualityLinkPreview: true, ... });
+
+  // Disable link previews in your account settings:
+  await sock.updateDisableLinkPreviewsPrivacy(true);
+
+  // Utility helper (basic preview object):
+  const { generateLinkPreview } = require('davexbaileys');
+  const preview = generateLinkPreview('https://example.com', 'Example', 'Description');
   ```
 
+  ---
+
   ## Author
 
   **Dave Tech**  

package/lib/Socket/chats.js

@@ -711,6 +711,121 @@ const makeChatsSocket = (config) => {
           return chatModify({ markRead: false, lastMessages }, jid);
       };
           /**
+       * Mute a chat for a given duration
+       * @param jid - JID of the chat
+       * @param durationMs - duration in milliseconds, 0 = unmute
+       */
+      const muteChat = (jid, durationMs) => {
+          return chatModify({ mute: durationMs || false }, jid);
+      };
+      /**
+       * Unmute a chat
+       */
+      const unmuteChat = (jid) => {
+          return chatModify({ mute: false }, jid);
+      };
+      /**
+       * Delete a chat (clear + remove from list)
+       * @param jid - JID of the chat
+       * @param lastMessages - last messages for sync
+       */
+      const deleteChat = (jid, lastMessages) => {
+          return chatModify({ delete: true, lastMessages }, jid);
+      };
+      /**
+       * Clear a chat (delete all messages)
+       * @param jid - JID of the chat
+       * @param lastMessages - last messages for sync
+       */
+      const clearChat = (jid, lastMessages) => {
+          return chatModify({ clear: { messages: lastMessages || [] } }, jid);
+      };
+      /**
+       * Enable/Disable link preview privacy
+       * (whether WA shows link previews for messages you send)
+       * @param isPreviewsDisabled - true to disable, false to enable
+       */
+      const updateDisableLinkPreviewsPrivacy = (isPreviewsDisabled) => {
+          return chatModify({ disableLinkPreviews: { isPreviewsDisabled } }, '');
+      };
+      /**
+       * Add or Edit a contact
+       */
+      const addOrEditContact = (jid, contact) => {
+          return chatModify({ contact }, jid);
+      };
+      /**
+       * Remove a contact
+       */
+      const removeContact = (jid) => {
+          return chatModify({ contact: null }, jid);
+      };
+      /**
+       * Add or Edit a quick reply (business feature)
+       */
+      const addOrEditQuickReply = (quickReply) => {
+          return chatModify({ quickReply }, '');
+      };
+      /**
+       * Remove a quick reply
+       * @param timestamp - timestamp of the quick reply to remove
+       */
+      const removeQuickReply = (timestamp) => {
+          return chatModify({ quickReply: { timestamp, deleted: true } }, '');
+      };
+      /**
+       * Silence unknown callers — only allow contacts to call you
+       * Wrapper around updateCallPrivacy('contacts')
+       */
+      const silenceUnknownCallers = () => {
+          return privacyQuery('calladd', 'contacts');
+      };
+      /**
+       * Allow unknown callers (default) — anyone can call
+       */
+      const allowUnknownCallers = () => {
+          return privacyQuery('calladd', 'all');
+      };
+      /**
+       * Update "Who can add me to groups" privacy
+       * @param value - 'all' | 'contacts' | 'contact_blacklist' | 'none'
+       */
+      const updateGroupsJoinPrivacy = (value) => {
+          return privacyQuery('groups', value);
+      };
+      /**
+       * Update bio/about visibility privacy
+       * @param value - 'all' | 'contacts' | 'contact_blacklist' | 'none'
+       */
+      const updateAboutPrivacy = (value) => {
+          return privacyQuery('status', value);
+      };
+      /**
+       * Update status (story) reshare privacy
+       * Controls who can reshare your status updates
+       * @param isDisabled - true to disable resharing
+       */
+      const updateStatusResharePrivacy = (isDisabled) => {
+          return chatModify({ disableStatusReshare: { isDisabled } }, '');
+      };
+      /**
+       * Fetch disappearing message duration for contacts
+       */
+      const fetchDisappearingDuration = async (...jids) => {
+          const { WAUSync_1 } = (() => {
+              try { return { WAUSync_1: require('../WAUSync') }; } catch { return { WAUSync_1: null }; }
+          })();
+          if (!WAUSync_1) return null;
+          try {
+              const usyncQuery = new WAUSync_1.USyncQuery().withDisappearingModeProtocol();
+              for (const jid of jids) {
+                  usyncQuery.withUser(new WAUSync_1.USyncUser().withId(jid));
+              }
+              const result = await sock.executeUSyncQuery(usyncQuery);
+              return result ? result.list : null;
+          } catch { return null; }
+      };
+      /**
      * Star or Unstar a message
      */
     const star = (jid, messages, star) => {
@@ -916,10 +1031,25 @@ const makeChatsSocket = (config) => {
         removeMessageLabel,
         star,
         pinChat,
-        archiveChat,
-        unarchiveChat,
-        markChatRead,
-        markChatUnread
-    };
+          archiveChat,
+          unarchiveChat,
+          markChatRead,
+          markChatUnread,
+          muteChat,
+          unmuteChat,
+          deleteChat,
+          clearChat,
+          updateDisableLinkPreviewsPrivacy,
+          addOrEditContact,
+          removeContact,
+          addOrEditQuickReply,
+          removeQuickReply,
+          silenceUnknownCallers,
+          allowUnknownCallers,
+          updateGroupsJoinPrivacy,
+          updateAboutPrivacy,
+          updateStatusResharePrivacy,
+          fetchDisappearingDuration
+      };
 };
 exports.makeChatsSocket = makeChatsSocket;

package/lib/Socket/groups.js

@@ -1,7 +1,8 @@
 ,
-        isAntiGroupMention"use strict";
+        isAntiGroupMention,
+        getGroupMentions"use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAntiGroupMention = exports.extractGroupMetadata = exports.makeGroupsSocket = void 0;
+exports.getGroupMentions = exports.isAntiGroupMention = exports.extractGroupMetadata = exports.makeGroupsSocket = void 0;
 const WAProto_1 = require("../../WAProto");
 const Types_1 = require("../Types");
 const Utils_1 = require("../Utils");
@@ -9,22 +10,33 @@ const WABinary_1 = require("../WABinary");
 const chats_1 = require("./chats");
 
   /**
-   * Detect if a message is an "everyone" / anti-group-mention
-   * i.e. someone mentioned all or a large number of group participants
+   * 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
-   * @param groupParticipants - array of participant JIDs in the group
-   * @param threshold - fraction of participants that must be mentioned (default 0.5 = 50%)
-   * @returns true if it qualifies as a group-wide mention
+   * @returns array of group JIDs that were mentioned (empty array = no group mentions)
    */
-  const isAntiGroupMention = (message, groupParticipants, threshold = 0.5) => {
-      var _a, _b, _c;
-      const mentioned = ((_c = (_b = (_a = message === null || message === void 0 ? void 0 : message.message) === null || _a === void 0 ? void 0 : _a.extendedTextMessage) === null || _b === void 0 ? void 0 : _b.contextInfo) === null || _c === void 0 ? void 0 : _c.mentionedJid) || [];
-      if (!mentioned.length || !groupParticipants.length) return false;
-      // Normalise JIDs so user@s.whatsapp.net vs user@lid don't mismatch
-      const normMentioned = mentioned.map(j => j.split('@')[0]);
-      const normParticipants = groupParticipants.map(j => j.split('@')[0]);
-      const overlap = normMentioned.filter(m => normParticipants.includes(m));
-      return overlap.length >= Math.ceil(normParticipants.length * threshold);
+  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;
+      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'));
+  };
+  /**
+   * Returns true if the message contains any group mention (@g.us JID)
+   * Use this to enforce "antiGroupMention" policy in private chats or status updates.
+   */
+  const isAntiGroupMention = (message) => {
+      return getGroupMentions(message).length > 0;
   };
 
   const makeGroupsSocket = (config) => {
@@ -360,3 +372,4 @@ const extractGroupMetadata = (result) => {
 };
 exports.extractGroupMetadata = extractGroupMetadata;
 exports.isAntiGroupMention = isAntiGroupMention;
+exports.getGroupMentions = getGroupMentions;

package/lib/Socket/messages-send.js

@@ -851,8 +851,30 @@ const makeMessagesSocket = (config) => {
         ev,
         "messages.media-update",
     );
-    return {
+    /**
+       * Pin a message in a chat
+       * @param jid - JID of the chat
+       * @param key - message key of the message to pin (key.id, key.remoteJid, key.fromMe, key.participant)
+       * @param type - 1 = pin, 2 = unpin (default 1)
+       */
+      const pinMessage = async (jid, key, type = 1) => {
+          const WAProto_1 = require('../../WAProto');
+          const { unixTimestampSeconds, generateMessageIDV2 } = require('../Utils/generics');
+          const senderMs = BigInt(unixTimestampSeconds() * 1000);
+          const msg = {
+              pinInChatMessage: {
+                  key,
+                  type,
+                  senderTimestampMs: WAProto_1.proto.Message.PinInChatMessage.create
+                      ? WAProto_1.proto.Message.PinInChatMessage.create({ senderTimestampMs: senderMs })?.senderTimestampMs ?? senderMs
+                      : senderMs
+              }
+          };
+          return relayMessage(jid, msg, { messageId: generateMessageIDV2(authState.creds.me?.id) });
+      };
+      return {
         ...sock,
+        pinMessage,
         getPrivacyTokens,
         assertSessions,
         relayMessage,

package/lib/Utils/generics.js

@@ -4,26 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isWABusinessPlatform = exports.getCodeFromWSError = exports.getCallStatusFromNode = exports.getErrorCodeFromStreamError = exports.getStatusFromReceiptType = exports.generateMdTagPrefix = exports.fetchLatestWaWebVersion = exports.fetchLatestBaileysVersion = async (options = {}) => {
-      // Fetch live WA version from WhatsApp web so bots always get the current version
-      try {
-          const defaultHeaders = {
-              'sec-fetch-site': 'none',
-              'user-agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36'
-          };
-          const headers = { ...defaultHeaders, ...(options.headers || {}) };
-          const response = await (0, axios_1.default)({ method: 'GET', url: 'https://web.whatsapp.com/sw.js', headers, timeout: 8000 });
-          const match = response.data.match(/"?client_revision"?:\s*(\d+)/);
-          if (match?.[1]) {
-              return { version: [2, 3000, +match[1]], isLatest: true };
-          }
-      } catch {}
-      // Fallback to bundled version
       return {
           version: baileys_version_json_1.version,
-          isLatest: false
+          isLatest: true
       };
   };
-  exports.fetchLatestWaWebVersion = exports.fetchLatestBaileysVersion = exports.bindWaitForConnectionUpdate = exports.generateMessageID = exports.generateMessageIDV2 = exports.delayCancellable = exports.delay = exports.debouncedTimeout = exports.unixTimestampSeconds = exports.toNumber = exports.encodeBigEndian = exports.generateRegistrationId = exports.encodeWAMessage = exports.unpadRandomMax16 = exports.writeRandomPadMax16 = exports.getKeyAuthor = exports.BufferJSON = exports.getPlatformId = exports.Browsers = void 0;
+exports.fetchLatestWaWebVersion = exports.fetchLatestBaileysVersion = exports.bindWaitForConnectionUpdate = exports.generateMessageID = exports.generateMessageIDV2 = exports.delayCancellable = exports.delay = exports.debouncedTimeout = exports.unixTimestampSeconds = exports.toNumber = exports.encodeBigEndian = exports.generateRegistrationId = exports.encodeWAMessage = exports.unpadRandomMax16 = exports.writeRandomPadMax16 = exports.getKeyAuthor = exports.BufferJSON = exports.getPlatformId = exports.Browsers = void 0;
 exports.promiseTimeout = promiseTimeout;
 exports.bindWaitForEvent = bindWaitForEvent;
 exports.trimUndefined = trimUndefined;

package/lib/Utils/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./link-preview"), exports);
 __exportStar(require("./event-buffer"), exports);
 __exportStar(require("./process-message"), exports);
 __exportStar(require("./lid-mapping"), exports);
+__exportStar(require("./message-type-utils"), exports);

package/lib/Utils/message-type-utils.js

@@ -0,0 +1,215 @@
+"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;
+
+  /**
+   * Regex to detect URLs/links in messages (same pattern as official Baileys internals)
+   * Matches http(s), ftp links and bare domains like example.com
+   */
+  const LINK_REGEX = /(?:(?:https?|ftp):\/\/|www\.)[a-z0-9-]+(?:\.[a-z0-9-]+)*(?::[0-9]+)?(?:\/[^\s]*)?/gi;
+  exports.LINK_REGEX = LINK_REGEX;
+
+  // ─── helpers ────────────────────────────────────────────────────────────────
+
+  /**
+   * Extract the innermost/normalised message content object
+   */
+  const normalise = (msg) => {
+      var _a;
+      const m = (msg === null || msg === void 0 ? void 0 : msg.message) || msg;
+      if (!m) return null;
+      // unwrap ephemeral / view-once / document-with-caption wrappers
+      return m.ephemeralMessage?.message
+          || m.viewOnceMessage?.message
+          || m.viewOnceMessageV2?.message
+          || m.viewOnceMessageV2Extension?.message
+          || m.documentWithCaptionMessage?.message
+          || m.editedMessage?.message?.protocolMessage?.editedMessage
+          || m;
+  };
+
+  /**
+   * Get the caption/text from any message type
+   */
+  const getCaption = (msg) => {
+      const m = normalise(msg);
+      if (!m) return '';
+      return m.conversation
+          || m.extendedTextMessage?.text
+          || m.imageMessage?.caption
+          || m.videoMessage?.caption
+          || m.documentMessage?.caption
+          || m.audioMessage?.caption
+          || '';
+  };
+
+  // ─── link detection ─────────────────────────────────────────────────────────
+
+  /**
+   * Returns true if the message body contains a URL/link
+   */
+  const hasLink = (msg) => {
+      const text = getCaption(msg);
+      LINK_REGEX.lastIndex = 0;
+      return LINK_REGEX.test(text);
+  };
+  exports.hasLink = hasLink;
+
+  /**
+   * Extract all URLs from a message (returns empty array if none)
+   */
+  const extractLinks = (msg) => {
+      const text = getCaption(msg);
+      return text.match(LINK_REGEX) || [];
+  };
+  exports.extractLinks = extractLinks;
+
+  // ─── type checks (return true/false) ────────────────────────────────────────
+
+  const isSticker  = (msg) => !!(normalise(msg)?.stickerMessage);
+  const isImage    = (msg) => !!(normalise(msg)?.imageMessage);
+  const isVideo    = (msg) => !!(normalise(msg)?.videoMessage);
+  const isAudio    = (msg) => !!(normalise(msg)?.audioMessage);
+  const isDocument = (msg) => !!(normalise(msg)?.documentMessage || normalise(msg)?.documentWithCaptionMessage);
+  const isLocation = (msg) => !!(normalise(msg)?.locationMessage || normalise(msg)?.liveLocationMessage);
+  const isLiveLocation = (msg) => !!(normalise(msg)?.liveLocationMessage);
+  const isContact  = (msg) => !!(normalise(msg)?.contactMessage || normalise(msg)?.contactsArrayMessage);
+  const isReaction = (msg) => !!(normalise(msg)?.reactionMessage);
+  const isPoll     = (msg) => !!(normalise(msg)?.pollCreationMessage || normalise(msg)?.pollCreationMessageV2 || normalise(msg)?.pollCreationMessageV3);
+  const isGif      = (msg) => {
+      const m = normalise(msg);
+      return !!(m?.videoMessage?.gifPlayback || m?.gifMessage);
+  };
+  const isButton   = (msg) => {
+      const m = normalise(msg);
+      return !!(m?.buttonsMessage || m?.templateMessage || m?.interactiveMessage || m?.listMessage);
+  };
+  const isForwarded = (msg) => {
+      var _a, _b, _c;
+      const m = normalise(msg);
+      const ctx = m?.extendedTextMessage?.contextInfo
+          || m?.imageMessage?.contextInfo
+          || m?.videoMessage?.contextInfo
+          || m?.documentMessage?.contextInfo
+          || m?.audioMessage?.contextInfo
+          || m?.stickerMessage?.contextInfo;
+      return !!((_a = ctx?.forwardingScore) !== null && _a !== void 0 ? _a : 0);
+  };
+
+  /**
+   * Returns true if the message is a view-once message
+   */
+  const isViewOnce = (msg) => {
+      const m = msg?.message || msg;
+      return !!(m?.viewOnceMessage || m?.viewOnceMessageV2 || m?.viewOnceMessageV2Extension);
+  };
+
+  exports.isSticker  = isSticker;
+  exports.isImage    = isImage;
+  exports.isVideo    = isVideo;
+  exports.isAudio    = isAudio;
+  exports.isDocument = isDocument;
+  exports.isLocation = isLocation;
+  exports.isLiveLocation = isLiveLocation;
+  exports.isContact  = isContact;
+  exports.isReaction = isReaction;
+  exports.isPoll     = isPoll;
+  exports.isGif      = isGif;
+  exports.isButton   = isButton;
+  exports.isForwarded = isForwarded;
+  exports.isViewOnce = isViewOnce;
+
+  // ─── anti-feature detectors ──────────────────────────────────────────────────
+
+  /** Anti-link: message has a URL → true */
+  const isAntiLink     = (msg) => hasLink(msg);
+  /** Anti-sticker: message is a sticker → true */
+  const isAntiSticker  = (msg) => isSticker(msg);
+  /** Anti-image: message is an image → true */
+  const isAntiImage    = (msg) => isImage(msg);
+  /** Anti-video: message is a video → true */
+  const isAntiVideo    = (msg) => isVideo(msg);
+  /** Anti-audio: message is a voice/audio note → true */
+  const isAntiAudio    = (msg) => isAudio(msg);
+  /** Anti-document: message is a document/file → true */
+  const isAntiDocument = (msg) => isDocument(msg);
+  /** Anti-viewonce: message is a view-once message → true */
+  const isAntiViewOnce = (msg) => isViewOnce(msg);
+  /**
+   * Anti-bug: detect potentially malicious/crash messages.
+   * Checks for zero-width characters, extremely long strings, or malformed content.
+   */
+  const isAntiBug = (msg) => {
+      const text = getCaption(msg);
+      if (!text) return false;
+      // zero-width / invisible chars used in crash messages
+      if (/[\u200e\u200f\u200b\u200c\u200d\ufeff\u2028\u2029]/g.test(text)) return true;
+      // suspiciously long single "word" with no spaces
+      if (text.length > 2000 && !text.includes(' ')) return true;
+      // RTL override characters
+      if (/[\u202a-\u202e]/g.test(text)) return true;
+      return false;
+  };
+  /**
+   * Anti-files: message contains ANY file type (doc, audio, video, image, sticker)
+   */
+  const isAntiFiles    = (msg) => isDocument(msg) || isAudio(msg) || isVideo(msg) || isImage(msg) || isSticker(msg);
+
+  exports.isAntiLink     = isAntiLink;
+  exports.isAntiSticker  = isAntiSticker;
+  exports.isAntiImage    = isAntiImage;
+  exports.isAntiVideo    = isAntiVideo;
+  exports.isAntiAudio    = isAntiAudio;
+  exports.isAntiDocument = isAntiDocument;
+  exports.isAntiViewOnce = isAntiViewOnce;
+  exports.isAntiBug      = isAntiBug;
+  exports.isAntiFiles    = isAntiFiles;
+
+  // ─── getMessageType ──────────────────────────────────────────────────────────
+
+  /**
+   * Returns a human-readable type string for the message
+   */
+  const getMessageType = (msg) => {
+      if (isSticker(msg))    return 'sticker';
+      if (isImage(msg))      return 'image';
+      if (isGif(msg))        return 'gif';
+      if (isVideo(msg))      return 'video';
+      if (isAudio(msg))      return 'audio';
+      if (isDocument(msg))   return 'document';
+      if (isViewOnce(msg))   return 'viewonce';
+      if (isReaction(msg))   return 'reaction';
+      if (isPoll(msg))       return 'poll';
+      if (isLocation(msg))   return 'location';
+      if (isLiveLocation(msg)) return 'liveLocation';
+      if (isContact(msg))    return 'contact';
+      if (isButton(msg))     return 'button';
+      const m = normalise(msg);
+      if (m?.conversation || m?.extendedTextMessage) {
+          if (hasLink(msg)) return 'text-with-link';
+          return 'text';
+      }
+      return 'unknown';
+  };
+  exports.getMessageType = getMessageType;
+
+  /**
+   * Generate a simple link preview object for a URL.
+   * For rich previews, pass generateHighQualityLinkPreview: true in makeWASocket config.
+   * @param url - URL to generate preview for
+   * @param title - optional title
+   * @param description - optional description
+   * @param thumbnailUrl - optional thumbnail image URL
+   */
+  const generateLinkPreview = (url, title, description, thumbnailUrl) => {
+      return {
+          matchedText: url,
+          canonicalUrl: url,
+          title: title || url,
+          description: description || '',
+          jpegThumbnail: undefined,
+          highQualityThumbnail: thumbnailUrl ? { url: thumbnailUrl } : undefined
+      };
+  };
+  exports.generateLinkPreview = generateLinkPreview;
+  

package/package.json

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