@crysnovax/baileys 2.6.4 → 2.6.6

package/README.md

@@ -732,6 +732,42 @@ await sock.sendMessage(jid, {
 })
 ```
 
+### Rich preview for group status 
+```
+// Fully auto — fetches title, description, image from the URL
+await sock.sendMessage(jid, {
+    text: 'https://facebook.com/share/v/14i...',
+    richPreview: true
+})
+
+// Group status with auto-fetched preview
+await sock.sendMessage(jid, {
+    text: 'https://chat.whatsapp.com/CODE',
+    richPreview: true,
+    groupStatus: true
+})
+```
+### SEND MESSAGES EXACTLY AS IS NO PROCESSING 
+```
+// Relay a received message exactly as-is
+await sock.sendMessage(jid, {
+    likeThis: true,
+    ...m.message  // spread the captured message directly
+})
+
+// Send a manually constructed proto without normalization
+await sock.sendMessage(jid, {
+    likeThis: true,
+    imageMessage: { ...rawFields }
+})
+
+// Re-forward with original quality intact
+await sock.sendMessage(jid, {
+    likeThis: true,
+    ...capturedMsg.message
+})
+```
+
 ### WHATSAPP VERIFIED ☑️ ⚉
 send Media messages with verified WhatsApp check ✔️ 
 ```
