@blurose/baileys 1.1.1 → 1.1.2

package/README.md

@@ -1,6 +1,6 @@
 <h1 align='center'><img alt="Baileys logo" src="https://veracloud.biz.id/dEPF.jpg" height="auto"/><br/>Baileys Newsletter (blurose/baileys)</h1>
 
-<div align='center'>A WebSockets-based TypeScript library for interacting with the WhatsApp Web API, customized for Newsletter/Channel Media support.</div>
+<div align='center'>A WebSockets-based TypeScript library for interacting with the WhatsApp Web API, customized for Newsletter/Channel Media support and built-in Advanced Interactive Message Builders (MessageBuilder v4.6).</div>
 
 > [!IMPORTANT]
 > **This is a custom fork and patch of `@whiskeysockets/baileys` (`blurose/baileys`)**
@@ -8,6 +8,8 @@
 > Developed & Maintained by: **Xyraa Team** & **alfavz**.
 >
 > This version introduces stable and native support for sending media (audios, images, videos, and documents) to WhatsApp Channels / Newsletters, bypassing E2E encryption for public channel broadcasts, and properly formatting the output stanzas (`type="media"` and `mediatype` metadata) which is currently unsupported in the official WhiskeySockets repository.
+>
+> In addition, it integrates **MessageBuilder v4.6** directly into the library, allowing you to generate advanced UI components (Buttons, Carousels, Native Flows, and AI Rich Responses) natively and easily.
 
 ---
 
@@ -24,19 +26,14 @@ Use at your own discretion. Do not spam people with this. We discourage any stal
 - **No Selenium/Chromium**: Baileys does not require Selenium or any other browser to interface with WhatsApp Web, saving massive amounts of RAM.
 - **Multi-Device Support**: Interacts natively with the multi-device and web versions of WhatsApp.
 - **Newsletter Media Patch**: Automatically maps correct CDN upload endpoints and formats stanzas so media displays perfectly in WhatsApp Channels.
+- **MessageBuilder v4.6 (Built-in)**: Chainable API for creating Buttons, Carousels, Native Flow messages, and AI Rich Response payloads natively from the library.
 
 ## Install
 
 To install this custom patched version into your project, use:
 
 ```bash
-npm install github:alfavz/blurose
-```
-
-Or when published to npm:
-
-```bash
-npm install blurose/baileys
+npm install @blurose/baileys
 ```
 
 Then import it in your code:
