@pontalabs/baileys 1.2.6 → 1.2.7

package/README.md

@@ -1,60 +1,41 @@
-<img src="https://capsule-render.vercel.app/api?type=waving&color=0:0f0c29,50:302b63,100:24243e&height=220&section=header&text=Baileys%20PontaLabs&fontSize=52&fontColor=ffffff&animation=fadeIn&fontAlignY=38&desc=⚡%20AI%20Rich%20Messages%20•%20High%20Performance%20•%20Advanced%20Features&descAlignY=58&descSize=16" width="100%"/>
-
 <div align="center">
 
-<!-- Animated Banner with Glow -->
-<a href="https://github.com/PontaSja">
-  <img src="https://raw.githubusercontent.com/PontaSja/image/408b34d9d8521dd22688a24d6b28db3f8ab1825a/IMG-20260710-WA0070.jpg" alt="PontaSockets Banner" width="720" style="border-radius: 18px; box-shadow: 0 0 40px rgba(0,217,255,0.4), 0 0 80px rgba(124,58,237,0.3);" />
-</a>
+<!-- Logo Banner -->
+<img src="https://raw.githubusercontent.com/PontaSja/image/408b34d9d8521dd22688a24d6b28db3f8ab1825a/IMG-20260710-WA0070.jpg" alt="PontaSockets Banner" width="720" style="border-radius: 12px;" />
 
 <br><br>
 
-<!-- Typing Animation -->
-<a href="https://git.io/typing-svg">
-  <img src="https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=700&size=24&duration=3000&pause=1000&color=00D9FF&center=true&vCenter=true&width=800&height=50&lines=Extended+from+%40whiskeysockets%2Fbaileys;🚀+Packed+with+Exclusive+Patches+%26+AI+Features;💬+Rich+Messages+%7C+Newsletter+%7C+Groups;⚡+Built+for+Speed%2C+Stability+%26+Scale" alt="Typing Animation" />
-</a>
+<!-- Welcome Text -->
+<h2>
+  <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Hand%20gestures/Waving%20Hand.png" alt="Waving Hand" width="35" style="vertical-align: middle; margin-right: 8px;" />
+  Selamat Datang di Baileys PontaLabs
+</h2>
 
 <br>
 
-<!-- Animated Badges -->
-<p>
-  <a href="https://www.npmjs.com/package/@pontalabs/baileys">
-    <img src="https://img.shields.io/npm/v/@pontalabs/baileys?style=for-the-badge&color=cb3837&label=npm&logo=npm&logoColor=white" alt="NPM Version" />
-  </a>
-  <a href="https://nodejs.org">
-    <img src="https://img.shields.io/badge/node-%3E%3D18.x-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js" />
-  </a>
-  <a href="./LICENSE">
-    <img src="https://img.shields.io/badge/license-Non--Commercial-orange?style=for-the-badge" alt="License" />
-  </a>
-  <a href="https://github.com/WhiskeySockets/Baileys">
-    <img src="https://img.shields.io/badge/fork-whiskeysockets%2Fbaileys-6e5494?style=for-the-badge&logo=github" alt="Fork" />
-  </a>
-</p>
-
-<!-- Animated Stats / Divider -->
-<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%" />
-
-<p><em>Extended from <code>@whiskeysockets/baileys</code> — packed with exclusive patches, AI-rich messages, and advanced WhatsApp features.</em></p>
-
-<!-- Visitor + Animated Wave -->
-<img src="https://komarev.com/ghpvc/?username=PontaSja&label=Views&color=00D9FF&style=for-the-badge" alt="Views" />
-<img src="https://img.shields.io/github/stars/PontaSja/baileys?color=FFD700&style=for-the-badge&logo=github" alt="Stars" />
-
-</div>
-
-<br>
+<!-- Badges -->
+<a href="https://www.npmjs.com/package/@pontalabs/baileys">
+  <img src="https://img.shields.io/npm/v/@pontalabs/baileys?style=flat-square&amp;color=cb3837&amp;label=npm&amp;logo=npm" alt="NPM Version" />
+</a>
+<a href="https://nodejs.org">
+  <img src="https://img.shields.io/badge/node-%3E%3D18.x-339933?style=flat-square&amp;logo=node.js&amp;logoColor=white" alt="Node.js" />
+</a>
+<a href="./LICENSE">
+  <img src="https://img.shields.io/badge/license-Non--Commercial-orange?style=flat-square" alt="License" />
+</a>
+<a href="https://github.com/WhiskeySockets/Baileys">
+  <img src="https://img.shields.io/badge/fork-whiskeysockets%2Fbaileys-blue?style=flat-square&amp;logo=github" alt="Fork" />
+</a>
 
-<div align="center">
+<br><br>
 
-### ⚡ Quick Navigation ⚡
-`Installation` • `Quick Start` • `Rich Messages` • `Newsletter` • `Groups`
+<p><em>Extended from <code>@whiskeysockets/baileys</code> — packed with exclusive patches, AI-rich messages, and advanced WhatsApp features.</em></p>
 
 </div>
 
 ---
 
-## <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Bookmark.png" width="30" /> Table of Contents
+## 📑 Table of Contents
 
 - [Why This Fork?](#-why-this-fork)
 - [Features](#-features)
@@ -75,20 +56,8 @@
 
 ---
 
-<div align="center">
-  <img src="https://raw.githubusercontent.com/platane/snk/output/github-contribution-grid-snake-dark.svg" alt="Snake animation" width="100%"/>
-</div>
-
----
-
 <details>
-<summary><h2>📥 Installation <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Inbox%20Tray.png" width="28" /></h2></summary>
-
-<br>
-
-<div align="center">
-  <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=18&pause=1000&color=00D9FF&center=true&width=600&lines=npm+install+%40pontalabs%2Fbaileys" alt="install" />
-</div>
+<summary><h2>📥 Installation</h2></summary>
 
 ```bash
 # npm
@@ -96,12 +65,6 @@ npm install @pontalabs/baileys
 
 # yarn
 yarn add @pontalabs/baileys
-
-# pnpm
-pnpm add @pontalabs/baileys
-
-# bun
-bun add @pontalabs/baileys
 ```
 
 </details>
@@ -109,9 +72,7 @@ bun add @pontalabs/baileys
 ---
 
 <details>
-<summary><h2>🚀 Quick Start <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Travel%20and%20places/Rocket.png" width="28" /></h2></summary>
-
-<br>
+<summary><h2>🚀 Quick Start</h2></summary>
 
 ```js
 import makeWASocket, { useMultiFileAuthState } from '@pontalabs/baileys'
@@ -134,15 +95,13 @@ async function start() {
 start()
 ```
 
-> <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Symbols/Bubbles.png" width="20" /> **Tip:** Gunakan `printQRInTerminal: true` untuk scan QR langsung di terminal!
-
 </details>
 
 ---
 
 ## 📖 Documentation
 
-### <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Electric%20Plug.png" width="25" /> Connecting
+### 🔌 Connecting
 
 <details>
 <summary><b>🔗 QR Code</b></summary>
@@ -298,126 +257,471 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   location: {
     degreesLatitude: 37.422,
-    degreesLongitude: -122.084
+    degreesLongitude: -122.084,
+    name: 'Google HQ'
   }
 })
 ```
 </details>
 
 <details>
-<summary><b>📄 Document</b></summary>
+<summary><b>💥 React</b></summary>
 
 ```js
