lyxe-baileys 1.0.2 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-  <img src="https://raw.githubusercontent.com/noxXza/data/refs/heads/main/lyxe-baileys.png" width="400" alt="Lyxe Baileys Banner" />
+  <img src="https://i.ibb.co.com/fz44Z9Nz/images.jpg" width="400" alt="Lyxe Baileys Banner" />
   <br><br>
 
   <h1>lyxe-baileys</h1>
@@ -113,6 +113,172 @@ Baru di sini? Ini seluruh library dalam satu pandangan. Tiap baris menaut ke bag
 
 ---
 
+## 🚀 Fitur Eksklusif Lyxe Baileys
+
+### 1. 🛡️ Smart Anti-Ban & Humanizer
+Hindari pemblokiran akun dengan jeda acak manusiawi dan simulasi presence:
+```javascript
+import { smartDelay } from 'lyxe-baileys'
+
+// Jeda acak (misal 1000 - 2500ms)
+await sock.smartDelay(1000, 2500)
+
+// Simulasi mengetik otomatis sebelum pesan terkirim
+await sock.simulateTyping(jid, 2000)
+
+// Atau langsung kirim dengan opsi simulateTyping
+await sock.sendMessage(jid, { text: 'Halo! Ada yang bisa dibantu?' }, { simulateTyping: true })
+```
+
+### 2. 👁️ View-Once & Anti-Delete Retriever
+Bongkar media pesan 1x lihat (foto/video/audio) atau pulihkan pesan yang ditarik:
+```javascript
+// Download pesan View Once secara instan
+const { buffer, mediaType, caption } = await sock.downloadViewOnce(m)
+console.log(`Media ${mediaType} berhasil diunduh! Ukuran: ${buffer.length} bytes`)
+
+// Tangkap pesan yang dihapus pengirim dari store
+const original = sock.extractRevokedMessage(store, revocationMsg)
+if (original) {
+    console.log('Pesan yang ditarik:', original.message)
+}
+```
+
+### 3. 📢 WhatsApp Status / Story Supercharger
+Otomatis baca story, beri reaksi emoji, buat status mention, atau unggah voice note ke story:
+```javascript
+// Otomatis tandai status sudah dibaca dengan jeda alami
+await sock.readStatus(statusMessage, 1500)
+
+// Beri reaksi emoji ke story kontak
+await sock.reactStatus(statusMessage, '❤️')
+
+// Buat status teks/media dengan mention kontak tertentu
+await sock.sendStatusMention('Halo semua!', ['628123456789@s.whatsapp.net'])
+
+// Unggah Voice Note (VN) ke Status WhatsApp
+await sock.sendVoiceStatus(audioBuffer, { backgroundColor: '#7F5AF0' })
+```
+
+### 4. 🎙️ Media & Audio Helpers
+Kirim Voice Note (PTT) asli dengan animasi waveform, stiker, dan media HD:
+```javascript
+// Kirim rekaman suara (Voice Note PTT) lengkap dengan waveform
+await sock.sendVoiceNote(jid, './suara.mp3', quoted)
+
+// Kirim stiker instan
+await sock.sendImageAsSticker(jid, stickerBuffer, quoted)
+
+// Kirim foto/video kualitas HD resmi
+await sock.sendHDMedia(jid, { image: { url: './foto.jpg' }, caption: 'Kualitas HD' })
+```
+
+### 5. 🤖 AI Streaming Message
+Tampilkan pesan bertahap dengan animasi ketik langsung seperti ChatGPT/Gemini di WhatsApp:
+```javascript
+// Mengalirkan teks bertahap (AsyncIterable, generator, array, atau string)
+await sock.streamMessage(jid, aiTextStream, {
+    throttleMs: 350,
+    initialPlaceholder: '⏳ Sedang merangkai jawaban...',
+    quoted: m
+})
+```
+
+### 6. 📱 Multi-Session Manager
+Kelola banyak nomor bot WhatsApp sekaligus dalam satu script:
+```javascript
+import makeWASocket, { LyxeSessionManager, useMultiFileAuthState } from 'lyxe-baileys'
+
+const manager = new LyxeSessionManager({
+    createSocketFn: makeWASocket
+})
+
+// Buat dan jalankan sesi bot 1
+const { state, saveCreds } = await useMultiFileAuthState('./session-bot1')
+const sock1 = await manager.createSession('bot-1', { auth: state })
+
+// Tangkap pesan dari semua sesi sekaligus
+manager.on('messages.upsert', ({ sessionId, upsert, sock }) => {
+    console.log(`Pesan masuk di ${sessionId}`)
+})
+```
+
+### 7. 🛡️ Built-in Proxy & TLS Chrome Spoofer (Anti-Banned Connection Shield)
+Hubungkan bot melalui proxy HTTP, HTTPS, atau SOCKS5 dengan fingerprint TLS Chrome 131+ asli untuk meminimalkan deteksi bot dari server WhatsApp:
+```javascript
+import makeWASocket, { useMultiFileAuthState } from 'lyxe-baileys'
+
+const { state, saveCreds } = await useMultiFileAuthState('./session')
+
+// Mendukung HTTP, HTTPS, atau SOCKS5 Proxy
+const sock = makeWASocket({
+    auth: state,
+    proxy: 'socks5://user:password@127.0.0.1:1080' // atau 'http://proxyhost:8080'
+})
+```
+
+### 8. 🏷️ Bypass Pembatasan Privasi Grup (Privacy 403 Bypass Engine)
+Menambahkan peserta ke grup meskipun nomor target mengunci privasi grup (*Error 403*). Engine otomatis mengambil tiket server resmi dan mengirimkan kartu undangan GroupInviteMessage (V4) 1-klik langsung ke chat pribadinya:
+```javascript
+// Otomatis bypass jika nomor target mengunci privasi grupnya
+const results = await sock.groupAddWithBypass(groupJid, ['6281234567890@s.whatsapp.net'], {
+    caption: 'Undangan resmi bergabung ke grup kami!'
+})
+
+console.log(results)
+// Output: [{ jid: '...', status: '403_bypassed_with_invite', bypassed: true, inviteCode: '...' }]
+```
+
+### 9. 🗄️ Immortal Media & Message Vault (Anti-Delete Otomatis)
+Simpan semua pesan, media (gambar, video, audio, VN), dan pesan View-Once yang masuk secara otomatis ke brankas lokal sebelum sempat ditarik pengirim:
+```javascript
+// Mengambil statistik dari vault
+const stats = sock.vault.getStats()
+console.log(`Vault menyimpan ${stats.totalMessages} pesan dan ${stats.totalMedia} berkas media.`)
+
+// Ambil riwayat chat tertentu dari brankas
+const chatHistory = sock.vault.getMessages('628123456789@s.whatsapp.net', 20)
+```
+
+### 10. 🚀 Built-in Web Cockpit & Live Dashboard
+Pantau status koneksi bot, statistik memori, uptime, kirim pesan uji coba, dan lihat pesan masuk secara live real-time via browser tanpa dependensi tambahan (zero-dependency native HTTP):
+```javascript
+// Nyalakan Web Cockpit Dashboard di port pilihan
+sock.startDashboard(3000)
+// Buka browser Anda: http://localhost:3000
+```
+
+### 11. ✈️ Telegram to WhatsApp Auto-Bridge
+Hubungkan bot Telegram langsung ke WhatsApp! Pesan teks, foto, video, dokumen, dan voice note dari Telegram otomatis diteruskan ke nomor atau grup WhatsApp yang ditentukan:
+```javascript
+const bridge = sock.bridgeTelegram({
+    botToken: '123456789:ABCdefGHIjklMNOpqrSTUvwxYZ',
+    targetWaJid: '120363023123456789@g.us', // JID WhatsApp tujuan
+    allowedTelegramChatIds: ['-1001234567890'], // (Opsional) filter ID Telegram
+    autoDownloadMedia: true
+})
+
+bridge.start()
+```
+
+### 12. 🛰️ Presence & Online Stalker Radar (Stealth Subscriptions)
+Lacak status online / offline target secara diam-diam tanpa perlu membuka obrolan mereka menggunakan stanza presence WhatsApp tingkat rendah:
+```javascript
+// Pantau target secara real-time
+await sock.trackPresence('628123456789@s.whatsapp.net', (presence) => {
+    console.log(`[RADAR] ${presence.jid} sekarang: ${presence.status} pada ${new Date(presence.lastSeen).toLocaleTimeString()}`)
+})
+```
+
+### 13. ⚪ Circular Video Note PTV (WhatsApp Video Bulat)
+Kirim video note berbentuk bulat layaknya pesan video instan di Telegram (Push-To-Video / PTV):
+```javascript
+// Kirim video note bulat instan
+await sock.sendVideoNote(jid, './video.mp4')
+```
+
+---
+
 ## 📚 Daftar Isi
 
 - [Ringkasan](#-ringkasan)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyxe-baileys",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "Custom WhatsApp Multi-Device library by lyxe (forked from luna-baileys by noxXza)",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/Lyxe/ai-stream.js

@@ -0,0 +1,72 @@
+import { delay } from '../Utils/generics.js';
+
+/**
+ * Mengirim pesan dengan efek streaming (seperti animasi mengetik AI ChatGPT/Gemini).
+ * Pesan dikirim sekali lalu di-edit bertahap seiring potongan teks baru tiba.
+ *
+ * @param {any} sock Socket Baileys
+ * @param {string} jid Target chat
+ * @param {AsyncIterable<string>|string[]|Iterable<string>} stream Iterable teks/chunk
+ * @param {object} [options={}] Opsi
+ * @param {number} [options.throttleMs=350] Interval minimum antar edit agar tidak terkena rate-limit WA
+ * @param {string} [options.initialPlaceholder='⏳ Sedang berpikir...'] Teks awal saat proses mulai
+ * @param {any} [options.quoted] Pesan rujukan (quoted message)
+ * @returns {Promise<any>} Objek pesan terakhir yang dikirim
+ */
+export const streamMessage = async (sock, jid, stream, options = {}) => {
+    const throttleMs = options.throttleMs || 350;
+    const placeholder = options.initialPlaceholder || '⏳ Sedang berpikir...';
+
+    // Kirim pesan pertama
+    const sent = await sock.sendMessage(jid, { text: placeholder }, { quoted: options.quoted });
+    if (!sent?.key) return sent;
+
+    let accumulatedText = '';
+    let lastEditTime = Date.now();
+
+    const doEdit = async (text) => {
+        try {
+            await sock.sendMessage(jid, {
+                text: text,
+                edit: sent.key
+            });
+            lastEditTime = Date.now();
+        } catch {
+            // Abaikan error transien saat streaming edit
+        }
+    };
+
+    if (stream && typeof stream[Symbol.asyncIterator] === 'function') {
+        for await (const chunk of stream) {
+            accumulatedText += chunk;
+            const now = Date.now();
+            if (now - lastEditTime >= throttleMs) {
+                await doEdit(accumulatedText);
+            }
+        }
+    } else if (stream && typeof stream[Symbol.iterator] === 'function') {
+        for (const chunk of stream) {
+            accumulatedText += chunk;
+            const now = Date.now();
+            if (now - lastEditTime >= throttleMs) {
+                await doEdit(accumulatedText);
+                await delay(throttleMs);
+            }
+        }
+    } else if (typeof stream === 'string') {
+        // Jika diberikan full string, simulasikan streaming dengan memecah per kata
+        const words = stream.split(' ');
+        for (let i = 0; i < words.length; i += 3) {
+            accumulatedText = words.slice(0, i + 3).join(' ');
+            await doEdit(accumulatedText);
+            await delay(throttleMs);
+        }
+    }
+
+    // Pastikan teks akhir terkirim utuh
+    if (accumulatedText && accumulatedText !== placeholder) {
+        await doEdit(accumulatedText);
+    }
+
+    return sent;
+};

package/src/Lyxe/dashboard.js

@@ -0,0 +1,301 @@
+import http from 'http';
+import os from 'os';
+
+/**
+ * Built-in Web Cockpit & Live Monitor Dashboard (Zero Dependency).
+ * Membuka antarmuka grafis di browser untuk memantau status bot, chat masuk, dan kontrol bot.
+ */
+export class LyxeDashboard {
+    constructor(sock, options = {}) {
+        this.sock = sock;
+        this.port = Number(options.port) || 3000;
+        this.recentMessages = [];
+        this.maxMessages = 40;
+        this.server = null;
+        this.qrCode = null;
+        this.connectionStatus = 'connecting';
+        this.startTime = Date.now();
+
+        this.bindEvents();
+    }
+
+    bindEvents() {
+        if (!this.sock) return;
+
+        this.sock.ev.on('connection.update', (update) => {
+            if (update.qr) {
+                this.qrCode = update.qr;
+            }
+            if (update.connection) {
+                this.connectionStatus = update.connection;
+                if (update.connection === 'open') {
+                    this.qrCode = null;
+                }
+            }
+        });
+
+        this.sock.ev.on('messages.upsert', ({ messages }) => {
+            for (const m of messages) {
+                if (!m.message) continue;
+                const text = m.message.conversation ||
+                             m.message.extendedTextMessage?.text ||
+                             m.message.imageMessage?.caption ||
+                             (m.message.imageMessage ? '[Foto]' : m.message.videoMessage ? '[Video]' : '[Media]');
+                const from = m.key.remoteJid;
+                const sender = m.key.participant || from;
+                this.recentMessages.unshift({
+                    id: m.key.id,
+                    from,
+                    sender: sender ? sender.split('@')[0] : 'Unknown',
+                    fromMe: Boolean(m.key.fromMe),
+                    text,
+                    time: new Date().toLocaleTimeString('id-ID')
+                });
+                if (this.recentMessages.length > this.maxMessages) {
+                    this.recentMessages.pop();
+                }
+            }
+        });
+    }
+
+    start() {
+        if (this.server) return;
+
+        this.server = http.createServer((req, res) => {
+            const url = new URL(req.url, `http://${req.headers.host}`);
+
+            // CORS headers
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204);
+                res.end();
+                return;
+            }
+
+            if (url.pathname === '/api/status') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    status: this.connectionStatus,
+                    user: this.sock?.user || null,
+                    uptime: Math.floor((Date.now() - this.startTime) / 1000),
+                    memory: {
+                        totalMB: Math.round(os.totalmem() / 1024 / 1024),
+                        freeMB: Math.round(os.freemem() / 1024 / 1024),
+                        processMB: Math.round(process.memoryUsage().rss / 1024 / 1024)
+                    },
+                    qrCode: this.qrCode
+                }));
+                return;
+            }
+
+            if (url.pathname === '/api/messages') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(this.recentMessages));
+                return;
+            }
+
+            if (url.pathname === '/api/send' && req.method === 'POST') {
+                let body = '';
+                req.on('data', chunk => body += chunk);
+                req.on('end', async () => {
+                    try {
+                        const { jid, text } = JSON.parse(body);
+                        if (!jid || !text) {
+                            res.writeHead(400, { 'Content-Type': 'application/json' });
+                            return res.end(JSON.stringify({ error: 'JID dan Text wajib diisi' }));
+                        }
+                        const formattedJid = jid.includes('@') ? jid : `${jid.replace(/[^0-9]/g, '')}@s.whatsapp.net`;
+                        const sent = await this.sock.sendMessage(formattedJid, { text });
+                        res.writeHead(200, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ success: true, id: sent?.key?.id }));
+                    } catch (e) {
+                        res.writeHead(500, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ error: e.message }));
+                    }
+                });
+                return;
+            }
+
+            // HTML Frontend Dashboard
+            if (url.pathname === '/' || url.pathname === '/index.html') {
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(this.renderHTML());
+                return;
+            }
+
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not Found');
+        });
+
+        this.server.listen(this.port, () => {
+            console.log(`\n🎛️ [Lyxe Cockpit] Web Dashboard aktif di: http://localhost:${this.port}\n`);
+        });
+    }
+
+    stop() {
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+    }
+
+    renderHTML() {
+        return `<!DOCTYPE html>
+<html lang="id">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Lyxe Baileys - Live Cockpit Dashboard</title>
+  <style>
+    :root {
+      --bg: #0f172a;
+      --card: #1e293b;
+      --border: #334155;
+      --primary: #8b5cf6;
+      --accent: #06b6d4;
+      --text: #f8fafc;
+      --muted: #94a3b8;
+      --green: #10b981;
+      --red: #ef4444;
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; background: var(--bg); color: var(--text); padding: 24px; }
+    .header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 24px; padding-bottom: 16px; border-bottom: 1px solid var(--border); }
+    .header h1 { font-size: 24px; font-weight: 700; background: linear-gradient(135deg, var(--primary), var(--accent)); -webkit-background-clip: text; -webkit-text-fill-color: transparent; }
+    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 16px; margin-bottom: 24px; }
+    .card { background: var(--card); border: 1px solid var(--border); border-radius: 12px; padding: 20px; box-shadow: 0 4px 6px -1px rgba(0,0,0,0.2); }
+    .card h3 { font-size: 14px; text-transform: uppercase; color: var(--muted); margin-bottom: 8px; letter-spacing: 0.5px; }
+    .card .val { font-size: 24px; font-weight: bold; }
+    .badge { display: inline-block; padding: 4px 10px; border-radius: 9999px; font-size: 12px; font-weight: 600; text-transform: uppercase; }
+    .badge-open { background: rgba(16, 185, 129, 0.2); color: var(--green); }
+    .badge-connecting { background: rgba(6, 182, 212, 0.2); color: var(--accent); }
+    .badge-close { background: rgba(239, 68, 68, 0.2); color: var(--red); }
+    .chat-container { display: grid; grid-template-columns: 1fr 340px; gap: 20px; }
+    .chat-box { background: var(--card); border: 1px solid var(--border); border-radius: 12px; padding: 20px; height: 500px; display: flex; flex-direction: column; }
+    .messages-list { flex: 1; overflow-y: auto; padding-right: 8px; }
+    .msg-item { padding: 10px; border-bottom: 1px solid rgba(255,255,255,0.05); font-size: 14px; }
+    .msg-item .meta { display: flex; justify-content: space-between; font-size: 11px; color: var(--muted); margin-bottom: 4px; }
+    .send-box { display: flex; flex-direction: column; gap: 12px; }
+    input, textarea, button { width: 100%; padding: 10px 14px; background: #0f172a; border: 1px solid var(--border); border-radius: 8px; color: #fff; font-size: 14px; }
+    input:focus, textarea:focus { outline: none; border-color: var(--primary); }
+    button { background: var(--primary); color: #fff; font-weight: 600; border: none; cursor: pointer; transition: 0.2s; }
+    button:hover { background: #7c3aed; }
+    @media (max-width: 800px) { .chat-container { grid-template-columns: 1fr; } }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <div>
+      <h1>⚡ LYXE BAILEYS COCKPIT</h1>
+      <p style="color: var(--muted); font-size: 13px;">Realtime Bot Engine & Protocol Telemetry</p>
+    </div>
+    <div id="badge-status" class="badge badge-connecting">Connecting...</div>
+  </div>
+
+  <div class="grid">
+    <div class="card">
+      <h3>Nomor WhatsApp</h3>
+      <div id="val-user" class="val">-</div>
+    </div>
+    <div class="card">
+      <h3>Penggunaan RAM</h3>
+      <div id="val-ram" class="val">-</div>
+    </div>
+    <div class="card">
+      <h3>Uptime Bot</h3>
+      <div id="val-uptime" class="val">-</div>
+    </div>
+  </div>
+
+  <div class="chat-container">
+    <div class="chat-box">
+      <h3 style="margin-bottom: 12px;">📡 LIVE MESSAGE STREAM</h3>
+      <div id="messages-list" class="messages-list">
+        <p style="color: var(--muted); text-align: center; margin-top: 40px;">Menunggu pesan masuk...</p>
+      </div>
+    </div>
+
+    <div class="card send-box">
+      <h3>🚀 TEST SEND MESSAGE</h3>
+      <input id="input-jid" placeholder="Nomor WA (contoh: 628123xxx)" />
+      <textarea id="input-text" rows="5" placeholder="Ketik pesan yang ingin dikirim..."></textarea>
+      <button onclick="sendMessage()">KIRIM PESAN</button>
+      <p id="send-status" style="font-size: 12px; text-align: center; color: var(--muted);"></p>
+    </div>
+  </div>
+
+  <script>
+    async function updateStatus() {
+      try {
+        const res = await fetch('/api/status');
+        const data = await res.json();
+        
+        const badge = document.getElementById('badge-status');
+        badge.innerText = data.status || 'unknown';
+        badge.className = 'badge badge-' + (data.status || 'connecting');
+        
+        document.getElementById('val-user').innerText = data.user?.id ? data.user.id.split('@')[0] : 'Belum Login';
+        document.getElementById('val-ram').innerText = data.memory ? data.memory.processMB + ' MB' : '-';
+        
+        const uptime = data.uptime || 0;
+        const mins = Math.floor(uptime / 60);
+        const secs = uptime % 60;
+        document.getElementById('val-uptime').innerText = mins + 'm ' + secs + 's';
+      } catch (e) {}
+    }
+
+    async function updateMessages() {
+      try {
+        const res = await fetch('/api/messages');
+        const list = await res.json();
+        const container = document.getElementById('messages-list');
+        if (!list || !list.length) return;
+        
+        container.innerHTML = list.map(m => \`
+          <div class="msg-item">
+            <div class="meta">
+              <span>\${m.fromMe ? '🟢 OUT' : '🔵 IN'} • @\${m.sender}</span>
+              <span>\${m.time}</span>
+            </div>
+            <div>\${m.text}</div>
+          </div>
+        \`).join('');
+      } catch (e) {}
+    }
+
+    async function sendMessage() {
+      const jid = document.getElementById('input-jid').value.trim();
+      const text = document.getElementById('input-text').value.trim();
+      const status = document.getElementById('send-status');
+      if (!jid || !text) return alert('Isi nomor dan pesan terlebih dahulu!');
+      status.innerText = 'Mengirim...';
+      try {
+        const res = await fetch('/api/send', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ jid, text })
+        });
+        const data = await res.json();
+        if (data.success) {
+          status.innerText = '✅ Terkirim! ID: ' + data.id;
+          document.getElementById('input-text').value = '';
+        } else {
+          status.innerText = '❌ Gagal: ' + data.error;
+        }
+      } catch (err) {
+        status.innerText = '❌ Error: ' + err.message;
+      }
+    }
+
+    setInterval(updateStatus, 2000);
+    setInterval(updateMessages, 1500);
+    updateStatus();
+    updateMessages();
+  </script>
+</body>
+</html>`;
+    }
+}

