npm - @pontalabs/baileys - Versions diffs - 1.2.3 → 1.2.5 - Mend

@pontalabs/baileys 1.2.3 → 1.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +479 -605
package/lib/Socket/messages-send.js +147 -10
package/lib/Utils/mbuilder.d.ts +9 -3
package/lib/Utils/mbuilder.js +25 -14
package/lib/Utils/rich-message-utils.js +31 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -584,215 +584,170 @@ await sock.sendMessage(jid, {
 ---
-### 🧱 Rich Builder API — `build.*`
-`build.*` adalah cara singkat untuk membuat **Rich AI item** yang langsung bisa dipakai di `sock.sendMessage()`.
+### 🤖 Rich Messages
-> **Tidak perlu import `build`.** Package mengekspos `build` secara global saat dimuat.
+> 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.
-#### 🚀 Cara paling sederhana
+<details>
+<summary><b>📌 Quick Start — Rich Message</b></summary>
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    build.richText('Halo! 👋'),
-    build.richCode('console.log("hello")', 'javascript'),
-    build.richTip('Selesai!')
-  ]
-})
+  richText: 'Halo! 👋'
+}, { quoted: message })
 ```
-Factory `build.rich*()` **tidak mengirim pesan sendiri**. Mereka hanya membuat item payload. Pengiriman tetap menggunakan API Baileys biasa: `sock.sendMessage()`.
-#### ⏱️ Delay antar build
-Kalau setiap item builder ingin dikirim sebagai **pesan terpisah**, gunakan `buildDelay` dalam milidetik:
+Builder `build.*` hanya membuat payload. Pengiriman tetap melalui `sock.sendMessage()`:
 ```js
 await sock.sendMessage(jid, {
   items: [
-    build.richText('Build 1'),
-    build.richText('Build 2'),
-    build.richTip('Build 3')
-  ],
-  buildDelay: 1000
+    build.richText('Halo! 👋'),
+    build.richTip('Dikirim dari PontaLabs')
+  ]
 })
 ```
-Urutannya menjadi `Build 1 → tunggu 1 detik → Build 2 → tunggu 1 detik → Build 3`.
+> `build` tersedia dari package dan tidak membutuhkan `sock` saat membuat payload.
-Tanpa `buildDelay`, perilaku `items` lama tetap dipakai: semua item digabung menjadi **satu Rich AI message**.
+</details>
-> `buildDelay` hanya berlaku untuk `items`. Nilai dalam milidetik harus lebih besar dari `0`.
+<details>
+<summary><b>📝 Rich Text — <code>richText</code></b></summary>
-#### ✨ Semua factory
+Rich markdown text yang dirender sebagai `GenAIMarkdownTextUXPrimitive`.
-| Factory | Contoh | Hasil |
-| --- | --- | --- |
-| `build.richText(text)` | `build.richText('Halo')` | Text |
-| `build.richFOAText(text)` | `build.richFOAText('Halo')` | FOA text |
-| `build.richHtml(html)` | `build.richHtml('<html>...</html>')` | HTML WebView |
-| `build.richCode(code, language)` | `build.richCode('console.log(1)', 'javascript')` | Code |
-| `build.richTable(table)` | `build.richTable([['A', 'B']])` | Table |
-| `build.richSource(sources)` | `build.richSource([...])` | Sources |
-| `build.richReels(items)` | `build.richReels([...])` | Reels |
-| `build.richImage(url)` | `build.richImage('https://...')` | Image |
-| `build.richVideo(url)` | `build.richVideo('https://...')` | Video |
-| `build.richProduct(data)` | `build.richProduct({...})` | Product |
-| `build.richPost(data)` | `build.richPost({...})` | Post |
-| `build.richMetadata(text)` | `build.richMetadata('Info')` | Metadata |
-| `build.richTip(text)` | `build.richTip('Tip')` | Tip |
-| `build.richWidget(data)` | `build.richWidget({...})` | Widget |
-| `build.richFooterAction(data)` | `build.richFooterAction({...})` | Footer action |
-| `build.richSuggest(value)` | `build.richSuggest('Lanjutkan')` | Suggestion |
+**Direct:**
-#### 🧩 Campur dengan shortcut lama
+```js
+await sock.sendMessage(jid, {
+  richText: '*Halo!* Ini rich text dari bot.\nStatus: `success`\nWaktu: _120ms_'
+}, { quoted: message })
+```
-API lama **tetap dipertahankan**. Builder bisa dicampur dengan object Rich AI biasa di `items`.
+**Array / beberapa paragraf:**
 ```js
 await sock.sendMessage(jid, {
-  items: [
-    { richText: 'Shortcut lama tetap jalan' },
-    build.richText('Item dari Builder'),
-    { richTip: 'Shortcut lama' },
-    build.richTip('Tip dari Builder')
+  richText: [
+    'Baris pertama.',
+    'Baris kedua.',
+    'Baris ketiga.'
   ]
-})
+}, { quoted: message })
 ```
-#### 🌐 HTML WebView
-`build.richHtml()` membuat primitive HTML Rich AI seperti webview. HTML dikirim sebagai payload langsung ke primitive `GenAIaeacdsnwHtmlPrimitive`.
+**Builder:**
 ```js
