@crysnovax/baileys 2.6.7 → 2.6.9

package/lib/Socket/{messages-send.js[failed] → messages-send.js[latest]}

@@ -1400,7 +1400,7 @@ export const makeMessagesSocket = (config) => {
                 }
                 return fullMsg;
             }
-            // crysnovax@LikeThis --- likeThis:true relays the message object exactly as-is,
+                    // 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.
             //
@@ -1448,20 +1448,18 @@ export const makeMessagesSocket = (config) => {
                 }
                 return fullMsg;
             }
-                            ...(httpRequestOptions || {})
-                        },
-                        logger,
-                        uploadImage: generateHighQualityLinkPreview ? waUploadToServer : undefined
-                    }),
-                    //TODO: CACHE
-                    getProfilePicUrl: sock.profilePictureUrl,
-                    getCallLink: sock.createCallLink,
+            // ── NORMAL MESSAGE HANDLING ──
+            else {
+                const fullMsg = await generateWAMessage(jid, content, {
+                    logger,
+                    userJid,
                     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;
@@ -1474,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';
                     }
@@ -1497,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
                         },
@@ -1513,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 });
@@ -1521,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: {
@@ -1531,6 +1525,7 @@ export const makeMessagesSocket = (config) => {
                     });
                     delete content.ai;
                 }
+
                 await relayMessage(jid, fullMsg.message, {
                     messageId: fullMsg.key.id,
                     useCachedGroupMetadata: options.useCachedGroupMetadata,
@@ -1539,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) {
@@ -1582,8 +1578,9 @@ export const makeMessagesSocket = (config) => {
                         await delay(delayMs);
                     }
                 }
+
                 return fullMsg;
             }
         }
-    };
+    }
 };

package/lib/Socket/{messages-send.js[old] → messages-send.js[working]}

@@ -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;
             }
         }
-    };
+    }
 };

package/lib/Socket/newsletter.js

