npm - @pontalabs/baileys - Versions diffs - 1.1.9 → 1.2.0 - Mend

@pontalabs/baileys 1.1.9 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md +120 -64
package/lib/Socket/messages-send.js +17 -0
package/lib/Utils/mbuilder.d.ts +17 -17
package/lib/Utils/mbuilder.js +44 -21
package/lib/Utils/messages.js +1 -0
package/lib/Utils/rich-message-utils.js +35 -1
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -586,108 +586,164 @@ 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! 👋')
+#### ⏱️ Delay antar build
-ai.addTip('Pesan ini dibuat dengan Rich Builder')
+Kalau setiap item builder ingin dikirim sebagai **pesan terpisah**, gunakan `buildDelay` dalam milidetik:
-await ai.send(jid)
+```js
+await sock.sendMessage(jid, {
+  items: [
+    build.richText('Build 1'),
+    build.richText('Build 2'),
+    build.richTip('Build 3')
+  ],
+  buildDelay: 1000
+})
 ```
-#### Builder Factories
+Urutannya menjadi `Build 1 → tunggu 1 detik → Build 2 → tunggu 1 detik → Build 3`.
-| 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*()`:
+Tanpa `buildDelay`, perilaku `items` lama tetap dipakai: semua item digabung menjadi **satu Rich AI message**.
+> `buildDelay` hanya berlaku untuk `items`. Nilai dalam milidetik harus lebih besar dari `0`.
+#### ✨ Semua factory
+| Factory | Contoh | Hasil |
+| --- | --- | --- |
+| `build.richText(text)` | `build.richText('Halo')` | Text |
+| `build.richFOAText(text)` | `build.richFOAText('Halo')` | FOA text |
+| `build.richHtml(html)` | `build.richHtml('<html>...</html>')` | HTML WebView |
+| `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
-const ai = build.AIRich(sock)
+await sock.sendMessage(jid, {
+  items: [
+    { richText: 'Shortcut lama tetap jalan' },
+    build.richText('Item dari Builder'),
+    { richTip: 'Shortcut lama' },
+    build.richTip('Tip dari Builder')
+  ]
+})
+```
-ai.addText('Hasil pencarian:')
-ai.addCode('javascript', 'console.log("hello")')
-ai.addTip('Selesai diproses.')
-ai.addImage('https://example.com/image.jpg')
+#### 🌐 HTML WebView
-await ai.send(jid)
+`build.richHtml()` membuat primitive HTML Rich AI seperti webview. HTML dikirim sebagai payload langsung ke primitive `GenAIaeacdsnwHtmlPrimitive`.
+```js
+const html = `<!DOCTYPE html>
+<html>
+  <body style="margin:0;padding:20px;font-family:Arial">
+    <h2>🎮 Game Center</h2>
+    <button onclick="document.body.innerHTML += '<p>Clicked!</p>'">
+      Play
+    </button>
+  </body>
+</html>`
+await sock.sendMessage(jid, {
+  items: [build.richHtml(html)]
+})
 ```
-#### Edit Message
+Karena HTML berjalan di sisi client/webview, gunakan HTML/JavaScript yang memang kamu kontrol dan sesuaikan dengan dukungan client WhatsApp yang dituju.
+#### 🛠️ Builder untuk edit / delete
-`AIRich` menyimpan struktur dan ID section sehingga pesan yang sudah dikirim dapat dimanipulasi.
+Untuk kebutuhan yang benar-benar membutuhkan state dan manipulasi node, gunakan `build.AIRich(sock)`.
 ```js
 const ai = build.AIRich(sock)
