plogme 2.1.1 → 2.1.2

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';
@@ -93,7 +105,7 @@ export const prepareWAMessageMedia = async (message, options) => {
         uploadData.mimetype = MIMETYPE_MAP[mediaType];
     }
     if (mediaType === 'sticker') {
-        // @neoxr/wb names the native AI-sticker marker `meta`. WhatsApp's
+        // 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;
@@ -1432,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 || []
                         }),
@@ -1471,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 };
@@ -1945,6 +1957,67 @@ export const generateWAMessageFromImagePoll = async (jid, content, relay, 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.

package/lib/Utils/native-flow.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/native-flow.js
+ * About: Native flow module for the Plogme WhatsApp protocol client.
+ * Important exports: parseNativeFlowResponse, parseWhatsAppFlowResponse, buildWhatsAppFlowButton, makeWhatsAppFlowButton
+ * 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.
+ */
 const parseJsonObject = (value) => {
     if (!value) {
         return {};

package/lib/Utils/noise-handler.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/noise-handler.js
+ * About: Noise handler module for the Plogme WhatsApp protocol client.
+ * Important exports: makeNoiseHandler
+ * 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 { proto } from '../../WAProto/index.js';
 import { NOISE_MODE, WA_CERT_DETAILS } from '../Defaults/index.js';

package/lib/Utils/offline-node-processor.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/offline-node-processor.js
+ * About: Offline node processor module for the Plogme WhatsApp protocol client.
+ * Important exports: makeOfflineNodeProcessor
+ * 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.
+ */
 /**
  * Creates a processor for offline stanza nodes that:
  * - Queues nodes for sequential processing

package/lib/Utils/pre-key-manager.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/pre-key-manager.js
+ * About: Pre key manager module for the Plogme WhatsApp protocol client.
+ * Important exports: PreKeyManager
+ * 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 PQueue from 'p-queue';
 /**
  * Manages pre-key operations with proper concurrency control

package/lib/Utils/process-message.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/process-message.js
+ * About: Process message module for the Plogme WhatsApp protocol client.
+ * Important exports: cleanMessage, isRealMessage, shouldIncrementChatUnread, getChatId, decryptPollVote, decryptEventResponse
+ * 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 { WAMessageStubType } from '../Types/index.js';
 import { getContentType, normalizeMessageContent } from '../Utils/messages.js';

package/lib/Utils/reporting-utils.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/reporting-utils.js
+ * About: Reporting utils module for the Plogme WhatsApp protocol client.
+ * Important exports: shouldIncludeReportingToken, getMessageReportingToken
+ * 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 { createHmac } from 'crypto';
 import { proto } from '../../WAProto/index.js';
 import { hkdf } from './crypto.js';