plogme 2.1.0 → 2.1.2

package/lib/Utils/event-buffer.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/event-buffer.js
+ * About: Event buffer module for the Plogme WhatsApp protocol client.
+ * Important exports: makeEventBuffer
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import EventEmitter from 'events';
 import { WAMessageStatus } from '../Types/index.js';
 import { trimUndefined } from './generics.js';

package/lib/Utils/games/miniapp.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/games/miniapp.js
+ * About: Miniapp module for the Plogme WhatsApp protocol client.
+ * Important exports: generateMiniAppHtml
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 /** 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>";

package/lib/Utils/games/slot-machine.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/games/slot-machine.js
+ * About: Slot machine module for the Plogme WhatsApp protocol client.
+ * Important exports: generateSlotMachineHtml, prepareSlotMachineMessage
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 /**
  * Slot Machine Game — Fruit Bonanza
  * 

package/lib/Utils/games/website-preview.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/games/website-preview.js
+ * About: Website preview module for the Plogme WhatsApp protocol client.
+ * Important exports: generateWebsitePreviewHtml, generateLinkPreviewHtml
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 /**
  * Website Preview — Mirror any website inside WhatsApp chat
  * 

package/lib/Utils/generics.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/generics.js
+ * About: Generics module for the Plogme WhatsApp protocol client.
+ * Important exports: BufferJSON, getKeyAuthor, isStringNullOrEmpty, writeRandomPadMax16, unpadRandomMax16, generateParticipantHashV2, encodeWAMessage, generateRegistrationId; …
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { Boom } from '@hapi/boom';
 import { createHash, randomBytes, randomFillSync } from 'crypto';
 import { proto } from '../../WAProto/index.js';

package/lib/Utils/group-history.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/group-history.js
+ * About: Group history module for the Plogme WhatsApp protocol client.
+ * Important exports: decodeGroupHistory, processGroupHistory
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { inflateSync } from 'zlib';
 import { proto } from '../../WAProto/index.js';
 

package/lib/Utils/history.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/history.js
+ * About: History module for the Plogme WhatsApp protocol client.
+ * Important exports: downloadHistory, processHistoryMessage, downloadAndProcessHistorySyncNotification, getHistoryMsg
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { promisify } from 'util';
 import { inflate } from 'zlib';
 import { proto } from '../../WAProto/index.js';

package/lib/Utils/identity-change-handler.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/identity-change-handler.js
+ * About: Identity change handler module for the Plogme WhatsApp protocol client.
+ * Important exports: handleIdentityChange
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import NodeCache from '@cacheable/node-cache';
 import { areJidsSameUser, getBinaryNodeChild, jidDecode } from '../WABinary/index.js';
 import { isStringNullOrEmpty } from './generics.js';

package/lib/Utils/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/index.js
+ * About: Utils module for the Plogme WhatsApp protocol client.
+ * Important exports: No public exports detected; module side effects or declarations are local.
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 export * from './generics.js';
 export * from './decode-wa-message.js';
 export * from './message-inspect.js';

package/lib/Utils/jid-display-normalization.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/jid-display-normalization.js
+ * About: Jid display normalization module for the Plogme WhatsApp protocol client.
+ * Important exports: normalizeMentionedJidsForSend, normalizeMessageForDisplayJids
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { isHostedLidUser, isHostedPnUser, isLidUser, isPnUser, jidDecode } from '../WABinary/index.js';
 
 const createLidPnDebug = (logger) => {

package/lib/Utils/link-preview.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/link-preview.js
+ * About: Link preview module for the Plogme WhatsApp protocol client.
+ * Important exports: getUrlInfo
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { prepareWAMessageMedia } from './messages.js';
 import { extractImageThumb, getHttpStream } from './messages-media.js';
 const THUMBNAIL_WIDTH_PX = 192;

package/lib/Utils/logger.js

@@ -1,2 +1,14 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/logger.js
+ * About: Logger module for the Plogme WhatsApp protocol client.
+ * Important exports: No public exports detected; module side effects or declarations are local.
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import P from 'pino';
 export default P({ timestamp: () => `,"time":"${new Date().toJSON()}"` });

package/lib/Utils/lt-hash.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/lt-hash.js
+ * About: Lt hash module for the Plogme WhatsApp protocol client.
+ * Important exports: LT_HASH_ANTI_TAMPERING
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { LTHashAntiTampering } from 'whatsapp-rust-bridge';
 /**
  * LT Hash is a summation based hash algorithm that maintains the integrity of a piece of data

package/lib/Utils/make-mutex.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/make-mutex.js
+ * About: Make mutex module for the Plogme WhatsApp protocol client.
+ * Important exports: makeMutex, makeKeyedMutex
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { Mutex as AsyncMutex } from 'async-mutex';
 export const makeMutex = () => {
     const mutex = new AsyncMutex();

package/lib/Utils/message-composer.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/message-composer.js
+ * About: Message composer module for the Plogme WhatsApp protocol client.
+ * Important exports: generateTableContent, generateListContent, generateCodeBlockContent, generateLatexContent, generateLatexImageContent, generateLatexInlineImageContent, captureUnifiedResponse, generateUnifiedResponseContent; …
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { proto } from '../../WAProto/index.js';
 import { generateMessageIDV2 } from './generics.js';
 
@@ -265,7 +277,12 @@ const buildBotForwardedMessage = (submessages, contextInfo, unifiedResponse) =>
 
 export const generateTableContent = (title, headers, rows, quoted, options = {}) => {
     const { footer, headerText } = options;
-    const tableRows = [{ items: headers, isHeading: true }, ...rows.map(row => ({ items: row.map(String) }))];
+    const safeHeaders = Array.isArray(headers) ? headers.map(String) : [];
+    const safeRows = Array.isArray(rows) ? rows : [];
+    const tableRows = [
+        { items: safeHeaders, isHeading: true },
+        ...safeRows.map(row => ({ items: Array.isArray(row) ? row.map(String) : [String(row)] }))
+    ];
     const submessages = [];
     if (headerText) {
         submessages.push({ messageType: 2, messageText: headerText });

package/lib/Utils/message-inspect.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/message-inspect.js
+ * About: Message inspect module for the Plogme WhatsApp protocol client.
+ * Important exports: isScheduledMessage, getScheduledMessageTime, getMessagePaymentInfo, getMessageCommentMetadata, getMessageAddOns, getPollCorrectAnswer, toJid, getSenderLid
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { proto } from '../../WAProto/index.js';
 import { isLidUser, jidEncode } from '../WABinary/index.js';
 

package/lib/Utils/message-retry-manager.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/message-retry-manager.js
+ * About: Message retry manager module for the Plogme WhatsApp protocol client.
+ * Important exports: RetryReason, MessageRetryManager
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { LRUCache } from 'lru-cache';
 /** Number of sent messages to cache in memory for handling retry receipts */
 const RECENT_MESSAGES_SIZE = 1024;