@@ -63,6 +60,11 @@ import makeWASocket from 'baileys' // (or whichever alias is configured)
 - [Whatsapp IDs Explain](#whatsapp-ids-explain)
 - [Utility Functions](#utility-functions)
 - [Sending Messages](#sending-messages)
+- [MessageBuilder Documentation (UI Components)](#messagebuilder-documentation-ui-components)
+    - [1. Button Builder (Button V1)](#1-button-builder-button-v1)
+    - [2. ButtonV2 Builder (Native Flow)](#2-buttonv2-builder-native-flow)
+    - [3. Carousel Builder](#3-carousel-builder)
+    - [4. AIRich Builder (AI Rich Response)](#4-airich-builder-ai-rich-response)
 - [Modify Messages](#modify-messages)
 - [Manipulating Media Messages](#manipulating-media-messages)
 - [Reject Call](#reject-call)
@@ -160,6 +162,124 @@ await sock.sendMessage(channelJid, {
 
 ---
 
+## MessageBuilder Documentation (UI Components)
+
+You can import the builders directly from the library:
+```javascript
+const { Button, ButtonV2, Carousel, AIRich } = require('@blurose/baileys');
+// or when using ESM:
+// import { Button, ButtonV2, Carousel, AIRich } from 'baileys';
+```
+
+### 1. Button Builder (Button V1)
+Create interactive messages containing a title, subtitle, image, reply buttons, copy code buttons, URL buttons, and drop-down menu lists.
+
+```javascript
+await new Button(sock)
+    .setTitle('🚀 NIXCODE')
+    .setSubtitle('Interactive Message')
+    .setBody('Pilih menu di bawah')
+    .setFooter('© Nixel')
+    .setImage('https://cdn.ornzora.eu.cc/b57c0d1e-d7a6-4277-8739-8f6b1d9894e6-FIORA.jpg')
+    .addReply('📦 Menu', '.menu', { icon: 'DEFAULT' })
+    .addReply('👤 Profile', '.profile', { icon: 'REVIEW' })
+    .addUrl('🌐 Website', 'https://example.com', true, { icon: 'PROMOTION' })
+    .addCopy('📋 Copy Code', 'NIX-2026', { icon: 'DOCUMENT' })
+    .addSelection('📚 Pilih Kategori')
+    .makeSection('Main Menu')
+    .makeRow('🔥 HOT', 'Downloader', 'Download social media', '.dl')
+    .makeRow('⚡ FAST', 'AI Chat', 'Chat dengan AI', '.ai')
+    .send(m.chat, { quoted: m });
+```
+
+### 2. ButtonV2 Builder (Native Flow)
+Create clean Native Flow buttons (e.g. quick reply buttons) for professional bots.
+
+```javascript
+await new ButtonV2(sock)
+    .setTitle('🚀 NIXCODE')
+    .setSubtitle('Buttons Message')
+    .setBody('Halo dunia')
+    .setFooter('Footer Message')
+    .setThumbnail('https://cdn.ornzora.eu.cc/4d2905ce-3707-4ec0-998a-68a3d851629f-FIORA.jpg')
+    .addButton('👤 Profile', '.profile')
+    .addButton('📡 Menu', '.menu')
+    .send(m.chat, { quoted: m });
+```
+
+### 3. Carousel Builder
+Create beautiful horizontal sliding cards (swipeable cards) with images and dedicated actions for each card.
+
+```javascript
+await new Carousel(sock)
+    .setBody('🛍️ Product List')
+    .setFooter('Swipe untuk lihat')
+    .addCard(
+        await new Button(sock)
+            .setTitle('🍔 Burger')
+            .setBody('Burger terenak')
+            .setFooter('$5')
+            .setImage('https://cdn.ornzora.eu.cc/36df8c36-c74e-4dc2-bc03-87893f373cb4-FIORA.jpg')
+            .addReply('🛒 Buy', '.buy burger')
+            .toCard()
+    )
+    .addCard(
+        await new Button(sock)
+            .setTitle('🍕 Pizza')
+            .setBody('Pizza mozzarella')
+            .setFooter('$7')
+            .setImage('https://cdn.ornzora.eu.cc/36df8c36-c74e-4dc2-bc03-87893f373cb4-FIORA.jpg')
+            .addReply('🛒 Buy', '.buy pizza')
+            .toCard()
+    )
+    .send(m.chat, { quoted: m });
+```
+
+### 4. AIRich Builder (AI Rich Response)
+Generate AI Rich responses, including formatted Markdown text, citation numbers, auto suggestions, tables, products, reels, and video elements.
+
+```javascript
+await new AIRich(sock)
+    .setTitle('🚀 NIXCODE')
+    .setFooter('© Fiora Sylvie') 
+    .addSuggest("MessageBuilderV4.6") 
+    .addSuggest(['Nixel', 'NIXCODE', 'Fiora Sylvie', 'AIRich'])  
+    .addTip('Ini adalah text tip (Metadata Text)')
+    .addText(`
+# Halo Dunia
+## NIXCODE
+
+---
+
+=={ Yellow Text }==
+
+---
+
+Ini hyperlink:
+[Google](https://google.com)
+
+Ini auto citation:
+[](https://openai.com)
+    `)
+    .addProduct({
+        title: 'Fiora Sylvie', 
+        brand: 'Nixel', 
+        price: 'Rp 1000', 
+        sale_price: 'Rp 0', 
+        url: 'https://wa.me/6285188349341', 
+        image: "https://cdn.ornzora.eu.cc/152f4f0b-02fb-4d60-aacc-fc4cfa87ccdb-FIORA.jpg"
+    })
+    .addCode('javascript', 'console.log("Hello World");')
+    .addTable([
+        ['Nama', 'Role'],
+        ['[Nixel](https://wa.me/6285188349341)', 'Developer'],
+        ['Fiora Sylvie', 'Assistant']
+    ])
+    .send(m.chat, { quoted: m });
+```
+
+---
+
 # Credits & Acknowledgements
 - Forked from the official [WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys) project by **Rajeh Taher** and contributors.
 - Patch ideas and concepts incorporated from **wileys** package.

package/lib/Utils/messages.js

@@ -485,6 +485,34 @@ export const generateWAMessageContent = async (message, options) => {
             }
         };
     }
+    else if (hasNonNullishProperty(message, 'buttons')) {
+        const buttonsMessage = {
+            contentText: message.text || message.caption || '',
+            footerText: message.footer || '',
+            buttons: message.buttons,
+            headerType: 1
+        };
+        if (hasNonNullishProperty(message, 'image')) {
+            const { imageMessage } = await prepareWAMessageMedia({ image: message.image }, options);
+            buttonsMessage.imageMessage = imageMessage;
+            buttonsMessage.headerType = 4;
+        }
+        else if (hasNonNullishProperty(message, 'video')) {
+            const { videoMessage } = await prepareWAMessageMedia({ video: message.video }, options);
+            buttonsMessage.videoMessage = videoMessage;
+            buttonsMessage.headerType = 5;
+        }
+        else if (hasNonNullishProperty(message, 'document')) {
+            const { documentMessage } = await prepareWAMessageMedia({ document: message.document }, options);
+            buttonsMessage.documentMessage = documentMessage;
+            buttonsMessage.headerType = 3;
+        }
+        else if (hasNonNullishProperty(message, 'location')) {
+            buttonsMessage.locationMessage = message.location;
+            buttonsMessage.headerType = 6;
+        }
+        m.buttonsMessage = buttonsMessage;
+    }
     else {
         m = await prepareWAMessageMedia(message, options);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blurose/baileys",
   "type": "module",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "A WebSockets library for interacting with WhatsApp Web",
   "keywords": [
     "whatsapp",