@pontalabs/baileys 1.1.9 → 1.1.10

package/README.md

@@ -586,108 +586,120 @@ await sock.sendMessage(jid, {
 
 ### 🧱 Rich Builder API — `build.*`
 
-> Builder API untuk membuat, mengedit, mengganti, menyisipkan, atau menghapus bagian Rich AI. Namespace `build.*` sengaja dipisahkan dari shortcut `sendMessage` agar API Baileys yang sudah ada tetap kompatibel.
+`build.*` adalah cara singkat untuk membuat **Rich AI item** yang langsung bisa dipakai di `sock.sendMessage()`.
 
-**Prinsip kompatibilitas:**
+> **Tidak perlu import `build`.** Package mengekspos `build` secara global saat dimuat.
 
-- `richText`, `code`, `table`, `items`, `richResponse`, dan shortcut lama lainnya **tetap sama**.
-- `build.richText()`, `build.richCode()`, dan seterusnya adalah **factory builder**, bukan pengganti shortcut lama.
-- Factory `build.*` mengembalikan instance `AIRich`, sehingga bisa dilanjutkan dengan operasi builder seperti `addText()`, `replace()`, `delete()`, `insertAt()`, `buildEdit()`, dan `sendEdit()`.
-
-#### Import
+#### 🚀 Cara paling sederhana
 
 ```js
-import { build, AIRich } from '@pontalabs/baileys'
+await sock.sendMessage(jid, {
+  items: [
+    build.richText('Halo! 👋'),
+    build.richCode('console.log("hello")', 'javascript'),
+    build.richTip('Selesai!')
+  ]
+})
 ```
 
-#### Quick Start
+Factory `build.rich*()` **tidak mengirim pesan sendiri**. Mereka hanya membuat item payload. Pengiriman tetap menggunakan API Baileys biasa: `sock.sendMessage()`.
 
-```js
-const ai = build.richText(sock, 'Halo! 👋')
+#### ✨ Semua factory
 
-ai.addTip('Pesan ini dibuat dengan Rich Builder')
+| Factory | Contoh | Hasil |
+| --- | --- | --- |
+| `build.richText(text)` | `build.richText('Halo')` | Text |
+| `build.richFOAText(text)` | `build.richFOAText('Halo')` | FOA text |
+| `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 |
 
-await ai.send(jid)
+#### 🧩 Campur dengan shortcut lama
+
+API lama **tetap dipertahankan**. Builder bisa dicampur dengan object Rich AI biasa di `items`.
+
+```js
+await sock.sendMessage(jid, {
+  items: [
+    { richText: 'Shortcut lama tetap jalan' },
+    build.richText('Item dari Builder'),
+    { richTip: 'Shortcut lama' },
+    build.richTip('Tip dari Builder')
+  ]
+})
 ```
 
-#### Builder Factories
+#### 🛠️ Builder untuk edit / delete
 
-| Factory | Fungsi |
-|:---|:---|
-| `build.richText(sock, text)` | Rich markdown text |
-| `build.richFOAText(sock, text)` | FOA text |
-| `build.richCode(sock, language, code)` | Code block |
-| `build.richTable(sock, table)` | Table |
-| `build.richSource(sock, sources)` | Sources |
-| `build.richReels(sock, reelsItems)` | Reels |
-| `build.richImage(sock, imageUrl)` | Image |
-| `build.richVideo(sock, videoUrl)` | Video |
-| `build.richProduct(sock, data)` | Product |
-| `build.richPost(sock, data)` | Post |
-| `build.richMetadata(sock, text)` | Metadata |
-| `build.richTip(sock, text)` | Tip |
-| `build.richWidget(sock, data)` | Widget |
-| `build.richFooterAction(sock, data)` | Footer action |
-| `build.richSuggest(sock, suggestion)` | Suggestions |
-| `build.AIRich(sock)` | Empty AIRich builder |
-
-#### Build Banyak Section
-
-Untuk beberapa section, gunakan `build.AIRich()` lalu chaining `add*()`:
+Untuk kebutuhan yang benar-benar membutuhkan state dan manipulasi node, gunakan `build.AIRich(sock)`.
 
 ```js
 const ai = build.AIRich(sock)
 
-ai.addText('Hasil pencarian:')
-ai.addCode('javascript', 'console.log("hello")')
-ai.addTip('Selesai diproses.')
-ai.addImage('https://example.com/image.jpg')
+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' })
 ```
 
-#### Edit Message
+> `replace` dan `insertAt` adalah **options pada `add*()`**, bukan method `ai.replace()` atau `ai.insertAt()`.
 
-`AIRich` menyimpan struktur dan ID section sehingga pesan yang sudah dikirim dapat dimanipulasi.
+#### 📝 Contoh workflow edit
 
 ```js
 const ai = build.AIRich(sock)
-ai.addText('Loading...')
-
-const sent = await ai.send(jid)
+ai.addText('⏳ Memproses...', { id: 'answer' })
 
-// Tambah section baru
-ai.addText('Selesai!')
+await ai.send(jid)
 
-// Kirim perubahan sebagai protocol edit
-await ai.sendEdit(jid, sent.key.id)
-```
+const result = await getAIResponse()
 
-Jika ingin membuat payload edit tanpa langsung mengirim:
+ai.addText(result, { replace: 'answer' })
+ai.addTip('Generated by AI')
 
-```js
-const editMessage = await ai.buildEdit(jid, sent.key.id)
+await ai.sendEdit(jid)
 ```
 
-#### Load Message Existing
-
-Builder juga dapat memuat Rich AI message yang sudah ada:
+#### 🔌 API lama tetap kompatibel
 
 ```js
-const ai = build.AIRich(sock)
-ai.loadFrom(existingMessage)
-
-// Manipulasi builder sesuai kebutuhan
-// ai.replace(...)
-// ai.delete(...)
-// ai.insertAt(...)
+await sock.sendMessage(jid, {
+  richText: 'Halo'
+})
 
-await ai.sendEdit(jid, existingMessage.key.id)
+await sock.sendMessage(jid, {
+  items: [
+    { richText: 'Halo' },
+    { richTip: 'Testing' }
+  ]
+})
 ```
 
-> **Catatan:** `build.richText()` membutuhkan `sock` karena hasilnya adalah instance `AIRich`, bukan object shortcut `sendMessage`. Untuk penggunaan shortcut biasa, tetap gunakan `sock.sendMessage(jid, { richText: 'Halo' })`.
+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
 

package/lib/Utils/mbuilder.d.ts

@@ -28,8 +28,6 @@ export declare class AIRich {
   addSection(section: any, options?: any): this;
   addSubmessage(submessage: any, options?: any): this;
   delete(id: any): this;
-  replace(id: any, content: any): this;
-  insertAt(index: number, content: any): this;
   build(jid: string, options?: any): Promise<any>;
   buildEdit(targetJid: string, targetId: string, options?: any): Promise<any>;
   send(jid: string, options?: any): Promise<any>;
@@ -39,19 +37,19 @@ export declare class AIRich {
 export declare class Toolkit { [key: string]: any; }
 export declare const build: {
   AIRich: (client: any, options?: any) => AIRich;
-  richText: (client: any, text: string, options?: any) => AIRich;
-  richFOAText: (client: any, text: string, options?: any) => AIRich;
-  richCode: (client: any, language: string, code: string, options?: any) => AIRich;
-  richTable: (client: any, table: any, options?: any) => AIRich;
-  richSource: (client: any, sources: any[], options?: any) => AIRich;
-  richReels: (client: any, reelsItems: any[], options?: any) => AIRich;
-  richImage: (client: any, imageUrl: any, options?: any) => AIRich;
-  richVideo: (client: any, videoUrl: any, options?: any) => AIRich;
-  richProduct: (client: any, data: any, options?: any) => AIRich;
-  richPost: (client: any, data: any, options?: any) => AIRich;
-  richMetadata: (client: any, text: string, options?: any) => AIRich;
-  richTip: (client: any, text: string, options?: any) => AIRich;
-  richWidget: (client: any, data: any, options?: any) => AIRich;
-  richFooterAction: (client: any, data: any, options?: any) => AIRich;
-  richSuggest: (client: any, suggestion: any, options?: any) => AIRich;
+  richText: (text: string) => any;
+  richFOAText: (text: string) => any;
+  richCode: (code: string, language?: string) => any;
+  richTable: (table: any) => any;
+  richSource: (sources: any) => any;
+  richReels: (reelsItems: any) => any;
+  richImage: (imageUrl: any) => any;
+  richVideo: (videoUrl: any) => any;
+  richProduct: (data: any) => any;
+  richPost: (data: any) => any;
+  richMetadata: (text: string) => any;
+  richTip: (text: string) => any;
+  richWidget: (data: any) => any;
+  richFooterAction: (data: any) => any;
+  richSuggest: (suggestion: any) => any;
 };

package/lib/Utils/mbuilder.js

@@ -3174,31 +3174,38 @@ class AIRich extends BaseBuilder {
 
 
 /**
- * Shortcut namespace for the AIRich builder.
+ * `build.*` creates lightweight Rich AI items for `sock.sendMessage()`.
  *
- * Existing Baileys sendMessage shortcuts such as `richText` remain unchanged.
- * These helpers intentionally live under `build.*` so builder usage is explicit.
- * Each rich* helper creates an AIRich instance and appends the corresponding
- * primitive, making it ready for further edits (`replace`, `delete`, etc.) or
- * `send()` / `build()`.
+ * Advanced editing is still available through `build.AIRich(sock)`.
+ * Keeping factories payload-only makes the common API simple:
+ *
+ *   await sock.sendMessage(jid, {
+ *     items: [build.richText('Hello'), build.richTip('Done')]
+ *   })
  */
 const build = {
 	AIRich: (client, options) => new AIRich(client, options),
-	richText: (client, text, options) => new AIRich(client).addText(text, options),
-	richFOAText: (client, text, options) => new AIRich(client).addFOAText(text, options),
-	richCode: (client, language, code, options) => new AIRich(client).addCode(language, code, options),
-	richTable: (client, table, options) => new AIRich(client).addTable(table, options),
-	richSource: (client, sources, options) => new AIRich(client).addSource(sources, options),
-	richReels: (client, reelsItems, options) => new AIRich(client).addReels(reelsItems, options),
-	richImage: (client, imageUrl, options) => new AIRich(client).addImage(imageUrl, options),
-	richVideo: (client, videoUrl, options) => new AIRich(client).addVideo(videoUrl, options),
-	richProduct: (client, data, options) => new AIRich(client).addProduct(data, options),
-	richPost: (client, data, options) => new AIRich(client).addPost(data, options),
-	richMetadata: (client, text, options) => new AIRich(client).addMetadata(text, options),
-	richTip: (client, text, options) => new AIRich(client).addTip(text, options),
-	richWidget: (client, data, options) => new AIRich(client).addWidget(data, options),
-	richFooterAction: (client, data, options) => new AIRich(client).addFooterAction(data, options),
-	richSuggest: (client, suggestion, options) => new AIRich(client).addSuggest(suggestion, options),
+	richText: (text) => ({ richText: text }),
+	richFOAText: (text) => ({ richFOAText: text }),
+	richCode: (code, language = 'javascript') => ({ richCode: code, language }),
+	richTable: (table) => ({ richTable: table }),
+	richSource: (sources) => ({ richSource: sources }),
+	richReels: (reelsItems) => ({ richReels: reelsItems }),
+	richImage: (imageUrl) => ({ richImage: imageUrl }),
+	richVideo: (videoUrl) => ({ richVideo: videoUrl }),
+	richProduct: (data) => ({ richProduct: data }),
+	richPost: (data) => ({ richPost: data }),
+	richMetadata: (text) => ({ richMetadata: text }),
+	richTip: (text) => ({ richTip: text }),
+	richWidget: (data) => ({ richWidget: data }),
+	richFooterAction: (data) => ({ richFooterAction: data }),
+	richSuggest: (suggestion) => ({ richSuggest: suggestion }),
 };
 
+// Expose the namespace globally so applications can use build.* without
+// importing another symbol. The named export remains available as well.
+if (!globalThis.build) {
+	globalThis.build = build;
+}
+
 export { VERSION, Button, ButtonV2, Carousel, AIRich, Toolkit, build };

package/lib/Utils/rich-message-utils.js

@@ -1517,6 +1517,23 @@ const mapVideoField = (data) => {
  *  jadi item internal fork ({richImage},{richVideo},{suggest}, dst). */
 const translateReadmeItem = (item) => {
     const out = {};
+    // Builder aliases: build.* returns lightweight items that can be passed
+    // directly to sendMessage({ items: [...] }).
+    if (item.richText != null) { out.text = item.richText; }
+    if (item.richFOAText != null) { out.foaText = item.richFOAText; }
+    if (item.richCode != null) { out.code = item.richCode; out.language = item.language; }
+    if (item.richTable != null) { out.table = item.richTable; }
+    if (item.richSource != null) { out.source = item.richSource; }
+    if (item.richReels != null) { out.reels = item.richReels; }
+    if (item.richImage != null) { out.richImage = item.richImage; }
+    if (item.richVideo != null) { out.richVideo = mapVideoField(item.richVideo); }
+    if (item.richProduct != null) { out.richProduct = mapProductFields(item.richProduct); }
+    if (item.richPost != null) { out.richPost = mapPostFields(item.richPost); }
+    if (item.richMetadata != null) { out.metadata = item.richMetadata; }
+    if (item.richTip != null) { out.tip = item.richTip; }
+    if (item.richWidget != null) { out.widget = item.richWidget; }
+    if (item.richFooterAction != null) { out.footerAction = item.richFooterAction; }
+    if (item.richSuggest != null) { out.suggest = item.richSuggest; }
     if (item.text != null) { out.text = item.text; if (item.inlineEntities) out.inlineEntities = item.inlineEntities; }
     if (item.code != null) { out.code = item.code; out.language = item.language; }
     if (item.table != null) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pontalabs/baileys",
   "type": "module",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "PontaLabs Baileys is a lightweight, modern, and customizable WhatsApp Web API library built on Baileys.",
   "keywords": [
     "whatsapp",