plogme 2.0.6 → 2.0.8

package/README.md

@@ -39,10 +39,10 @@ npm install plogme
 
 The package currently requires **Node.js 20 or newer**.
 
-To install the development branch directly from GitHub:
+The published package is available from npm:
 
 ```bash
-npm install github:crysnovax/baileys
+npm install plogme
 ```
 
 Plogme is an ES module package. Use `import` syntax in Node.js projects configured with `"type": "module"`.
@@ -1290,9 +1290,83 @@ await sock.sendBotToolResult(jid, {
   resolutionData: { status: 'success', value: 42 }
 })
 ```
+### Proto-backed map, prompts, sources, dynamic media, and transcripts
+These helpers expose fields explicitly present in the generated `WAProto` schema. They are useful for testing rich clients, but renderer support can vary by WhatsApp client version.
 
-### Planning metadata and tool results
+#### Map cards
+```js
+await sock.sendRichMap(jid, {
+  centerLatitude: 6.5244,
+  centerLongitude: 3.3792,
+  latitudeDelta: 0.12,
+  longitudeDelta: 0.1,
+  showInfoList: true,
+  annotations: [
+    {
+      latitude: 6.53,
+      longitude: 3.38,
+      title: 'Lagos',
+      body: 'Nigeria'
+    }
+  ]
+})
+```
 
+#### Suggested prompts
+```js
+await sock.sendBotPromptSuggestions(jid, {
+  text: 'Choose a follow-up',
+  suggestions: ['Summarize this', 'Translate this', 'Explain further'],
+  selectedPromptIndex: 1,
+  selectedPromptId: 'translate'
+})
+```
+
+#### Search/source metadata
+Provider values follow `WAProto.BotSourcesMetadata.BotSourceItem.SourceProvider`:
+`0 = UNKNOWN`, `1 = BING`, `2 = GOOGLE`, `3 = SUPPORT`, `4 = OTHER`.
+```js
+await sock.sendBotSources(jid, {
+  text: 'Here are the relevant sources:',
+  sources: [{
+    provider: 2,
+    url: 'https://example.com/docs',
+    query: 'baileys proto',
+    title: 'Documentation',
+    citationNumber: 1,
+    faviconUrl: 'https://example.com/favicon.ico'
+  }]
+})
+```
+
+#### Dynamic image/GIF metadata
+This sends the Proto `AIRichResponseDynamicMetadata` submessage. `type` may be `IMAGE` or `GIF`.
+```js
+await sock.sendRichDynamicMedia(jid, {
+  type: 'GIF',
+  url: 'https://example.com/animation.gif',
+  version: 2,
+  loopCount: 3
+})
+
+await sock.sendRichDynamicMedia(jid, {
+  type: 'IMAGE',
+  url: 'https://example.com/image.jpg',
+  version: 1
+})
+```
+
+#### PTT transcript metadata
+Use this for a caller-provided push-to-talk/voice transcript. The helper does not transcribe audio itself.
+```js
+await sock.sendBotPttTranscript(jid, {
+  text: 'Voice transcript',
+  transcript: 'Hello, this text came from a voice message.'
+})
+```
+
+All of these methods return the generated message object. For client-side testing, inspect `botForwardedMessage.message.richResponseMessage` and `messageContextInfo.botMetadata` before checking how the WhatsApp app renders the message.
+### Planning metadata and tool results
 `sendBotPlan` serializes the generated `BotProgressIndicatorMetadata` structure and advertises the `AGENTIC_PLANNING` and `QUERY_PLAN` capabilities defined in `WAProto`. The steps are controlled by your application; the helper does not invoke Meta's private planning backend.
 
 ```js
