@pontalabs/baileys 1.2.5 → 1.2.7

package/README.md

@@ -280,9 +280,33 @@ await sock.sendMessage(jid, { react: { text: '', key: message.key } })
 ```js
 await sock.sendMessage(jid, {
   poll: {
-    name: 'Favorite color?',
-    values: ['Red', 'Blue', 'Green'],
-    selectableCount: 1
+    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'
   }
 })
 ```
@@ -299,6 +323,37 @@ await sock.sendAlbumMessage(jid, [
 ```
 </details>
 
+<details>
+<summary><b>📆 Event</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  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>
 
@@ -333,6 +388,41 @@ await sock.sendMessage(jid, {
 ```
 </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>🔩 Raw / Legacy Buttons</b></summary>
 
@@ -586,87 +676,52 @@ await sock.sendMessage(jid, {
 
 ### 🤖 Rich Messages
 
-> 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.
-
-<details>
-<summary><b>📌 Quick Start — Rich Message</b></summary>
+> 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.
 
-```js
-await sock.sendMessage(jid, {
-  richText: 'Halo! 👋'
-}, { quoted: message })
-```
+**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)
 
-Builder `build.*` hanya membuat payload. Pengiriman tetap melalui `sock.sendMessage()`:
-
-```js
-await sock.sendMessage(jid, {
-  items: [
-    build.richText('Halo! 👋'),
-    build.richTip('Dikirim dari PontaLabs')
-  ]
-})
-```
+---
 
-> `build` tersedia dari package dan tidak membutuhkan `sock` saat membuat payload.
+#### 📝 Rich Text
 
-</details>
+> AI bot-styled markdown text rendered in `richResponseMessage`.
 
 <details>
-<summary><b>📝 Rich Text — <code>richText</code></b></summary>
-
-Rich markdown text yang dirender sebagai `GenAIMarkdownTextUXPrimitive`.
-
-**Direct:**
+<summary><b>Simple Text</b></summary>
 
 ```js
-await sock.sendMessage(jid, {
-  richText: '*Halo!* Ini rich text dari bot.\nStatus: `success`\nWaktu: _120ms_'
-}, { quoted: message })
+await sock.sendMessage(jid, { richText: 'Halo! Ini pesan dari bot.' }, { quoted: message })
 ```
+</details>
 
-**Array / beberapa paragraf:**
+<details>
+<summary><b>Markdown (bold, italic, inline code)</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  richText: [
-    'Baris pertama.',
-    'Baris kedua.',
-    'Baris ketiga.'
-  ]
+  richText: '*Hasil eksekusi:*\nStatus: `success`\nWaktu: _120ms_'
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
+<details>
+<summary><b>Multiple Paragraphs (Array)</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richText('Halo! 👋')
-  ]
-})
+  richText: ['Baris pertama.', 'Baris kedua.', 'Baris ketiga.']
+}, { quoted: message })
 ```
+</details>
 
-**Raw item:**
+---
 
-```js
-await sock.sendMessage(jid, {
-  items: [
-    { text: 'Halo! 👋' }
-  ]
-})
-```
+#### 📝 Rich Html
 
-</details>
+> AI html rendered in `GenAIaeacdsnwHtmlPrimitive`.
 
 <details>
-<summary><b>🌐 Rich HTML WebView — <code>richHtml</code></b></summary>
-
-Mengirim HTML langsung ke primitive `GenAIaeacdsnwHtmlPrimitive`.
-
-**Direct `sendMessage`:**
+<summary><b>Simple Html</b></summary>
 
 ```js
 const html = `<!DOCTYPE html>
@@ -686,68 +741,16 @@ await sock.sendMessage(jid, {
   richHtml: html
 }, { quoted: message })
 ```
-
-**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.
-
 </details>
-<details>
-<summary>👤 richCard — Entity Card</summary>
-
-Membuat Card Entity/Profile langsung melalui `sendMessage()`. Tidak membutuhkan `build` atau `AIRich`.
 
-```js
-await conn.sendMessage(m.chat, {
-    richCard: {
-        thumbnail_url: 'https://example.com/profile.jpg',
-        verification: true,
-        title: 'PontaLabs',
-        subtitle: 'Owner: Ponta',
-        description: 'Ini Ownernya',
-        entity_id: '6283857182374',
-        entity_url: 'https://wa.me/6283857182374',
-        profile_url: 'https://example.com/profile.jpg'
-    }
-});
-```
-
-| Property | Type | Description |
-|---|---|---|
-| `thumbnail_url` | `string` | Thumbnail Card |
-| `verification` | `boolean` | Status verified |
-| `title` | `string` | Judul Entity |
-| `subtitle` | `string` | Subjudul |
-| `description` | `string` | Deskripsi |
-| `entity_id` | `string` | ID Entity |
-| `entity_url` | `string` | URL Entity |
-| `profile_url` | `string` | URL fallback/profile |
+---
 
