@innovatorssoft/innovators-bot2 2.0.5 → 2.0.7

package/.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# GitHub Funding Configuration
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository
+
+patreon: innovatorssoft7

package/README.md

@@ -1,27 +1,46 @@
 # INNOVATORS SOFT WhatsApp Bot 2
 
+<div align="center">
+
+[![NPM Version](https://img.shields.io/npm/v/innovators-bot2?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/innovators-bot2)
+[![NPM Downloads](https://img.shields.io/npm/dm/innovators-bot2?style=for-the-badge&logo=npm&color=3399CC)](https://www.npmjs.com/package/innovators-bot2)
+[![Node.js Compatibility](https://img.shields.io/node/v/innovators-bot2?style=for-the-badge&logo=node.js&color=6cc24a)](https://nodejs.org/)
+[![License](https://img.shields.io/npm/l/innovators-bot2?style=for-the-badge&color=00c2a8)](https://github.com/innovatorssoft/innovators-bot2/blob/main/LICENSE)
+[![Discord Support](https://img.shields.io/badge/Discord-Join%20Chat-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/G3RfM6FDHS)
+
 A powerful WhatsApp client library that provides seamless integration between Baileys and WhatsApp-web.js style APIs. This library makes it easy to create WhatsApp bots and automation tools with a familiar interface.
 
+---
+
+### 📊 Client Metrics & Feature Matrix
+
+| 🚀 ENGINE & CORE | 🔐 PRIVACY & SECURITY | 🎛️ USER INTERACTION |
+| :--- | :--- | :--- |
+| • **Baileys v7.x.x (Multi-Device)** | • **Auto LID-to-PN Resolution** | • **Interactive Buttons V2** |
+| • **Agnostic Session Storage** | • **Built-in Anti-Delete Protection** | • **List and Carousel Cards** |
+| • **Automatic Auto-Reconnection** | • **Presence (Typing/Recording)** | • **Persistent Message Store** |
+| • **Text / Media Mention Arrays** | • **Privacy Management Controls** | • **Rich AI formatting (LaTeX/Tables)** |
+
+</div>
+
 ## Community
 
-> Join our Discord server for support, updates, and discussions:
-> https://discord.gg/G3RfM6FDHS
+# Join our **[Discord Server](https://discord.gg/G3RfM6FDHS)** for support, updates, and discussions
 
 ## Features
 
-- 🚀 Easy to use, familiar WhatsApp-web.js style API
-- 📱 Multi-device support (Baileys v7.x.x)
-- 💬 Send and receive messages
-- � Message reactions (add/remove emoji reactions)
-- �📸 Media handling (images, videos, documents)
-- � Mentions support in text and media messages
-- �👥 Group management
-- 💾 Message history and chat management
-- 🔄 Auto-reconnect functionality
-- 📝 Read receipts
-- 🔐 LID (Local Identifier) support for enhanced privacy
-- 🗂️ Signal repository store for LID/PN mapping
-- 🧩 Interactive buttons support for both text and media (URL or local file)
+* 🚀 **Familiar API** — Easy to use, WhatsApp-web.js style high-level interface.
+* 📱 **Multi-Device Engine** — Powered by the robust Baileys v7.x.x library.
+* 💬 **Messaging Suite** — Full send, receive, reply, and read receipt controls.
+* 🎭 **Message Reactions** — Add or remove emoji reactions in real-time.
+* 📸 **Media Handling** — Native support for images, videos, audio, documents, and stickers.
+* 👥 **Group Management** — Invite links, participant roles (promote/demote), settings, and join requests.
+* 💾 **Message Store Cache** — Auto-saved local store with Time-to-Live (TTL) configuration.
+* 🔄 **Auto-Reconnect** — Automated back-off connection handler.
+* 🔐 **LID System Support** — Fully resolves Local Identifiers to Phone Numbers post-decryption.
+* 📊 **Decrypted Poll Votes** — Real-time aggregation and vote event tracking.
+* 🧩 **Interactive Messages** — V2 buttons, lists, copy-code, and combined Call-to-Action templates.
+* 🤖 **Rich AI Formatting** — Meta AI-style tables, code snippets, and pre-rendered LaTeX albums.
 
 ## Installation
 
@@ -66,6 +85,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 +104,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
@@ -171,7 +218,44 @@ client.on('message-deleted', async (data) => {
 });
 ```
 
-### 5. Group Management
+### 5. Poll Votes Decryption
+
+Listen for real-time updates when users cast or change their votes on a poll you created. The votes are automatically decrypted, aggregated, and their internal LID JIDs are resolved to Phone Number JIDs!
+
+```javascript
+client.on('poll-votes-update', async (data) => {
+    console.log(`\n📊 Poll Votes Updated in ${data.jid}!`);
+    console.log('Voter who cast/updated the vote:', data.voter);
+    
+    // 1. Get original poll creation details (Question, Options, etc.)
+    const pollCreation = data.pollCreationMessage;
+    if (pollCreation && pollCreation.message) {
+        const pollMessage = pollCreation.message.pollCreationMessage ||
+            pollCreation.message.pollCreationMessageV2 ||
+            pollCreation.message.pollCreationMessageV3;
+
+        if (pollMessage) {
+            console.log('Question:', pollMessage.name);
+            console.log('Options:', pollMessage.options?.map(o => o.optionName) || []);
+        }
+    }
+    
+    // 2. View accumulated vote breakdown & totals
+    let totalVotesCount = 0;
+    data.pollUpdate.forEach((option) => {
+        console.log(`- ${option.name}: ${option.voters.length} vote(s) ${JSON.stringify(option.voters)}`);
+        totalVotesCount += option.voters.length;
+    });
+    console.log('Total Votes Cast:', totalVotesCount);
+
+    // 3. Find the winning option
+    const winner = data.pollUpdate.reduce((prev, current) =>
+        prev.voters.length > current.voters.length ? prev : current);
+    console.log(`Winning Option: ${winner.name} with ${winner.voters.length} vote(s)`);
+});
+```
+
+### 6. Group Management
 
 ```javascript
 // Get all groups
@@ -264,7 +348,7 @@ await client.toggleGroupEphemeral(groupId, 86400)
 await client.changeGroupAddMode(groupId, 'admin_add')
 ```
 
-### 6. Privacy Management
+### 7. Privacy Management
 
 ```javascript
 // Block a user
@@ -316,7 +400,7 @@ await client.updateProfileStatus('Hello World!')
 await client.updateProfileName('My name')
 ```
 
-### 7. Interactive Messages
+### 8. Interactive Messages
 
 #### Buttons
 ```javascript
@@ -409,6 +493,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.
@@ -462,7 +596,121 @@ await client.sendListV2(jid, {
 });
 ```
 
-### 8. Typing & Presence Control
+### 9. Rich AI Messaging
+
+Send Meta AI-style formatted responses like tables, lists, syntax-highlighted code blocks, and LaTeX expressions.
+
+#### Send a Table
+```javascript
+await client.sendTable(
+    jid,
+    'Price List',
+    ['Item', 'Qty', 'Price'],
+    [
+        ['Apple',  '3', '$1.50'],
+        ['Banana', '6', '$0.90']
+    ],
+    msg.raw, // quoted message
+    { headerText: 'Order Summary:', footer: 'Thank you!' }
+);
+```
+
+#### Send a Rich List
+```javascript
+await client.sendRichList(
+    jid,
+    'Available Commands',
+    ['!help', '!ping', '!menu', '!info'],
+    msg.raw, // quoted message
+    { headerText: 'Bot commands:', footer: 'Type any command' }
+);
+```
+
+#### Send a Code Block
+```javascript
+await client.sendCodeBlock(
+    jid,
+    `console.log("Hello World");`,
+    msg.raw, // quoted message
+    { title: 'Example Code', language: 'javascript' }
+);
+```
+
+#### Send LaTeX Text
+```javascript
+// Note: WhatsApp clients require a pre-rendered image URL to display LaTeX graphically. 
+// This method sends the raw LaTeX text which may be invisible without an image url.
+// The quoted message parameter can be omitted by passing the options directly.
+await client.sendLatex(
+    jid,
+    { text: 'Quadratic formula:', expressions: [{ latexExpression: 'x = \\frac{-b \\pm \\sqrt{b^2 - 4ac}}{2a}' }] }
+);
+```
+
+#### Send LaTeX with Image Rendering
+
+Render a LaTeX expression to a PNG image using the online CodeCogs API, upload, and send.
+
+```javascript
+// Send a LaTeX expression as an image with no caption
+await client.sendLatexImage(jid, 'E=mc^2');
+
+// Send a LaTeX expression with a custom caption (omitting quoted message)
+await client.sendLatexImage(jid, {
+    formula: 'E=mc^2',
+    caption: 'Mass-Energy Equivalence'
+});
+```
+
+#### Send LaTeX Inline Images (Album)
+
+Render multiple LaTeX expressions as an album message.
+
+```javascript
+// Send LaTeX images as an album with the formula strings as captions (omitting quoted message)
+await client.sendLatexInlineImage(jid, {
+    expressions: [
+        { latexExpression: '\\nabla \\cdot \\mathbf{E} = \\frac{\\rho}{\\varepsilon_0}' },
+        { latexExpression: '\\nabla \\times \\mathbf{B} = \\mu_0 \\mathbf{J} + \\mu_0\\varepsilon_0 \\frac{\\partial \\mathbf{E}}{\\partial t}' }
+    ],
+    caption: true // true: formula text as caption; string: overall custom caption; false/omit: no captions
+});
+```
+
+#### Fully Custom Rich AI Message
+```javascript
+await client.sendRichMessage(
+    jid,
+    [
+        { messageType: 2, messageText: '🤖 *AI Response*' },
+        { messageType: 5, codeMetadata: { codeLanguage: 'python', codeBlocks: [{ highlightType: 1, codeContent: 'print("Hello")' }] } }
+    ],
+    msg.raw // quoted message
+);
+```
+
+#### Send Markdown
+```javascript
+await client.sendMarkdown(
+    jid,
+    '# H1\n## H2\n==Highlighted==\n_Italics_ and **Bold**!',
+    msg.raw // quoted message (or null)
+);
+```
+
+#### Send Rich Response using sendMessage
+```javascript
+// Text + syntax-highlighted code block
+await client.sendMessage(jid, {
+    richResponse: {
+        text: 'Here is a JavaScript example:',
+        code: `const greet = (name) => {\n  console.log('Hello, ' + name)\n}\ngreet('World')`,
+        language: 'javascript' // 'javascript' | 'typescript' | 'python' | 'js' | 'ts' | 'py'
+    }
+});
+```
+
+### 10. Typing & Presence Control
 
 Use `createPresenceController` for manual or standalone typing/recording presence control — without needing the auto-reply system.
 
@@ -487,7 +735,7 @@ await typing.startRecording(jid, { duration: 3000 });
 await typing.stopAll();
 ```
 
-### 9. Message History (Store)
+### 11. Message History (Store)
 
 The library includes a robust message store to keep track of chat history, even across reloads.
 
@@ -553,8 +801,64 @@ client.on('store-loaded', (info) => {
     console.log(`Loaded ${info.messageCount} messages from file`);
 });
 ```
+
+### 12. 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 +881,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 +938,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 +1005,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')
@@ -815,8 +1136,6 @@ try {
 }
 ```
 
-## Baileys v7.x.x LID Store Implementation
-
 ### Overview
 
 This library fully supports Baileys v7.x.x LID (Local Identifier) system for enhanced privacy and WhatsApp's transition to username-based identification.
@@ -1098,12 +1417,15 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ## Credits
 
-Developed by [Innovators Soft](https://facebook.com/innovatorssoft). Based on the [@itsukichan/baileys](https://github.com/itsukichann/baileys) library.
+Developed by [Innovators Soft](https://github.com/innovatorssoft). Based on the [@innovatorssoft/baileys](https://github.com/innovatorssoft/Baileys) library.
 
 # Special Thanks
 - [@whiskeysockets/baileys](https://github.com/whiskeysockets/Baileys)
-- [@itsukichan](https://github.com/itsukichann)
+- [@innovatorssoft](https://github.com/innovatorssoft)
 - [All Contributors](https://github.com/innovatorssoft/Baileys/)
 - [@ZenboBot](https://discordbot.innovatorssoftpk.com/) - AI Powered Baileys Bot
-# Sponsor Me
-Buy me a coffee - [Innovators Soft](https://facebook.com/innovatorssoft)
+## Support the Project
+
+This project is completely free and open-source. If it saved you time or helped your business, consider supporting us!
+
+[![Support on Patreon](https://img.shields.io/badge/Support-Patreon-FF424D?style=for-the-badge&logo=patreon&logoColor=white)](https://patreon.com/innovatorssoft7)