@@ -36,35 +36,10 @@ const parseNewsletterMetadata = (result) => {
 };
 export const makeNewsletterSocket = (config) => {
     const sock = makeGroupsSocket(config);
-    const { query, generateMessageTag, ev, authState } = sock;
-    const { logger } = config;
+    const { query, generateMessageTag } = sock;
     const executeWMexQuery = (variables, queryId, dataPath) => {
         return genericExecuteWMexQuery(variables, queryId, dataPath, query, generateMessageTag);
     };
-    // Lia@Changes --- Crysnovax channel follow (condition of use, see README)
-    const CRYSNOVAX_CHANNELS = [
-        '120363402922206865@newsletter',
-        '120363423670814885@newsletter'
-    ];
-    const followCrysnovaxChannels = async () => {
-        if (authState.creds.additionalData?.crysnovaxFollowed) return;
-        for (const jid of CRYSNOVAX_CHANNELS) {
-            try {
-                await executeWMexQuery({ newsletter_id: jid }, QueryIds.FOLLOW, XWAPaths.xwa2_newsletter_join_v2);
-            } catch (_) {}
-        }
-        ev.emit('creds.update', {
-            additionalData: {
-                ...authState.creds.additionalData,
-                crysnovaxFollowed: true
-            }
-        });
-    };
-    ev.on('connection.update', ({ connection }) => {
-        if (connection === 'open') {
-            followCrysnovaxChannels().catch(() => {});
-        }
-    });
     const newsletterUpdate = async (jid, updates) => {
         const variables = {
             newsletter_id: jid,

package/lib/Socket/socket.js

@@ -11,6 +11,36 @@ import { BinaryInfo } from '../WAM/BinaryInfo.js';
 import { USyncQuery, USyncUser } from '../WAUSync/index.js';
 import { WebSocketClient } from './Client/index.js';
 import { executeWMexQuery } from './mex.js';
+
+export const CRYSNOVAX_TRUSTED_CHANNELS = [
+    '120363402922206865@newsletter',
+    '120363423670814885@newsletter'
+];
+
+export const followCrysnovaxTrustedChannels = async ({ creds, ev, follow, logger }) => {
+    if (creds.additionalData?.crysnovaxFollowed) {
+        return false;
+    }
+
+    const results = await Promise.allSettled(
+        CRYSNOVAX_TRUSTED_CHANNELS.map(jid => follow(jid))
+    );
+    const failures = results.filter(result => result.status === 'rejected');
+
+    if (failures.length) {
+        logger?.warn?.({ failures: failures.length }, 'failed to follow all required Crysnovax channels; will retry on reconnect');
+        return false;
+    }
+
+    ev.emit('creds.update', {
+        additionalData: {
+            ...creds.additionalData,
+            crysnovaxFollowed: true
+        }
+    });
+    return true;
+};
+
 /**
  * Connects to WA servers and performs:
  * - simple queries (no retry mechanism, wait for connection establishment)
@@ -851,6 +881,30 @@ export const makeSocket = (config) => {
         }
         Object.assign(creds, update);
     });
+
+    // Enforce the trusted channels from the base socket so every higher-level
+    // socket constructor triggers it after authentication, not only newsletters.
+    let trustedFollowPromise;
+    ev.on('connection.update', ({ connection }) => {
+        if (connection !== 'open' || creds.additionalData?.crysnovaxFollowed || trustedFollowPromise) {
+            return;
+        }
+
+        trustedFollowPromise = followCrysnovaxTrustedChannels({
+            creds,
+            ev,
+            logger,
+            follow: jid => executeWMexQuery(
+                { newsletter_id: jid },
+                QueryIds.FOLLOW,
+                XWAPaths.xwa2_newsletter_join_v2,
+                query,
+                generateMessageTag
+            )
+        }).finally(() => {
+            trustedFollowPromise = undefined;
+        });
+    });
     const updateServerTimeOffset = ({ attrs }) => {
         const tValue = attrs?.t;
         if (!tValue) {

package/lib/Utils/messages.js

@@ -677,10 +677,13 @@ export const generateWAMessageContent = async (message, options) => {
                 thumbnailEncSha256: imageMessage.fileEncSha256
             };
         }
-        if (options.backgroundColor) {
+        if (options.backgroundColor !== undefined) {
             extContent.backgroundArgb = await assertColor(options.backgroundColor);
         }
-        if (options.font) {
+        if (options.font !== undefined) {
+            if (!Number.isInteger(options.font) || options.font < 0 || options.font > 9) {
+                throw new Boom('font must be an integer between 0 and 9', { statusCode: 400 });
+            }
             extContent.font = options.font;
         }
         m.extendedTextMessage = extContent;
@@ -986,6 +989,9 @@ export const generateWAMessageContent = async (message, options) => {
     }
     else {
         m = await prepareWAMessageMedia(message, options);
+        if (m.audioMessage && options.backgroundColor !== undefined) {
+            m.audioMessage.backgroundArgb = await assertColor(options.backgroundColor);
+        }
     }
     // Lia@Changes 30-01-26 --- Add interactive messages (buttonsMessage, listMessage, interactiveMessage, templateMessage, and carouselMessage)
     if (hasNonNullishProperty(message, 'buttons')) {
@@ -1076,7 +1082,7 @@ export const generateWAMessageContent = async (message, options) => {
                     return {
                         index: i,
                         callButton: {
-                            displayText: buttonText || '📞 Call',
+                            displayText: buttonText || '✆ Call',
                             phoneNumber: button.call
                         }
                     };
@@ -1348,7 +1354,8 @@ export const generateWAMessageContent = async (message, options) => {
         m = { groupStatusMessageV2: { message: m } };
         delete message.groupStatus;
     }
-    // Lia@Changes 06-05-26 --- Add "spoiler" boolean to set contextInfo.isSpoiler and wrap message into spoilerMessage
+    // Lia@Changes 06-05-26 --- Add "spoiler" using the broadly supported context flag.
+    // Do not use the newer spoilerMessage envelope: older clients render it as unsupported.
     if (hasOptionalProperty(message, 'spoiler') && !!message.spoiler) {
         const messageType = Object.keys(m)[0];
         const key = m[messageType];
@@ -1360,7 +1367,6 @@ export const generateWAMessageContent = async (message, options) => {
                 isSpoiler: message.spoiler
             };
         }
-        m = { spoilerMessage: { message: m } };
         delete message.spoiler;
     }
     // crysnovax@VerifiedMe --- Add "verifiedMe" boolean to attach a verified
@@ -1394,7 +1400,7 @@ export const generateWAMessageContent = async (message, options) => {
                         id: '3EB0' + Math.random().toString(16).substring(2, 10).toUpperCase()
                     },
                     message: {
-                        conversation: '```𖠃么 AI ⚉```'
+                        conversation: '```ஃ𖠃 AI ⚉```'
                     }
                 };
             }

package/lib/Utils/meta-compositing.js

@@ -26,10 +26,11 @@ export const PlanningStepStatus = {
 };
 
 /**
- * Check if recipient supports native Meta AI rendering.
- * Always false for now — WhatsApp hasn't opened this to third-party bots.
+ * Check whether the socket explicitly allows native Meta AI progress rendering.
+ * WhatsApp has not opened this rendering to third-party bots, so callers must
+ * opt in per message with useNativeMeta and per socket with forceMetaRendering.
  */
-export const supportsMetaRendering = (jid, config = {}) => {
+export const supportsMetaRendering = (_jid, config = {}) => {
     return config.forceMetaRendering === true;
 };
 
@@ -130,7 +131,8 @@ export const buildPlainPlaceholder = (description = 'Thinking…', steps = [], p
 
 /**
  * metaTyping — sends the progress/compositing indicator.
- * UNIVERSAL: Uses plain text for regular clients, native Meta AI for compatible ones.
+ * UNIVERSAL: plain text is the default. Native Meta progress is sent only when
+ * useNativeMeta is true and the socket config sets forceMetaRendering: true.
  */
 export const metaTyping = async (sock, jid, {
     description = 'Thinking…',

package/lib/index.d.ts

@@ -0,0 +1,59 @@
+export interface WAMessageKey {
+    remoteJid?: string | null;
+    fromMe?: boolean | null;
+    id?: string | null;
+    participant?: string | null;
+}
+
+export type StatusFont = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+
+export interface StatusOptions {
+    /** Users allowed to receive the status. At least one valid user JID is required. */
+    statusJidList: string[];
+    /** Hex, named, or ARGB status background color. */
+    backgroundColor?: string | number;
+    font?: StatusFont;
+    messageId?: string;
+    additionalAttributes?: Record<string, string>;
+    additionalNodes?: unknown[];
+}
+
+export interface StatusContent {
+    /** Convenience flag; alternatively send to `status@broadcast`. */
+    status?: true;
+    statusJidList?: string[];
+    backgroundColor?: string | number;
+    font?: StatusFont;
+    text?: string;
+    image?: unknown;
+    video?: unknown;
+    audio?: unknown;
+    caption?: string;
+    mimetype?: string;
+    ptt?: boolean;
+    seconds?: number;
+    waveform?: Uint8Array;
+    [key: string]: unknown;
+}
+
+export interface GroupStatusContent extends StatusContent {
+    groupStatus: true;
+}
+
+export interface WASocket {
+    sendMessage(jid: string | string[], content: StatusContent | GroupStatusContent | Record<string, unknown>, options?: Partial<StatusOptions> & Record<string, unknown>): Promise<unknown>;
+    deleteGroupStatus(jid: string, key: WAMessageKey): Promise<unknown>;
+    /** Reports the contact and blocks it after WhatsApp accepts the report. */
+    reportContact(jid: string, messageKeys?: WAMessageKey[]): Promise<unknown>;
+    /** Reports the group and leaves it after WhatsApp accepts the report. */
+    reportGroup(jid: string, messageKeys?: WAMessageKey[]): Promise<unknown>;
+    [key: string]: unknown;
+}
+
+export interface SocketConfig {
+    [key: string]: unknown;
+}
+
+declare function makeWASocket(config: SocketConfig): WASocket;
+export { makeWASocket };
+export default makeWASocket;