innovators-bot2 2.0.5 → 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
@@ -409,6 +437,56 @@ await client.SendList('1234567890@s.whatsapp.net', {
 });
 ```
 
+#### 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.
@@ -553,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:
@@ -577,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
@@ -633,6 +768,12 @@ The library includes example bot commands that you can use:
 ### 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
@@ -694,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')