@blurose/baileys 1.1.21 → 1.1.22

package/README.md

@@ -79,6 +79,13 @@ import makeWASocket from '@blurose/baileys'
 - [Blurose Custom Features](#blurose-custom-features)
     - [Buttons and Interactive Messages](#buttons-and-interactive-messages)
     - [A2UI Bloks Widgets](#a2ui-bloks-widgets)
+    - [MessageBuilder (Ported from Nixel V4.7)](#messagebuilder-ported-from-nixel-v47)
+        - [InteractiveBuilder — nativeFlowMessage Buttons](#interactivebuilder--nativeflowmessage-buttons)
+        - [sendInteractiveMessage — Raw nativeFlowMessage](#sendinteractivemessage--raw-nativeflowmessage)
+        - [AIRich — GenAI / AiRich Bubble](#airich--genai--airich-bubble)
+        - [Carousel](#carousel)
+        - [ButtonV2 (Deprecated)](#buttonv2-deprecated)
+        - [Toolkit — Media Utilities](#toolkit--media-utilities)
     - [Custom Pairing](#custom-pairing)
     - [Session Auto-Heal (Pre-Keys)](#session-auto-heal-pre-keys)
 - [Connecting Account](#connecting-account)
@@ -258,6 +265,264 @@ await sock.sendMessage(jid, {
 })
 ```
 
+
+---
+
+### MessageBuilder (Ported from Nixel V4.7)
+
+Semua class MessageBuilder dari [Nixel V4.7](https://gist.github.com/ValdazGT/adc8b767a082d18d12ff3e7f01b78651) sudah terintegrasi langsung ke library ini. Import langsung dari `@blurose/baileys` — tidak perlu file eksternal lagi.
+
+```ts
+import {
+    InteractiveBuilder,
+    sendInteractiveMessage,
+    AIRich,
+    Carousel,
+    ButtonV2,
+    Toolkit,
+} from '@blurose/baileys'
+```
+
+---
+
+#### InteractiveBuilder — nativeFlowMessage Buttons
+
+Fluent builder untuk mengirim pesan dengan button `quick_reply`, `cta_copy`, `cta_url`, `cta_call`, `send_location`, dan list menu `single_select`.
+
+```ts
+import { InteractiveBuilder } from '@blurose/baileys'
+
+// Button copy + reply
+await new InteractiveBuilder(conn, m.chat)
+    .text('Pilih aksi:')
+    .footer('Powered by blurose')
+    .addCopy('📋 Salin Kode Lokasi', 'LOC-JAKARTA-01')
+    .addReply('🗺️ Buka Google Maps', 'open_maps')
+    .send()
+
+// Button URL + Call + Location
+await new InteractiveBuilder(conn, m.chat)
+    .text('Hubungi kami:')
+    .addUrl('🌐 Website', 'https://example.com')
+    .addCall('📞 Telepon', '6281234567890')
+    .addLocation()
+    .quoted(m)
+    .send()
+
+// List Menu (single_select)
+await new InteractiveBuilder(conn, m.chat)
+    .text('Pilih produk top up:')
+    .addList('📦 Lihat Pilihan')
+        .addSection('🎮 Game')
+            .addRow('Mobile Legends', '100 Diamonds', 'ml_100')
+            .addRow('Free Fire', '100 Diamonds', 'ff_100')
+        .addSection('📺 Streaming')
+            .addRow('Spotify Premium', '1 Bulan', 'spotify_1m')
+            .addRow('Netflix', '1 Bulan', 'netflix_1m')
+    .send()
+```
+
+| Method | Keterangan |
+|---|---|
+| `.text(body)` | Teks isi pesan |
+| `.footer(text)` | Teks footer |
+| `.image(src, caption?)` | Header gambar (Buffer atau URL) |
+| `.video(src, caption?)` | Header video |
+| `.quoted(msg)` | Reply ke pesan tertentu |
+| `.addReply(text, id?)` | Button quick reply |
+| `.addCopy(text, code)` | Button salin teks |
+| `.addUrl(text, url, webview?)` | Button buka URL |
+| `.addCall(text, phone)` | Button telepon |
+| `.addLocation()` | Button kirim lokasi |
+| `.addList(buttonText)` | Buka list menu |
+| `.addSection(title)` | Tambah section di list |
+| `.addRow(title, desc?, id?)` | Tambah item di section |
+| `.send()` | Kirim pesan |
+
+---
+
+#### sendInteractiveMessage — Raw nativeFlowMessage
+
+Untuk yang sudah punya struktur `nativeFlowMessage` raw dan tidak mau ubah banyak kode.
+
+```ts
+import { sendInteractiveMessage } from '@blurose/baileys'
+
+await sendInteractiveMessage(conn, m.chat, {
+    body: 'Pilih aksi:',
+    footer: 'Powered by blurose',
+    nativeFlowMessage: {
+        buttons: [
+            {
+                name: 'cta_copy',
+                buttonParamsJson: JSON.stringify({
+                    display_text: '📋 Salin Kode Lokasi',
+                    copy_code: 'LOC-JAKARTA-01'
+                })
+            },
+            {
+                name: 'quick_reply',
+                buttonParamsJson: JSON.stringify({
+                    display_text: '🗺️ Buka Google Maps',
+                    id: 'open_maps'
+                })
+            }
+        ]
+    },
+    quoted: m
+})
+```
+
+---
+
+#### AIRich — GenAI / AiRich Bubble
+
+Builder untuk pesan AiRich (`botForwardedMessage`) — bubble ChatAI WhatsApp dengan teks markdown, kode, tabel, gambar, video, saran follow-up, dll.
+
+```ts
+import { AIRich } from '@blurose/baileys'
+
+// Teks + kode + saran
+await new AIRich(conn)
+    .setTitle('Hasil Bot')
+    .addText('Halo! Berikut hasilnya:')
+    .addCode('javascript', 'const x = 1 + 2\nconsole.log(x)')
+    .addTip('Coba tanya hal lain!')
+    .addSuggest(['Hitung lagi', 'Coba Python', 'Bantuan'])
+    .send(m.chat)
+
+// Tabel data
+await new AIRich(conn)
+    .addTable([
+        ['Nama', 'Harga', 'Stok'],
+        ['ML Diamonds', 'Rp 15.000', '✅'],
+        ['FF Diamonds', 'Rp 12.000', '✅'],
+    ])
+    .send(m.chat)
+
+// Edit pesan AiRich yang sudah ada
+const airich = new AIRich(conn).loadFrom(existingMsg)
+airich.addText('Update!')
+await airich.sendEdit(m.chat, existingMsg.key.id)
+```
+
+| Method | Keterangan |
+|---|---|
+| `.setTitle(text)` | Disclaimer/judul kecil di atas bubble |
+| `.addText(text)` | Teks markdown |
+| `.addCode(lang, code)` | Blok kode dengan syntax highlight |
+| `.addTable(arr)` | Tabel dari nested array string |
+| `.addImage(url/buffer)` | Gambar |
+| `.addVideo(url/buffer)` | Video |
+| `.addSource(sources)` | Kartu sumber referensi |
+| `.addReels(items)` | Kartu reels |
+| `.addProduct(data)` | Kartu produk |
+| `.addPost(data)` | Kartu post sosmed |
+| `.addWidget(data)` | Widget 3P custom |
+| `.addFooterAction(data)` | Tombol CTA bawah |
+| `.addSuggest(text/arr)` | Chip saran follow-up |
+| `.addTip(text)` | Teks tips ⓘ |
+| `.loadFrom(msg)` | Load dari pesan AiRich existing |
+| `.send(jid)` | Kirim pesan |
+| `.sendEdit(jid, id)` | Edit pesan AiRich yang sudah terkirim |
+
+---
+
+#### Carousel
+
+Builder untuk pesan carousel (swipe card) dengan media + button di setiap card.
+
+```ts
+import { Carousel } from '@blurose/baileys'
+import { prepareWAMessageMedia } from '@blurose/baileys'
+
+const imageMedia = await prepareWAMessageMedia(
+    { image: { url: 'https://example.com/img.png' } },
+    { upload: conn.waUploadToServer }
+)
+
+await new Carousel(conn)
+    .setBody('Pilih produk favorit kamu:')
+    .setFooter('Swipe untuk lihat lebih →')
+    .addCard({
+        header: {
+            hasMediaAttachment: true,
+            imageMessage: imageMedia.imageMessage
+        },
+        body: { text: 'ML Diamonds' },
+        footer: { text: 'Mulai Rp 5.000' },
+        nativeFlowMessage: {
+            buttons: [
+                { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: '🛒 Beli', id: 'buy_ml' }) }
+            ],
+            messageParamsJson: '{}'
+        }
+    })
+    .send(m.chat)
+```
+
+> [!NOTE]
+> Setiap card **wajib** punya `header.hasMediaAttachment: true` dan minimal satu media (image/video).
+
+---
+
+#### ButtonV2 (Deprecated)
+
+Builder untuk `buttonsMessage` — format lama yang sudah diblokir render di WhatsApp versi baru. Masih bisa dipakai untuk client atau testing.
+
+```ts
+import { ButtonV2 } from '@blurose/baileys'
+
+await new ButtonV2(conn)
+    .setBody('Pilih salah satu:')
+    .setFooter('Footer teks')
+    .setTitle('Judul')
+    .setThumbnail('https://example.com/thumb.png')
+    .addButton('Option 1', 'btn_1')
+    .addButton('Option 2', 'btn_2')
+    .send(m.chat)
+```
+
+---
+
+#### Toolkit — Media Utilities
+
+Static helper untuk proses media sebelum dikirim ke WhatsApp.
+
+```ts
+import { Toolkit } from '@blurose/baileys'
+
+// Fetch URL → Buffer
+const buf = await Toolkit.fetchBuffer('https://example.com/image.png')
+
+// Resize gambar (output: PNG Buffer)
+const thumb = await Toolkit.resize(imageBuffer, 300, 300)
+
+// Upload Buffer ke CDN WhatsApp → URL CDN
+const cdnUrl = await Toolkit.toUrl(conn, imageBuffer, 'image')
+
+// Resolve media (URL/Buffer/base64) → URL atau Buffer
+const url = await Toolkit.resolveMedia(conn, 'https://example.com/img.png', 'image')
+const b64 = await Toolkit.resolveMedia(conn, buf, 'image', { result: 'base64', resize: true })
+
+// Durasi video MP4 dari Buffer (tanpa ffmpeg)
+const secs = Toolkit.getMp4Duration(videoBuffer) // → number (detik)
+
+// Frame preview dari video MP4
+const preview = await Toolkit.getMp4Preview(videoBuffer, { time: 5, result: 'buffer' })
+
+// JSON stringify dengan unicode escape
+const escaped = Toolkit.stringifyEscaped({ key: 'nilai ñ 🎯' })
+
+// Resolve Promise bersarang rekursif
+const resolved = await Toolkit.waitAllPromises({
+    a: Promise.resolve(1),
+    b: { c: Promise.resolve('hello') }
+}) // → { a: 1, b: { c: 'hello' } }
+```
+
+---
+
 ### Custom Pairing
 Enhanced pairing code logic tailored for custom device registration and bypassing common connection limits.
 ```ts
@@ -1381,6 +1646,9 @@ sock.ws.on('CB:edge_routing,id:abcd', (node: BinaryNode) => { })
 sock.ws.on('CB:edge_routing,id:abcd,routing_info', (node: BinaryNode) => { })
 ```
 
+# Blurose Exclusive Features
+See [BLUROSE_FEATURES.md](BLUROSE_FEATURES.md) for documentation on the 5 exclusive features (Album Message, Scheduled Messages, HTML Mini Apps, Account Health Signals, and Full Newsletter Support).
+
 # License
 Copyright (c) 2025 blurose
 

package/WAProto/WAProto.proto

@@ -2159,6 +2159,18 @@ message Message {
     optional PollCreationMessage pollCreationMessageV5 = 111;
     optional NewsletterFollowerInviteMessage newsletterFollowerInviteMessageV2 = 113;
     optional PollResultSnapshotMessage pollResultSnapshotMessageV3 = 114;
+    optional PollCreationMessage pollCreationMessageV6 = 119;
+    optional ConditionalRevealMessage conditionalRevealMessage = 120;
+    message ConditionalRevealMessage {
+        optional bytes encPayload = 1;
+        optional bytes encIv = 2;
+        optional ConditionalRevealMessageType conditionalRevealMessageType = 3;
+        optional string revealKeyId = 4;
+        enum ConditionalRevealMessageType {
+            UNKNOWN = 0;
+            SCHEDULED_MESSAGE = 1;
+        }
+    }
     message AlbumMessage {
         optional uint32 expectedImageCount = 2;
         optional uint32 expectedVideoCount = 3;
@@ -3236,6 +3248,9 @@ message Message {
         optional Message.PollContentType pollContentType = 6;
         optional Message.PollType pollType = 7;
         optional Option correctAnswer = 8;
+        optional int64 endTime = 9;
+        optional bool hideParticipantName = 10;
+        optional bool allowAddOption = 11;
         message Option {
             optional string optionName = 1;
             optional string optionHash = 2;
@@ -3340,6 +3355,7 @@ message Message {
             HISTORY_SYNC_NOTIFICATION = 5;
             APP_STATE_SYNC_KEY_SHARE = 6;
             APP_STATE_SYNC_KEY_REQUEST = 7;
+            MESSAGE_UNSCHEDULE = 32;
             MSG_FANOUT_BACKFILL_REQUEST = 8;
             INITIAL_SECURITY_NOTIFICATION_SETTING_SYNC = 9;
             APP_STATE_FATAL_EXCEPTION_NOTIFICATION = 10;