-await sock.sendMessage(jid, {
-  document: fs.readFileSync('file.pdf'),
-  mimetype: 'application/pdf',
-  fileName: 'myfile.pdf'
-})
+await sock.sendMessage(jid, { react: { text: '👍', key: message.key } })
+// Remove reaction
+await sock.sendMessage(jid, { react: { text: '', key: message.key } })
 ```
 </details>
 
 <details>
-<summary><b>😆 Reaction</b></summary>
+<summary><b>📊 Poll</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  react: {
-    text: '🔥',
-    key: message.key
+  poll: {
+    name: 'Pilih salah satu',
+    values: ['Opsi A', 'Opsi B', 'Opsi C'],
+    selectableCount: 1  // 0 = boleh pilih banyak
+  }
+})
+
+// Poll dengan fitur tambahan
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Nama Poll',
+    values: ['Opsi A', 'Opsi B'],
+    selectableCount: 1,
+    endDate: new Date('2025-12-31'),
+    hideVoter: true,
+    canAddOption: false,
+    toAnnouncementGroup: false
+  }
+})
+
+// Quiz (Poll dengan jawaban benar)
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Ibu kota Indonesia?',
+    values: ['Jakarta', 'Surabaya', 'Bandung'],
+    selectableCount: 1,
+    pollType: 1,           // 1 = QUIZ
+    correctAnswer: 'Jakarta'
   }
 })
 ```
 </details>
 
 <details>
-<summary><b>📊 Poll</b></summary>
+<summary><b>📸 Album</b></summary>
+
+```js
+await sock.sendAlbumMessage(jid, [
+  { image: { url: 'https://example.com/1.jpg' }, caption: 'First' },
+  { video: { url: 'https://example.com/clip.mp4' }, caption: 'Second' }
+], { quoted: message, delay: 3000 })
+```
+</details>
+
+<details>
+<summary><b>📆 Event</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  poll: {
-    name: 'Favorite Programming Language?',
-    values: ['JavaScript', 'Python', 'Go'],
-    selectableCount: 1
+  event: {
+    name: 'Nama Acara',
+    description: 'Deskripsi',
+    startDate: new Date('2026-12-01T10:00:00'),
+    endDate: new Date('2026-12-01T12:00:00'),
+    location: {
+      degreesLatitude: -6.2088,
+      degreesLongitude: 106.8456,
+      name: 'Monas, Jakarta'
+    },
+    extraGuestsAllowed: true
+  }
+})
+
+// Event dengan scheduled call
+await sock.sendMessage(jid, {
+  event: {
+    name: 'Meeting Online',
+    startDate: new Date('2026-12-01T10:00:00'),
+    call: 'audio',   // 'audio' | 'video'
+    isScheduleCall: true
   }
 })
 ```
 </details>
 
----
+<details>
+<summary><b>👨‍💻 Interactive (Native Flow & Carousel)</b></summary>
 
-### <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Activities/Sparkles.png" width="25" /> Rich Messages
+```js
+// Native Flow
+await sock.sendMessage(jid, {
+  text: 'Choose an option:',
+  title: 'Title',
+  footer: '© PontaLabs Baileys',
+  interactive: [{
+    name: 'quick_reply',
+    buttonParamsJson: JSON.stringify({ display_text: 'Quick Reply', id: '123' })
+  }]
+})
 
-> <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Light%20Bulb.png" width="20" /> Semua fitur **Rich Message** dikirim melalui `sock.sendMessage()` dan dirender sebagai AI bot message di WhatsApp.
->
-> **Tidak ada daftar `build.*` terpisah.** Builder, shortcut lama, `items`, `richResponse`, HTML WebView, interactive builder, dan opsi terkait semuanya didokumentasikan di bagian ini supaya API Rich tetap berada di satu tempat.
+// Carousel
+await sock.sendMessage(jid, {
+  text: 'Check out our collection!',
+  title: 'Catalog',
+  footer: '© PontaLabs Baileys',
+  cards: [{
+    image: { url: 'https://example.com/image.jpg' },
+    title: 'Product Name',
+    body: 'Product description',
+    footer: '© PontaLabs',
+    buttons: [{
+      name: 'quick_reply',
+      buttonParamsJson: JSON.stringify({ display_text: 'Select', id: '1' })
+    }]
+  }]
+})
+```
+</details>
+
+<details>
+<summary><b>🤖 listMessage</b></summary>
+
+```js
+sock.sendMessage(jid, {
+  text: "Halo kak, pilih menu dibawah ya",
+  footer: "@PontaLabs",
+  title: "Menu Utama",
+  buttonText: "Buka Menu",
+  sections: [
+    {
+      title: "Menu",
+      rows: [
+        {
+          title: "Info Bot",
+          description: "Cek info bot",
+          rowId: ".info"
+        },
+        {
+          title: "Owner",
+          description: "Hubungi owner",
+          rowId: ".owner"
+        },
+        {
+          title: "Donasi",
+          description: "Donasi seikhlasnya",
+          rowId: ".donasi"
+        }
+      ]
+    }
+  ]
+}, { quoted: message })
+```
+</details>
 
 <details>
-<summary><b>📌 Quick Start — Rich Message <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Symbols/Double%20Exclamation%20Mark.png" width="20" /></b></summary>
+<summary><b>🔩 Raw / Legacy Buttons</b></summary>
+
+> Varian tombol raw/proto WhatsApp mentah — lebih fleksibel, tapi kamu yang susun strukturnya sendiri.
+
+#### `buttonsMessage`
+
+Kirim objek `buttonsMessage` proto WhatsApp mentah — thumbnail lokasi di dalamnya otomatis diproses kalau berupa Buffer/URL/path.
 
 ```js
 await sock.sendMessage(jid, {
-  richText: 'Halo! 👋'
+  buttonsMessage: {
+    contentText: 'Pilih salah satu:',
+    footerText: '© PontaCT',
+    buttons: [
+      { buttonId: 'a', buttonText: { displayText: 'Opsi A' }, type: 1 },
+      { buttonId: 'b', buttonText: { displayText: 'Opsi B' }, type: 1 }
+    ]
+  }
 }, { quoted: message })
 ```
 
-Builder `build.*` hanya membuat payload. Pengiriman tetap melalui `sock.sendMessage()`:
+#### `templateButtons`
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richText('Halo! 👋'),
-    build.richTip('Dikirim dari PontaLabs')
+  text: 'Butuh bantuan?',
+  footer: '© PontaCT',
+  templateButtons: [
+    { index: 1, urlButton: { displayText: 'Kunjungi Website', url: 'https://example.com' } },
+    { index: 2, callButton: { displayText: 'Telepon', phoneNumber: '+6281234567890' } }
   ]
+}, { quoted: message })
+```
+
+#### `interactiveButtons`
+
+```js
+await sock.sendMessage(jid, {
+  title: 'Menu Utama',
+  subtitle: 'Silakan pilih',
+  text: 'Ada yang bisa dibantu?',
+  footer: '© PontaCT',
+  interactiveButtons: [
+    { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Mulai', id: 'start' }) }
+  ]
+}, { quoted: message })
+```
+
+</details>
+
+<details>
+<summary><b>📌 Pin & Keep</b></summary>
+
+```js
+// Pin — 24h = 86400 · 7d = 604800 · 30d = 2592000
+await sock.sendMessage(jid, { pin: { type: 1, time: 86400, key: message.key } })
+
+// Keep
+await sock.sendMessage(jid, { keep: { key: message.key, type: 1 } })
+```
+</details>
+
+---
+
+### 📍 Location + Buttons
+
+> Location message with native list menu (`single_select`) and extra buttons — all in one `buttonsMessage`.
+
+<details>
+<summary><b>Location + List Menu</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  buttonLocation: {
+    latitude: -6.2088,
+    longitude: 106.8456,
+    name: 'Kantor Pusat PontaCT',
+    address: 'Jl. Sudirman No. 1, Jakarta Pusat',
+    text: 'Temukan kami di sini:',
+    footer: '© PontaCT',
+    thumbnail: 'https://example.com/map-preview.jpg',
+    listButtonText: 'Pilih Layanan',
+    listSectionTitle: 'Layanan Tersedia',
+    listMenu: [
+      { title: 'Customer Service', description: 'Lantai 1, Senin–Jumat 08.00–17.00', id: 'cs' },
+      { title: 'Kasir & Pembayaran', description: 'Lantai 2, buka setiap hari', id: 'kasir' },
+      { title: 'Gudang & Pengiriman', description: 'Gedung B, pintu belakang', id: 'gudang' }
+    ]
+  }
 })
 ```
+</details>
 
-> `build` tersedia dari package dan tidak membutuhkan `sock` saat membuat payload.
+<details>
+<summary><b>Location + Extra Buttons</b></summary>
 
+```js
+await sock.sendMessage(jid, {
+  buttonLocation: {
+    latitude: -6.2088,
+    longitude: 106.8456,
+    name: 'Toko PontaCT',
+    address: 'Jl. Kebon Sirih No. 10, Jakarta',
+    text: 'Kunjungi toko kami!',
+    footer: '© PontaCT',
+    thumbnail: 'https://example.com/store.jpg',
+    extraButtons: [
+      { id: 'call', displayText: '📞 Hubungi Kami' },
+      { id: 'whatsapp', displayText: '💬 WhatsApp' },
+      { id: 'maps', displayText: '🗺️ Buka di Maps' }
+    ]
+  }
+})
+```
 </details>
 
 <details>
-<summary><b>📝 Rich Text — <code>richText</code></b></summary>
+<summary><b>Location + List Menu + Extra Buttons</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  buttonLocation: {
+    latitude: -6.2088,
+    longitude: 106.8456,
+    name: 'Plaza PontaCT',
+    address: 'Jl. MH Thamrin No. 5, Jakarta',
+    text: 'Selamat datang di pusat layanan kami.',
+    footer: 'Buka setiap hari 09.00–21.00',
+    thumbnail: 'https://example.com/plaza.jpg',
+    listButtonText: 'Pilih Tujuan',
+    listSectionTitle: 'Area Tersedia',
+    listMenu: [
+      { title: 'Food Court', description: 'Lt. 1 — lebih dari 30 tenant', id: 'food' },
+      { title: 'Cinema', description: 'Lt. 4 — 8 studio', id: 'cinema' },
+      { title: 'Customer Care', description: 'Lt. 2 — sebelah eskalator', id: 'care' }
+    ],
+    extraButtons: [
+      { id: 'navigate', displayText: '🧭 Navigasi' },
+      { id: 'promo', displayText: '🎁 Promo Hari Ini' }
+    ]
+  }
+})
+```
+</details>
 