@@ -1430,7 +1504,7 @@ Auto-greet new contacts with an interactive FAQ menu. Fires once per contact, ne
 ### Basic Setup
 
 ```javascript
-import { createWelcomeFlow } from '@crysnovax/baileys'
+import { createWelcomeFlow } from 'plogme'
 
 const welcome = createWelcomeFlow(sock, {
   greeting: 'Welcome! How can I help you today?',
@@ -1506,7 +1580,7 @@ welcome.hasGreeted(jid)  // check if greeted → boolean
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | greeting | string | 'Welcome!…' | Body text of welcome message |
-| footer | string | 'Powered by @crysnovax/baileys' | Footer text |
+| footer | string | 'Powered by plogme' | Footer text |
 | buttonText | string | 'Choose an option' | List button label |
 | sectionTitle | string | 'How can we help?' | Section header |
 | faqs | Array | 4 defaults | { id, title, description } |
@@ -1629,7 +1703,7 @@ sock.sendMessage(jid, {
     text: 'Built manually',
     contextInfo: {
       externalAdReply: {
-        title: '@crysnovax/baileys',
+        title: 'plogme',
         thumbnail: fs.readFileSync('./image.jpg'),
         sourceApp: 'whatsapp',
         showAdAttribution: true,
@@ -1811,7 +1885,7 @@ saveFavs(remaining)
 
 ```javascript
 // Create
-sock.newsletterCreate('@crysnovax/baileys', 'Fresh updates weekly')
+sock.newsletterCreate('plogme', 'Fresh updates weekly')
 
 // Metadata
 const metadata = await sock.newsletterMetadata('1231111111111@newsletter')
