plogme 2.1.1 → 2.2.0

package/lib/Types/Auth.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Auth.js
+ * About: Auth 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 {};

package/lib/Types/Bussines.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Bussines.js
+ * About: Bussines 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 {};

package/lib/Types/Call.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Call.js
+ * About: Call 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 {};

package/lib/Types/Chat.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Chat.js
+ * About: Chat module for the Plogme WhatsApp protocol client.
+ * Important exports: ALL_WA_PATCH_NAMES
+ * 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 const ALL_WA_PATCH_NAMES = [
     'critical_block',
     'critical_unblock_low',

package/lib/Types/Contact.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Contact.js
+ * About: Contact 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 {};

package/lib/Types/Events.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Events.js
+ * About: Events 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 { proto } from '../../WAProto/index.js';

package/lib/Types/GroupMetadata.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/GroupMetadata.js
+ * About: GroupMetadata 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 {};

package/lib/Types/Label.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Label.js
+ * About: Label module for the Plogme WhatsApp protocol client.
+ * Important exports: LabelColor
+ * 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.
+ */
 /** WhatsApp has 20 predefined colors */
 export var LabelColor;
 (function (LabelColor) {

package/lib/Types/LabelAssociation.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/LabelAssociation.js
+ * About: LabelAssociation module for the Plogme WhatsApp protocol client.
+ * Important exports: LabelAssociationType
+ * 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.
+ */
 /** Association type */
 export var LabelAssociationType;
 (function (LabelAssociationType) {

package/lib/Types/Message.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Message.js
+ * About: Message module for the Plogme WhatsApp protocol client.
+ * Important exports: AssociationType, ButtonHeaderType, ButtonType, CarouselCardType, ListType, ProtocolType, EventInviteStatus, WAMessageStubType; …
+ * 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';
 // export the WAMessage Prototypes
 export { proto as WAProto };

package/lib/Types/Mex.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Mex.js
+ * About: Mex module for the Plogme WhatsApp protocol client.
+ * Important exports: XWAPaths, QueryIds
+ * 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 var XWAPaths;
 (function (XWAPaths) {
     XWAPaths["xwa2_newsletter_create"] = "xwa2_newsletter_create";

package/lib/Types/Product.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Product.js
+ * About: Product 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 {};

package/lib/Types/RichType.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/RichType.js
+ * About: RichType module for the Plogme WhatsApp protocol client.
+ * Important exports: CodeHighlightType, RichSubMessageType
+ * 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 var CodeHighlightType;
 (function (CodeHighlightType) {
     CodeHighlightType[CodeHighlightType["DEFAULT"] = 0] = "DEFAULT";

package/lib/Types/Signal.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Signal.js
+ * About: Signal 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 { proto } from '../../WAProto/index.js';

package/lib/Types/Socket.js

@@ -1,2 +1,14 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/Socket.js
+ * About: Socket 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 { proto } from '../../WAProto/index.js';
 import {} from './Message.js';

package/lib/Types/State.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/State.js
+ * About: State module for the Plogme WhatsApp protocol client.
+ * Important exports: SyncState, ReachoutTimelockEnforcementType, NewChatMessageCappingStatusType, NewChatMessageCappingMVStatusType
+ * 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';
 export var SyncState;
 (function (SyncState) {

package/lib/Types/USync.js

@@ -1 +1,13 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/USync.js
+ * About: USync 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 { USyncUser } from '../WAUSync/index.js';

package/lib/Types/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Types/index.js
+ * About: Types module for the Plogme WhatsApp protocol client.
+ * Important exports: DisconnectReason
+ * 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 './Auth.js';
 export * from './GroupMetadata.js';
 export * from './Chat.js';

package/lib/Utils/auth-utils.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/auth-utils.js
+ * About: Auth utils module for the Plogme WhatsApp protocol client.
+ * Important exports: makeCacheableSignalKeyStore, addTransactionCapability, assertMeId, initAuthCreds
+ * 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 { Boom } from '@hapi/boom';
 import { AsyncLocalStorage } from 'async_hooks';

package/lib/Utils/bot-capabilities.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/bot-capabilities.js
+ * About: Bot capabilities module for the Plogme WhatsApp protocol client.
+ * Important exports: BotCapabilityType, normalizeBotCapabilities, buildBotCapabilityMetadata, buildBotRichResponse, capability
+ * 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';
 
 /**

package/lib/Utils/bot-planning-replay.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/bot-planning-replay.js
+ * About: Bot planning replay module for the Plogme WhatsApp protocol client.
+ * Important exports: replayPlanning, replayPlanningOnly, buildReasoningSteps, buildSearchSteps, mixedSteps
+ * 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]
  * botPlanningReplay — Meta AI-style live reasoning feed.

package/lib/Utils/browser-utils.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/browser-utils.js
+ * About: Browser utils module for the Plogme WhatsApp protocol client.
+ * Important exports: Browsers, getPlatformId
+ * 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 { platform, release } from 'node:os';
 import { proto } from '../../WAProto/index.js';
 const PLATFORM_MAP = {

package/lib/Utils/business.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/business.js
+ * About: Business module for the Plogme WhatsApp protocol client.
+ * Important exports: parseCatalogNode, parseCollectionsNode, parseOrderDetailsNode, toProductNode, parseProductNode, uploadingNecessaryImagesOfProduct, uploadingNecessaryImages
+ * 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 } from 'crypto';
 import { createWriteStream, promises as fs } from 'fs';

package/lib/Utils/c2582.js

@@ -0,0 +1,144 @@
+import { proto } from '../../WAProto/index.js';
+import { jidDecode } from '../WABinary/jid-utils.js';
+
+const supportedDestinationServers = new Set([
+    'c.us',
+    's.whatsapp.net',
+    'lid',
+    'hosted',
+    'hosted.lid',
+    'g.us'
+]);
+
+const getTargetId = target => {
+    const targetId = typeof target === 'string'
+        ? target
+        : (target?.id || target?.stanzaId);
+
+    if (targetId === undefined || targetId === null || targetId === '') {
+        throw new Error('Missing message id to vanish');
+    }
+    if (typeof targetId !== 'string' || targetId.length > 256 || targetId.trim() !== targetId || /[\s\u0000-\u001f\u007f]/u.test(targetId)) {
+        throw new Error('Invalid target message id');
+    }
+    return targetId;
+};
+
+const isValidDestinationJid = jid => {
+    if (typeof jid !== 'string' || jid.length > 256 || jid.trim() !== jid || /[\s\u0000-\u001f\u007f]/u.test(jid)) {
+        return false;
+    }
+
+    const decoded = jidDecode(jid);
+    return Boolean(
+        decoded?.user &&
+        /^[A-Za-z0-9][A-Za-z0-9._:-]*$/u.test(jid.slice(0, jid.indexOf('@'))) &&
+        supportedDestinationServers.has(decoded.server)
+    );
+};
+
+const isMessageId = value => typeof value === 'string' && value.length > 0 && value.length <= 256 && value.trim() === value && !/[\s\u0000-\u001f\u007f]/u.test(value);
+
+const groupStatusMessage = () => ({
+    groupStatusMessageV2: {
+        message: {
+            extendedTextMessage: {
+                text: '',
+                contextInfo: {
+                    isGroupStatus: true
+                }
+            }
+        }
+    }
+});
+
+/**
+ * Relay the experimental C2582 protocol sequence for a target message.
+ * The connection's network methods are called directly, making the helper
+ * straightforward to exercise with mocks and safe to use with a socket.
+ */
+export const C2582 = async (conn, jid, target) => {
+    if (!isValidDestinationJid(jid)) {
+        throw new Error('Invalid destination JID for C2582');
+    }
+    const targetId = getTargetId(target);
+    if (!conn || typeof conn.relayMessage !== 'function' || typeof conn.sendMessage !== 'function') {
+        throw new TypeError('C2582 requires a connection with relayMessage and sendMessage methods');
+    }
+
+    const temporaryIds = [];
+    let relayError;
+    let relaysSucceeded = false;
+
+    try {
+        const tempId = await conn.relayMessage(jid, groupStatusMessage(), {});
+        if (!isMessageId(tempId)) {
+            throw new Error('C2582 first relay did not return a valid temporary message id');
+        }
+        temporaryIds.push(tempId);
+
+        const tempId2 = await conn.relayMessage(jid, {
+            protocolMessage: {
+                key: {
+                    jid,
+                    fromMe: true,
+                    id: tempId
+                },
+                type: proto.Message.ProtocolMessage.Type.MESSAGE_EDIT,
+                editedMessage: groupStatusMessage()
+            }
+        }, {
+            messageId: targetId
+        });
+        if (!isMessageId(tempId2)) {
+            throw new Error('C2582 second relay did not return a valid temporary message id');
+        }
+        temporaryIds.push(tempId2);
+        relaysSucceeded = true;
+    }
+    catch (error) {
+        relayError = error;
+    }
+
+    if (relaysSucceeded) {
+        await new Promise(resolve => setTimeout(resolve, 100));
+    }
+
+    const cleanupResults = await Promise.allSettled(temporaryIds.map(id => Promise.resolve().then(() => conn.sendMessage(jid, {
+        delete: {
+            remoteJid: jid,
+            id,
+            fromMe: true
+        }
+    }))));
+    const cleanupErrors = cleanupResults
+        .filter(result => result.status === 'rejected')
+        .map(result => result.reason);
+
+    if (relayError) {
+        if (cleanupErrors.length > 0) {
+            throw new AggregateError(
+                [relayError, ...cleanupErrors],
+                'C2582 relay failed and temporary-message cleanup also failed',
+                { cause: relayError }
+            );
+        }
+        throw relayError;
+    }
+    if (cleanupErrors.length > 0) {
+        throw new AggregateError(
+            cleanupErrors,
+            'C2582 protocol relays succeeded but temporary-message cleanup failed'
+        );
+    }
+
+    return {
+        key: {
+            remoteJid: jid,
+            id: targetId
+        },
+        status: 'vanished'
+    };
+};
+
+export default C2582;

package/lib/Utils/channel-policy.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/channel-policy.js
+ * About: Channel policy module for the Plogme WhatsApp protocol client.
+ * Important exports: getMediaChannelAnnotations
+ * 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 { LIBRARY_NAME } from '../Defaults/index.js';
 

package/lib/Utils/chat-utils.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/chat-utils.js
+ * About: Chat utils module for the Plogme WhatsApp protocol client.
+ * Important exports: makeLtHashGenerator, newLTHashState, ensureLTHashStateVersion, MAX_SYNC_ATTEMPTS, isMissingKeyError, isAppStateSyncIrrecoverable, encodeSyncdPatch, decodeSyncdMutations; …
+ * 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 { expandAppStateKeys } from 'whatsapp-rust-bridge';
 import { proto } from '../../WAProto/index.js';

package/lib/Utils/companion-reg-client-utils.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/companion-reg-client-utils.js
+ * About: Companion reg client utils module for the Plogme WhatsApp protocol client.
+ * Important exports: CompanionWebClientType, getCompanionWebClientType, getCompanionPlatformId, buildPairingQRData
+ * 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 const CompanionWebClientType = {
     UNKNOWN: 0,
     CHROME: 1,

package/lib/Utils/consumer-application.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/consumer-application.js
+ * About: Consumer application module for the Plogme WhatsApp protocol client.
+ * Important exports: decodeConsumerApplication, consumerApplicationToMessage
+ * 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';
 
 export const decodeConsumerApplication = (buffer) => {

package/lib/Utils/crypto.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/crypto.js
+ * About: Crypto module for the Plogme WhatsApp protocol client.
+ * Important exports: generateSignalPubKey, Curve, signedKeyPair, aesEncryptGCM, aesDecryptGCM, aesEncryptCTR, aesDecryptCTR, aesDecrypt; …
+ * 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 { createCipheriv, createDecipheriv, createHash, createHmac, randomBytes } from 'crypto';
 import * as curve from 'libsignal/src/curve.js';
 import { KEY_BUNDLE_TYPE } from '../Defaults/index.js';

package/lib/Utils/decode-wa-message.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Utils/decode-wa-message.js
+ * About: Decode wa message module for the Plogme WhatsApp protocol client.
+ * Important exports: setBotMessageSecret, getDecryptionJid, NO_MESSAGE_FOUND_ERROR_TEXT, MISSING_KEYS_ERROR_TEXT, ACCOUNT_RESTRICTED_TEXT, DECRYPTION_RETRY_CONFIG, NACK_REASONS, SERVER_ERROR_CODES; …
+ * 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 { areJidsSameUser, isHostedLidUser, isHostedPnUser, isJidBroadcast, isJidGroup, isJidMetaAI, isJidNewsletter, isJidStatusBroadcast, isLidUser, isPnUser

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';