@innovatorssoft/innovators-bot2 2.0.1 → 2.0.2

package/README.md

@@ -9,12 +9,14 @@ A powerful WhatsApp client library that provides seamless integration between Ba
 - 💬 Send and receive messages
 - � Message reactions (add/remove emoji reactions)
 - �📸 Media handling (images, videos, documents)
-- 👥 Group management
+- � 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)
 
 ## Installation
 
@@ -97,10 +99,22 @@ await client.sendMedia('1234567890@s.whatsapp.net', './image.jpg', {
     caption: 'Check out this image!'
 })
 
+// Send an image with mentions
+await client.sendMedia('1234567890@s.whatsapp.net', './image.jpg', {
+    caption: 'Hey @user, check this out!',
+    mentions: ['user@s.whatsapp.net']
+})
+
 // Send a document
 await client.sendDocument('1234567890@s.whatsapp.net', './document.pdf', 
     'Check out this document!'
 )
+
+// Send a document with mentions (caption object is supported)
+await client.sendDocument('1234567890@s.whatsapp.net', './document.pdf', {
+    caption: 'Hey @user, please read this',
+    mentions: ['user@s.whatsapp.net']
+})
 ```
 
 ### 3. Sticker Management
@@ -277,7 +291,7 @@ await client.sendButtons('1234567890@s.whatsapp.net', {
     text: 'Do you like this bot?',
     title: 'Feedback',
     subtitle: 'Let us know!',
-    footer: 'Powered by Baileys',
+    footer: 'Powered by Innovators Soft',
     interactiveButtons: [
         {
             name: 'quick_reply',
@@ -295,6 +309,43 @@ await client.sendButtons('1234567890@s.whatsapp.net', {
         }
     ]
 });
+
+// Send interactive buttons with an image from URL + caption
+await client.sendButtons('1234567890@s.whatsapp.net', {
+    image: { url: 'https://example.com/image.jpg' },
+    caption: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    interactiveButtons: [
+        {
+            name: 'quick_reply',
+            buttonParamsJson: JSON.stringify({
+                display_text: 'DisplayText',
+                id: 'ID1'
+            })
+        }
+    ],
+    hasMediaAttachment: false
+});
+
+// Send interactive buttons with a local image file + caption
+await client.sendButtons('1234567890@s.whatsapp.net', {
+    imagePath: './image.jpg',
+    caption: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    interactiveButtons: [
+        {
+            name: 'quick_reply',
+            buttonParamsJson: JSON.stringify({
+                display_text: 'DisplayText',
+                id: 'ID1'
+            })
+        }
+    ]
+});
 ```
 
 #### List Messages
@@ -444,6 +495,24 @@ client.on('disconnected', (error) => {
 })
 ```
 
+### Contact Events
+```javascript
+// When contacts are received from history sync
+client.on('contacts-received', (contacts) => {
+    console.log(`Received ${contacts.length} contacts`);
+})
+
+// When new contacts are added/updated
+client.on('contacts-upsert', (contacts) => {
+    console.log(`New Contacts: ${contacts.length} contacts added/updated`);
+})
+
+// When existing contacts are updated (profile picture changes, etc.)
+client.on('contacts-update', (updates) => {
+    console.log(`Contact Updates: ${updates.length} contacts modified`);
+})
+```
+
 ### Message Events
 ```javascript
 // When a new message is received