-const html = `<!DOCTYPE html>
-<html>
-  <body style="margin:0;padding:20px;font-family:Arial">
-    <h2>🎮 Game Center</h2>
-    <button onclick="document.body.innerHTML += '<p>Clicked!</p>'">
-      Play
-    </button>
-  </body>
-</html>`
 await sock.sendMessage(jid, {
-  items: [build.richHtml(html)]
+  items: [
+    build.richText('Halo! 👋')
+  ]
 })
 ```
-Karena HTML berjalan di sisi client/webview, gunakan HTML/JavaScript yang memang kamu kontrol dan sesuaikan dengan dukungan client WhatsApp yang dituju.
-#### 🛠️ Builder untuk edit / delete
-Untuk kebutuhan yang benar-benar membutuhkan state dan manipulasi node, gunakan `build.AIRich(sock)`.
+**Raw item:**
 ```js
-const ai = build.AIRich(sock)
-ai.addText('⏳ Loading...', { id: 'status' })
-ai.addTip('Mohon tunggu')
-await ai.send(jid)
-// Ganti node berdasarkan ID
-ai.addText('✅ Selesai!', { replace: 'status' })
-// Hapus node
-ai.delete('status')
-// Sisipkan setelah node tertentu
-ai.addTip('Tambahan', { insertAt: 'status' })
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Halo! 👋' }
+  ]
+})
 ```
-> `replace` dan `insertAt` adalah **options pada `add*()`**, bukan method `ai.replace()` atau `ai.insertAt()`.
-#### 📝 Contoh workflow edit
+</details>
-```js
-const ai = build.AIRich(sock)
-ai.addText('⏳ Memproses...', { id: 'answer' })
+<details>
+<summary><b>🌐 Rich HTML WebView — <code>richHtml</code></b></summary>
-await ai.send(jid)
+Mengirim HTML langsung ke primitive `GenAIaeacdsnwHtmlPrimitive`.
-const result = await getAIResponse()
+**Direct `sendMessage`:**
-ai.addText(result, { replace: 'answer' })
-ai.addTip('Generated by AI')
+```js
+const html = `<!DOCTYPE html>
+<html>
+<head>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+</head>
+<body>
+  <h2>🎮 Game Center</h2>
+  <button onclick="document.body.innerHTML += '<p>Clicked!</p>'">
+    Play
+  </button>
+</body>
+</html>`
-await ai.sendEdit(jid)
+await sock.sendMessage(jid, {
+  richHtml: html
+}, { quoted: message })
 ```
-#### 🔌 API lama tetap kompatibel
+**Builder:**
 ```js
-await sock.sendMessage(jid, {
-  richText: 'Halo'
-})
 await sock.sendMessage(jid, {
   items: [
-    { richText: 'Halo' },
-    { richTip: 'Testing' }
+    build.richHtml(html)
   ]
 })
 ```
-Dengan desain ini, developer bisa memilih:
-- **`sock.sendMessage()` + shortcut** → paling sederhana.
-- **`sock.sendMessage()` + `build.rich*()`** → payload Rich AI yang lebih rapi dan mudah dirangkai.
-- **`build.AIRich(sock)`** → kebutuhan advanced seperti `id`, `replace`, `insertAt`, `delete`, dan edit message.
-### 🤖 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>Simple Text</b></summary>
+**Raw item:**
 ```js
-await sock.sendMessage(jid, { richText: 'Halo! Ini pesan dari bot.' }, { quoted: message })
+await sock.sendMessage(jid, {
+  items: [
+    { html: html }
+  ]
+})
 ```