-</details>
+#### 💻 Rich Code Block
 
+> Syntax-highlighted code. Use `code` for single block, `codes` for multiple.
 
 <details>
-<summary><b>💻 Rich Code — <code>code</code> / <code>codes</code> / <code>richCode</code></b></summary>
-
-**Single block:**
+<summary><b>Single Block</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
@@ -755,36 +758,50 @@ await sock.sendMessage(jid, {
   language: 'javascript'
 }, { quoted: message })
 ```
+</details>
 
-**Multiple blocks:**
+<details>
+<summary><b>Multiple Blocks</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
   codes: [
-    { code: 'console.log("hello")', language: 'javascript' },
-    { code: 'SELECT * FROM users;', language: 'sql' }
+    { code: 'SELECT * FROM users WHERE id = 1;', language: 'sql' },
+    { code: '{ "id": 1, "name": "Ponta", "role": "admin" }', language: 'json' }
   ]
 }, { quoted: message })
 ```
+</details>
 
-**Builder:**
-
-```js
-await sock.sendMessage(jid, {
-  items: [
-    build.richCode('console.log("hello")', 'javascript')
-  ]
-})
-```
+<details>
+<summary><b>Supported Languages</b></summary>
 
-**Supported language aliases:** `javascript`, `js`, `typescript`, `ts`, `python`, `py`, `bash`, `sh`, `zsh`, `go`, `golang`, `rust`, `rs`, `c`, `h`, `cpp`, `c++`, `csharp`, `cs`, `css`, `html`, `powershell`, `ps1`, `cmd`, `bat`, `sql`, `json`.
+| 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, {
@@ -799,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>
+
+---
+
+#### 🖼️ 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>
 
-**Multiple images:**
+<details>
+<summary><b>Multiple Images (Grid)</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
@@ -840,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>
+---
 
-**Shorthand:**
+#### 🎥 Rich Video
+
+> Video embed as AI animated media (`GenAIImaginePrimitive` with `imagine_type: ANIMATE`).
+
+<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
 
-**Direct:**
+> Follow-up prompt pills — like native AI chat buttons.
+
+<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>
 
-<details>
-<summary><b>🔣 Rich LaTeX — <code>richLatex</code></b></summary>
+---
 
-**Shorthand URL:**
+#### 🔣 Rich LaTeX
+
+> Math formula rendering as `GenAILatexItem` inline entity. `url` points to a rendered formula image (PNG/JPG from external LaTeX renderer).
+
+<details>
+<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: 'Produk A',
-      price_display_string: 'Rp 99.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, {
@@ -1002,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, {
@@ -1038,362 +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 |
+
+</details>
+
+---
+
+#### 🔍 Rich Sources
 
-**Shorthand:**
+> 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://example.com/favicon.ico', 'https://example.com', 'Example']
-    ])
+  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.richCode('SELECT COUNT(*) FROM messages;', 'sql'),
-    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
-- `{ code, language }` — Code block
-- `{ 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: 'nodejs.org',
-          source_subtitle: 'nodejs.org',
-          source_url: 'https://nodejs.org'
-        }],
-        __typename: 'GenAISearchCitationItem'
+  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: ['Version', 'LTS', 'Release'], isHeading: true },
-      { items: ['22.x', 'Yes', '2024'], isHeading: false }
-    ]
-  }]
-})
+  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')
+#### 🔗 Rich Response — `richResponse`
 
-await sock.sendMessage(jid, {
-  items: [buttons]
-})
-```
-
-**Carousel:**
+<details>
+<summary><b>Inline Citation</b></summary>
 
 ```js
-const carousel = build.carousel()
-  .setBody('Pilih produk')
-  .setFooter('PontaLabs')
-  .addCard(card)
-
 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 })
 ```
-
-> `build.button()`, `build.buttonV2()`, dan `build.carousel()` tidak membutuhkan `sock` saat dibuat. Builder hanya menghasilkan payload.
-
 </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 })
 ```
-
-> `buildDelay` hanya berlaku untuk `items` dan nilainya harus lebih besar dari `0`.
-
 </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, {
@@ -1401,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>
 
 ---