plogme 1.0.5 → 1.0.6

package/README.md

@@ -10,7 +10,7 @@
 npm install plogme
 ```
 
-The current package version is **1.0.4**. Use Node.js 20 or newer.
+The current package version is **1.0.6**. Use Node.js 20 or newer.
 
 ## Quick start
 
@@ -474,6 +474,93 @@ sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
 })
 ```
 
+## Reporting, group history, rich HTML, and source grep
+
+Version 1.0.6 adds the realvare-style `w:report` methods without replacing plogme's existing evidence-based `reportSpam` method. The methods use different WhatsApp IQ namespaces and should be selected according to the operation you intend to perform.
+
+| API | Wire operation | Use |
+| --- | --- | --- |
+| `reportSpam(jid, messages, spamFlow, subject)` | `xmlns="spam"` → `spam_list` | Report a chat or group with message evidence. |
+| `reportUser(jid, reason, waitForAckMs)` | `xmlns="w:report"` → `user` | Report one user. |
+| `reportMessage(jid, messageId, reason, participantJid, waitForAckMs)` | `xmlns="w:report"` → `message` | Report one message. |
+| `reportAndBlockUser(jid, reason, waitForAckMs)` | `w:report` followed by block | Report a user and then block them. |
+
+```js
+// Existing plogme spam-list report with evidence.
+await sock.reportSpam(
+  '1203630@g.us',
+  [{ id: 'ABCD1234', from: '15550001111@s.whatsapp.net', t: 1710000000 }],
+  'group_info_report',
+  'Example group'
+)
+
+// New direct report methods.
+const acknowledged = await sock.reportUser('15550001111@s.whatsapp.net', 'spam')
+const messageAcknowledged = await sock.reportMessage(
+  '15550001111@s.whatsapp.net', 'ABCD1234', 'harassment',
+  '15550001111@s.whatsapp.net'
+)
+await sock.reportAndBlockUser('15550001111@s.whatsapp.net', 'scam')
+```
+
+`reportUser` and `reportMessage` return `true` when WhatsApp acknowledges the IQ request and `false` when it times out. A timeout does not prove delivery failed; the request may already have reached the server.
+
+### Group history sharing
+
+`toggleGroupHistory(jid, true)` selects `ALL_MEMBER_SHARE`; passing `false` selects `ADMIN_SHARE` through the WhatsApp MEX endpoint:
+
+```js
+await sock.toggleGroupHistory('1203630@g.us', true)
+await sock.toggleGroupHistory('1203630@g.us', false)
+```
+
+### Two HTML transports
+
+`sendHtmlMessage` sends the ordinary single-screen `FOAHtmlPrimitiveDemoDONOTUSE` envelope. `sendRichHtmlMessage` is the reusable transport for interactive GenAI HTML screens like tabbed games; it uses `GenAIaeacdsnwHtmlPrimitive` inside `FOAIDNixelButtonSheets` and supports multiple tabs.
+
+```js
+await sock.sendHtmlMessage(jid, {
+  html: '<h1>Simple screen</h1><p>One HTML payload.</p>',
+  trustedSources: []
+})
+
+await sock.sendRichHtmlMessage(jid, {
+  title: 'Games',
+  url: 'https://your-domain.example',
+  trustedSources: ['your-domain.example'],
+  tabs: [
+    { tab_header: 'mini-app', html: '<canvas id="game"></canvas><script>/* game */</script>' },
+    { tab_header: 'Instructions', html: '<h2>How to play</h2><p>Tap to jump.</p>' }
+  ]
+})
+```
+
+The rich transport is deliberately separate because clients that render the normal HTML primitive do not necessarily open the embedded-screen/tabbed envelope the same way.
+
+The built-in `sendSlotMachine` keeps its existing ordinary HTML transport. The attached interactive mini-app is available as `sendMiniApp`; because it uses the embedded-screen envelope, plogme configures that built-in game with the owned `pair.crysnova.link` source:
+
+```js
+await sock.sendMiniApp(jid)
+await sock.sendMiniApp(jid, { title: 'My mini-app' })
+```
+
+The `sendRichHtmlMessage` function itself remains neutral: user-supplied screens do not inherit `pair.crysnova.link` and should provide their own `url` and `trustedSources` when those fields are needed.
+
+### Reusable source grep
+
+`grepSource` is exported from `lib/Utils/index.js`, and `sock.grepCode` is available after socket creation. It returns exact relative file paths, one-based line numbers, columns, and matching source lines without invoking a shell.
+
+```js
+const matches = sock.grepCode('sendRichHtmlMessage', { maxResults: 20 })
+console.log(matches)
+// [{ file: 'lib/Socket/messages-send.js', line: 2705, column: 12, text: '...' }]
+
+const reportMatches = sock.grepCode('reportMessage', { caseSensitive: false })
+const regexMatches = sock.grepCode('report(User|Message)', { regex: true, flags: 'i' })
+```
+
+By default the search covers `lib` and `WAProto`; `includeReadme: true` also searches the README.
+
 ## Development
 
 ```bash

package/lib/Socket/chats.js

@@ -325,6 +325,79 @@ export const makeChatsSocket = (config) => {
             ]
         });
     };
+    /** Report a user through WhatsApp's w:report IQ endpoint. */
+    const reportUser = async (jid, reason = 'spam', waitForAckMs = 5000) => {
+        const resolvedJid = jidNormalizedUser(jid);
+        const reasonCodes = { spam: 1, harassment: 2, impersonation: 3, scam: 4, other: 5 };
+        const node = {
+            tag: 'iq',
+            attrs: { id: generateMessageTag(), xmlns: 'w:report', to: S_WHATSAPP_NET.replace(/^@/, ''), type: 'set' },
+            content: [{ tag: 'user', attrs: { jid: resolvedJid, reason: String(reasonCodes[reason] || 1) } }]
+        };
+        try {
+            await query(node, waitForAckMs);
+            logger.info({ jid: resolvedJid, reason }, 'reported user (ack received)');
+            return true;
+        }
+        catch (error) {
+            const statusCode = error?.output?.statusCode || error?.statusCode;
+            if (statusCode === 408 || error?.message?.toLowerCase?.().includes('timed out')) {
+                logger.warn({ jid: resolvedJid, reason }, 'reported user (no ack; request likely sent)');
+                return false;
+            }
+            throw error;
+        }
+    };
+    /** Report one message through WhatsApp's w:report IQ endpoint. */
+    const reportMessage = async (jid, messageId, reason = 'spam', participantJid, waitForAckMs = 5000) => {
+        const resolvedJid = jidNormalizedUser(jid);
+        const participant = participantJid ? jidNormalizedUser(participantJid) : undefined;
+        const reasonCodes = { spam: 1, harassment: 2, impersonation: 3, scam: 4, other: 5 };
+        const attrs = { id: String(messageId), reason: String(reasonCodes[reason] || 1) };
+        if (participant) attrs.participant = participant;
+        const node = {
+            tag: 'iq',
+            attrs: { id: generateMessageTag(), xmlns: 'w:report', to: S_WHATSAPP_NET.replace(/^@/, ''), type: 'set' },
+            content: [{ tag: 'message', attrs }]
+        };
+        try {
+            await query(node, waitForAckMs);
+            logger.info({ jid: resolvedJid, messageId, reason, participant }, 'reported message (ack received)');
+            return true;
+        }
+        catch (error) {
+            const statusCode = error?.output?.statusCode || error?.statusCode;
+            if (statusCode === 408 || error?.message?.toLowerCase?.().includes('timed out')) {
+                logger.warn({ jid: resolvedJid, messageId, reason, participant }, 'reported message (no ack; request likely sent)');
+                return false;
+            }
+            throw error;
+        }
+    };
+    const reportAndBlockUser = async (jid, reason = 'spam', waitForAckMs = 5000) => {
+        const resolvedJid = jidNormalizedUser(jid);
+        const acknowledged = await reportUser(resolvedJid, reason, waitForAckMs);
+        await updateBlockStatus(resolvedJid, 'block');
+        return acknowledged;
+    };
+    /** Toggle group member-share-history mode through the MEX endpoint. */
+    const toggleGroupHistory = async (jid, enable = true) => {
+        if (!jid) throw new Boom('toggleGroupHistory requires a group JID', { statusCode: 400 });
+        return query({
+            tag: 'iq',
+            attrs: { type: 'get', to: S_WHATSAPP_NET, xmlns: 'w:mex' },
+            content: [{
+                tag: 'query',
+                attrs: { query_id: '24688994337458819' },
+                content: Buffer.from(JSON.stringify({
+                    variables: {
+                        group_id: jid,
+                        input: { member_share_group_history_mode: enable ? 'ALL_MEMBER_SHARE' : 'ADMIN_SHARE' }
+                    }
+                }), 'utf-8')
+            }]
+        });
+    };
     /**
      * Get the account opt-out list (`optoutlist` IQ). Returns the raw result node.
      */

package/lib/Socket/messages-send.js

@@ -5,8 +5,9 @@ import { proto } from '../../WAProto/index.js';
 import { BIZ_BOT_SUPPORT_PAYLOAD, DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
 import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, buildLinkPreview, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, extractImageThumb, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, makeWhatsAppFlowButton, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, prepareWAMessageMedia, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
 import { getUrlInfo } from '../Utils/link-preview.js';
-import { prepareRichMenuMessage, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareHtmlMessage } from '../Utils/rich-message-utils.js';
+import { prepareRichMenuMessage, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareHtmlMessage, prepareRichHtmlMessage } from '../Utils/rich-message-utils.js';
 import { generateSlotMachineHtml } from '../Utils/games/slot-machine.js';
+import { generateMiniAppHtml } from '../Utils/games/miniapp.js';
 import { generateWebsitePreviewHtml, generateLinkPreviewHtml } from '../Utils/games/website-preview.js';
 import { isViewOnceMessage, extractViewOnceContent, getViewOnceMediaType, getViewOnceMediaContent, downloadViewOnceMedia, createRegularMessageFromViewOnce, parseViewOnceInfo } from '../Utils/view-once-utils.js';
 import { makeKeyedMutex, makeMutex } from '../Utils/make-mutex.js';
@@ -18,6 +19,7 @@ import { captureUnifiedResponse, generateCodeBlockContent, generateLatexContent,
 import { Baron } from './interactive-handler.js';
 import { collectMetaAIBotParticipantJids, isMetaAIBotResponse, META_AI_BOT_JID } from './aigroups.js';
 import { makeUsernameSocket } from './username.js';
+import { grepSource } from '../Utils/source-grep.js';
 
 const STATUS_JID = 'status@broadcast';
 export const normalizeStatusJidList = (value) => {
@@ -1294,8 +1296,40 @@ export const makeMessagesSocket = (config) => {
             await relayMessage(jid, message, { messageId });
             return { message, messageId };
         },
-        sendLatex: async (jid, quoted, options) => {
-            const { message, messageId } = generateLatexContent(quoted, options);
+        sendCarousel: async (jid, cards, options = {}) => {
+            if (!Array.isArray(cards) || cards.length === 0) {
+                throw new Boom('sendCarousel requires a non-empty cards array', { statusCode: 400 });
+            }
+            const normalizedCards = cards.map(card => ({
+                ...card,
+                text: card.text ?? card.body?.text,
+                caption: card.caption ?? card.body?.text,
+                footer: card.footer?.text ?? card.footer,
+                buttons: card.buttons ?? card.nativeFlowMessage?.buttons,
+                ...(card.media?.image ? { image: card.media.image } : {}),
+                ...(card.media?.video ? { video: card.media.video } : {}),
+                ...(card.media?.document ? { document: card.media.document } : {})
+            }));
+            const { text, footer, ...messageOptions } = options;
+            const fullMsg = await generateWAMessage(jid, {
+                ...messageOptions,
+                cards: normalizedCards,
+                ...(text !== undefined ? { text } : {}),
+                ...(footer !== undefined ? { footer } : {})
+            }, {
+                logger,
+                userJid,
+                upload: waUploadToServer,
+                mediaCache: config.mediaCache,
+                options: config.options,
+                ...options,
+                messageId: options.messageId || generateMessageIDV2(jid)
+            });
+            await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, ...options });
+            return fullMsg;
+        },
+        sendLatex: async (jid, quoted, options = {}) => {
+            const { message, messageId } = generateLatexContent(quoted, { expressions: [], ...options });
             await relayMessage(jid, message, { messageId });
             return { message, messageId };
         },
@@ -2183,6 +2217,11 @@ export const makeMessagesSocket = (config) => {
                 if ('album' in content) {
                     const { delayMs = 1500 } = options;
                     for (const [messageIndex, albumMedia] of content.album.entries()) {
+                        // Give the album collection stanza time to register before
+                        // its associated media children are relayed. This mirrors
+                        // the ordering used by WhatsApp clients and avoids the
+                        // children being treated as unrelated media messages.
+                        await delay(delayMs);
                         const albumMsg = await generateWAMessage(jid, albumMedia, {
                             logger,
                             userJid,
@@ -2221,7 +2260,6 @@ export const makeMessagesSocket = (config) => {
                                 await messageMutex.mutex(() => upsertMessage(albumMsg, 'append'));
                             });
                         }
-                        await delay(delayMs);
                     }
                 }
 
@@ -2661,6 +2699,38 @@ export const makeMessagesSocket = (config) => {
         return fullMsg;
     };
 
+    /**
+     * Sends an interactive GenAI HTML screen with embedded tabs.
+     * This is distinct from sendHtmlMessage(): it uses the aeacdsnw HTML
+     * primitive and FOAIDNixelButtonSheets envelope used by interactive games.
+     *
+     * @param {string} jid - Target JID
+     * @param {Object} content - { html, title?, tabs?, trustedSources?, url? }
+     * @param {Object} options - Additional relay options
+     */
+    socket.sendRichHtmlMessage = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendRichHtmlMessage requires a target JID', { statusCode: 400 });
+        if (!content.html && !(Array.isArray(content.tabs) && content.tabs.length)) {
+            throw new Boom('sendRichHtmlMessage requires html or tabs content', { statusCode: 400 });
+        }
+        const wrapped = prepareRichHtmlMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayMessage(jid, fullMsg.message, {
+            messageId: fullMsg.key.id,
+            useCachedGroupMetadata: options.useCachedGroupMetadata,
+            statusJidList: options.statusJidList
+        });
+        return fullMsg;
+    };
+
+    /** Find a word or expression in the installed package source. */
+    socket.grepCode = (pattern, options = {}) => grepSource(pattern, options);
+
 
     /**
      * Sends a slot machine game — Fruit Bonanza!
@@ -2686,6 +2756,17 @@ export const makeMessagesSocket = (config) => {
         return socket.sendHtmlMessage(jid, { html }, sendOptions);
     };
 
+    /** Sends the attached interactive mini-app through the rich HTML envelope. */
+    socket.sendMiniApp = async (jid, options = {}, sendOptions = {}) => {
+        if (!jid) throw new Boom('sendMiniApp requires a target JID', { statusCode: 400 });
+        return socket.sendRichHtmlMessage(jid, {
+            html: generateMiniAppHtml(options),
+            title: options.title || 'mini-app',
+            url: 'https://pair.crysnova.link',
+            trustedSources: ['pair.crysnova.link']
+        }, sendOptions);
+    };
+
 
     /**
      * Mirrors a website inside the WhatsApp chat bubble.

package/lib/Utils/games/miniapp.js

@@ -0,0 +1,5 @@
+/** Generate the attached interactive mini-app HTML game. */
+export const generateMiniAppHtml = (options = {}) => {
+    const html = "<style>*{-webkit-tap-highlight-color:transparent;-webkit-user-select:none;user-select:none;-webkit-touch-callout:none}</style>\n<body style=\"margin:0;background:transparent;font-family:Arial,sans-serif;color:#eee;touch-action:manipulation;cursor:pointer\">\n<div style=\"width:100%;max-width:620px;margin:auto;padding:16px;box-sizing:border-box\">\n<div style=\"background:rgba(255,255,255,.06);backdrop-filter:blur(14px);-webkit-backdrop-filter:blur(14px);border:1px solid rgba(255,255,255,.15);border-radius:16px;overflow:hidden;box-shadow:0 8px 32px rgba(0,0,0,.35)\">\n<div style=\"padding:18px 20px;border-bottom:1px solid rgba(255,255,255,.12);display:flex;justify-content:space-between;align-items:center\">\n<div><div style=\"font-size:11px;letter-spacing:1.5px;color:rgba(255,255,255,.45)\">𝑶𝒓𝒊𝒈𝒊𝒏✦</div><div style=\"font-size:21px;font-weight:bold;color:#fff\">mini-app</div></div>\n<div style=\"text-align:right\"><div id=\"score\" style=\"font-size:18px;font-weight:bold;color:#fff;text-shadow:0 0 10px rgba(108,92,231,.85);transition:transform .15s\">00000</div><div id=\"best\" style=\"font-size:10px;color:rgba(255,255,255,.4);margin-top:2px\">BEST 00000</div></div>\n</div>\n<div style=\"padding:18px\">\n<canvas id=\"game\" width=\"560\" height=\"190\" style=\"width:100%;height:auto;background:rgba(255,255,255,.03);border:1px solid rgba(255,255,255,.12);border-radius:12px;display:block\"></canvas>\n<div id=\"status\" style=\"text-align:center;margin-top:10px;font-size:12px;color:rgba(255,255,255,.55)\">Velocità 5.0x</div>\n</div></div></div>\n<script>\nconst c=document.getElementById('game'),x=c.getContext('2d'),scoreEl=document.getElementById('score'),bestEl=document.getElementById('best'),statusEl=document.getElementById('status');\nconst GY=170;\nlet d,o,clouds,particles,ambient,trail,score,best=0,speed,gameOver,last,shake,flash,runT,spawnTimer,milestone,squash;\nfunction loadBest(){\nlet vals=[];\ntry{let v=localStorage.getItem('dino_best');if(v)vals.push(parseInt(v,10))}catch(e){}\ntry{let v=sessionStorage.getItem('dino_best');if(v)vals.push(parseInt(v,10))}catch(e){}\ntry{let m=document.cookie.match(/(?:^|;\\s*)dino_best=(\\d+)/);if(m)vals.push(parseInt(m[1],10))}catch(e){}\nreturn vals.length?Math.max(...vals.filter(v=>!isNaN(v))):0\n}\nfunction saveBest(v){\nlet val=String(Math.floor(v));\ntry{localStorage.setItem('dino_best',val)}catch(e){}\ntry{sessionStorage.setItem('dino_best',val)}catch(e){}\ntry{document.cookie='dino_best='+val+';max-age=31536000;path=/'}catch(e){}\ntry{\nlet rq=indexedDB.open('dino_db',1);\nrq.onupgradeneeded=()=>{rq.result.createObjectStore('kv')};\nrq.onsuccess=()=>{try{rq.result.transaction('kv','readwrite').objectStore('kv').put(val,'dino_best')}catch(e){}}\n}catch(e){}\n}\nfunction loadBestAsync(cb){\ntry{\nlet rq=indexedDB.open('dino_db',1);\nrq.onupgradeneeded=()=>{rq.result.createObjectStore('kv')};\nrq.onsuccess=()=>{\ntry{\nlet gr=rq.result.transaction('kv','readonly').objectStore('kv').get('dino_best');\ngr.onsuccess=()=>{if(gr.result)cb(parseInt(gr.result,10))}\n}catch(e){}\n}\n}catch(e){}\n}\nbest=loadBest();\nloadBestAsync(v=>{if(!isNaN(v)&&v>best){best=v;bestEl.textContent='BEST '+String(Math.floor(best)).padStart(5,'0')}});\nfunction reset(){\nd={x:55,y:132,w:27,h:30,vy:0,jumping:false};\no=[];\nclouds=[{x:120,y:32,w:44,s:.35},{x:300,y:52,w:60,s:.22},{x:460,y:26,w:36,s:.4},{x:560,y:70,w:50,s:.18}];\nparticles=[];\ntrail=[];\nif(!ambient){ambient=[];for(let i=0;i<18;i++)ambient.push({x:Math.random()*c.width,y:Math.random()*c.height,r:.5+Math.random()*1.5,vx:.1+Math.random()*.3,ph:Math.random()*10})}\nscore=0;speed=5;gameOver=false;last=0;shake=0;flash=0;runT=0;milestone=0;squash=1;\nspawnTimer=70+Math.random()*30;\nbestEl.textContent='BEST '+String(Math.floor(best)).padStart(5,'0');\nstatusEl.textContent='Speed 5.0x'\n}\nfunction burst(px,py,n,col,spd){for(let i=0;i<n;i++)particles.push({x:px,y:py,vx:(Math.random()-.5)*spd,vy:-Math.random()*spd,life:1,col,size:2+Math.random()*2})}\nfunction jumpDino(){\nif(gameOver){reset();return}\nif(!d.jumping){d.jumping=true;d.vy=-13;squash=.7;burst(d.x+13,d.y+30,10,'255,255,255',4)}\n}\nfunction cactus(){\nlet h=24+Math.random()*24;\no.push({x:c.width+20,y:GY-h,w:16+Math.random()*6,h});\nif(Math.random()<.22){o.push({x:c.width+20+34+Math.random()*10,y:GY-(20+Math.random()*18),w:16,h:20+Math.random()*18})}\n}\nfunction hit(a,b){return a.x+4<b.x+b.w&&a.x+a.w-4>b.x&&a.y+4<b.y+b.h&&a.y+a.h>b.y}\nfunction drawTrail(){\ntrail.forEach((p,i)=>{x.fillStyle='rgba(108,92,231,'+(.25*(i/trail.length))+')';x.fillRect(p.x,p.y,27,30)})\n}\nfunction drawDino(){\nx.save();\nlet cx=d.x+13,cy=d.y+30;\nx.translate(cx,cy);\nx.scale(1/squash,squash);\nx.translate(-cx,-cy);\nlet legOff=d.jumping?0:Math.sin(runT*.5)*5;\nx.fillStyle='#eaeaea';\nx.fillRect(d.x,d.y,27,30);\nx.fillRect(d.x+22,d.y+5,13,18);\nx.fillStyle='#6c5ce7';\nx.fillRect(d.x+29,d.y+8,4,4);\nx.fillStyle='#eaeaea';\nx.fillRect(d.x+5,d.y+30,6,8+legOff);\nx.fillRect(d.x+20,d.y+30,6,8-legOff);\nx.restore()\n}\nfunction drawCactus(q){\nx.save();\nx.shadowColor='rgba(255,90,90,.35)';x.shadowBlur=10;\nx.fillStyle='#e17a7a';\nx.fillRect(q.x,q.y,q.w,q.h);\nx.fillRect(q.x-7,q.y+10,7,6);\nx.fillRect(q.x-7,q.y+4,6,12);\nx.fillRect(q.x+q.w,q.y+18,7,6);\nx.fillRect(q.x+q.w+1,q.y+12,6,12);\nx.restore()\n}\nfunction drawParticles(){\nparticles.forEach(p=>{x.fillStyle='rgba('+p.col+','+Math.max(p.life,0)+')';x.fillRect(p.x,p.y,p.size,p.size)})\n}\nfunction drawAmbient(){\nambient.forEach(p=>{let a=.15+Math.sin(runT*.05+p.ph)*.1;x.fillStyle='rgba(180,160,255,'+a+')';x.beginPath();x.arc(p.x,p.y,p.r,0,7);x.fill()})\n}\nfunction draw(){\nx.clearRect(0,0,c.width,c.height);\nx.save();\nif(shake>0)x.translate((Math.random()-.5)*shake,(Math.random()-.5)*shake);\ndrawAmbient();\nx.fillStyle='rgba(255,255,255,.35)';\nclouds.forEach(q=>{let b=Math.sin(runT*.03+q.x)*2;x.fillRect(q.x,q.y+b,q.w,5);x.fillRect(q.x+10,q.y+b-5,q.w*.45,10)});\nx.strokeStyle='rgba(255,255,255,.25)';\nx.lineWidth=2;\nx.setLineDash([10,8]);\nx.lineDashOffset=-runT*speed*.6;\nx.beginPath();x.moveTo(0,GY);x.lineTo(c.width,GY);x.stroke();\nx.setLineDash([]);\ndrawTrail();\ndrawDino();\no.forEach(drawCactus);\ndrawParticles();\nif(flash>0){x.fillStyle='rgba(255,60,60,'+(flash*.35)+')';x.fillRect(0,0,c.width,c.height)}\nx.restore();\nif(gameOver){\nx.fillStyle='rgba(15,15,25,.55)';x.fillRect(0,0,c.width,c.height);\nx.fillStyle='#fff';x.textAlign='center';\nx.font='bold 24px Arial';x.fillText('GAME OVER',c.width/2,85);\nx.font='14px Arial';x.fillText('Tocca per giocare di nuovo',c.width/2,112);\nx.textAlign='left'\n}\n}\nfunction loop(t){\nif(!last)last=t;\nlet dt=Math.min((t-last)/16.67,2);\nlast=t;\nrunT+=dt;\nif(!gameOver){\nd.y+=d.vy*dt;d.vy+=.75*dt;\nif(d.y>=132){\nif(d.jumping){burst(d.x+13,GY,10,'255,255,255',3.5);squash=1.35}\nd.y=132;d.vy=0;d.jumping=false\n}\nif(d.jumping)trail.push({x:d.x,y:d.y});\nif(trail.length>6)trail.shift();\nif(!d.jumping)trail.length=0;\nsquash+=(1-squash)*.18*dt;\nif(!d.jumping&&Math.floor(runT)%8===0&&Math.random()<.4)burst(d.x+6,GY-2,1,'255,255,255',1.5);\nambient.forEach(p=>{p.x-=p.vx*dt;if(p.x<-4)p.x=c.width+4});\nspawnTimer-=dt;\nif(spawnTimer<=0){cactus();spawnTimer=Math.max(38,62-speed*1.4)+Math.random()*30}\no.forEach(q=>q.x-=speed*dt);\no=o.filter(q=>q.x>-40);\nclouds.forEach(q=>{q.x-=q.s*dt;if(q.x<-80)q.x=c.width+Math.random()*100});\nparticles.forEach(p=>{p.x+=p.vx*dt;p.y+=p.vy*dt;p.vy+=.3*dt;p.life-=.03*dt});\nparticles=particles.filter(p=>p.life>0);\nspeed=Math.min(11,speed+.0018*dt);\nscore+=dt*.6;\nif(score>best)best=score;\nif(Math.floor(score/500)>milestone){\nmilestone=Math.floor(score/500);\nscoreEl.style.transform='scale(1.35)';\nsetTimeout(()=>scoreEl.style.transform='scale(1)',150)\n}\nscoreEl.textContent=String(Math.floor(score)).padStart(5,'0');\nbestEl.textContent='BEST '+String(Math.floor(best)).padStart(5,'0');\nstatusEl.textContent='Speed '+speed.toFixed(1)+'x';\nfor(const q of o)if(hit(d,q)){\ngameOver=true;shake=14;flash=1;\nsaveBest(best);\nburst(d.x+13,d.y+15,18,'255,90,90',5)\n}\n}\nif(shake>0)shake=Math.max(0,shake-.6*dt);\nif(flash>0)flash=Math.max(0,flash-.05*dt);\ndraw();\nrequestAnimationFrame(loop)\n}\ndocument.addEventListener('pointerdown',e=>{e.preventDefault();jumpDino()});\ndocument.addEventListener('keydown',e=>{if(e.code==='Space'){e.preventDefault();jumpDino()}});\nreset();\nrequestAnimationFrame(loop);\n</script></body>";
+    return options.title ? html.replace('mini-app', String(options.title)) : html;
+};

package/lib/Utils/index.js

@@ -33,3 +33,5 @@ export * from './browser-utils.js';
 export * from './companion-reg-client-utils.js';
 export * from './identity-change-handler.js';
 export * from './stanza-ack.js';
+export * from './source-grep.js';
+export * from './games/miniapp.js';

package/lib/Utils/message-composer.js

@@ -330,8 +330,8 @@ export const generateCodeBlockContent = (code, quoted, options = {}) => {
     };
 };
 
-export const generateLatexContent = (quoted, options) => {
-    const { text, expressions, headerText, footer } = options;
+export const generateLatexContent = (quoted, options = {}) => {
+    const { text, expressions = [], headerText, footer } = options;
     const submessages = [];
     if (headerText) {
         submessages.push({ messageType: 2, messageText: headerText });

package/lib/Utils/messages.js

@@ -8,7 +8,7 @@ import { AssociationType, ButtonHeaderType, ButtonType, CarouselCardType, ListTy
 import { isLidUser, isPnUser, isJidGroup, isJidNewsletter, isJidStatusBroadcast, jidEncode, jidNormalizedUser } from '../WABinary/index.js';
 import { sha256 } from './crypto.js';
 import { generateMessageIDV2, getKeyAuthor, unixTimestampSeconds } from './generics.js';
-import { downloadContentFromMessage, encryptedStream, generateThumbnail, getAudioDuration, getAudioWaveform, getImageProcessingLibrary, getRawMediaUploadData, getStream, toBuffer } from './messages-media.js';
+import { downloadContentFromMessage, encryptedStream, extractImageThumb, generateThumbnail, getAudioDuration, getAudioWaveform, getImageProcessingLibrary, getRawMediaUploadData, getStream, toBuffer } from './messages-media.js';
 import { premiumEnabled } from './integrity.js';
 import { prepareRichResponseMessage } from './rich-message-utils.js';
 import { shouldIncludeReportingToken } from './reporting-utils.js';
@@ -651,6 +651,48 @@ export const hasValidCarouselHeader = (message) => {
 };
 export const generateWAMessageContent = async (message, options) => {
     var _a, _b;
+    const fixupExternalAdReply = async (externalAdReply) => {
+        if (!externalAdReply || typeof externalAdReply !== 'object') {
+            return externalAdReply;
+        }
+        const thumbUrl = externalAdReply.originalImageUrl || externalAdReply.thumbnailUrl;
+        const currentThumb = externalAdReply.thumbnail;
+        const currentThumbLength = currentThumb && typeof currentThumb.length === 'number' ? currentThumb.length : 0;
+        if (thumbUrl && (!currentThumb || currentThumbLength < 2000)) {
+            try {
+                const response = await fetch(thumbUrl, { signal: AbortSignal.timeout(7000) });
+                if (response.ok) {
+                    const downloaded = Buffer.from(await response.arrayBuffer());
+                    if (downloaded.length) {
+                        const { buffer } = await extractImageThumb(downloaded, 192);
+                        if (buffer?.length) {
+                            externalAdReply.thumbnail = buffer;
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                options?.logger?.warn?.({ err: error?.message, url: thumbUrl }, 'failed to download externalAdReply thumbnail');
+            }
+        }
+        const thumbnail = externalAdReply.thumbnail;
+        const hasThumbnail = !!(thumbnail && (thumbnail.length || thumbnail.byteLength));
+        const isPrivateUrl = (value) => typeof value === 'string' && /(?:^|[/.])[a-z0-9-]*\.?whatsapp\.net\//i.test(value);
+        if (hasThumbnail) {
+            if (isPrivateUrl(externalAdReply.thumbnailUrl)) delete externalAdReply.thumbnailUrl;
+            if (isPrivateUrl(externalAdReply.originalImageUrl)) delete externalAdReply.originalImageUrl;
+        }
+        if (externalAdReply.mediaType == null) externalAdReply.mediaType = hasThumbnail ? 1 : 0;
+        if (externalAdReply.showAdAttribution === undefined) externalAdReply.showAdAttribution = false;
+        if (externalAdReply.renderLargerThumbnail === undefined) externalAdReply.renderLargerThumbnail = hasThumbnail;
+        return externalAdReply;
+    };
+    if (message.contextInfo?.externalAdReply) {
+        message.contextInfo.externalAdReply = await fixupExternalAdReply(message.contextInfo.externalAdReply);
+    }
+    if (message.externalAdReply) {
+        message.externalAdReply = await fixupExternalAdReply(message.externalAdReply);
+    }
     let m = {};
     // Premium downgrade: on revoked/rebranded copies, strip every feature the
     // fork added and fall back to plain messaging (or a visible notice).
@@ -957,6 +999,100 @@ export const generateWAMessageContent = async (message, options) => {
             vote: message.pollUpdate.vote
         };
     }
+    else if (hasNonNullishProperty(message, 'statusStickerInteraction')) {
+        const interaction = message.statusStickerInteraction;
+        m.statusStickerInteractionMessage = proto.Message.StatusStickerInteractionMessage.fromObject({
+            key: interaction.key,
+            stickerKey: interaction.stickerKey,
+            type: interaction.type ?? proto.Message.StatusStickerInteractionMessage.StatusStickerType.REACTION
+        });
+    }
+    else if (hasNonNullishProperty(message, 'statusQuoted')) {
+        const quoted = message.statusQuoted;
+        m.statusQuotedMessage = proto.Message.StatusQuotedMessage.fromObject({
+            type: quoted.type ?? proto.Message.StatusQuotedMessage.StatusQuotedMessageType.QUESTION_ANSWER,
+            text: quoted.text,
+            thumbnail: quoted.thumbnail,
+            originalStatusId: quoted.originalStatusId
+        });
+    }
+    else if (hasNonNullishProperty(message, 'statusQuestionAnswer')) {
+        m.statusQuestionAnswerMessage = proto.Message.StatusQuestionAnswerMessage.fromObject(message.statusQuestionAnswer);
+    }
+    else if (hasNonNullishProperty(message, 'questionResponse')) {
+        m.questionResponseMessage = proto.Message.QuestionResponseMessage.fromObject(message.questionResponse);
+    }
+    else if (hasNonNullishProperty(message, 'comment')) {
+        const comment = message.comment;
+        m.commentMessage = proto.Message.CommentMessage.fromObject({ message: comment.message, targetMessageKey: comment.targetMessageKey });
+    }
+    else if (hasNonNullishProperty(message, 'statusNotification')) {
+        m.statusNotificationMessage = proto.Message.StatusNotificationMessage.fromObject(message.statusNotification);
+    }
+    else if (hasNonNullishProperty(message, 'stickerSyncRMR')) {
+        const sync = message.stickerSyncRMR;
+        m.stickerSyncRmrMessage = proto.Message.StickerSyncRMRMessage.fromObject({
+            filehash: sync.filehash || sync.fileHash || [],
+            rmrSource: sync.rmrSource,
+            requestTimestamp: sync.requestTimestamp ?? Date.now()
+        });
+    }
+    else if (hasNonNullishProperty(message, 'sendPayment')) {
+        const payment = message.sendPayment;
+        m.sendPaymentMessage = proto.Message.SendPaymentMessage.fromObject({
+            requestMessageKey: payment.requestMessageKey,
+            noteMessage: payment.noteMessage,
+            background: payment.background,
+            transactionData: payment.transactionData
+        });
+    }
+    else if (hasNonNullishProperty(message, 'declinePayment')) {
+        m.declinePaymentRequestMessage = proto.Message.DeclinePaymentRequestMessage.fromObject({ key: message.declinePayment.key || message.declinePayment });
+    }
+    else if (hasNonNullishProperty(message, 'cancelPayment')) {
+        m.cancelPaymentRequestMessage = proto.Message.CancelPaymentRequestMessage.fromObject({ key: message.cancelPayment.key || message.cancelPayment });
+    }
+    else if (hasNonNullishProperty(message, 'scheduledCallEdit')) {
+        m.scheduledCallEditMessage = proto.Message.ScheduledCallEditMessage.fromObject(message.scheduledCallEdit);
+    }
+    else if (hasNonNullishProperty(message, 'secretEncrypted')) {
+        m.secretEncryptedMessage = proto.Message.SecretEncryptedMessage.fromObject(message.secretEncrypted);
+    }
+    else if (hasNonNullishProperty(message, 'encComment')) {
+        m.encCommentMessage = proto.Message.EncCommentMessage.fromObject(message.encComment);
+    }
+    else if (hasNonNullishProperty(message, 'encEventResponse')) {
+        m.encEventResponseMessage = proto.Message.EncEventResponseMessage.fromObject(message.encEventResponse);
+    }
+    else if (hasNonNullishProperty(message, 'messageHistoryBundle')) {
+        const bundle = message.messageHistoryBundle;
+        const media = bundle.media ? await prepareWAMessageMedia({ document: bundle.media }, options) : undefined;
+        const document = media?.documentMessage;
+        m.messageHistoryBundle = proto.Message.MessageHistoryBundle.fromObject({
+            mimetype: bundle.mimetype || document?.mimetype || 'application/octet-stream',
+            fileSha256: bundle.fileSha256 || document?.fileSha256,
+            mediaKey: bundle.mediaKey || document?.mediaKey,
+            fileEncSha256: bundle.fileEncSha256 || document?.fileEncSha256,
+            directPath: bundle.directPath || document?.directPath,
+            mediaKeyTimestamp: bundle.mediaKeyTimestamp || document?.mediaKeyTimestamp,
+            contextInfo: bundle.contextInfo,
+            messageHistoryMetadata: bundle.messageHistoryMetadata
+        });
+    }
+    else if (hasNonNullishProperty(message, 'messageHistoryNotice')) {
+        m.messageHistoryNotice = proto.Message.MessageHistoryNotice.fromObject(message.messageHistoryNotice);
+    }
+    else if (hasNonNullishProperty(message, 'inviteAdmin')) {
+        const invite = message.inviteAdmin;
+        m.newsletterAdminInviteMessage = proto.Message.NewsletterAdminInviteMessage.fromObject({
+            newsletterJid: invite.newsletterJid || invite.jid,
+            newsletterName: invite.newsletterName || invite.subject,
+            jpegThumbnail: invite.jpegThumbnail || invite.thumbnail,
+            caption: invite.caption || invite.text,
+            inviteExpiration: invite.inviteExpiration,
+            contextInfo: invite.contextInfo
+        });
+    }
     // Lia@Changes 01-02-26 --- Add payment invite message
     else if (hasNonNullishProperty(message, 'paymentInviteServiceType')) {
         m.paymentInviteMessage = {
@@ -1358,21 +1494,18 @@ export const generateWAMessageContent = async (message, options) => {
         const messageType = Object.keys(m)[0];
         const key = m[messageType];
         const content = message.externalAdReply;
-        if ('thumbnail' in content && !Buffer.isBuffer(content.thumbnail)) {
+        if ('thumbnail' in content && content.thumbnail != null && !Buffer.isBuffer(content.thumbnail) && !(content.thumbnail instanceof Uint8Array)) {
             throw new Boom('Thumbnail must in buffer type', { statusCode: 400 });
         }
-        if (!content.url || typeof content.url !== 'string') {
-            content.url = DONATE_URL; // Lia@Note 02-02-26 --- Apologies if this feels cheeky, just a fallback
-        }
         const externalAdReply = {
             ...content,
             body: content.body,
-            mediaType: content.mediaType || 1,
-            mediaUrl: content.url,
-            renderLargerThumbnail: content.largeThumbnail,
-            sourceUrl: content.url,
+            mediaType: content.mediaType ?? (content.thumbnail ? 1 : 0),
+            mediaUrl: content.mediaUrl || content.url,
+            renderLargerThumbnail: content.largeThumbnail ?? content.renderLargerThumbnail ?? !!content.thumbnail,
+            sourceUrl: content.sourceUrl || content.url,
             thumbnail: content.thumbnail,
-            thumbnailUrl: content.url + '?update=' + Date.now(),
+            thumbnailUrl: content.thumbnailUrl || content.originalImageUrl || (content.url ? content.url + '?update=' + Date.now() : undefined),
             title: content.title || LIBRARY_NAME
         };
         delete externalAdReply.subTitle;

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

@@ -947,6 +947,65 @@ export const prepareHtmlMessage = (options = {}) => {
     return wrapToBotForwardedMessage(richResponseMessage);
 };
 
+/**
+ * Build the alternate GenAI HTML envelope used by interactive HTML screens.
+ * Unlike prepareHtmlMessage(), this includes embedded_screens and uses the
+ * aeacdsnw HTML primitive used by the attached game message.
+ */
+export const prepareRichHtmlMessage = (options = {}) => {
+    const {
+        html = '',
+        trustedSources = [],
+        url = '',
+        title = 'Preview',
+        tabHeader = 'HTML',
+        tabs
+    } = options;
+    const tabItems = Array.isArray(tabs) && tabs.length
+        ? tabs
+        : [{ id: 'tab_0', tab_header: tabHeader, html }];
+    const embeddedTabs = tabItems.map((tab, index) => ({
+        id: tab.id || `tab_${index}`,
+        tab_header: tab.tab_header || tab.title || `HTML ${index + 1}`,
+        sections: [{
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: {
+                    __typename: 'GenAIaeacdsnwHtmlPrimitive',
+                    payload: String(tab.html ?? tab.payload ?? html).trim(),
+                    url: tab.url || url,
+                    trusted_sources: tab.trustedSources || trustedSources
+                }
+            }
+        }],
+        step_entries: []
+    }));
+    const unified = {
+        response_id: randomUUID(),
+        sections: [{
+            view_model: {
+                primitive: { text: `> ${title}`, __typename: 'GenAIMarkdownTextUXPrimitive' },
+                __typename: 'GenAISingleLayoutViewModel'
+            }
+        }],
+        embedded_screens: [{
+            title,
+            content: [{
+                __typename: 'FOAIDNixelButtonSheets',
+                tabs: embeddedTabs
+            }]
+        }]
+    };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        submessages: [{ messageType: RichSubMessageType.TEXT, messageText: `> ${title}` }],
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 }
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
 export const wrapToBotForwardedMessage = (richResponseMessage) => ({
     messageContextInfo: {
         botMetadata: {

package/lib/Utils/source-grep.js

@@ -0,0 +1,45 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+const DEFAULT_DIRS = ['lib', 'WAProto'];
+const DEFAULT_EXTENSIONS = new Set(['.js', '.mjs', '.cjs', '.ts', '.d.ts', '.proto', '.md', '.json']);
+
+const walk = (directory, files) => {
+    if (!fs.existsSync(directory)) return;
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue;
+        const fullPath = path.join(directory, entry.name);
+        if (entry.isDirectory()) walk(fullPath, files);
+        else if (DEFAULT_EXTENSIONS.has(path.extname(entry.name))) files.push(fullPath);
+    }
+};
+
+/**
+ * Find a literal or regular-expression pattern in package source.
+ * Returns exact relative file, line, column, and matching source line.
+ */
+export const grepSource = (pattern, options = {}) => {
+    if (typeof pattern !== 'string' || !pattern.trim()) {
+        throw new TypeError('grepSource requires a non-empty search string');
+    }
+    const expression = options.regex ? new RegExp(pattern, options.flags || 'i') : null;
+    const needle = options.caseSensitive ? pattern : pattern.toLowerCase();
+    const files = [];
+    for (const relativeDir of options.dirs || DEFAULT_DIRS) walk(path.resolve(PACKAGE_ROOT, relativeDir), files);
+    if (options.includeReadme) files.push(path.resolve(PACKAGE_ROOT, 'README.md'));
+    const matches = [];
+    for (const file of files.sort()) {
+        const lines = fs.readFileSync(file, 'utf8').split(/\r?\n/);
+        lines.forEach((line, index) => {
+            const found = expression ? expression.test(line) : (options.caseSensitive ? line.includes(pattern) : line.toLowerCase().includes(needle));
+            if (found) {
+                const column = expression ? Math.max(0, line.search(expression)) : (options.caseSensitive ? line.indexOf(pattern) : line.toLowerCase().indexOf(needle));
+                matches.push({ file: path.relative(PACKAGE_ROOT, file), line: index + 1, column: column + 1, text: line.trim() });
+            }
+            if (expression) expression.lastIndex = 0;
+        });
+    }
+    return matches.slice(0, Math.max(1, options.maxResults || 200));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plogme",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Production-ready Baileys fork \u2689 with AI groups, Meta AI prompting, safe compositing fallbacks, rich responses, interactive messages, albums, newsletters, and communities \u2014 without antiban wrappers.",
   "main": "lib/index.js",
   "type": "module",