@pontasockets/baileys 0.2.4 → 0.2.6

package/README.md

@@ -65,6 +65,7 @@ This fork introduces targeted custom patches on top of the original Baileys libr
 | `02` | 📊 **Table Message** | Send structured tables via `{ table: { title?, headers, rows } }` — renders as rich table in WhatsApp |
 | `03` | 📝 **Rich Text Message** | Send styled text via `{ richText: '...' }` — renders as AI bot markdown text in WhatsApp |
 | `04` | 🔀 **Mixed Rich Message** | Combine text + code + table in one message via `{ items: [...] }` |
+| `05` | 🔗 **Inline Citation Message** | Send text with clickable footnote citations via `{ richResponse: [...] }` |
 | `02` | 🪪 **Custom Message ID** | All outgoing message IDs prefixed with `PONTASOCKETS` |
 | `03` | 🐛 **LID Bug Fixes** | Full fix for participant, mentionedJid, sender, and group admin LID resolution |
 | `04` | 📦 **makeInMemoryStore Fix** | Corrected store behavior for stable session handling |
@@ -485,7 +486,111 @@ await sock.sendMessage(jid, {
 
 > **Tipe yang valid di dalam `items`:**
 > - `{ text: 'string' }` — teks / markdown
-> - `{ code: 'string', language: 'string' }` — code block
+> - 
+
+<details>
+<summary><b>🔗 Inline Citation Message <kbd>NEW</kbd></b></summary>
+<br>
+
+> Render teks dengan citation/footnote yang bisa diklik — mirip jawaban AI WhatsApp yang punya referensi sumber
+
+**Single citation**
+
+```javascript
+await sock.sendMessage(jid, {
+  richResponse: [
+    {
+      text: 'Koperasi Merah Putih adalah inisiatif pemerintah. {{SS_0}}¹{{/SS_0}} ',
+      inlineEntities: [{
+        key: 'SS_0',
+        metadata: {
+          reference_id: 1,
+          reference_url: 'https://example.com',
+          reference_title: 'Judul Sumber',
+          reference_display_name: 'Sumber',
+          sources: [{
+            source_type: 'THIRD_PARTY',
+            source_display_name: 'Sumber',
+            source_subtitle: 'example.com',
+            source_url: 'https://example.com'
+          }],
+          __typename: 'GenAISearchCitationItem'
+        }
+      }]
+    }
+  ]
+}, { quoted: message })
+```
+
+**Multi citation dalam satu teks**
+
+```javascript
+await sock.sendMessage(jid, {
+  richResponse: [
+    {
+      text: 'Node.js {{SS_0}}¹{{/SS_0}} adalah runtime JavaScript. Dibuat oleh Ryan Dahl {{SS_1}}²{{/SS_1}} pada 2009.',
+      inlineEntities: [
+        {
+          key: 'SS_0',
+          metadata: {
+            reference_id: 1,
+            reference_url: 'https://nodejs.org',
+            reference_title: 'Node.js Official',
+            reference_display_name: 'nodejs.org',
+            sources: [{ source_type: 'THIRD_PARTY', source_display_name: 'nodejs.org', source_subtitle: 'nodejs.org', source_url: 'https://nodejs.org' }],
+            __typename: 'GenAISearchCitationItem'
+          }
+        },
+        {
+          key: 'SS_1',
+          metadata: {
+            reference_id: 2,
+            reference_url: 'https://wikipedia.org/wiki/Ryan_Dahl',
+            reference_title: 'Ryan Dahl - Wikipedia',
+            reference_display_name: 'Wikipedia',
+            sources: [{ source_type: 'THIRD_PARTY', source_display_name: 'Wikipedia', source_subtitle: 'wikipedia.org', source_url: 'https://wikipedia.org/wiki/Ryan_Dahl' }],
+            __typename: 'GenAISearchCitationItem'
+          }
+        }
+      ]
+    }
+  ]
+}, { quoted: message })
+```
+
+**Citation + Code Block dalam satu pesan**
+
+```javascript
+await sock.sendMessage(jid, {
+  richResponse: [
+    {
+      text: 'Cara install Node.js {{SS_0}}¹{{/SS_0}}:',
+      inlineEntities: [{
+        key: 'SS_0',
+        metadata: {
+          reference_id: 1,
+          reference_url: 'https://nodejs.org/en/download',
+          reference_title: 'Download Node.js',
+          reference_display_name: 'nodejs.org',
+          sources: [{ source_type: 'THIRD_PARTY', source_display_name: 'nodejs.org', source_subtitle: 'nodejs.org', source_url: 'https://nodejs.org/en/download' }],
+          __typename: 'GenAISearchCitationItem'
+        }
+      }]
+    },
+    { code: 'curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -\napt-get install -y nodejs', language: 'bash' },
+    { text: '_Verifikasi instalasi dengan_ `node --version`' }
+  ]
+}, { quoted: message })
+```
+
+> **Format citation di teks:** `{{KEY}}N{{/KEY}}` — `KEY` harus cocok dengan `key` di `inlineEntities`, `N` adalah nomor urut footnote
+
+> **`richResponse` array** support semua tipe yang sama dengan `items`:
+> - `{ text, inlineEntities? }` — teks / markdown dengan optional citation
+> - `{ code, language }` — code block
+> - `{ table, title? }` — tabel (rows langsung array of arrays `[items[], isHeading?]`)
+
+</details>`{ code: 'string', language: 'string' }` — code block
 > - `{ table: { title?, headers?, rows } }` — tabel
 
 </details>
@@ -1108,4 +1213,4 @@ This project is licensed for **personal and non-commercial use only**.
 
 *Made with ♥ by PONTASOCKETS*
 
-</div>
+</div>

package/lib/Utils/messages.js

@@ -409,7 +409,7 @@ const generateForwardMessageContent = (message, forceForward) => {
 
 const generateWAMessageContent = async (message, options) => {
     let m = {}
-    if ('code' in message || 'codes' in message || 'table' in message || 'items' in message || 'richText' in message) {
+    if ('code' in message || 'codes' in message || 'table' in message || 'items' in message || 'richText' in message || 'richResponse' in message) {
         return rich_message_utils_1.prepareRichResponseMessage(message)
     } else if ('text' in message) {
         const extContent = {
@@ -1728,4 +1728,4 @@ module.exports = {
     downloadMediaMessage,
     assertMediaContent,
     patchMessageForMdIfRequired
-}
+}

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

@@ -174,10 +174,11 @@ const toUnified = (submessages, uuid) => ({
                     primitive: {
                         title: tm.title || null,
                         rows: tm.rows.map(row => ({
+                            is_header: row.isHeading || false,
                             cells: row.items,
-                            is_heading: row.isHeading || false
+                            markdown_cells: row.items.map(item => ({ text: item }))
                         })),
-                        __typename: 'GenAITableUXPrimitive'
+                        __typename: 'GenATableUXPrimitive'
                     },
                     __typename: 'GenAISingleLayoutViewModel'
                 }
@@ -204,7 +205,7 @@ const toUnified = (submessages, uuid) => ({
                 view_model: {
                     primitive: {
                         text: submessage.messageText,
-                        inline_entities: [],
+                        inline_entities: submessage.inlineEntities || [],
                         __typename: 'GenAIMarkdownTextUXPrimitive'
                     },
                     __typename: 'GenAISingleLayoutViewModel'
@@ -234,131 +235,118 @@ const botMetadataCertificate = (length = 685) => {
 // ─── prepareRichResponseMessage ───────────────────────────────────────────────
 
 const prepareRichResponseMessage = (content) => {
-    const proto = WAProto_1.proto
 
     // Normalize ke array of items
     // Support:
-    //   { code, language }                                      — single code block
-    //   { codes: [{ code, language }, ...] }                    — multi code block
-    //   { table: { title?, headers?, rows } }                   — single table
-    //   { text: 'string' }                                      — single text
-    //   { items: [{ text } | { code, language } | { table }] } — mixed, bebas urutan
-    let items = []
-
-    if (content.items) {
-        items = content.items
-    } else if (content.codes) {
-        items = content.codes.map(c => ({ code: c.code, language: c.language }))
-    } else if (content.table) {
-        items = [{ table: content.table }]
-    } else if ('richText' in content) {
-        items = [{ text: content.richText }]
-    } else {
-        items = [{ code: content.code, language: content.language }]
-    }
-
-    const built = items.map(item => {
-        // ── TEXT ──────────────────────────────────────────────────────────────
-        if ('text' in item) {
-            return {
-                submessage: proto.AIRichResponseSubMessage.create({
-                    messageType: RichSubMessageType.TEXT, // 2
-                    messageText: item.text
-                }),
-                unified: {
+    //   { code, language }                                                — single code block
+    //   { codes: [{ code, language }, ...] }                              — multi code block
+    //   { table: { title?, headers?, rows } }                             — single table
+    //   { richText: 'string' }                                            — single text
+    //   { items: [{ text } | { code, language } | { table }] }           — mixed, bebas urutan
+    //   { richResponse: [{ text, inlineEntities? } | { code, language }  — full array mode
+    //                   | { table, title? } | { inlineImage } | ...] }
+
+    let submessages = []
+
+    if (Array.isArray(content.richResponse)) {
+        // ── richResponse array mode (dari Lia) ────────────────────────────────
+        submessages = content.richResponse.map(sub => {
+            if (sub.text !== undefined) {
+                return {
                     messageType: RichSubMessageType.TEXT,
-                    messageText: item.text
+                    messageText: sub.text,
+                    ...(sub.inlineEntities ? { inlineEntities: sub.inlineEntities } : {})
                 }
             }
-        }
-
-        // ── TABLE ─────────────────────────────────────────────────────────────
-        if (item.table) {
-            const { title, headers, rows } = item.table
-
-            // Build rows: header row dulu (kalau ada), baru data rows
-            const allRows = []
-            if (headers && headers.length) {
-                allRows.push(proto.AIRichResponseTableMetadata.AIRichResponseTableRow.create({
-                    items: headers,
-                    isHeading: true
-                }))
+            if (sub.code !== undefined) {
+                const lang = sub.language || 'javascript'
+                return {
+                    messageType: RichSubMessageType.CODE,
+                    codeMetadata: {
+                        codeLanguage: lang,
+                        codeBlocks: tokenizeCode(sub.code, lang)
+                    }
+                }
             }
-            for (const row of (rows || [])) {
-                allRows.push(proto.AIRichResponseTableMetadata.AIRichResponseTableRow.create({
-                    items: row,
-                    isHeading: false
-                }))
+            if (sub.table !== undefined) {
+                return {
+                    messageType: RichSubMessageType.TABLE,
+                    tableMetadata: {
+                        ...(sub.title ? { title: sub.title } : {}),
+                        rows: sub.table
+                    }
+                }
             }
+            // passthrough — kalau ada tipe lain langsung lewat
+            return sub
+        })
+    } else {
+        // ── shorthand / items mode ────────────────────────────────────────────
+        let items = []
+
+        if (content.items) {
+            items = content.items
+        } else if (content.codes) {
+            items = content.codes.map(c => ({ code: c.code, language: c.language }))
+        } else if (content.table) {
+            items = [{ table: content.table }]
+        } else if ('richText' in content) {
+            items = Array.isArray(content.richText)
+                ? content.richText.map(t => ({ text: t }))
+                : [{ text: content.richText }]
+        } else {
+            items = [{ code: content.code, language: content.language }]
+        }
 
-            const tableMetadata = proto.AIRichResponseTableMetadata.create({
-                title: title || null,
-                rows: allRows
-            })
+        submessages = items.map(item => {
+            // ── TEXT ──────────────────────────────────────────────────────────
+            if ('text' in item) {
+                return {
+                    messageType: RichSubMessageType.TEXT,
+                    messageText: item.text,
+                    ...(item.inlineEntities ? { inlineEntities: item.inlineEntities } : {})
+                }
+            }
 
-            return {
-                submessage: proto.AIRichResponseSubMessage.create({
-                    messageType: RichSubMessageType.TABLE, // 4
-                    tableMetadata
-                }),
-                unified: {
+            // ── TABLE ─────────────────────────────────────────────────────────
+            if (item.table) {
+                const { title, headers, rows } = item.table
+                const allRows = []
+                if (headers && headers.length) {
+                    allRows.push({ items: headers, isHeading: true })
+                }
+                for (const row of (rows || [])) {
+                    allRows.push({ items: row, isHeading: false })
+                }
+                return {
                     messageType: RichSubMessageType.TABLE,
                     tableMetadata: {
-                        title: title || null,
-                        rows: [
-                            ...(headers ? [{ items: headers, isHeading: true }] : []),
-                            ...(rows || []).map(r => ({ items: r, isHeading: false }))
-                        ]
+                        ...(title ? { title } : {}),
+                        rows: allRows
                     }
                 }
             }
-        }
 
-        // ── CODE (default) ────────────────────────────────────────────────────
-        const lang = item.language || 'javascript'
-        const codeBlocks = tokenizeCode(item.code, lang)
-        return {
-            submessage: proto.AIRichResponseSubMessage.create({
-                messageType: RichSubMessageType.CODE, // 5
-                codeMetadata: proto.AIRichResponseCodeMetadata.create({
-                    codeLanguage: lang,
-                    codeBlocks: codeBlocks.map(b =>
-                        proto.AIRichResponseCodeMetadata.AIRichResponseCodeBlock.create({
-                            highlightType: b.highlightType,
-                            codeContent: b.codeContent
-                        })
-                    )
-                })
-            }),
-            unified: {
+            // ── CODE (default) ────────────────────────────────────────────────
+            const lang = item.language || 'javascript'
+            const codeBlocks = tokenizeCode(item.code, lang)
+            return {
                 messageType: RichSubMessageType.CODE,
-                codeMetadata: { codeLanguage: lang, codeBlocks }
+                codeMetadata: {
+                    codeLanguage: lang,
+                    codeBlocks: codeBlocks.map(b => ({
+                        highlightType: b.highlightType,
+                        codeContent: b.codeContent
+                    }))
+                }
             }
-        }
-    })
+        })
+    }
 
     const uuid = crypto_1.randomUUID()
-    const unified = toUnified(built.map(b => b.unified), uuid)
-
-    // Build AIRichResponseMessage using E2E proto class
-    const richResponseMessage = proto.AIRichResponseMessage.create({
-        submessages: built.map(b => b.submessage),
-        messageType: 1, // AI_RICH_RESPONSE_TYPE_STANDARD
-        unifiedResponse: proto.AIRichResponseUnifiedResponse
-            ? proto.AIRichResponseUnifiedResponse.create({
-                data: Buffer.from(JSON.stringify(unified))
-            })
-            : { data: Buffer.from(JSON.stringify(unified)) },
-        contextInfo: {
-            isForwarded: true,
-            forwardingScore: 1,
-            forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' },
-            forwardOrigin: 4
-        }
-    })
+    const unified = toUnified(submessages, uuid)
 
-    // Wrap in botForwardedMessage
-    const message = {
+    return {
         messageContextInfo: {
             botMetadata: {
                 verificationMetadata: {
@@ -373,10 +361,22 @@ const prepareRichResponseMessage = (content) => {
             }
         },
         botForwardedMessage: {
-            message: { richResponseMessage }
+            message: {
+                richResponseMessage: {
+                    messageType: 1,
+                    submessages,
+                    unifiedResponse: {
+                        data: Buffer.from(JSON.stringify(unified))
+                    },
+                    contextInfo: {
+                        isForwarded: true,
+                        forwardingScore: 1,
+                        forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' },
+                        forwardOrigin: 4
+                    }
+                }
+            }
         }
     }
-
-    return message
 }
-exports.prepareRichResponseMessage = prepareRichResponseMessage
+exports.prepareRichResponseMessage = prepareRichResponseMessage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pontasockets/baileys",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Baileys is a lightweight JavaScript library for interacting with the WhatsApp Web API using WebSocket.",
   "keywords": [
     "facebook",