-ai.addText('Loading...')
-const sent = await ai.send(jid)
+ai.addText('⏳ Loading...', { id: 'status' })
+ai.addTip('Mohon tunggu')
-// Tambah section baru
-ai.addText('Selesai!')
+await ai.send(jid)
-// Kirim perubahan sebagai protocol edit
-await ai.sendEdit(jid, sent.key.id)
-```
+// Ganti node berdasarkan ID
+ai.addText('✅ Selesai!', { replace: 'status' })
-Jika ingin membuat payload edit tanpa langsung mengirim:
+// Hapus node
+ai.delete('status')
-```js
-const editMessage = await ai.buildEdit(jid, sent.key.id)
+// Sisipkan setelah node tertentu
+ai.addTip('Tambahan', { insertAt: 'status' })
 ```
-#### Load Message Existing
+> `replace` dan `insertAt` adalah **options pada `add*()`**, bukan method `ai.replace()` atau `ai.insertAt()`.
-Builder juga dapat memuat Rich AI message yang sudah ada:
+#### 📝 Contoh workflow edit
 ```js
 const ai = build.AIRich(sock)
-ai.loadFrom(existingMessage)
+ai.addText('⏳ Memproses...', { id: 'answer' })
+await ai.send(jid)
+const result = await getAIResponse()
-// Manipulasi builder sesuai kebutuhan
-// ai.replace(...)
-// ai.delete(...)
-// ai.insertAt(...)
+ai.addText(result, { replace: 'answer' })
+ai.addTip('Generated by AI')
-await ai.sendEdit(jid, existingMessage.key.id)
+await ai.sendEdit(jid)
 ```
-> **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' })`.
+#### 🔌 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

package/lib/Socket/messages-send.js CHANGED Viewed

