@realvare/based 2.5.8 → 2.6.0

package/README.MD

@@ -25,6 +25,60 @@
 
 </div>
 
+## Indice
+
+- [Indice](#indice)
+- [✨ Caratteristiche Principali](#-caratteristiche-principali)
+- [🚀 Guida Rapida](#-guida-rapida)
+  - [Esempio Base - Avvio Bot](#esempio-base---avvio-bot)
+  - [Esempio Anti-Ban - Configurazione consigliata per Evitare Ban](#esempio-anti-ban---configurazione-consigliata-per-evitare-ban)
+- [📊 Gestione Avanzata Cache](#-gestione-avanzata-cache)
+  - [Configurazione Cache Avanzata](#configurazione-cache-avanzata)
+- [🔍 Risoluzione Problemi](#-risoluzione-problemi)
+  - [Problemi di Connessione](#problemi-di-connessione)
+  - [Gestione Memoria](#gestione-memoria)
+  - [Logging Avanzato](#logging-avanzato)
+  - [Gestione Messaggi Base con LID/JID](#gestione-messaggi-base-con-lidjid)
+- [📚 Documentazione API](#-documentazione-api)
+  - [🏗️ Metodi Fondamentali](#️-metodi-fondamentali)
+  - [🎯 Eventi Principali](#-eventi-principali)
+- [🎪 Messaggi e Funzionalità Interattive](#-messaggi-e-funzionalità-interattive)
+  - [Messaggi Base](#messaggi-base)
+    - [Testo con Formattazione](#testo-con-formattazione)
+    - [Media Base](#media-base)
+    - [Media Avanzati](#media-avanzati)
+    - [Messaggi Interattivi](#messaggi-interattivi)
+      - [Messaggi con Bottoni Semplici](#messaggi-con-bottoni-semplici)
+      - [Messaggi con Bottoni e Immagine](#messaggi-con-bottoni-e-immagine)
+      - [Messaggi Liste](#messaggi-liste)
+    - [Altri Messaggi](#altri-messaggi)
+  - [Gestione delle Risposte](#gestione-delle-risposte)
+  - [🎭 Funzionalità Gruppi](#-funzionalità-gruppi)
+    - [Gestione Base Gruppi](#gestione-base-gruppi)
+    - [Gestione Partecipanti](#gestione-partecipanti)
+    - [Impostazioni Gruppo](#impostazioni-gruppo)
+    - [Messaggi Gruppo Avanzati](#messaggi-gruppo-avanzati)
+- [🔧 Fix LID/JID nel Proprio Main e Handler](#-fix-lidjid-nel-proprio-main-e-handler)
+  - [Best Practices per LID/JID](#best-practices-per-lidjid)
+  - [Esempio Integrato in Main](#esempio-integrato-in-main)
+  - [Esempio Handler Personalizzato](#esempio-handler-personalizzato)
+  - [🚀 Cache Intelligente LID/JID](#-cache-intelligente-lidjid)
+  - [🛡️ Validazione JID Avanzata](#️-validazione-jid-avanzata)
+  - [📊 Logging Condizionale](#-logging-condizionale)
+  - [🔧 Configurazione Performance](#-configurazione-performance)
+- [🧩 Eventi: LID e JID sempre disponibili (nuovo)](#-eventi-lid-e-jid-sempre-disponibili-nuovo)
+- [⚙️ Configurazione Avanzata](#️-configurazione-avanzata)
+  - [🔧 Opzioni Complete per makeWASocket](#-opzioni-complete-per-makewasocket)
+  - [🛡️ Sicurezza e Crittografia](#️-sicurezza-e-crittografia)
+- [🌐 Supporto e Community](#-supporto-e-community)
+  - [📞 Contatti e Risorse](#-contatti-e-risorse)
+- [🙏 Ringraziamenti](#-ringraziamenti)
+- [⚠️ Disclaimer \& Licenza](#️-disclaimer--licenza)
+  - [📋 Nota Legale](#-nota-legale)
+  - [📜 Licenza MIT](#-licenza-mit)
+
+----
+
 ## ✨ Caratteristiche Principali
 
 <p align="center">
@@ -43,7 +97,7 @@ Questa libreria, basata su Baileys con miglioramenti specifici, offre un'API int
     </td>
     <td align="center" width="25%">
       <h3>💬 Messaggi</h3>
-      <p>• Testo, media, interattivi<br>• Bottoni, liste, carousel<br>• Album, poll, reazioni<br>• Template avanzati</p>
+      <p>• Testo, media, interattivi<br>• Bottoni, liste, album<br>• Poll, reazioni<br>• Template avanzati</p>
     </td>
     <td align="center" width="25%">
       <h3>🛠️ Developer</h3>
@@ -330,79 +384,20 @@ Questa sezione espande i metodi principali, con esempi dettagliati e parametri.
 
 ### 🏗️ Metodi Fondamentali
 
-<details>
-<summary><strong>📡 makeWASocket(config)</strong></summary>
-
-Crea un'istanza del socket WhatsApp. È il punto di ingresso principale.
-
-**Parametri:**
-- `config`: Oggetto con opzioni (vedi sezione Configurazione Avanzata per dettagli completi).
-
-**Restituisce:** Istanza del socket con metodi come `sendMessage` e `ev` per eventi.
-
-**Esempio:**
-```typescript
-const sock = makeWASocket({
-  auth: state,
-  printQRInTerminal: true,
-  logger: console,
-  browser: ['Varebot', 'Chrome', '4.0.0'],
-});
-```
-</details>
-<details>
-<summary><strong>🔐 useMultiFileAuthState(folder)</strong></summary>
-
-Gestisce l'autenticazione persistente salvando credenziali in file multipli per sicurezza.
-
-**Parametri:**
-- `folder`: Stringa, path della cartella per i file di auth (es. 'auth_info').
-
-**Restituisce:**
-- `{ state, saveCreds }`: Stato autenticazione e funzione per salvare aggiornamenti.
-
-**Esempio:**
-```typescript
-const { state, saveCreds } = await useMultiFileAuthState('auth_info');
-conn.ev.on('creds.update', saveCreds); // Integra nel socket
-```
-</details>
-
-<details>
-<summary><strong>🔄 getSenderLid(message) & toJid(lid)</strong></summary>
-
-Utilità per gestire LID/JID, risolvendo problemi comuni in gruppi e multi-dispositivo.
-
-**getSenderLid(message):**
-- Estrae LID dal messaggio.
-- Restituisce: Oggetto con `lid` e altre info mittente.
-
-**toJid(lid):**
-- Converte LID in JID normalizzato (es. prende pn e aggiunge `@s.whatsapp.net`).
-
-**Esempio:**
-```typescript
-const info = getSenderLid(msg);
-const jid = toJid(info.lid);
-conn.sendMessage(jid, { text: 'we ridin porsches in the rain' });
-```
-</details>
-
-<details>
-<summary><strong>📤 sendMessage(jid, content, options)</strong></summary>
+| Metodo | Descrizione | Import |
+|--------|-------------|--------|
+| `makeWASocket(config)` | **Core**: Crea socket WhatsApp | ✅ Incluso |
+| `useMultiFileAuthState(folder)` | **Auth**: Gestione credenziali persistenti | ✅ Incluso |
+| `getSenderLid(msg)` | **LID**: Estrae LID dal messaggio | ✅ Incluso |
+| `toJid(lid)` | **JID**: Converte LID → JID | ✅ Incluso |
+| `validateJid(jid)` | **Validazione**: Verifica JID | ✅ Incluso |
+| `getCacheStats()` | **Performance**: Statistiche cache | ✅ Incluso |
+| `clearCache()` | **Pulizia**: Svuota cache | ✅ Incluso |
+| `setPerformanceConfig(config)` | **Config**: Personalizza performance | ✅ Incluso |
 
-Invia messaggi di vari tipi. Supporta testo, media, interattivi.
+**🔥 Nota**: Tutti i metodi sopra sono **già pronti all'uso** e mostrati nella Guida Rapida. Passa direttamente alle sezioni avanzate per funzionalità specifiche!
 
-**Parametri:**
-- `jid`: Stringa JID del destinatario.
-- `content`: Oggetto messaggio (es. { text: 'finche vedo tutto violaviola' }).
-- `options`: Opzionale, include `quoted`, `mentions`, ecc.
-
-**Esempio Testo Semplice:**
-```typescript
-await conn.sendMessage(jid, { text: 'bankai!' });
-```
-</details>
+---
 
 ### 🎯 Eventi Principali
 
@@ -543,31 +538,6 @@ await conn.sendMessage(jid, {
 });
 ```
 
-##### Carousel e Card Messages
-Il carousel è un tipo speciale di messaggio che permette di mostrare una serie di card scorrevoli.
-```typescript
-await conn.sendMessage(jid, {
-  text: '〖 🌸 〗 Benvenuto in VareBot!',
-  title: '',
-  footer: '',
-  cards: [
-    {
-      image: { url: 'https://i.ibb.co/hJW7WwxV/varebot.jpg' },
-      title: 'by sam aka vare',
-      body: '〖 💫 〗 Esplora funzionalità\n〖 🚀 〗 Bot aggiornato',
-      footer: '˗ˏˋ ☾ 𝚟𝚊𝚛𝚎𝚋𝚘𝚝 ☽ ˎˊ˗',
-      buttons: [
-        { name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: 'Sito VareBot', url: 'https://varebot.netlify.app' }) },
-        { name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: '💻 GitHub', url: 'https://github.com/realvare' }) },
-        { name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: '💬 WhatsApp', url: 'https://wa.me/393476686131' }) },
-        { name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: '📸 Instagram', url: 'https://instagram.com/samakavare' }) },
-        { name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: '📧 Email', url: 'mailto:samakavare1@gmail.com' }) },
-      ],
-    },
-  ],
-}, { quoted: m });
-```
-
 #### Altri Messaggi
 ```typescript
 // Messaggio con citazione
@@ -849,6 +819,15 @@ await conn.groupAcceptInvite(code);
 // Ottenere info gruppo da link
 const groupInfo = await conn.groupGetInviteInfo('https://chat.whatsapp.com/ABC123');
 
+// Ascolta modifiche impostazioni
+conn.ev.on('group-settings.update', async ({ id, announce, restrict }) => {
+    if (announce !== undefined) {
+        await conn.sendMessage(id, { text: `Il gruppo è stato impostato come ${announce ? 'solo admin' : 'tutti'}` });
+    }
+    if (restrict !== undefined) {
+        await conn.sendMessage(id, { text: `Le info gruppo possono essere modificate da ${restrict ? 'solo admin' : 'tutti'}` });
+    }
+});
 ```
 
 #### Messaggi Gruppo Avanzati
@@ -871,24 +850,8 @@ await conn.sendMessage(jid, {
         isForwarded: true
     }
 });
-
 ```
 
-// Ascolta modifiche impostazioni
-conn.ev.on('group-settings.update', async ({ jid, announce, restrict }) => {
-    if(announce !== undefined) {
-        await conn.sendMessage(jid, {
-            text: `Il gruppo è stato impostato come ${announce ? 'solo admin' : 'tutti'}`
-        });
-    }
-    if(restrict !== undefined) {
-        await conn.sendMessage(jid, {
-            text: `Le info gruppo possono essere modificate da ${restrict ? 'solo admin' : 'tutti'}`
-        });
-    }
-});
-```
-```
 ---
 
 ## 🔧 Fix LID/JID nel Proprio Main e Handler
@@ -1019,8 +982,6 @@ conn.ev.on('messages.upsert', async ({ messages }) => {
 
 ### Esempio Handler Personalizzato
 
-Crea un handler separato per modularità:
-
 ```typescript
 // handler.js
 export async function handleMessage(sock, msg) {
@@ -1285,4 +1246,4 @@ Vedi [LICENSE](LICENSE) per dettagli.
 <br>
 <img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=24&height=120&section=footer&text=&fontSize=30&fontColor=ffffff&animation=fadeIn&fontAlignY=35"/>
 
-</div>
+</div>

package/lib/Defaults/baileys-version.json

@@ -1,3 +1,3 @@
 {
-    "version": [2, 3000, 1023888953]
-}
+    "version": [2, 3000, 1029001831]
+}

package/lib/Signal/libsignal.js

@@ -42,7 +42,17 @@ const sender_key_record_1 = require("./Group/sender-key-record");
 const Group_1 = require("./Group");
 function makeLibSignalRepository(auth) {
     const storage = signalStorage(auth);
+    const lidMapping = {
+        get: async (lid) => {
+            const { [lid]: pn } = await auth.keys.get('lid-mapping', [lid]);
+            return pn;
+        },
+        set: (lid, pn) => {
+            return auth.keys.set({ 'lid-mapping': { [lid]: pn } });
+        }
+    };
     return {
+        lidMapping,
         decryptGroupMessage({ group, authorJid, msg }) {
             const senderName = jidToSignalSenderKeyName(group, authorJid);
             const cipher = new Group_1.GroupCipher(storage, senderName);
@@ -107,6 +117,17 @@ function makeLibSignalRepository(auth) {
         },
         jidToSignalProtocolAddress(jid) {
             return jidToSignalProtocolAddress(jid).toString();
+        },
+        getLidAddress(jid) {
+            const { user, device } = (0, WABinary_1.jidDecode)(jid);
+            return new libsignal.ProtocolAddress(user, device || 0);
+        },
+        getDeviceCanHandleLid() {
+            const { platform, pushname, verifiedName } = auth.creds;
+            if (platform === 'android' || platform === 'ios' || platform === 'smba' || platform === 'smbi') {
+                return true;
+            }
+            return false;
         }
     };
 }

package/lib/Socket/messages-recv.js

@@ -640,12 +640,25 @@ const makeMessagesRecvSocket = (config) => {
                             }
                         }
                         else {
+                            // Log ACK status changes for monitoring
+                            ids.forEach(id => {
+                                const statusName = Object.keys(WAProto_1.proto.WebMessageInfo.Status)[status] || `UNKNOWN_${status}`;
+                                logger.debug({ remoteJid, id, status: statusName }, 'ACK status update');
+                            });
                             ev.emit('messages.update', ids.map(id => ({
                                 key: { ...key, id },
                                 update: { status }
                             })));
                         }
                     }
+                    // Emit SERVER_ACK for error status to fix stuck ACKs
+                    if (status === WAProto_1.proto.WebMessageInfo.Status.ERROR) {
+                        ev.emit('messages.update', ids.map(id => ({
+                            key: { ...key, id },
+                            update: { status: WAProto_1.proto.WebMessageInfo.Status.SERVER_ACK }
+                        })));
+                    }
+
                     if (attrs.type === 'retry') {
                         // correctly set who is asking for the retry
                         key.participant = key.participant || attrs.from;
@@ -1041,6 +1054,22 @@ const makeMessagesRecvSocket = (config) => {
             logger.trace(`sendActiveReceipts set to "${sendActiveReceipts}"`);
         }
     });
+
+    // Retry logic for stuck pending messages
+    ev.on('messages.update', (updates) => {
+        updates.forEach(update => {
+            if (update.update.status === WAProto_1.proto.WebMessageInfo.Status.PENDING &&
+                Date.now() - (update.update.timestamp || 0) > 30000) { // 30 seconds
+                logger.debug({ key: update.key }, 'retrying stuck pending message');
+                // Retry by re-sending the message
+                getMessage(update.key).then(msg => {
+                    if (msg) {
+                        relayMessage(update.key.remoteJid, msg, { messageId: update.key.id });
+                    }
+                }).catch(err => logger.error({ err, key: update.key }, 'failed to retry stuck message'));
+            }
+        });
+    });
     return {
         ...sock,
         sendMessageAck,

package/lib/Socket/messages-send.js

@@ -15,6 +15,7 @@ const link_preview_1 = require("../Utils/link-preview");
 const WABinary_1 = require("../WABinary");
 const WAUSync_1 = require("../WAUSync");
 const newsletter_1 = require("./newsletter");
+const rate_limiter_1 = __importDefault(require("../Utils/rate-limiter"));
 const makeMessagesSocket = (config) => {
     const { logger, linkPreviewImageThumbnailWidth, generateHighQualityLinkPreview, options: axiosOptions, patchMessageBeforeSending, cachedGroupMetadata, } = config;
     const sock = (0, newsletter_1.makeNewsletterSocket)(config);
@@ -23,6 +24,9 @@ const makeMessagesSocket = (config) => {
         stdTTL: Defaults_1.DEFAULT_CACHE_TTLS.USER_DEVICES, // 5 minutes
         useClones: false
     });
+
+    // Initialize rate limiter for anti-ban protection
+    const rateLimiter = new rate_limiter_1.default(1); // 1 message per second default
     let mediaConn;
     const refreshMediaConn = async (forceGet = false) => {
         const media = await mediaConn;
@@ -1074,7 +1078,7 @@ const makeMessagesSocket = (config) => {
                     const results = [];
                     for (const adminJid of adminJids) {
                         try {
-                            const result = await sendMessageInternal(adminJid, contentCopy, options);
+                            const result = await rateLimiter.add(() => sendMessageInternal(adminJid, contentCopy, options));
                             results.push(result);
                         } catch (error) {
                             console.warn(`Failed to send admin-only message to ${adminJid}:`, error);
@@ -1392,7 +1396,7 @@ const makeMessagesSocket = (config) => {
                 }
 
 
-                await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, additionalAttributes, additionalNodes: isAiMsg ? additionalNodes : options.additionalNodes, statusJidList: options.statusJidList });
+                await rateLimiter.add(() => relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, additionalAttributes, additionalNodes: isAiMsg ? additionalNodes : options.additionalNodes, statusJidList: options.statusJidList }));
                 if (config.emitOwnEvents) {
                     process.nextTick(() => {
                         processingMutex.mutex(() => (upsertMessage(fullMsg, 'append')));