package/src/Lyxe/group-bypass.js

@@ -0,0 +1,87 @@
+import { getBinaryNodeChild } from '../WABinary/index.js';
+
+/**
+ * Menambahkan peserta ke grup dengan engine bypass pembatasan privasi (Privacy 403 Bypass).
+ * Jika peserta menyetel privasi grup ke "Kontak Saya" atau "Tidak Ada" (Error 403),
+ * engine otomatis mengambil kode undangan resmi yang ditandatangani server WhatsApp,
+ * lalu mengirim kartu undangan GroupInviteMessage (V4) langsung ke chat pribadi target.
+ *
+ * @param {any} sock Socket Baileys
+ * @param {string} groupJid JID grup tujuan
+ * @param {string[]|string} participants JID nomor yang ingin ditambahkan
+ * @param {object} [options={}] Opsi tambahan
+ * @param {boolean} [options.autoInvite=true] Otomatis kirim kartu undangan jika terblokir privasi 403
+ * @param {string} [options.caption] Teks pengantar undangan
+ * @returns {Promise<Array<{ jid: string, status: string, bypassed: boolean, inviteCode?: string, inviteExpiration?: number }>>}
+ */
+export const groupAddWithBypass = async (sock, groupJid, participants, options = {}) => {
+    const list = Array.isArray(participants) ? participants : [participants];
+    const autoInvite = options.autoInvite !== false;
+
+    // 1. Eksekusi penambahan langsung via WhatsApp protocol
+    const updateResults = await sock.groupParticipantsUpdate(groupJid, list, 'add');
+    const finalResults = [];
+
+    let groupMeta = null;
+    const getMeta = async () => {
+        if (!groupMeta) {
+            try {
+                groupMeta = await sock.groupMetadata(groupJid);
+            } catch {
+                groupMeta = { subject: 'Grup WhatsApp' };
+            }
+        }
+        return groupMeta;
+    };
+
+    for (const res of updateResults) {
+        if (res.status === '403') {
+            // Server WhatsApp menolak add langsung karena privasi target, tapi memberikan add_request token resmi
+            const addRequestNode = getBinaryNodeChild(res.content, 'add_request');
+            const code = addRequestNode?.attrs?.code;
+            const expiration = addRequestNode?.attrs?.expiration;
+
+            if (code && expiration && autoInvite) {
+                try {
+                    const meta = await getMeta();
+                    await sock.sendMessage(res.jid, {
+                        groupInviteMessage: {
+                            groupJid: groupJid,
+                            groupName: meta.subject || 'Grup WhatsApp',
+                            caption: options.caption || `Halo! Kamu diundang bergabung ke grup *${meta.subject || 'Grup'}*. Klik tombol di bawah untuk bergabung langsung.`,
+                            inviteCode: code,
+                            inviteExpiration: Number(expiration)
+                        }
+                    });
+
+                    finalResults.push({
+                        jid: res.jid,
+                        status: '403_bypassed_with_invite',
+                        bypassed: true,
+                        inviteCode: code,
+                        inviteExpiration: Number(expiration)
+                    });
+                    continue;
+                } catch (inviteErr) {
+                    sock.logger?.warn?.({ err: inviteErr }, 'groupAddWithBypass: Gagal mengirim V4 group invite card');
+                }
+            }
+
+            finalResults.push({
+                jid: res.jid,
+                status: '403',
+                bypassed: false,
+                inviteCode: code,
+                inviteExpiration: expiration ? Number(expiration) : undefined
+            });
+        } else {
+            finalResults.push({
+                jid: res.jid,
+                status: res.status || '200',
+                bypassed: res.status === '200'
+            });
+        }
+    }
+
+    return finalResults;
+};