-</details>
-<details>
-<summary><b>Markdown (bold, italic, inline code)</b></summary>
+> HTML berjalan di sisi client/webview. Gunakan HTML/JavaScript yang kamu kontrol dan sesuaikan dengan dukungan client WhatsApp yang dituju.
-```js
-await sock.sendMessage(jid, {
-  richText: '*Hasil eksekusi:*\nStatus: `success`\nWaktu: _120ms_'
-}, { quoted: message })
-```
 </details>
 <details>
-<summary><b>Multiple Paragraphs (Array)</b></summary>
+<summary>👤 richCard — Entity Card</summary>
+Membuat Card Entity/Profile langsung melalui `sendMessage()`. Tidak membutuhkan `build` atau `AIRich`.
 ```js
-await sock.sendMessage(jid, {
-  richText: ['Baris pertama.', 'Baris kedua.', 'Baris ketiga.']
-}, { quoted: message })
+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'
+    }
+});
 ```
-</details>
----
+| 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 |
-#### 💻 Rich Code Block
+</details>
-> Syntax-highlighted code. Use `code` for single block, `codes` for multiple.
 <details>
-<summary><b>Single Block</b></summary>
+<summary><b>💻 Rich Code — <code>code</code> / <code>codes</code> / <code>richCode</code></b></summary>
+**Single block:**
 ```js
 await sock.sendMessage(jid, {
@@ -800,50 +755,36 @@ await sock.sendMessage(jid, {
   language: 'javascript'
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Multiple Blocks</b></summary>
+**Multiple blocks:**
 ```js
 await sock.sendMessage(jid, {
   codes: [
-    { code: 'SELECT * FROM users WHERE id = 1;', language: 'sql' },
-    { code: '{ "id": 1, "name": "Ponta", "role": "admin" }', language: 'json' }
+    { code: 'console.log("hello")', language: 'javascript' },
+    { code: 'SELECT * FROM users;', language: 'sql' }
   ]
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Supported Languages</b></summary>
-| 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>
+**Builder:**
----
+```js
+await sock.sendMessage(jid, {
+  items: [
+    build.richCode('console.log("hello")', 'javascript')
+  ]
+})
+```
-#### 📊 Rich Table
+**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`.
-> 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>
 <details>
-<summary><b>Simple Table</b></summary>
+<summary><b>📊 Rich Table — <code>table</code> / <code>richTable</code></b></summary>
+**Top-level:**
 ```js
 await sock.sendMessage(jid, {
@@ -858,57 +799,37 @@ await sock.sendMessage(jid, {
   }
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Table without Title</b></summary>
+**Builder:**
 ```js
 await sock.sendMessage(jid, {
-  table: {
-    headers: ['Command', 'Description'],
-    rows: [
-      ['.ping', 'Cek latency bot'],
-      ['.info', 'Info bot'],
-      ['.help', 'List semua command']
-    ]
-  }
-}, { quoted: message })
+  items: [
+    build.richTable([
+      ['Name', 'Role'],
+      ['Ponta', 'Admin'],
+      ['Yue', 'Member']
+    ])
+  ]
+})
 ```
-</details>
-<details>
-<summary><b>Data Only (no header)</b></summary>
+> Untuk `richResponse`, format `table` berbeda: gunakan array baris siap-pakai seperti `{ items: [...], isHeading }`, bukan `{ headers, rows }`.
-```js
-await sock.sendMessage(jid, {
-  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>
+<summary><b>🖼️ Rich Images — <code>richImages</code> / <code>richImage</code></b></summary>
+**Single image:**
 ```js
-await sock.sendMessage(jid, { richImages: 'https://example.com/photo.jpg' }, { quoted: message })
+await sock.sendMessage(jid, {
+  richImages: 'https://example.com/photo.jpg'
+}, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Multiple Images (Grid)</b></summary>
+**Multiple images:**
 ```js
 await sock.sendMessage(jid, {
@@ -919,252 +840,156 @@ await sock.sendMessage(jid, {
   ]
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Inside items / richResponse</b></summary>
+**Builder:**
 ```js
-// items
 await sock.sendMessage(jid, {
   items: [
-    { text: 'Hasil foto hari ini:' },
-    { images: ['https://example.com/1.jpg', 'https://example.com/2.jpg'] }
+    build.richImage('https://example.com/photo.jpg')
   ]
-}, { quoted: message })
-// richResponse
-await sock.sendMessage(jid, {
-  richResponse: [
-    { text: 'Lihat gambarnya:' },
-    { images: 'https://example.com/banner.jpg' }
-  ]
-}, { quoted: message })
+})
 ```
-</details>
----
-#### 🎥 Rich Video
-> Video embed as AI animated media (`GenAIImaginePrimitive` with `imagine_type: ANIMATE`).
+</details>
 <details>
-<summary><b>Shorthand URL</b></summary>
+<summary><b>🎥 Rich Video — <code>richVideo</code> / <code>richVideo</code> builder</b></summary>
+**Shorthand:**
 ```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>
-<details>
-<summary><b>Full Options</b></summary>
+**Full options:**
 ```js
 await sock.sendMessage(jid, {
   richVideo: {
     url: 'https://example.com/clip.mp4',
-    mimeType: 'video/mp4',        // default: 'video/mp4'
-    duration: 15,                   // seconds, default: 10
-    fallbackText: 'Preview video' // default: '[ VIDEO - PontaCT ]'
+    mimeType: 'video/mp4',
+    duration: 15,
+    fallbackText: 'Preview video'
   }
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Inside items / richResponse</b></summary>
+**Builder:**
 ```js
-// items
 await sock.sendMessage(jid, {
   items: [
-    { 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 } }
+    build.richVideo('https://example.com/clip.mp4')
   ]
-}, { quoted: message })
+})
 ```
-</details>
----
-#### 💡 Rich Suggestions
-> Follow-up prompt pills — like native AI chat buttons.
+</details>
 <details>
-<summary><b>Shorthand</b></summary>
+<summary><b>💡 Rich Suggestions — <code>richSuggestions</code> / <code>richSuggest</code></b></summary>
+**Direct:**
 ```js
 await sock.sendMessage(jid, {
   richSuggestions: ['Coba lagi', 'Lihat detail', 'Batalkan']
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Inside items / richResponse</b></summary>
+**Builder:**
 ```js
-// items
 await sock.sendMessage(jid, {
   items: [
-    { 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'] }
+    build.richSuggest('Lihat detail')
   ]
-}, { quoted: message })
+})
 ```
-</details>
----
-#### 🔣 Rich LaTeX
-> Math formula rendering as `GenAILatexItem` inline entity. `url` points to a rendered formula image (PNG/JPG from external LaTeX renderer).
+</details>
 <details>
-<summary><b>Shorthand URL</b></summary>
+<summary><b>🔣 Rich LaTeX — <code>richLatex</code></b></summary>
+**Shorthand URL:**
 ```js
 await sock.sendMessage(jid, {
   richLatex: 'https://latex.codecogs.com/png.latex?E%3Dmc%5E2'
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Full Options</b></summary>
+**Full options:**
 ```js
 await sock.sendMessage(jid, {
   richLatex: {
     url: 'https://latex.codecogs.com/png.latex?E%3Dmc%5E2',
-    text: 'E = mc²',     // label & fallback
-    width: 120,            // default: 100
-    height: 60,            // default: 100
-    font_height: 83.33,    // default: 83.33
-    padding: 15            // default: 15
+    text: 'E = mc²',
+    width: 120,
+    height: 60,
+    font_height: 83.33,
+    padding: 15
   }
 }, { quoted: message })
 ```
-</details>
-<details>
-<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
-> Product card(s) as `GenAIProductItemCardPrimitive`. Object = single card, Array = horizontal scroll carousel.
 <details>
-<summary><b>Single Product</b></summary>
+<summary><b>🛍️ Rich Product — <code>richProduct</code> / <code>richProduct</code> builder</b></summary>
+**Single product:**
 ```js
 await sock.sendMessage(jid, {
   richProduct: {
     title: 'Sepatu Adidas Samba',
     price_display_string: 'Rp 1.200.000',
-    description: 'Sepatu casual ikonik, tersedia berbagai ukuran.',
+    description: 'Sepatu casual ikonik.',
     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>
-<details>
-<summary><b>Product Carousel</b></summary>
+**Carousel:**
 ```js
 await sock.sendMessage(jid, {
   richProduct: [
-    {
-      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 }
-    }
+    { title: 'Sepatu A', price_display_string: 'Rp 500.000' },
+    { title: 'Sepatu B', price_display_string: 'Rp 750.000' }
   ]
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Inside items / richResponse</b></summary>
+**Builder:**
 ```js
-// items
 await sock.sendMessage(jid, {
   items: [
-    { 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' }] }
+    build.richProduct({
+      title: 'Produk A',
+      price_display_string: 'Rp 99.000'
+    })
   ]
-}, { quoted: message })
+})
 ```
-</details>
----
-#### 📰 Rich Post
-> Post card(s) as `GenAIPostPrimitive`. Object = single post, Array = carousel.
+</details>
 <details>
-<summary><b>Single Post</b></summary>
+<summary><b>📰 Rich Post — <code>richPost</code> / <code>richPost</code> builder</b></summary>
 ```js
 await sock.sendMessage(jid, {
@@ -1177,29 +1002,25 @@ await sock.sendMessage(jid, {
   }
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Post Carousel</b></summary>
+**Builder:**
 ```js
 await sock.sendMessage(jid, {
-  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' }
+  items: [
+    build.richPost({
+      title: 'Post PontaLabs',
+      author_display_name: '@pontalabs',
+      media_url: 'https://example.com/post.jpg'
+    })
   ]
-}, { quoted: message })
+})
 ```
-</details>
----
-#### 🎬 Rich Reels
-> Reels carousel as `GenAIReelPrimitive` with `contentItemsMetadata`. Auto-injects `richResponseSourcesMetadata` with `provider: 'PontaCT'`.
+</details>
 <details>
-<summary><b>Single Reel</b></summary>
+<summary><b>🎬 Rich Reels — <code>richReels</code> / <code>richReels</code> builder</b></summary>
 ```js
 await sock.sendMessage(jid, {
@@ -1217,352 +1038,405 @@ await sock.sendMessage(jid, {
   }
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Reels Carousel</b></summary>
+**Builder:**
 ```js
 await sock.sendMessage(jid, {
-  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'
-    }
+  items: [
+    build.richReels([{
+      title: '@creator',
+      thumbnailUrl: 'https://example.com/thumb.jpg',
+      videoUrl: 'https://example.com/reel.mp4'
+    }])
   ]
-}, { quoted: message })
+})
 ```
-</details>
-<details>
-<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
-> Search result source list as `GenAISearchResultPrimitive`. Accepts full objects **or** shorthand `[faviconUrl, sourceUrl, displayName]`.
 <details>
-<summary><b>Shorthand Array</b></summary>
+<summary><b>🔍 Rich Sources — <code>richSources</code> / <code>richSource</code></b></summary>
+**Shorthand:**
 ```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://github.com/favicon.ico', 'https://github.com/nodejs/node', 'GitHub']
+    ['https://nodejs.org/favicon.ico', 'https://nodejs.org/en/docs', 'Node.js Docs']
   ]
 }, { quoted: message })
 ```
-</details>
-<details>
-<summary><b>Full Object</b></summary>
+**Full object:**
 ```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 })
 ```
+**Builder:**
+```js
+await sock.sendMessage(jid, {
+  items: [
+    build.richSource([
+      ['https://example.com/favicon.ico', 'https://example.com', 'Example']
+    ])
+  ]
+})
+```
 </details>
 <details>
-<summary><b>Mixed Format</b></summary>
+<summary><b>📌 Rich Tip, Footer & Metadata — <code>richTip</code> / <code>richFooter</code> / <code>richMetadata</code></b></summary>
 ```js
 await sock.sendMessage(jid, {
-  richSources: [
-    ['https://wikipedia.org/fav.ico', 'https://wikipedia.org', 'Wikipedia'],
-    { source_type: 'THIRD_PARTY', source_display_name: 'Docs', source_url: 'https://docs.example.com' }
-  ]
+  richTip: 'Dihasilkan oleh AI · PontaLabs'
+}, { quoted: message })
+await sock.sendMessage(jid, {
+  richFooter: '© PontaLabs · Data bersumber dari layanan publik'
 }, { quoted: message })
 ```
-</details>
----
+**Builder:**
-#### 📌 Rich Tip & Footer
+```js
+await sock.sendMessage(jid, {
+  items: [
+    build.richTip('AI-generated content'),
+    build.richMetadata('PontaLabs Rich Message'),
+    build.richFooter('© PontaLabs')
+  ]
+})
+```
-> `richTip` — small metadata text above/center of message.
-> `richFooter` — metadata text below message (disclaimer / branding).
+</details>
 <details>
-<summary><b>Rich Tip</b></summary>
+<summary><b>🧩 Rich FOA Text — <code>richFOAText</code></b></summary>
 ```js
 await sock.sendMessage(jid, {
-  richTip: 'Dihasilkan oleh AI · pontalabs v0.3.4'
-}, { quoted: message })
+  items: [
+    build.richFOAText('Halo dari FOA Rich Text')
+  ]
+})
 ```
 </details>
 <details>
-<summary><b>Rich Footer</b></summary>
+<summary><b>🧱 Rich Widget — <code>richWidget</code></b></summary>
 ```js
 await sock.sendMessage(jid, {
-  richFooter: '© 2025 PontaCT · Data bersumber dari layanan publik'
-}, { quoted: message })
+  items: [
+    build.richWidget({
+      /* widget payload */
+    })
+  ]
+})
 ```
 </details>
 <details>
-<summary><b>Inside items / richResponse</b></summary>
+<summary><b>🔀 Mixed Rich — <code>items</code></b></summary>
+Semua Rich item dapat dicampur dalam satu `items`. Urutan array menjadi urutan tampilan.
 ```js
