@nuiisweety/baileys 0.1.3 → 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~ 🌷'
+})
 ```
 
 ---

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

@@ -19,6 +19,22 @@ const buildLatexUrl = (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
 ───────────────────────────────────────────────────────────── */
@@ -259,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'
@@ -273,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,
@@ -416,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) */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuiisweety/baileys",
   "type": "module",
-  "version": "0.1.3",
+  "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",