@@ -457,7 +526,14 @@ client.on('message', async msg => {
     // Handle different message types
     if (msg.hasMedia) {
         console.log('Message contains media')
-        // Handle media message
+        // Download media (image/video/audio/document)
+        const media = await client.downloadMedia(msg)
+        if (media) {
+            const fs = require('fs')
+            const fileName = `./download-${Date.now()}.${media.extension}`
+            fs.writeFileSync(fileName, media.buffer)
+            console.log('Saved media to:', fileName)
+        }
     }
 })
 ```
@@ -844,3 +920,11 @@ 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.
+
+# Special Thanks
+- [@whiskeysockets/baileys](https://github.com/whiskeysockets/Baileys)
+- [@itsukichan](https://github.com/itsukichann)
+- [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)

package/example.js

@@ -76,6 +76,19 @@ async function start() {
         console.log('📦 New LID/PN mappings received')
     })
 
+    // Handle Contact Events
+    client.on('contacts-received', (contacts) => {
+        console.log(`\n👥 History Sync: Received ${contacts.length} contacts`);
+    })
+
+    client.on('contacts-upsert', (contacts) => {
+        console.log(`\n👥 New Contacts: ${contacts.length} contacts added/updated`);
+    })
+
+    client.on('contacts-update', (updates) => {
+        console.log(`\n👥 Contact Updates: ${updates.length} contacts modified`);
+    })
+
     // Handle Anti-Delete system
     client.on('message-deleted', async (data) => {
         console.log(`\n🛡️ Message from ${data.jid} was deleted!`)
@@ -242,29 +255,6 @@ async function start() {
                                 { title: 'Security', id: 'security', description: 'Security and login options' },
                                 { title: 'Payments', id: 'payments', description: 'Manage payment methods' },
                                 { title: 'Subscriptions', id: 'subscriptions', description: 'View your subscriptions' },
-                                { title: 'Orders', id: 'orders', description: 'View order history' },
-                                { title: 'Wishlist', id: 'wishlist', description: 'Your saved items' },
-                                { title: 'Addresses', id: 'addresses', description: 'Manage shipping addresses' },
-                                { title: 'Help Center', id: 'help', description: 'Get help and support' },
-                                { title: 'Contact Us', id: 'contact', description: 'Reach out to our team' },
-                                { title: 'FAQs', id: 'faqs', description: 'Frequently asked questions' },
-                                { title: 'About Us', id: 'about', description: 'Learn about our company' },
-                                { title: 'Careers', id: 'careers', description: 'Join our team' },
-                                { title: 'Blog', id: 'blog', description: 'Read our latest articles' },
-                                { title: 'Newsletter', id: 'newsletter', description: 'Subscribe to updates' },
-                                { title: 'Events', id: 'events', description: 'Upcoming events' },
-                                { title: 'Webinars', id: 'webinars', description: 'Join live webinars' },
-                                { title: 'Tutorials', id: 'tutorials', description: 'Learn how to use features' },
-                                { title: 'Documentation', id: 'docs', description: 'Technical documentation' },
-                                { title: 'API', id: 'api', description: 'Developer API' },
-                                { title: 'Integrations', id: 'integrations', description: 'Third-party integrations' },
-                                { title: 'Download', id: 'download', description: 'Download our app' },
-                                { title: 'Pricing', id: 'pricing', description: 'View pricing plans' },
-                                { title: 'Upgrade', id: 'upgrade', description: 'Upgrade your plan' },
-                                { title: 'Refer a Friend', id: 'refer', description: 'Earn rewards' },
-                                { title: 'Feedback', id: 'feedback', description: 'Share your thoughts' },
-                                { title: 'Report Issue', id: 'report', description: 'Report a problem' },
-                                { title: 'Language', id: 'language', description: 'Change language' }
                             ]
                         },
                         {
@@ -277,29 +267,6 @@ async function start() {
                                 { title: 'Data Saver', id: 'data_saver', description: 'Reduce data usage' },
                                 { title: 'Storage', id: 'storage', description: 'Manage local storage' },
                                 { title: 'Cache', id: 'cache', description: 'Clear cached data' },
-                                { title: 'Backup', id: 'backup', description: 'Backup your data' },
-                                { title: 'Restore', id: 'restore', description: 'Restore from backup' },
-                                { title: 'Export Data', id: 'export', description: 'Download your data' },
-                                { title: 'Delete Account', id: 'delete', description: 'Permanently remove account' },
-                                { title: 'Terms of Service', id: 'tos', description: 'Read terms and conditions' },
-                                { title: 'Privacy Policy', id: 'privacy_policy', description: 'How we handle your data' },
-                                { title: 'Cookie Policy', id: 'cookies', description: 'About our use of cookies' },
-                                { title: 'Accessibility', id: 'accessibility', description: 'Accessibility features' },
-                                { title: 'Version', id: 'version', description: 'App version information' },
-                                { title: 'Changelog', id: 'changelog', description: 'Recent updates' },
-                                { title: 'Roadmap', id: 'roadmap', description: 'Upcoming features' },
-                                { title: 'Status', id: 'status', description: 'Service status' },
-                                { title: 'Legal', id: 'legal', description: 'Legal information' },
-                                { title: 'Partners', id: 'partners', description: 'Our partners' },
-                                { title: 'Press', id: 'press', description: 'Press resources' },
-                                { title: 'Investors', id: 'investors', description: 'Investor relations' },
-                                { title: 'Affiliates', id: 'affiliates', description: 'Become an affiliate' },
-                                { title: 'Merchandise', id: 'merch', description: 'Official merchandise' },
-                                { title: 'Donate', id: 'donate', description: 'Support our work' },
-                                { title: 'Volunteer', id: 'volunteer', description: 'Get involved' },
-                                { title: 'Community', id: 'community', description: 'Join our community' },
-                                { title: 'Forum', id: 'forum', description: 'Community discussions' },
-                                { title: 'Beta Program', id: 'beta', description: 'Try beta features' }
                             ]
                         }
                     ]
@@ -334,10 +301,10 @@ async function start() {
 
                 await client.sendButtons(msg.from, {
                     imagePath: './example.jpg',
-                    caption: '', // Keep it short and concise
-                    title: '', // Max 24 chars
-                    subtitle: '', // Optional, appears below title
-                    footer: '',
+                    caption: 'here is captions of image\nwith linebreaks', // Keep it short and concise
+                    title: 'Image Title', // Max 24 chars
+                    subtitle: 'Image Subtitle (but optional)', // Optional, appears below title
+                    footer: 'Image Footer',
                     interactiveButtons: [
                         {
                             name: 'quick_reply',

package/index.js

@@ -61,6 +61,8 @@ class WhatsAppClient extends EventEmitter {
             maxMessagesPerChat: config.maxMessagesPerChat || 1000,
             ttl: config.messageTTL || 24 * 60 * 60 * 1000
         });
+        // Initialize contacts cache
+        this.contactsCache = new NodeCache({ stdTTL: 0, checkperiod: 20 }); // No TTL, manual cleanup on logout
     }
 
     /**
@@ -150,13 +152,11 @@ class WhatsAppClient extends EventEmitter {
                         console.error(`Error fetching metadata for group ${jid}:`, error);
                         return null;
                     }
-                }
+                },
             });
 
             this.store = this.sock.signalRepository.lidMapping;
 
-
-
             this.sock.ev.on('connection.update', async (update) => {
                 const { connection, lastDisconnect, qr } = update;
 
@@ -167,13 +167,13 @@ class WhatsAppClient extends EventEmitter {
                     if (this._connectionState !== 'connected') {
                         const user = getCurrentSenderInfo(this.sock.authState)
                         if (user) {
+                            this.isConnected = true;
                             const userInfo = {
                                 name: user.pushName || 'Unknown',
                                 phone: user.phoneNumber,
                                 platform: user.platform || 'Unknown',
-                                isOnline: true
+                                isOnline: true,
                             };
-                            this.isConnected = true;
                             this._connectionState = 'connected';
                             this.emit('connected', userInfo);
                         }
@@ -387,6 +387,8 @@ class WhatsAppClient extends EventEmitter {
 
             // 👍 Handle message reactions
             this.sock.ev.on('messages.reaction', async (reactions) => {
+
+
                 try {
                     for (const reaction of reactions) {
                         // Get the chat JID, preferring PN over LID
@@ -509,6 +511,34 @@ class WhatsAppClient extends EventEmitter {
                 }
             });
 
+            // Handle contacts from history sync
+            this.sock.ev.on('messaging-history.set', ({ contacts: newContacts }) => {
+                if (newContacts && newContacts.length > 0) {
+                    for (const contact of newContacts) {
+                        this.contactsCache.set(contact.id, contact);
+                    }
+                    this.emit('contacts-received', newContacts);
+
+                }
+            });
+
+            // Handle contacts upsert (new contacts added)
+            this.sock.ev.on('contacts.upsert', (newContacts) => {
+                for (const contact of newContacts) {
+                    this.contactsCache.set(contact.id, contact);
+                }
+                this.emit('contacts-upsert', newContacts);
+            });
+
+            // Handle contacts update (profile picture changes, etc.)
+            this.sock.ev.on('contacts.update', (updates) => {
+                for (const update of updates) {
+                    const existing = this.contactsCache.get(update.id) || {};
+                    this.contactsCache.set(update.id, { ...existing, ...update });
+                }
+                this.emit('contacts-update', updates);
+            });
+
         } catch (error) {
             console.error('Error in connect:', error);
             this.emit('error', error);
@@ -654,6 +684,10 @@ class WhatsAppClient extends EventEmitter {
                     throw new Error('Unsupported file type: ' + fileExtension);
             }
 
+            if (options.mentions) {
+                mediaMessage.mentions = options.mentions;
+            }
+
             return await this.sock.sendMessage(chatId, mediaMessage, { ai: true });
         } catch (error) {
             console.error('Error sending media:', error);
@@ -684,11 +718,20 @@ class WhatsAppClient extends EventEmitter {
             const fileName = path.basename(filePath);
             const mimeType = mime.getType(filePath);
 
-            return await this.sock.sendMessage(chatId, {
+            const messageContent = {
                 document: fileBuffer,
                 caption: caption,
                 mimetype: mimeType,
                 fileName: fileName,
+            };
+
+            if (typeof caption === 'object' && caption !== null) {
+                if (caption.caption) messageContent.caption = caption.caption;
+                if (caption.mentions) messageContent.mentions = caption.mentions;
+            }
+
+            return await this.sock.sendMessage(chatId, {
+                ...messageContent,
             }, { ai: true });
         } catch (error) {
             console.error('Error sending document:', error);
@@ -719,8 +762,16 @@ class WhatsAppClient extends EventEmitter {
         const {
             text,
             imagePath,
+            image,
+            video,
+            document,
+            location,
+            product,
+            mimetype,
+            jpegThumbnail,
             caption,
             title,
+            subtitle,
             footer,
             interactiveButtons = [],
             hasMediaAttachment = false,
@@ -729,24 +780,40 @@ class WhatsAppClient extends EventEmitter {
         let messageContent = {};
 
         try {
+            const base = {
+                title: title,
+                subtitle: subtitle,
+                footer: footer,
+                interactiveButtons: interactiveButtons,
+                hasMediaAttachment: hasMediaAttachment,
+            };
+
             if (imagePath) {
-                // Handle message with image
+                // Handle message with local image path
                 const imageBuffer = fs.readFileSync(imagePath);
                 messageContent = {
+                    ...base,
                     image: imageBuffer,
                     caption: caption,
-                    title: title,
-                    footer: footer,
-                    interactiveButtons: interactiveButtons,
-                    hasMediaAttachment: hasMediaAttachment,
+                };
+            } else if (image || video || document || location || product) {
+                // Pass-through media objects (e.g. { image: { url } })
+                messageContent = {
+                    ...base,
+                    ...(image ? { image } : {}),
+                    ...(video ? { video } : {}),
+                    ...(document ? { document } : {}),
+                    ...(location ? { location } : {}),
+                    ...(product ? { product } : {}),
+                    ...(mimetype ? { mimetype } : {}),
+                    ...(jpegThumbnail ? { jpegThumbnail } : {}),
+                    caption: caption,
                 };
             } else {
                 // Handle text-only message
                 messageContent = {
+                    ...base,
                     text: text,
-                    title: title,
-                    footer: footer,
-                    interactiveButtons: interactiveButtons,
                 };
             }
 
@@ -1183,6 +1250,12 @@ class WhatsAppClient extends EventEmitter {
                 this.sock = null;
             }
 
+            // Clear store interval
+            if (this._storeInterval) {
+                clearInterval(this._storeInterval);
+                this._storeInterval = null;
+            }
+
             // Add a small delay before reconnecting
             await new Promise(resolve => setTimeout(resolve, 1000));
 
@@ -1332,6 +1405,7 @@ class WhatsAppClient extends EventEmitter {
 
             // Update connection state and emit event
             this.isConnected = false;
+
             this.emit('logout', 'Logged out successfully');
 
             return true;
@@ -1343,11 +1417,11 @@ class WhatsAppClient extends EventEmitter {
     }
 
     /**
-     * Download media from a message
-     * @param {object} message - The message object containing media (must have raw property)
-     * @returns {Promise<object|null>} Object with buffer, mimetype, and extension, or null if no media
-     * @throws {Error} If client is not connected or download fails
-     */
+      * Download media from a message
+      * @param {object} message - The message object containing media (must have raw property)
+      * @returns {Promise<object|null>} Object with buffer, mimetype, and extension, or null if no media
+      * @throws {Error} If client is not connected or download fails
+      */
     async downloadMedia(message) {
         if (!this.isConnected) {
             throw new Error('Client is not connected');

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@innovatorssoft/innovators-bot2",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "WhatsApp API",
   "main": "index.js",
   "scripts": {
     "start": "node example.js",
+    "dev": "node --watch example.js",
     "publish:all": "node publish-dual.js"
   },
   "keywords": [