-Rich markdown text yang dirender sebagai `GenAIMarkdownTextUXPrimitive`.
+<details>
+<summary><b>📋 Fields Reference</b></summary>
 
-**Direct:**
+| Field | Type | Required | Default | Description |
+|:---|:---|:---:|:---|:---|
+| `latitude` | `number` | — | `0` | Latitude coordinate |
+| `longitude` | `number` | — | `0` | Longitude coordinate |
+| `name` | `string` | — | `'Location'` | Place name |
+| `address` | `string` | — | `''` | Text address |
+| `text` | `string` | — | `''` | Message body text |
+| `footer` | `string` | — | `''` | Footer text |
+| `thumbnail` | `Buffer / URL / path` | ✅ | — | Map preview image |
+| `listButtonText` | `string` | — | `'Pilih Menu'` | List button label |
+| `listSectionTitle` | `string` | — | `'Pilihan'` | List section title |
+| `listMenu` | `array` | — | — | Menu rows |
+| `extraButtons` | `array` | — | — | Extra buttons |
+
+</details>
+
+---
+
+### 📦 Order Status
+
+> Interactive order tracking card using native `order_status` flow button.
+
+<details>
+<summary><b>Basic Order Status</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richText: '*Halo!* Ini rich text dari bot.\nStatus: `success`\nWaktu: _120ms_'
-}, { quoted: message })
+  orderStatus: {
+    image: 'https://example.com/order-banner.jpg',
+    title: 'Status Pesanan',
+    text: 'Pesanan kamu sedang diproses oleh penjual.',
+    referenceId: 'ORD-20250629-001',
+    status: 'PROCESSING',
+    currency: 'IDR'
+  }
+})
 ```
+</details>
 
-**Array / beberapa paragraf:**
+<details>
+<summary><b>Full Order Status with Total & Tax</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richText: [
-    'Baris pertama.',
-    'Baris kedua.',
-    'Baris ketiga.'
-  ]
-}, { quoted: message })
+  orderStatus: {
+    image: 'https://example.com/order.jpg',
+    title: 'Update Pesanan #ORD-2025-001',
+    text: 'Pesananmu sedang dalam perjalanan! 🚚',
+    footer: 'Estimasi tiba: 2–3 hari kerja',
+    referenceId: 'ORD-2025-001',
+    status: 'SHIPPED',
+    subtotalValue: 15000000,
+    subtotalOffset: 100,
+    taxValue: 1500000,
+    taxOffset: 100,
+    currency: 'IDR'
+  }
+})
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Local Image File</b></summary>
 
 ```js
