@nuiisweety/baileys 0.1.2 → 0.1.4

package/README.md

@@ -1102,33 +1102,48 @@ await sock.sendMessage(jid, {
 
 > 🌸 Kirim grid gambar — satu gambar utama dengan beberapa thumbnail, tampil sebagai AI Rich Response~
 
+> ⚠️ **Catatan penting:** Setiap URL gambar harus berupa object `{ imagePreviewUrl, imageHighResUrl, sourceUrl }`. Bisa juga pakai string URL langsung — akan otomatis di-expand~
+
 ```js
+// ✅ Dengan object URL lengkap (recommended)
 await sock.sendMessage(jid, {
   gridImage: {
     gridImageUrl: {
-      imagePreviewUrl: 'https://example.com/thumb.jpg',
-      imageHighResUrl: 'https://example.com/image.jpg',
-      sourceUrl: 'https://example.com'
+      imagePreviewUrl: 'https://picsum.photos/id/10/300/300',
+      imageHighResUrl: 'https://picsum.photos/id/10/1200/1200',
+      sourceUrl: 'https://picsum.photos'
     },
     imageUrls: [
       {
-        imagePreviewUrl: 'https://example.com/t1.jpg',
-        imageHighResUrl: 'https://example.com/i1.jpg',
-        sourceUrl: 'https://example.com/1'
+        imagePreviewUrl: 'https://picsum.photos/id/11/300/300',
+        imageHighResUrl: 'https://picsum.photos/id/11/1200/1200',
+        sourceUrl: 'https://picsum.photos'
       },
       {
-        imagePreviewUrl: 'https://example.com/t2.jpg',
-        imageHighResUrl: 'https://example.com/i2.jpg',
-        sourceUrl: 'https://example.com/2'
+        imagePreviewUrl: 'https://picsum.photos/id/12/300/300',
+        imageHighResUrl: 'https://picsum.photos/id/12/1200/1200',
+        sourceUrl: 'https://picsum.photos'
       }
     ]
   },
   headerText: 'Hasil pencarian gambar 🌸',
   footerText: 'Sumber: Internet 🌐'
 })
+
+// ✅ Dengan string URL langsung (shorthand)
+await sock.sendMessage(jid, {
+  gridImage: {
+    gridImageUrl: 'https://picsum.photos/id/10/300/300',
+    imageUrls: [
+      'https://picsum.photos/id/11/300/300',
+      'https://picsum.photos/id/12/300/300'
+    ]
+  },
+  headerText: 'Hasil pencarian gambar 🌸'
+})
 ```
 
-> 💡 `imageUrls` adalah array gambar pendukung di bawah gambar utama~
+> 💡 `imageUrls` adalah array gambar pendukung di bawah gambar utama. Gunakan URL yang bisa diakses publik~
 
 ---
 
@@ -1136,21 +1151,35 @@ await sock.sendMessage(jid, {
 
 > ✨ Kirim gambar yang muncul inline di dalam teks — seperti ilustrasi di dalam respons AI~
 
+> ⚠️ **Catatan penting:** `imageUrl` harus berupa object `{ imagePreviewUrl, imageHighResUrl, sourceUrl }` atau string URL langsung~
+
 ```js
+// ✅ Dengan object URL lengkap
 await sock.sendMessage(jid, {
   inlineImage: {
     imageUrl: {
-      imagePreviewUrl: 'https://example.com/preview.jpg',
-      imageHighResUrl: 'https://example.com/hires.jpg',
-      sourceUrl: 'https://example.com'
+      imagePreviewUrl: 'https://picsum.photos/id/237/300/300',
+      imageHighResUrl: 'https://picsum.photos/id/237/1200/1200',
+      sourceUrl: 'https://picsum.photos'
     },
-    imageText: 'Ilustrasi diagram arsitektur 💡',
-    alignment: 0,    // 0 = leading, 1 = trailing, 2 = center
-    tapLinkUrl: 'https://example.com/detail'
+    imageText: 'Ilustrasi gambar random 🌸',
+    alignment: 2,    // 0 = leading, 1 = trailing, 2 = center
+    tapLinkUrl: 'https://picsum.photos'
   },
   headerText: 'Berikut ilustrasinya~ 🌷',
   footerText: 'Tap gambar untuk detail 🔍'
 })
+
+// ✅ Shorthand dengan string URL
+await sock.sendMessage(jid, {
+  inlineImage: {
+    imageUrl: 'https://picsum.photos/id/237/300/300',
+    imageText: 'Ilustrasi gambar random 🌸',
+    alignment: 2,
+    tapLinkUrl: 'https://picsum.photos'
+  },
+  headerText: 'Berikut ilustrasinya~ 🌷'
+})
 ```
 
 ---
@@ -1236,15 +1265,20 @@ await sock.sendMessage(jid, {
 
 > ✏️ Kirim rumus matematika dalam format LaTeX — tampil dengan render formula yang indah~
 
+> ⚠️ **Catatan penting:**
+> - `url` di setiap expression **wajib ada** agar WA client bisa menampilkan gambar LaTeX. Jika tidak diisi, library akan **auto-generate** URL dari [latex.codecogs.com](https://latex.codecogs.com).
+> - Gunakan `latex: {...}` langsung (flat) — **bukan** dibungkus dalam `richResponse: [{ latex: {...} }]`.
+> - `headerText`, `footerText`, `disclaimerText` tetap bisa dipakai bersama `latex`.
+
 ```js
-// Rumus sederhana
+// ✅ Rumus sederhana — url auto-generate jika tidak diisi
 await sock.sendMessage(jid, {
   latex: {
     text: 'Berikut rumus yang kamu minta:',
     expressions: [
       {
         expression: 'E = mc^2',
-        url: 'https://example.com/formula/e-mc2.png',   // opsional: gambar render-nya
+        // url auto-generate dari codecogs kalau tidak diisi~
         width: 120,
         height: 40
       }
@@ -1254,7 +1288,7 @@ await sock.sendMessage(jid, {
   footerText: 'E = energi, m = massa, c = kecepatan cahaya 💡'
 })
 
-// Multiple expressions
+// ✅ Multiple expressions
 await sock.sendMessage(jid, {
   latex: {
     text: 'Rumus-rumus fisika dasar:',
@@ -1267,9 +1301,34 @@ await sock.sendMessage(jid, {
   headerText: 'Hukum Newton 🍎',
   disclaimerText: 'Fisika dasar kelas 10~'
 })
+
+// ✅ Dengan url custom (jika kamu punya server render sendiri)
+await sock.sendMessage(jid, {
+  latex: {
+    text: 'Energi massa Einstein:',
+    expressions: [
+      {
+        expression: 'E = mc^2',
+        url: 'https://latex.codecogs.com/png.image?\dpi{150}\bg{white}E%20%3D%20mc%5E2',
+        width: 120,
+        height: 40
+      }
+    ]
+  },
+  headerText: 'Fisika Modern ⚛️'
+})
 ```
 
-> 💡 `expression` menggunakan sintaks LaTeX standar. `url` adalah opsional — URL gambar hasil render LaTeX (misalnya dari layanan seperti render.githubusercontent.com)~
+> 💡 `expression` menggunakan sintaks LaTeX standar. `url` akan **otomatis di-generate** dari codecogs jika tidak diisi — jadi kamu tidak perlu khawatir soal ini~
+
+> ❌ **Jangan pakai cara ini** (akan kosong/error):
+> ```js
+> // SALAH — latex tidak boleh dibungkus richResponse array untuk flat usage
+> await sock.sendMessage(jid, {
+>   richResponse: [{ latex: { text: '...', expressions: [...] } }],
+>   headerText: 'Judul'  // ← headerText diabaikan di mode array lama
+> })
+> ```
 
 ---
 

package/lib/Utils/messages.js

@@ -561,7 +561,13 @@ export const generateWAMessageContent = async (message, options) => {
     else if (hasNonNullishProperty(message, 'code') ||
         hasNonNullishProperty(message, 'links') ||
         hasNonNullishProperty(message, 'table') ||
-        hasNonNullishProperty(message, 'richResponse')) {
+        hasNonNullishProperty(message, 'richResponse') ||
+        hasNonNullishProperty(message, 'latex') ||
+        hasNonNullishProperty(message, 'gridImage') ||
+        hasNonNullishProperty(message, 'inlineImage') ||
+        hasNonNullishProperty(message, 'dynamic') ||
+        hasNonNullishProperty(message, 'map') ||
+        hasNonNullishProperty(message, 'contentItems')) {
         m = prepareRichResponseMessage(message);
     }
     else if (hasNonNullishProperty(message, 'text')) {

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

@@ -7,6 +7,34 @@ import { unixTimestampSeconds } from './generics.js';
 
 const NOOP = new Set([]);
 
+/* ─────────────────────────────────────────────────────────────
+   LATEX URL GENERATOR
+   WhatsApp client membutuhkan URL gambar render untuk setiap
+   LaTeX expression. Tanpa URL, pesan tampil kosong.
+   Gunakan latex.codecogs.com sebagai fallback gratis~
+───────────────────────────────────────────────────────────── */
+const buildLatexUrl = (expression) => {
+    if (!expression) return null;
+    const encoded = encodeURIComponent(expression);
+    return `https://latex.codecogs.com/png.image?\dpi{150}\bg{white}${encoded}`;
+};
+
+/* ─────────────────────────────────────────────────────────────
+   IMAGE URL HELPER
+   Konversi objek AIRichResponseImageURL ke snake_case JSON
+   agar WA client bisa baca dengan benar~
+───────────────────────────────────────────────────────────── */
+const toImageUrlJson = (imgUrl) => {
+    if (!imgUrl) return null;
+    // support both plain string and object
+    if (typeof imgUrl === 'string') return { image_preview_url: imgUrl, image_high_res_url: imgUrl, source_url: null };
+    return {
+        image_preview_url: imgUrl.imagePreviewUrl || imgUrl.image_preview_url || null,
+        image_high_res_url: imgUrl.imageHighResUrl || imgUrl.image_high_res_url || null,
+        source_url: imgUrl.sourceUrl || imgUrl.source_url || null
+    };
+};
+
 /* ─────────────────────────────────────────────────────────────
    TOKENIZER
 ───────────────────────────────────────────────────────────── */
@@ -247,8 +275,8 @@ const buildUnifiedSection = (submessage) => {
             return {
                 view_model: {
                     primitive: {
-                        grid_image_url: gm.gridImageUrl,
-                        image_urls: gm.imageUrls,
+                        grid_image_url: toImageUrlJson(gm.gridImageUrl),
+                        image_urls: (gm.imageUrls || []).map(toImageUrlJson),
                         __typename: 'GenAIGridImageUXPrimitive'
                     },
                     __typename: 'GenAISingleLayoutViewModel'
@@ -261,7 +289,7 @@ const buildUnifiedSection = (submessage) => {
             return {
                 view_model: {
                     primitive: {
-                        image_url: im.imageUrl,
+                        image_url: toImageUrlJson(im.imageUrl),
                         image_text: im.imageText,
                         alignment: im.alignment ?? 0,
                         tap_link_url: im.tapLinkUrl || null,
@@ -404,16 +432,35 @@ const makeTableSub = (rows, title, noHeading) => ({
     }
 });
 
+/** Normalize input ke format AIRichResponseImageURL */
+const normalizeImageUrl = (u) => {
+    if (!u) return null;
+    if (typeof u === 'string') return { imagePreviewUrl: u, imageHighResUrl: u, sourceUrl: null };
+    return {
+        imagePreviewUrl: u.imagePreviewUrl || u.image_preview_url || null,
+        imageHighResUrl: u.imageHighResUrl || u.image_high_res_url || null,
+        sourceUrl: u.sourceUrl || u.source_url || null
+    };
+};
+
 /** Buat submessage GRID_IMAGE */
 const makeGridImageSub = (gridImageUrl, imageUrls = []) => ({
     messageType: RichSubMessageType.GRID_IMAGE,
-    gridImageMetadata: { gridImageUrl, imageUrls }
+    gridImageMetadata: {
+        gridImageUrl: normalizeImageUrl(gridImageUrl),
+        imageUrls: (imageUrls || []).map(normalizeImageUrl)
+    }
 });
 
 /** Buat submessage INLINE_IMAGE */
 const makeInlineImageSub = (imageUrl, imageText = '', alignment = 0, tapLinkUrl = null) => ({
     messageType: RichSubMessageType.INLINE_IMAGE,
-    imageMetadata: { imageUrl, imageText, alignment, tapLinkUrl }
+    imageMetadata: {
+        imageUrl: normalizeImageUrl(imageUrl),
+        imageText,
+        alignment,
+        tapLinkUrl
+    }
 });
 
 /** Buat submessage DYNAMIC (animated image/GIF) */
@@ -446,17 +493,22 @@ const makeLatexSub = (text, expressions = []) => ({
     messageType: RichSubMessageType.LATEX,
     latexMetadata: {
         text,
-        expressions: expressions.map(e => ({
-            latexExpression: e.expression || e.latexExpression || '',
-            url: e.url || null,
-            width: e.width ?? 0,
-            height: e.height ?? 0,
-            fontHeight: e.fontHeight ?? 0,
-            imageTopPadding: e.imageTopPadding ?? 0,
-            imageLeadingPadding: e.imageLeadingPadding ?? 0,
-            imageBottomPadding: e.imageBottomPadding ?? 0,
-            imageTrailingPadding: e.imageTrailingPadding ?? 0
-        }))
+        expressions: expressions.map(e => {
+            const expr = e.expression || e.latexExpression || '';
+            // url WAJIB ada agar WA client bisa render — auto-generate jika tidak disupply
+            const url = e.url || buildLatexUrl(expr);
+            return {
+                latexExpression: expr,
+                url,
+                width: e.width ?? 120,
+                height: e.height ?? 40,
+                fontHeight: e.fontHeight ?? 0,
+                imageTopPadding: e.imageTopPadding ?? 0,
+                imageLeadingPadding: e.imageLeadingPadding ?? 0,
+                imageBottomPadding: e.imageBottomPadding ?? 0,
+                imageTrailingPadding: e.imageTrailingPadding ?? 0
+            };
+        })
     }
 });
 
@@ -499,7 +551,9 @@ export const prepareRichResponseMessage = (content) => {
 
     /* ── mode array (richResponse) — multi-section campuran ── */
     if (Array.isArray(richResponse)) {
-        submessages = richResponse.map(sub => {
+        // headerText dan footerText tetap dihormati meskipun pakai mode array
+        if (headerText) submessages.push(makeTextSub(headerText));
+        submessages.push(...richResponse.map(sub => {
             if (sub.text != null)       return makeTextSub(sub.text, sub.inlineEntities);
             if (sub.code != null)       return makeCodeSub(sub.code, sub.language || 'javascript');
             if (sub.table != null)      return makeTableSub(sub.table, sub.title, sub.noHeading);
@@ -510,7 +564,8 @@ export const prepareRichResponseMessage = (content) => {
             if (sub.latex != null)      return makeLatexSub(sub.latex.text, sub.latex.expressions);
             if (sub.contentItems != null) return makeContentItemsSub(sub.contentItems.items, sub.contentItems.contentType);
             return sub; // passthrough kalau sudah bentuk proto
-        }).filter(Boolean);
+        }).filter(Boolean));
+        if (footerText) submessages.push(makeTextSub(footerText));
 
     /* ── mode flat (convenience fields) ── */
     } else {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuiisweety/baileys",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A WebSockets library for interacting with WhatsApp Web — forked STRICTLY from @whiskeysockets/baileys only, NOT from any other baileys fork. Modified by NuiiSweety.",
   "keywords": [
     "whatsapp",