innovators-bot2 1.2.3 → 1.2.5

package/README.md

@@ -7,7 +7,8 @@ A powerful WhatsApp client library that provides seamless integration between Ba
 - 🚀 Easy to use, familiar WhatsApp-web.js style API
 - 📱 Multi-device support (Baileys v7.x.x)
 - 💬 Send and receive messages
-- 📸 Media handling (images, videos, documents)
+- � Message reactions (add/remove emoji reactions)
+- �📸 Media handling (images, videos, documents)
 - 👥 Group management
 - 💾 Message history and chat management
 - 🔄 Auto-reconnect functionality
@@ -102,7 +103,43 @@ await client.sendDocument('1234567890@s.whatsapp.net', './document.pdf',
 )
 ```
 
-### 3. Group Management
+### 3. Sticker Management
+
+Create stickers easily from any image buffer with automatic conversion and metadata support.
+
+```javascript
+const fs = require('fs');
+
+// Send a sticker from an image or video buffer
+const buffer = fs.readFileSync('./image.jpg');
+await client.sendSticker('1234567890@s.whatsapp.net', buffer, {
+    packName: 'Innovators',
+    author: 'Innovators Bot',
+    type: 'full', // 'full' or 'crop'
+    quality: 50
+});
+```
+
+### 4. Anti-Delete System
+
+The library includes a built-in Anti-Delete system that tracks deleted messages in real-time.
+
+```javascript
+// Listen for deleted messages
+client.on('message-deleted', async (data) => {
+    console.log(`User ${data.jid} deleted a message!`);
+    
+    // Content of the deleted message
+    const original = data.originalMessage;
+    
+    // Reply to the chat with the deleted content
+    await client.sendMessage(data.jid, 'I saw that! 😉', { 
+        quoted: original 
+    });
+});
+```
+
+### 5. Group Management
 
 ```javascript
 // Get all groups
@@ -235,11 +272,17 @@ The library includes example bot commands that you can use:
 - `!list` - Display a scrollable list
 - `!logout` - Logout from current session
 
-### LID/PN Management (v7.x.x)
+### 🛡️ Protection
+- `Anti-Delete` - Automatically tracks and emits events for deleted messages
+
+### 🔐 JID & LID/PN Management (v7.x.x)
 - `!lid` - Get your LID (Local Identifier)
 - `!pn <lid>` - Get phone number from a LID
+- `!parse <jid>` - Parse detailed JID information
+- `!normalize <number>` - Normalize a number to JID format
 
-## Event Handling
+### 🎨 Sticker Commands
+- `!sticker` - Create a sticker from an image
 
 ### Connection Events
 ```javascript
@@ -282,6 +325,72 @@ client.on('message', async msg => {
 })
 ```
 
+### Message Reaction Events
+
+Listen for when users add or remove reactions (emojis) from messages:
+
+```javascript
+// When a message receives a reaction
+client.on('message-reaction', async (reaction) => {
+    console.log('Reaction received!')
+    console.log('Chat:', reaction.from)
+    console.log('Sender:', reaction.sender)
+    console.log('Emoji:', reaction.emoji)
+    console.log('Is removed:', reaction.isRemoved)
+    
+    // Check if reaction was added or removed
+    if (reaction.isRemoved) {
+        console.log('User removed their reaction')
+    } else {
+        console.log(`User reacted with: ${reaction.emoji}`)
+    }
+    
+    // Access the message key that was reacted to
+    console.log('Message ID:', reaction.messageKey.id)
+    
+    // For group messages, get the participant who reacted
+    if (reaction.from.endsWith('@g.us')) {
+        console.log('Participant who reacted:', reaction.sender)
+    }
+})
+```
+
+#### Reaction Event Data Structure
+
+The `message-reaction` event provides the following data:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `from` | `string` | Chat JID where the reaction occurred (prefers PN over LID) |
+| `sender` | `string` | JID of the user who reacted (in groups, this is the participant) |
+| `participant` | `string\|null` | Original participant JID (could be LID or PN) |
+| `participantAlt` | `string\|null` | Alternate participant JID format |
+| `emoji` | `string\|null` | The emoji used for the reaction (null if removed) |
+| `isRemoved` | `boolean` | `true` if the reaction was removed, `false` if added |
+| `messageKey` | `object` | The message key object that was reacted to |
+| `timestamp` | `Date` | When the reaction event was processed |
+| `raw` | `object` | Raw reaction data from Baileys |
+
+#### Sending Reactions
+
+You can also send reactions to messages programmatically:
+
+```javascript
+// React to a message
+await client.sendMessage(chatId, {
+    type: 'reaction',
+    emoji: '❤️',
+    messageKey: messageToReactTo.key
+})
+
+// Remove a reaction (send empty emoji)
+await client.sendMessage(chatId, {
+    type: 'reaction',
+    emoji: '',
+    messageKey: messageToReactTo.key
+})
+```
+
 ### LID Mapping Events
 ```javascript
 // Listen for LID/PN mapping updates