plogme 2.0.4 → 2.0.5

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, prepareA2UICommandMenu, prepareAIRichCommandMenu, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, 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, 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';
@@ -1051,7 +1051,7 @@ export const makeMessagesSocket = (config) => {
         await relayMessage(jid, fullMsg.message, relayOptions);
 
         const richEnvelope = fullMsg.message?.botForwardedMessage?.message?.richResponseMessage;
-        if (options.renderRichResponse !== false && richEnvelope) {
+        if (options.renderRichResponse !== false && (richEnvelope || options.forceRichEdit || fullMsg.message?.interactiveMessage?.bloksWidget)) {
             const editContent = proto.Message.fromObject({
                 botForwardedMessage: {
                     message: {
@@ -2407,7 +2407,7 @@ export const makeMessagesSocket = (config) => {
             messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
             ...options,
         });
-        await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, ...options.relayOptions });
+        await relayRichMessage(jid, fullMsg, { ...options, forceRichEdit: true });
         if (config.emitOwnEvents) {
             process.nextTick(async () => {
                 await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
@@ -2415,6 +2415,27 @@ export const makeMessagesSocket = (config) => {
         }
         return fullMsg;
     };
+    /** Send arbitrary A2UI/interactive payloads; sendA2UICommandMenu is a preset wrapper. */
+    socket.sendA2UIMessage = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendA2UIMessage requires a target JID', { statusCode: 400 });
+        const { image, ...payload } = content || {};
+        let imageMessage;
+        if (image) {
+            const prepared = await prepareWAMessageMedia({ image }, { upload: waUploadToServer });
+            imageMessage = prepared.imageMessage;
+        }
+        const wrapped = prepareA2UIMessage({ ...payload, imageMessage });
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options,
+        });
+        await relayRichMessage(jid, fullMsg, { ...options, forceRichEdit: true });
+        if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
+        return fullMsg;
+    };
+
     /** Sends the manually serialized AIRich command card shown in the screenshot. */
     socket.sendAIRichCommandMenu = async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('sendAIRichCommandMenu requires a target JID', { statusCode: 400 });
@@ -2433,6 +2454,36 @@ export const makeMessagesSocket = (config) => {
         }
         return fullMsg;
     };
+    /** Send a provider-neutral AIRich social/entity result card. */
+    socket.sendSocialEntity = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendSocialEntity requires a target JID', { statusCode: 400 });
+        const wrapped = prepareSocialEntityMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options,
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
+        return fullMsg;
+    };
+
+    /** Send the primary Instagram profile result using the universal social/entity API. */
+    socket.sendInstagramProfile = async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendInstagramProfile requires a target JID', { statusCode: 400 });
+        const wrapped = prepareInstagramProfileMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options,
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
+        return fullMsg;
+    };
+
     /** Sends a rich response with experimental BotInfrastructureDiagnostics metadata. */
     socket.sendBotDiagnostics = async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('sendBotDiagnostics requires a target JID', { statusCode: 400 });
@@ -2792,11 +2843,7 @@ export const makeMessagesSocket = (config) => {
             messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
             ...options
         });
-        await relayMessage(jid, fullMsg.message, {
-            messageId: fullMsg.key.id,
-            useCachedGroupMetadata: options.useCachedGroupMetadata,
-            statusJidList: options.statusJidList
-        });
+        await relayRichMessage(jid, fullMsg, { ...options, forceRichEdit: true });
         return fullMsg;
     };
 

package/lib/Utils/messages.js