package/lib/Utils/messages-media.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/messages-media.js
+ * About: Messages media module for the Plogme WhatsApp protocol client.
+ * Important exports: getImageProcessingLibrary, hkdfInfoKey, getRawMediaUploadData, getMediaKeys, extractVideoThumb, extractImageThumb, encodeBase64EncodedStringForUpload, generateProfilePicture; …
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { Boom } from '@hapi/boom';
 import { spawn } from 'child_process';
 import * as Crypto from 'crypto';

package/lib/Utils/messages.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/messages.js
+ * About: Messages module for the Plogme WhatsApp protocol client.
+ * Important exports: extractUrlFromText, generateLinkPreviewIfRequired, prepareWAMessageMedia, prepareDisappearingMessageSettingContent, generateForwardMessageContent, hasNonNullishProperty, hasOptionalProperty, hasValidAlbumMedia; …
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { Boom } from '@hapi/boom';
 import { randomBytes } from 'crypto';
 import { zip } from 'fflate';
@@ -92,6 +104,21 @@ export const prepareWAMessageMedia = async (message, options) => {
     if (!uploadData.mimetype) {
         uploadData.mimetype = MIMETYPE_MAP[mediaType];
     }
+    if (mediaType === 'sticker') {
+        // New compatibility names the native AI-sticker marker `meta`. WhatsApp's
+        // current StickerMessage schema exposes this as `isAiSticker`.
+        if (hasOptionalProperty(message, 'meta')) {
+            uploadData.isAiSticker = !!message.meta;
+            delete uploadData.meta;
+        }
+        // There is no protobuf field literally named `lock`. WhatsApp's
+        // compatible native marker for stickers that should not be saved is
+        // the avatar-sticker bit, which is what current clients inspect.
+        if (hasOptionalProperty(message, 'lock')) {
+            uploadData.isAvatar = !!message.lock;
+            delete uploadData.lock;
+        }
+    }
     if (cacheableKey) {
         const mediaBuff = await options.mediaCache.get(cacheableKey);
         if (mediaBuff) {
@@ -882,6 +909,33 @@ export const generateWAMessageContent = async (message, options) => {
         m.eventMessage.isScheduleCall = message.event.isScheduleCall ?? false;
         m.eventMessage.location = message.event.location;
     }
+    else if (hasNonNullishProperty(message, 'imagePoll')) {
+        const imagePoll = message.imagePoll;
+        if (!Array.isArray(imagePoll.options) || imagePoll.options.length < 2 || imagePoll.options.length > 12) {
+            throw new Boom('imagePoll.options must contain between 2 and 12 options', { statusCode: 400 });
+        }
+        const selectableOptionsCount = imagePoll.selectableCount ?? 1;
+        if (selectableOptionsCount < 0 || selectableOptionsCount > imagePoll.options.length) {
+            throw new Boom(`imagePoll.selectableCount should be >= 0 and <= ${imagePoll.options.length}`, {
+                statusCode: 400
+            });
+        }
+        m.pollCreationMessageV3 = {
+            name: imagePoll.name,
+            selectableOptionsCount,
+            options: imagePoll.options.map(option => ({
+                optionName: option.optionName,
+                optionHash: option.optionHash
+            })),
+            pollContentType: WAProto.Message.PollContentType.IMAGE,
+            endTime: imagePoll.endDate ? imagePoll.endDate.getTime() : undefined,
+            hideParticipantName: imagePoll.hideVoter ?? false,
+            allowAddOption: imagePoll.canAddOption ?? false
+        };
+        m.messageContextInfo = {
+            messageSecret: imagePoll.messageSecret || randomBytes(32)
+        };
+    }
     else if (hasNonNullishProperty(message, 'poll')) {
         (_a = message.poll).selectableCount || (_a.selectableCount = 0);
         (_b = message.poll).toAnnouncementGroup || (_b.toAnnouncementGroup = false);
@@ -1390,7 +1444,7 @@ export const generateWAMessageContent = async (message, options) => {
                         throw new Boom('Invalid media type for carousel card', { statusCode: 400 });
                     }
                     const carouselCard = {
-                        nativeFlowMessage: prepareNativeFlowButtons({
+                        nativeFlowMessage: card.nativeFlowMessage || prepareNativeFlowButtons({
                             ...card,
                             nativeFlow: card.nativeFlow || card.buttons || []
                         }),
@@ -1429,8 +1483,8 @@ export const generateWAMessageContent = async (message, options) => {
                 messageVersion: 1
             }
         };
-        if (hasOptionalProperty(message, 'text')) {
-            interactiveMessage.body = { text: message.text };
+        if (hasOptionalProperty(message, 'text') || hasOptionalProperty(message, 'content')) {
+            interactiveMessage.body = { text: message.text ?? message.content };
         }
         if (hasOptionalProperty(message, 'footer')) {
             interactiveMessage.footer = { text: message.footer };
@@ -1550,6 +1604,10 @@ export const generateWAMessageContent = async (message, options) => {
     if (hasOptionalProperty(message, 'groupStatus') && !!message.groupStatus) {
         const messageType = Object.keys(m)[0];
         const key = m[messageType];
+        const privateAudience = message.private;
+        if (privateAudience !== undefined && (privateAudience === null || typeof privateAudience !== 'object' || Array.isArray(privateAudience))) {
+            throw new Boom('groupStatus private metadata must be an object', { statusCode: 400 });
+        }
         if (key && 'contextInfo' in key && !!key.contextInfo) {
             key.contextInfo.isGroupStatus = message.groupStatus;
         }
@@ -1558,8 +1616,32 @@ export const generateWAMessageContent = async (message, options) => {
                 isGroupStatus: message.groupStatus
             };
         }
-        m = { groupStatusMessageV2: { message: m } };
+        if (privateAudience && (privateAudience.name != null || privateAudience.emoji != null)) {
+            const name = privateAudience.name == null ? '' : String(privateAudience.name);
+            const emoji = privateAudience.emoji == null ? '' : String(privateAudience.emoji);
+            if (!name && !emoji) {
+                throw new Boom('groupStatus private metadata requires a name or emoji', { statusCode: 400 });
+            }
+            const statusMessage = m[Object.keys(m)[0]];
+            statusMessage.contextInfo = {
+                ...(statusMessage.contextInfo || {}),
+                statusAudienceMetadata: {
+                    audienceType: proto.ContextInfo.StatusAudienceMetadata.AudienceType.CLOSE_FRIENDS,
+                    ...(name ? { listName: name } : {}),
+                    ...(emoji ? { listEmoji: emoji } : {})
+                }
+            };
+        }
+        // V2 remains the default. The legacy envelope is available for
+        // compatibility testing with clients that still handle the two
+        // group-status fields differently.
+        const groupStatusVersion = message.groupStatusVersion || options?.groupStatusVersion;
+        m = groupStatusVersion === 'legacy' || groupStatusVersion === 'v1'
+            ? { groupStatusMessage: { message: m } }
+            : { groupStatusMessageV2: { message: m } };
         delete message.groupStatus;
+        delete message.groupStatusVersion;
+        delete message.private;
     }
     // Media spoiler support uses WhatsApp's FutureProofMessage spoiler envelope plus
     // contextInfo.isSpoiler. Text spoilers use ||...|| by default because native text
@@ -1790,6 +1872,152 @@ export const generateWAMessage = async (jid, content, options) => {
     }
     return generateWAMessageFromContent(jid, await generateWAMessageContent(content, options), options);
 };
+/**
+ * Hashes an image-poll option as SHA-256(SHA-256(option name) + base64(file SHA-256)).
+ * This follows the WhatsApp Web image-poll format; the format remains experimental.
+ */
+export const hashImagePollOption = (optionName, fileSha256) => {
+    const nameHash = sha256(Buffer.from(String(optionName), 'utf-8')).toString('hex');
+    const mediaHash = fileSha256 ? Buffer.from(fileSha256).toString('base64') : '';
+    return sha256(Buffer.from(nameHash + mediaHash, 'utf-8')).toString('hex');
+};
+/**
+ * Sends a photo poll as one poll-creation message followed by associated image child messages.
+ * `relay` receives `(message, relayOptions, webMessageInfo)` for each wire message.
+ */
+export const generateWAMessageFromImagePoll = async (jid, content, relay, options = {}) => {
+    if (typeof relay !== 'function') {
+        throw new Boom('image poll requires a relay callback', { statusCode: 400 });
+    }
+    if (!Array.isArray(content?.values) || content.values.length < 2 || content.values.length > 12) {
+        throw new Boom('image poll requires between 2 and 12 values', { statusCode: 400 });
+    }
+    if (content.values.some(value => value && typeof value === 'object' && value.image) && typeof options.upload !== 'function') {
+        throw new Boom('image poll requires a configured media uploader', { statusCode: 400 });
+    }
+    const prepared = [];
+    const pollOptions = [];
+    for (const value of content.values) {
+        const option = typeof value === 'string' ? { name: value } : value;
+        const optionName = option?.name ?? option?.optionName;
+        if (typeof optionName !== 'string' || !optionName.trim()) {
+            throw new Boom('Each image poll value must have a non-empty name', { statusCode: 400 });
+        }
+        let media;
+        if (option.image) {
+            media = await prepareWAMessageMedia({ image: option.image }, { ...options, jid });
+        }
+        prepared.push({ media });
+        pollOptions.push({
+            optionName,
+            optionHash: hashImagePollOption(optionName, media?.imageMessage?.fileSha256)
+        });
+    }
+    if (!prepared.some(({ media }) => media)) {
+        throw new Boom('At least one image poll option must include an image', { statusCode: 400 });
+    }
+    const pollMessageContent = await generateWAMessageContent({
+        imagePoll: {
+            name: content.name,
+            selectableCount: content.selectableCount ?? 1,
+            options: pollOptions,
+            endDate: content.endDate,
+            hideVoter: content.hideVoter,
+            canAddOption: content.canAddOption,
+            messageSecret: content.messageSecret
+        }
+    }, { ...options, jid });
+    const poll = generateWAMessageFromContent(jid, pollMessageContent, { ...options, jid });
+    const pollMeta = {
+        tag: 'meta',
+        attrs: {
+            polltype: 'creation',
+            contenttype: isJidNewsletter(jid) ? 'image' : undefined
+        },
+        content: undefined
+    };
+    await relay(poll.message, {
+        messageId: poll.key.id,
+        additionalNodes: [...(options.additionalNodes || []), pollMeta]
+    }, poll);
+    for (let index = 0; index < prepared.length; index++) {
+        const media = prepared[index].media;
+        if (!media) continue;
+        const optionMessage = proto.Message.fromObject({
+            pollCreationOptionImageMessage: { message: media },
+            messageContextInfo: {
+                messageAssociation: {
+                    associationType: proto.MessageAssociation.AssociationType.MEDIA_POLL,
+                    parentMessageKey: poll.key
+                }
+            }
+        });
+        const option = generateWAMessageFromContent(jid, optionMessage, { ...options, jid, messageId: undefined });
+        await relay(option.message, { messageId: option.key.id }, option);
+    }
+    return poll;
+};
+/**
+ * Sends a motion photo as an image parent followed by an associated video child.
+ * The static image may be supplied as `image` or `thumbnail`; otherwise the
+ * prepared video thumbnail is used as the still image.
+ */
+export const generateWAMessageFromLivePhoto = async (jid, content, relay, options = {}) => {
+    if (typeof relay !== 'function') {
+        throw new Boom('live photo requires a relay callback', { statusCode: 400 });
+    }
+    if (!content?.video) {
+        throw new Boom('live photo requires a video source', { statusCode: 400 });
+    }
+    const normalizeMedia = media => typeof media === 'string' ? { url: media } : media;
+    const offset = content.motionPhotoPresentationOffsetMs ?? content.presentationOffsetMs;
+    if (offset != null && (!Number.isSafeInteger(Number(offset)) || Number(offset) < 0)) {
+        throw new Boom('motionPhotoPresentationOffsetMs must be a non-negative integer', { statusCode: 400 });
+    }
+    const video = await prepareWAMessageMedia({
+        video: normalizeMedia(content.video),
+        ...(content.videoMimetype ? { mimetype: content.videoMimetype } : {}),
+        ...(content.videoThumbnail ? { jpegThumbnail: content.videoThumbnail } : {}),
+        ...(offset != null ? { motionPhotoPresentationOffsetMs: Number(offset) } : {})
+    }, { ...options, jid });
+    const videoMessage = video?.videoMessage;
+    if (!videoMessage) {
+        throw new Boom('live photo video could not be prepared', { statusCode: 400 });
+    }
+    const still = content.image || content.thumbnail || videoMessage.jpegThumbnail;
+    if (!still) {
+        throw new Boom('live photo needs a still image or a video with an extractable thumbnail', { statusCode: 400 });
+    }
+    const parent = await generateWAMessage(jid, {
+        image: normalizeMedia(still),
+        caption: content.caption ?? content.text ?? '',
+        ...(!content.image && !content.thumbnail && videoMessage.jpegThumbnail
+            ? { jpegThumbnail: videoMessage.jpegThumbnail }
+            : content.imageThumbnail ? { jpegThumbnail: content.imageThumbnail } : {})
+    }, { ...options, jid });
+    const childContent = proto.Message.fromObject({
+        videoMessage: {
+            ...videoMessage,
+            ...(offset != null ? { motionPhotoPresentationOffsetMs: Number(offset) } : {})
+        },
+        messageContextInfo: {
+            messageAssociation: {
+                associationType: proto.MessageAssociation.AssociationType.MOTION_PHOTO,
+                parentMessageKey: parent.key
+            }
+        }
+    });
+    const { quoted: _quoted, ...childOptions } = options;
+    const child = generateWAMessageFromContent(jid, childContent, {
+        ...childOptions,
+        jid,
+        messageId: undefined
+    });
+    const relayOptions = options.relayOptions || {};
+    await relay(parent.message, { ...relayOptions, messageId: parent.key.id }, parent);
+    await relay(child.message, { ...relayOptions, messageId: child.key.id }, child);
+    return parent;
+};
 /** Get the key to access the true type of content */
 export const getContentType = (content) => {
     if (content) {

package/lib/Utils/meta-ai-msmsg.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/meta-ai-msmsg.js
+ * About: Meta ai msmsg module for the Plogme WhatsApp protocol client.
+ * Important exports: decryptMsmsgBotMessage, parseUnifiedResponseData, textFromUnifiedResponse, textFromRichResponse, extractMetaAiText, decodeUnifiedResponseInPlace, decodeDecryptedMsmsgMessage
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 import { proto } from '../../WAProto/index.js';
 import { aesDecryptGCM, hkdf } from './crypto.js';
 

package/lib/Utils/meta-compositing.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/meta-compositing.js
+ * About: Meta compositing module for the Plogme WhatsApp protocol client.
+ * Important exports: PlanningStepStatus, supportsMetaRendering, buildProgressIndicator, buildCompositingPlaceholder, buildPlainPlaceholder, metaTyping, editMetaMessage, sendMetaComposited; …
+ * Directions: Import the listed exports and preserve protocol, validation, and compatibility invariants when modifying.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 /**
  * Lia@Changes [WIP]
  * Meta Compositing — send rich messages with Meta AI-style progress indicator.