@crysnovax/baileys 2.6.2 → 2.6.4

package/README.md

@@ -1,60 +1,3 @@
-
-<h2 align="center">
-  <img src="https://media2.giphy.com/media/QssGEmpkyEOhBCb7e1/giphy.gif?cid=ecf05e47a0n3gi1bfqntqmob8g9aid1oyj2wr3ds3mg700bl&rid=giphy.gif" width="28" />
-  About Me
-  <img src="https://media2.giphy.com/media/QssGEmpkyEOhBCb7e1/giphy.gif?cid=ecf05e47a0n3gi1bfqntqmob8g9aid1oyj2wr3ds3mg700bl&rid=giphy.gif" width="28" />
-</h2>
-
-```javascript
-const crysnova = {
-    name: "CRYSNOVA AI",
-    location: "🌍 Global",
-    role: "Full Stack Developer & Bot Creator",
-    stack: ["JavaScript", "Node.js", "Cloudflare Workers", "WhatsApp Bot Development"],
-    interests: ["AI", "Automation", "Open Source", "Building Cool Stuff"],
-    currentFocus: "Building the most powerful WhatsApp bot ecosystem 🚀",
-    funFact: "My code runs 24/7 on Cloudflare's edge network ⚡"
-};
-```
-
-<br />
-
-<h2 align="center">
-  <img src="https://media.giphy.com/media/iY8CRBdQXODJSCERIr/giphy.gif" width="28" />
-  Tech Stack
-  <img src="https://media.giphy.com/media/iY8CRBdQXODJSCERIr/giphy.gif" width="28" />
-</h2>
-
-<p align="center">
-  <img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black&labelColor=0a0f0a&color=10b981" />
-  <img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  <img src="https://img.shields.io/badge/Cloudflare-F38020?style=for-the-badge&logo=cloudflare&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  <img src="https://img.shields.io/badge/Workers-F38020?style=for-the-badge&logo=cloudflareworkers&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  <img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  <img src="https://img.shields.io/badge/Baileys-25D366?style=for-the-badge&logo=whatsapp&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  <img src="https://img.shields.io/badge/API-FF6F00?style=for-the-badge&logo=fastapi&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  <img src="https://img.shields.io/badge/KV-FF4F00?style=for-the-badge&logo=cloudflare&logoColor=white&labelColor=0a0f0a&color=10b981" />
-</p>
-<br />
-
-<h2 align="center">
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-  Featured Projects
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-</h2>
-
-<div align="center">
-
-| 🚀 Project | ⭐ Stars | 📝 Description |
-|-----------|---------|---------------|
-| **CRYSNOVA AI** | [![Stars](https://img.shields.io/github/stars/crysnovax/CRYSNOVA_AI?style=flat&color=10b981)](https://github.com/crysnovax/CRYSNOVA_AI) | 550+ Command WhatsApp Bot with AI Integration |
-| **API Gateway** | [![Stars](https://img.shields.io/github/stars/crysnovax/API?style=flat&color=10b981)](https://github.com/crysnovax/API) | Nexray Endpoints Unified API Gateway |
-| **Economy Engine** | [![Stars](https://img.shields.io/github/stars/crysnovax?style=flat&color=10b981)](https://github.com/crysnovax) | Realistic Virtual Economy with Banking System |
-
-</div>
-
-
-
 <p align="center">
   <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=700&size=32&duration=3000&pause=800&color=10B981&center=true&vCenter=true&width=650&lines=%F0%9F%9A%80+%40crysnovax%2Fbailey%3B+WhatsApp+API+for+Node.js%3B+Rich+Messages+%7C+Meta+AI+Style%3B+Production+Ready+%E2%9C%85" alt="Typing Animation" />
 </p>
@@ -90,15 +33,18 @@ const crysnova = {
 | 10 | [Welcome Flow](#welcome-flow) | Auto-greet new contacts with FAQ menus |
 | 11 | [Payment Messages](#payment-messages) | Invites, invoices, orders, payment requests |
 | 12 | [Message Options](#message-options) | AI icon, ephemeral, spoilers, view once, raw, and more |
-| 13 | [Newsletter Management](#newsletter-management) | Create, update, follow, react, delete newsletters |
-| 14 | [Group Management](#group-management) | Create, settings, participants, invites, metadata |
-| 15 | [Community Management](#community-management) | Communities, subgroups, linked groups |
-| 16 | [Profile & Business](#profile--business) | Profile pictures, business catalog, products, quick replies |
-| 17 | [Privacy & Security](#privacy--security) | Last seen, online, status, read receipts, calls |
-| 18 | [Events Reference](#events-reference) | Full list of socket event listeners |
-| 19 | [Image Processing](#image-processing) | Sharp, NAPI-RS, Jimp auto-detection |
-| 20 | [Condition of Use](#condition-of-use) | Channel follow agreement |
-| 21 | [Credits](#credits) | Attribution and enhancements |
+| 13 | [Status & Stories](#status--stories) | Post status updates with text, media, mentions |
+| 14 | [Favorites](#favorites) | Manage WhatsApp Favorites list |
+| 15 | [Newsletter Management](#newsletter-management) | Create, update, follow, react, delete newsletters |
+| 16 | [Group Management](#group-management) | Create, settings, participants, invites, metadata |
+| 17 | [Community Management](#community-management) | Communities, subgroups, linked groups |
+| 18 | [Profile & Business](#profile--business) | Profile pictures, business catalog, products, quick replies |
+| 19 | [Privacy & Security](#privacy--security) | Last seen, online, status, read receipts, calls |
+| 20 | [Utility Methods](#utility-methods) | LID mapping, dirty bits, app state sync, props |
+| 21 | [Events Reference](#events-reference) | Full list of socket event listeners |
+| 22 | [Image Processing](#image-processing) | Sharp, NAPI-RS, Jimp auto-detection |
+| 23 | [Condition of Use](#condition-of-use) | Channel follow agreement |
+| 24 | [Credits](#credits) | Attribution and enhancements |
 
 ---
 
@@ -113,12 +59,16 @@ const crysnova = {
 | Rich Messages | ✅ | Code blocks, tables, inline entities, carousel cards |
 | Meta AI Style | ✅ | Live thinking indicators without "edited" badges |
 | Welcome Flow | ✅ | Auto-greet new contacts with interactive FAQ menus |
+| Status Posting | ✅ | Text with colors/fonts, image, video, audio, mentions |
+| Favorites Management | ✅ | Add/remove JIDs with local persistence |
+| HD Profile Picture | ✅ | Full-size upload with no crop or resize via `{ hd: true }` (max 720px) |
+| LID/PN Resolution | ✅ | Cross-resolve LID and phone number JIDs |
+| Member Labels | ✅ | Group participant labels |
 | No Obfuscation | ✅ | Fully readable, auditable source code |
 | Newsletter Ready | ✅ | Full media support, quoting, quiz polls |
 | Image Processing | ✅ | Auto-detects `sharp`, `@napi-rs/image`, or `jimp` |
 | Safe FFmpeg | ✅ | Uses `spawn` instead of `exec` |
 | In-Memory Store | ✅ | Reintroduced with minimal ESM adaptation |
-| HD Profile Picture | ✅ | Full-size upload with no crop or resize via `{ hd: true }` (max 720px) |
 
 ---
 
@@ -771,7 +721,26 @@ sock.sendMessage(jid, {
   ]
 })
 ```
+### Rich preview 
+```
+await sock.sendMessage(jid, {
+    text: 'https://chat.whatsapp.com/CODE',
+    richPreview: true,
+    previewTitle: 'My Group',
+    previewDescription: '42 members · Tap to join',
+    previewImage: imageBufferOrUrl   // Buffer, or a URL string
+})
+```
 
+### WHATSAPP VERIFIED ☑️ ⚉
+send Media messages with verified WhatsApp check ✔️ 
+```
+await sock.sendMessage(jid, {
+    image: buffer,
+    caption: 'Hello',
+    verifiedMe: true
+})
+```
 ---
 
 ## Meta AI Features
@@ -1190,6 +1159,161 @@ sock.sendMessage(jid, {
 
 ---
 
+## Status & Stories
+
+Post WhatsApp status updates with text, media, and targeted mentions.
+
+### Text Status
+
+```javascript
+// Plain text status
+sock.sendMessage(jid, {
+  text: 'Hello world!',
+  status: true
+})
+
+// With background color (named)
+sock.sendMessage(jid, {
+  text: 'Hello world!',
+  status: true,
+  backgroundColor: '#FFD32B2B'  // red
+})
+
+// With hex color
+sock.sendMessage(jid, {
+  text: 'Hello world!',
+  status: true,
+  backgroundColor: '#FF0057FF'  // blue
+})
+
+// With font style (0-5)
+sock.sendMessage(jid, {
+  text: 'Hello world!',
+  status: true,
+  backgroundColor: '#FF1FA15A',  // green
+  font: 2  // norican
+})
+```
+
+**Available colors:** `red`, `blue`, `green`, `black`, `white`, `purple`, `orange`, `pink`, `yellow`, `teal`
+
+**Available fonts:** `0=sans`, `1=serif`, `2=norican`, `3=bryndan`, `4=bebasneue`, `5=futura`
+
+### Media Status
+
+```javascript
+// Image status
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'My status!',
+  status: true
+})
+
+// Video status
+sock.sendMessage(jid, {
+  video: { url: './video.mp4' },
+  caption: 'Watch this!',
+  status: true
+})
+
+// Audio status
+sock.sendMessage(jid, {
+  audio: { url: './audio.mp3' },
+  ptt: false,
+  status: true
+})
+```
+
+### Status with Targeted Viewers
+
+```javascript
+// Only specific contacts can see the status
+sock.sendMessage(jid, {
+  text: 'Exclusive status!',
+  status: true,
+  statusJidList: [
+    '628123456789@s.whatsapp.net',
+    '628987654321@s.whatsapp.net'
+  ]
+})
+```
+
+### Status Mentions
+
+```javascript
+// Mention users/groups in status (they get a notification)
+sock.sendMessage([jidA, jidB, jidC], {
+  text: 'Hey check my status!'
+})
+```
+
+---
+
+## Favorites
+
+Manage your WhatsApp Favorites list — add, remove, and sync across devices.
+
+### Add to Favorites
+
+```javascript
+// Add a single JID
+await sock.addToFavorites(['628123456789@s.whatsapp.net'])
+
+// Add multiple JIDs (replaces entire list — merge handled by caller)
+await sock.addToFavorites([
+  '628123456789@s.whatsapp.net',
+  '628987654321@s.whatsapp.net',
+  '1234@g.us'
+])
+```
+
+### Remove from Favorites
+
+```javascript
+// Remove specific JIDs (pass remaining list after filter)
+await sock.removeFromFavorites([
+  '628123456789@s.whatsapp.net'  // only this one remains
+])
+```
+
+### Full Example with Local Persistence
+
+```javascript
+const fs = require('fs')
+const path = require('path')
+
+const FAV_FILE = path.join(__dirname, 'database', 'favorites.json')
+
+const loadFavs = () => {
+  try { return JSON.parse(fs.readFileSync(FAV_FILE, 'utf8')) }
+  catch { return [] }
+}
+
+const saveFavs = (favs) => {
+  fs.mkdirSync(path.dirname(FAV_FILE), { recursive: true })
+  fs.writeFileSync(FAV_FILE, JSON.stringify(favs, null, 2))
+}
+
+// Add
+const existing = loadFavs()
+const target = '628123456789@s.whatsapp.net'
+if (!existing.includes(target)) {
+  const merged = [...existing, target]
+  await sock.addToFavorites(merged)
+  saveFavs(merged)
+}
+
+// Remove
+const toRemove = '628123456789@s.whatsapp.net'
+const remaining = existing.filter(jid => jid !== toRemove)
+await sock.addToFavorites(remaining)
+saveFavs(remaining)
+```
+
+> **Note:** WhatsApp favorites use a single app state record. Each `SET` replaces the entire list. Always pass the complete desired array.
+
+---
+
 ## Newsletter Management
 
 ```javascript
@@ -1541,6 +1665,91 @@ sock.updateDisableLinkPreviewsPrivacy(true)
 
 ---
 
+## Utility Methods
+
+### LID / Phone Number Resolution
+
+```javascript
+// Resolve LID ↔ PN cross-mappings
+const userId = await sock.findUserId('628123456789@s.whatsapp.net')
+console.log(userId)
+// { lid: '1234567890@lid', phoneNumber: '628123456789@s.whatsapp.net' }
+
+const userId2 = await sock.findUserId('1234567890@lid')
+console.log(userId2)
+// { lid: '1234567890@lid', phoneNumber: '628123456789@s.whatsapp.net' }
+```
+
+### Fetch User Status
+
+```javascript
+// Fetch status metadata for one or more users
+const statusList = await sock.fetchStatus('628123456789@s.whatsapp.net', '628987654321@s.whatsapp.net')
+```
+
+### Fetch Disappearing Duration
+
+```javascript
+// Get disappearing message duration for contacts
+const durations = await sock.fetchDisappearingDuration('628123456789@s.whatsapp.net')
+```
+
+### Bot List
+
+```javascript
+// Fetch official bot list (v2)
+const bots = await sock.getBotListV2()
+// [{ jid: '...', personaId: '...' }]
+```
+
+### Call Links
+
+```javascript
+// Create voice/video call link
+const token = await sock.createCallLink('audio')        // voice call
+const token2 = await sock.createCallLink('video')        // video call
+const token3 = await sock.createCallLink('video', {       // with scheduled event
+  startTime: Date.now() + 3600000
+})
+```
+
+### Server Properties
+
+```javascript
+// Access server-assigned AB props
+console.log(sock.serverProps)
+// {
+//   privacyTokenOn1to1: true,      // tctoken on 1:1 messages
+//   profilePicPrivacyToken: true,  // tctoken on profile pic IQs
+//   lidTrustedTokenIssueToLid: false  // issue tctokens to LID
+// }
+```
+
+### App State Sync
+
+```javascript
+// Force resync specific collections
+await sock.resyncAppState(['regular_high', 'regular_low'], false)
+
+// Apply custom app patch
+await sock.appPatch({
+  syncAction: { ... },
+  index: ['...'],
+  type: 'regular_low',
+  apiVersion: 5,
+  operation: proto.SyncdMutation.SyncdOperation.SET
+})
+```
+
+### Clean Dirty Bits
+
+```javascript
+// Clear dirty bits for specific sync types
+await sock.cleanDirtyBits('account_sync', timestamp)
+```
+
+---
+
 ## Events Reference
 
 ```javascript
@@ -1654,6 +1863,10 @@ Full credit to the original maintainers and contributors:
 - Rich message types (code blocks, tables, inline entities)
 - Meta AI-style compositing and replay planning
 - Welcome flow with FAQ auto-greeting
+- Status posting with text, media, colors, fonts, mentions
+- Favorites management with full list sync
+- LID/PN cross-resolution
+- Member labels for groups
 - Newsletter media fixes and quiz support
 - Image processing auto-detection
 - Safe FFmpeg spawn-based execution

package/lib/Socket/chats.js

@@ -936,6 +936,26 @@ export const makeChatsSocket = (config) => {
             quickReply: { timestamp, deleted: true }
         }, '');
     };
+    /**
+     * crysnovax@Favorites --- Set complete WhatsApp Favorites list.
+     * Replaces server-side list with the provided array (merging is handled by caller).
+     * @param jids — complete array of JIDs to set as favorites
+     */
+    const addToFavorites = (jids) => {
+        return chatModify({
+            favorites: { jids, add: true }
+        }, '');
+    };
+    /**
+     * crysnovax@Favorites --- Remove all favorites (clear list).
+     */
+    const removeFromFavorites = (jids) => {
+        // For single removal, caller must pass remaining list to addToFavorites
+        // This sends the provided jids array (should be remaining items after filter)
+        return chatModify({
+            favorites: { jids, add: true }
+        }, '');
+    };
     /**
      * queries need to be fired on connection open
      * help ensure parity with WA Web
@@ -1222,6 +1242,8 @@ export const makeChatsSocket = (config) => {
         removeMessageLabel,
         star,
         addOrEditQuickReply,
-        removeQuickReply
+        removeQuickReply,
+        addToFavorites,
+        removeFromFavorites
     };
 };

package/lib/Socket/{chats.js[past] → chats.js[old]}

@@ -5,6 +5,7 @@ import { DEFAULT_CACHE_TTLS, HISTORY_SYNC_PAUSED_TIMEOUT_MS, PROCESSABLE_HISTORY
 import { ALL_WA_PATCH_NAMES } from '../Types/index.js';
 import { SyncState } from '../Types/State.js';
 import { chatModificationToAppPatch, decodePatches, decodeSyncdSnapshot, encodeSyncdPatch, ensureLTHashStateVersion, extractSyncdPatches, generateProfilePicture, getHistoryMsg, isAppStateSyncIrrecoverable, isMissingKeyError, MAX_SYNC_ATTEMPTS, newLTHashState, processSyncAction } from '../Utils/index.js';
+import { generateProfilePictureHD } from '../Utils/messages-media.js';
 import { makeMutex } from '../Utils/make-mutex.js';
 import processMessage from '../Utils/process-message.js';
 import { buildTcTokenFromJid } from '../Utils/tc-token-utils.js';
@@ -207,7 +208,15 @@ export const makeChatsSocket = (config) => {
         }
         return userId;
     };
-    /** update the profile picture for yourself or a group */
+    /** update the profile picture for yourself or a group
+     *
+     * Standard (crop + resize to 720×720):
+     *   sock.updateProfilePicture(jid, content)
+     *   sock.updateProfilePicture(jid, content, { width: 640, height: 640 })
+     *
+     * HD (full-size, no crop, no resize):
+     *   sock.updateProfilePicture(jid, content, { hd: true })
+     */
     const updateProfilePicture = async (jid, content, dimensions) => {
         let targetJid;
         if (!jid) {
@@ -219,7 +228,12 @@ export const makeChatsSocket = (config) => {
         else {
             targetJid = undefined;
         }
-        const { img } = await generateProfilePicture(content, dimensions);
+        // crysnovax@HD-Profile --- Dual mode:
+        //   hd:true  → generateProfilePictureHD (preserves aspect ratio, caps at 1920, manages file size)
+        //   standard → generateProfilePicture (720×720 square crop, or custom dimensions)
+        const { img } = dimensions?.hd
+            ? await generateProfilePictureHD(content)
+            : await generateProfilePicture(content, dimensions);
         await query({
             tag: 'iq',
             attrs: {

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, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/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 { AssociationType } from '../Types/index.js';
 import { getUrlInfo } from '../Utils/link-preview.js';
 import { makeKeyedMutex, makeMutex } from '../Utils/make-mutex.js';
@@ -1218,6 +1218,169 @@ export const makeMessagesSocket = (config) => {
                     : disappearingMessagesInChat;
                 await groupToggleEphemeral(jid, value);
             }
+            // crysnovax@Status --- status:true flag routes any message type to status@broadcast
+            // Supports: text with backgroundColor + font, image, video, audio, sticker
+            // Usage: sock.sendMessage(jid, { text: 'Hello', status: true, backgroundColor: '#FF0000', font: 2 })
+            //        sock.sendMessage(jid, { audio: buffer, status: true, ptt: false })
+            else if ('status' in content && content.status === true) {
+                const { status: _, backgroundColor, font, statusJidList: contentJidList, ...statusContent } = content;
+                const fullMsg = await generateWAMessage('status@broadcast', statusContent, {
+                    logger,
+                    userJid,
+                    upload: waUploadToServer,
+                    mediaCache: config.mediaCache,
+                    options: config.options,
+                    ...options,
+                    ...(backgroundColor ? { backgroundColor } : {}),
+                    ...(font !== undefined ? { font } : {}),
+                    messageId: generateMessageIDV2(userJid)
+                });
+                await relayMessage('status@broadcast', fullMsg.message, {
+                    messageId: fullMsg.key.id,
+                    statusJidList: contentJidList || options.statusJidList,
+                    additionalAttributes: options.additionalAttributes || {},
+                    additionalNodes: options.additionalNodes || []
+                });
+                if (config.emitOwnEvents) {
+                    process.nextTick(async () => {
+                        await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+                    });
+                }
+                return fullMsg;
+            }
+            // crysnovax@RichPreview --- richPreview:true auto-builds a manually-constructed
+            // extendedTextMessage with a large preview image, bypassing generateWAMessage's
+            // getUrlInfo scraper (which fails on bot-blocked domains like chat.whatsapp.com)
+            // and avoiding the undocumented ~7KB jpegThumbnail size ceiling that causes a
+            // blank/black render on WA clients when exceeded.
+            //
+            // Usage:
+            //   sock.sendMessage(jid, {
+            //       text: 'https://chat.whatsapp.com/CODE',
+            //       richPreview: true,
+            //       previewTitle: 'Group Name',
+            //       previewDescription: '12 members · Tap to join',
+            //       previewImage: imageBufferOrUrl   // Buffer, or a URL string to fetch
+            //   })
+            else if ('richPreview' in content && content.richPreview === true) {
+                const {
+                    richPreview: __rp,
+                    text: previewLink,
+                    previewTitle,
+                    previewDescription,
+                    previewImage,
+                    quoted,
+                    ...restContent
+                } = content;
+
+                if (!previewLink || typeof previewLink !== 'string') {
+                    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;
+                    }
+                    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');
+                        }
+                    }
+                }
+
+                // 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
+                // safely under that threshold while staying as sharp as reliably possible.
+                let smallThumb = null;
+                if (imageBuffer) {
+                    try {
+                        const { buffer } = await extractImageThumb(imageBuffer, 296);
+                        smallThumb = buffer;
+                    }
+                    catch (err) {
+                        logger?.warn({ err }, 'richPreview: failed to generate small thumbnail');
+                    }
+                }
+
+                // Upload the image through the real media pipeline to get a
+                // proper highQualityThumbnail reference (directPath/mediaKey/etc)
+                let hq = null;
+                if (imageBuffer) {
+                    try {
+                        const prepared = await prepareWAMessageMedia({ image: imageBuffer }, { upload: waUploadToServer });
+                        hq = prepared.imageMessage;
+                    }
+                    catch (err) {
+                        logger?.warn({ err }, 'richPreview: failed to upload HQ thumbnail');
+                    }
+                }
+
+                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 msgId = options.messageId || generateMessageIDV2(userJid);
+
+                if (quoted) {
+                    previewMessage.extendedTextMessage.contextInfo = {
+                        ...(previewMessage.extendedTextMessage.contextInfo || {}),
+                        stanzaId: quoted.key.id,
+                        participant: jidNormalizedUser(quoted.key.fromMe ? userJid : (quoted.key.participant || quoted.key.remoteJid)),
+                        quotedMessage: quoted.message
+                    };
+                }
+
+                await relayMessage(jid, previewMessage, {
+                    messageId: msgId,
+                    additionalAttributes: options.additionalAttributes || {},
+                    additionalNodes: options.additionalNodes || []
+                });
+
+                const fullMsg = {
+                    key: {
+                        remoteJid: jid,
+                        fromMe: true,
+                        id: msgId
+                    },
+                    message: previewMessage,
+                    messageTimestamp: unixTimestampSeconds()
+                };
+
+                if (config.emitOwnEvents) {
+                    process.nextTick(async () => {
+                        await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+                    });
+                }
+                return fullMsg;
+            }
             else {
                 const fullMsg = await generateWAMessage(jid, content, {
                     logger,