@pontalabs/baileys 1.1.7 → 1.1.9

package/README.md

@@ -584,6 +584,111 @@ 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.
+
+**Prinsip kompatibilitas:**
+
+- `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
+
+```js
+import { build, AIRich } from '@pontalabs/baileys'
+```
+
+#### Quick Start
+
+```js
+const ai = build.richText(sock, 'Halo! 👋')
+
+ai.addTip('Pesan ini dibuat dengan Rich Builder')
+
+await ai.send(jid)
+```
+
+#### Builder Factories
+
+| 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*()`:
+
+```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')
+
+await ai.send(jid)
+```
+
+#### Edit Message
+
+`AIRich` menyimpan struktur dan ID section sehingga pesan yang sudah dikirim dapat dimanipulasi.
+
+```js
+const ai = build.AIRich(sock)
+ai.addText('Loading...')
+
+const sent = await ai.send(jid)
+
+// Tambah section baru
+ai.addText('Selesai!')
+
+// Kirim perubahan sebagai protocol edit
+await ai.sendEdit(jid, sent.key.id)
+```
+
+Jika ingin membuat payload edit tanpa langsung mengirim:
+
+```js
+const editMessage = await ai.buildEdit(jid, sent.key.id)
+```
+
+#### Load Message Existing
+
+Builder juga dapat memuat Rich AI message yang sudah ada:
+
+```js
+const ai = build.AIRich(sock)
+ai.loadFrom(existingMessage)
+
+// Manipulasi builder sesuai kebutuhan
+// ai.replace(...)
+// ai.delete(...)
+// ai.insertAt(...)
+
+await ai.sendEdit(jid, existingMessage.key.id)
+```
+
+> **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' })`.
+
+---
+
 ### 🤖 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,57 @@
+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;
+  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>;
+  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: (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;
+};