-// items
 await sock.sendMessage(jid, {
   items: [
-    { text: 'Hasil pencarian:' },
-    { sources: [['https://fav.ico', 'https://example.com', 'Example']] },
-    { tip: 'AI-generated content' },
-    { footer: '© PontaCT Baileys' }
+    { 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')
   ]
 }, { 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>
-// richResponse
+</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`.
+**Basic:**
+```js
 await sock.sendMessage(jid, {
   richResponse: [
-    { text: 'Summary di sini.' },
-    { footer: '© PontaCT · pontalabs' }
+    { text: '*Hasil:* Node.js adalah runtime JavaScript.' },
+    { code: 'node --version', language: 'bash' },
+    { suggestions: ['Lihat docs', 'Install'] },
+    { footer: 'PontaLabs' }
   ]
 }, { quoted: message })
 ```
-</details>
----
+**Inline citation:**
-#### 🔀 Rich Mixed — `items`
+```js
+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'
+      }
+    }]
+  }]
+}, { quoted: message })
+```
-> Combine all rich types in any order. Array order = display order.
+**Table di `richResponse`:**
-**Valid keys in `items`:**
+```js
+await sock.sendMessage(jid, {
+  richResponse: [{
+    table: [
+      { items: ['Version', 'LTS', 'Release'], isHeading: true },
+      { items: ['22.x', 'Yes', '2024'], isHeading: false }
+    ]
+  }]
+})
+```
-| Key | Type |
-|:---|:---|
-| `{ text }` | Rich text |
-| `{ code, language }` | Code block |
-| `{ table }` | Table |
-| `{ images }` | Image grid |
-| `{ videoUrl, mimeType?, duration? }` | Video embed |
-| `{ suggestions }` | Suggestion pills |
-| `{ latexUrl, latexText?, latexWidth?, latexHeight? }` | LaTeX formula |
-| `{ product }` | Product card(s) |
-| `{ post }` | Post card(s) |
-| `{ reels }` | Reels carousel |
-| `{ sources }` | Search sources |
-| `{ tip }` | Tip metadata |
-| `{ footer }` | Footer metadata |
+> Berbeda dari `table` top-level / `items`, format table di `richResponse` harus berupa array row siap-pakai.
+</details>
 <details>
-<summary><b>Text + Code + Table</b></summary>
+<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:**
 ```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: [
-    { 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 })
+  items: [button]
+})
+```
+**ButtonV2:**
+```js
+const buttons = build.buttonV2()
+  .setBody('Pilih aksi')
+  .setFooter('PontaLabs')
+  .addButton('Yes')
+  .addButton('No')
+await sock.sendMessage(jid, {
+  items: [buttons]
+})
+```
+**Carousel:**
+```js
+const carousel = build.carousel()
+  .setBody('Pilih produk')
+  .setFooter('PontaLabs')
+  .addCard(card)
+await sock.sendMessage(jid, {
+  items: [carousel]
+})
 ```
+> `build.button()`, `build.buttonV2()`, dan `build.carousel()` tidak membutuhkan `sock` saat dibuat. Builder hanya menghasilkan payload.
 </details>
 <details>
-<summary><b>Text + Images + Video + Suggestions</b></summary>
+<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: [
-    { 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 })
+    build.richText('⏳ Memproses...'),
+    build.richText('🔍 Mencari data...'),
+    build.richText('✅ Selesai!')
+  ],
+  buildDelay: 1000
+})
 ```
