plogme 2.1.1 → 2.1.2

package/README.md

@@ -444,6 +444,28 @@ await sock.sendMessage(jid, {
 
 Remote URLs, local file paths, and buffers are supported where the selected media helper accepts them.
 
+For reel and rich-image cards, Plogme keeps its native AIRich representation and can additionally emit the field shape used by `New compatibility`:
+
+```js
+await sock.sendNewRichMedia(jid, {
+  reels: [{
+    creator: 'Creator Name',
+    avatar: 'https://example.com/avatar.jpg',
+    verified: true,
+    thumbnail: 'https://example.com/reel.jpg',
+    url: 'https://example.com/reel.mp4',
+    source: 'IG'
+  }],
+  images: [{
+    url: 'https://example.com/post.jpg',
+    thumbnail: 'https://example.com/post-thumb.jpg',
+    post_type: 'IMAGE'
+  }]
+})
+```
+
+This compatibility path is additive; `sendRichMedia()` and the native Plogme serializers remain available unchanged.
+
 > [!WARNING]
 > A URL must point to a real, playable media file. A URL returning an HTML error page, an empty file, or an invalid video container can produce a WhatsApp media verification or download warning even when the library code is correct.
 
@@ -747,6 +769,81 @@ await sock.sendMessage(jid, {
 })
 ```
 
+### Convenience message helpers
+
+`replyButton()` wraps the existing legacy button builder. Buttons accept `id` or
+`command` actions, as well as URL, call, copy, and native-flow definitions. A
+single image, video, document, or location can be used as the header.
+
+```js
+await sock.replyButton(jid, [
+  { text: 'Open menu', command: '#menu' },
+  { text: 'Visit docs', url: 'https://example.com/docs' }
+], quotedMessage, {
+  text: 'Choose an action',
+  footer: 'Plogme'
+})
+
+await sock.replyButton(jid, [
+  { text: 'I am coming', id: 'attend' }
+], quotedMessage, {
+  text: 'Meet here',
+  footer: 'Plogme',
+  location: {
+    name: 'Lagos',
+    address: 'Nigeria',
+    degreesLatitude: 6.5244,
+    degreesLongitude: 3.3792
+  }
+})
+```
+
+`sendProgress()` renders a text progress bar. Start a message, retain its key,
+then pass that key back to edit the same message as progress changes.
+
+```js
+const progress = await sock.sendProgress(jid, 'Uploading', quotedMessage, {
+  progress: 20
+})
+await sock.sendProgress(jid, 'Uploading', undefined, {
+  progress: 75,
+  messageKey: progress.key
+})
+```
+
+`sendMessageModify()` and its `sendMessageModifyV2()` alias create a text
+message with a custom external preview card. Thumbnails may be buffers, URLs,
+or local paths. `largeThumb` controls the larger preview and `ads` controls the
+ad-attribution marker.
+
+```js
+await sock.sendMessageModify(jid, 'Open the documentation', quotedMessage, {
+  title: 'Plogme docs',
+  description: 'API reference and examples',
+  url: 'https://example.com/docs',
+  thumbnail: 'https://example.com/docs-card.jpg',
+  largeThumb: true,
+  ads: false
+})
+```
+
+`sendFile()` accepts a path, URL, buffer, or `{ url }` media input. Set
+`photo_live: true` for a motion photo: Plogme sends a still image followed by
+the associated video child. Supply `thumbnail` or `image` for the still; if
+omitted, the video thumbnail is used. Motion-photo rendering depends on the
+recipient's WhatsApp client version.
+
+```js
+await sock.sendFile(
+  jid,
+  'https://example.com/clip.mp4',
+  'clip.mp4',
+  'A moment in motion',
+  quotedMessage,
+  { photo_live: true, thumbnail: 'https://example.com/still.jpg' }
+)
+```
+
 ### Interactive table
 
 ```js
@@ -1068,6 +1165,24 @@ console.log('Sent message:', result.key.id)
 
 `sendPlogmeMessage` accepts both HTML formats: `html` uses the same `FOAHtmlPrimitiveDemoDONOTUSE` primitive as `sendHtmlMessage`, while `richHtml` uses the tabbed `GenAIaeacdsnwHtmlPrimitive` format from `sendRichHtmlMessage`. They can be included together in one response. Alternatively, pass the tabbed config as `html: { title, url, tabs, trustedSources }`.
 It also composes the compatible standalone AIRich helpers in the same response: `copyButton`/`copyToClipboard`, `richText`, `quote`, `richImage`, `richLinks`, `richMap`/`map`, `dynamicMedia`/`richDynamicMedia`, `socialEntity`, `socialProfile`, `richMenu`, `airichCommandMenu`, `gridImages`, `verticalAlbum`, `videoGrid`, `richGeneration`, `richLabel`, `suggestedPrompt`, `botSources`, and `botPttTranscript`. Use `sections` or `richSections` for newly discovered unified-response primitives, or `unifiedResponse: { sections, embedded_screens }` when passing an already serialized section set. A2UI/native-flow payloads remain separate because they use an `interactiveMessage` envelope rather than AIRich's `unifiedResponse` envelope; use `sendA2UIMessage` for those.
+
+Tables can use either renderer: `table: [['Name', 'Value'], ...]` keeps the inline table, while `table: { title, headers, rows }` or `richTable: { title, headers, rows }` uses the preview-table submessage. To include both in one message, pass a mixed `tables` array; its order is preserved, with `headerText` and `footerText` bracketing the table content:
+
+```js
+await sock.sendPlogmeMessage(jid, {
+  headerText: 'Testing rich rendering',
+  footerText: 'CODY AI',
+  tables: [
+    {
+      title: 'CODY Rich Table Test',
+      headers: ['Feature', 'Result'],
+      rows: [['Instagram profile card', 'Rich edit works'], ['Table message', 'Testing']]
+    },
+    [['Service', 'State'], ['API', 'Online'], ['Worker', 'Online']]
+  ]
+}, undefined, { renderRichResponse: true })
+```
+
 Every field in the example is optional. A minimal response is valid as well:
 
 ```js

package/WAProto/WAProto.proto

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: WAProto/WAProto.proto
+ * About: WAProto module for the Plogme WhatsApp protocol client.
+ * Important exports: Protocol message and enum declarations.
+ * Directions: Generated schema source; update through the repository protobuf workflow.
+ *
+ * Copyright and attribution notice.
+ * Do not copy, reproduce, redistribute, modify, or create derivative works
+ * from this source without explicit written permission.
+ */
 syntax = "proto3";
 package proto;
 

package/WAProto/index.d.ts

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: WAProto/index.d.ts
+ * About: Index.d 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 * as $protobuf from "protobufjs";
 import Long = require("long");
 /** Namespace proto. */

package/WAProto/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: WAProto/index.js
+ * About: WAProto module for the Plogme WhatsApp protocol client.
+ * Important exports: proto
+ * 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.
+ */
 /*eslint-disable block-scoped-var, id-length, no-control-regex, no-magic-numbers, no-prototype-builtins, no-redeclare, no-shadow, no-var, sort-vars*/
 "use strict";
 

package/engine-requirements.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: engine-requirements.js
+ * About: Engine requirements 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 { readFileSync } from 'fs';
 
 const major = parseInt(

package/lib/Defaults/ban-checker.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Defaults/ban-checker.js
+ * About: Ban checker module for the Plogme WhatsApp protocol client.
+ * Important exports: MOBILE_ENDPOINT, MOBILE_PORT, WA_VERSION, WA_VERSION_HASH, MOBILE_TOKEN, MOBILE_REGISTRATION_ENDPOINT, MOBILE_USERAGENT, GRAPHQL_ENDPOINT; …
+ * 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 { createHash } from 'crypto';
 
 export const MOBILE_ENDPOINT =

package/lib/Defaults/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Defaults/index.js
+ * About: Defaults module for the Plogme WhatsApp protocol client.
+ * Important exports: UNAUTHORIZED_CODES, BIZ_BOT_SUPPORT_PAYLOAD, DEFAULT_ORIGIN, CALL_VIDEO_PREFIX, CALL_AUDIO_PREFIX, DEF_CALLBACK_PREFIX, DEF_TAG_PREFIX, DONATE_URL; …
+ * 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 { makeLibSignalRepository } from '../Signal/libsignal.js';
 import { Browsers } from '../Utils/browser-utils.js';

package/lib/Signal/Group/ciphertext-message.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/ciphertext-message.js
+ * About: Ciphertext message module for the Plogme WhatsApp protocol client.
+ * Important exports: CiphertextMessage
+ * 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 class CiphertextMessage {
     constructor() {
         this.UNSUPPORTED_VERSION = 1;

package/lib/Signal/Group/group-session-builder.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/group-session-builder.js
+ * About: Group session builder module for the Plogme WhatsApp protocol client.
+ * Important exports: GroupSessionBuilder
+ * 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 * as keyhelper from './keyhelper.js';
 import { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
 import { SenderKeyName } from './sender-key-name.js';

package/lib/Signal/Group/group_cipher.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/group_cipher.js
+ * About: Group cipher module for the Plogme WhatsApp protocol client.
+ * Important exports: GroupCipher
+ * 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 { decrypt, encrypt } from 'libsignal/src/crypto.js';
 import { SenderKeyMessage } from './sender-key-message.js';
 import { SenderKeyName } from './sender-key-name.js';

package/lib/Signal/Group/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/index.js
+ * About: Group module for the Plogme WhatsApp protocol client.
+ * Important exports: GroupSessionBuilder, SenderKeyDistributionMessage, SenderKeyRecord, SenderKeyName, GroupCipher, SenderKeyState, SenderKeyMessage, SenderMessageKey; …
+ * 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 { GroupSessionBuilder } from './group-session-builder.js';
 export { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
 export { SenderKeyRecord } from './sender-key-record.js';

package/lib/Signal/Group/keyhelper.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/keyhelper.js
+ * About: Keyhelper module for the Plogme WhatsApp protocol client.
+ * Important exports: generateSenderKey, generateSenderKeyId, generateSenderSigningKey
+ * 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 * as nodeCrypto from 'crypto';
 import { generateKeyPair } from 'libsignal/src/curve.js';
 export function generateSenderKey() {

package/lib/Signal/Group/sender-chain-key.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/sender-chain-key.js
+ * About: Sender chain key module for the Plogme WhatsApp protocol client.
+ * Important exports: SenderChainKey
+ * 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 { calculateMAC } from 'libsignal/src/crypto.js';
 import { SenderMessageKey } from './sender-message-key.js';
 export class SenderChainKey {

package/lib/Signal/Group/sender-key-distribution-message.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/sender-key-distribution-message.js
+ * About: Sender key distribution message module for the Plogme WhatsApp protocol client.
+ * Important exports: SenderKeyDistributionMessage
+ * 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 { CiphertextMessage } from './ciphertext-message.js';
 export class SenderKeyDistributionMessage extends CiphertextMessage {

package/lib/Signal/Group/sender-key-message.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/sender-key-message.js
+ * About: Sender key message module for the Plogme WhatsApp protocol client.
+ * Important exports: SenderKeyMessage
+ * 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 { calculateSignature, verifySignature } from 'libsignal/src/curve.js';
 import { proto } from '../../../WAProto/index.js';
 import { CiphertextMessage } from './ciphertext-message.js';

package/lib/Signal/Group/sender-key-name.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/sender-key-name.js
+ * About: Sender key name module for the Plogme WhatsApp protocol client.
+ * Important exports: SenderKeyName
+ * 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.
+ */
 function isNull(str) {
     return str === null || str === '';
 }

package/lib/Signal/Group/sender-key-record.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/sender-key-record.js
+ * About: Sender key record module for the Plogme WhatsApp protocol client.
+ * Important exports: SenderKeyRecord
+ * 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 { BufferJSON } from '../../Utils/generics.js';
 import { SenderKeyState } from './sender-key-state.js';
 export class SenderKeyRecord {

package/lib/Signal/Group/sender-key-state.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/sender-key-state.js
+ * About: Sender key state module for the Plogme WhatsApp protocol client.
+ * Important exports: SenderKeyState
+ * 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 { SenderChainKey } from './sender-chain-key.js';
 import { SenderMessageKey } from './sender-message-key.js';
 export class SenderKeyState {

package/lib/Signal/Group/sender-message-key.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/Group/sender-message-key.js
+ * About: Sender message key module for the Plogme WhatsApp protocol client.
+ * Important exports: SenderMessageKey
+ * 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 { deriveSecrets } from 'libsignal/src/crypto.js';
 export class SenderMessageKey {
     constructor(iteration, seed) {

package/lib/Signal/libsignal.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/libsignal.js
+ * About: Libsignal module for the Plogme WhatsApp protocol client.
+ * Important exports: makeLibSignalRepository
+ * 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.
+ */
 // @ts-ignore
 import * as libsignal from 'libsignal';
 // @ts-ignore

package/lib/Signal/lid-mapping.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Signal/lid-mapping.js
+ * About: Lid mapping module for the Plogme WhatsApp protocol client.
+ * Important exports: LIDMappingStore
+ * 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';
 import { isHostedLidUser, isHostedPnUser, isLidUser, isPnUser, jidDecode, jidNormalizedUser, WAJIDDomains } from '../WABinary/index.js';
 export class LIDMappingStore {

package/lib/Socket/Client/index.js

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

package/lib/Socket/Client/types.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/Client/types.js
+ * About: Types module for the Plogme WhatsApp protocol client.
+ * Important exports: AbstractSocketClient
+ * 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 { URL } from 'url';
 export class AbstractSocketClient extends EventEmitter {

package/lib/Socket/Client/websocket.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/Client/websocket.js
+ * About: Websocket module for the Plogme WhatsApp protocol client.
+ * Important exports: WebSocketClient
+ * 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 WebSocket from 'ws';
 import { DEFAULT_ORIGIN } from '../../Defaults/index.js';
 import { AbstractSocketClient } from './types.js';

package/lib/Socket/aigroups.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/aigroups.js
+ * About: Aigroups module for the Plogme WhatsApp protocol client.
+ * Important exports: META_AI_BOT_JID, isMetaAIBotResponse, collectMetaAIBotParticipantJids, makeAIGroupsSocket, extractAIGroupMetadata
+ * 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 { WAMessageAddressingMode } from '../Types/index.js';
 import { generateMessageIDV2, normalizeMessageContent } from '../Utils/index.js';
 import { getBinaryNodeChild, getBinaryNodeChildren, getBinaryNodeChildString, isJidGroup, isJidMetaAI, isLidUser, isPnUser, jidEncode, jidNormalizedUser } from '../WABinary/index.js';

package/lib/Socket/ban-checker.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/ban-checker.js
+ * About: Ban checker module for the Plogme WhatsApp protocol client.
+ * Important exports: checkStatusWA, getBanDetails, normalizePhone
+ * 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 { randomBytes, randomUUID } from 'crypto';
 import { initAuthCreds } from '../Utils/auth-utils.js';
 import { Curve, md5, signedKeyPair } from '../Utils/crypto.js';

package/lib/Socket/business.js

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

package/lib/Socket/chats.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/chats.js
+ * About: Chats module for the Plogme WhatsApp protocol client.
+ * Important exports: makeChatsSocket
+ * 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 { proto } from '../../WAProto/index.js';

package/lib/Socket/communities.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/communities.js
+ * About: Communities module for the Plogme WhatsApp protocol client.
+ * Important exports: makeCommunitiesSocket, extractCommunityMetadata
+ * 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 { generateMessageID, generateMessageIDV2, unixTimestampSeconds } from '../Utils/index.js';

package/lib/Socket/graphql.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/graphql.js
+ * About: Graphql module for the Plogme WhatsApp protocol client.
+ * Important exports: executeWWWGraphQL, executeFacebookGraphQL, executeWamoGraphQL, makeGraphQLSocket
+ * 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';
 
 // Endpoints confirmed from APX.java and WamoGraphQLExecutor.java

package/lib/Socket/groups.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/groups.js
+ * About: Groups module for the Plogme WhatsApp protocol client.
+ * Important exports: buildReportNode, buildGroupStatusRevokeMessage, makeGroupsSocket, extractGroupMetadata
+ * 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 { WAMessageAddressingMode, WAMessageStubType } from '../Types/index.js';

package/lib/Socket/index.js

@@ -1,3 +1,15 @@
+/**
+ * @crysnpvax
+ *
+ * File: lib/Socket/index.js
+ * About: Socket module for the Plogme WhatsApp protocol client.
+ * Important exports: checkStatusWA
+ * 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 { DEFAULT_CONNECTION_CONFIG } from '../Defaults/index.js';
 import { makeCommunitiesSocket } from './communities.js';
 import { makeInteropSocket } from './interop.js';