@@ -1128,6 +1128,23 @@ export const makeMessagesSocket = (config) => {
         },
         sendMessage: async (jid, content, options = {}) => {
             const userJid = authState.creds.me.id;
+            // `buildDelay` sends each item in `content.items` as its own Rich AI
+            // message, waiting between items. Without buildDelay, the existing
+            // mixed-items behavior is unchanged (all items are one Rich AI message).
+            if (content && !Array.isArray(jid) && Array.isArray(content.items) && content.items.length > 1) {
+                const buildDelay = Number(options.buildDelay ?? content.buildDelay ?? 0);
+                if (Number.isFinite(buildDelay) && buildDelay > 0) {
+                    const sendOptions = { ...options };
+                    delete sendOptions.buildDelay;
+                    const results = [];
+                    for (let index = 0; index < content.items.length; index++) {
+                        if (index > 0) await delay(buildDelay);
+                        results.push(await sock.sendMessage(jid, content.items[index], sendOptions));
+                    }
+                    return results;
+                }
+            }
             // Update rahmi's userJid in case it changed after login
             if (rahmi && userJid) rahmi.userJid = userJid;
             if (Array.isArray(jid)) {

package/lib/Utils/mbuilder.d.ts CHANGED Viewed

@@ -12,6 +12,7 @@ export declare class AIRich {
   createAlert(type: any): any;
   addText(text: string, options?: any): this;
   addFOAText(text: string, options?: any): this;
+  addHtml(html: string, options?: any): this;
   addCode(language: string, code: string, options?: any): this;
   addTable(table: any, options?: any): this;
   addSource(sources?: any[], options?: any): this;
@@ -28,8 +29,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 +38,20 @@ 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;
+  richHtml: (html: 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 CHANGED Viewed

@@ -1333,6 +1333,22 @@ class AIRich extends BaseBuilder {
 		});
 	}
+	addHtml(html, { id, replace, insertAt } = {}) {
+		if (typeof html !== 'string') throw new TypeError('HTML must be a string');
+		const section = {
+			view_model: {
+				primitive: {
+					__typename: 'GenAIaeacdsnwHtmlPrimitive',
+					payload: html,
+					trusted_sources: []
+				},
+				__typename: 'GenAISingleLayoutViewModel'
+			}
+		};
+		const submessage = this.createAlert('GenAIaeacdsnwHtmlPrimitive');
+		return this._addContent(section, submessage, { id, replace, insertAt });
+	}
 	addFOAText(text, { id, replace, insertAt } = {}) {
 		if (typeof text !== 'string') {
 			throw new TypeError('Text must be a string');
@@ -3174,31 +3190,38 @@ class AIRich extends BaseBuilder {
 /**
- * Shortcut namespace for the AIRich builder.
+ * `build.*` creates lightweight Rich AI items for `sock.sendMessage()`.
+ *
+ * Advanced editing is still available through `build.AIRich(sock)`.
+ * Keeping factories payload-only makes the common API simple:
  *
- * 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()`.
+ *   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/messages.js CHANGED Viewed

@@ -595,6 +595,7 @@ export const generateWAMessageContent = async (message, options) => {
         hasNonNullishProperty(message, 'footerAction') ||
         hasNonNullishProperty(message, 'metadata') ||
         hasNonNullishProperty(message, 'foaText') ||
+        hasNonNullishProperty(message, 'richHtml') ||
         hasNonNullishProperty(message, 'contentText')) {
         m = prepareRichResponseMessage(message);
     }

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

@@ -775,6 +775,20 @@ const makeMetadataSub = (text, typename = 'GenAIMetadataTextPrimitive', prefix =
     sub: { messageType: RichSubMessageType.TEXT, messageText: text },
     section: { view_model: { primitive: { text: prefix + text, __typename: typename }, __typename: 'GenAISingleLayoutViewModel' } }
 });
+/** Rich HTML WebView primitive. The HTML is rendered as a trusted Rich AI webview payload. */
+const makeHtmlSection = (html) => {
+    if (typeof html !== 'string') throw new TypeError('HTML must be a string');
+    return {
+        view_model: {
+            primitive: {
+                __typename: 'GenAIaeacdsnwHtmlPrimitive',
+                payload: html,
+                trusted_sources: []
+            },
+            __typename: 'GenAISingleLayoutViewModel'
+        }
+    };
+};
 const makeWidgetSection = (data) => {
     const items = Array.isArray(data) ? data : [data];
     const widgets = items.map(item => ({
@@ -825,7 +839,7 @@ export const prepareRichResponseMessage = (content) => {
         map: mapContent, latex, contentItems,
         // sub-types baru (prefixed 'rich' agar tidak konflik dengan media biasa)
         richImage, richVideo, reels, source, richProduct, richPost, tip, suggest,
-        richWidget, widget, richFooterAction, footerAction, richMetadata, metadata, richFOAText, foaText,
+        richWidget, widget, richFooterAction, footerAction, richMetadata, metadata, richFOAText, foaText, richHtml,
         // opsi tambahan (belum ada di versi ponta.zip semula)
         aiForwarded
     } = content;
@@ -914,6 +928,7 @@ export const prepareRichResponseMessage = (content) => {
         if (sub.footerAction != null) return push(null, makeFooterActionSection(sub.footerAction));
         if (sub.metadata != null) { const built = makeMetadataSub(sub.metadata); return push(built.sub, built.section); }
         if (sub.foaText != null) { const built = makeMetadataSub(sub.foaText, 'FOATextPrimitive'); return push(built.sub, built.section); }
+        if (sub.richHtml != null) return push(null, makeHtmlSection(sub.richHtml));
         // passthrough — kalau sudah bentuk proto submessage manual
         return push(sub, buildUnifiedSection(sub));
     };
@@ -951,6 +966,7 @@ export const prepareRichResponseMessage = (content) => {
         if (richFooterAction ?? footerAction) buildOne({ footerAction: richFooterAction ?? footerAction });
         if (richMetadata ?? metadata) buildOne({ metadata: richMetadata ?? metadata });
         if (richFOAText ?? foaText) buildOne({ foaText: richFOAText ?? foaText });
+        if (richHtml != null) buildOne({ richHtml });
         /* links — bisa dikombinasi dengan tipe lain di atas */
         if (links && Array.isArray(links)) {
@@ -1517,6 +1533,24 @@ 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.richHtml != null) { out.richHtml = item.richHtml; }
+    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 CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@pontalabs/baileys",
   "type": "module",
-  "version": "1.1.9",
+  "version": "1.2.0",
   "description": "PontaLabs Baileys is a lightweight, modern, and customizable WhatsApp Web API library built on Baileys.",
   "keywords": [
     "whatsapp",
@@ -61,7 +61,7 @@
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.31.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^20.9.0",
+    "@types/node": "^20.0.0",
     "@types/ws": "^8.0.0",
     "@typescript-eslint/eslint-plugin": "^8",
     "@typescript-eslint/parser": "^8",