-</details>
-<details>
-<summary><b>Full Mixed (all types)</b></summary>
+Dengan `buildDelay: 1000`, item berikutnya diproses setiap 1 detik dan update tetap menggunakan message ID target yang sama.
+**Custom message ID:**
 ```js
 await sock.sendMessage(jid, {
+  messageId: 'MY_MESSAGE_ID',
   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 })
+    build.richText('Build 1'),
+    build.richText('Build 2')
+  ],
+  buildDelay: 1000
+})
 ```
+> `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>
-#### 🔗 Rich Response — `richResponse`
+Untuk state, node ID, replace, insert, delete, dan edit message gunakan `build.AIRich(sock)`.
-> Full array mode supporting all types including inline citations via `inlineEntities`.
+```js
+const ai = build.AIRich(sock)
-**Valid keys in `richResponse`:**
+ai.addText('⏳ Loading...', { id: 'status' })
+ai.addTip('Mohon tunggu')
-| Key | Type |
-|:---|:---|
-| `{ text, inlineEntities? }` | Text + optional citation/hyperlink |
-| `{ code, language }` | Code block |
-| `{ table, title? }` | Table — ⚠️ format beda dari `items`/top-level: `table` di sini harus array baris siap-pakai `[{ items: [...], isHeading }]`, **bukan** `{ headers, rows }` |
-| `{ images }` | Image grid |
-| `{ video }` | Video embed |
-| `{ suggestions }` | Suggestion pills |
-| `{ latex }` | LaTeX formula |
-| `{ product }` | Product card(s) |
-| `{ post }` | Post card(s) |
-| `{ reels }` | Reels carousel |
-| `{ sources }` | Search sources |
-| `{ tip }` | Tip metadata |
-| `{ footer }` | Footer metadata |
+await ai.send(jid)
-<details>
-<summary><b>Inline Citation</b></summary>
+ai.addText('✅ Selesai!', { replace: 'status' })
+ai.delete('status')
+ai.addTip('Tambahan', { insertAt: 'status' })
+```
+**Contoh edit:**
 ```js
-await sock.sendMessage(jid, {
-  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 })
+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>
 <details>
-<summary><b>Full Response — all types at once</b></summary>
+<summary><b>⚙️ Rich Options — <code>aiForwarded</code></b></summary>
+`aiForwarded` menambahkan label forwarded-from-AI-bot pada `contextInfo`.
 ```js
 await sock.sendMessage(jid, {
-  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' }
-  ]
+  richText: 'Pesan dengan label AI bot',
+  aiForwarded: true
 }, { quoted: message })
 ```
-</details>
----
+Bisa digunakan bersama `richText`, `items`, `richResponse`, `richHtml`, dan key Rich lainnya.
-#### ⚙️ Rich Options
+</details>
 <details>
-<summary><b><code>aiForwarded</code> — toggle label "Diteruskan dari bot AI"</b></summary>
+<summary><b>🔌 Legacy Compatibility</b></summary>
-> 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).
+API Rich lama tetap kompatibel:
 ```js
 await sock.sendMessage(jid, {
-  richText: 'Pesan dengan label AI bot',
-  aiForwarded: true
-}, { quoted: message })
+  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>
 ---