@pontalabs/baileys 1.1.8 → 1.1.10

package/README.md

@@ -584,6 +584,123 @@ await sock.sendMessage(jid, {
 
 ---
 
+### 🧱 Rich Builder API — `build.*`
+
+`build.*` adalah cara singkat untuk membuat **Rich AI item** yang langsung bisa dipakai di `sock.sendMessage()`.
+
+> **Tidak perlu import `build`.** Package mengekspos `build` secara global saat dimuat.
+
+#### 🚀 Cara paling sederhana
+
+```js
+await sock.sendMessage(jid, {
+  items: [
+    build.richText('Halo! 👋'),
+    build.richCode('console.log("hello")', 'javascript'),
+    build.richTip('Selesai!')
+  ]
+})
+```
+
+Factory `build.rich*()` **tidak mengirim pesan sendiri**. Mereka hanya membuat item payload. Pengiriman tetap menggunakan API Baileys biasa: `sock.sendMessage()`.
+
+#### ✨ Semua factory
+
+| 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 |
+
+#### 🧩 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 untuk edit / delete
+
+Untuk kebutuhan yang benar-benar membutuhkan state dan manipulasi node, gunakan `build.AIRich(sock)`.
+
+```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' })
+```
+
+> `replace` dan `insertAt` adalah **options pada `add*()`**, bukan method `ai.replace()` atau `ai.insertAt()`.
+
+#### 📝 Contoh workflow 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)
+```
+
+#### 🔌 API lama tetap kompatibel
+
+```js
+await sock.sendMessage(jid, {
+  richText: 'Halo'
+})
+
+await sock.sendMessage(jid, {
+  items: [
+    { richText: 'Halo' },
+    { richTip: 'Testing' }
+  ]
+})
+```
+
+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.

package/lib/Socket/messages-send.js

@@ -1347,6 +1347,16 @@ export const makeMessagesSocket = (config) => {
                     additionalAttributes,
                     additionalNodes
                 });
+                // Semua AI Rich memakai bypass-download secara default; opt-out dengan bypassDownload:false.
+                const isRichAiContent = !!(fullMsg.message?.botForwardedMessage?.message?.richResponseMessage || fullMsg.message?.richResponseMessage);
+                if (isRichAiContent && options.bypassDownload !== false) {
+                    const editMessage = await generateWAMessageFromContent(jid, {
+                        botForwardedMessage: { message: { protocolMessage: {
+                            key: { remoteJid: jid, fromMe: true, id: fullMsg.key.id }, type: 14, editedMessage: fullMsg.message
+                        } } }
+                    }, { messageId: generateMessageIDV2(sock.user?.id) });
+                    await relayMessage(jid, editMessage.message, { messageId: editMessage.key.id });
+                }
                 if (config.emitOwnEvents) {
                     process.nextTick(async () => {
                         await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));

package/lib/Utils/index.d.ts

@@ -22,3 +22,4 @@ export * from "./companion-reg-client-utils.js";
 export * from "./identity-change-handler.js";
 export * from "./stanza-ack.js";
 //# sourceMappingURL=index.d.ts.map
+export * from './mbuilder.js';

package/lib/Utils/index.js

@@ -22,3 +22,4 @@ export * from './companion-reg-client-utils.js';
 export * from './identity-change-handler.js';
 export * from './stanza-ack.js';
 //# sourceMappingURL=index.js.map
+export * from './mbuilder.js';

package/lib/Utils/mbuilder.d.ts

@@ -0,0 +1,55 @@
+export declare const VERSION: string;
+export declare class Button { constructor(client: any, options?: any); loadFrom(data: any): this; build(jid: string, options?: any): any; send(jid: string, options?: any): Promise<any>; [key: string]: any; }
+export declare class ButtonV2 { constructor(client: any, options?: any); loadFrom(data: any): this; build(jid: string, options?: any): any; send(jid: string, options?: any): Promise<any>; [key: string]: any; }
+export declare class Carousel { constructor(client: any, options?: any); loadFrom(data: any): this; build(jid: string, options?: any): any; send(jid: string, options?: any): Promise<any>; [key: string]: any; }
+export declare class AIRich {
+  constructor(client: any, options?: { dynamic?: boolean; unsupportedTypeAlert?: boolean });
+  loadFrom(msg: any): this;
+  setResponseId(id: string): this;
+  refreshResponseId(): this;
+  setBotResponseId(id: string): this;
+  refreshBotResponseId(): this;
+  createAlert(type: any): any;
+  addText(text: string, options?: any): this;
+  addFOAText(text: string, options?: any): this;
+  addCode(language: string, code: string, options?: any): this;
+  addTable(table: any, options?: any): this;
+  addSource(sources?: any[], options?: any): this;
+  addReels(reelsItems?: any[], options?: any): this;
+  addImage(imageUrl: any, options?: any): this;
+  addVideo(videoUrl: any, options?: any): this;
+  addProduct(data?: any, options?: any): this;
+  addPost(data?: any, options?: any): this;
+  addMetadata(text: string, options?: any): this;
+  addTip(text: string, options?: any): this;
+  addWidget(data: any, options?: any): this;
+  addFooterAction(data: any, options?: any): this;
+  addSuggest(suggestion: any, options?: any): this;
+  addSection(section: any, options?: any): this;
+  addSubmessage(submessage: any, options?: any): this;
+  delete(id: 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>;
+  sendEdit(jid?: string, id?: string, options?: any): Promise<any>;
+  [key: string]: any;
+}
+export declare class Toolkit { [key: string]: any; }
+export declare const build: {
+  AIRich: (client: 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;
+};