@crysnovax/baileys 2.6.1 → 2.6.3

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 }` |
 
 ---
 
@@ -776,6 +726,10 @@ sock.sendMessage(jid, {
 
 ## Meta AI Features
 
+Meta AI-style thinking indicators and live reasoning feeds. Works on **all WhatsApp clients** — no "Update WhatsApp" messages.
+
+> **Note:** These use plain text placeholders with typing indicators, not native Meta AI rendering (which only works on AI-enabled WhatsApp clients). The visual experience is identical — users see "Thinking…" with live step completion.
+
 ### Meta Typing Indicator
 
 Show a live thinking indicator that you control. Delete it manually when ready — no "edited" badge ever appears.
@@ -797,6 +751,19 @@ await sock.sendMessage(jid, { delete: placeholder.key })
 await sock.sendMessage(jid, { text: 'Here is your answer!' })
 ```
 
+**What users see:**
+```
+[typing… indicator]
+
+_Thinking…_
+○ Reading your message…
+○ Writing response…
+
+[auto-deletes]
+
+Here is your answer!
+```
+
 ### Meta Compositing
 
 Full flow: indicator shows → auto-deletes → clean final message lands. Works with every rich content type.
@@ -875,6 +842,30 @@ await replayPlanning(
 )
 ```
 
+**What users see:**
+```
+_Thinking…_
+○ Understanding your question…
+○ Searching for data…
+○ Writing the answer…
+
+[step 1 completes]
+_Thinking…_
+✓ Understanding your question…
+○ Searching for data…
+○ Writing the answer…
+
+[step 2 completes]
+_Thinking…_
+✓ Understanding your question…
+✓ Searching for data…
+○ Writing the answer…
+
+[all done, deletes, then:]
+
+const answer = 42
+```
+
 **Step type helpers:**
 
 ```javascript
@@ -1149,6 +1140,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
@@ -1344,7 +1490,9 @@ sock.updateProfilePicture(jid, { url })
 // Standard with custom dimensions
 sock.updateProfilePicture(jid, { url }, { width: 640, height: 640 })
 
-// 🆕 HD — full resolution, no crop, no resize
+// HD — preserves original aspect ratio, no crop, no padding
+// Images under 720px pass through unchanged.
+// Larger images are scaled down proportionally to fit within 720px.
 sock.updateProfilePicture(jid, buffer, { hd: true })
 sock.updateProfilePicture(jid, { url }, { hd: true })
 
@@ -1498,6 +1646,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
@@ -1611,6 +1844,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

@@ -5,7 +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 { getStream, toBuffer } from '../Utils/messages-media.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';
@@ -228,18 +228,12 @@ export const makeChatsSocket = (config) => {
         else {
             targetJid = undefined;
         }
-        let img;
-        if (dimensions?.hd) {
-            // crysnovax@HD-Profile --- bypass resize/crop, send raw buffer directly
-            if (Buffer.isBuffer(content)) {
-                img = content;
-            } else {
-                const { stream } = await getStream(content);
-                img = await toBuffer(stream);
-            }
-        } else {
-            ({ 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: {
@@ -942,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
@@ -1228,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

@@ -1218,6 +1218,36 @@ 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;
+            }
             else {
                 const fullMsg = await generateWAMessage(jid, content, {
                     logger,