+const fs = require('fs')
 await sock.sendMessage(jid, {
-  items: [
-    build.richText('Halo! 👋')
-  ]
+  orderStatus: {
+    image: fs.readFileSync('./assets/order-confirm.jpg'),
+    title: 'Pesanan Dikonfirmasi ✅',
+    text: 'Terima kasih telah berbelanja!',
+    referenceId: 'ORD-LOCAL-001',
+    status: 'PROCESSING',
+    currency: 'IDR'
+  }
 })
 ```
+</details>
+
+<details>
+<summary><b>📋 Fields Reference</b></summary>
+
+| Field | Type | Required | Default | Description |
+|:---|:---|:---:|:---|:---|
+| `image` | `Buffer / URL / path` | ✅ | — | Header card image |
+| `title` | `string` | — | `'Order Status'` | Header title |
+| `text` | `string` | — | `'Silakan cek status pesanan Anda.'` | Body text |
+| `footer` | `string` | — | `'Powered by PontaCT'` | Footer text |
+| `referenceId` | `string` | — | `'PT-001'` | Order reference ID |
+| `status` | `string` | — | `'PROCESSING'` | Order status |
+| `subtotalValue` | `number` | — | `0` | Subtotal value (in offset units) |
+| `subtotalOffset` | `number` | — | `100` | Value divider |
+| `taxValue` | `number` | — | `0` | Tax value |
+| `taxOffset` | `number` | — | `100` | Tax divider |
+| `currency` | `string` | — | `'IDR'` | Currency code |
+
+> **Status values:** `PROCESSING` · `SHIPPED` · `DELIVERED` · `CANCELLED` · `REFUNDED`
 
 </details>
 
+---
+
+### 🤖 Rich Messages
+
+> All rich messages are sent via standard `sendMessage` and rendered as AI bot messages in WhatsApp. Use the appropriate key instead of `text`, `image`, `video`, etc.
+
+**Quick jump:** [Rich Text](#rich-text) · [Code](#rich-code-block) · [Table](#rich-table) · [Images](#rich-images) · [Video](#rich-video) · [Suggestions](#rich-suggestions) · [LaTeX](#rich-latex) · [Product](#rich-product) · [Post](#rich-post) · [Reels](#rich-reels) · [Sources](#rich-sources) · [Tip & Footer](#rich-tip--footer) · [Mixed](#rich-mixed) · [Response](#rich-response)
+
+---
+
+#### 📝 Rich Text
+
+> AI bot-styled markdown text rendered in `richResponseMessage`.
+
 <details>
-<summary><b>🌐 Rich HTML WebView — <code>richHtml</code></b></summary>
+<summary><b>Simple Text</b></summary>
+
+```js
+await sock.sendMessage(jid, { richText: 'Halo! Ini pesan dari bot.' }, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Markdown (bold, italic, inline code)</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richText: '*Hasil eksekusi:*\nStatus: `success`\nWaktu: _120ms_'
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Multiple Paragraphs (Array)</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richText: ['Baris pertama.', 'Baris kedua.', 'Baris ketiga.']
+}, { quoted: message })
+```
+</details>
 
-Mengirim HTML langsung ke primitive `GenAIaeacdsnwHtmlPrimitive`.
+---
+
+#### 📝 Rich Html
 
-**Direct `sendMessage`:**
+> AI html rendered in `GenAIaeacdsnwHtmlPrimitive`.
+
+<details>
+<summary><b>Simple Html</b></summary>
 
 ```js
 const html = `<!DOCTYPE html>
@@ -437,91 +741,67 @@ await sock.sendMessage(jid, {
   richHtml: html
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
-
-```js
-await sock.sendMessage(jid, {
-  items: [
-    build.richHtml(html)
-  ]
-})
-```
-
-**Raw item:**
-
-```js
-await sock.sendMessage(jid, {
-  items: [
-    { html: html }
-  ]
-})
-```
+---
 
-> HTML berjalan di sisi client/webview. Gunakan HTML/JavaScript yang kamu kontrol dan sesuaikan dengan dukungan client WhatsApp yang dituju.
+#### 💻 Rich Code Block
 
-</details>
+> Syntax-highlighted code. Use `code` for single block, `codes` for multiple.
 
 <details>
-<summary><b>👤 Rich Card — <code>richCard</code></b></summary>
-
-Entity card / profile preview yang dirender sebagai AI message. Cocok untuk menampilkan kontak, channel, atau brand profile tanpa perlu builder terpisah.
-
-**Direct `sendMessage`:**
+<summary><b>Single Block</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richCard: {
-    thumbnail_url: 'https://example.com/profile.jpg',
-    verification: true,
-    title: 'PontaLabs',
-    subtitle: 'Official Channel',
-    description: 'WhatsApp Bot Framework by PontaLabs',
-    entity_id: '62123456789',
-    entity_url: 'https://wa.me/62123456789',
-    profile_url: 'https://example.com/profile.jpg'
-  }
+  code: 'console.log("Hello World")',
+  language: 'javascript'
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Multiple Blocks</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richCard({
-      thumbnail_url: 'https://example.com/profile.jpg',
-      verification: true,
-      title: 'PontaLabs',
-      subtitle: 'Official Channel',
-      description: 'WhatsApp Bot Framework by PontaLabs',
-      entity_id: '62123456789',
-      entity_url: 'https://wa.me/62123456789',
-      profile_url: 'https://example.com/profile.jpg'
-    })
+  codes: [
+    { code: 'SELECT * FROM users WHERE id = 1;', language: 'sql' },
+    { code: '{ "id": 1, "name": "Ponta", "role": "admin" }', language: 'json' }
   ]
-})
+}, { quoted: message })
 ```
+</details>
 
-| Property | Type | Required | Description |
-|:---|:---|:---:|:---|
-| `thumbnail_url` | `string` | — | URL thumbnail publik untuk card |
-| `verification` | `boolean` | — | Menampilkan badge verified |
-| `title` | `string` | ✅ | Judul utama entity |
-| `subtitle` | `string` | — | Subjudul / role / tagline |
-| `description` | `string` | — | Deskripsi singkat entity |
-| `entity_id` | `string` | ✅ | ID / nomor WhatsApp entity |
-| `entity_url` | `string` | — | URL tujuan saat card diklik |
-| `profile_url` | `string` | — | Fallback URL untuk avatar / profile |
+<details>
+<summary><b>Supported Languages</b></summary>
 
-> Gunakan URL thumbnail yang valid dan dapat diakses publik. `entity_id` harus dalam format nomor internasional tanpa `+`.
+| Language | Key |
+|:---|:---|
+| JavaScript | `javascript` · `js` |
+| TypeScript | `typescript` · `ts` |
+| Python | `python` · `py` |
+| Bash / Shell | `bash` · `sh` · `zsh` |
+| Go | `go` · `golang` |
+| Rust | `rust` · `rs` |
+| C / C++ | `c` · `h` · `cpp` · `c++` |
+| C# | `csharp` · `cs` |
+| CSS / HTML | `css` · `html` |
+| PowerShell / CMD | `powershell` · `ps1` · `cmd` · `bat` |
+| SQL / JSON | `sql` · `json` |
 
 </details>
 
-<details>
-<summary><b>📊 Rich Table — <code>table</code> / <code>richTable</code></b></summary>
+---
+
+#### 📊 Rich Table
 
-**Top-level:**
+> Structured table with `title`, `headers`, and `rows`.
+>
+> ⚠️ Shorthand `{ title?, headers?, rows }` ini hanya berlaku untuk key `table` top-level dan di dalam `items`. Kalau dipakai di dalam `richResponse`, isi `table` harus sudah berupa array baris jadi — lihat [Rich Response](#-rich-response--richresponse).
+
+<details>
+<summary><b>Simple Table</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
@@ -536,37 +816,57 @@ await sock.sendMessage(jid, {
   }
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Table without Title</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richTable([
-      ['Name', 'Role'],
-      ['Ponta', 'Admin'],
-      ['Yue', 'Member']
-    ])
-  ]
-})
+  table: {
+    headers: ['Command', 'Description'],
+    rows: [
+      ['.ping', 'Cek latency bot'],
+      ['.info', 'Info bot'],
+      ['.help', 'List semua command']
+    ]
+  }
+}, { quoted: message })
 ```
-
-> Untuk `richResponse`, format `table` berbeda: gunakan array baris siap-pakai seperti `{ items: [...], isHeading }`, bukan `{ headers, rows }`.
-
 </details>
 
 <details>
-<summary><b>🖼️ Rich Images — <code>richImages</code> / <code>richImage</code></b></summary>
-
-**Single image:**
+<summary><b>Data Only (no header)</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richImages: 'https://example.com/photo.jpg'
+  table: {
+    rows: [
+      ['RAM', '512 MB'],
+      ['CPU', '4 Core'],
+      ['Uptime', '99.9%']
+    ]
+  }
 }, { quoted: message })
 ```
+</details>
 
-**Multiple images:**
+---
+
+#### 🖼️ Rich Images
+
+> AI image grid. Single URL = single image, multiple URLs = carousel.
+
+<details>
+<summary><b>Single Image</b></summary>
+
+```js
+await sock.sendMessage(jid, { richImages: 'https://example.com/photo.jpg' }, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Multiple Images (Grid)</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
@@ -577,156 +877,252 @@ await sock.sendMessage(jid, {
   ]
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Inside items / richResponse</b></summary>
 
 ```js
+// items
 await sock.sendMessage(jid, {
   items: [
-    build.richImage('https://example.com/photo.jpg')
+    { text: 'Hasil foto hari ini:' },
+    { images: ['https://example.com/1.jpg', 'https://example.com/2.jpg'] }
   ]
-})
-```
+}, { quoted: message })
 
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Lihat gambarnya:' },
+    { images: 'https://example.com/banner.jpg' }
+  ]
+}, { quoted: message })
+```
 </details>
 
-<details>
-<summary><b>🎥 Rich Video — <code>richVideo</code> / <code>richVideo</code> builder</b></summary>
+---
+
+#### 🎥 Rich Video
+
+> Video embed as AI animated media (`GenAIImaginePrimitive` with `imagine_type: ANIMATE`).
 
-**Shorthand:**
+<details>
+<summary><b>Shorthand URL</b></summary>
 
 ```js
-await sock.sendMessage(jid, {
-  richVideo: 'https://example.com/clip.mp4'
-}, { quoted: message })
+await sock.sendMessage(jid, { richVideo: 'https://example.com/clip.mp4' }, { quoted: message })
 ```
