@innovatorssoft/innovators-bot2 2.0.6 → 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
 
@@ -199,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
@@ -292,7 +348,7 @@ await client.toggleGroupEphemeral(groupId, 86400)
 await client.changeGroupAddMode(groupId, 'admin_add')
 ```
 
-### 6. Privacy Management
+### 7. Privacy Management
 
 ```javascript
 // Block a user
@@ -344,7 +400,7 @@ await client.updateProfileStatus('Hello World!')
 await client.updateProfileName('My name')
 ```
 
-### 7. Interactive Messages
+### 8. Interactive Messages
 
 #### Buttons
 ```javascript
@@ -540,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.
 
@@ -565,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.
 
@@ -632,7 +802,7 @@ client.on('store-loaded', (info) => {
 });
 ```
 
-### 10. Status / Story Posting
+### 12. Status / Story Posting
 
 Post text, image, video, and voice note statuses easily using the `sendStatus` method.
 
@@ -966,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.
@@ -1249,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)

package/example.js

@@ -1,4 +1,11 @@
-const { WhatsAppClient, STATUS_BACKGROUNDS, STATUS_FONTS } = require('./index')
+const { WhatsAppClient,
+    STATUS_BACKGROUNDS,
+    STATUS_FONTS,
+    renderLatexToPng,
+    uploadUnencryptedToWA,
+    RichSubMessageType
+} = require('./index')
+
 const qrcode = require('qrcode-terminal')
 const fs = require('fs');
 const readline = require('readline');
@@ -48,6 +55,7 @@ async function start() {
         sessionName: sessionDir,
         authmethod: authMethod,
         pairingPhoneNumber: pairingPhoneNumber,
+        ai: true, // Enable/Disable AI flag for outgoing messages (default: true)
         // Message store persistence configuration
         messageStoreFilePath: path.join(sessionDir, 'message-store.json'),
         autoSaveInterval: 5 * 60 * 1000, // Auto-save every 5 minutes
@@ -124,6 +132,37 @@ async function start() {
         console.log('Is Removed:', reaction.isRemoved)
         console.log('Message ID:', reaction.messageKey.id)
     })
+    client.on('poll-votes-update', async (data) => {
+        console.log('\n📊 Poll Votes Updated!');
+        console.log('Chat:', data.jid);
+        console.log('Voter:', data.voter);
+
+        // 1. Extract Poll Creation Message (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('\n📝 Poll Creation Details:');
+                console.log('Question:', pollMessage.name);
+                console.log('Options:', pollMessage.options?.map(o => o.optionName) || []);
+            }
+        }
+
+        // 2. Extract voters array from pollUpdate
+        console.log('\n🗳️ Vote Breakdown:');
+        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}`);
+        const winner = data.pollUpdate.reduce((prev, current) =>
+            prev.voters.length > current.voters.length ? prev : current);
+        console.log(`--> The Winner Is ${winner.name} With ${winner.voters.length} votes`);
+    });
 
     client.on('call', (call) => {
         const callData = call[0]; // Get the first call object from the array
@@ -200,13 +239,23 @@ async function start() {
         // Mark the message as read
         await client.readMessage(msg.raw.key)
 
-        const command = msg.body.toLowerCase().split(' ')[0]
-        const args = msg.body.toLowerCase().split(' ').slice(1).join(' ')
+        const command = msg.body.split(' ')[0].toLowerCase()
+        const args = msg.body.split(' ').slice(1).join(' ')
 
         switch (command) {
             case '!ping':
                 await client.sendMessage(msgFrom, 'Hello Pong! 🎊')
                 break
+            case '!poll':
+                await client.sendMessage(msgFrom, '', {
+                    poll: {
+                        name: 'Which programming language do you like most?',
+                        options: ['JavaScript', 'Python', 'C++', 'Java'],
+                        selectableOptionsCount: 1,
+                        messageId: 'poll1'
+                    }
+                });
+                break
             case '!echo':
                 if (args) {
                     await client.sendMessage(msgFrom, args)
@@ -274,6 +323,18 @@ async function start() {
                 }
                 break
 
+            case '!urlimage':
+                try {
+                    const integrationFormula = '\\dpi{900}\\int\\frac{1}{x}dx=\\ln\\left|x\\right|+C';
+                    const mediaurl = `https://latex.codecogs.com/png.image?${encodeURIComponent(integrationFormula)}`;
+                    await client.sendMedia(msgFrom, mediaurl, {
+                        caption: 'Check out this image!'
+                    })
+                } catch (error) {
+                    await client.sendMessage(msgFrom, `Failed to send image from URL: ${error.message}`)
+                }
+                break
+
             case '!doc':
                 if (fs.existsSync('./example.pdf')) {
                     await client.sendDocument(msgFrom, './example.pdf', 'Check out this document!')
@@ -666,6 +727,17 @@ async function start() {
                     `• !updatestatus <text> - Update profile status\n` +
                     `• !updatename <text> - Update profile name\n\n` +
 
+                    `*🤖 Rich AI Messaging*\n` +
+                    `• !table - Send a formatted table\n` +
+                    `• !richlist - Send a bulleted list\n` +
+                    `• !codeblock - Send a syntax-highlighted code snippet\n` +
+                    `• !latex - Send LaTeX text\n` +
+                    `• !lateximage - Send LaTeX image\n` +
+                    `• !latexinlineimage - Send LaTeX inline image\n` +
+                    `• !rich - Send demo rich message\n` +
+                    `• !markdown - Send native markdown message\n` +
+                    `• !richresponse - Send rich text with code block\n\n` +
+
                     `*🎛️ Templates & Buttons*\n` +
                     `• !buttons - Button template\n` +
                     `• !list - Scrollable list\n\n` +
@@ -718,6 +790,176 @@ async function start() {
                 await client.sendMessage(msgFrom, help)
                 break
 
+            case '!table':
+                await client.sendTable(
+                    msgFrom,
+                    'Price List',
+                    ['Item', 'Qty', 'Price'],
+                    [
+                        ['Apple', '3', '$1.50'],
+                        ['Banana', '6', '$0.90'],
+                        ['Cherry', '1', '$3.00']
+                    ],
+                    msg.raw,
+                    { headerText: 'Here is your order summary:', footer: 'Thank you!' }
+                );
+                break;
+
+            case '!richlist':
+                await client.sendRichList(
+                    msgFrom,
+                    'Available Commands',
+                    ['!help', '!ping', '!menu', '!info'],
+                    msg.raw,
+                    { headerText: 'Bot commands:', footer: 'Type any command to use it.' }
+                );
+                break;
+
+            case '!codeblock':
+                await client.sendCodeBlock(
+                    msgFrom,
+                    `async function fetchData(url) {\n  const res = await fetch(url)\n  return res.json()\n}`,
+                    msg.raw,
+                    { title: '📦 Example – fetch helper', language: 'javascript', footer: 'Copy and paste into your project.' }
+                );
+                break;
+
+            case '!latex':
+                await client.sendLatex(
+                    msgFrom,
+                    { text: 'Quadratic formula:', expressions: [{ latexExpression: 'x=\\frac{-b\\pm\\sqrt{b^2-4ac}}{2a}' }] }
+                );
+                break;
+
+            case '!lateximage':
+                try {
+                    await client.sendLatexImage(
+                        msgFrom,
+                        {
+                            formula: 'E=mc^2',
+                            caption: 'Mass-Energy Equivalence (DPI 600)'
+                        }
+                    );
+                } catch (error) {
+                    return (error)
+                }
+                break;
+
+            case '!latexinlineimage':
+                try {
+                    await client.sendLatexInlineImage(
+                        msgFrom,
+                        {
+                            expressions: [
+                                { latexExpression: 'e^{i\\pi} + 1 = 0' },
+                                { latexExpression: '\\int_a^b x^2 \\, dx = \\frac{b^3 - a^3}{3}' },
+                                { latexExpression: 'f(x) = \\sum_{n=0}^{\\infty} \\frac{f^{(n)}(a)}{n!} (x-a)^n' }
+                            ],
+                            caption: true // Use each LaTeX expression as the caption for its respective image in the album
+                        }
+                    );
+                } catch (error) {
+                    return (error)
+                }
+                break;
+
+            case '!rich':
+                const richLatexExpr = 'E = mc^2';
+                const richPngBuf = await renderLatexToPng(richLatexExpr);
+                const richImageUrl = (await uploadUnencryptedToWA(richPngBuf.buffer, client.sock.waUploadToServer)).url;
+
+                await client.sendRichMessage(msgFrom, [
+                    {
+                        messageType: RichSubMessageType.TEXT,
+                        messageText: '# H1\n## H2\n### H3\n#### H4\n##### H5\n###### H6\n\n___\n\n> To use a horizontal line, you need to have two "\\n" above and below the "___"\n==Highlighted text==\n# By the way, ^you^ can _mix_ ==multiple markdowns== for a **richer response**\n###### Try different combinations...'
+                    },
+                    {
+                        messageType: RichSubMessageType.TABLE,
+                        tableMetadata: {
+                            title: 'Product Prices',
+                            rows: [
+                                { items: ['Product', 'Price', 'Stock'], isHeading: true },
+                                { items: ['Innovators Baileys Pro', '$49.99', 'In Stock'] },
+                                { items: ['Rust WASM Plugin', '$19.99', 'Low Stock'] }
+                            ]
+                        }
+                    },
+                    {
+                        messageType: RichSubMessageType.TEXT,
+                        messageText: 'LaTeX Formula:'
+                    },
+                    {
+                        messageType: RichSubMessageType.INLINE_IMAGE,
+                        imageMetadata: {
+                            imageUrl: {
+                                imagePreviewUrl: richImageUrl,
+                                imageHighResUrl: richImageUrl
+                            },
+                            imageText: richLatexExpr,
+                            alignment: 2
+                        }
+                    },
+                    {
+                        messageType: RichSubMessageType.CODE,
+                        codeMetadata: {
+                            codeLanguage: 'javascript',
+                            codeBlocks: [
+                                { highlightType: 1, codeContent: 'const ' },
+                                { highlightType: 0, codeContent: 'price = ' },
+                                { highlightType: 4, codeContent: '49.99' },
+                                { highlightType: 0, codeContent: ';\n' },
+                                { highlightType: 1, codeContent: 'if ' },
+                                { highlightType: 0, codeContent: '(price > ' },
+                                { highlightType: 4, codeContent: '20' },
+                                { highlightType: 0, codeContent: ') {\n    console.log(' },
+                                { highlightType: 3, codeContent: '"Premium tier"' },
+                                { highlightType: 0, codeContent: ');\n}' }
+                            ]
+                        }
+                    }
+                ], null, { useMarkdown: true });
+                break;
+
+            case '!markdown':
+                await client.sendMarkdown(
+                    msgFrom,
+                    '# Markdown Demo\n## Headers work\n==Highlighted text==\n_Italics_ and **Bold** are supported!',
+                    msg.raw
+                );
+                break;
+
+            case '!richresponse':
+                // Demonstrate that sendMessage can now natively accept an array of rich submessages
+                await client.sendMessage(msgFrom, {
+                    richResponse: [
+                        {
+                            messageType: 2,
+                            messageText: '# H1\n## H2\n### H3\n#### H4\n##### H5\n###### H6\n\n___\n\n> To use a horizontal line, you need to have two "\\n" above and below the "___"\n==Highlighted text==\n# By the way, ^you^ can _mix_ ==multiple markdowns== for a **richer response**\n###### Try different combinations...'
+                        },
+                        {
+                            messageType: 2,
+                            messageText: 'And here is a syntax-highlighted code block natively passed:'
+                        },
+                        {
+                            messageType: 5,
+                            codeMetadata: {
+                                codeLanguage: 'javascript',
+                                codeBlocks: [
+                                    { highlightType: 1, codeContent: 'const ' },
+                                    { highlightType: 0, codeContent: 'greet = (name) => {\n  console.log(' },
+                                    { highlightType: 3, codeContent: '"Hello, "' },
+                                    { highlightType: 0, codeContent: ' + name)\n}\n' },
+                                    { highlightType: 0, codeContent: 'greet(' },
+                                    { highlightType: 3, codeContent: '"World"' },
+                                    { highlightType: 0, codeContent: ')' }
+                                ]
+                            }
+                        }
+                    ]
+                },
+                    { markdown: true });
+                break;
+
             case '!groups':
                 try {
                     const groups = await client.getAllGroups()