@@ -1592,7 +1592,16 @@ export const generateWAMessageContent = async (message, options) => {
         m = { lottieStickerMessage: { message: m } };
     }
     else if (hasOptionalProperty(message, 'viewOnce') && !!message.viewOnce) {
-        m = { viewOnceMessage: { message: m } };
+        // Text view-once clients expect the flag on the inner
+        // ExtendedTextMessage. Media continues to use the standard outer
+        // viewOnceMessage envelope.
+        if (m.extendedTextMessage) {
+            m.extendedTextMessage.viewOnce = true;
+        }
+        else {
+            m = { viewOnceMessage: { message: m } };
+        }
+        delete message.viewOnce;
     }
     // Lia@Changes 03-02-26 --- Add "viewOnceV2" boolean to wrap message into viewOnceMessageV2 like "viewOnce"
     else if (hasOptionalProperty(message, 'viewOnceV2') && !!message.viewOnceV2) {

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

@@ -376,6 +376,110 @@ const richMenuButton = (button, toast = '') => {
  * This is an experimental WhatsApp rich-response format, not a standard
  * buttonsMessage/nativeFlowMessage payload.
  */
+/**
+ * Build a universal AIRich social/entity result card.
+ * The wire format is provider-neutral; Instagram is exposed as a dedicated
+ * convenience wrapper below because it is the primary supported profile view.
+ */
+export const prepareSocialEntityMessage = ({
+    username = '',
+    platform = 'GENERIC',
+    title = 'CODY AI',
+    subtitle = '⚉',
+    imageUrl = '',
+    entityId,
+    entityUrl = '',
+    entityType,
+    fullName = 'NOT found',
+    isVerified = false,
+    resultText = 'See results',
+    botJid = '867051314767696@bot',
+    responseId
+} = {}) => {
+    const normalizedPlatform = String(platform || 'GENERIC').toUpperCase();
+    const profileUrl = entityUrl || (username ? `https://www.${normalizedPlatform.toLowerCase()}.com/${encodeURIComponent(username)}` : '');
+    const resolvedType = entityType || (normalizedPlatform === 'INSTAGRAM' ? 'IG_PROFILE' : 'SOCIAL_PROFILE');
+    const displayName = username || fullName || 'Profile';
+    const sections = [
+        {
+            view_model: {
+                primitives: [{
+                    title,
+                    subtitle,
+                    ...(imageUrl ? { image: { url: imageUrl, mime_type: 'image/png' } } : {}),
+                    entity_id: String(entityId ?? username ?? ''),
+                    entity_url: profileUrl,
+                    entity_type: 'WEBSITE',
+                    action_type: 'OPEN_URL',
+                    is_verified: !!isVerified,
+                    __typename: 'GenAICompactEntityPrimitive'
+                }],
+                __typename: 'GenAIActionRowLayoutViewModel'
+            }
+        },
+        {
+            view_model: {
+                primitives: [{ type: 'HORIZONTAL_LINE', __typename: 'GenAIDividerPrimitive' }],
+                __typename: 'GenAIVStackLayoutViewModel'
+            }
+        },
+        {
+            view_model: {
+                primitives: [
+                    { __typename: 'GenAISpacerPrimitive' },
+                    {
+                        text: `# {{social_entity_1}}${resultText}\0{{/social_entity_1}}    `,
+                        inline_entities: [{
+                            key: 'social_entity_1',
+                            metadata: {
+                                __typename: 'GenAISocialEntityItem',
+                                entity_id: String(entityId ?? username ?? ''),
+                                entity_name: displayName,
+                                entity_full_name: fullName,
+                                entity_picture_url: imageUrl,
+                                entity_url: profileUrl,
+                                entity_type: resolvedType,
+                                platform: normalizedPlatform,
+                                is_verified: !!isVerified
+                            }
+                        }],
+                        __typename: 'GenAIMarkdownTextUXPrimitive'
+                    },
+                    { __typename: 'GenAISpacerPrimitive' }
+                ],
+                __typename: 'GenAIActionRowLayoutViewModel'
+            }
+        }
+    ];
+    return {
+        botForwardedMessage: {
+            message: {
+                richResponseMessage: {
+                    messageType: 1,
+                    submessages: [],
+                    unifiedResponse: {
+                        response_id: responseId || randomUUID(),
+                        data: Buffer.from(JSON.stringify({ sections })).toString('base64')
+                    },
+                    contextInfo: {
+                        isForwarded: true,
+                        forwardOrigin: 4,
+                        forwardedAiBotMessageInfo: { botJid }
+                    }
+                }
+            }
+        }
+    };
+};
+
+/** Dedicated Instagram profile card using the universal social-entity wire format. */
+export const prepareInstagramProfileMessage = (content = {}) => prepareSocialEntityMessage({
+    ...content,
+    platform: 'INSTAGRAM',
+    entityType: 'IG_PROFILE',
+    entityUrl: content.entityUrl || (content.username ? `https://www.instagram.com/${encodeURIComponent(content.username)}` : undefined)
+});
+
 export const prepareRichMenuMessage = (content = {}) => {
     const { header = {}, body = {}, footer = {}, verificationMetadata } = content || {};
     const sections = [];
@@ -500,6 +604,29 @@ export const prepareAIRichCommandMenu = ({ image, title = 'CODY AI', subtitle =
     return wrapToBotForwardedMessage(richResponseMessage);
 };
 
+/**
+ * Build an arbitrary A2UI interactive message. The command-menu helper below
+ * is only a convenience preset; callers may provide any supported component,
+ * widget, or native-flow payload through this universal builder.
+ */
+export const prepareA2UIMessage = ({ imageMessage, bloksWidget = {}, nativeFlowMessage, fallback = '', ...interactiveFields } = {}) => ({
+    interactiveMessage: {
+        ...interactiveFields,
+        ...(imageMessage ? { header: { imageMessage, hasMediaAttachment: true } } : {}),
+        bloksWidget: {
+            type: bloksWidget.type || 'im_a2ui',
+            data: typeof bloksWidget.data === 'string' ? bloksWidget.data : JSON.stringify(bloksWidget.data || {}),
+            ...(bloksWidget.fallback || fallback ? { fallback: String(bloksWidget.fallback || fallback) } : {})
+        },
+        ...(nativeFlowMessage ? {
+            nativeFlowMessage: {
+                ...nativeFlowMessage,
+                ...(nativeFlowMessage.buttons ? { buttons: nativeFlowMessage.buttons } : {})
+            }
+        } : {})
+    }
+});
+
 /** Build the A2UI interactive command menu used by the full-size card layout. */
 export const prepareA2UICommandMenu = ({ imageMessage, title = 'CODY AI', rows = [], buttons = [], fallback = '' } = {}) => {
     if (!Array.isArray(rows)) throw new Error('A2UI command-menu rows must be an array');
@@ -798,10 +925,12 @@ export const prepareVerticalAlbumMessage = ({ items = [], verificationMetadata }
         const height = image?.height || item?.height || 400;
         const mimeType = image?.mimeType || image?.mime_type || 'image/png';
         return {
-            preview_image: { url: previewUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
-            full_image: { url: fullUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
-            dark_mode_preview_image: { url: image?.darkModePreviewUrl || previewUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
-            dark_mode_full_image: { url: image?.darkModeHighResUrl || image?.darkModePreviewUrl || fullUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            preview_image: { url: previewUrl, url_fallback: previewUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            full_image: { url: fullUrl, url_fallback: fullUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            dark_mode_preview_image: { url: image?.darkModePreviewUrl || previewUrl, url_fallback: image?.darkModePreviewUrl || previewUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            dark_mode_full_image: { url: image?.darkModeHighResUrl || image?.darkModePreviewUrl || fullUrl, url_fallback: image?.darkModeHighResUrl || image?.darkModePreviewUrl || fullUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            display_mode: 'FULL_WIDTH',
+            full_width: true,
             asset_query_status: 'FETCHED',
             __typename: 'GenAIImagePrimitive'
         };
@@ -809,7 +938,7 @@ export const prepareVerticalAlbumMessage = ({ items = [], verificationMetadata }
     const richResponseMessage = proto.AIRichResponseMessage.create({
         submessages: [],
         messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
-        unifiedResponse: { data: Buffer.from(JSON.stringify({ response_id: randomUUID(), sections: [{ view_model: { primitives, __typename: 'GenAIVStackLayoutViewModel' } }] })) },
+        unifiedResponse: { data: Buffer.from(JSON.stringify({ response_id: randomUUID(), sections: [{ view_model: { primitives, display_mode: 'FULL_WIDTH', full_width: true, __typename: 'GenAIVStackLayoutViewModel' } }] })) },
         contextInfo: { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' }, forwardOrigin: 4 }
     });
     return wrapToBotForwardedMessage(richResponseMessage, verificationMetadata);

package/lib/index.d.ts

@@ -247,6 +247,13 @@ export interface AnimatedWallpaperInput {
     opacity?: number;
 }
 
+export interface A2UIMessageContent {
+    image?: unknown;
+    bloksWidget?: { type?: string; data?: unknown; fallback?: string };
+    nativeFlowMessage?: { messageParamsJson?: string; buttons?: unknown[]; [key: string]: unknown };
+    [key: string]: unknown;
+}
+
 export interface A2UICommandMenuContent {
     image?: unknown;
     title?: string;
@@ -255,6 +262,22 @@ export interface A2UICommandMenuContent {
     fallback?: string;
 }
 
+export interface SocialEntityContent {
+    username?: string;
+    platform?: string;
+    title?: string;
+    subtitle?: string;
+    imageUrl?: string;
+    entityId?: string | number;
+    entityUrl?: string;
+    entityType?: string;
+    fullName?: string;
+    isVerified?: boolean;
+    resultText?: string;
+    botJid?: string;
+    responseId?: string;
+}
+
 export interface AIRichCommandMenuContent {
     image: string;
     title?: string;
@@ -301,6 +324,12 @@ export interface WASocket {
     relayMessage(jid: string, message: Record<string, unknown>, options?: RelayMessageOptions): Promise<unknown>;
     /** Send an experimental Meta AI-style rich menu with image, card buttons, and an optional URL footer. */
     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 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. */
+    sendA2UIMessage(jid: string, content?: A2UIMessageContent, options?: Record<string, unknown>): Promise<unknown>;
     /** Send the large A2UI card/menu with an image header, command table, URL buttons, and native-flow selector. */
     sendA2UICommandMenu(jid: string, content?: A2UICommandMenuContent, options?: Record<string, unknown>): Promise<unknown>;
     /** Send the manually serialized AIRich command card with image, Markdown, widget CTAs, and footer actions. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plogme",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "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",