@n4tzz/n4lyx 2.7.10 → 2.7.11

package/README.MD

@@ -1,1295 +1,776 @@
-# <div align='center'>Wileys</div>
+# n4lyx
 
-<div align='center'>
+> WhatsApp Web API — multi-device, TypeScript-first, built different.
 
-[![npm version](https://img.shields.io/npm/v/wileys.svg)](https://www.npmjs.com/package/wileys)
-[![License](https://img.shields.io/badge/license-GPL%203-blue.svg)](LICENSE)
-[![Downloads](https://img.shields.io/npm/dm/wileys.svg)](https://www.npmjs.com/package/wileys)
-
-</div>
-
-## 💝 Donasi
-
-Dukung pengembangan proyek ini:
-
-**Salin and paste di browser :**
-```
-https://cdn.yupra.my.id/yp/eocz6gnv.html
-```
+[![npm](https://img.shields.io/npm/v/@n4tzz/n4lyx?color=black&labelColor=000)](https://npmjs.com/package/@n4tzz/n4lyx)
+[![license](https://img.shields.io/badge/license-MIT-black?labelColor=000)](LICENSE)
+[![downloads](https://img.shields.io/npm/dm/@n4tzz/n4lyx?color=black&labelColor=000)](https://npmjs.com/package/@n4tzz/n4lyx)
+[![node](https://img.shields.io/badge/node-%3E%3D20-black?labelColor=000)](package.json)
 
 ---
 
-## ✨ Fitur Utama
+**n4lyx** is a WhatsApp Web API library built for real projects. Proper `@lid → @pn` resolution, full multi-device support, clean TypeScript API. Fast, minimal, no bloat. Ships with exclusive features like tag-all and group status v2 that upstream doesn't have.
 
-- 🚀 **Modern & Cepat** - Dibangun dengan TypeScript dan teknologi terbaru
-- 🔧 **Perbaikan @lid & @jid** - Mengatasi masalah @lid ke @pn di grup WhatsApp
-- 📱 **Dukungan Multi-Device** - Mendukung koneksi multi-device WhatsApp
-- 🔐 **Enkripsi End-to-End** - Komunikasi terenkripsi penuh
-- 📨 **Semua Jenis Pesan** - Dukung teks, media, polling, dll.
+> Not affiliated with WhatsApp Inc. Don't spam. Don't abuse. You're responsible for how you use this.
 
-## ⚠️ Peringatan
-
-Proyek ini tidak berafiliasi, terkait, diotorisasi, didukung, atau terhubung secara resmi dengan WhatsApp atau anak perusahaannya. Situs resmi WhatsApp ada di whatsapp.com.
-
-Pengelola Wileys tidak mendukung penggunaan aplikasi ini untuk melanggar Ketentuan Layanan WhatsApp. Kami menekankan tanggung jawab pribadi pengguna untuk menggunakan secara adil dan bertanggung jawab.
-
-Gunakan dengan bijak. Hindari spam. Jangan gunakan otomatisasi berlebihan.
-
-## 📦 Instalasi
+---
 
-### Versi Stabil (Direkomendasikan)
+## Install
 
 ```bash
-npm i wileys
+npm i @n4tzz/n4lyx
 ```
 
-### Versi Edge (Fitur Terbaru)
-
-```bash
-npm i wileys@latest
-# atau
-yarn add wileys@latest
+```js
+const { default: makeWASocket } = require('@n4tzz/n4lyx')
+// ESM
+import makeWASocket from '@n4tzz/n4lyx'
 ```
 
-### Impor di Kode
+---
 
-```javascript
-const { default: makeWASocket } = require("wileys")
-// atau ES6
-import makeWASocket from "wileys"
-```
+## Quick Start
 
-## 🚀 Mulai Cepat
+```js
+const {
+  default: makeWASocket,
+  DisconnectReason,
+  useMultiFileAuthState
+} = require('@n4tzz/n4lyx')
+const { Boom } = require('@hapi/boom')
 
-### Contoh Dasar
+async function connect() {
+  const { state, saveCreds } = await useMultiFileAuthState('auth')
+
+  const sock = makeWASocket({
+    auth: state,
+    printQRInTerminal: true,
+    browser: ['n4lyx', 'Desktop', '1.0.0']
+  })
+
+  sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+    if (connection === 'close') {
+      const code = (lastDisconnect?.error as Boom)?.output?.statusCode
+      if (code !== DisconnectReason.loggedOut) connect()
+    } else if (connection === 'open') {
+      console.log('connected')
+    }
+  })
 
-```javascript
-const { default: makeWASocket, DisconnectReason, useMultiFileAuthState } = require('wileys')
-const { Boom } = require('@hapi/boom')
+  sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+      if (!msg.message) continue
+      await sock.sendMessage(msg.key.remoteJid!, { text: 'pong' })
+    }
+  })
 
-async function connectToWhatsApp() {
-    const { state, saveCreds } = await useMultiFileAuthState('auth_info_wileys')
-    
-    const sock = makeWASocket({
-        auth: state,
-        printQRInTerminal: true,
-        browser: ['Wileys', 'Desktop', '3.0']
-    })
-
-    sock.ev.on('connection.update', (update) => {
-        const { connection, lastDisconnect } = update
-        if(connection === 'close') {
-            const shouldReconnect = (lastDisconnect?.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut
-            console.log('Koneksi tertutup karena ', lastDisconnect.error, ', reconnecting ', shouldReconnect)
-            if(shouldReconnect) {
-                connectToWhatsApp()
-            }
-        } else if(connection === 'open') {
-            console.log('✅ Berhasil terhubung ke WhatsApp!')
-        }
-    })
-
-    sock.ev.on('messages.upsert', async ({ messages }) => {
-        for (const m of messages) {
-            if (!m.message) continue
-            
-            console.log('📱 Pesan baru:', JSON.stringify(m, undefined, 2))
-            
-            // Balas otomatis
-            await sock.sendMessage(m.key.remoteJid!, { 
-                text: 'Halo! Saya bot WhatsApp menggunakan Wileys 🤖' 
-            })
-        }
-    })
-
-    sock.ev.on('creds.update', saveCreds)
+  sock.ev.on('creds.update', saveCreds)
 }
 
-connectToWhatsApp()
+connect()
 ```
 
-## 📋 Daftar Isi
-
-Disclaimer : Docs ini masih dalam tahap beta, jadi ada kesalahan atau ketidaksesuaian 
-
-## 🔌 Koneksi Akun
-
-WhatsApp menyediakan API multi-device yang memungkinkan Wileys terautentikasi sebagai klien WhatsApp sekunder melalui QR code atau pairing code.
+---
 
-### Hubungkan dengan QR Code
+## Authentication
 
-> [!TIP]  
-> Sesuaikan nama browser menggunakan konstanta `Browsers`. Lihat konfigurasi yang tersedia di bawah.
+### QR Code
 
-```javascript
-const { default: makeWASocket, Browsers } = require("wileys")
+```js
+const { default: makeWASocket, Browsers } = require('@n4tzz/n4lyx')
 
 const sock = makeWASocket({
-    browser: Browsers.ubuntu('My App'),
-    printQRInTerminal: true
+  browser: Browsers.ubuntu('n4lyx'),
+  printQRInTerminal: true
 })
 ```
 
-Setelah koneksi berhasil, QR code akan muncul di terminal. Pindai dengan WhatsApp di ponsel Anda untuk login.
-
-### Hubungkan dengan Pairing Code
+### Pairing Code
 
-> [!IMPORTANT]  
-> Pairing code bukan bagian dari Mobile API. Ini memungkinkan koneksi WhatsApp Web tanpa QR code, tapi hanya satu perangkat. Lihat [FAQ WhatsApp](https://faq.whatsapp.com/).
+Phone number must include country code — no spaces, no symbols.
 
-Nomor telepon harus tanpa `+`, `()`, atau `-`, dan sertakan kode negara.
+```js
+const sock = makeWASocket({ printQRInTerminal: false })
 
-```javascript
-const { default: makeWASocket } = require("wileys")
-
-const sock = makeWASocket({
-    printQRInTerminal: false
-})
-
-// Pairing Normal
 if (!sock.authState.creds.registered) {
-    const number = '6285134816783'
-    const code = await sock.requestPairingCode(number)
-    console.log('🔑 Kode Pairing:', code)
+  const code = await sock.requestPairingCode('628XXXXXXXXX')
+  console.log('Pairing code:', code)
 }
 
-// Pairing Kustom
+// Custom pairing code (exactly 8 chars)
 if (!sock.authState.creds.registered) {
-    const pair = "YP240125" // 8 karakter
-    const number = '6285134816783'
-    const code = await sock.requestPairingCode(number, pair)
-    console.log('🔑 Kode Pairing Kustom:', code)
+  const code = await sock.requestPairingCode('628XXXXXXXXX', 'N4LYX001')
+  console.log('Pairing code:', code)
 }
 ```
 
-### Terima Riwayat Lengkap
+### Persist Auth
+
+```js
+const { useMultiFileAuthState } = require('@n4tzz/n4lyx')
 
-1. Setel `syncFullHistory` ke `true`.
-2. Secara default, Wileys menggunakan konfigurasi Chrome. Untuk koneksi seperti desktop (untuk riwayat pesan lebih banyak), gunakan:
+const { state, saveCreds } = await useMultiFileAuthState('auth')
+const sock = makeWASocket({ auth: state })
+sock.ev.on('creds.update', saveCreds)
+```
+
+> For production, store credentials in a real database (PostgreSQL, MongoDB, Redis) — not on disk.
 
-```javascript
-const { default: makeWASocket, Browsers } = require("wileys")
+### Full History Sync
 
+```js
 const sock = makeWASocket({
-    browser: Browsers.macOS('Desktop'),
-    syncFullHistory: true
+  browser: Browsers.macOS('Desktop'),
+  syncFullHistory: true
 })
 ```
 
-## ⚙️ Catatan Penting Konfigurasi Socket
+---
 
-### Caching Metadata Grup (Direkomendasikan)
+## Configuration
 
-Untuk penggunaan grup, implementasikan caching metadata grup:
+### Group Metadata Cache
 
-```javascript
-const { default: makeWASocket } = require("wileys")
-const NodeCache = require('node-cache')
+Required for group-heavy bots. Cuts down repeated API calls significantly.
 
+```js
+const NodeCache = require('node-cache')
 const groupCache = new NodeCache({ stdTTL: 5 * 60, useClones: false })
 
 const sock = makeWASocket({
-    cachedGroupMetadata: async (jid) => groupCache.get(jid)
+  cachedGroupMetadata: async (jid) => groupCache.get(jid)
 })
 
 sock.ev.on('groups.update', async ([event]) => {
-    const metadata = await sock.groupMetadata(event.id)
-    groupCache.set(event.id, metadata)
+  groupCache.set(event.id, await sock.groupMetadata(event.id))
 })
 
 sock.ev.on('group-participants.update', async (event) => {
-    const metadata = await sock.groupMetadata(event.id)
-    groupCache.set(event.id, metadata)
-})
-```
-
-### Perbaiki Sistem Retry & Dekripsi Vote Poll
-
-Tingkatkan pengiriman pesan dan dekripsi vote poll dengan store:
-
-```javascript
-const sock = makeWASocket({
-    getMessage: async (key) => await getMessageFromStore(key)
+  groupCache.set(event.id, await sock.groupMetadata(event.id))
 })
 ```
 
-### Terima Notifikasi di Aplikasi WhatsApp
+### Message Store
 
-Nonaktifkan status online untuk menerima notifikasi:
+Needed for message retry and poll vote decryption.
 
-```javascript
+```js
 const sock = makeWASocket({
-    markOnlineOnConnect: false
+  getMessage: async (key) => await getMessageFromStore(key)
 })
 ```
 
-## 💾 Simpan Info Auth
-
-Hindari pemindaian QR code berulang dengan menyimpan kredensial:
-
-```javascript
-const makeWASocket = require("wileys").default
-const { useMultiFileAuthState } = require("wileys")
+### Background Mode
 
-async function connect() {
-    const { state, saveCreds } = await useMultiFileAuthState('auth_info_wileys')
-    const sock = makeWASocket({ auth: state })
-    sock.ev.on('creds.update', saveCreds)
-}
+Disable online status to receive push notifications while "offline".
 
-connect()
-```
-
-> [!IMPORTANT]  
-> `useMultiFileAuthState` menyimpan status auth di folder. Untuk produksi, gunakan database SQL/No-SQL dan kelola update kunci dengan hati-hati.
-
-```javascript
-const sock = makeWASocket()
-sock.ev.on('messages.upsert', ({ messages }) => {
-    console.log('Dapat pesan:', messages)
-})
-```
-
-### Contoh Mulai
-
-```javascript
-const makeWASocket = require("wileys").default
-const { DisconnectReason, useMultiFileAuthState } = require("wileys")
-const { Boom } = require('@hapi/boom')
-
-async function connectToWhatsApp() {
-    const { state, saveCreds } = await useMultiFileAuthState('auth_info_wileys')
-    const sock = makeWASocket({
-        auth: state,
-        printQRInTerminal: true
-    })
-
-    sock.ev.on('connection.update', (update) => {
-        const { connection, lastDisconnect } = update
-        if(connection === 'close') {
-            const shouldReconnect = (lastDisconnect.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut
-            console.log('Koneksi tertutup karena ', lastDisconnect.error, ', reconnecting ', shouldReconnect)
-            if(shouldReconnect) {
-                connectToWhatsApp()
-            }
-        } else if(connection === 'open') {
-            console.log('Koneksi terbuka')
-        }
-    })
-
-    sock.ev.on('messages.upsert', async ({ messages }) => {
-        for (const m of messages) {
-            console.log(JSON.stringify(m, undefined, 2))
-            console.log('Balas ke', m.key.remoteJid)
-            await sock.sendMessage(m.key.remoteJid!, { text: 'Halo Dunia' })
-        }
-    })
-
-    sock.ev.on('creds.update', saveCreds)
-}
-
-connectToWhatsApp()
-```
-
-### Dekripsi Vote Poll
-
-Secara default, vote poll terenkripsi dan ditangani di `messages.update`:
-
-```javascript
-sock.ev.on('messages.update', event => {
-    for(const { key, update } of event) {
-        if(update.pollUpdates) {
-            const pollCreation = await getMessage(key)
-            if(pollCreation) {
-                console.log(
-                    'update poll diterima, agregasi: ',
-                    getAggregateVotesInPollMessage({
-                        message: pollCreation,
-                        pollUpdates: update.pollUpdates,
-                    })
-                )
-            }
-        }
-    }
-})
+```js
+const sock = makeWASocket({ markOnlineOnConnect: false })
 ```
 
-`getMessage` adalah implementasi store (di pihak Anda).
-
-### Ringkasan Event Koneksi Pertama
-
-1. Saat koneksi pertama, `connection.update` akan dipicu meminta restart sock.
-2. Kemudian, pesan riwayat diterima di `messaging.history-set`.
-
-## 🗄️ Implementasi Data Store
-
-Wileys tidak menyertakan penyimpanan default untuk obrolan, kontak, atau pesan. Namun, implementasi in-memory sederhana disediakan. Store mendengarkan update obrolan, pesan baru, dll., untuk menjaga data tetap terkini.
-
-> [!IMPORTANT]  
-> Saya sangat merekomendasikan membangun data store sendiri, karena menyimpan seluruh riwayat obrolan di memori sangat boros RAM.
+---
 
-```javascript
-const makeWASocket = require("wileys").default
-const { makeInMemoryStore } = require("wileys")
+## In-Memory Store
 
-const store = makeInMemoryStore({ })
+n4lyx doesn't ship a default persistent store. A basic in-memory store is available for local dev and testing — not recommended for production.
 
-store.readFromFile('./wileys_store.json')
+```js
+const { makeInMemoryStore } = require('@n4tzz/n4lyx')
 
-setInterval(() => {
-    store.writeToFile('./wileys_store.json')
-}, 10_000)
+const store = makeInMemoryStore({})
+store.readFromFile('./store.json')
+setInterval(() => store.writeToFile('./store.json'), 10_000)
 
-const sock = makeWASocket({ })
+const sock = makeWASocket({})
 store.bind(sock.ev)
 
-sock.ev.on('chats.upsert', () => {
-    console.log('dapat obrolan', store.chats.all())
-})
-
-sock.ev.on('contacts.upsert', () => {
-    console.log('dapat kontak', Object.values(store.contacts))
-})
+sock.ev.on('chats.upsert', () => console.log(store.chats.all()))
+sock.ev.on('contacts.upsert', () => console.log(Object.values(store.contacts)))
 ```
 
-Store juga menyediakan fungsi sederhana seperti `loadMessages` untuk mempercepat pengambilan data.
-
-## 🆔 Penjelasan ID WhatsApp
+> Build your own store backed by a proper DB for anything in production.
 
-`id` adalah ID WhatsApp, disebut juga `jid`, untuk orang atau grup tujuan pesan.
-
-Format: `[kode negara][nomor telepon]@s.whatsapp.net`  
-Contoh untuk orang: `+19999999999@s.whatsapp.net`.  
-
-Untuk grup: `123456789-123345@g.us`.  
-
-Untuk daftar siaran: `[timestamp pembuatan]@broadcast`.  
-
-Untuk cerita: `status@broadcast`.
-
-## 🔧 Fungsi Utilitas
-
-- `getContentType` - Mengembalikan tipe konten pesan
-- `getDevice` - Mengembalikan perangkat dari pesan
-- `makeCacheableSignalKeyStore` - Mempercepat store auth
-- `downloadContentFromMessage` - Unduh konten dari pesan
-
-## 📤 Kirim Pesan
-
-Kirim semua jenis pesan dengan satu fungsi.
-
-Lihat konten pesan yang didukung di bagian di bawah.  
-Lihat opsi seperti quote di contoh di bawah.
+---
 
-```javascript
-const jid: string
-const content: AnyMessageContent
-const options: MiscMessageGenerationOptions
+## Sending Messages
 
-sock.sendMessage(jid, content, options)
+```js
+await sock.sendMessage(jid, content, options?)
 ```
 
-### Pesan Non-Media
+### Text
 
-#### Pesan Teks
-
-```javascript
-await sock.sendMessage(jid, { text: 'halo dunia' })
+```js
+await sock.sendMessage(jid, { text: 'hello' })
 ```
 
-#### Pesan Kutipan (bekerja dengan semua tipe)
+### Reply / Quote
 
-```javascript
-await sock.sendMessage(jid, { text: 'halo dunia' }, { quoted: message })
+```js
+await sock.sendMessage(jid, { text: 'hello' }, { quoted: message })
 ```
 
-#### Sebut Pengguna (bekerja dengan sebagian besar tipe)
-
-`@number` untuk sebut di teks, opsional.
+### Mention
 
-```javascript
-await sock.sendMessage(
-    jid,
-    {
-        text: '@12345678901',
-        mentions: ['12345678901@s.whatsapp.net']
-    }
-)
+```js
+await sock.sendMessage(jid, {
+  text: '@628XXXXXXXXX',
+  mentions: ['628XXXXXXXXX@s.whatsapp.net']
+})
 ```
 
-#### Teruskan Pesan
+### Tag All — n4lyx exclusive
 
-Butuh objek pesan, ambil dari store atau gunakan objek pesan.
+Mention every member in a group. Automatically fetches participant list — no manual work.
 
-```javascript
-const msg = getMessageFromStore() // implementasikan sendiri
-await sock.sendMessage(jid, { forward: msg })
-```
+```js
+// Tag all members
+await sock.sendMessage(jid, {
+  text: '@everyone listen up',
+  tagAll: true
+})
 
-#### Pesan Lokasi
+// Tag admins only
+await sock.sendMessage(jid, {
+  text: 'admins only',
+  tagAll: true,
+  tagAllScope: 'admins'
+})
 
-```javascript
-await sock.sendMessage(
-    jid, 
-    {
-        location: {
-            degreesLatitude: 24.121231,
-            degreesLongitude: 55.1121221
-        }
-    }
-)
+// Tag non-admins only
+await sock.sendMessage(jid, {
+  text: 'members',
+  tagAll: true,
+  tagAllScope: 'non_admins'
+})
 ```
 
-#### Pesan Kontak
+`tagAllScope` options: `'all'` (default) | `'admins'` | `'non_admins'`
 
-```javascript
-const vcard = 'BEGIN:VCARD\n' 
-            + 'VERSION:3.0\n' 
-            + 'FN:Jeff Singh\n' 
-            + 'ORG:Ashoka Uni;\n' 
-            + 'TEL;type=CELL;type=VOICE;waid=911234567890:+91 12345 67890\n' 
-            + 'END:VCARD'
+You can also get the jid list directly:
 
-await sock.sendMessage(
-    id,
-    { 
-        contacts: { 
-            displayName: 'Jeff', 
-            contacts: [{ vcard }] 
-        }
-    }
-)
+```js
+const jids = await sock.groupTagAll(groupJid, 'all')
+// returns: ['628XXX@s.whatsapp.net', ...]
 ```
 
-#### Pesan Reaksi
+### Forward
 
-Butuh kunci pesan, ambil dari store atau gunakan objek kunci.
-
-```javascript
-await sock.sendMessage(
-    jid,
-    {
-        react: {
-            text: '💖', // kosongkan untuk hapus reaksi
-            key: message.key
-        }
-    }
-)
+```js
+await sock.sendMessage(jid, { forward: msg })
 ```
 
-#### Pin Pesan
+### Location
 
-Butuh kunci pesan.
+```js
+await sock.sendMessage(jid, {
+  location: { degreesLatitude: -6.2, degreesLongitude: 106.8 }
+})
+```
 
-Waktu:
+### Contact
 
-| Waktu | Detik      |
-|-------|------------|
-| 24j   | 86.400     |
-| 7h    | 604.800    |
-| 30h   | 2.592.000  |
+```js
+const vcard = [
+  'BEGIN:VCARD',
+  'VERSION:3.0',
+  'FN:John Doe',
+  'TEL;type=CELL;waid=628XXXXXXXXX:+62 8XX-XXXX-XXXX',
+  'END:VCARD'
+].join('\n')
 
-```javascript
-await sock.sendMessage(
-    jid,
-    {
-        pin: {
-            type: 1, // 0 untuk hapus
-            time: 86400,
-            key: message.key
-        }
-    }
-)
+await sock.sendMessage(jid, {
+  contacts: { displayName: 'John', contacts: [{ vcard }] }
+})
 ```
 
-#### Pesan Poll
+### Reaction
 
-```javascript
-await sock.sendMessage(
-    jid,
-    {
-        poll: {
-            name: 'Poll Saya',
-            values: ['Opsi 1', 'Opsi 2', ...],
-            selectableCount: 1,
-            toAnnouncementGroup: false // atau true
-        }
-    }
-)
+```js
+await sock.sendMessage(jid, {
+  react: { text: '🔥', key: message.key }
+})
+// Remove: text: ''
 ```
 
-### Kirim dengan Pratinjau Tautan
+### Poll
 
-1. Secara default, WA tidak punya generasi tautan dari web.
-2. Wileys punya fungsi untuk pratinjau tautan.
-3. Tambahkan `link-preview-js` dengan `npm i link-preview-js`.
-4. Kirim tautan:
-
-```javascript
-await sock.sendMessage(
-    jid,
-    {
-        text: 'Halo, ini dikirim menggunakan https://npmjs.com/wileys'
-    }
-)
+```js
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Pick one',
+    values: ['Option A', 'Option B'],
+    selectableCount: 1
+  }
+})
 ```
 
-### Pesan Media
-
-Pengiriman media (video, stiker, gambar) lebih mudah & efisien.
-
-> [!NOTE] Di pesan media, bisa gunakan `{ stream: Stream }` atau `{ url: Url }` atau Buffer langsung, lihat contoh di bawah.
+### Pin Message
 
-Wileys tidak muat seluruh buffer ke memori; enkripsi sebagai stream.
-
-> [!TIP] Gunakan Stream atau Url untuk hemat memori.
-
-#### Pesan Gif
-
-WA tidak dukung .gif, kirim sebagai .mp4 dengan flag `gifPlayback`.
-
-```javascript
-await sock.sendMessage(
-    jid, 
-    { 
-        video: fs.readFileSync('Media/ma_gif.mp4'),
-        caption: 'halo dunia',
-        gifPlayback: true
-    }
-)
+```js
+await sock.sendMessage(jid, {
+  pin: {
+    type: 1,     // 0 = unpin
+    time: 86400, // 86400 = 24h | 604800 = 7d | 2592000 = 30d
+    key: message.key
+  }
+})
 ```
 
-#### Pesan Video
-
-```javascript
-await sock.sendMessage(
-    id, 
-    { 
-        video: {
-            url: './Media/ma_gif.mp4'
-        },
-        caption: 'halo dunia',
-        ptv: false // true untuk video note
-    }
-)
-```
+### Media
 
-#### Pesan Audio
+All media supports `Buffer`, `{ url: '...' }`, or `{ stream: Stream }`.
 
-Konversi dengan ffmpeg: `codec: libopus`, `ac: 1`, `avoid_negative_ts`, `make_zero`.
+```js
+// Image
+await sock.sendMessage(jid, {
+  image: { url: './photo.png' },
+  caption: 'caption'
+})
 
-Contoh: `ffmpeg -i input.mp4 -avoid_negative_ts make_zero -ac 1 output.ogg`
+// Video
+await sock.sendMessage(jid, {
+  video: { url: './video.mp4' },
+  caption: 'caption',
+  ptv: false // true = video note (circle)
+})
 
-```javascript
-await sock.sendMessage(
-    jid, 
-    {
-        audio: {
-            url: './Media/audio.mp3'
-        },
-        mimetype: 'audio/mp4'
-    }
-)
-```
+// Audio
+// Convert: ffmpeg -i input.mp4 -avoid_negative_ts make_zero -ac 1 output.ogg
+await sock.sendMessage(jid, {
+  audio: { url: './audio.ogg' },
+  mimetype: 'audio/mp4'
+})
 
-#### Pesan Gambar
+// GIF (must be MP4 + gifPlayback flag)
+await sock.sendMessage(jid, {
+  video: fs.readFileSync('./animation.mp4'),
+  gifPlayback: true
+})
 
-```javascript
-await sock.sendMessage(
-    id, 
-    { 
-        image: {
-            url: './Media/ma_img.png'
-        },
-        caption: 'halo dunia'
-    }
-)
+// View once (works on image, video, audio)
+await sock.sendMessage(jid, {
+  image: { url: './photo.png' },
+  viewOnce: true
+})
 ```
 
-#### Pesan View Once
+### Link Preview
 
-Tambahkan `viewOnce: true` untuk semua pesan di atas.
+Requires `link-preview-js`:
 
-```javascript
-await sock.sendMessage(
-    id, 
-    { 
-        image: {
-            url: './Media/ma_img.png'
-        },
-        viewOnce: true, // bekerja dengan video, audio juga
-        caption: 'halo dunia'
-    }
-)
+```bash
+npm i link-preview-js
 ```
 
-## ✏️ Ubah Pesan
-
-### Hapus Pesan (untuk semua)
-
-```javascript
-const msg = await sock.sendMessage(jid, { text: 'halo dunia' })
-await sock.sendMessage(jid, { delete: msg.key })
+```js
+await sock.sendMessage(jid, {
+  text: 'check this out: https://npmjs.com/package/@n4tzz/n4lyx'
+})
 ```
 
-Catatan: Hapus untuk diri sendiri dukung via `chatModify`, lihat [Ubah Obrolan](#ubah-obrolan).
+---
 
-### Edit Pesan
+## Edit & Delete
 
-Gunakan konten editable.
+```js
+// Delete for everyone
+const sent = await sock.sendMessage(jid, { text: 'oops' })
+await sock.sendMessage(jid, { delete: sent.key })
 
-```javascript
+// Edit message
 await sock.sendMessage(jid, {
-      text: 'teks terupdate di sini',
-      edit: response.key,
-    });
+  text: 'corrected text',
+  edit: sent.key
+})
 ```
 
-## 🖼️ Manipulasi Pesan Media
-
-### Thumbnail di Pesan Media
-
-Thumbnail otomatis untuk gambar & stiker jika tambah `jimp` atau `sharp` (`npm i jimp` atau `npm i sharp`).  
-
-Untuk video, butuh `ffmpeg` terinstal.
-
-### Unduh Pesan Media
+---
 
-Untuk simpan media yang diterima:
+## Downloading Media
 
-```javascript
+```js
+import { downloadMediaMessage, getContentType } from '@n4tzz/n4lyx'
 import { createWriteStream } from 'fs'
-import { downloadMediaMessage, getContentType } from 'wileys'
 
 sock.ev.on('messages.upsert', async ({ messages: [m] }) => {
-    if (!m.message) return
-    const messageType = getContentType(m)
-
-    if (messageType === 'imageMessage') {
-        const stream = await downloadMediaMessage(
-            m,
-            'stream', // atau 'buffer'
-            { },
-            { 
-                logger,
-                reuploadRequest: sock.updateMediaMessage
-            }
-        )
-        const writeStream = createWriteStream('./my-download.jpeg')
-        stream.pipe(writeStream)
-    }
-})
-```
-
-### Unggah Ulang Pesan Media ke WhatsApp
-
-WA hapus media lama dari server. Unggah ulang dengan:
+  if (!m.message) return
+  if (getContentType(m) !== 'imageMessage') return
 
-```javascript
-await sock.updateMediaMessage(msg)
-```
-
-## 📞 Tolak Panggilan
+  const stream = await downloadMediaMessage(m, 'stream', {}, {
+    logger,
+    reuploadRequest: sock.updateMediaMessage
+  })
 
-Ambil `callId` dan `callFrom` dari event `call`.
-
-```javascript
-await sock.rejectCall(callId, callFrom)
-```
-
-## 💬 Status Kirim di Obrolan
-
-### Baca Pesan
-
-Kumpulan kunci pesan harus ditandai dibaca secara eksplisit.
-
-```javascript
-const key: WAMessageKey
-await sock.readMessages([key]) // bisa multiple kunci
+  stream.pipe(createWriteStream('./download.jpeg'))
+})
 ```
 
-ID pesan adalah pengenal unik. Akses dengan `message.key.id`.
+Re-upload expired media:
 
-### Update Kehadiran
-
-`presence` bisa: available, composing, recording, paused, unavailable.
-
-Berlaku 10 detik. Beri tahu jid apakah Anda online, offline, mengetik, dll.
-
-```javascript
-await sock.sendPresenceUpdate('available', jid) 
+```js
+await sock.updateMediaMessage(msg)
 ```
 
-> [!NOTE] Jika klien desktop aktif, WA tidak kirim notifikasi push. Untuk terima notifikasi, setel offline dengan `sock.sendPresenceUpdate('unavailable')`.
-
-## 📁 Ubah Obrolan
-
-WA gunakan komunikasi terenkripsi untuk update obrolan/aplikasi.
-
-> [!IMPORTANT] Jika salah update, WA bisa logout dari semua perangkat.
-
-### Arsipkan Obrolan
+---
 
-```javascript
-const lastMsgInChat = await getLastMessageInChat(jid) // implementasikan sendiri
-await sock.chatModify({ archive: true, lastMessages: [lastMsgInChat] }, jid)
-```
+## Chat Modifications
 
-### Bisukan/Buka Bisukan Obrolan
+> Wrong updates can log you out of all devices. Handle with care.
 
-Waktu dukung:
+```js
+const last = await getLastMessage(jid) // your implementation
 
-| Waktu | Milidetik   |
-|-------|-------------|
-| Hapus | null        |
-| 8j    | 86.400.000  |
-| 7h    | 604.800.000 |
+// Archive
+await sock.chatModify({ archive: true, lastMessages: [last] }, jid)
 
-```javascript
-// Bisukan 8 jam
-await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid)
-// Buka bisukan
+// Mute (ms) / unmute
+await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid) // 8h
 await sock.chatModify({ mute: null }, jid)
-```
-
-### Tandai Obrolan Dibaca/Tidak Dibaca
 
-```javascript
-const lastMsgInChat = await getLastMessageInChat(jid)
-// tandai tidak dibaca
-await sock.chatModify({ markRead: false, lastMessages: [lastMsgInChat] }, jid)
-```
-
-### Hapus Pesan untuk Saya
-
-```javascript
-await sock.chatModify(
-    {
-        clear: {
-            messages: [
-                {
-                    id: 'ATWYHDNNWU81732J',
-                    fromMe: true, 
-                    timestamp: '1654823909'
-                }
-            ]
-        }
-    }, 
-    jid
-)
-```
+// Mark unread
+await sock.chatModify({ markRead: false, lastMessages: [last] }, jid)
 
-### Hapus Obrolan
+// Pin / unpin
+await sock.chatModify({ pin: true }, jid)
+await sock.chatModify({ pin: false }, jid)
 
-```javascript
-const lastMsgInChat = await getLastMessageInChat(jid)
+// Delete chat
 await sock.chatModify({
-        delete: true,
-        lastMessages: [
-            {
-                key: lastMsgInChat.key,
-                messageTimestamp: lastMsgInChat.messageTimestamp
-            }
-        ]
-    },
-    jid
-)
-```
+  delete: true,
+  lastMessages: [{ key: last.key, messageTimestamp: last.messageTimestamp }]
+}, jid)
 
-### Pin/Hapus Pin Obrolan
-
-```javascript
+// Delete message (self only)
 await sock.chatModify({
-        pin: true // atau false untuk hapus pin
-    },
-    jid
-)
-```
+  clear: { messages: [{ id: 'MESSAGE_ID', fromMe: true, timestamp: '...' }] }
+}, jid)
 
-### Bintangi/Hapus Bintang Pesan
-
-```javascript
+// Star / unstar
 await sock.chatModify({
-        star: {
-            messages: [
-                {
-                    id: 'messageID',
-                    fromMe: true // atau false
-                }
-            ],
-            star: true // true: Bintangi; false: Hapus Bintang
-        }
-    },
-    jid
-)
+  star: {
+    messages: [{ id: 'MESSAGE_ID', fromMe: true }],
+    star: true // false = unstar
+  }
+}, jid)
 ```
 
-### Pesan Menghilang
-
-Ephemeral:
+### Disappearing Messages
 
-| Waktu | Detik       |
-|-------|-------------|
-| Hapus | 0           |
-| 24j   | 86.400      |
-| 7h    | 604.800     |
-| 90h   | 7.776.000   |
+```js
+// Enable (86400 = 24h | 604800 = 7d | 7776000 = 90d)
+await sock.sendMessage(jid, { disappearingMessagesInChat: WA_DEFAULT_EPHEMERAL })
 
-Gunakan detik, default 7 hari.
+// Send as ephemeral
+await sock.sendMessage(jid, { text: 'poof' }, { ephemeralExpiration: WA_DEFAULT_EPHEMERAL })
 
-```javascript
-// Nyalakan pesan menghilang
-await sock.sendMessage(
-    jid, 
-    { disappearingMessagesInChat: WA_DEFAULT_EPHEMERAL }
-)
-
-// Kirim sebagai pesan menghilang
-await sock.sendMessage(jid, { text: 'halo' }, { ephemeralExpiration: WA_DEFAULT_EPHEMERAL })
-
-// Matikan
-await sock.sendMessage(
-    jid, 
-    { disappearingMessagesInChat: false }
-)
-```
-
-## 👤 Query Pengguna
-
-### Periksa ID Ada di WhatsApp
-
-```javascript
-const [result] = await sock.onWhatsApp(jid)
-if (result.exists) console.log(`${jid} ada di WhatsApp, sebagai jid: ${result.jid}`)
+// Disable
+await sock.sendMessage(jid, { disappearingMessagesInChat: false })
 ```
 
-### Query Riwayat Obrolan (grup juga)
-
-Butuh pesan tertua di obrolan.
-
-```javascript
-const msg = await getOldestMessageInChat(jid) // implementasikan sendiri
-await sock.fetchMessageHistory(
-    50, // jumlah (max: 50 per query)
-    msg.key,
-    msg.messageTimestamp
-)
-```
-
-Pesan diterima di event `messaging.history-set`.
-
-### Ambil Status
-
-```javascript
-const status = await sock.fetchStatus(jid)
-console.log('status: ' + status)
-```
-
-### Ambil Foto Profil (grup juga)
-
-```javascript
-// resolusi rendah
-const ppUrl = await sock.profilePictureUrl(jid)
-console.log(ppUrl)
+---
 
-// resolusi tinggi
-const ppUrl = await sock.profilePictureUrl(jid, 'image')
-```
+## Groups
 
-### Ambil Profil Bisnis (deskripsi atau kategori)
+```js
+// Create
+const group = await sock.groupCreate('Group Name', ['jid@s.whatsapp.net'])
+console.log('Created:', group.gid)
 
-```javascript
-const profile = await sock.getBusinessProfile(jid)
-console.log('deskripsi bisnis: ' + profile.description + ', kategori: ' + profile.category)
-```
+// Add / remove / promote / demote
+await sock.groupParticipantsUpdate(jid, ['jid@s.whatsapp.net'], 'add')
+// 'add' | 'remove' | 'promote' | 'demote'
 
-### Ambil Kehadiran Seseorang (mengetik atau online)
+// Update name
+await sock.groupUpdateSubject(jid, 'New Name')
 
-```javascript
-sock.ev.on('presence.update', console.log)
+// Update description
+await sock.groupUpdateDescription(jid, 'New description')
 
-await sock.presenceSubscribe(jid) 
-```
+// Settings
+await sock.groupSettingUpdate(jid, 'announcement')     // admin-only send
+await sock.groupSettingUpdate(jid, 'not_announcement') // everyone can send
+await sock.groupSettingUpdate(jid, 'locked')           // admin-only settings
+await sock.groupSettingUpdate(jid, 'unlocked')         // everyone can edit
 
-## 🔄 Ubah Profil
+// Leave
+await sock.groupLeave(jid)
 
-### Ubah Status Profil
+// Invite link
+const code = await sock.groupInviteCode(jid)
+// link: https://chat.whatsapp.com/${code}
 
-```javascript
-await sock.updateProfileStatus('Halo Dunia!')
-```
+// Revoke invite
+await sock.groupRevokeInvite(jid)
 
-### Ubah Nama Profil
+// Join via code (without https://chat.whatsapp.com/)
+await sock.groupAcceptInvite(code)
 
-```javascript
-await sock.updateProfileName('Nama Saya')
-```
+// Metadata (participants, name, desc...)
+const meta = await sock.groupMetadata(jid)
 
-### Ubah Foto Tampilan (grup juga)
+// Ephemeral
+await sock.groupToggleEphemeral(jid, 86400)
 
-> [!NOTE] Seperti pesan media, gunakan `{ stream: Stream }` atau `{ url: Url }` atau Buffer, lihat [Pesan Media](#pesan-media).
+// Add mode
+await sock.groupMemberAddMode(jid, 'all_member_add') // or 'admin_add'
 
-```javascript
-await sock.updateProfilePicture(jid, { url: './new-profile-picture.jpeg' })
-```
+// Join approval mode
+await sock.groupJoinApprovalMode(jid, 'on') // or 'off'
 
-### Hapus Foto Tampilan (grup juga)
+// Join requests
+const requests = await sock.groupRequestParticipantsList(jid)
+await sock.groupRequestParticipantsUpdate(jid, ['jid@s.whatsapp.net'], 'approve') // or 'reject'
 
-```javascript
-await sock.removeProfilePicture(jid)
+// All joined group metadata
+const all = await sock.groupFetchAllParticipating()
 ```
 
-## 👥 Grup
-
-Untuk ubah properti grup, harus admin.
-
-### Buat Grup
-
-```javascript
-const group = await sock.groupCreate('Grup Saya', ['1234@s.whatsapp.net', '4564@s.whatsapp.net'])
-console.log('grup dibuat dengan id: ' + group.gid)
-await sock.sendMessage(group.id, { text: 'halo semuanya' })
-```
+### Group Status V2 — n4lyx exclusive
 
-### Tambah/Hapus atau Turunkan/Naikkan
+Extended group status with full metadata control.
 
-```javascript
-await sock.groupParticipantsUpdate(
-    jid, 
-    ['abcd@s.whatsapp.net', 'efgh@s.whatsapp.net'],
-    'add' // ganti dengan 'remove', 'demote', atau 'promote'
-)
-```
+```js
+// Set group status v2
+await sock.groupSetStatusV2(jid, {
+  duration: 86400,       // seconds (default: 86400 = 24h)
+  allowReply: true,      // allow members to reply (default: true)
+  allowReaction: true,   // allow reactions (default: true)
+  visibility: 'all'      // 'all' | 'admin' (default: 'all')
+})
 
-### Ubah Subjek (nama)
+// Get current group status v2 settings
+const settings = await sock.groupGetStatusV2(jid)
+console.log(settings)
+// { duration: 86400, allowReply: true, allowReaction: true, visibility: 'all' }
 
-```javascript
-await sock.groupUpdateSubject(jid, 'Subjek Baru!')
+// Send message as group status v2
+await sock.sendMessage(jid, {
+  text: 'group announcement',
+  groupStatusV2: {
+    duration: 604800,     // 7 days
+    allowReply: false,
+    allowReaction: true,
+    visibility: 'all'
+  }
+})
 ```
 
-### Ubah Deskripsi
+---
 
-```javascript
-await sock.groupUpdateDescription(jid, 'Deskripsi Baru!')
-```
+## Presence
 
-### Ubah Pengaturan
-
-```javascript
-// Hanya admin kirim pesan
-await sock.groupSettingUpdate(jid, 'announcement')
-// Semua bisa kirim
-await sock.groupSettingUpdate(jid, 'not_announcement')
-// Semua bisa ubah pengaturan grup
-await sock.groupSettingUpdate(jid, 'unlocked')
-// Hanya admin ubah pengaturan
-await sock.groupSettingUpdate(jid, 'locked')
-```
+```js
+// Mark messages as read
+await sock.readMessages([key])
 
-### Keluar Grup
+// Send presence
+// 'available' | 'unavailable' | 'composing' | 'recording' | 'paused'
+await sock.sendPresenceUpdate('composing', jid)
 
-```javascript
-await sock.groupLeave(jid)
+// Subscribe to contact presence
+sock.ev.on('presence.update', console.log)
+await sock.presenceSubscribe(jid)
 ```
 
-### Ambil Kode Undangan
+---
 
-Buat tautan: `'https://chat.whatsapp.com/' + code`.
+## Querying
 
-```javascript
-const code = await sock.groupInviteCode(jid)
-console.log('kode grup: ' + code)
-```
-
-### Cabut Kode Undangan
+```js
+// Check if number is on WhatsApp
+const [result] = await sock.onWhatsApp(jid)
+if (result.exists) console.log(result.jid)
 
-```javascript
-const code = await sock.groupRevokeInvite(jid)
-console.log('Kode grup baru: ' + code)
-```
+// Status text
+const status = await sock.fetchStatus(jid)
 
-### Gabung Menggunakan Kode Undangan
+// Profile picture
+const url = await sock.profilePictureUrl(jid)            // low res
+const urlHD = await sock.profilePictureUrl(jid, 'image') // high res
 
-Kode tanpa `https://chat.whatsapp.com/`.
+// Business profile
+const biz = await sock.getBusinessProfile(jid)
+console.log(biz.description, biz.category)
 
-```javascript
-const response = await sock.groupAcceptInvite(code)
-console.log('bergabung ke: ' + response)
+// Message history (max 50 per call)
+const oldest = await getOldestMessage(jid) // your implementation
+await sock.fetchMessageHistory(50, oldest.key, oldest.messageTimestamp)
+// messages arrive via messaging.history-set
 ```
 
-### Ambil Info Grup dari Kode Undangan
-
-```javascript
-const response = await sock.groupGetInviteInfo(code)
-console.log('info grup: ' + response)
-```
+---
 
-### Query Metadata (peserta, nama, deskripsi...)
+## Privacy
 
-```javascript
-const metadata = await sock.groupMetadata(jid) 
-console.log(metadata.id + ', judul: ' + metadata.subject + ', deskripsi: ' + metadata.desc)
-```
+```js
+// Block / unblock
+await sock.updateBlockStatus(jid, 'block')
+await sock.updateBlockStatus(jid, 'unblock')
 
-### Gabung Menggunakan groupInviteMessage
+// Get settings
+await sock.fetchPrivacySettings(true)
 
-```javascript
-const response = await sock.groupAcceptInviteV4(jid, groupInviteMessage)
-console.log('bergabung ke: ' + response)
-```
+// Get blocklist
+await sock.fetchBlocklist()
 
-### Ambil Daftar Permintaan Gabung
+// Update settings
+// 'all' | 'contacts' | 'contact_blacklist' | 'none'
+await sock.updateLastSeenPrivacy('contacts')
+await sock.updateProfilePicturePrivacy('contacts')
+await sock.updateStatusPrivacy('contacts')
+await sock.updateReadReceiptsPrivacy('all')
+await sock.updateGroupsAddPrivacy('contacts')
+await sock.updateOnlinePrivacy('all') // or 'match_last_seen'
 
-```javascript
-const response = await sock.groupRequestParticipantsList(jid)
-console.log(response)
+// Default disappearing mode
+await sock.updateDefaultDisappearingMode(86400)
 ```
 
-### Setujui/Tolak Permintaan Gabung
-
-```javascript
-const response = await sock.groupRequestParticipantsUpdate(
-    jid,
-    ['abcd@s.whatsapp.net', 'efgh@s.whatsapp.net'],
-    'approve' // atau 'reject'
-)
-console.log(response)
-```
+---
 
-### Ambil Semua Metadata Grup yang Diikuti
+## Profile
 
-```javascript
-const response = await sock.groupFetchAllParticipating()
-console.log(response)
+```js
+await sock.updateProfileStatus('available')
+await sock.updateProfileName('My Name')
+await sock.updateProfilePicture(jid, { url: './avatar.jpeg' })
+await sock.removeProfilePicture(jid)
 ```
 
-### Toggle Ephemeral
-
-Ephemeral:
-
-| Waktu | Detik       |
-|-------|-------------|
-| Hapus | 0           |
-| 24j   | 86.400      |
-| 7h    | 604.800     |
-| 90h   | 7.776.000   |
-
-```javascript
-await sock.groupToggleEphemeral(jid, 86400)
-```
+---
 
-### Ubah Mode Tambah
+## Broadcast & Stories
 
-```javascript
-await sock.groupMemberAddMode(
-    jid,
-    'all_member_add' // atau 'admin_add'
+```js
+await sock.sendMessage(
+  'status@broadcast',
+  { image: { url: url }, caption: 'caption' },
+  {
+    backgroundColor: '#000',
+    font: 0,
+    statusJidList: ['jid@s.whatsapp.net'],
+    broadcast: true
+  }
 )
-```
 
-## 🔒 Privasi
-
-### Blokir/Buka Blokir Pengguna
-
-```javascript
-await sock.updateBlockStatus(jid, 'block') // Blokir
-await sock.updateBlockStatus(jid, 'unblock') // Buka blokir
+// Broadcast list info
+const info = await sock.getBroadcastListInfo('1234@broadcast')
+console.log(info.name, info.recipients)
 ```
 
-### Ambil Pengaturan Privasi
-
-```javascript
-const privacySettings = await sock.fetchPrivacySettings(true)
-console.log('pengaturan privasi: ' + privacySettings)
-```
+---
 
-### Ambil Daftar Blokir
+## Calls
 
-```javascript
-const response = await sock.fetchBlocklist()
-console.log(response)
+```js
+sock.ev.on('call', async ([call]) => {
+  await sock.rejectCall(call.id, call.from)
+})
 ```
 
-### Update Privasi Terakhir Dilihat
+---
 
-```javascript
-const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateLastSeenPrivacy(value)
-```
+## Poll Decryption
 
-### Update Privasi Online
+Polls are encrypted by default. Decryption happens in `messages.update`.
 
-```javascript
-const value = 'all' // 'match_last_seen'
-await sock.updateOnlinePrivacy(value)
-```
+```js
+sock.ev.on('messages.update', async (events) => {
+  for (const { key, update } of events) {
+    if (!update.pollUpdates) continue
 
-### Update Privasi Foto Profil
-
-```javascript
-const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateProfilePicturePrivacy(value)
-```
+    const creation = await getMessage(key) // your implementation
+    if (!creation) continue
 
-### Update Privasi Status
-
-```javascript
-const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateStatusPrivacy(value)
+    console.log(
+      getAggregateVotesInPollMessage({
+        message: creation,
+        pollUpdates: update.pollUpdates
+      })
+    )
+  }
+})
 ```
 
-### Update Privasi Tanda Terima Baca
-
-```javascript
-const value = 'all' // 'none'
-await sock.updateReadReceiptsPrivacy(value)
-```
+---
 
-### Update Privasi Tambah Grup
+## Low-Level: WebSocket Callbacks
 
-```javascript
-const value = 'all' // 'contacts' | 'contact_blacklist'
-await sock.updateGroupsAddPrivacy(value)
+```js
+sock.ws.on('CB:edge_routing', (node) => { })
+sock.ws.on('CB:edge_routing,id:abcd', (node) => { })
+sock.ws.on('CB:edge_routing,id:abcd,routing_info', (node) => { })
 ```
 
-### Update Mode Menghilang Default
+Debug mode — logs every WA protocol frame:
 
-Ephemeral:
-
-| Waktu | Detik       |
-|-------|-------------|
-| Hapus | 0           |
-| 24j   | 86.400      |
-| 7h    | 604.800     |
-| 90h   | 7.776.000   |
-
-```javascript
-const ephemeral = 86400 
-await sock.updateDefaultDisappearingMode(ephemeral)
+```js
+const sock = makeWASocket({ logger: P({ level: 'debug' }) })
 ```
 
-## 📢 Daftar Siaran & Cerita
-
-### Kirim Siaran & Cerita
-
-Pesan bisa dikirim ke siaran & cerita. Tambahkan opsi pesan:
-
-```javascript
-await sock.sendMessage(
-    jid,
-    {
-        image: {
-            url: url
-        },
-        caption: caption
-    },
-    {
-        backgroundColor: backgroundColor,
-        font: font,
-        statusJidList: statusJidList,
-        broadcast: true
-    }
-)
-```
+---
 
-Body pesan bisa `extendedTextMessage`, `imageMessage`, dll., lihat [Pesan Media](#pesan-media).  
+## JID Format
 
-`broadcast: true` aktifkan mode siaran.  
+| Type      | Format                         |
+|-----------|-------------------------------|
+| User      | `628XXXXXXXXX@s.whatsapp.net` |
+| Group     | `123456789-123456@g.us`       |
+| Broadcast | `[timestamp]@broadcast`       |
+| Story     | `status@broadcast`            |
 
-`statusJidList`: daftar penerima.  
+---
 
-ID siaran: `12345678@broadcast`.
+## Utilities
 
-### Query Penerima & Nama Daftar Siaran
+| Function                      | Description                          |
+|-------------------------------|--------------------------------------|
+| `getContentType(msg)`         | Returns content type of a message    |
+| `getDevice(msg)`              | Returns sender's device info         |
+| `makeCacheableSignalKeyStore` | Speeds up auth key store operations  |
+| `downloadContentFromMessage`  | Downloads raw content from a message |
+| `fetchLatestN4lyxVersion`     | Fetches latest n4lyx version from npm |
+| `fetchLatestWaWebVersion`     | Fetches latest WA Web version        |
 
-```javascript
-const bList = await sock.getBroadcastListInfo('1234@broadcast')
-console.log(`nama daftar: ${bList.name}, penerima: ${bList.recipients}`)
-```
+---
 
-## 🛠️ Fungsi Kustom
+## n4lyx Exclusive Features
 
-Wileys dirancang untuk fungsi kustom. Tambahkan ekstensi sendiri tanpa fork.
+| Feature | Description |
+|---|---|
+| `tagAll` in `sendMessage` | Auto-mention all/admins/non-admins in a group |
+| `groupTagAll(jid, scope)` | Get list of participant jids by scope |
+| `groupSetStatusV2(jid, opts)` | Set group status v2 with full metadata |
+| `groupGetStatusV2(jid)` | Get current group status v2 settings |
+| `N4lyxMeta` in proto | Internal message metadata (version, session, timestamp) |
+| `GroupStatusV2Message` in proto | Extended group status message type |
+| `TagAllMessage` in proto | Tag-all message type with scope support |
 
-### Aktifkan Level Debug di Log Wileys
+---
 
-```javascript
-const sock = makeWASocket({
-    logger: P({ level: 'debug' }),
-})
-```
+## Optional Dependencies
 
-Ini tampilkan pesan WhatsApp di konsol.
-
-### Cara WhatsApp Berkomunikasi
-
-> [!TIP] Pelajari protokol WhatsApp dengan Libsignal Protocol dan Noise Protocol.
-
-Contoh: Lacak persentase baterai ponsel. Aktifkan log, pesan baterai muncul:
-
-```json
-{
-    "level": 10,
-    "fromMe": false,
-    "frame": {
-        "tag": "ib",
-        "attrs": {
-            "from": "@s.whatsapp.net"
-        },
-        "content": [
-            {
-                "tag": "edge_routing",
-                "attrs": {},
-                "content": [
-                    {
-                        "tag": "routing_info",
-                        "attrs": {},
-                        "content": {
-                            "type": "Buffer",
-                            "data": [8,2,8,5]
-                        }
-                    }
-                ]
-            }
-        ]
-    },
-    "msg":"communication"
-}
+```bash
+npm i jimp              # or sharp — thumbnail generation
+npm i link-preview-js   # link previews in text messages
+npm i qrcode-terminal   # QR rendering in terminal
 ```
 
-`'frame'` punya: `tag` (jenis frame), `attrs` (metadata), `content` (data).  
-
-### Daftarkan Callback untuk Event Websocket
+Video thumbnails require `ffmpeg` on your system.
 
-> [!TIP] Lihat fungsi `onMessageReceived` di `socket.ts`.
+Audio conversion:
 
-```javascript
-// Untuk tag 'edge_routing'
-sock.ws.on('CB:edge_routing', (node: BinaryNode) => { })
-
-// Dengan id 'abcd'
-sock.ws.on('CB:edge_routing,id:abcd', (node: BinaryNode) => { })
-
-// Dengan node routing_info
-sock.ws.on('CB:edge_routing,id:abcd,routing_info', (node: BinaryNode) => { })
+```bash
+ffmpeg -i input.mp4 -avoid_negative_ts make_zero -ac 1 output.ogg
 ```
 
-## 💡 Tips & Praktik Terbaik
-
-- **Gunakan Caching**: Cache metadata grup untuk performa lebih baik.
-- **Tangani Rekoneksi**: Implementasikan auto-reconnect untuk kestabilan.
-- **Kelola Store**: Gunakan database (MongoDB, PostgreSQL) untuk produksi.
-- **Penanganan Error**: Bungkus panggilan socket dengan try-catch.
-- **Batas Rate**: Hormati batas WhatsApp untuk hindari ban—jangan spam.
-- **Keamanan**: Jangan bagikan kredensial auth; gunakan variabel lingkungan.
+---
 
-## 📄 Lisensi
+## License
 
-Didistribusikan di bawah Lisensi GPL-3.0. Lihat [LICENSE](LICENSE) untuk info lebih lanjut.
+MIT — see [LICENSE](LICENSE).
 
 ---
 
-<div align="center">
-  Fork dan dimodifikasi oleh Tim Wileys.  
-  Wileys - API WhatsApp Web Modern dengan Perbaikan @lid Ke @pn
-</div>
+<sub>n4lyx — built by N4tzz.</sub>