@realvare/baileys 1.0.0 → 1.0.1

package/README.MD

@@ -53,7 +53,6 @@
     - [Text with Formatting](#text-with-formatting)
     - [Basic Media](#basic-media)
     - [Advanced Media](#advanced-media)
-    - [Stickers](#stickers)
       - [Sticker Packs](#sticker-packs)
       - [Stickers on Status (2025 Feature)](#stickers-on-status-2025-feature)
     - [Interactive Messages](#interactive-messages)
@@ -76,7 +75,6 @@
       - [Status Quoted Messages](#status-quoted-messages)
       - [Status Sticker Interaction Messages](#status-sticker-interaction-messages)
       - [AI Rich Response Messages](#ai-rich-response-messages)
-    - [New Interactive Features (2025)](#new-interactive-features-2025)
     - [Other Messages](#other-messages)
       - [Business Call Messages (BCall)](#business-call-messages-bcall)
       - [Call Log Messages](#call-log-messages)
@@ -100,12 +98,14 @@
       - [Secret Encrypted Messages](#secret-encrypted-messages)
       - [Status Notification Messages](#status-notification-messages)
       - [Sticker Sync RMR Messages](#sticker-sync-rmr-messages)
+      - [Request Payment](#request-payment)
       - [Send Payment](#send-payment)
       - [Decline Payment Request](#decline-payment-request)
       - [Cancel Payment Request](#cancel-payment-request)
       - [Scheduled Call Creation](#scheduled-call-creation)
       - [Scheduled Call Edit](#scheduled-call-edit)
       - [Pin/Unpin Messages](#pinunpin-messages)
+  - [Response Management](#response-management)
   - [🎭 Group Features](#-group-features)
     - [Basic Group Management](#basic-group-management)
     - [Participant Management](#participant-management)
@@ -113,15 +113,12 @@
     - [Advanced Group Messages](#advanced-group-messages)
 - [🔧 Fix LID/JID in Your Own Main and Handler](#-fix-lidjid-in-your-own-main-and-handler)
   - [Best Practices for LID/JID](#best-practices-for-lidjid)
-  - [Integrated Example in Main](#integrated-example-in-main)
-  - [Custom Handler Example](#custom-handler-example)
+  - [Integrated Example](#integrated-example)
   - [🚀 Smart LID/JID Cache](#-smart-lidjid-cache)
   - [🛡️ Advanced JID Validation](#️-advanced-jid-validation)
   - [📊 Conditional Logging](#-conditional-logging)
   - [🔧 Performance Configuration](#-performance-configuration)
-- [🧩 Events: LID and JID always available (new)](#-events-lid-and-jid-always-available-new)
-  - [Gestione dei Messaggi (`messages.upsert`)](#gestione-dei-messaggi-messagesupsert)
-  - [Gestione dei Partecipanti di Gruppo (`group-participants.update`)](#gestione-dei-partecipanti-di-gruppo-group-participantsupdate)
+- [🧩 Events: LID and JID Management](#-events-lid-and-jid-management)
 - [⚙️ Advanced Configuration](#️-advanced-configuration)
   - [🔧 Complete Options for makeWASocket](#-complete-options-for-makewasocket)
   - [🛡️ Security and Encryption](#️-security-and-encryption)
@@ -225,26 +222,11 @@ const isValid = isValidJid('1234567890@s.whatsapp.net');
 ### 🎛️ Usage Example
 
 ```javascript
-const { makeWASocket, useMultiFileAuthState, setPerformanceConfig, PerformanceConfig } = require('@realvare/baileys');
+const { makeWASocket, useMultiFileAuthState } = require('@realvare/baileys');
 
 // Set up authentication
 const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys');
 
-// Configure performance settings
-const performanceConfig = new PerformanceConfig();
-
-// Customize settings (optional)
-performanceConfig.updatePerformanceConfig({
-  batchSize: 50,
-  maxRetries: 5,
-  retryDelay: 5000,
-  retryBackoffMultiplier: 1.5,
-  syncFullHistory: false
-});
-
-// Apply configuration
-setPerformanceConfig(performanceConfig);
-
 // Create socket
 const sock = makeWASocket({
   auth: state,
@@ -302,19 +284,7 @@ This library, based on Baileys with specific improvements, offers an intuitive A
 ### Basic Example - Starting Bot
 
 ```typescript
-import makeWASocket, { DisconnectReason, useMultiFileAuthState, getPerformanceConfig, setPerformanceConfig } from '@realvare/baileys';
-
-// Configure performance and cache
-setPerformanceConfig({
-    performance: {
-        enableCache: true,
-        enableMetrics: true
-    },
-    debug: {
-        enableLidLogging: true,
-        logLevel: 'info'
-    }
-});
+import makeWASocket, { DisconnectReason, useMultiFileAuthState } from '@realvare/baileys';
 
 async function startBot() {
     // 🔐 Multi-file authentication setup for persistent sessions
@@ -330,7 +300,10 @@ async function startBot() {
 
     // Improved reconnection system
     let reconnectAttempts = 0;
-    const config = getPerformanceConfig();
+    const maxRetries = 5;
+    const retryDelay = 5000;
+    const retryBackoffMultiplier = 1.5;
+    const maxRetryDelay = 60000;
 
     sock.ev.on('connection.update', (update) => {
         const { connection, lastDisconnect } = update;
@@ -341,16 +314,16 @@ async function startBot() {
             if (shouldReconnect) {
                 reconnectAttempts++;
                 const delay = Math.min(
-                    config.performance.retryDelay * Math.pow(
-                        config.performance.retryBackoffMultiplier,
+                    retryDelay * Math.pow(
+                        retryBackoffMultiplier,
                         reconnectAttempts - 1
                     ),
-                    config.performance.maxRetryDelay
+                    maxRetryDelay
                 );
 
-                console.log(`🔄 Reconnection attempt ${reconnectAttempts}/${config.performance.maxRetries} in ${delay}ms`);
+                console.log(`🔄 Reconnection attempt ${reconnectAttempts}/${maxRetries} in ${delay}ms`);
 
-                if (reconnectAttempts <= config.performance.maxRetries) {
+                if (reconnectAttempts <= maxRetries) {
                     setTimeout(startBot, delay);
                 } else {
                     console.log('❌ Maximum number of reconnection attempts reached');
@@ -369,21 +342,7 @@ async function startBot() {
 ### Anti-Ban Example - Recommended Configuration to Avoid Bans
 
 ```typescript
-import makeWASocket, { DisconnectReason, useMultiFileAuthState, getPerformanceConfig, setPerformanceConfig, getSenderLid, validateJid } from '@realvare/baileys';
-
-// Anti-ban configuration to reduce ban risks from improper acks
-setPerformanceConfig({
-    performance: {
-        enableCache: true,          // Enable TTL cache to reduce API calls
-        enableMetrics: true,        // Monitor performance to avoid overload
-        batchSize: 50,              // Process messages in smaller batches to simulate human speed
-        maxRetries: 5,              // Limit retry attempts to avoid aggressive behavior
-        retryDelay: 5000,           // Base delay in ms for reconnections
-        retryBackoffMultiplier: 1.5,// Exponential backoff to space retries
-        maxRetryDelay: 60000,       // Maximum delay to avoid rapid reconnections
-        maxMsgRetryCount: 3         // Limit message resend attempts
-    }
-});
+import makeWASocket, { DisconnectReason, useMultiFileAuthState, getSenderLid, validateJid } from '@realvare/baileys';
 
 async function startBot() {
     const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys');
@@ -398,7 +357,10 @@ async function startBot() {
     });
 
     let reconnectAttempts = 0;
-    const config = getPerformanceConfig();
+    const maxRetries = 5;
+    const retryDelay = 5000;
+    const retryBackoffMultiplier = 1.5;
+    const maxRetryDelay = 60000;
 
     sock.ev.on('connection.update', (update) => {
         const { connection, lastDisconnect } = update;
@@ -409,14 +371,14 @@ async function startBot() {
             if (shouldReconnect) {
                 reconnectAttempts++;
                 const delay = Math.min(
-                    config.performance.retryDelay * Math.pow(
-                        config.performance.retryBackoffMultiplier,
+                    retryDelay * Math.pow(
+                        retryBackoffMultiplier,
                         reconnectAttempts - 1
                     ),
-                    config.performance.maxRetryDelay
+                    maxRetryDelay
                 );
 
-                console.log(`Reconnecting attempt ${reconnectAttempts}/${config.performance.maxRetries} in ${delay}ms`);
+                console.log(`Reconnecting attempt ${reconnectAttempts}/${maxRetries} in ${delay}ms`);
 
                 if (reconnectAttempts <= config.performance.maxRetries) {
                     setTimeout(startBot, delay);
@@ -483,21 +445,19 @@ console.log('Cache statistics:', stats);
 
 ### Advanced Cache Configuration
 
-The cache can be configured with various options to optimize performance:
+The cache is pre-configured with optimal settings for production use:
 
 ```typescript
-setPerformanceConfig({
-    cache: {
-        lidCache: {
-            ttl: 5 * 60 * 1000, // Entry lifetime
-            maxSize: 10000,      // Maximum number of entries
-            cleanupInterval: 2 * 60 * 1000 // Cleanup interval
-        }
-    },
-    performance: {
-        memoryThreshold: 0.85 // Threshold for automatic cleanup
-    }
-});
+import { CacheManager } from '@realvare/baileys';
+
+// Cache is automatically configured with:
+// - lidCache: 5 minutes TTL, 10000 max entries
+// - jidCache: 5 minutes TTL, 10000 max entries
+// - Automatic cleanup and memory management
+
+// Monitor cache performance
+const stats = CacheManager.getStats('lidCache');
+console.log('Cache statistics:', stats);
 ```
 ## 🔍 Troubleshooting
 
@@ -513,13 +473,12 @@ setPerformanceConfig({
 
 ### Advanced Logging
 ```typescript
-setPerformanceConfig({
-    debug: {
-        enableLidLogging: true,
-        enablePerformanceLogging: true,
-        logLevel: 'debug'
-    }
-});
+import { Logger } from '@realvare/baileys';
+
+// Use the built-in Logger for conditional logging
+Logger.debug('Debug info');
+Logger.performance('Performance metrics');
+Logger.error('Error occurred');
 ```
 
 ### Basic Message Management with LID/JID
@@ -575,7 +534,6 @@ This section expands on the main methods, with detailed examples and parameters.
 | `validateJid(jid)` | **Validation**: Verifies JID | ✅ Included |
 | `getCacheStats()` | **Performance**: Cache statistics | ✅ Included |
 | `clearCache()` | **Cleanup**: Clears cache | ✅ Included |
-| `setPerformanceConfig(config)` | **Config**: Customizes performance | ✅ Included |
 
 **🔥 Note**: All the above methods are **ready to use** and shown in the Quick Guide. Go directly to the advanced sections for specific features!
 
@@ -1996,18 +1954,9 @@ conn.ev.on('messages.upsert', async ({ messages }) => {
 The library now includes an advanced cache system to optimize LID/JID conversions:
 
 ```typescript
-import { getCacheStats, clearCache, setPerformanceConfig } from '@realvare/baileys';
-
-// Configure custom cache
-setPerformanceConfig({
-    cache: {
-        lidCache: {
-            ttl: 10 * 60 * 1000, // 10 minutes
-            maxSize: 15000
-        }
-    }
-});
+import { getCacheStats, clearCache, CacheManager } from '@realvare/baileys';
 
+// Cache is pre-configured with optimal settings
 // Monitor performance
 const stats = getCacheStats();
 console.log('LID Cache:', stats.lidCache.size, '/', stats.lidCache.maxSize);
@@ -2034,18 +1983,9 @@ if (validation.isValid) {
 ### 📊 Conditional Logging
 
 ```typescript
-import { Logger, setPerformanceConfig } from '@realvare/baileys';
+import { Logger } from '@realvare/baileys';
 
-// Configure logging
-setPerformanceConfig({
-    debug: {
-        enableLidLogging: true,
-        enablePerformanceLogging: true,
-        logLevel: 'debug' // 'error', 'warn', 'info', 'debug'
-    }
-});
-
-// Use conditional logger
+// Use the built-in Logger for conditional logging
 Logger.debug('Debug info');
 Logger.performance('Performance metrics');
 Logger.error('Error occurred');
@@ -2053,30 +1993,20 @@ Logger.error('Error occurred');
 
 ### 🔧 Performance Configuration
 
+The library comes pre-configured with optimal settings. Cache and logging are automatically managed:
+
 ```typescript
-import { setPerformanceConfig, getPerformanceConfig } from '@realvare/baileys';
+import { CacheManager, Logger, getCacheStats } from '@realvare/baileys';
 
-// Complete configuration
-setPerformanceConfig({
-    performance: {
-        enableCache: true,
-        enableMetrics: true,
-        batchSize: 100,
-        maxRetries: 3
-    },
-    cache: {
-        lidCache: { ttl: 5 * 60 * 1000, maxSize: 10000 },
-        jidCache: { ttl: 5 * 60 * 1000, maxSize: 10000 }
-    },
-    debug: {
-        enableLidLogging: false,
-        logLevel: 'warn'
-    }
-});
+// Cache is automatically configured and managed
+// Monitor cache performance
+const stats = getCacheStats();
+console.log('Cache enabled: true');
+console.log('LID Cache:', stats.lidCache.size, '/', stats.lidCache.maxSize);
 
-// Get current configuration
-const config = getPerformanceConfig();
-console.log('Cache enabled:', config.performance.enableCache);
+// Use Logger for conditional logging
+Logger.debug('Debug info');
+Logger.error('Error occurred');
 ```
 
 ---

package/lib/Socket/groups.js

@@ -6,7 +6,6 @@ const Types_1 = require("../Types");
 const Utils_1 = require("../Utils");
 const WABinary_1 = require("../WABinary");
 const chats_1 = require("./chats");
-const { getPerformanceConfig } = require('../Utils/performance-config');
 const { CacheManager } = require('../Utils/cache-manager');
 const makeGroupsSocket = (config) => {
     const sock = (0, chats_1.makeChatsSocket)(config);
@@ -24,8 +23,6 @@ const makeGroupsSocket = (config) => {
         content
     }));
     const groupMetadata = async (jid) => {
-        const config = getPerformanceConfig();
-
         const forbiddenUntil = forbiddenGroupMetadataUntil.get(jid);
         if (forbiddenUntil && forbiddenUntil > Date.now()) {
             const err = new Error('forbidden');
@@ -54,30 +51,29 @@ const makeGroupsSocket = (config) => {
             let retryCount = 0;
             const maxRetries = 3;
             const baseDelay = 1000; // 1 second
-            
+
             while (retryCount <= maxRetries) {
                 try {
                     const result = await groupQuery(jid, 'get', [{ tag: 'query', attrs: { request: 'interactive' } }]);
                     const metadata = (0, exports.extractGroupMetadata)(result);
 
-                    // Cache the result
-                    CacheManager.set('groupMetadataCache', jid, metadata, config.cache.groupMetadataCache.ttl);
+                    // Cache the result (default TTL: 5 minutes)
+                    CacheManager.set('groupMetadataCache', jid, metadata, 5 * 60 * 1000);
 
                     return metadata;
                 } catch (error) {
                     const statusCode = error?.output?.statusCode || error?.data;
                     if (statusCode === 403 || error?.message === 'forbidden') {
-                        const cooldownMs = 5 * 60 * 1000;
+                        const cooldownMs = 30 * 1000;
                         forbiddenGroupMetadataUntil.set(jid, Date.now() + cooldownMs);
                         throw error;
                     }
                     if (error.message === 'rate-overlimit' && retryCount < maxRetries) {
-                        const delay = baseDelay * Math.pow(2, retryCount); // Exponential backoff
+                        const delay = baseDelay * Math.pow(2, retryCount);
                         config.logger?.warn({ jid, retryCount, delay }, 'Rate limit hit, retrying group metadata fetch');
                         await new Promise(resolve => setTimeout(resolve, delay));
                         retryCount++;
                     } else {
-                        // Re-throw non-rate-limit errors or if max retries exceeded
                         throw error;
                     }
                 }
@@ -144,11 +140,15 @@ const makeGroupsSocket = (config) => {
 
     ev.on('group-participants.update', async (update) => {
         CacheManager.del('groupMetadataCache', update.id);
+        // Clear forbidden cooldown when participant update occurs (e.g. bot was added)
+        forbiddenGroupMetadataUntil.delete(update.id);
     });
 
     ev.on('groups.upsert', async (groups) => {
         for (const group of groups) {
             CacheManager.del('groupMetadataCache', group.id);
+            // Clear forbidden cooldown when a group is created/joined
+            forbiddenGroupMetadataUntil.delete(group.id);
         }
     });
     return {
@@ -202,24 +202,32 @@ const makeGroupsSocket = (config) => {
             ]);
             const node = (0, WABinary_1.getBinaryNodeChild)(result, 'membership_approval_requests');
             const participants = (0, WABinary_1.getBinaryNodeChildren)(node, 'membership_approval_request');
-            return participants.map(v => v.attrs);
+            return participants.map(v => {
+                const rawJid = v.attrs.jid || '';
+                const resolvedJid = rawJid.endsWith('@lid')
+                    ? (v.attrs.phone_number
+                        ? (v.attrs.phone_number.includes('@') ? v.attrs.phone_number : `${v.attrs.phone_number}@s.whatsapp.net`)
+                        : rawJid)
+                    : rawJid;
+                return { ...v.attrs, jid: resolvedJid };
+            });
         },
         groupRequestParticipantsUpdate: async (jid, participants, action) => {
             participants = participants.map(resolveJid);
             const result = await groupQuery(jid, 'set', [{
-                    tag: 'membership_requests_action',
-                    attrs: {},
-                    content: [
-                        {
-                            tag: action,
-                            attrs: {},
-                            content: participants.map(jid => ({
-                                tag: 'participant',
-                                attrs: { jid }
-                            }))
-                        }
-                    ]
-                }]);
+                tag: 'membership_requests_action',
+                attrs: {},
+                content: [
+                    {
+                        tag: action,
+                        attrs: {},
+                        content: participants.map(jid => ({
+                            tag: 'participant',
+                            attrs: { jid }
+                        }))
+                    }
+                ]
+            }]);
             const node = (0, WABinary_1.getBinaryNodeChild)(result, 'membership_requests_action');
             const nodeAction = (0, WABinary_1.getBinaryNodeChild)(node, action);
             const participantsAffected = (0, WABinary_1.getBinaryNodeChildren)(nodeAction, 'participant');
@@ -298,13 +306,13 @@ const makeGroupsSocket = (config) => {
             key = typeof key === 'string' ? { remoteJid: key } : key;
             key.remoteJid = resolveJid(key.remoteJid);
             const results = await groupQuery(inviteMessage.groupJid, 'set', [{
-                    tag: 'accept',
-                    attrs: {
-                        code: inviteMessage.inviteCode,
-                        expiration: inviteMessage.inviteExpiration.toString(),
-                        admin: key.remoteJid
-                    }
-                }]);
+                tag: 'accept',
+                attrs: {
+                    code: inviteMessage.inviteCode,
+                    expiration: inviteMessage.inviteExpiration.toString(),
+                    admin: key.remoteJid
+                }
+            }]);
             // if we have the full message key
             // update the invite message to be expired
             if (key.id) {
@@ -420,4 +428,4 @@ const extractGroupMetadata = (result) => {
     };
     return metadata;
 };
-exports.extractGroupMetadata = extractGroupMetadata;
+exports.extractGroupMetadata = extractGroupMetadata;

package/lib/Socket/messages-recv.js

@@ -11,7 +11,6 @@ const WAProto_1 = require("../../WAProto");
 const Defaults_1 = require("../Defaults");
 const Types_1 = require("../Types");
 const Utils_1 = require("../Utils");
-const performance_config_1 = require("../Utils/performance-config");
 const make_mutex_1 = require("../Utils/make-mutex");
 const WABinary_1 = require("../WABinary");
 const groups_1 = require("./groups");
@@ -450,7 +449,14 @@ const makeMessagesRecvSocket = (config) => {
         switch (child === null || child === void 0 ? void 0 : child.tag) {
             case 'create':
                 let metadata = (0, groups_1.extractGroupMetadata)(child);
-                const fullMetadata = await groupMetadata(groupJid);
+                let fullMetadata;
+                try {
+                    fullMetadata = await groupMetadata(groupJid);
+                } catch (_err) {
+                    // groupMetadata may fail with 403 right after group creation
+                    // Use the partial metadata from the notification itself
+                    fullMetadata = metadata;
+                }
                 if (metadata.owner && metadata.owner.endsWith('@lid')) {
                     const found = fullMetadata.participants.find(p => p.id === metadata.owner);
                     metadata.owner = (found === null || found === void 0 ? void 0 : found.jid) || (0, WABinary_1.lidToJid)(metadata.owner);
@@ -1486,7 +1492,6 @@ const makeMessagesRecvSocket = (config) => {
         }
     });
     ev.on('messages.update', (updates) => {
-        const config = (0, performance_config_1.getPerformanceConfig)();
         updates.forEach(update => {
             if (update.update.status === WAProto_1.proto.WebMessageInfo.Status.PENDING &&
                 Date.now() - (update.update.timestamp || 0) > 30000) {
@@ -1500,7 +1505,7 @@ const makeMessagesRecvSocket = (config) => {
                     } catch (err) {
                         logger.error({ err, key: update.key }, 'failed to retry stuck message');
                     }
-                }, config.security?.messageDelay?.min || 1000);
+                }, 1000);
             }
         });
     });