@xbibzlibrary/whatsbibz 1.3.2 → 1.4.0

package/README.id.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/gh/XbibzOfficial777/whatsbibz@main/assets/logo/preview.png" alt="WhatsBibz" width="360">
+  <a href="https://www.npmjs.com/package/@xbibzlibrary/whatsbibz"><img src="https://cdn.jsdelivr.net/gh/XbibzOfficial777/whatsbibz@main/assets/logo/preview.webp" alt="WhatsBibz" width="640"></a>
 </p>
 
 <h1 align="center">WhatsBibz</h1>
@@ -18,7 +18,7 @@
 </p>
 
 <p align="center">
-  <a href="README.md">English</a> · <b>Bahasa Indonesia</b>
+  <a href="README.md">English</a> · <b>Bahasa Indonesia</b> · <a href="README.cn.md">简体中文</a>
 </p>
 
 ---
@@ -39,6 +39,9 @@
   - [Mode kustom](#mode-kustom)
   - [Apa yang diterima WhatsApp](#apa-yang-diterima-whatsapp)
 - [Mengirim dan membaca pesan](#mengirim-dan-membaca-pesan)
+  - [Format teks dan markup chat](#format-teks-dan-markup-chat)
+  - [Tombol interaktif (Button)](#tombol-interaktif-button)
+  - [Pesan kaya bergaya AI](#pesan-kaya-bergaya-ai)
 - [API tingkat rendah (kompatibel Baileys)](#api-tingkat-rendah-kompatibel-baileys)
 - [TypeScript](#typescript)
 - [Migrasi dari Baileys / ourin-baileys](#migrasi-dari-baileys--ourin-baileys)
@@ -49,10 +52,11 @@
 - [Berkontribusi](#berkontribusi)
 - [Keamanan](#keamanan)
 - [Lisensi](#lisensi)
+- [Dukungan dan komunitas](#dukungan-dan-komunitas)
 
 ## Mengapa WhatsBibz
 
-WhatsBibz adalah fork penuh dari [Baileys](https://github.com/WhiskeySockets/Baileys) v7 (lewat `ourin-baileys@9.0.21`), sudah di-patch sampai `master` upstream saat ini, ditambah lapisan yang menyelesaikan hal-hal yang selalu ditulis ulang oleh setiap pembuat bot:
+WhatsBibz adalah fork penuh dari [Baileys](https://github.com/WhiskeySockets/Baileys) v7 (lewat `ourin-baileys@9.0.21`), sudah di-patch sampai `master` upstream saat ini, ditambah lapisan bawaan yang menangani koneksi, identitas, dan sesi:
 
 | Masalah | Yang dilakukan WhatsBibz |
 |---|---|
@@ -125,6 +129,7 @@ Contoh yang bisa langsung dijalankan ada di [`example/ping-bot.js`](example/ping
 | `companionPlatformDisplay` | `string \| null` | `null` | Override `companion_platform_display` saat pairing. Isi hanya bila kamu yakin nilainya ada di allow-list WhatsApp. |
 | `logger` | `{ info, warn, error, debug, ok }` | console | Objek apa pun dengan metode tersebut (semua opsional). |
 | `printQR` | `boolean` | `false` | Cetak QR sebagai ASCII saat QR ditampilkan (butuh `qrcode-terminal`). |
+| `banner` | `boolean` | `auto` | Cetak banner ASCII *"WhatsBibz."* (huruf Small Slant, warna pelangi) di terminal saat client dibuat. Bawaan hanya di terminal interaktif; `true` memaksa, `false` mematikan. |
 | `socketConfig` | `Partial<SocketConfig>` | `{}` | Opsi mentah `makeWASocket`, digabung paling akhir — pintu keluar penuh. |
 | `fetchLatestVersion` | `boolean` | `true` | Ambil versi WhatsApp Web terkini di setiap connect. Versi bawaan tidak pernah diturunkan. |
 | `forceIPv4` | `boolean` | `true` | Paksa IPv4 untuk unggah media. |
@@ -279,6 +284,220 @@ import {
 
 `sock.sendMessage(jid, content)` mentah mendukung semua yang didukung Baileys: teks, gambar, video, audio, dokumen, stiker, paket stiker, lokasi, kontak, polling, reaksi, edit, hapus, pin, teruskan, view-once, tombol interaktif, pesan produk dan event, newsletter. Builder `Button`, `Carousel`, dan `AIRich` diekspor.
 
+## Format teks dan markup chat
+
+### 1) Format asli WhatsApp (tanpa konversi)
+
+`sendText(..., { format: false })` dan `sock.sendMessage(jid, { text })` mengirim teks **apa adanya** — WhatsApp sendiri yang merender markup berikut di HP penerima:
+
+| Kamu ketik | Hasil di WhatsApp |
+|---|---|
+| `*teks*` | **teks tebal** |
+| `_teks_` | *teks miring* |
+| `~teks~` | ~~teks coret~~ |
+| `` `teks` `` | `teks monospace` |
+| `*_kombinasi_*` / `_*kombinasi*_` | **_tebal dan miring_** |
+| `` ```baris\nteks``` `` | blok kode monospace |
+
+```js
+await sock.sendMessage(jid, { text: '*Halo* _dunia_ ~semua~ `kode`' });
+// sendText dengan format:false juga meneruskannya apa adanya
+await sendText(sock, jid, '*bold* _italic_ ~strike~ `mono`', { format: false });
+```
+
+### 2) Konversi Markdown (gaya ChatGPT/AI) otomatis
+
+`sendText(..., { format: true })` (bawaan) menjalankan `whatsappify()` agar teks Markdown yang biasa keluar dari LLM tampil rapi sebagai format WhatsApp:
+
+| Markdown sumber | Hasil WhatsApp |
+|---|---|
+| `**tebal**` atau `__tebal__` | `*tebal*` |
+| `***tebal-miring***` | `*tebal-miring*` |
+| `~~coret~~` | `~coret~` |
+| `_miring_` | `_miring_` (dibiarkan, sudah format WA) |
+| `# / ## / ### …` di awal baris | dihapus (tidak tampil) |
+| `[label](https://url)` | `label (https://url)` |
+| sisa `***`/`___` berlebih | dirapikan jadi `*`/`_` |
+
+```js
+const jawabanAI = '## Ringkasan\n\n**Cuaca** hari ini *cerah*, ~~hujan~~ sudah berlalu.\nLihat [prakiraan](https://bmkg.go.id).';
+await sendText(sock, jid, jawabanAI);            // format: true secara default
+// hasil: "Ringkasan" (tanpa #) + *Cuaca* + _cerah_ + ~hujan~ + "prakiraan (https://bmkg.go.id)"
+```
+
+`splitText(teks, maxLen)` memecah teks > 4000 karakter (potong di baris/spasi, jeda 250 ms antar bagian) — `sendText` melakukannya otomatis.
+
+### 3) Mention & sebut semua
+
+```js
+import { pnJid } from '@xbibzlibrary/whatsbibz';
+
+await sock.sendMessage(jid, {
+  text: 'Halo @6281234567890, cek ini!',
+  mentions: [pnJid('6281234567890')],   // [] array JID
+});
+await sock.sendMessage(groupJid, {
+  text: 'Perhatian semua anggota',
+  mentions: [],            // atau isi [jidA, jidB, ...]
+  mentionAll: true,        // menandai seluruh chat (broadcast mention)
+});
+```
+
+## Tombol interaktif (Button)
+
+Semua tombol modern WhatsApp memakai format **native flow**: konten tombol berbentuk markup `{ name, buttonParamsJson }`. WhatsBibz meneruskannya lewat `sock.sendMessage(jid, { interactiveMessage: {...} })` atau builder `ButtonV2`.
+
+### Cara 1 — Native flow (disarankan) lewat `sendMessage`
+
+```js
+await sock.sendMessage(jid, {
+  interactiveMessage: {
+    title:  'Silakan pilih menu di bawah:',   // → teks badan pesan
+    footer: 'WhatsBibz Bot',                  // teks kecil di bawah (opsional)
+    header: 'MENU MAKAN',                  // judul besar (opsional)
+    buttons: [
+      { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Makanan', id: 'food' }) },
+      { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Minuman', id: 'drink' }) },
+      { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Batal', id: 'cancel' }) },
+    ],
+  },
+});
+```
+
+**Markup tombol native flow** (`name` + isi `buttonParamsJson`):
+
+| `name` | Tampilan | `buttonParamsJson` (contoh) |
+|---|---|---|
+| `quick_reply` | tombol balas biasa | `{"display_text":"Ya","id":"yes"}` |
+| `single_select` | dropdown daftar pilihan | `{"title":"Pilih Kota","sections":[{...}]}` (lihat Cara 3) |
+| `cta_url` | tombol buka tautan | `{"display_text":"Kunjungi","url":"https://…","webview_interaction":false}` |
+| `cta_call` | tombol telepon | `{"display_text":"Hubungi","id":"+628…"}` |
+| `cta_copy` | tombol salin | `{"display_text":"Salin kode","copy_code":"ABC123"}` |
+| `cta_reminder` / `cta_cancel_reminder` | atur / batalkan pengingat | `{"display_text":"Ingatkan saya","id":"…"}` |
+| `address_message` | minta alamat | `{"display_text":"Kirim alamat","id":"…"}` |
+| `send_location` | minta lokasi | `{"display_text":"…"}` |
+| `limited_time_offer` | penawaran terbatas | `{"text":"…","url":"…","copy_code":"…","expiration_time":0}` |
+
+Kunci yang dikenal: `display_text`, `id`, `url`, `copy_code`, `webview_interaction`, `expiration_time`, `sections`, `title`, `rows`. Tombol maksimal yang nyaman: 3 `quick_reply`, atau 1 `single_select` per pesan.
+
+### Cara 2 — Builder `ButtonV2` (format lama `buttonsMessage`)
+
+```js
+import { ButtonV2 } from '@xbibzlibrary/whatsbibz';
+
+const btn = new ButtonV2(sock)
+  .text('Pilih jawabanmu')         // .title()/.text()/.footer()/.image(url)
+  .footer('Kuis WhatsBibz')
+  .addButton('Sangat Puas', 'a')
+  .addButton('Cukup', 'b')
+  .addButton('Kurang', 'c');
+
+const msg = await btn.send(jid);   // otomatis menyisipkan node <biz> yang diperlukan
+// msg.key.id → id pesan terkirim
+```
+
+### Cara 3 — Dropdown pilihan (single_select)
+
+```js
+await sock.sendMessage(jid, {
+  interactiveMessage: {
+    title: 'Pilih kota tujuan:',
+    buttons: [{
+      name: 'single_select',
+      buttonParamsJson: JSON.stringify({
+        title: 'Kota',
+        sections: [{
+          title: 'Pulau Jawa',
+          rows: [
+            { title: 'Jakarta',  description: 'DKI Jakarta', id: 'jkt' },
+            { title: 'Bandung',  description: 'Jawa Barat',  id: 'bdg' },
+            { title: 'Surabaya', description: 'Jawa Timur',  id: 'sby' },
+          ],
+        }],
+      }),
+    }],
+  },
+});
+```
+
+### Menangkap klik / balasan tombol (inbound)
+
+Ketika user menekan tombol (native flow maupun legacy), bot menerima `messages.upsert` dengan tipe balasan; `extractMessage` menormalkannya menjadi `type: 'button'`:
+
+```js
+sock.ev.on('messages.upsert', async ({ messages, type }) => {
+  if (type !== 'notify') return;
+  for (const m of messages) {
+    if (m.key.fromMe || !m.message) continue;
+    const item = extractMessage(m);           // unwrap otomatis
+    if (item?.type !== 'button') continue;
+
+    console.log('Tombol ditekan:', item.buttonId, '|', item.buttonText);
+    switch (item.buttonId) {
+      case 'food':    return sendText(sock, m.key.remoteJid, 'Anda memilih *Makanan*', { quoted: m });
+      case 'drink':   return sendText(sock, m.key.remoteJid, 'Anda memilih *Minuman*', { quoted: m });
+      case 'jkt':     return sendText(sock, m.key.remoteJid, 'Tujuan: *Jakarta*', { quoted: m });
+      case 'cancel':  return sendText(sock, m.key.remoteJid, 'Dibatalkan');
+    }
+  }
+});
+```
+
+Klik **quick_reply** juga bisa dibaca mentah: `m.message.interactiveResponseMessage.nativeFlowResponseMessage` berisi `name` (mis. `quick_reply`) dan `paramsJson` = string JSON `{"id":"food","text":"Makanan"}`. Balasan `listResponseMessage`, `buttonsResponseMessage`, dan `templateButtonReplyMessage` (legacy) juga masuk akun `extractMessage`.
+
+## Pesan kaya bergaya AI
+
+WhatsBibz ikut menyediakan pembuat **rich message** (format yang sama dengan balasan Meta AI di WhatsApp: `botForwardedMessage`/`richResponseMessage`) sehingga bot bisa menampilkan tabel, blok kode ber-highlight, daftar tautan, dan saran lanjutan dalam satu pesan terformat.
+
+### Metode bawaan socket
+
+```js
+// Tabel
+await sock.sendTable(jid, 'Daftar Harga', ['Item', 'Harga'], [['Nasi Goreng', 'Rp15rb'], ['Es Teh', 'Rp5rb']], undefined, { footer: 'berlaku hari ini' });
+
+// Blok kode dengan highlight sintaks
+await sock.sendCodeBlock(jid, 'const x = 1;\nconsole.log(x);', undefined, { language: 'javascript', title: 'Contoh JS' });
+
+// Daftar tautan terformat — links: string URL atau { url, displayName }
+await sock.sendLink(jid, 'Sumber terpercaya:', [
+  { displayName: 'BMKG — Info Cuaca & Gempa', url: 'https://www.bmkg.go.id' },
+  'https://www.bmkg.go.id/cuaca',
+], undefined);
+
+// Pesan rich penuh dari submessage mentah
+await sock.sendRichMessage(jid, [
+  { messageType: 2, messageText: 'Halo dari rich message' },
+  { messageType: 4, tableMetadata: { title: 'Skor', rows: [{ items: ['A', '1'], isHeading: true }] } },
+], undefined);
+```
+
+Metode lain: `sendTableV2`, `sendList`, `sendCodeBlockV2`, `sendLinkV2`, `sendLatex`, `sendLatexImage`, `sendUnifiedResponse`, `captureUnifiedResponse` (lihat `Socket/messages-send.js`).
+
+### Builder `AIRich` (fluent)
+
+```js
+import { AIRich } from '@xbibzlibrary/whatsbibz';
+
+const rich = new AIRich(sock)
+  .addText('Berikut ringkasan cuaca hari ini untuk **Jakarta**:')
+  .addTable([
+    ['Waktu',   'Cuaca',   'Suhu'],
+    ['Pagi',    'Cerah',   '26°C'],
+    ['Siang',   'Berawan','32°C'],
+    ['Malam',   'Hujan',   '28°C'],
+  ])
+  .addCode('javascript', `async function cuaca(kota) {\n  return await fetch('https://api/weather?q=' + kota);\n}`)
+  .addSuggest(['Bagaimana cuaca besok?', 'Cari prakiraan mingguan']);
+
+await rich.send(jid, { forwarded: true, includesUnifiedResponse: true });
+```
+
+Metode `AIRich` (semua mengembalikan `this`, bisa dirantai): `addText(text)`, `addTable(array2dString)`, `addCode(lang, code)`, `addSource([[ikon, url, teks], ...])`, `addImage(url/buffer | array)`, `addVideo(...)`, `addProduct({...}|[...])`, `addPost(...)`, `addReels(...)`, `addTip(text)`, `addSuggest(string | string[])`, `addSubmessage(...)`, `addSection(...)`. `send(jid, { forwarded, notification, includesUnifiedResponse, includesSubmessages })` — semua opsi bernilai default `true` kecuali `notification` (`false`). `ORich` adalah alias `AIRich`; utilitas statis: `AIRich.tokenizer(code, lang)`, `AIRich.toTableMetadata(arr)`, `AIRich.newLayout(...)`.
+
+### Catatan penggunaan yang etis
+
+Pesan rich/AI ini tampil di HP penerima **seolah-olah berasal dari asisten AI resmi Meta** (memakai `forwardedAiBotMessageInfo`, `GenAI*` view-model, dll.). Gunakan hanya untuk bot yang memang meniru asisten AI secara transparan — jangan dipakai untuk menyamar, menipu, atau mengelabui pengguna. Demikian pula: library ini adalah klien WhatsApp **tidak resmi**; pakai di nomor cadangan dan sadari risiko pembatasan akun oleh WhatsApp.
+
 ## API tingkat rendah (kompatibel Baileys)
 
 ```js
@@ -372,3 +591,14 @@ Jangan buka issue publik untuk kerentanan. Lihat [SECURITY.md](SECURITY.md).
 MIT — © 2026 Xbibz Developer. Berbasis Baileys, MIT © Rajeh Taher / WhiskeySockets — lihat [LICENSE](LICENSE) dan [LICENSE.upstream](LICENSE.upstream).
 
 WhatsBibz tidak berafiliasi dengan, didukung oleh, atau disokong oleh WhatsApp maupun Meta. Gunakan nomor khusus, patuhi Ketentuan Layanan WhatsApp, dan jangan mengirim pesan yang tidak diminta.
+
+## Dukungan dan komunitas
+
+<p align="center">
+  <a href="https://ko-fi.com/xbibzofficial"><img src="https://img.shields.io/badge/Ko--Fi-Donate-FF5E5B?style=for-the-badge&amp;logo=ko-fi&amp;logoColor=white" alt="Ko-Fi"></a>
+  <a href="https://saweria.co/XbibzOfficial"><img src="https://img.shields.io/badge/Saweria-Support-FFAA00?style=for-the-badge" alt="Saweria"></a>
+  <a href="https://tiktok.com/@xbibzofficial"><img src="https://img.shields.io/badge/TikTok-@xbibzofficial-000000?style=for-the-badge&amp;logo=tiktok&amp;logoColor=white" alt="TikTok"></a>
+  <a href="https://t.me/xbibzofc"><img src="https://img.shields.io/badge/Telegram-@xbibzofc-26A5E4?style=for-the-badge&amp;logo=telegram&amp;logoColor=white" alt="Telegram"></a>
+</p>
+
+[Ko-Fi](https://ko-fi.com/xbibzofficial) · [Saweria](https://saweria.co/XbibzOfficial) · [TikTok](https://tiktok.com/@xbibzofficial) · [Telegram](https://t.me/xbibzofc)

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/gh/XbibzOfficial777/whatsbibz@main/assets/logo/preview.png" alt="WhatsBibz" width="360">
+  <a href="https://www.npmjs.com/package/@xbibzlibrary/whatsbibz"><img src="https://cdn.jsdelivr.net/gh/XbibzOfficial777/whatsbibz@main/assets/logo/preview.webp" alt="WhatsBibz" width="640"></a>
 </p>
 
 <h1 align="center">WhatsBibz</h1>
@@ -18,7 +18,7 @@
 </p>
 
 <p align="center">
-  <b>English</b> · <a href="README.id.md">Bahasa Indonesia</a>
+  <b>English</b> · <a href="README.id.md">Bahasa Indonesia</a> · <a href="README.cn.md">简体中文</a>
 </p>
 
 ---
@@ -39,6 +39,9 @@
   - [Custom mode](#custom-mode)
   - [What WhatsApp accepts](#what-whatsapp-accepts)
 - [Sending and reading messages](#sending-and-reading-messages)
+  - [Text formatting and chat markup](#text-formatting-and-chat-markup)
+  - [Interactive buttons](#interactive-buttons)
+  - [Rich and AI-styled messages](#rich-and-ai-styled-messages)
 - [Low-level API (Baileys-compatible)](#low-level-api-baileys-compatible)
 - [TypeScript](#typescript)
 - [Migrating from Baileys / ourin-baileys](#migrating-from-baileys--ourin-baileys)
@@ -49,10 +52,11 @@
 - [Contributing](#contributing)
 - [Security](#security)
 - [License](#license)
+- [Support & community](#support--community)
 
 ## Why WhatsBibz
 
-WhatsBibz is a full fork of [Baileys](https://github.com/WhiskeySockets/Baileys) v7 (via `ourin-baileys@9.0.21`), patched up to the current upstream `master`, plus a layer that solves the things every bot author ends up rewriting:
+WhatsBibz is a full fork of [Baileys](https://github.com/WhiskeySockets/Baileys) v7 (via `ourin-baileys@9.0.21`), patched up to the current upstream `master`, with a built-in layer that handles the connection, identity and session plumbing:
 
 | Problem | What WhatsBibz does |
 |---|---|
@@ -125,6 +129,7 @@ A runnable example lives in [`example/ping-bot.js`](example/ping-bot.js).
 | `companionPlatformDisplay` | `string \| null` | `null` | Override the `companion_platform_display` sent at pairing. Only set this if you know the value is on WhatsApp's allow-list. |
 | `logger` | `{ info, warn, error, debug, ok }` | console | Any object with those methods (all optional). |
 | `printQR` | `boolean` | `false` | Print the QR as ASCII when a QR is shown (requires `qrcode-terminal`). |
+| `banner` | `boolean` | `auto` | Print the rainbow *"WhatsBibz."* ASCII banner (Small Slant) to the terminal when the client starts. Default prints only in an interactive terminal; `true` forces it, `false` disables it. |
 | `socketConfig` | `Partial<SocketConfig>` | `{}` | Raw `makeWASocket` options merged last — full escape hatch. |
 | `fetchLatestVersion` | `boolean` | `true` | Fetch the current WhatsApp Web version on every connect. The built-in version is never downgraded. |
 | `forceIPv4` | `boolean` | `true` | Force IPv4 for media uploads. |
@@ -279,6 +284,220 @@ import {
 
 The raw `sock.sendMessage(jid, content)` supports everything Baileys does: text, image, video, audio, document, sticker, sticker packs, location, contacts, polls, reactions, edits, deletes, pins, forwards, view-once, interactive buttons, product and event messages, newsletters. Builders `Button`, `Carousel` and `AIRich` are exported.
 
+## Text formatting and chat markup
+
+### 1) Native WhatsApp formatting (raw, no conversion)
+
+`sendText(..., { format: false })` and `sock.sendMessage(jid, { text })` send text **as-is** — WhatsApp renders the markup itself on the recipient's phone:
+
+| You type | Shows in WhatsApp |
+|---|---|
+| `*text*` | **bold** |
+| `_text_` | _italic_ |
+| `~text~` | ~~strikethrough~~ |
+| `` `text` `` | `monospace` |
+| `*_combined_*` / `_*combined*_` | **_bold italic_** |
+| `` ```line\ntext``` `` | monospace code block |
+
+```js
+await sock.sendMessage(jid, { text: '*Hello* _world_ ~everyone~ `code`' });
+// sendText with format:false also passes it through untouched
+await sendText(sock, jid, '*bold* _italic_ ~strike~ `mono`', { format: false });
+```
+
+### 2) Automatic Markdown → WhatsApp conversion
+
+`sendText(..., { format: true })` (default) runs `whatsappify()` so Markdown coming from an LLM looks clean as WhatsApp formatting:
+
+| Markdown source | WhatsApp result |
+|---|---|
+| `**bold**` or `__bold__` | `*bold*` |
+| `***bold-italic***` | `*bold-italic*` |
+| `~~strike~~` | `~strike~` |
+| `_italic_` | `_italic_` (kept — already WhatsApp syntax) |
+| `# / ## / ### …` at line start | removed |
+| `[label](https://url)` | `label (https://url)` |
+| stray `***`/`___` | collapsed to `*`/`_` |
+
+```js
+const llmAnswer = '## Summary\n\n**Weather** today is *clear*, ~~rain~~ has passed.\nSee [forecast](https://bmkg.go.id).';
+await sendText(sock, jid, llmAnswer);           // format: true by default
+// renders as: "Summary" (no #) + *Weather* + _clear_ + ~rain~ + "forecast (https://bmkg.go.id)"
+```
+
+`splitText(text, maxLen)` splits text over 4000 chars (breaks at newlines/spaces, 250 ms pause between parts) — `sendText` does this automatically.
+
+### 3) Mentions & mention-all
+
+```js
+import { pnJid } from '@xbibzlibrary/whatsbibz';
+
+await sock.sendMessage(jid, {
+  text: 'Hi @6281234567890, check this!',
+  mentions: [pnJid('6281234567890')],   // array of JIDs
+});
+await sock.sendMessage(groupJid, {
+  text: 'Attention all members',
+  mentions: [],            // or [jidA, jidB, ...]
+  mentionAll: true,        // highlights the whole chat (broadcast mention)
+});
+```
+
+## Interactive buttons
+
+All modern WhatsApp buttons use the **native flow** format: a button is the markup `{ name, buttonParamsJson }`. WhatsBibz forwards that through `sock.sendMessage(jid, { interactiveMessage: {...} })` or the `ButtonV2` builder.
+
+### Way 1 — Native flow (recommended) via `sendMessage`
+
+```js
+await sock.sendMessage(jid, {
+  interactiveMessage: {
+    title:  'Please pick a menu option below:',   // → message body text
+    footer: 'WhatsBibz Bot',                      // small footer text (optional)
+    header: 'FOOD MENU',                       // big header title (optional)
+    buttons: [
+      { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Food', id: 'food' }) },
+      { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Drinks', id: 'drink' }) },
+      { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Cancel', id: 'cancel' }) },
+    ],
+  },
+});
+```
+
+**Native-flow button markup** (`name` + contents of `buttonParamsJson`):
+
+| `name` | Shows as | `buttonParamsJson` example |
+|---|---|---|
+| `quick_reply` | plain reply button | `{"display_text":"Yes","id":"yes"}` |
+| `single_select` | list dropdown | `{"title":"Pick City","sections":[{...}]}` (see Way 3) |
+| `cta_url` | open-link button | `{"display_text":"Visit","url":"https://…","webview_interaction":false}` |
+| `cta_call` | call button | `{"display_text":"Call","id":"+628…"}` |
+| `cta_copy` | copy button | `{"display_text":"Copy code","copy_code":"ABC123"}` |
+| `cta_reminder` / `cta_cancel_reminder` | set / cancel reminder | `{"display_text":"Remind me","id":"…"}` |
+| `address_message` | request address | `{"display_text":"Send address","id":"…"}` |
+| `send_location` | request location | `{"display_text":"…"}` |
+| `limited_time_offer` | limited-time offer | `{"text":"…","url":"…","copy_code":"…","expiration_time":0}` |
+
+Known keys: `display_text`, `id`, `url`, `copy_code`, `webview_interaction`, `expiration_time`, `sections`, `title`, `rows`. Comfortable limits: up to 3 `quick_reply`, or 1 `single_select` per message.
+
+### Way 2 — `ButtonV2` builder (legacy `buttonsMessage`)
+
+```js
+import { ButtonV2 } from '@xbibzlibrary/whatsbibz';
+
+const btn = new ButtonV2(sock)
+  .text('Pick your answer')         // .title()/.text()/.footer()/.image(url)
+  .footer('WhatsBibz Quiz')
+  .addButton('Very satisfied', 'a')
+  .addButton('Okay', 'b')
+  .addButton('Not great', 'c');
+
+const msg = await btn.send(jid);   // automatically injects the required <biz> node
+// msg.key.id → id of the sent message
+```
+
+### Way 3 — Single-select dropdown list
+
+```js
+await sock.sendMessage(jid, {
+  interactiveMessage: {
+    title: 'Pick a destination city:',
+    buttons: [{
+      name: 'single_select',
+      buttonParamsJson: JSON.stringify({
+        title: 'Cities',
+        sections: [{
+          title: 'Java Island',
+          rows: [
+            { title: 'Jakarta',  description: 'DKI Jakarta', id: 'jkt' },
+            { title: 'Bandung',  description: 'West Java',   id: 'bdg' },
+            { title: 'Surabaya', description: 'East Java',   id: 'sby' },
+          ],
+        }],
+      }),
+    }],
+  },
+});
+```
+
+### Reading button taps (inbound)
+
+When a user taps a button (native flow or legacy), the bot gets a `messages.upsert`; `extractMessage` normalises it to `type: 'button'`:
+
+```js
+sock.ev.on('messages.upsert', async ({ messages, type }) => {
+  if (type !== 'notify') return;
+  for (const m of messages) {
+    if (m.key.fromMe || !m.message) continue;
+    const item = extractMessage(m);           // auto-unwrapped
+    if (item?.type !== 'button') continue;
+
+    console.log('Button pressed:', item.buttonId, '|', item.buttonText);
+    switch (item.buttonId) {
+      case 'food':    return sendText(sock, m.key.remoteJid, 'You picked *Food*', { quoted: m });
+      case 'drink':   return sendText(sock, m.key.remoteJid, 'You picked *Drinks*', { quoted: m });
+      case 'jkt':     return sendText(sock, m.key.remoteJid, 'Destination: *Jakarta*', { quoted: m });
+      case 'cancel':  return sendText(sock, m.key.remoteJid, 'Cancelled');
+    }
+  }
+});
+```
+
+Raw **quick_reply** taps can also be read directly: `m.message.interactiveResponseMessage.nativeFlowResponseMessage` carries `name` (e.g. `quick_reply`) and `paramsJson` — a JSON string like `{"id":"food","text":"Food"}`. Replies from `listResponseMessage`, `buttonsResponseMessage` and `templateButtonReplyMessage` (legacy) are covered by `extractMessage` too.
+
+## Rich and AI-styled messages
+
+WhatsBibz ships a **rich message** builder (the same format as Meta AI replies on WhatsApp: `botForwardedMessage` / `richResponseMessage`) so a bot can show tables, syntax-highlighted code blocks, formatted link lists and follow-up suggestions in one formatted message.
+
+### Built-in socket methods
+
+```js
+// Table
+await sock.sendTable(jid, 'Price List', ['Item', 'Price'], [['Fried rice', 'Rp15k'], ['Iced tea', 'Rp5k']], undefined, { footer: 'valid today' });
+
+// Syntax-highlighted code block
+await sock.sendCodeBlock(jid, 'const x = 1;\nconsole.log(x);', undefined, { language: 'javascript', title: 'JS sample' });
+
+// Formatted link list — links: a URL string or { url, displayName }
+await sock.sendLink(jid, 'Trusted sources:', [
+  { displayName: 'BMKG — Weather & quakes', url: 'https://www.bmkg.go.id' },
+  'https://www.bmkg.go.id/cuaca',
+], undefined);
+
+// Full rich message from raw submessages
+await sock.sendRichMessage(jid, [
+  { messageType: 2, messageText: 'Hello from a rich message' },
+  { messageType: 4, tableMetadata: { title: 'Score', rows: [{ items: ['A', '1'], isHeading: true }] } },
+], undefined);
+```
+
+Other methods: `sendTableV2`, `sendList`, `sendCodeBlockV2`, `sendLinkV2`, `sendLatex`, `sendLatexImage`, `sendUnifiedResponse`, `captureUnifiedResponse` (see `Socket/messages-send.js`).
+
+### `AIRich` fluent builder
+
+```js
+import { AIRich } from '@xbibzlibrary/whatsbibz';
+
+const rich = new AIRich(sock)
+  .addText('Here is today\'s weather summary for **Jakarta**:')
+  .addTable([
+    ['Time',   'Weather',  'Temp'],
+    ['Morning','Clear',    '26°C'],
+    ['Noon',   'Cloudy',   '32°C'],
+    ['Evening','Rain',     '28°C'],
+  ])
+  .addCode('javascript', `async function weather(city) {\n  return await fetch('https://api/weather?q=' + city);\n}`)
+  .addSuggest(['What is the weather tomorrow?', 'Weekly forecast']);
+
+await rich.send(jid, { forwarded: true, includesUnifiedResponse: true });
+```
+
+Chainable `AIRich` methods: `addText(text)`, `addTable(array2dOfStrings)`, `addCode(lang, code)`, `addSource([[icon, url, text], ...])`, `addImage(url/buffer | array)`, `addVideo(...)`, `addProduct({...}|[...])`, `addPost(...)`, `addReels(...)`, `addTip(text)`, `addSuggest(string | string[])`, `addSubmessage(...)`, `addSection(...)`. `send(jid, { forwarded, notification, includesUnifiedResponse, includesSubmessages })` — options default to `true` except `notification` (`false`). `ORich` is an alias of `AIRich`; statics: `AIRich.tokenizer(code, lang)`, `AIRich.toTableMetadata(arr)`, `AIRich.newLayout(...)`.
+
+### Ethical usage note
+
+These rich/AI messages render on the recipient's phone **as if they came from Meta's official AI assistant** (they reuse `forwardedAiBotMessageInfo`, `GenAI*` view models, etc.). Use them only for bots that transparently mimic an AI assistant — never for impersonation, deception or tricking users. Likewise, this is an **unofficial** WhatsApp client; run it on a spare number and accept the risk of WhatsApp restricting the account.
+
 ## Low-level API (Baileys-compatible)
 
 ```js
@@ -372,3 +591,14 @@ Do not open public issues for vulnerabilities. See [SECURITY.md](SECURITY.md).
 MIT — © 2026 Xbibz Developer. Based on Baileys, MIT © Rajeh Taher / WhiskeySockets — see [LICENSE](LICENSE) and [LICENSE.upstream](LICENSE.upstream).
 
 WhatsBibz is not affiliated with, endorsed by, or supported by WhatsApp or Meta. Use a dedicated number, respect WhatsApp's Terms of Service and do not send unsolicited messages.
+
+## Support & community
+
+<p align="center">
+  <a href="https://ko-fi.com/xbibzofficial"><img src="https://img.shields.io/badge/Ko--Fi-Donate-FF5E5B?style=for-the-badge&amp;logo=ko-fi&amp;logoColor=white" alt="Ko-Fi"></a>
+  <a href="https://saweria.co/XbibzOfficial"><img src="https://img.shields.io/badge/Saweria-Support-FFAA00?style=for-the-badge" alt="Saweria"></a>
+  <a href="https://tiktok.com/@xbibzofficial"><img src="https://img.shields.io/badge/TikTok-@xbibzofficial-000000?style=for-the-badge&amp;logo=tiktok&amp;logoColor=white" alt="TikTok"></a>
+  <a href="https://t.me/xbibzofc"><img src="https://img.shields.io/badge/Telegram-@xbibzofc-26A5E4?style=for-the-badge&amp;logo=telegram&amp;logoColor=white" alt="Telegram"></a>
+</p>
+
+[Ko-Fi](https://ko-fi.com/xbibzofficial) · [Saweria](https://saweria.co/XbibzOfficial) · [TikTok](https://tiktok.com/@xbibzofficial) · [Telegram](https://t.me/xbibzofc)

package/assets/logo/README.md

@@ -1,21 +1,19 @@
 # Logo WhatsBibz
 
-Gelembung pesan hijau (`#0a6958`) dengan buku terbuka di dalamnya, wordmark **WhatsBib'S** dan
-tagline *WHATSAPP LIBRARY*. Sumber utamanya adalah `preview-2048.png` (raster 2048×2048, dari
-pemilik proyek); semua berkas lain diturunkan dari situ.
+Logo utama (banner/logo lebar 1672×940) diberikan oleh pemilik proyek sebagai WebP
+dan disimpan sebagai `preview.webp`; turunan PNG-nya ada di `preview.png`.
+Keduanya dipakai untuk README dan halaman npm.
 
 | Berkas | Pakai untuk |
 |---|---|
-| `preview.png` | lockup lengkap 1024×1024 — README, halaman npm, dokumen |
-| `preview-2048.png` | master resolusi penuh (tidak ikut dipublish ke npm) |
-| `png/logo-1600.png`, `png/logo-800.png` | lockup dipangkas rapi (tanpa margin besar) |
-| `png/mark-1024.png`, `png/mark-512.png` | gelembung saja, **latar transparan** — avatar, watermark |
-| `png/icon-{16…1024}.png` | ikon persegi sudut membulat (tile putih + gelembung) — avatar npm/GitHub, app icon |
+| `preview.webp` | master asli (WebP 1672×940) — README, halaman npm |
+| `preview.png` | versi PNG `preview.webp` (1080×607) |
+| `preview-2048.png` | master persegi 2048×2048 dari rebrand sebelumnya (arsip) |
+| `png/logo-1600.png`, `png/logo-800.png` | lockup lama yang dipangkas rapi |
+| `png/mark-1024.png`, `png/mark-512.png` | gelembung saja, latar transparan — avatar, watermark |
+| `png/icon-{16…1024}.png` | ikon persegi sudut membulat — avatar npm/GitHub, app icon |
 | `png/banner-1200x360.png` | banner README/sosial |
 | `whatsbibz.ico` | favicon multi-ukuran 16–256 |
 
-Warna: hijau utama `#0a6958`, teks `#2b2e33`, latar putih. Ruang kosong minimal di sekeliling
-lockup = tinggi huruf **B**. Jangan dimiringkan, diberi outline, atau diganti fontnya.
-
-Regenerasi turunan (mark transparan, ikon, ICO, banner) dari master: skrip yang dipakai ada di
-riwayat proyek (`scripts/` tidak menyertakannya karena hanya dijalankan sekali saat rebrand).
+Ikon, mark, banner, dan favicon masih turunan dari lockup persegi versi lama.
+Setelah versi final disepakati, turunan tersebut perlu diregenerasi dari `preview.webp`.

package/lib/BibzWhats/banner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Banner ASCII "WhatsBibz." yang dicetak saat client dibuat.
+ * Huruf: "Small Slant" (figlet). Warna: filter pelangi (Rainbow 2).
+ */
+
+export const BANNER_FONT: string;
+export const BANNER_FILTER: string;
+
+/** Banner polos tanpa kode warna ANSI (4 baris, tanpa newline tambahan). */
+export const BANNER_TEXT: string;
+
+export interface BannerRenderOptions {
+    /** true = selalu berwarna, false = polos, 'auto' (default) = ikuti terminal. */
+    color?: boolean | 'auto';
+    /** Berapa kali spektrum pelangi diulang sepanjang lebar banner (default 1). */
+    cycles?: number;
+    /** Environment untuk deteksi warna (default process.env). */
+    env?: NodeJS.ProcessEnv;
+    /** Stream untuk deteksi TTY (default process.stdout). */
+    stream?: unknown;
+}
+
+export function colorEnabled(opts?: { env?: NodeJS.ProcessEnv; stream?: unknown }): boolean;
+
+/** Render banner menjadi string siap cetak (tanpa newline tambahan). */
+export function renderBanner(options?: BannerRenderOptions): string;
+
+/** Cetak banner ke terminal. */
+export function printBanner(
+    options?: BannerRenderOptions & { write?: (chunk: string) => void },
+): boolean;