+</details>
 
-**Full options:**
+<details>
+<summary><b>Full Options</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   richVideo: {
     url: 'https://example.com/clip.mp4',
-    mimeType: 'video/mp4',
-    duration: 15,
-    fallbackText: 'Preview video'
+    mimeType: 'video/mp4',        // default: 'video/mp4'
+    duration: 15,                   // seconds, default: 10
+    fallbackText: 'Preview video' // default: '[ VIDEO - PontaCT ]'
   }
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Inside items / richResponse</b></summary>
 
 ```js
+// items
 await sock.sendMessage(jid, {
   items: [
-    build.richVideo('https://example.com/clip.mp4')
+    { text: 'Cek videonya:' },
+    { videoUrl: 'https://example.com/clip.mp4', duration: 20 }
   ]
-})
-```
+}, { quoted: message })
 
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Tutorial:' },
+    { video: { url: 'https://example.com/tutorial.mp4', duration: 30 } }
+  ]
+}, { quoted: message })
+```
 </details>
 
-<details>
-<summary><b>💡 Rich Suggestions — <code>richSuggestions</code> / <code>richSuggest</code></b></summary>
+---
+
+#### 💡 Rich Suggestions
+
+> Follow-up prompt pills — like native AI chat buttons.
 
-**Direct:**
+<details>
+<summary><b>Shorthand</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   richSuggestions: ['Coba lagi', 'Lihat detail', 'Batalkan']
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Inside items / richResponse</b></summary>
 
 ```js
+// items
 await sock.sendMessage(jid, {
   items: [
-    build.richSuggest('Lihat detail')
+    { text: 'Mau lanjut ke mana?' },
+    { suggestions: ['Halaman utama', 'Bantuan', 'Hubungi admin'] }
   ]
-})
+}, { quoted: message })
+
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Hasil pencarian ditemukan.' },
+    { suggestions: ['Tampilkan semua', 'Filter ulang', 'Export'] }
+  ]
+}, { quoted: message })
 ```
+</details>
+
+---
+
+#### 🔣 Rich LaTeX
 
-</details>
+> Math formula rendering as `GenAILatexItem` inline entity. `url` points to a rendered formula image (PNG/JPG from external LaTeX renderer).
 
 <details>
-<summary><b>🔣 Rich LaTeX — <code>richLatex</code></b></summary>
-
-**Shorthand URL:**
+<summary><b>Shorthand URL</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   richLatex: 'https://latex.codecogs.com/png.latex?E%3Dmc%5E2'
 }, { quoted: message })
 ```
+</details>
 
-**Full options:**
+<details>
+<summary><b>Full Options</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   richLatex: {
     url: 'https://latex.codecogs.com/png.latex?E%3Dmc%5E2',
-    text: 'E = mc²',
-    width: 120,
-    height: 60,
-    font_height: 83.33,
-    padding: 15
+    text: 'E = mc²',     // label & fallback
+    width: 120,            // default: 100
+    height: 60,            // default: 100
+    font_height: 83.33,    // default: 83.33
+    padding: 15            // default: 15
   }
 }, { quoted: message })
 ```
-
 </details>
 
 <details>
-<summary><b>🛍️ Rich Product — <code>richProduct</code> / <code>richProduct</code> builder</b></summary>
+<summary><b>Inside items / richResponse</b></summary>
+
+```js
+// items
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Rumus energi kinetik:' },
+    {
+      latexUrl: 'https://latex.codecogs.com/png.latex?E_k%3D%5Cfrac%7B1%7D%7B2%7Dmv%5E2',
+      latexText: 'Ek = ½mv²',
+      latexWidth: 150,
+      latexHeight: 60
+    }
+  ]
+}, { quoted: message })
+
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Solusi integral:' },
+    { latex: { url: 'https://latex.codecogs.com/png.latex?%5Cint%20x%5E2%20dx', text: '∫x² dx = x³/3 + C' } }
+  ]
+}, { quoted: message })
+```
+</details>
+
+---
+
+#### 🛍️ Rich Product
 
-**Single product:**
+> Product card(s) as `GenAIProductItemCardPrimitive`. Object = single card, Array = horizontal scroll carousel.
+
+<details>
+<summary><b>Single Product</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   richProduct: {
     title: 'Sepatu Adidas Samba',
     price_display_string: 'Rp 1.200.000',
-    description: 'Sepatu casual ikonik.',
+    description: 'Sepatu casual ikonik, tersedia berbagai ukuran.',
     retailer_id: 'adidas_store',
-    thumbnail: {
-      url: 'https://example.com/adidas.jpg',
-      mime_type: 'image/jpeg',
-      width: 300,
-      height: 300
-    }
+    thumbnail: { url: 'https://example.com/adidas.jpg', mime_type: 'image/jpeg', width: 300, height: 300 }
   }
 }, { quoted: message })
 ```
+</details>
 
-**Carousel:**
+<details>
+<summary><b>Product Carousel</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   richProduct: [
-    { title: 'Sepatu A', price_display_string: 'Rp 500.000' },
-    { title: 'Sepatu B', price_display_string: 'Rp 750.000' }
+    {
+      title: 'Sepatu A',
+      price_display_string: 'Rp 500.000',
+      thumbnail: { url: 'https://example.com/a.jpg', mime_type: 'image/jpeg', width: 300, height: 300 }
+    },
+    {
+      title: 'Sepatu B',
+      price_display_string: 'Rp 750.000',
+      thumbnail: { url: 'https://example.com/b.jpg', mime_type: 'image/jpeg', width: 300, height: 300 }
+    }
   ]
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Inside items / richResponse</b></summary>
 
 ```js
+// items
 await sock.sendMessage(jid, {
   items: [
-    build.richProduct({
-      title: 'Sepatu A',
-      price_display_string: 'Rp 500.000'
-    })
+    { text: 'Rekomendasi produk hari ini:' },
+    { product: { title: 'Produk X', price_display_string: 'Rp 99.000' } }
   ]
-})
-```
+}, { quoted: message })
 
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Pilih produkmu:' },
+    { product: [{ title: 'A' }, { title: 'B' }] }
+  ]
+}, { quoted: message })
+```
 </details>
 
+---
+
+#### 📰 Rich Post
+
+> Post card(s) as `GenAIPostPrimitive`. Object = single post, Array = carousel.
+
 <details>
-<summary><b>📰 Rich Post — <code>richPost</code> / <code>richPost</code> builder</b></summary>
+<summary><b>Single Post</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
@@ -739,25 +1135,29 @@ await sock.sendMessage(jid, {
   }
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Post Carousel</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richPost({
-      title: 'Post PontaLabs',
-      author_display_name: '@pontalabs',
-      media_url: 'https://example.com/post.jpg'
-    })
+  richPost: [
+    { title: 'Post 1', author_display_name: '@user1', media_url: 'https://example.com/1.jpg' },
+    { title: 'Post 2', author_display_name: '@user2', media_url: 'https://example.com/2.jpg' }
   ]
-})
+}, { quoted: message })
 ```
-
 </details>
 
+---
+
+#### 🎬 Rich Reels
+
+> Reels carousel as `GenAIReelPrimitive` with `contentItemsMetadata`. Auto-injects `richResponseSourcesMetadata` with `provider: 'PontaCT'`.
+
 <details>
