innovators-bot2 2.0.4 → 2.0.6

package/README.md

@@ -66,6 +66,11 @@ const client = new WhatsAppClient({
     authmethod: authMethod
 });
 
+// Handle pairing code event
+client.on('pairing-code', (code) => {
+    console.log('Pairing Code:', code)
+})
+
 // Handle ready event
 client.on('connected', () => {
     console.log('Client is ready!')
@@ -80,22 +85,45 @@ client.connect()
 ### 1. Basic Messaging
 
 ```javascript
+// Determine the correct reply target (group JID for groups, sender JID for DMs)
+const isGroupMsg = msg.isGroup;
+const msgFrom = isGroupMsg ? msg.from : msg.sender;
+
 // Send a text message
-await client.sendMessage('1234567890@s.whatsapp.net', 'Hello world!')
+await client.sendMessage(msgFrom, 'Hello world!')
 
 // Send a reply
-await client.reply('1234567890@s.whatsapp.net', 'This is a reply', {
-    quoted: originalMessage
+await msg.reply('This is a reply message')
+
+// Mention a specific user
+// Use msg.sender (the person's JID), NOT msg.from (which is the group JID in groups)
+const number = msg.sender.split('@')[0]
+await client.sendMessage(msgFrom, {
+    type: 'text',
+    text: `Hey @${number}! How are you?`,
+    mentions: [number]
 })
 
-// Send with mentions
-await client.sendMessage('1234567890@s.whatsapp.net', {
+// Mention all members in a group (only works in groups)
+await client.sendMessage(msgFrom, {
     type: 'text',
-    text: 'Hey @user!',
-    mentions: ['user@s.whatsapp.net']
+    text: 'Hey @all! How are you?',
+    mentions: ['@all']
+})
+
+// You can also use the explicit mentionAll flag
+await client.sendMessage(msgFrom, {
+    type: 'text',
+    text: 'Attention everyone!',
+    mentionAll: true
 })
 ```
 
+> **Note on `msg.from` vs `msg.sender`:**
+> - `msg.from` — The chat JID. For groups this is the group ID (e.g. `120363...@g.us`), for DMs it's the person's JID.
+> - `msg.sender` — The actual person who sent the message (always a user JID like `923001234567@s.whatsapp.net`).
+> - When mentioning a user, always use `msg.sender` (not `msg.from`) to get the correct user JID.
+
 ### Call Methods
 
 ```javascript
@@ -308,6 +336,12 @@ await client.updateGroupsAddPrivacy('contacts')
 // Update default disappearing mode for new chats
 // Options: 0 (off), 86400 (24h), 604800 (7d), 7776000 (90d)
 await client.updateDefaultDisappearingMode(604800)
+
+// Update profile status
+await client.updateProfileStatus('Hello World!')
+
+// Update profile name
+await client.updateProfileName('My name')
 ```
 
 ### 7. Interactive Messages
@@ -403,10 +437,135 @@ await client.SendList('1234567890@s.whatsapp.net', {
 });
 ```
 
-### 8. Message History
+#### Cards Messages
+```javascript
+// Send interactive cards
+await client.sendcards('1234567890@s.whatsapp.net', {
+    text: 'Body Message',
+    title: 'Title Message',
+    subtile: 'Subtitle Message',
+    footer: 'Footer Message',
+    cards: [
+        {
+            image: { url: 'https://example.com/image1.jpg' }, // or buffer
+            title: 'Title Card 1',
+            body: 'Body Card 1',
+            footer: 'Footer Card 1',
+            buttons: [
+                {
+                    name: 'quick_reply',
+                    buttonParamsJson: JSON.stringify({
+                        display_text: 'Button 1',
+                        id: 'id1'
+                    })
+                },
+                {
+                    name: 'cta_url',
+                    buttonParamsJson: JSON.stringify({
+                        display_text: 'Open Link',
+                        url: 'https://www.example.com'
+                    })
+                }
+            ]
+        },
+        {
+            video: { url: 'https://example.com/video1.mp4' }, // or buffer
+            title: 'Title Card 2',
+            body: 'Body Card 2',
+            footer: 'Footer Card 2',
+            buttons: [
+                {
+                    name: 'quick_reply',
+                    buttonParamsJson: JSON.stringify({
+                        display_text: 'Button 2',
+                        id: 'id2'
+                    })
+                }
+            ]
+        }
+    ]
+});
+```
+
+#### Interactive Messages (V2)
+
+Modern interactive message generation with simplified API.
 
+**Quick Reply Buttons (V2)**
 ```javascript
-### 8. Message Store (History)
+await client.sendQuickReplyV2(jid, 'Please select an option below:', [
+    { id: 'btn-1', displayText: '✅ Accept' },
+    { id: 'btn-2', displayText: '❌ Reject' }
+], { footer: 'Powered by Innovators Soft' });
+```
+
+**URL Button (V2)**
+```javascript
+await client.sendUrlButtonV2(jid, 'Visit our website for more info', [
+    { displayText: '🌐 Open Website', url: 'https://example.com' }
+], { title: 'Product Info', footer: 'Click to open' });
+```
+
+**Copy Code Button (V2)**
+```javascript
+await client.sendCopyCodeV2(jid, 'Your OTP Code is:', '123456', '📋 Copy Code');
+```
+
+**Combined Buttons (Mix URL, Reply, Copy, Call) (V2)**
+```javascript
+await client.sendCombinedButtonsV2(jid, 'Choose an action:', [
+    { type: 'reply', displayText: '🛒 Order Now', id: 'order' },
+    { type: 'url', displayText: '🌐 Website', url: 'https://example.com' },
+    { type: 'call', displayText: '📞 Phone', phoneNumber: '+923224559543' },
+    { type: 'copy', displayText: '📋 Copy Promo', copyCode: 'PROMO2024' }
+], { title: 'Main Menu', footer: 'Innovators Soft' });
+```
+
+**List Message (V2)**
+```javascript
+await client.sendListV2(jid, {
+    title: '📋 Product Menu',
+    buttonText: 'View Menu',
+    description: 'Please select a product',
+    footer: 'Powered by Innovators Soft',
+    sections: [
+        {
+            title: 'Food',
+            rows: [
+                { rowId: 'nasi-goreng', title: 'Fried Rice', description: '$2.50' },
+                { rowId: 'mie-goreng', title: 'Fried Noodles', description: '$2.00' }
+            ]
+        }
+    ]
+});
+```
+
+### 8. Typing & Presence Control
+
+Use `createPresenceController` for manual or standalone typing/recording presence control — without needing the auto-reply system.
+
+```javascript
+const typing = client.createPresenceController();
+
+// Show "typing..." for 2 s, then send the message — all in one call
+const sent = await typing.simulateTyping(jid, 2000, async () => {
+    await client.sendMessage(jid, 'Here is your answer! ✅');
+});
+
+// Manual start (auto-pauses after 5 s by default)
+await typing.startTyping(jid, { duration: 5000 });
+
+// Manual stop
+await typing.stopTyping(jid);
+
+// Voice note recording indicator
+await typing.startRecording(jid, { duration: 3000 });
+
+// Stop all active indicators (e.g. on socket close)
+await typing.stopAll();
+```
+
+### 9. Message History (Store)
 
 The library includes a robust message store to keep track of chat history, even across reloads.
 
@@ -472,8 +631,64 @@ client.on('store-loaded', (info) => {
     console.log(`Loaded ${info.messageCount} messages from file`);
 });
 ```
+
+### 10. Status / Story Posting
+
+Post text, image, video, and voice note statuses easily using the `sendStatus` method.
+
+| Feature | Description |
+|---------|-------------|
+| **Multi-Device Support** | Automatically handles `statusJidList` for correct visibility |
+| **All Media Types** | Supports Text, Image, Video, GIF, and Voice Note statuses |
+| **Rich Customization** | Supports backgrounds, fonts, and colors for text status |
+
+#### Sending Text Status
+```javascript
+await client.sendStatus({
+    text: 'Hello from Innovators Soft! 🌍',
+    backgroundColor: '#34B7F1', // Hex color
+    font: 2, // Norican font (0-9)
+    textColor: '#FFFFFF'
+}, ['1234567890@s.whatsapp.net']);
+```
+
+#### Sending Media Status
+```javascript
+// Image Status
+await client.sendStatus({
+    imagePath: './photo.jpg',
+    caption: 'Beautiful day! ☀️'
+}, ['1234567890@s.whatsapp.net']);
+
+// Video/GIF Status
+await client.sendStatus({
+    videoPath: './video.mp4',
+    caption: 'Check this out! 🎬',
+    isGif: true
+}, ['1234567890@s.whatsapp.net']);
+
+// Voice Note Status
+await client.sendStatus({
+    audioPath: './voice.ogg'
+}, ['1234567890@s.whatsapp.net']);
 ```
 
+#### Status Visibility
+> [!IMPORTANT]
+> The second parameter of `sendStatus` is an array of JIDs (contacts) who should be able to see this status. On Multi-Device WhatsApp, statuses are NOT visible to anyone unless you explicitly include them in this list.
+
+#### Helper Utilities
+You can also access the underlying `StatusHelper` directly:
+```javascript
+const { StatusHelper, STATUS_BACKGROUNDS, STATUS_FONTS } = require('@innovatorssoft/baileys');
+
+// Generate raw status content
+const status = StatusHelper.text('Direct usage', STATUS_BACKGROUNDS.solid.purple);
+await StatusHelper.send(client.sock, status, ['1234567890@s.whatsapp.net']);
+```
+
+---
+
 ## More Examples and Information
 
 For a complete working example with message handling, group management, and error handling, check out our [`example.js`](https://github.com/innovatorssoft/innovators-bot2/blob/main/example.js) file. This example includes:
@@ -496,7 +711,8 @@ The library includes example bot commands that you can use:
 - `!help` - Show all available commands
 
 ### Messaging
-- `!mention` - Mention you in a message
+- `!mention` - Mention the sender in a message
+- `!mentionall` - Mention all group members (groups only)
 - `!reply` - Reply to your message
 - `!react` - React to your message with ❤️
 - `!read` - Mark messages as read
@@ -546,10 +762,18 @@ The library includes example bot commands that you can use:
 - `!readreceiptprivacy <value>` - Update read receipts privacy (all/none)
 - `!groupaddprivacy <value>` - Update who can add you to groups (all/contacts/contact_blacklist)
 - `!disappearing <seconds>` - Update default disappearing mode (0/86400/604800/7776000)
+- `!updatestatus <text>` - Update profile status
+- `!updatename <text>` - Update profile name
 
 ### Interactive Messages
 - `!buttons` - Show interactive buttons
 - `!list` - Display a scrollable list
+- `!quickreplyv2` - Quick reply buttons V2
+- `!urlbuttonv2` - URL button V2
+- `!copycodev2` - Copy code button V2
+- `!combinedv2` - Mixed buttons V2
+- `!listv2` - Interactive list V2
+- `!cards` - Show interactive cards message
 - `!logout` - Logout from current session
 
 ### 💾 Message Store
@@ -611,12 +835,22 @@ client.on('contacts-update', (updates) => {
 ```javascript
 // When a new message is received
 client.on('message', async msg => {
-    console.log('Message from:', msg.from)
-    console.log('Message content:', msg.body)
+    console.log('Message from:', msg.from)       // Chat JID (group or DM)
+    console.log('Sender:', msg.sender)            // Person who sent it
+    console.log('Sender Name:', msg.raw.pushName) // Display name
+    console.log('Message:', msg.body)
+    console.log('Is Group:', msg.isGroup)
+    
+    // Determine reply target: group JID for groups, sender JID for DMs
+    const isGroupMsg = msg.isGroup;
+    const msgFrom = isGroupMsg ? msg.from : msg.sender;
     
     // Mark message as read
     await client.readMessage(msg.raw.key)
     
+    // Reply back
+    await msg.reply('Got your message!')
+    
     // Handle different message types
     if (msg.hasMedia) {
         console.log('Message contains media')