@realvare/based 2.6.11 → 2.6.23

package/README.MD

@@ -6,106 +6,106 @@
 ![Retro](https://readme-typing-svg.herokuapp.com?font=VT323&size=24&duration=2500&pause=10000&color=8A2BE2&center=true&vCenter=true&width=250&height=25&lines=$+by+Sam+aka+Vare)
 <br>
 <p align="center">
-  <img src="https://img.shields.io/npm/v/@realvare/based?style=for-the-badge&color=8a2be2&labelColor=2d1b69" alt="Versione NPM">
-  <img src="https://img.shields.io/npm/dm/@realvare/based?style=for-the-badge&color=8a2be2&labelColor=2d1b69" alt="Download NPM">
-  <img src="https://img.shields.io/badge/Licenza-MIT-8a2be2.svg?style=for-the-badge&labelColor=2d1b69" alt="Licenza MIT">
-  <img src="https://img.shields.io/github/stars/realvare/based?style=for-the-badge&color=8a2be2&labelColor=2d1b69" alt="GitHub Stelle">
+  <img src="https://img.shields.io/npm/v/@realvare/based?style=for-the-badge&color=8a2be2&labelColor=2d1b69" alt="NPM Version">
+  <img src="https://img.shields.io/npm/dm/@realvare/based?style=for-the-badge&color=8a2be2&labelColor=2d1b69" alt="NPM Downloads">
+  <img src="https://img.shields.io/badge/License-MIT-8a2be2.svg?style=for-the-badge&labelColor=2d1b69" alt="MIT License">
+  <img src="https://img.shields.io/github/stars/realvare/based?style=for-the-badge&color=8a2be2&labelColor=2d1b69" alt="GitHub Stars">
   <img src="https://img.shields.io/github/forks/realvare/based?style=for-the-badge&color=8a2be2&labelColor=2d1b69" alt="GitHub Forks">
 </p>
 <p align="center">
-  <a href="#-caratteristiche-principali"><img src="https://img.shields.io/badge/_Caratteristiche-8a2be2?style=flat-square&logo=github&logoColor=white"/></a>&nbsp;&nbsp;
-  <a href="#-installazione"><img src="https://img.shields.io/badge/_Installazione-8a2be2?style=flat-square&logo=npm&logoColor=white"/></a>&nbsp;&nbsp;
-  <a href="#-guida-rapida"><img src="https://img.shields.io/badge/_Guida_Rapida-8a2be2?style=flat-square&logo=rocket&logoColor=white"/></a>&nbsp;&nbsp;
-  <a href="#-documentazione-api"><img src="https://img.shields.io/badge/_Documentazione_API-8a2be2?style=flat-square&logo=book&logoColor=white"/></a>&nbsp;&nbsp;
-  <a href="#-supporto-e-community"><img src="https://img.shields.io/badge/_Supporto-8a2be2?style=flat-square&logo=teamspeak&logoColor=white"/></a>
+  <a href="#-main-features"><img src="https://img.shields.io/badge/_Features-8a2be2?style=flat-square&logo=github&logoColor=white"/></a>&nbsp;&nbsp;
+  <a href="#-installation"><img src="https://img.shields.io/badge/_Installation-8a2be2?style=flat-square&logo=npm&logoColor=white"/></a>&nbsp;&nbsp;
+  <a href="#-quick-guide"><img src="https://img.shields.io/badge/_Quick_Guide-8a2be2?style=flat-square&logo=rocket&logoColor=white"/></a>&nbsp;&nbsp;
+  <a href="#-api-documentation"><img src="https://img.shields.io/badge/_API_Documentation-8a2be2?style=flat-square&logo=book&logoColor=white"/></a>&nbsp;&nbsp;
+  <a href="#-support-and-community"><img src="https://img.shields.io/badge/_Support-8a2be2?style=flat-square&logo=teamspeak&logoColor=white"/></a>
 </p>
-  <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=20&duration=4000&pause=2500&color=8A2BE2&center=true&vCenter=true&width=800&lines=💜+Una+libreria+WhatsApp+Web+API+moderna%2C+potente+e+veloce;🔄+Con+supporto+per+LID%2FJID+e+multi-dispositivo;">
+  <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=20&duration=4000&pause=2500&color=8A2BE2&center=true&vCenter=true&width=800&lines=💜+A+modern%2C+powerful+and+fast+WhatsApp+Web+API+library;🔄+With+support+for+LID%2FJID+and+multi-device;">
 
 ----
 
 </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)