-<summary><b>🎬 Rich Reels — <code>richReels</code> / <code>richReels</code> builder</b></summary>
+<summary><b>Single Reel</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
@@ -775,364 +1175,328 @@ await sock.sendMessage(jid, {
   }
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Reels Carousel</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richReels([{
-      title: '@creator',
-      thumbnailUrl: 'https://example.com/thumb.jpg',
-      videoUrl: 'https://example.com/reel.mp4'
-    }])
+  richReels: [
+    {
+      title: '@creator1',
+      profileIconUrl: 'https://example.com/av1.jpg',
+      thumbnailUrl: 'https://example.com/th1.jpg',
+      videoUrl: 'https://example.com/r1.mp4',
+      likes_count: 5000,
+      reel_source: 'IG'
+    },
+    {
+      title: '@creator2',
+      profileIconUrl: 'https://example.com/av2.jpg',
+      thumbnailUrl: 'https://example.com/th2.jpg',
+      videoUrl: 'https://example.com/r2.mp4',
+      likes_count: 8200,
+      reel_source: 'TT'
+    }
   ]
-})
+}, { quoted: message })
 ```
-
 </details>
 
 <details>
-<summary><b>🔍 Rich Sources — <code>richSources</code> / <code>richSource</code></b></summary>
+<summary><b>📋 Fields Reference</b></summary>
+
+| Field | Type | Default | Description |
+|:---|:---|:---:|:---|
+| `title` | `string` | — | Username / creator name |
+| `profileIconUrl` | `string` | — | Avatar URL |
+| `thumbnailUrl` | `string` | — | Thumbnail cover URL |
+| `videoUrl` | `string` | — | Video source URL |
+| `reels_title` | `string` | `''` | Reel title |
+| `likes_count` | `number` | `0` | Like count |
+| `shares_count` | `number` | `0` | Share count |
+| `view_count` | `number` | `0` | View count |
+| `reel_source` | `string` | `'IG'` | Source platform |
+| `is_verified` | `boolean` | `false` | Verified badge |
 
-**Shorthand:**
+</details>
+
+---
+
+#### 🔍 Rich Sources
+
+> Search result source list as `GenAISearchResultPrimitive`. Accepts full objects **or** shorthand `[faviconUrl, sourceUrl, displayName]`.
+
+<details>
+<summary><b>Shorthand Array</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   richSources: [
     ['https://wikipedia.org/favicon.ico', 'https://wikipedia.org/wiki/Node.js', 'Wikipedia'],
-    ['https://nodejs.org/favicon.ico', 'https://nodejs.org/en/docs', 'Node.js Docs']
+    ['https://nodejs.org/favicon.ico', 'https://nodejs.org/en/docs', 'Node.js Docs'],
+    ['https://github.com/favicon.ico', 'https://github.com/nodejs/node', 'GitHub']
   ]
 }, { quoted: message })
 ```
+</details>
 
-**Full object:**
+<details>
+<summary><b>Full Object</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richSources: [{
-    source_type: 'THIRD_PARTY',
-    source_display_name: 'Wikipedia',
-    source_subtitle: 'wikipedia.org',
-    source_url: 'https://wikipedia.org/wiki/Node.js',
-    favicon: {
-      url: 'https://wikipedia.org/favicon.ico',
-      mime_type: 'image/jpeg',
-      width: 16,
-      height: 16
+  richSources: [
+    {
+      source_type: 'THIRD_PARTY',
+      source_display_name: 'Wikipedia',
+      source_subtitle: 'wikipedia.org',
+      source_url: 'https://wikipedia.org/wiki/Node.js',
+      favicon: { url: 'https://wikipedia.org/favicon.ico', mime_type: 'image/jpeg', width: 16, height: 16 }
     }
-  }]
+  ]
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Mixed Format</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richSource([
-      ['https://wikipedia.org/favicon.ico', 'https://wikipedia.org/wiki/Node.js', 'Wikipedia']
-    ])
+  richSources: [
+    ['https://wikipedia.org/fav.ico', 'https://wikipedia.org', 'Wikipedia'],
+    { source_type: 'THIRD_PARTY', source_display_name: 'Docs', source_url: 'https://docs.example.com' }
   ]
-})
+}, { quoted: message })
 ```
-
 </details>
 
-<details>
-<summary><b>📌 Rich Tip, Footer & Metadata — <code>richTip</code> / <code>richFooter</code> / <code>richMetadata</code></b></summary>
+---
 
-```js
-await sock.sendMessage(jid, {
-  richTip: 'Dihasilkan oleh AI · PontaLabs'
-}, { quoted: message })
+#### 📌 Rich Tip & Footer
 
-await sock.sendMessage(jid, {
-  richFooter: '© PontaLabs · Data bersumber dari layanan publik'
-}, { quoted: message })
-```
+> `richTip` — small metadata text above/center of message.  
+> `richFooter` — metadata text below message (disclaimer / branding).
 
-**Builder:**
+<details>
+<summary><b>Rich Tip</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richTip('AI-generated content'),
-    build.richMetadata('PontaLabs Rich Message'),
-    build.richFooter('© PontaLabs')
-  ]
-})
+  richTip: 'Dihasilkan oleh AI · pontalabs v0.3.4'
+}, { quoted: message })
 ```
-
 </details>
 
 <details>
-<summary><b>🧩 Rich FOA Text — <code>richFOAText</code></b></summary>
+<summary><b>Rich Footer</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richFOAText('Halo dari FOA Rich Text')
-  ]
-})
+  richFooter: '© 2025 PontaCT · Data bersumber dari layanan publik'
+}, { quoted: message })
 ```
-
 </details>
 
 <details>
-<summary><b>🧱 Rich Widget — <code>richWidget</code></b></summary>
+<summary><b>Inside items / richResponse</b></summary>
 
 ```js