@@ -1832,8 +1906,8 @@ sock.newsletterDemote('1231111111111@newsletter', '6281111111111@s.whatsapp.net'
 sock.newsletterChangeOwner('1231111111111@newsletter', '6281111111111@s.whatsapp.net')
 
 // Update
-sock.newsletterUpdate('1231111111111@newsletter', { name: '@crysnovax/baileys' })
-sock.newsletterUpdateName('1231111111111@newsletter', '@crysnovax/baileys')
+sock.newsletterUpdate('1231111111111@newsletter', { name: 'plogme' })
+sock.newsletterUpdateName('1231111111111@newsletter', 'plogme')
 sock.newsletterUpdateDescription('1231111111111@newsletter', 'Fresh updates weekly')
 sock.newsletterUpdatePicture('1231111111111@newsletter', { url: 'path/to/image.jpg' })
 sock.newsletterRemovePicture('1231111111111@newsletter')
@@ -1860,7 +1934,7 @@ sock.newsletterDelete('1231111111111@newsletter')
 
 ```javascript
 // Create
-const group = await sock.groupCreate('@crysnovax/baileys', ['628123456789@s.whatsapp.net'])
+const group = await sock.groupCreate('plogme', ['628123456789@s.whatsapp.net'])
 
 // Metadata
 const metadata = await sock.groupMetadata(jid)
@@ -1883,7 +1957,7 @@ sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'demote')
 sock.groupRequestParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'approve')
 
 // Info updates
-sock.groupUpdateSubject(jid, '@crysnovax/baileys')
+sock.groupUpdateSubject(jid, 'plogme')
 sock.groupUpdateDescription(jid, 'Updated description')
 sock.updateProfilePicture(jid, { url: 'path/to/image.jpg' })
 sock.removeProfilePicture(jid)
@@ -1916,7 +1990,7 @@ const requests = await sock.groupRequestParticipantsList(jid)
 const group = await sock.groupGetInviteInfo('ABC123456789')
 
 // Member label
-sock.updateMemberLabel(jid, '@crysnovax/baileys')
+sock.updateMemberLabel(jid, 'plogme')
 ```
 
 ---
@@ -1925,7 +1999,7 @@ sock.updateMemberLabel(jid, '@crysnovax/baileys')
 
 ```javascript
 // Create
-const community = await sock.communityCreate('@crysnovax/baileys', 'Fresh updates weekly')
+const community = await sock.communityCreate('plogme', 'Fresh updates weekly')
 
 // Create subgroup
 const group = await sock.communityCreateGroup(
@@ -1953,7 +2027,7 @@ sock.communityLeave(jid)
 sock.communityRequestParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'approve')
 
 // Updates
-sock.communityUpdateSubject(jid, '@crysnovax/baileys')
+sock.communityUpdateSubject(jid, 'plogme')
 sock.communityUpdateDescription(jid, 'Updated description')
 
 // Settings
@@ -2261,7 +2335,7 @@ Meta AI-style thinking indicators and live reasoning feeds. Works on all WhatsAp
 Show a live thinking indicator that you control. Delete it manually when ready — no "edited" badge ever appears.
 
 ```javascript
-import { metaTyping, buildSteps } from '@crysnovax/baileys'
+import { metaTyping, buildSteps } from 'plogme'
 
 const placeholder = await metaTyping(sock, jid, {
   description: 'Thinking…',
@@ -2296,7 +2370,7 @@ Here is your answer!
 Full flow: indicator shows → auto-deletes → clean final message lands. Works with every rich content type.
 
 ```javascript
-import { sendMetaComposited, PlanningStepStatus } from '@crysnovax/baileys'
+import { sendMetaComposited, PlanningStepStatus } from 'plogme'
 
 // With code block
 await sendMetaComposited(
@@ -2345,7 +2419,7 @@ await sendMetaComposited(
 Live Meta AI-style reasoning feed — each step visibly completes in real time, then the final rich message lands clean.
 
 ```javascript
-import { replayPlanning, mixedSteps } from '@crysnovax/baileys'
+import { replayPlanning, mixedSteps } from 'plogme'
 
 await replayPlanning(
   sock, jid,
@@ -2402,7 +2476,7 @@ import {
   buildSearchSteps,     // isEnhancedSearch: true
   mixedSteps,           // mix any combination
   buildSteps            // plain steps
-} from '@crysnovax/baileys'
+} from 'plogme'
 
 // All reasoning
 buildReasoningSteps(['Analyzing the problem…', 'Checking edge cases…'])
@@ -2421,7 +2495,7 @@ mixedSteps([
 Replay planning only (no final message):
 
 ```javascript
-import { replayPlanningOnly, buildSearchSteps } from '@crysnovax/baileys'
+import { replayPlanningOnly, buildSearchSteps } from 'plogme'
 
 await replayPlanningOnly(
   sock, jid,
@@ -2491,7 +2565,7 @@ sock.ev.on('settings.update', (update) => {})
 Auto-detects available libraries: sharp, @napi-rs/image, or jimp.
 
 ```javascript
-import { getImageProcessingLibrary } from '@crysnovax/baileys'
+import { getImageProcessingLibrary } from 'plogme'
 import { readFile } from 'fs/promises'
 
 const lib = await getImageProcessingLibrary()

package/lib/Defaults/index.js

@@ -10,7 +10,7 @@ export const CALL_VIDEO_PREFIX = 'https://call.whatsapp.com/video/';
 export const CALL_AUDIO_PREFIX = 'https://call.whatsapp.com/voice/';
 export const DEF_CALLBACK_PREFIX = 'CB:';
 export const DEF_TAG_PREFIX = 'TAG:';
-export const DONATE_URL = 'https://web.crysnovax.link'; // 
+export const DONATE_URL = 'https://pair.crysnovax.link'; //
 export const LIBRARY_NAME = 'crysnovax/bailey';
 export const PHONE_CONNECTION_CB = 'CB:Pong';
 export const WA_ADV_ACCOUNT_SIG_PREFIX = Buffer.from([6, 0]);

package/lib/Socket/messages-send.js

@@ -5,7 +5,7 @@ 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, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, prepareWAMessageMedia, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
 import { getUrlInfo } from '../Utils/link-preview.js';
-import { prepareRichMenuMessage, prepareA2UIMessage, prepareA2UICommandMenu, prepareAIRichCommandMenu, prepareSocialEntityMessage, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareSocialProfileMessage, prepareUnifiedResponseMessage, prepareGridImageMessage, prepareVerticalAlbumMessage, prepareVideoGridMessage, prepareHtmlMessage, prepareRichHtmlMessage, attachBotVerificationProofs, hasVerifiableProofs } from '../Utils/rich-message-utils.js';
+import { prepareRichMenuMessage, prepareA2UIMessage, prepareA2UICommandMenu, prepareAIRichCommandMenu, prepareSocialEntityMessage, prepareInstagramProfileMessage, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareSocialProfileMessage, prepareUnifiedResponseMessage, prepareRichMapMessage, prepareBotPromptSuggestionsMessage, prepareBotSourcesMessage, prepareRichDynamicMediaMessage, prepareBotPttTranscriptMessage, prepareGridImageMessage, prepareVerticalAlbumMessage, prepareVideoGridMessage, prepareHtmlMessage, prepareRichHtmlMessage, attachBotVerificationProofs, hasVerifiableProofs } 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';
@@ -37,6 +37,7 @@ export const normalizeStatusJidList = (value) => {
 export const makeMessagesSocket = (config) => {
     const { logger, linkPreviewImageThumbnailWidth, generateHighQualityLinkPreview, options: httpRequestOptions, patchMessageBeforeSending, cachedGroupMetadata, enableRecentMessageCache, maxMsgRetryCount } = config;
     const sock = makeUsernameSocket(config);
+    let socket;
     const { ev, authState, messageMutex, signalRepository, upsertMessage, query, fetchPrivacySettings, sendNode, groupMetadata, groupToggleEphemeral, registerSocketEndHandler } = sock;
     const getLIDForPN = signalRepository.lidMapping.getLIDForPN.bind(signalRepository.lidMapping);
 
@@ -56,57 +57,45 @@ export const makeMessagesSocket = (config) => {
 
     // ── BULK REACTION HELPER (NEW) ──
     const sendBulkReactions = async (jid, messageId, emoji, count = 1, fake = false) => {
-        const maxReactions = Math.min(count, 1000);
-        const reactions = [];
-
-        if (fake) {
-            for (let i = 0; i < maxReactions; i++) {
-                const fakeSender = `${Math.floor(Math.random() * 999999999)}${i}@s.whatsapp.net`;
-                reactions.push({
-                    key: {
-                        remoteJid: jid,
-                        fromMe: false,
-                        id: messageId,
-                        participant: fakeSender
-                    },
-                    reaction: {
-                        key: {
-                            remoteJid: jid,
-                            fromMe: false,
-                            id: messageId
-                        },
-                        text: emoji,
-                        senderTimestampMs: Date.now() + i
-                    }
-                });
-            }
-        } else {
-            for (let i = 0; i < maxReactions; i++) {
-                reactions.push({
-                    react: {
-                        text: emoji,
-                        key: {
-                            remoteJid: jid,
-                            fromMe: false,
-                            id: messageId
-                        }
-                    }
-                });
+        const maxReactions = Math.min(Math.max(Number(count) || 1, 1), 1000);
+        if (isJidNewsletter(jid)) {
+            if (typeof socket.newsletterReactMessage !== 'function') {
+                throw new Boom('newsletter reaction API is unavailable', { statusCode: 501 });
             }
+            await socket.newsletterReactMessage(jid, messageId, String(emoji || ''));
+            return { sent: 1, requested: maxReactions, fake: false, channel: true, jid };
         }
-
-        const batchSize = 50;
-        for (let i = 0; i < reactions.length; i += batchSize) {
-            const batch = reactions.slice(i, i + batchSize);
-            try {
-                await sock.sendMessage(jid, batch, { ephemeralExpiration: 86400 });
-                await delay(100);
-            } catch (err) {
-                console.log(`[BULK_REACT] Batch failed: ${err.message}`);
+        const makeReaction = () => ({
+            react: {
+                text: String(emoji || ''),
+                key: {
+                    remoteJid: jid,
+                    fromMe: false,
+                    id: messageId
+                }
             }
+        });
+        let sent = 0;
+        const batchSize = 10;
+
+        // sendMessage accepts one content object, not an array of messages.
+        // Also, fake inbound reaction records cannot be serialized as outgoing
+        // WhatsApp messages or impersonate other users. Keep the flag for API
+        // compatibility, but always send a valid reaction from this account.
+        if (fake) {
+            logger.warn('[BULK_REACT] fake=true cannot impersonate other WhatsApp users; sending valid reactions from this account');
+        }
+        for (let i = 0; i < maxReactions; i += batchSize) {
+            const batch = Array.from({ length: Math.min(batchSize, maxReactions - i) }, () =>
+                socket.sendMessage(jid, makeReaction(), { ephemeralExpiration: 86400 })
+                    .then(() => { sent += 1; })
+                    .catch(error => logger.warn(`[BULK_REACT] Reaction failed: ${error.message}`))
+            );
+            await Promise.all(batch);
+            if (i + batchSize < maxReactions) await delay(100);
         }
 
-        return { sent: maxReactions, fake, jid };
+        return { sent, requested: maxReactions, fake: false, jid };
     };
 
     // ── MIMIC HELPER ──
@@ -1232,7 +1221,7 @@ export const makeMessagesSocket = (config) => {
         }
     });
 
-    const socket = {
+    socket = {
         ...sock,
         userDevicesCache,
         devicesMutex,
@@ -2440,6 +2429,71 @@ export const makeMessagesSocket = (config) => {
         }
         return fullMsg;
     };
+    /** Sends a protocol-backed AIRich map with optional numbered annotations. */
+    socket.sendRichMap = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendRichMap requires a target JID', { statusCode: 400 });
+        const wrapped = prepareRichMapMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    };
+    /** Sends BotSuggestedPromptMetadata with a rich-response text fallback. */
+    socket.sendBotPromptSuggestions = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendBotPromptSuggestions requires a target JID', { statusCode: 400 });
+        const wrapped = prepareBotPromptSuggestionsMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    };
+    /** Sends BotSourcesMetadata for citation-aware bot responses. */
+    socket.sendBotSources = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendBotSources requires a target JID', { statusCode: 400 });
+        const wrapped = prepareBotSourcesMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    };
+    /** Sends an experimental AIRich dynamic image/GIF submessage. */
+    socket.sendRichDynamicMedia = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendRichDynamicMedia requires a target JID', { statusCode: 400 });
+        const wrapped = prepareRichDynamicMediaMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    };
+    /** Sends BotPttPromptMetadata containing a caller-provided transcript. */
+    socket.sendBotPttTranscript = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendBotPttTranscript requires a target JID', { statusCode: 400 });
+        const wrapped = prepareBotPttTranscriptMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    };
     socket.richMenu = async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('richMenu requires a target JID', { statusCode: 400 });
         const wrapped = prepareRichMenuMessage(content);

package/lib/Utils/generics.js

@@ -184,7 +184,7 @@ export const bindWaitForConnectionUpdate = (ev) => bindWaitForEvent(ev, 'connect
  * Use to ensure your WA connection is always on the latest version
  */
 export const fetchLatestBaileysVersion = async (options = {}) => {
-    const URL = 'https://web.crysnovax.link';
+    const URL = 'https://pair.crysnovax.link';
     try {
         const response = await fetch(URL, {
             dispatcher: options.dispatcher,

package/lib/Utils/generics.js@old

@@ -179,7 +179,7 @@ export const bindWaitForConnectionUpdate = (ev) => bindWaitForEvent(ev, 'connect
  * Use to ensure your WA connection is always on the latest version
  */
 export const fetchLatestBaileysVersion = async (options = {}) => {
-    const URL = 'https://web.crysnovax.link';
+    const URL = 'https://pair.crysnovax.link';
     try {
         const response = await fetch(URL, {
             dispatcher: options.dispatcher,

package/lib/Utils/messages.js

@@ -250,7 +250,7 @@ const prepareProductMessage = async (message, options) => {
  */
 // Lia@Changes 21-04-26 --- Enhanced prepareStickerPackMessage
 const prepareStickerPackMessage = async (message, options) => {
-    const { cover, stickers = [], name = '📦 Sticker Pack', publisher = 'Website: web.crysnovax.link', description = '🏷️ crysnovax/bailey' } = message;
+    const { cover, stickers = [], name = '📦 Sticker Pack', publisher = 'Website: pair.crysnovax.link', description = '🏷️ crysnovax/bailey' } = message;
     if (stickers.length > 60) {
         throw new Boom('Sticker pack exceeds the maximum limit of 60 stickers', { statusCode: 400 });
     }

package/lib/Utils/messages.js[old]

@@ -271,7 +271,7 @@ const prepareProductMessage = async (message, options) => {
  */
 // Lia@Changes 21-04-26 --- Enhanced prepareStickerPackMessage
 const prepareStickerPackMessage = async (message, options) => {
-    const { cover, stickers = [], name = '📦 Sticker Pack', publisher = 'Website: web.crysnovax.link', description = '🏷️ crysnovax/bailey' } = message;
+    const { cover, stickers = [], name = '📦 Sticker Pack', publisher = 'Website: pair.crysnovax.link', description = '🏷️ crysnovax/bailey' } = message;
     if (stickers.length > 60) {
         throw new Boom('Sticker pack exceeds the maximum limit of 60 stickers', { statusCode: 400 });
     }

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

@@ -169,6 +169,47 @@ export const toUnified = (submessages, uuid) => ({
                     }
                 };
             }
+            case RichSubMessageType.MAP: {
+                const map = submessage.mapMetadata || {};
+                return {
+                    view_model: {
+                        primitive: {
+                            center_latitude: map.centerLatitude,
+                            center_longitude: map.centerLongitude,
+                            latitude_delta: map.latitudeDelta,
+                            longitude_delta: map.longitudeDelta,
+                            show_info_list: map.showInfoList === true,
+                            annotations: (map.annotations || []).map((annotation, index) => ({
+                                annotation_number: annotation.annotationNumber ?? index + 1,
+                                latitude: annotation.latitude,
+                                longitude: annotation.longitude,
+                                title: annotation.title || '',
+                                body: annotation.body || ''
+                            })),
+                            __typename: 'GenAIMapPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
+            }
+            case RichSubMessageType.DYNAMIC: {
+                const dynamic = submessage.dynamicMetadata || {};
+                const dynamicType = dynamic.type === proto.AIRichResponseDynamicMetadata.AIRichResponseDynamicMetadataType.AI_RICH_RESPONSE_DYNAMIC_METADATA_TYPE_GIF
+                    ? 'GIF'
+                    : 'IMAGE';
+                return {
+                    view_model: {
+                        primitive: {
+                            dynamic_type: dynamicType,
+                            version: dynamic.version,
+                            url: dynamic.url || '',
+                            loop_count: dynamic.loopCount,
+                            __typename: 'GenAIDynamicMediaPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
+            }
             case RichSubMessageType.TEXT:
                 return {
                     view_model: {
@@ -1110,6 +1151,146 @@ export const prepareUnifiedResponseMessage = ({ sections = [], submessages = [],
     return wrapToBotForwardedMessage(richResponseMessage);
 };
 
+/** Build a protocol-backed AIRich map card with optional numbered annotations. */
+export const prepareRichMapMessage = ({ text = 'Map location', centerLatitude, centerLongitude, latitudeDelta, longitudeDelta, annotations = [], showInfoList = false, verificationMetadata } = {}) => {
+    if (!Number.isFinite(Number(centerLatitude)) || !Number.isFinite(Number(centerLongitude))) {
+        throw new Boom('prepareRichMapMessage requires centerLatitude and centerLongitude', { statusCode: 400 });
+    }
+    const submessages = [
+        ...(text ? [{ messageType: RichSubMessageType.TEXT, messageText: String(text) }] : []),
+        {
+        messageType: RichSubMessageType.MAP,
+        mapMetadata: {
+            centerLatitude: Number(centerLatitude),
+            centerLongitude: Number(centerLongitude),
+            ...(latitudeDelta == null ? {} : { latitudeDelta: Number(latitudeDelta) }),
+            ...(longitudeDelta == null ? {} : { longitudeDelta: Number(longitudeDelta) }),
+            showInfoList: Boolean(showInfoList),
+            annotations: (Array.isArray(annotations) ? annotations : []).map((annotation, index) => ({
+                annotationNumber: annotation.annotationNumber ?? index + 1,
+                latitude: Number(annotation.latitude),
+                longitude: Number(annotation.longitude),
+                title: String(annotation.title || ''),
+                body: String(annotation.body || '')
+            }))
+        }
+        }
+    ];
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        submessages,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(toUnified(submessages, randomUUID()))) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 }
+    });
+    return wrapToBotForwardedMessage(richResponseMessage, verificationMetadata);
+};
+
+/** Build a rich response carrying BotSuggestedPromptMetadata from WAProto. */
+export const prepareBotPromptSuggestionsMessage = ({ text = '', suggestions = [], selectedPromptIndex, selectedPromptId, verificationMetadata } = {}) => {
+    if (!Array.isArray(suggestions) || suggestions.length === 0) {
+        throw new Boom('prepareBotPromptSuggestionsMessage requires at least one suggestion', { statusCode: 400 });
+    }
+    const envelope = wrapToBotForwardedMessage(proto.AIRichResponseMessage.create({
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        submessages: [{ messageType: RichSubMessageType.TEXT, messageText: String(text) }],
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 }
+    }), verificationMetadata);
+    envelope.messageContextInfo.botMetadata.suggestedPromptMetadata = {
+        suggestedPrompts: suggestions.map(String),
+        ...(selectedPromptIndex == null ? {} : { selectedPromptIndex: Number(selectedPromptIndex) }),
+        ...(selectedPromptId == null ? {} : { selectedPromptId: String(selectedPromptId) })
+    };
+    return envelope;
+};
+
+/** Build a rich response carrying BotSourcesMetadata for citations/search results. */
+export const prepareBotSourcesMessage = ({ text = '', sources = [], verificationMetadata } = {}) => {
+    if (!Array.isArray(sources) || sources.length === 0) {
+        throw new Boom('prepareBotSourcesMessage requires at least one source', { statusCode: 400 });
+    }
+    const submessages = [{
+        messageType: RichSubMessageType.TEXT,
+        messageText: String(text || 'Sources')
+    }];
+    const sourceCards = sources.map((source, index) => ({
+        source_type: 'THIRD_PARTY',
+        source_display_name: source.sourceTitle || source.title || '',
+        source_subtitle: source.sourceQuery || source.query || 'Source',
+        source_url: source.sourceProviderUrl || source.url || '',
+        favicon: {
+            url: source.faviconCdnUrl || source.faviconUrl || source.thumbnailCdnUrl || source.thumbnailUrl || '',
+            mime_type: 'image/jpeg',
+            width: 16,
+            height: 16
+        },
+        citation_number: source.citationNumber ?? index + 1
+    })).filter((source) => source.source_url || source.source_display_name);
+    const sections = toUnified(submessages, randomUUID()).sections;
+    if (sourceCards.length) {
+        sections.push({
+            view_model: {
+                primitive: { sources: sourceCards, __typename: 'GenAISearchResultPrimitive' },
+                __typename: 'GenAISingleLayoutViewModel'
+            }
+        });
+    }
+    const envelope = wrapToBotForwardedMessage(proto.AIRichResponseMessage.create({
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        submessages,
+        unifiedResponse: { data: Buffer.from(JSON.stringify({ response_id: randomUUID(), sections })) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 }
+    }), verificationMetadata);
+    envelope.messageContextInfo.botMetadata.richResponseSourcesMetadata = {
+        sources: sources.map((source, index) => ({
+            provider: source.provider ?? proto.BotSourcesMetadata.BotSourceItem.SourceProvider.OTHER,
+            thumbnailCdnUrl: source.thumbnailCdnUrl || source.thumbnailUrl || '',
+            sourceProviderUrl: source.sourceProviderUrl || source.url || '',
+            sourceQuery: source.sourceQuery || source.query || '',
+            faviconCdnUrl: source.faviconCdnUrl || source.faviconUrl || '',
+            citationNumber: source.citationNumber ?? index + 1,
+            sourceTitle: source.sourceTitle || source.title || ''
+        }))
+    };
+    return envelope;
+};
+
+/** Build an AIRich dynamic image/GIF submessage from WAProto metadata. */
+export const prepareRichDynamicMediaMessage = ({ url = '', type = 'IMAGE', version = 1, loopCount, verificationMetadata } = {}) => {
+    if (!url || typeof url !== 'string') throw new Boom('prepareRichDynamicMediaMessage requires a URL', { statusCode: 400 });
+    const dynamicTypes = proto.AIRichResponseDynamicMetadata.AIRichResponseDynamicMetadataType;
+    const normalizedType = String(type).toUpperCase();
+    const dynamicMetadata = {
+        type: normalizedType === 'GIF'
+            ? dynamicTypes.AI_RICH_RESPONSE_DYNAMIC_METADATA_TYPE_GIF
+            : dynamicTypes.AI_RICH_RESPONSE_DYNAMIC_METADATA_TYPE_IMAGE,
+        version: Number(version),
+        url,
+        ...(loopCount == null ? {} : { loopCount: Number(loopCount) })
+    };
+    const submessages = [{ messageType: RichSubMessageType.DYNAMIC, dynamicMetadata }];
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        submessages,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(toUnified(submessages, randomUUID()))) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 }
+    });
+    return wrapToBotForwardedMessage(richResponseMessage, verificationMetadata);
+};
+
+/** Build a rich response carrying the exact BotPttPromptMetadata transcript field. */
+export const prepareBotPttTranscriptMessage = ({ text = '', transcript = '', verificationMetadata } = {}) => {
+    if (!transcript || typeof transcript !== 'string') {
+        throw new Boom('prepareBotPttTranscriptMessage requires a transcript', { statusCode: 400 });
+    }
+    const envelope = wrapToBotForwardedMessage(proto.AIRichResponseMessage.create({
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        submessages: [{ messageType: RichSubMessageType.TEXT, messageText: String(text || transcript) }],
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 }
+    }), verificationMetadata);
+    envelope.messageContextInfo.botMetadata.pttPromptMetadata = { transcript };
+    return envelope;
+};
+
 export const prepareRichResponseMessage = (content) => {
     const { alignment, code, contentText, disclaimerText, footerText, headerText, imageText, inlineImage, inlineVideo, items, language, latex, links, noDonation, noHeading, posts, products, reels, sources: sourceInputs, suggested, richResponse, table, tapLinkUrl, title, verificationMetadata } = content;
     let submessages = [];

package/lib/index.d.ts

@@ -278,6 +278,67 @@ export interface SocialEntityContent {
     responseId?: string;
 }
 
+export interface RichMapAnnotation {
+    annotationNumber?: number;
+    latitude: number;
+    longitude: number;
+    title?: string;
+    body?: string;
+}
+
+export interface RichMapContent {
+    centerLatitude: number;
+    centerLongitude: number;
+    latitudeDelta?: number;
+    longitudeDelta?: number;
+    annotations?: RichMapAnnotation[];
+    showInfoList?: boolean;
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface BotPromptSuggestionsContent {
+    text?: string;
+    suggestions: string[];
+    selectedPromptIndex?: number;
+    selectedPromptId?: string;
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface BotSourceContent {
+    provider?: number;
+    thumbnailCdnUrl?: string;
+    thumbnailUrl?: string;
+    sourceProviderUrl?: string;
+    url?: string;
+    sourceQuery?: string;
+    query?: string;
+    faviconCdnUrl?: string;
+    faviconUrl?: string;
+    citationNumber?: number;
+    sourceTitle?: string;
+    title?: string;
+}
+
+export interface BotSourcesContent {
+    text?: string;
+    sources: BotSourceContent[];
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface RichDynamicMediaContent {
+    url: string;
+    type?: 'IMAGE' | 'GIF' | string;
+    version?: number;
+    loopCount?: number;
+    verificationMetadata?: Record<string, unknown>;
+}
+
+export interface BotPttTranscriptContent {
+    transcript: string;
+    text?: string;
+    verificationMetadata?: Record<string, unknown>;
+}
+
 export interface AIRichCommandMenuContent {
     image: string;
     title?: string;
@@ -326,6 +387,16 @@ export interface WASocket {
     richMenu(jid: string, content?: RichMenuContent, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a provider-neutral AIRich social/entity result card. */
     sendSocialEntity(jid: string, content?: SocialEntityContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send a protocol-backed AIRich map with optional numbered annotations. */
+    sendRichMap(jid: string, content: RichMapContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send BotSuggestedPromptMetadata with a rich-response text fallback. */
+    sendBotPromptSuggestions(jid: string, content: BotPromptSuggestionsContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send BotSourcesMetadata for citation-aware bot responses. */
+    sendBotSources(jid: string, content: BotSourcesContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send an experimental AIRich dynamic image/GIF submessage. */
+    sendRichDynamicMedia(jid: string, content: RichDynamicMediaContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send BotPttPromptMetadata containing a caller-provided transcript. */
+    sendBotPttTranscript(jid: string, content: BotPttTranscriptContent, options?: Record<string, unknown>): Promise<unknown>;
     /** Send the primary Instagram profile result using the universal social/entity format. */
     sendInstagramProfile(jid: string, content: SocialEntityContent, options?: Record<string, unknown>): Promise<unknown>;
     /** Send arbitrary A2UI/interactive payloads with immediate relay/edit rendering. */

package/package.json

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