+## Table of Contents
+
+- [Table of Contents](#table-of-contents)
+- [✨ Main Features](#-main-features)
+- [🚀 Quick Guide](#-quick-guide)
+  - [Basic Example - Starting Bot](#basic-example---starting-bot)
+  - [Anti-Ban Example - Recommended Configuration to Avoid Bans](#anti-ban-example---recommended-configuration-to-avoid-bans)
+- [📊 Advanced Cache Management](#-advanced-cache-management)
+  - [Advanced Cache Configuration](#advanced-cache-configuration)
+- [🔍 Troubleshooting](#-troubleshooting)
+  - [Connection Issues](#connection-issues)
+  - [Memory Management](#memory-management)
+  - [Advanced Logging](#advanced-logging)
+  - [Basic Message Management with LID/JID](#basic-message-management-with-lidjid)
+- [📚 API Documentation](#-api-documentation)
+  - [🏗️ Fundamental Methods](#️-fundamental-methods)
+  - [🎯 Main Events](#-main-events)
+- [🎪 Messages and Interactive Features](#-messages-and-interactive-features)
+  - [Basic Messages](#basic-messages)
+    - [Text with Formatting](#text-with-formatting)
+    - [Basic Media](#basic-media)
+    - [Advanced Media](#advanced-media)
+    - [Interactive Messages](#interactive-messages)
+      - [Messages with Simple Buttons](#messages-with-simple-buttons)
+      - [Messages with Buttons and Image](#messages-with-buttons-and-image)
+      - [List Messages](#list-messages)
+    - [Other Messages](#other-messages)
+  - [Response Management](#response-management)
+  - [🎭 Group Features](#-group-features)
+    - [Basic Group Management](#basic-group-management)
+    - [Participant Management](#participant-management)
+    - [Group Settings](#group-settings)
+    - [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)
+  - [🚀 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)
+- [⚙️ Advanced Configuration](#️-advanced-configuration)
+  - [🔧 Complete Options for makeWASocket](#-complete-options-for-makewasocket)
+  - [🛡️ Security and Encryption](#️-security-and-encryption)
+- [🌐 Support and Community](#-support-and-community)
+  - [📞 Contacts and Resources](#-contacts-and-resources)
+- [🙏 Acknowledgments](#-acknowledgments)
+- [⚠️ Disclaimer \& License](#️-disclaimer--license)
+  - [📋 Legal Note](#-legal-note)
+  - [📜 MIT License](#-mit-license)
 
 ----
 
-## ✨ Caratteristiche Principali
+## ✨ Main Features
 
 <p align="center">
-  <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=18&duration=2500&pause=2500&color=8A2BE2&center=true&vCenter=true&width=600&lines=🚀+Potente+e+Intuitiva;🔧+Basata+su+Baileys+con+Miglioramenti" alt="Features">
+  <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=18&duration=2500&pause=2500&color=8A2BE2&center=true&vCenter=true&width=600&lines=🚀+Powerful+and+Intuitive;🔧+Based+on+Baileys+with+Improvements" alt="Features">
 </div>
 
 <br>
 
-Questa libreria, basata su Baileys con miglioramenti specifici, offre un'API intuitiva per interagire con WhatsApp Web. Ecco un riassunto delle funzionalità chiave:
+This library, based on Baileys with specific improvements, offers an intuitive API to interact with WhatsApp Web. Here is a summary of the key features:
 
 <table align="center">
   <tr>
     <td align="center" width="25%">
       <h3>🔄 Core Features</h3>
-      <p>• Mappatura intelligente LID/JID<br>• Supporto multi-dispositivo<br>• Crittografia E2E Signal<br>• TypeScript moderno</p>
+      <p>• Intelligent LID/JID mapping<br>• Multi-device support<br>• E2E Signal encryption<br>• Modern TypeScript</p>
     </td>
     <td align="center" width="25%">
-      <h3>💬 Messaggi</h3>
-      <p>• Testo, media, interattivi<br>• Bottoni, liste, album<br>• Poll, reazioni<br>• Template avanzati</p>
+      <h3>💬 Messages</h3>
+      <p>• Text, media, interactive<br>• Buttons, lists, albums<br>• Polls, reactions<br>• Advanced templates</p>
     </td>
     <td align="center" width="25%">
       <h3>🛠️ Developer</h3>
-      <p>• Eventi real-time<br>• TypeScript completo<br>• Documentazione estesa<br>• API estendibili</p>
+      <p>• Real-time events<br>• Full TypeScript<br>• Extensive documentation<br>• Extensible APIs</p>
     </td>
     <td align="center" width="25%">
       <h3>⚡ Performance</h3>
-      <p>• Riconnessione intelligente<br>• Cache avanzata TTL<br>• Monitoraggio prestazioni</p>
+      <p>• Intelligent reconnection<br>• Advanced TTL cache<br>• Performance monitoring</p>
     </td>
   </tr>
 </table>
@@ -113,16 +113,16 @@ Questa libreria, basata su Baileys con miglioramenti specifici, offre un'API int
 <img src="https://64.media.tumblr.com/13bc9e3c3b332dfc008cb4b9e8571558/2a577b39b15547dc-cc/s400x600/3db051b3117b695a61ad8e0b686f2774b971d210.gifv" width="800">
 
 
-## 🚀 Guida Rapida
+## 🚀 Quick Guide
 
-- Questa sezione include esempi base per l'autenticazione e la gestione delle connessioni.
+- This section includes basic examples for authentication and connection management.
 
-### Esempio Base - Avvio Bot
+### Basic Example - Starting Bot
 
 ```typescript
 import makeWASocket, { DisconnectReason, useMultiFileAuthState, getPerformanceConfig, setPerformanceConfig } from '@realvare/based';
 
-// Configura performance e cache
+// Configure performance and cache
 setPerformanceConfig({
     performance: {
         enableCache: true,
@@ -135,10 +135,10 @@ setPerformanceConfig({
 });
 
 async function startBot() {
-    // 🔐 Setup autenticazione multi-file per sessioni persistenti
+    // 🔐 Multi-file authentication setup for persistent sessions
     const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys');
 
-    // 🌐 Creazione del socket con configurazione base
+    // 🌐 Socket creation with basic configuration
     const sock = makeWASocket({
         auth: state,
         printQRInTerminal: true,
@@ -146,7 +146,7 @@ async function startBot() {
         browser: ['VareBot', 'Chrome', '4.0.0'],
     });
 
-    // Sistema di riconnessione migliorato
+    // Improved reconnection system
     let reconnectAttempts = 0;
     const config = getPerformanceConfig();
 
@@ -166,16 +166,16 @@ async function startBot() {
                     config.performance.maxRetryDelay
                 );
 
-                console.log(`🔄 Tentativo di riconnessione ${reconnectAttempts}/${config.performance.maxRetries} tra ${delay}ms`);
+                console.log(`🔄 Reconnection attempt ${reconnectAttempts}/${config.performance.maxRetries} in ${delay}ms`);
 
                 if (reconnectAttempts <= config.performance.maxRetries) {
                     setTimeout(startBot, delay);
                 } else {
-                    console.log('❌ Numero massimo di tentativi di riconnessione raggiunto');
+                    console.log('❌ Maximum number of reconnection attempts reached');
                 }
             }
         } else if (connection === 'open') {
-            console.log('🟢 Connesso con successo!');
+            console.log('🟢 Connected successfully!');
             reconnectAttempts = 0;
         }
     });
@@ -184,22 +184,22 @@ async function startBot() {
 }startBot().catch(console.error);
 ```
 
-### Esempio Anti-Ban - Configurazione consigliata per Evitare Ban
+### Anti-Ban Example - Recommended Configuration to Avoid Bans
 
 ```typescript
 import makeWASocket, { DisconnectReason, useMultiFileAuthState, getPerformanceConfig, setPerformanceConfig, getSenderLid, validateJid } from '@realvare/based';
 
-// Configurazione anti-ban per ridurre rischi ban da acks impropri
+// Anti-ban configuration to reduce ban risks from improper acks
 setPerformanceConfig({
     performance: {
-        enableCache: true,          // Abilita cache TTL per ridurre chiamate API
-        enableMetrics: true,        // Monitora performance per evitare sovraccarico
-        batchSize: 50,              // Elabora messaggi in batch più piccoli per simulare velocità umana
-        maxRetries: 5,              // Limita tentativi retry per evitare comportamento aggressivo
-        retryDelay: 5000,           // Ritardo base in ms per riconnessioni
-        retryBackoffMultiplier: 1.5,// Backoff esponenziale per spaziare retry
-        maxRetryDelay: 60000,       // Ritardo massimo per evitare riconnessioni rapide
-        maxMsgRetryCount: 3         // Limita tentativi rispedizione messaggi
+        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
     }
 });
 
@@ -210,9 +210,9 @@ async function startBot() {
         auth: state,
         printQRInTerminal: true,
         logger: console,
-        browser: ['YourBotName', 'Chrome', '4.0.0'], // Personalizza fingerprint browser
-        markOnlineOnConnect: false, // Cruciale: Previene apparire sempre online, riduce rischio ban
-        syncFullHistory: false      // Evita sync dati non necessari che potrebbero segnalare attività
+        browser: ['YourBotName', 'Chrome', '4.0.0'], // Customize browser fingerprint
+        markOnlineOnConnect: false, // Crucial: Prevents always appearing online, reduces ban risk
+        syncFullHistory: false      // Avoid syncing unnecessary data that could signal activity
     });
 
     let reconnectAttempts = 0;
@@ -248,23 +248,23 @@ async function startBot() {
         }
     });
 
-    // Monitora acks tramite aggiornamenti messaggi per garantire gestione corretta
+    // Monitor acks through message updates to ensure proper handling
     sock.ev.on('messages.update', (updates) => {
         for (const update of updates) {
             if (update.update.status) {
-                console.log(`Message ${update.key.id} status: ${update.update.status}`); // Traccia acks (1=sent, 2=delivered, 3=read)
-                // Aggiungi logica personalizzata se necessaria, ma evita override predefiniti per prevenire detection
+                console.log(`Message ${update.key.id} status: ${update.update.status}`); // Track acks (1=sent, 2=delivered, 3=read)
+                // Add custom logic if necessary, but avoid overriding defaults to prevent detection
             }
         }
     });
 
-    // Utilità LID/JID avanzate per stabilità acks
+    // Advanced LID/JID utilities for ack stability
     sock.ev.on('messages.upsert', ({ messages }) => {
         for (const msg of messages) {
             const info = getSenderLid(msg);
             const validation = validateJid(info.jid);
             if (validation.isValid) {
-                // Elabora e ack in sicurezza
+                // Process and ack safely
                 console.log(`Valid JID: ${info.jid}, LID: ${info.lid}`);
             } else {
                 console.warn(`Invalid JID detected: ${info.jid}`);
@@ -278,58 +278,58 @@ async function startBot() {
 startBot().catch(console.error);
 ```
 
-## 📊 Gestione Avanzata Cache
+## 📊 Advanced Cache Management
 
-La libreria ora include un sistema di cache avanzato con gestione automatica della memoria e TTL configurabile:
+The library now includes an advanced cache system with automatic memory management and configurable TTL:
 
 ```typescript
 import { CacheManager } from 'based/lib/Utils/cache-manager';
 
-// Esempio di utilizzo della cache
+// Example of using the cache
 const cache = CacheManager;
 
-// Salva un valore nella cache
-cache.set('lidCache', 'chiave', 'valore', 300); // TTL di 300 secondi
+// Save a value in the cache
+cache.set('lidCache', 'key', 'value', 300); // TTL of 300 seconds
 
-// Recupera un valore
-const valore = cache.get('lidCache', 'chiave');
+// Retrieve a value
+const value = cache.get('lidCache', 'key');
 
-// Ottieni statistiche della cache
+// Get cache statistics
 const stats = cache.getStats('lidCache');
-console.log('Statistiche cache:', stats);
+console.log('Cache statistics:', stats);
 ```
 
-### Configurazione Cache Avanzata
+### Advanced Cache Configuration
 
-La cache può essere configurata con varie opzioni per ottimizzare le prestazioni:
+The cache can be configured with various options to optimize performance:
 
 ```typescript
 setPerformanceConfig({
     cache: {
         lidCache: {
-            ttl: 5 * 60 * 1000, // Tempo di vita delle entries
-            maxSize: 10000,      // Numero massimo di entries
-            cleanupInterval: 2 * 60 * 1000 // Intervallo pulizia
+            ttl: 5 * 60 * 1000, // Entry lifetime
+            maxSize: 10000,      // Maximum number of entries
+            cleanupInterval: 2 * 60 * 1000 // Cleanup interval
         }
     },
     performance: {
-        memoryThreshold: 0.85 // Soglia per pulizia automatica
+        memoryThreshold: 0.85 // Threshold for automatic cleanup
     }
 });
 ```
-## 🔍 Risoluzione Problemi
+## 🔍 Troubleshooting
 
-### Problemi di Connessione
-- La libreria ora implementa un sistema di retry con backoff esponenziale
-- Monitoraggio automatico dello stato della connessione
-- Tentativi di riconnessione configurabili
+### Connection Issues
+- The library now implements a retry system with exponential backoff
+- Automatic monitoring of connection status
+- Configurable reconnection attempts
 
-### Gestione Memoria
-- Monitoraggio automatico dell'uso della memoria
-- Pulizia cache automatica quando necessario
-- TTL configurabile per ogni tipo di cache
+### Memory Management
+- Automatic monitoring of memory usage
+- Automatic cache cleanup when necessary
+- Configurable TTL for each cache type
 
-### Logging Avanzato
+### Advanced Logging
 ```typescript
 setPerformanceConfig({
     debug: {
@@ -340,37 +340,37 @@ setPerformanceConfig({
 });
 ```
 
-### Gestione Messaggi Base con LID/JID
+### Basic Message Management with LID/JID
 
 ```typescript
 import makeWASocket, { getSenderLid, toJid, getCacheStats, validateJid, Logger } from '@realvare/based';
 
-// ... (codice di creazione sock qui)
+// ... (sock creation code here)
 
 conn.ev.on('messages.upsert', ({ messages }) => {
   for (const msg of messages) {
-    // 🔍 Estrai LID del mittente con validazione
+    // 🔍 Extract sender LID with validation
     const info = getSenderLid(msg);
     
-    // ✅ Valida JID prima di usarlo
+    // ✅ Validate JID before using it
     const validation = validateJid(info.jid);
     if (!validation.isValid) {
-      Logger.error('JID non valido:', validation.error);
+      Logger.error('Invalid JID:', validation.error);
       continue;
     }
     
-    const jid = toJid(info.lid); // Normalizza in JID
+    const jid = toJid(info.lid); // Normalize to JID
     
-    Logger.info('💬 Messaggio da:', jid, 'Valid:', info.isValid);
-    console.log('📝 Contenuto:', msg.message?.conversation);
+    Logger.info('💬 Message from:', jid, 'Valid:', info.isValid);
+    console.log('📝 Content:', msg.message?.conversation);
     
-    // Rispondi automaticamente solo se valido
+    // Automatically reply only if valid
     if (info.isValid) {
-      conn.sendMessage(jid, { text: 'Messaggio ricevuto!' });
+      conn.sendMessage(jid, { text: 'Message received!' });
     }
   }
   
-  // 📊 Monitora performance cache
+  // 📊 Monitor cache performance
   const stats = getCacheStats();
   Logger.performance('Cache stats:', stats);
 });
@@ -378,64 +378,64 @@ conn.ev.on('messages.upsert', ({ messages }) => {
 
 ---
 
-## 📚 Documentazione API
+## 📚 API Documentation
 
-Questa sezione espande i metodi principali, con esempi dettagliati e parametri. Tutti i metodi sono tipizzati in TypeScript per un'esperienza di sviluppo sicura.
+This section expands on the main methods, with detailed examples and parameters. All methods are typed in TypeScript for a safe development experience.
 
-### 🏗️ Metodi Fondamentali
+### 🏗️ Fundamental Methods
 
-| Metodo | Descrizione | Import |
+| Method | Description | 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 |
+| `makeWASocket(config)` | **Core**: Creates WhatsApp socket | ✅ Included |
+| `useMultiFileAuthState(folder)` | **Auth**: Persistent credentials management | ✅ Included |
+| `getSenderLid(msg)` | **LID**: Extracts LID from message | ✅ Included |
+| `toJid(lid)` | **JID**: Converts LID → JID | ✅ Included |
+| `validateJid(jid)` | **Validation**: Verifies JID | ✅ Included |
+| `getCacheStats()` | **Performance**: Cache statistics | ✅ Included |
+| `clearCache()` | **Cleanup**: Clears cache | ✅ Included |
+| `setPerformanceConfig(config)` | **Config**: Customizes performance | ✅ Included |
 
-**🔥 Nota**: Tutti i metodi sopra sono **già pronti all'uso** e mostrati nella Guida Rapida. Passa direttamente alle sezioni avanzate per funzionalità specifiche!
+**🔥 Note**: All the above methods are **ready to use** and shown in the Quick Guide. Go directly to the advanced sections for specific features!
 
 ---
 
-### 🎯 Eventi Principali
+### 🎯 Main Events
 
-| Evento              | Descrizione                          | Callback Signature                  |
+| Event              | Description                          | Callback Signature                  |
 |---------------------|--------------------------------------|-------------------------------------|
-| `connection.update` | Aggiornamenti stato connessione      | `(update: Partial<ConnectionState>) => void` |
-| `creds.update`      | Aggiornamento credenziali            | `() => void`                        |
-| `messages.upsert`   | Nuovi messaggi o aggiornamenti       | `({ messages: WAMessage[], type: MessageUpsertType }) => void` |
-| `messages.update`   | Modifiche a messaggi esistenti       | `(update: WAMessageUpdate[]) => void` |
-| `group-participants.update` | Cambiamenti partecipanti gruppo | `(update: GroupParticipantEvent) => void` |
+| `connection.update` | Connection status updates      | `(update: Partial<ConnectionState>) => void` |
+| `creds.update`      | Credentials update            | `() => void`                        |
+| `messages.upsert`   | New messages or updates       | `({ messages: WAMessage[], type: MessageUpsertType }) => void` |
+| `messages.update`   | Changes to existing messages       | `(update: WAMessageUpdate[]) => void` |
+| `group-participants.update` | Group participant changes | `(update: GroupParticipantEvent) => void` |
 
-**Esempio Registrazione Evento:**
+**Event Registration Example:**
 ```typescript
 conn.ev.on('group-participants.update', (update) => {
-  console.log('Partecipante aggiornato:', update);
+  console.log('Participant updated:', update);
 });
 ```
 
 ---
 
-## 🎪 Messaggi e Funzionalità Interattive
+## 🎪 Messages and Interactive Features
 
-### Messaggi Base
+### Basic Messages
 
-#### Testo con Formattazione
+#### Text with Formatting
 ```typescript
-// Testo con formattazione e menzioni
+// Text with formatting and mentions
 await conn.sendMessage(jid, { 
-    text: `*Bold* _italic_ ~strikethrough~ \`monospace\`\n@menzione`, 
+    text: `*Bold* _italic_ ~strikethrough~ \`monospace\`\n@mention`, 
     mentions: ['393476686131@s.whatsapp.net'] 
 });
 ```
 
-#### Media Base
+#### Basic Media
 ```typescript
-// Immagine
+// Image
 await conn.sendMessage(jid, { 
-    image: { url: './media/varebot.jpg' }, // Supporta anche Buffer
+    image: { url: './media/varebot.jpg' }, // Also supports Buffer
     caption: 'zwag'
 });
 
@@ -443,27 +443,27 @@ await conn.sendMessage(jid, {
 await conn.sendMessage(jid, { 
     video: { url: './media/oppastoppa.mp4' },
     caption: 'brrrr',
-    gifPlayback: false // true per riprodurre come GIF
+    gifPlayback: false // true to play as GIF
 });
 
 // Audio
 await conn.sendMessage(jid, { 
     audio: { url: './media/audio.mp3' },
     mimetype: 'audio/mp4',
-    ptt: true // true per messaggio vocale, false per audio normale
+    ptt: true // true for voice message, false for normal audio
 });
 
-// Documento
+// Document
 await conn.sendMessage(jid, { 
     document: { url: './media/doc.pdf' },
     mimetype: 'application/pdf',
-    fileName: 'documento.pdf'
+    fileName: 'document.pdf'
 });
 ```
 
-#### Media Avanzati
+#### Advanced Media
 ```typescript
-// Album (Multiple immagini)
+// Album (Multiple images)
 await conn.sendMessage(jid, {
     album: imageBuffers.map(buffer => ({ image: buffer })),
     caption: 'ts gettin real'
@@ -474,7 +474,7 @@ await conn.sendMessage(jid, {
     sticker: { url: './stickers/sticker.webp' }
 });
 
-// Messaggio con posizione
+// Location message
 await conn.sendMessage(jid, { 
     location: { 
         degreesLatitude: 45.4642, 
@@ -485,68 +485,68 @@ await conn.sendMessage(jid, {
 });
 ```
 
-#### Messaggi Interattivi
-Questi messaggi includono elementi interattivi come bottoni, liste e template.
+#### Interactive Messages
+These messages include interactive elements like buttons, lists, and templates.
 
-##### Messaggi con Bottoni Semplici
-Invia bottoni di risposta rapida.
+##### Messages with Simple Buttons
+Send quick reply buttons.
 
 ```typescript
 await conn.sendMessage(jid, {
-  text: 'Scegli un\'opzione:',
+  text: 'Choose an option:',
   footer: 'Footer',
   buttons: [
-    { buttonId: 'cmd1', buttonText: { displayText: 'testo1' }, type: 1 },
-    { buttonId: 'cmd2', buttonText: { displayText: 'testo2' }, type: 1 },
+    { buttonId: 'cmd1', buttonText: { displayText: 'text1' }, type: 1 },
+    { buttonId: 'cmd2', buttonText: { displayText: 'text2' }, type: 1 },
   ],
   headerType: 1,
 });
 ```
 
-##### Messaggi con Bottoni e Immagine
-Combina immagine con bottoni.
+##### Messages with Buttons and Image
+Combine image with buttons.
 
 ```typescript
 await conn.sendMessage(jid, {
   image: { url: 'https://i.ibb.co/hJW7WwxV/varebot.jpg' },
-  caption: 'Messaggio con bottoni e immagine',
+  caption: 'Message with buttons and image',
   footer: 'vare ✧ bot',
   buttons: [
-    { buttonId: 'cmd', buttonText: { displayText: 'testo1' }, type: 1 },
+    { buttonId: 'cmd', buttonText: { displayText: 'text1' }, type: 1 },
   ],
 });
 ```
 
-##### Messaggi Liste
-Invia una lista di opzioni (solo in privato).
+##### List Messages
+Send a list of options (only in private).
 
 ```typescript
 await conn.sendMessage(jid, {
-  text: 'Questa è una lista!',
+  text: 'This is a list!',
   footer: 'purplepurplepurple!',
-  title: 'Titolo Lista',
-  buttonText: 'Visualizza Lista',
+  title: 'List Title',
+  buttonText: 'View List',
   sections: [
     { 
-      title: 'Sezione 1', 
+      title: 'Section 1', 
       rows: [ 
-        { title: 'Opzione 1', rowId: 'opt1',description: 'Descrizionex' }, 
-        { title: 'Opzione 2', rowId: 'opt2', description: 'Descrizioney' } 
+        { title: 'Option 1', rowId: 'opt1',description: 'Descriptionx' }, 
+        { title: 'Option 2', rowId: 'opt2', description: 'Descriptiony' } 
       ] 
     },
   ],
 });
 ```
 
-#### Altri Messaggi
+#### Other Messages
 ```typescript
-// Messaggio con citazione
+// Message with quote
 await conn.sendMessage(jid, { 
     text: 'bang bang',
-    quoted: quotedMessage // Il messaggio da quotare/rispondere/citare
+    quoted: quotedMessage // The message to quote/reply/cite
 });
 
-// Messaggi Contatto
+// Contact Messages
 await conn.sendMessage(jid, { 
   contacts: { 
     displayName: 'Sam aka vare', 
@@ -554,23 +554,23 @@ await conn.sendMessage(jid, {
   } 
 });
 
-// Messaggi Poll (Sondaggio)
+// Poll Messages (Survey)
 await conn.sendMessage(jid, { 
   poll: { 
-    name: 'Anime preferito?', 
+    name: 'Favorite Anime?', 
     values: ['Aot', 'Bleach', 'Death note'], 
-    selectableCount: 1 // quante scelte possibili
+    selectableCount: 1 // how many choices possible
   } 
 });
 
-// Messaggi Ephemeral (Che si Autodistruggono)
+// Ephemeral Messages (Self-Destructing)
 await conn.sendMessage(jid, { 
-  text: "Questo messaggio si autodistruggerà {speriamo come israele}"
+  text: "This message will self-destruct {hopefully like israel}"
 }, {
   ephemeralExpiration: 7 * 24 * 60 * 60
 });
 
-// Messaggi con Risposta a Visualizzazione
+// Messages with View Once Response
 await conn.sendMessage(
     jid,
     {
@@ -580,27 +580,27 @@ await conn.sendMessage(
     }
 )
 
-// Messaggi di Status (Stato)
+// Status Messages
 await conn.sendMessage('status@broadcast', {
     text: 'god forgive em'
 }, {
-    statusJidList: contatti
+    statusJidList: contacts
 });
 
-// Invia uno stato con media (visibile solo a contatti selezionati)
+// Send a status with media (visible only to selected contacts)
 await conn.sendMessage('status@broadcast', {
     image: { url: './media/menu/menu.jpg' },
     caption: 'all i need in this life of sin is-',
     }, {
-    statusJidList: contatti
+    statusJidList: contacts
 });
 
-// Messaggi Newsletter
+// Newsletter Messages
 await conn.sendMessage('120363418582531215@newsletter', {
     text: 'ay yo',
     });
 
-// Messaggi di Pagamento
+// Payment Messages
 await conn.sendMessage(jid, {
     requestPayment: {
         currency: 'EUR',
@@ -610,7 +610,7 @@ await conn.sendMessage(jid, {
     }
 });
 
-// Messaggi di Chiamata
+// Call Messages
 await conn.sendMessage(jid, {
     call: {
         callKey: {
@@ -622,7 +622,7 @@ await conn.sendMessage(jid, {
     }
 });
 
-// Messaggi con Live Location
+// Live Location Messages
 await conn.sendMessage(jid, {
     liveLocation: {
         degreesLatitude: 45.4642,
@@ -636,11 +636,11 @@ await conn.sendMessage(jid, {
     }
 });
 
-// Messaggi di Ordini/Prodotti
+// Order/Product Messages
 await conn.sendMessage(jid, {
     order: {
         id: 'bysamakavare',
-        thumbnail: buffer, // immagine buffer
+        thumbnail: buffer, // image buffer
         itemCount: 67,
         surface: 'CATALOG',
         title: 'heh',
@@ -651,12 +651,12 @@ await conn.sendMessage(jid, {
     }
 });
 
-// Prodotto
+// Product
 await conn.sendMessage(jid, {
     product: {
         productImage: { url: './media/menu/menu.jpg' },
         productId: 'prod123',
-        title: 'titolo',
+        title: 'title',
         description: 'Desc',
         currency: 'EUR',
         priceAmount1000: 67000,
@@ -666,97 +666,97 @@ await conn.sendMessage(jid, {
     businessOwnerJid: m.sender
 });
 
- // Messaggi con Intestazione Personalizzata
+ // Messages with Custom Header
 await conn.sendMessage(jid, {
     text: 'dilemma',
             contextInfo: {
                 externalAdReply: {
-                    title: `titolo`,
+                    title: `title`,
                     body: `desc`,
-                    thumbnailUrl: 'https://i.ibb.co/hJW7WwxV/sam.jpg', // immagine
-                    sourceUrl: '', // sconsiglio di metterla
+                    thumbnailUrl: 'https://i.ibb.co/hJW7WwxV/sam.jpg', // image
+                    sourceUrl: '', // not recommended to set
                     mediaType: 1,
                     renderLargerThumbnail: false
                 }
             }
 });
->  nota: non usate showAdAttribution o tenetela in false, poiche con essa attiva non viene visualizzato il messaggio
+>  note: do not use showAdAttribution or keep it false, because with it active the message is not displayed
 ```
 
-### Gestione delle Risposte
+### Response Management
 
-Per gestire le risposte ai messaggi interattivi, usa il listener `messages.upsert` e controlla il tipo di risposta:
+To manage responses to interactive messages, use the `messages.upsert` listener and check the response type:
 
 ```typescript
 conn.ev.on('messages.upsert', async ({ messages }) => {
     const msg = messages[0];
     
-    // Risposta a bottoni
+    // Button response
     if (msg.message?.buttonsResponseMessage) {
         const selectedId = msg.message.buttonsResponseMessage.selectedButtonId;
-        console.log(`Bottone selezionato: ${selectedId}`);
+        console.log(`Selected button: ${selectedId}`);
     }
     
-    // Risposta a liste
+    // List response
     if (msg.message?.listResponseMessage) {
         const selectedId = msg.message.listResponseMessage.singleSelectReply.selectedRowId;
-        console.log(`Opzione selezionata: ${selectedId}`);
+        console.log(`Selected option: ${selectedId}`);
     }
     
-    // Risposta a sondaggio
+    // Poll response
     if (msg.message?.pollResponseMessage) {
         const selectedOptions = msg.message.pollResponseMessage.selectedOptions;
-        console.log('Opzioni selezionate:', selectedOptions);
+        console.log('Selected options:', selectedOptions);
     }
 });
 ```
 
-### 🎭 Funzionalità Gruppi
+### 🎭 Group Features
 
-#### Gestione Base Gruppi
+#### Basic Group Management
 
 ```typescript
-// Creazione gruppo - il jid sta per l'aggiunta di partecipanti
+// Group creation - the jid is for adding participants
 const group = await conn.groupCreate('Angels 🩸🕊️', ['user@s.whatsapp.net']);
 
-// Ottenere info gruppo
+// Get group info
 const metadata = await conn.groupMetadata(jid);
 
-// Ottenere codice invito
+// Get invite code
 const code = await conn.groupInviteCode(jid);
 
-// Revocare link invito
+// Revoke invite link
 await conn.groupRevokeInvite(jid);
 
-// Lasciare gruppo
+// Leave group
 await conn.groupLeave(jid);
 ```
 
-#### Gestione Partecipanti
+#### Participant Management
 
 ```typescript
-// Aggiungere partecipanti
+// Add participants
 await conn.groupParticipantsUpdate(
     jid, 
     ['user@s.whatsapp.net'],
     'add'
 );
 
-// Rimuovere partecipanti
+// Remove participants
 await conn.groupParticipantsUpdate(
     jid,
     ['user@s.whatsapp.net'],
     'remove'
 );
 
-// Promuovere ad admin
+// Promote to admin
 await conn.groupParticipantsUpdate(
     jid,
     ['user@s.whatsapp.net'],
     'promote'
 );
 
-// Degradare da admin
+// Demote from admin
 await conn.groupParticipantsUpdate(
     jid,
     ['user@s.whatsapp.net'],
@@ -764,76 +764,76 @@ await conn.groupParticipantsUpdate(
 );
 ```
 
-#### Impostazioni Gruppo
+#### Group Settings
 
 ```typescript
-// Modificare nome gruppo
-await conn.groupUpdateSubject(jid, 'Nuovo Nome');
+// Change group name
+await conn.groupUpdateSubject(jid, 'New Name');
 
-// Modificare descrizione
-await conn.groupUpdateDescription(jid, 'Nuova descrizione');
+// Change description
+await conn.groupUpdateDescription(jid, 'New description');
 
-// Modificare foto gruppo
+// Change group photo
 await conn.updateProfilePicture(jid, { url: './img/group.jpg' });
 
-// Rimuovere foto gruppo
+// Remove group photo
 await conn.removeProfilePicture(jid);
 
-// Impostare gruppo come solo admin
+// Set group as admin only
 await conn.groupSettingUpdate(jid, 'announcement');
 
-// Impostare gruppo come aperto a tutti
+// Set group as open to all
 await conn.groupSettingUpdate(jid, 'not_announcement');
 
-// Impostare chi può modificare le info - solo admin
+// Set who can edit info - admin only
 await conn.groupSettingUpdate(jid, 'locked');
 
-// Impostare chi può modificare le info - tutti
+// Set who can edit info - all
 await conn.groupSettingUpdate(jid, 'unlocked');
 
-// Impostare chi può aggiungere membri - solo admin
+// Set who can add members - admin only
 await conn.groupMemberAddMode(jid, 'admin_add');
 
-// Impostare chi può aggiungere membri - tutti
+// Set who can add members - all
 await conn.groupMemberAddMode(jid, 'all_member_add');
 
-// Attivare/disattivare messaggi temporanei (24 ore)
-await conn.groupToggleEphemeral(jid, 86400); // secondi
+// Enable/disable temporary messages (24 hours)
+await conn.groupToggleEphemeral(jid, 86400); // seconds
 
-// Disattivare messaggi temporanei
+// Disable temporary messages
 await conn.groupToggleEphemeral(jid, 0);
 
-// Attivare/disattivare modalità approvazione adesioni
-await conn.groupJoinApprovalMode(jid, 'on'); // richiede approvazione
-await conn.groupJoinApprovalMode(jid, 'off'); // aperta
+// Enable/disable membership approval mode
+await conn.groupJoinApprovalMode(jid, 'on'); // requires approval
+await conn.groupJoinApprovalMode(jid, 'off'); // open
 
-// Ottenere tutti i gruppi
+// Get all groups
 const groups = await conn.groupFetchAllParticipating();
 
-// Ottenere inviti pendenti
+// Get pending invites
 const invites = await conn.groupGetInviteInfo(code);
 
-// Accettare invito gruppo
+// Accept group invite
 await conn.groupAcceptInvite(code);
 
-// Ottenere info gruppo da link
+// Get group info from link
 const groupInfo = await conn.groupGetInviteInfo('https://chat.whatsapp.com/ABC123');
 
-// Ascolta modifiche impostazioni
+// Listen to settings changes
 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'}` });
+        await conn.sendMessage(id, { text: `The group has been set to ${announce ? 'admin only' : 'all'}` });
     }
     if (restrict !== undefined) {
-        await conn.sendMessage(id, { text: `Le info gruppo possono essere modificate da ${restrict ? 'solo admin' : 'tutti'}` });
+        await conn.sendMessage(id, { text: `Group info can be edited by ${restrict ? 'admin only' : 'all'}` });
     }
 });
 ```
 
-#### Messaggi Gruppo Avanzati
+#### Advanced Group Messages
 
 ```typescript
-// Messaggio con menzione multipla
+// Message with multiple mentions
 await conn.sendMessage(jid, {
     text: '@user1 @user2 @user3',
     mentions: [user1, user2, user3],
@@ -842,7 +842,7 @@ await conn.sendMessage(jid, {
     }
 });
 
-// Messaggio con ricerca google
+// Message with Google search
 await conn.sendMessage(jid, {
     text: 'ZWAG',
     contextInfo: {
@@ -854,18 +854,18 @@ await conn.sendMessage(jid, {
 
 ---
 
-## 🔧 Fix LID/JID nel Proprio Main e Handler
+## 🔧 Fix LID/JID in Your Own Main and Handler
 
-*Il supporto LID/JID è un punto di forza di questa libreria, risolvendo problemi comuni come l'identificazione mittenti in gruppi e chat privata. Ecco come integrarlo nel tuo codice principale e handler.*
+*The LID/JID support is a strength of this library, solving common problems like sender identification in groups and private chats. Here's how to integrate it into your main code and handler.*
 
-### Best Practices per LID/JID
+### Best Practices for LID/JID
 
-- **decodeJid(jid)**: Funzione principale per normalizzare JID/LID. Gestisce:
-  - Formati con `:\d+@` (usa `jidNormalizedUser`).
-  - Decodifica user/server in `${user}@${server}`.
-  - Converti `@lid` in `@s.whatsapp.net`.
+- **decodeJid(jid)**: Main function to normalize JID/LID. Handles:
+  - Formats with `:\d+@` (uses `jidNormalizedUser`).
+  - Decodes user/server into `${user}@${server}`.
+  - Converts `@lid` to `@s.whatsapp.net`.
   
-  **Esempio di Implementazione (da main.js):**
+  **Implementation Example (from main.js):**
   ```typescript
   decodeJid: (jid) => {
       if (!jid) return jid;
@@ -882,11 +882,11 @@ await conn.sendMessage(jid, {
       return decoded;
   },
   ```
-  Usa `conn.decodeJid(jid)` ovunque per normalizzare IDs (es. sender, participant, quoted).
+  Use `conn.decodeJid(jid)` everywhere to normalize IDs (e.g., sender, participant, quoted).
 
-- **Monkey-Patch per groupParticipantsUpdate**: Corregge aggiornamenti partecipanti gruppo trovando il JID reale dal metadata.
+- **Monkey-Patch for groupParticipantsUpdate**: Fixes group participant updates by finding the real JID from metadata.
   
-  **Esempio (da handler.js):**
+  **Example (from handler.js):**
   ```typescript
   if (!this.originalGroupParticipantsUpdate) {
       this.originalGroupParticipantsUpdate = this.groupParticipantsUpdate;
@@ -898,7 +898,7 @@ await conn.sendMessage(jid, {
                   if (metadata) global.groupCache.set(chatId, metadata);
               }
               if (!metadata) {
-                  console.error('[ERRORE] Nessun metadato del gruppo disponibile per un aggiornamento sicuro');
+                  console.error('[ERROR] No group metadata available for safe update');
                   return this.originalGroupParticipantsUpdate.call(this, chatId, users, action);
               }
 
@@ -910,25 +910,25 @@ await conn.sendMessage(jid, {
                       const pPhone = pId.split('@')[0].split(':')[0];
                       return pPhone === phone;
                   });
-                  return participant ? participant.id : userJid; // Fallback all'originale se non trovato
+                  return participant ? participant.id : userJid; // Fallback to original if not found
               });
 
               return this.originalGroupParticipantsUpdate.call(this, chatId, correctedUsers, action);
           } catch (e) {
-              console.error('[ERRORE] Errore in safeGroupParticipantsUpdate:', e);
+              console.error('[ERROR] Error in safeGroupParticipantsUpdate:', e);
               throw e;
           }
       };
   }
   ```
 
-- **Cache per Metadata Gruppo**: Usa NodeCache per memorizzare metadata, normalizzando con `decodeJid`.
+- **Cache for Group Metadata**: Use NodeCache to store metadata, normalizing with `decodeJid`.
   
-  **Esempio (da handler.js):**
+  **Example (from handler.js):**
   ```typescript
   global.groupCache = new NodeCache({ stdTTL: 5 * 60, useClones: false });
 
-  // In participantsUpdate o groups.update:
+  // In participantsUpdate or groups.update:
   metadata.participants.forEach(u => {
       const normId = this.decodeJid(u.id);
       const jid = u.jid || normId;
@@ -936,14 +936,14 @@ await conn.sendMessage(jid, {
   global.groupCache.set(update.id, metadata);
   ```
 
-- **Normalizzazione in Print/Log**: Rimuovi `:xx` dai numeri telefono per clean display.
+- **Normalization in Print/Log**: Remove `:xx` from phone numbers for clean display.
   
-  **Esempio (da print.js):**
+  **Example (from print.js):**
   ```typescript
   function formatPhoneNumber(jid, name) {
-      if (!jid) return 'Sconosciuto';
+      if (!jid) return 'Unknown';
       let userPart = jid.split('@')[0];
-      let cleanNumber = userPart.split(':')[0]; // Rimuovi la parte :xx per ottenere il numero reale
+      let cleanNumber = userPart.split(':')[0]; // Remove the :xx part to get the real number
       try {
           const number = PhoneNumber('+' + cleanNumber).getNumber('international');
           return number + (name ? ` ~${name}` : '');
@@ -953,18 +953,18 @@ await conn.sendMessage(jid, {
   }
   ```
 
-- **Problemi Comuni e Fix:**
-  - **LID Mancante in Gruppi:** Usa `decodeJid` e cache metadata per trovare JID reali.
-  - **Conversione JID:** Sempre applica `decodeJid` prima di `sendMessage` o query.
-  - **Multi-Dispositivo:** Imposta `syncFullHistory: true` in config per sync LID.
-  - **Errori in Mention/Quoted:** Normalizza con `decodeJid` in handler per quoted.sender e mentionedJid.
+- **Common Problems and Fixes:**
+  - **Missing LID in Groups:** Use `decodeJid` and metadata cache to find real JIDs.
+  - **JID Conversion:** Always apply `decodeJid` before `sendMessage` or query.
+  - **Multi-Device:** Set `syncFullHistory: true` in config for LID sync.
+  - **Errors in Mention/Quoted:** Normalize with `decodeJid` in handler for quoted.sender and mentionedJid.
 
-### Esempio Integrato in Main
+### Integrated Example in Main
 
 ```typescript
-// Nel tuo file main
+// In your main file
 import makeWASocket, { getSenderLid, toJid } from '@realvare/based';
-// ... (autenticazione e creazione sock)
+// ... (authentication and sock creation)
 
 conn.ev.on('messages.upsert', async ({ messages }) => {
   const msg = messages[0];
@@ -973,14 +973,14 @@ conn.ev.on('messages.upsert', async ({ messages }) => {
   const info = getSenderLid(msg);
   const senderJid = toJid(info.lid); // Fix LID -> JID
 
-  // Esempio: Rispondi solo se JID valido
+  // Example: Reply only if valid JID
   if (senderJid.endsWith('@s.whatsapp.net')) {
-    await conn.sendMessage(senderJid, { text: `Ciao da ${senderJid}!` }, { quoted: msg });
+    await conn.sendMessage(senderJid, { text: `Hello from ${senderJid}!` }, { quoted: msg });
   }
 });
 ```
 
-### Esempio Handler Personalizzato
+### Custom Handler Example
 
 ```typescript
 // handler.js
@@ -988,44 +988,44 @@ export async function handleMessage(sock, msg) {
   const info = getSenderLid(msg);
   const jid = toJid(info.lid);
   
-  // Log e risposta
-  console.log(`Messaggio da ${jid}`);
-  await conn.sendMessage(jid, { text: 'Handler attivato!' });
+  // Log and response
+  console.log(`Message from ${jid}`);
+  await conn.sendMessage(jid, { text: 'Handler activated!' });
 }
 
-// Nel main: conn.ev.on('messages.upsert', ({ messages }) => handleMessage(sock, messages[0]));
+// In main: conn.ev.on('messages.upsert', ({ messages }) => handleMessage(sock, messages[0]));
 ```
 
-**Consiglio:** Testa in gruppi per verificare LID, poiché Baileys upstream ha migliorato il supporto nativo nel 2025, ma i fix personalizzati qui garantiscono retrocompatibilità.
+**Tip:** Test in groups to verify LID, as Baileys upstream has improved native support in 2025, but the custom fixes here ensure backward compatibility.
 
 ---
 
-### 🚀 Cache Intelligente LID/JID
+### 🚀 Smart LID/JID Cache
 
-La libreria ora include un sistema di cache avanzato per ottimizzare le conversioni LID/JID:
+The library now includes an advanced cache system to optimize LID/JID conversions:
 
 ```typescript
 import { getCacheStats, clearCache, setPerformanceConfig } from '@realvare/based';
 
-// Configura cache personalizzata
+// Configure custom cache
 setPerformanceConfig({
     cache: {
         lidCache: {
-            ttl: 10 * 60 * 1000, // 10 minuti
+            ttl: 10 * 60 * 1000, // 10 minutes
             maxSize: 15000
         }
     }
 });
 
-// Monitora performance
+// Monitor performance
 const stats = getCacheStats();
-console.log('Cache LID:', stats.lidCache.size, '/', stats.lidCache.maxSize);
+console.log('LID Cache:', stats.lidCache.size, '/', stats.lidCache.maxSize);
 
-// Pulisci cache se necessario
+// Clear cache if necessary
 clearCache();
 ```
 
-### 🛡️ Validazione JID Avanzata
+### 🛡️ Advanced JID Validation
 
 ```typescript
 import { validateJid, Logger } from '@realvare/based';
@@ -1034,18 +1034,18 @@ const jid = '1234567890@s.whatsapp.net';
 const validation = validateJid(jid);
 
 if (validation.isValid) {
-    Logger.info('JID valido:', jid);
+    Logger.info('Valid JID:', jid);
 } else {
-    Logger.error('JID non valido:', validation.error);
+    Logger.error('Invalid JID:', validation.error);
 }
 ```
 
-### 📊 Logging Condizionale
+### 📊 Conditional Logging
 
 ```typescript
 import { Logger, setPerformanceConfig } from '@realvare/based';
 
-// Configura logging
+// Configure logging
 setPerformanceConfig({
     debug: {
         enableLidLogging: true,
@@ -1054,18 +1054,18 @@ setPerformanceConfig({
     }
 });
 
-// Usa logger condizionale
+// Use conditional logger
 Logger.debug('Debug info');
 Logger.performance('Performance metrics');
 Logger.error('Error occurred');
 ```
 
-### 🔧 Configurazione Performance
+### 🔧 Performance Configuration
 
 ```typescript
 import { setPerformanceConfig, getPerformanceConfig } from '@realvare/based';
 
-// Configurazione completa
+// Complete configuration
 setPerformanceConfig({
     performance: {
         enableCache: true,
@@ -1083,122 +1083,122 @@ setPerformanceConfig({
     }
 });
 
-// Ottieni configurazione corrente
+// Get current configuration
 const config = getPerformanceConfig();
-console.log('Cache abilitata:', config.performance.enableCache);
+console.log('Cache enabled:', config.performance.enableCache);
 ```
 
 ---
 
-## 🧩 Eventi: LID e JID sempre disponibili (nuovo)
+## 🧩 Events: LID and JID always available (new)
 
-Gli eventi emessi includono campi ausiliari sui messaggi per accedere facilmente sia al JID sia al LID del mittente/partecipante.
+The emitted events include auxiliary fields on messages to easily access both the sender/participant's JID and LID.
 
 ```typescript
 conn.ev.on('messages.upsert', ({ messages, type }) => {
   for (const msg of messages) {
-    // Campi aggiuntivi su msg.key
-    // - remoteJidNormalized: JID normalizzato (es. @s.whatsapp.net)
-    // - remoteLid: LID equivalente del remoteJid
-    // - participantLid: LID equivalente del participant (se presente)
+    // Additional fields on msg.key
+    // - remoteJidNormalized: Normalized JID (e.g., @s.whatsapp.net)
+    // - remoteLid: LID equivalent of remoteJid
+    // - participantLid: LID equivalent of participant (if present)
     const jid = msg.key.remoteJidNormalized || msg.key.remoteJid;
     const remoteLid = msg.key.remoteLid;
     const participantLid = msg.key.participantLid;
 
     if (jid?.endsWith('@s.whatsapp.net')) {
-      conn.sendMessage(jid, { text: `Ciao! LID: ${remoteLid || 'n/d'}` });
+      conn.sendMessage(jid, { text: `Hello! LID: ${remoteLid || 'n/a'}` });
     }
   }
 });
 ```
 
-Questi campi eliminano ambiguità in gruppi e contesti multi-dispositivo dove alcuni eventi riportano LID, altri JID.
+These fields eliminate ambiguity in groups and multi-device contexts where some events report LID, others JID.
 
 ---
 
-## ⚙️ Configurazione Avanzata
+## ⚙️ Advanced Configuration
 
-Personalizza il socket per performance e comportamento.
+Customize the socket for performance and behavior.
 
-### 🔧 Opzioni Complete per makeWASocket
+### 🔧 Complete Options for makeWASocket
 
 ```typescript
 const sock = makeWASocket({
-  // 🔐 Autenticazione
+  // 🔐 Authentication
   auth: state,
   
-  // 🖥️ UI e Debug
+  // 🖥️ UI and Debug
   printQRInTerminal: true,
   logger: console,
   browser: ['VareBot', 'Chrome', '4.0.0'],
   
-  // ⏱️ Timeout e Connessione
+  // ⏱️ Timeout and Connection
   defaultQueryTimeoutMs: 60000,
   keepAliveIntervalMs: 30000,
   connectTimeoutMs: 60000,
   retryRequestDelayMs: 250,
   maxMsgRetryCount: 5,
   
-  // 🎛️ Comportamento
+  // 🎛️ Behavior
   markOnlineOnConnect: true,
-  syncFullHistory: false, // Attiva per sync completo (consuma dati)
+  syncFullHistory: false, // Enable for full sync (consumes data)
   fireInitQueries: true,
   generateHighQualityLinkPreview: true,
 });
 ```
 <div align="center">
 
-### 🛡️ Sicurezza e Crittografia
+### 🛡️ Security and Encryption
 
-| Caratteristica            | Descrizione                              |
+| Feature            | Description                              |
 |---------------------------|------------------------------------------|
-| 🔐 End-to-End Encryption | Protocollo Signal per messaggi sicuri    |
-| 🔑 Key Management        | Generazione/rotazione automatica chiavi  |
-| 🔍 Authentication        | Sicurezza tramite QR code o pairing code |
-| 🛡️ Data Protection       | Archiviazione sicura credenziali locali  |
+| 🔐 End-to-End Encryption | Signal protocol for secure messages    |
+| 🔑 Key Management        | Automatic key generation/rotation  |
+| 🔍 Authentication        | Security via QR code or pairing code |
+| 🛡️ Data Protection       | Secure local credentials storage  |
 
 ---
 
-## 🌐 Supporto e Community
+## 🌐 Support and Community
 
-Unisciti alla community per aiuto e contributi.
+Join the community for help and contributions.
 
-### 📞 Contatti e Risorse
+### 📞 Contacts and Resources
 
-| Canale           | Link/Info                                |
+| Channel           | Link/Info                                |
 |------------------|------------------------------------------|
 | **Email**        | [samakavare1@gmail.com](mailto:samakavare1@gmail.com) |
-| **GitHub Issues**| [Segnala Bug](https://github.com/realvare/based/issues) |
-| **PayPal**       | [Dona](https://www.paypal.me/samakavare) |
-| **Canale whatsapp**| [Canale](https://www.whatsapp.com/channel/0029VbB41Sa1Hsq1JhsC1Z1z) |
+| **GitHub Issues**| [Report Bug](https://github.com/realvare/based/issues) |
+| **PayPal**       | [Donate](https://www.paypal.me/samakavare) |
+| **WhatsApp Channel**| [Channel](https://www.whatsapp.com/channel/0029VbB41Sa1Hsq1JhsC1Z1z) |
 
 ---
 
-## 🙏 Ringraziamenti
+## 🙏 Acknowledgments
 
-Grazie ai progetti che ispirano Based:
+Thanks to the projects that inspire Based:
 
-| Progetto                  | Contributo                               |
+| Project                  | Contribution                               |
 |---------------------------|------------------------------------------|
-| [Baileys](https://github.com/WhiskeySockets/Baileys) | API WhatsApp Web originale               |
-| [Yupra](https://www.npmjs.com/package/@yupra/baileys) | Fix LID/JID                     |
-| [Signal Protocol](https://signal.org/) | Crittografia end-to-end                  |
+| [Baileys](https://github.com/WhiskeySockets/Baileys) | Original WhatsApp Web API               |
+| [Yupra](https://www.npmjs.com/package/@yupra/baileys) | LID/JID Fix                     |
+| [Signal Protocol](https://signal.org/) | End-to-end encryption                  |
 
 ---
 
-## ⚠️ Disclaimer & Licenza
+## ⚠️ Disclaimer & License
 
-### 📋 Nota Legale
+### 📋 Legal Note
 
-⚠️ **Importante**: Non affiliato a WhatsApp Inc. o Meta. Uso educativo/sviluppo solo.
+⚠️ **Important**: Not affiliated with WhatsApp Inc. or Meta. Educational/development use only.
 
-🛡️ **Uso Responsabile**: Evita spam, violazioni ToS WhatsApp. Rischio ban account.
+🛡️ **Responsible Use**: Avoid spam, WhatsApp ToS violations. Risk of account ban.
 
-### 📜 Licenza MIT
+### 📜 MIT License
 
 MIT License © 2025 [realvare](https://github.com/realvare)
 
-Vedi [LICENSE](LICENSE) per dettagli.
+See [LICENSE](LICENSE) for details.
 
 ---
 
@@ -1208,7 +1208,7 @@ Vedi [LICENSE](LICENSE) per dettagli.
     <td align="center">
       <img src="https://i.ibb.co/Cp0SQznC/sam2.png" width="120" height="120" alt="pfp" style="bysamakavare"/>
       <br><br>
-      <h2>👨‍💻 Creato da <a href="https://github.com/realvare" style="color: #8a2be2; text-decoration: none;">realvare</a></h2>
+      <h2>👨‍💻 Created by <a href="https://github.com/realvare" style="color: #8a2be2; text-decoration: none;">realvare</a></h2>
       <p><em>sam aka vare</em></p>
     </td>
   </tr>
@@ -1217,13 +1217,13 @@ Vedi [LICENSE](LICENSE) per dettagli.
 <br>
 <p align="center">
   <a href="https://github.com/realvare/based">
-    <img src="https://img.shields.io/badge/⭐_Stella_il_Progetto-8a2be2?style=for-the-badge&logo=github&logoColor=white&labelColor=2d1b69"/>
+    <img src="https://img.shields.io/badge/⭐_Star_the_Project-8a2be2?style=for-the-badge&logo=github&logoColor=white&labelColor=2d1b69"/>
   </a>&nbsp;&nbsp;
   <a href="https://github.com/realvare/based/fork">
     <img src="https://img.shields.io/badge/🔄_Fork_Repository-8a2be2?style=for-the-badge&logo=github&logoColor=white&labelColor=2d1b69"/>
   </a>&nbsp;&nbsp;
   <a href="https://paypal.me/samakavare">
-    <img src="https://img.shields.io/badge/💰_Dona-8a2be2?style=for-the-badge&logo=paypal&logoColor=white&labelColor=2d1b69"/>
+    <img src="https://img.shields.io/badge/💰_Donate-8a2be2?style=for-the-badge&logo=paypal&logoColor=white&labelColor=2d1b69"/>
   </a>
 </p>
 <p align="center">
@@ -1241,7 +1241,7 @@ Vedi [LICENSE](LICENSE) per dettagli.
   </a>
 </p>
 <div align="center">
-  <p><strong>Se ti è stato utile, lascia una stella e/o considera una donazione! ✧</strong></p>
+  <p><strong>If it was useful to you, leave a star and/or consider a donation! ✧</strong></p>
 
 <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"/>