+// items
 await sock.sendMessage(jid, {
   items: [
-    build.richWidget({
-      /* widget payload */
-    })
+    { text: 'Hasil pencarian:' },
+    { sources: [['https://fav.ico', 'https://example.com', 'Example']] },
+    { tip: 'AI-generated content' },
+    { footer: '© PontaCT Baileys' }
   ]
-})
-```
-
-</details>
-
-<details>
-<summary><b>🔀 Mixed Rich — <code>items</code></b></summary>
-
-Semua Rich item dapat dicampur dalam satu `items`. Urutan array menjadi urutan tampilan.
+}, { quoted: message })
 
-```js
+// richResponse
 await sock.sendMessage(jid, {
-  items: [
-    { text: '*Laporan Harian Bot*' },
-    { table: {
-      headers: ['Metric', 'Value'],
-      rows: [
-        ['Uptime', '99.9%'],
-        ['Messages', '1.2K']
-      ]
-    }},
-    build.richText('SELECT COUNT(*) FROM messages;'),
-    build.richHtml('<h2>Dashboard</h2>'),
-    build.richSuggest('Refresh'),
-    build.richFooter('Auto-generated · PontaLabs')
+  richResponse: [
+    { text: 'Summary di sini.' },
+    { footer: '© PontaCT · pontalabs' }
   ]
 }, { quoted: message })
 ```
-
-**Item shorthand yang tersedia:**
-
-<details>
-<summary><b>📋 Lihat semua key <code>items</code></b></summary>
-
-- `{ text, inlineEntities? }` — Rich text
-- `{ table }` — Table
-- `{ images }` — Image grid
-- `{ videoUrl, mimeType?, duration? }` — Video
-- `{ suggestions }` — Suggestion pills
-- `{ latexUrl, latexText?, latexWidth?, latexHeight? }` — LaTeX
-- `{ product }` — Product card
-- `{ post }` — Post card
-- `{ reels }` — Reels
-- `{ sources }` — Sources
-- `{ tip }` — Tip
-- `{ footer }` — Footer
-
-</details>
-
 </details>
 
-<details>
-<summary><b>🔗 Rich Response — <code>richResponse</code></b></summary>
+---
 
-`richResponse` adalah full array mode untuk menyusun Rich primitive secara manual, termasuk inline citation melalui `inlineEntities`.
+#### 🔀 Rich Mixed — `items`
 
-**Basic:**
+<details>
+<summary><b>Text + Code + Table</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richResponse: [
-    { text: '*Hasil:* Node.js adalah runtime JavaScript.' },
-    { code: 'node --version', language: 'bash' },
-    { suggestions: ['Lihat docs', 'Install'] },
-    { footer: 'PontaLabs' }
+  items: [
+    { text: 'Query yang dijalankan:' },
+    { code: 'SELECT id, name, score FROM users ORDER BY score DESC LIMIT 3', language: 'sql' },
+    { text: 'Hasil:' },
+    {
+      table: {
+        headers: ['id', 'name', 'score'],
+        rows: [
+          ['1', 'Ponta', '98'],
+          ['2', 'Yue', '87'],
+          ['3', 'Frieren', '75']
+        ]
+      }
+    }
   ]
 }, { quoted: message })
 ```
 
-**Inline citation:**
-
-```js
+```
+ // build delay (muncul satu satu)
 await sock.sendMessage(jid, {
-  richResponse: [{
-    text: 'Node.js {{SS_0}}¹{{/SS_0}} adalah runtime JavaScript.',
-    inlineEntities: [{
-      key: 'SS_0',
-      metadata: {
-        reference_id: 1,
-        reference_url: 'https://nodejs.org',
-        reference_title: 'Node.js Official',
-        reference_display_name: 'nodejs.org',
-        sources: [{
-          source_type: 'THIRD_PARTY',
-          source_display_name: 'Node.js',
-          source_url: 'https://nodejs.org'
-        }]
+  items: [
+    { text: 'Query yang dijalankan:' },
+    { code: 'SELECT id, name, score FROM users ORDER BY score DESC LIMIT 3', language: 'sql' },
+    { text: 'Hasil:' },
+    {
+      table: {
+        headers: ['id', 'name', 'score'],
+        rows: [
+          ['1', 'Ponta', '98'],
+          ['2', 'Yue', '87'],
+          ['3', 'Frieren', '75']
+        ]
       }
-    }]
-  }]
+    }
+  ],
+  buildDelay: 2500,
 }, { quoted: message })
 ```
+</details>
 
-**Table di `richResponse`:**
+<details>
+<summary><b>Text + Images + Video + Suggestions</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richResponse: [{
-    table: {
-      items: [
-        { items: ['Name', 'Role'], isHeading: true },
-        { items: ['Ponta', 'Admin'] }
-      ]
-    }
-  }]
+  items: [
+    { text: '*Konten hari ini*' },
+    { images: ['https://example.com/1.jpg', 'https://example.com/2.jpg'] },
+    { videoUrl: 'https://example.com/preview.mp4', duration: 15 },
+    { suggestions: ['Lihat selengkapnya', 'Bagikan', 'Simpan'] }
+  ]
 }, { quoted: message })
 ```
-
-> Berbeda dari `table` top-level / `items`, format table di `richResponse` harus berupa array row siap-pakai.
-
 </details>
 
 <details>
-<summary><b>🎛️ Interactive Rich Builder — Button, ButtonV2 & Carousel</b></summary>
-
-Builder interactive juga berada di namespace `build` dan dikirim melalui `sock.sendMessage()`.
-
-**Native Flow Button:**
+<summary><b>Full Mixed (all types)</b></summary>
 
 ```js
-const button = build.button()
-  .setTitle('Menu')
-  .setBody('Pilih salah satu')
-  .setFooter('PontaLabs')
-  .addReply('Halo', 'hello')
-  .addUrl('Website', 'https://example.com')
-  .addCopy('Copy ID', 'ABC123')
-
 await sock.sendMessage(jid, {
-  items: [button]
-})
+  items: [
+    { text: '*Laporan Harian Bot*' },
+    { table: { headers: ['Metric', 'Value'], rows: [['Uptime', '99.9%'], ['Messages', '1.2K']] } },
+    { code: 'SELECT COUNT(*) FROM messages WHERE date = CURDATE()', language: 'sql' },
+    { text: 'Formula uptime:' },
+    {
+      latexUrl: 'https://latex.codecogs.com/png.latex?U%3D%5Cfrac%7Bt_u%7D%7Bt_t%7D%5Ctimes100',
+      latexText: 'U = (tu/tt) × 100'
+    },
+    { sources: [['https://example.com/fav.ico', 'https://example.com', 'Dashboard']] },
+    { suggestions: ['Refresh', 'Export PDF'] },
+    { footer: 'Auto-generated · PontaCT' }
+  ]
+}, { quoted: message })
 ```
+</details>
 
-**ButtonV2:**
-
-```js
-const buttons = build.buttonV2()
-  .setBody('Pilih aksi')
-  .setFooter('PontaLabs')
-  .addButton('Yes')
-  .addButton('No')
+---
 
-await sock.sendMessage(jid, {
-  items: [buttons]
-})
-```
+#### 🔗 Rich Response — `richResponse`
 
-**Carousel:**
+<details>
+<summary><b>Inline Citation</b></summary>
 
 ```js
-const carousel = build.carousel()
-  .addCard(c => c
-    .setTitle('Card 1')
-    .setBody('Deskripsi 1')
-    .addReply('Pilih', 'card1')
-  )
-  .addCard(c => c
-    .setTitle('Card 2')
-    .setBody('Deskripsi 2')
-    .addUrl('Buka', 'https://example.com')
-  )
-
 await sock.sendMessage(jid, {
-  items: [carousel]
-})
+  richResponse: [
+    {
+      text: 'Node.js {{SS_0}}¹{{/SS_0}} adalah runtime JavaScript. Dibuat oleh Ryan Dahl {{SS_1}}²{{/SS_1}} pada 2009.',
+      inlineEntities: [
+        {
+          key: 'SS_0',
+          metadata: {
+            reference_id: 1,
+            reference_url: 'https://nodejs.org',
+            reference_title: 'Node.js Official',
+            reference_display_name: 'nodejs.org',
+            sources: [{
+              source_type: 'THIRD_PARTY',
+              source_display_name: 'nodejs.org',
+              source_subtitle: 'nodejs.org',
+              source_url: 'https://nodejs.org'
+            }],
+            __typename: 'GenAISearchCitationItem'
+          }
+        },
+        {
+          key: 'SS_1',
+          metadata: {
+            reference_id: 2,
+            reference_url: 'https://wikipedia.org/wiki/Ryan_Dahl',
+            reference_title: 'Ryan Dahl - Wikipedia',
+            reference_display_name: 'Wikipedia',
+            sources: [{
+              source_type: 'THIRD_PARTY',
+              source_display_name: 'Wikipedia',
+              source_subtitle: 'wikipedia.org',
+              source_url: 'https://wikipedia.org/wiki/Ryan_Dahl'
+            }],
+            __typename: 'GenAISearchCitationItem'
+          }
+        }
+      ]
+    }
+  ]
+}, { quoted: message })
 ```
-
 </details>
 
 <details>
-<summary><b>⏱️ Rich Build Delay — <code>buildDelay</code></b></summary>
-
-`buildDelay` digunakan bersama `items` untuk melakukan progressive update pada target message yang sama.
-
-```js
-await sock.sendMessage(jid, {
-  items: [
-    build.richText('⏳ Memproses...'),
-    build.richText('🔍 Mencari data...'),
-    build.richText('✅ Selesai!')
-  ],
-  buildDelay: 1000
-})
-```
-
-Dengan `buildDelay: 1000`, item berikutnya diproses setiap 1 detik dan update tetap menggunakan message ID target yang sama.
-
-**Custom message ID:**
+<summary><b>Full Response — all types at once</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  messageId: 'MY_MESSAGE_ID',
-  items: [
-    build.richText('Build 1'),
-    build.richText('Build 2')
+  richResponse: [
+    { text: '*Hasil Pencarian:* Node.js {{SS_0}}¹{{/SS_0}}', inlineEntities: [/* ... */] },
+    { images: ['https://example.com/nodejs.png'] },
+    { text: 'Cara install:' },
+    { code: 'npm install node', language: 'bash' },
+    {
+      table: [
+        { items: ['Version', 'LTS', 'Release'], isHeading: true },
+        { items: ['22.x', 'Yes', '2024'], isHeading: false },
+        { items: ['21.x', 'No', '2023'], isHeading: false }
+      ]
+    },
+    { sources: [['https://nodejs.org/fav.ico', 'https://nodejs.org', 'Node.js']] },
+    { suggestions: ['Lihat changelog', 'Download', 'Docs'] },
+    { footer: 'PontaCT · pontalabs' }
   ],
-  buildDelay: 1000
-})
+  buildDelay: 2500,
+}, { quoted: message })
 ```
-
 </details>
 
-<details>
-<summary><b>🛠️ Advanced Rich Builder — <code>build.AIRich(sock)</code></b></summary>
-
-Untuk state, node ID, replace, insert, delete, dan edit message gunakan `build.AIRich(sock)`.
-
-```js
-const ai = build.AIRich(sock)
-
-ai.addText('⏳ Loading...', { id: 'status' })
-ai.addTip('Mohon tunggu')
-
-await ai.send(jid)
-
-ai.addText('✅ Selesai!', { replace: 'status' })
-ai.delete('status')
-ai.addTip('Tambahan', { insertAt: 'status' })
-```
-
-**Contoh edit:**
-
-```js
-const ai = build.AIRich(sock)
-
-ai.addText('⏳ Memproses...', { id: 'answer' })
-await ai.send(jid)
-
-const result = await getAIResponse()
-
-ai.addText(result, { replace: 'answer' })
-ai.addTip('Generated by AI')
-
-await ai.sendEdit(jid)
-```
-
-> `replace` dan `insertAt` adalah options pada `add*()`, bukan method `ai.replace()` atau `ai.insertAt()`.
+---
 
-</details>
+#### ⚙️ Rich Options
 
 <details>
-<summary><b>⚙️ Rich Options — <code>aiForwarded</code></b></summary>
+<summary><b><code>aiForwarded</code> — toggle label "Diteruskan dari bot AI"</b></summary>
 
-`aiForwarded` menambahkan label forwarded-from-AI-bot pada `contextInfo`.
+> Default `false`. Set `true` kalau mau pesan diberi tag forwarded-from-AI-bot di `contextInfo`. Bisa dipakai bareng key rich manapun (`richText`, `items`, `richResponse`, dll).
 
 ```js
 await sock.sendMessage(jid, {
@@ -1140,42 +1504,6 @@ await sock.sendMessage(jid, {
   aiForwarded: true
 }, { quoted: message })
 ```
-
-Bisa digunakan bersama `richText`, `items`, `richResponse`, `richHtml`, dan key Rich lainnya.
-
-</details>
-
-<details>
-<summary><b>🔌 Legacy Compatibility</b></summary>
-
-API Rich lama tetap kompatibel:
-
-```js
-await sock.sendMessage(jid, {
-  richText: 'Halo'
-})
-
-await sock.sendMessage(jid, {
-  items: [
-    { richText: 'Halo' },
-    { richTip: 'Testing' }
-  ]
-})
-```
-
-Kamu juga dapat mencampur object Rich lama dengan `build.*`:
-
-```js
-await sock.sendMessage(jid, {
-  items: [
-    { richText: 'Shortcut lama' },
-    build.richText('Builder baru'),
-    { richTip: 'Shortcut lama' },
-    build.richTip('Builder baru')
-  ]
-})
-```
-
 </details>
 
 ---
@@ -1195,19 +1523,39 @@ const newsletter = await sock.newsletterMetadata('jid', '120363282083849178@news
 </details>
 
 <details>
-<summary><b>➕ Follow / Unfollow Newsletter</b></summary>
+<summary><b>👆 Follow / Unfollow / Mute / Unmute</b></summary>
+
+```js
+const nlJid = '120363282083849178@newsletter'
+
+await sock.newsletterFollow(nlJid)
+await sock.newsletterUnfollow(nlJid)
+await sock.newsletterMute(nlJid)
+await sock.newsletterUnmute(nlJid)
+```
+</details>
+
+<details>
+<summary><b>📣 Create Newsletter</b></summary>
 
 ```js
-await sock.newsletterFollow('120363282083849178@newsletter')
-await sock.newsletterUnfollow('120363282083849178@newsletter')
+const newsletter = await sock.newsletterCreate(
+  'Newsletter Name',
+  'Description here',
+  { url: 'https://example.com/image.jpg' }
+)
 ```
 </details>
 
 <details>
-<summary><b>📨 Newsletter Reaction</b></summary>
+<summary><b>🌟 React to Newsletter Post</b></summary>
 
 ```js
-await sock.newsletterReactMessage('120363282083849178@newsletter', '123', '🔥')
+await sock.newsletterReactMessage(
+  '120363282083849178@newsletter',
+  '12',   // server message ID
+  '🦖'    // emoji
+)
 ```
 </details>
 
@@ -1216,11 +1564,15 @@ await sock.newsletterReactMessage('120363282083849178@newsletter', '123', '🔥'
 ## 👥 Groups
 
 <details>
-<summary><b>📝 Create Group</b></summary>
+<summary><b>🔄 Create Group</b></summary>
 
 ```js
-const group = await sock.groupCreate('My Group', ['1234567890@s.whatsapp.net'])
-console.log('Group ID:', group.id)
+const group = await sock.groupCreate('Group Title', [
+  '1234567890@s.whatsapp.net',
+  '0987654321@s.whatsapp.net'
+])
+
+console.log('Group JID:', group.id)
 ```
 </details>
 
@@ -1420,14 +1772,6 @@ const summary = getAggregateResponsesInEventMessage(eventMsg, sock.user.lid)
 
 ## 🤝 Contributing
 
-<div align="center">
-
-<img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Hand%20gestures/Handshake.png" width="60" />
-
-**Contributions are welcome!**
-
-</div>
-
 1. **Fork** repository
 2. Create a feature branch: `git checkout -b feat/your-feature`
 3. Commit your changes: `git commit -m "feat: add something awesome"`
@@ -1438,10 +1782,6 @@ const summary = getAggregateResponsesInEventMessage(eventMsg, sock.user.lid)
 
 ## 📜 License
 
-<div align="center">
-
-<img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Scroll.png" width="40" />
-
 This project is licensed for **personal and non-commercial use only**.
 
 | | |
@@ -1451,8 +1791,6 @@ This project is licensed for **personal and non-commercial use only**.
 | ❌ | Commercial use strictly prohibited |
 | ❌ | Resale or rebranding prohibited |
 
-</div>
-
 ---
 
 ## ⚠️ Disclaimer
@@ -1464,16 +1802,10 @@ This project is licensed for **personal and non-commercial use only**.
 
 <div align="center">
 
-<img src="https://capsule-render.vercel.app/api?type=waving&color=0:0f0c29,100:302b63&height=150&section=footer&text=PontaLabs&fontSize=30&fontColor=fff&animation=fadeIn" width="100%"/>
-
 [📦 NPM](https://www.npmjs.com/package/@pontalabs/baileys) · [📖 Baileys Wiki](https://github.com/WhiskeySockets/Baileys/wiki) · [⭐ Star this repo](#)
 
 <br>
 
-<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=14&pause=1000&color=00D9FF&center=true&width=400&lines=Made+with+%E2%99%A5+by+PontaCT;Thanks+for+visiting!" alt="footer typing" />
-
-<br><br>
-
-<img src="https://komarev.com/ghpvc/?username=PontaCT&label=Thanks+for+visiting&color=00D9FF&style=flat-square" />
+Made with ♥ by **PontaCT**
 
 </div>