@@ -741,6 +777,7 @@ await sock.sendMessage(jid, {
     verifiedMe: true
 })
 ```
+
 ---
 
 ## Meta AI Features

package/lib/Socket/messages-send.js

@@ -3,7 +3,7 @@ import { Boom } from '@hapi/boom';
 import { randomBytes } from 'crypto';
 import { proto } from '../../WAProto/index.js';
 import { BIZ_BOT_SUPPORT_PAYLOAD, DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
-import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, extractImageThumb, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, prepareWAMessageMedia, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
+import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, buildLinkPreview, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, extractImageThumb, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, prepareWAMessageMedia, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
 import { AssociationType } from '../Types/index.js';
 import { getUrlInfo } from '../Utils/link-preview.js';
 import { makeKeyedMutex, makeMutex } from '../Utils/make-mutex.js';
@@ -1269,6 +1269,7 @@ export const makeMessagesSocket = (config) => {
                     previewTitle,
                     previewDescription,
                     previewImage,
+                    groupStatus: isGroupStatus,
                     quoted,
                     ...restContent
                 } = content;
@@ -1277,24 +1278,35 @@ export const makeMessagesSocket = (config) => {
                     throw new Boom('richPreview requires a `text` field containing the URL', { statusCode: 400 });
                 }
 
-                // Resolve previewImage into a raw Buffer, whether given as
-                // a Buffer directly or a URL string to fetch
-                let imageBuffer = null;
-                if (previewImage) {
-                    if (Buffer.isBuffer(previewImage)) {
-                        imageBuffer = previewImage;
+                // Auto-fetch metadata (title, description, image) when not provided.
+                // Uses library helpers: fetchLinkMeta, resolvePreviewMeta, resolvePreviewImage,
+                // with special handling for chat.whatsapp.com invite links (uses groupGetInviteInfo
+                // + profilePictureUrl instead of scraping the bot-blocked page).
+                const _preview = await buildLinkPreview(
+                    previewLink,
+                    sock,
+                    {
+                        customTitle: previewTitle || '',
+                        customDesc: previewDescription || '',
+                        customImage: Buffer.isBuffer(previewImage) ? previewImage : null
                     }
-                    else if (typeof previewImage === 'string') {
-                        try {
-                            const res = await fetch(previewImage);
-                            imageBuffer = Buffer.from(await res.arrayBuffer());
-                        }
-                        catch (err) {
-                            logger?.warn({ err }, 'richPreview: failed to fetch previewImage URL');
-                        }
+                );
+
+                let imageBuffer = _preview.imageBuffer;
+
+                // If previewImage was a URL string, fetch it (overrides auto-fetch)
+                if (!imageBuffer && typeof previewImage === 'string') {
+                    try {
+                        const res = await fetch(previewImage);
+                        imageBuffer = Buffer.from(await res.arrayBuffer());
+                    } catch (err) {
+                        logger?.warn({ err }, 'richPreview: failed to fetch previewImage URL');
                     }
                 }
 
+                const resolvedTitle = previewTitle || _preview.title || '';
+                const resolvedDescription = previewDescription || _preview.description || '';
+
                 // Small embedded jpegThumbnail — kept under the ~7KB ceiling
                 // that causes WA clients to render a blank/black preview if exceeded.
                 // 296px @ quality 50 (fixed internally by extractImageThumb) sits
@@ -1323,41 +1335,48 @@ export const makeMessagesSocket = (config) => {
                     }
                 }
 
-                const previewMessage = {
-                    extendedTextMessage: {
-                        text: previewLink,
-                        matchedText: previewLink,
-                        canonicalUrl: previewLink,
-                        title: previewTitle || '',
-                        description: previewDescription || '',
-                        previewType: 5, // IMAGE
-                        jpegThumbnail: smallThumb || undefined,
-                        ...(hq
-                            ? {
-                                thumbnailDirectPath: hq.directPath,
-                                mediaKey: hq.mediaKey,
-                                mediaKeyTimestamp: hq.mediaKeyTimestamp,
-                                thumbnailWidth: hq.width,
-                                thumbnailHeight: hq.height,
-                                thumbnailSha256: hq.fileSha256,
-                                thumbnailEncSha256: hq.fileEncSha256
-                            }
-                            : {}),
-                        ...restContent
-                    }
+                const extendedText = {
+                    text: previewLink,
+                    matchedText: previewLink,
+                    canonicalUrl: previewLink,
+                    title: resolvedTitle,
+                    description: resolvedDescription,
+                    previewType: 5, // IMAGE
+                    jpegThumbnail: smallThumb || undefined,
+                    ...(hq
+                        ? {
+                            thumbnailDirectPath: hq.directPath,
+                            mediaKey: hq.mediaKey,
+                            mediaKeyTimestamp: hq.mediaKeyTimestamp,
+                            thumbnailWidth: hq.width,
+                            thumbnailHeight: hq.height,
+                            thumbnailSha256: hq.fileSha256,
+                            thumbnailEncSha256: hq.fileEncSha256
+                        }
+                        : {}),
+                    ...restContent
                 };
 
-                const msgId = options.messageId || generateMessageIDV2(userJid);
-
                 if (quoted) {
-                    previewMessage.extendedTextMessage.contextInfo = {
-                        ...(previewMessage.extendedTextMessage.contextInfo || {}),
+                    extendedText.contextInfo = {
+                        ...(extendedText.contextInfo || {}),
                         stanzaId: quoted.key.id,
                         participant: jidNormalizedUser(quoted.key.fromMe ? userJid : (quoted.key.participant || quoted.key.remoteJid)),
                         quotedMessage: quoted.message
                     };
                 }
 
+                // Support groupStatus:true alongside richPreview:true
+                if (isGroupStatus) {
+                    extendedText.contextInfo = { ...(extendedText.contextInfo || {}), isGroupStatus: true };
+                }
+
+                const previewMessage = isGroupStatus
+                    ? { groupStatusMessageV2: { message: { extendedTextMessage: extendedText } } }
+                    : { extendedTextMessage: extendedText };
+
+                const msgId = options.messageId || generateMessageIDV2(userJid);
+
                 await relayMessage(jid, previewMessage, {
                     messageId: msgId,
                     additionalAttributes: options.additionalAttributes || {},
@@ -1381,28 +1400,66 @@ export const makeMessagesSocket = (config) => {
                 }
                 return fullMsg;
             }
+                    // crysnovax@LikeThis --- likeThis:true relays the message object exactly as-is,
+            // bypassing generateWAMessage/generateWAMessageContent entirely.
+            // No re-encoding, no normalization, no transformation — what you pass is what WA gets.
+            //
+            // Useful for:
+            //   - Forwarding a message with original proto fields intact (no re-upload)
+            //   - Relaying a captured incoming message verbatim
+            //   - Sending a manually constructed proto without fighting normalization
+            //   - Re-sending albums/carousels without re-uploading every item
+            //
+            // WARNING: bypasses all validation — broken proto fields go straight to WA.
+            //
+            // Usage:
+            //   sock.sendMessage(jid, {
+            //       likeThis: true,
+            //       imageMessage: { ...rawProtoFields }
+            //   })
+            //   sock.sendMessage(jid, {
+            //       likeThis: true,
+            //       ...capturedMessage.message   // spread a received message directly
+            //   })
+            else if ('likeThis' in content && content.likeThis === true) {
+                const { likeThis: _, ...rawMessage } = content;
+                const msgId = options.messageId || generateMessageIDV2(userJid);
+
+                await relayMessage(jid, rawMessage, {
+                    messageId: msgId,
+                    additionalAttributes: options.additionalAttributes || {},
+                    additionalNodes: options.additionalNodes || []
+                });
+
+                const fullMsg = {
+                    key: {
+                        remoteJid: jid,
+                        fromMe: true,
+                        id: msgId
+                    },
+                    message: rawMessage,
+                    messageTimestamp: unixTimestampSeconds()
+                };
+
+                if (config.emitOwnEvents) {
+                    process.nextTick(async () => {
+                        await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+                    });
+                }
+                return fullMsg;
+            }
+            // ── NORMAL MESSAGE HANDLING ──
             else {
                 const fullMsg = await generateWAMessage(jid, content, {
                     logger,
                     userJid,
-                    getUrlInfo: text => getUrlInfo(text, {
-                        thumbnailWidth: linkPreviewImageThumbnailWidth,
-                        fetchOpts: {
-                            timeout: 3000,
-                            ...(httpRequestOptions || {})
-                        },
-                        logger,
-                        uploadImage: generateHighQualityLinkPreview ? waUploadToServer : undefined
-                    }),
-                    //TODO: CACHE
-                    getProfilePicUrl: sock.profilePictureUrl,
-                    getCallLink: sock.createCallLink,
                     upload: waUploadToServer,
                     mediaCache: config.mediaCache,
                     options: config.options,
                     ...options,
                     messageId: generateMessageIDV2(userJid)
                 });
+
                 const isNewsletter = isJidNewsletter(jid);
                 const isEventMsg = 'event' in content && !!content.event;
                 const isDeleteMsg = 'delete' in content && !!content.delete;
@@ -1415,9 +1472,8 @@ export const makeMessagesSocket = (config) => {
                 const isNeedBizAttrs = 'secureMetaServiceLabel' in content && !!content.secureMetaServiceLabel;
                 const additionalAttributes = options.additionalAttributes || {};
                 const additionalNodes = options.additionalNodes || [];
-                // required for delete
+
                 if (isDeleteMsg || isKeepMsg) {
-                    // if the chat is a group, and I am not the author, then delete the message as an admin
                     if (isJidGroup(content.delete?.remoteJid) && !content.delete?.fromMe) {
                         additionalAttributes.edit = '8';
                     }
@@ -1438,7 +1494,6 @@ export const makeMessagesSocket = (config) => {
                     additionalNodes.push({
                         tag: 'meta',
                         attrs: {
-                            // Lia@Note 08-02-26 --- Still a hypothesis regarding PollResult ༎ຶ⁠‿⁠༎ຶ
                             polltype: isQuizMsg ? 'quiz_creation' : 'creation',
                             contenttype: isPollMsg && isNewsletter ? 'text' : undefined
                         },
@@ -1454,7 +1509,6 @@ export const makeMessagesSocket = (config) => {
                         content: undefined
                     });
                 }
-                // Lia@Changes 30-01-26 --- Add support for AI label in message when "ai" is true, but works only in private chat
                 else if (isAiMsg) {
                     if (!(isPnUser(jid) || isLidUser(jid))) {
                         throw new Boom('AI icon on message are only allowed in private chat', { statusCode: 400 });
@@ -1462,7 +1516,6 @@ export const makeMessagesSocket = (config) => {
                     if ('messageContextInfo' in fullMsg.message && !!fullMsg.message.messageContextInfo) {
                         fullMsg.message.messageContextInfo.supportPayload = BIZ_BOT_SUPPORT_PAYLOAD;
                     }
-                    ;
                     additionalNodes.push({
                         tag: 'bot',
                         attrs: {
@@ -1472,6 +1525,7 @@ export const makeMessagesSocket = (config) => {
                     });
                     delete content.ai;
                 }
+
                 await relayMessage(jid, fullMsg.message, {
                     messageId: fullMsg.key.id,
                     useCachedGroupMetadata: options.useCachedGroupMetadata,
@@ -1480,13 +1534,14 @@ export const makeMessagesSocket = (config) => {
                     additionalAttributes,
                     additionalNodes
                 });
+
                 if (config.emitOwnEvents) {
                     process.nextTick(async () => {
                         await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
                     });
                 }
-                // Lia@Changes 31-01-26 --- Add support for album messages
-                // Lia@Note 06-02-26 --- Refactored to reduce high RSS usage (⁠╥⁠﹏⁠╥⁠)
+
+                // ── ALBUM MESSAGES ──
                 if ('album' in content) {
                     const { delayMs = 1500 } = options;
                     for (const albumMedia of content.album) {
@@ -1523,8 +1578,9 @@ export const makeMessagesSocket = (config) => {
                         await delay(delayMs);
                     }
                 }
+
                 return fullMsg;
             }
         }
-    };
-};
+    }
+};