plogme 2.1.0 → 2.1.2

package/README.md

@@ -326,8 +326,24 @@ await sock.sendMessage(jid, {
     canAddOption: false
   }
 })
+
+// Photo polls: each image is uploaded and sent as a MEDIA_POLL-associated child.
+// Values without an image can be mixed in with image options.
+await sock.sendMessage(channelJid, {
+  poll: {
+    name: 'Choose a cover',
+    values: [
+      { name: 'Purple', image: { url: './purple-cover.jpg' } },
+      { name: 'Blue', image: { url: './blue-cover.jpg' } },
+      'Other'
+    ],
+    selectableCount: 1
+  }
+})
 ```
 
+Photo polls use WhatsApp's experimental image-poll format: a V3 poll with `pollContentType: IMAGE`, option hashes, and separately associated `pollCreationOptionImageMessage` children. Forwarding a received poll with a generic one-message forward does not automatically collect and resend those associated image children.
+
 ### Latest WAProto additions
 
 The WAProto generation is updated to WhatsApp Web revision
@@ -417,10 +433,39 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   sticker: { url: './sticker.webp' }
 })
+
+// AI and avatar-style protected sticker markers
+await sock.sendMessage(jid, {
+  sticker: { url: './sticker.webp' },
+  meta: true, // native StickerMessage.isAiSticker
+  lock: true  // native avatar-style marker; WhatsApp has no literal lock field
+})
 ```
 
 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.
 
@@ -724,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
@@ -1003,6 +1123,20 @@ const result = await sock.sendPlogmeMessage(jid, {
     verified: true
   }],
 
+  // Optional raw HTML section, composed into this same unified response.
+  html: '<section><h2>Deployment</h2><p>Ready</p></section>',
+  trustedSources: ['crysnovax.com'],
+
+  // Optional tabbed HTML screen, using the same format as sendRichHtmlMessage.
+  richHtml: {
+    title: 'Service dashboard',
+    url: 'https://crysnovax.com/dashboard',
+    tabs: [
+      { tab_header: 'Overview', html: '<h1>Overview</h1>' },
+      { tab_header: 'Logs', html: '<h1>Logs</h1>' }
+    ]
+  },
+
   // Optional source cards: [favicon URL, source URL, display text].
   sources: [[
     'https://example.com/favicon.jpg',
@@ -1029,6 +1163,26 @@ const result = await sock.sendPlogmeMessage(jid, {
 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
@@ -2155,7 +2309,12 @@ await sock.sendMessage(groupJid, {
   mentions: ['628123456789@s.whatsapp.net'],
   groupStatus: true
 })
-
+// Compatibility test for the older groupStatusMessage envelope.
+await sock.sendMessage(groupJid, {
+  text: 'Legacy group-status test',
+  groupStatus: true,
+  groupStatusVersion: 'legacy'
+})
 // Delete using the key returned by the original group-status send.
 // The group JID must match key.remoteJid when that field is present.
 await sock.deleteGroupStatus(groupJid, groupStatus.key)
@@ -2296,8 +2455,73 @@ await sock.sendMessage('status@broadcast', {
 
 Named, hex, and ARGB colors are accepted. Viewer JIDs are normalized and deduplicated.
 
-### Status Mentions
+### Named custom audiences
+
+A normal status can be restricted to a named status audience. This is different from a group status: it is still sent through `status@broadcast`, while the audience is configured through status privacy lists. The list name and emoji are rendered by the WhatsApp client when supported.
+
+```javascript
+const audienceMembers = [
+  '15551234567@s.whatsapp.net',
+  '15557654321@s.whatsapp.net'
+]
+
+await sock.setStatusPrivacy('whitelist', audienceMembers, [
+  {
+    id: 'cody-test-audience',
+    listname: 'Cody AI Testers',
+    emoji: '🧸',
+    selected: true,
+    members: audienceMembers
+  }
+])
 
+await sock.sendStatus(
+  { text: 'Only the selected custom audience can see this status.' },
+  { statusJidList: audienceMembers }
+)
+
+console.log(await sock.getStatusPrivacy())
+```
+
+Supported status privacy distribution types are `contacts`, `whitelist`, `blacklist`, and `null`. Named lists use the `customlist` status-privacy entry. A custom list does not turn the status into a group status, and the group JID itself must not be used as a status viewer; expand a group to its participant JIDs first.
+
+### Group status versus custom-audience status
+
+These are separate WhatsApp features:
+
+| Feature | Destination | Content flag/envelope | Result |
+| --- | --- | --- | --- |
+| Normal status | `status@broadcast` | `status: true` or `sendStatus()` | Personal status with selected viewers or privacy audience |
+| Custom-audience status | `status@broadcast` | Normal status plus status privacy/custom-list configuration | Native “custom audience” experience where supported by the client |
+| Group status | A group JID | `groupStatus: true` | Status attached to the group with “Added by …” and “Reply to group” UI |
+| Status mention | Array of user/group JIDs | `sendStatusMention()` or array destination | Status plus mention notification |
+
+Plogme's default group-status wire envelope is `groupStatusMessageV2`. For compatibility testing, the older envelope can be selected explicitly with `groupStatusVersion: 'legacy'` (or `'v1'`). This selector applies only to group status and does not configure a custom audience.
+
+For example, this tests the older group-status envelope in the supplied group without adding Cody or changing group membership:
+
+```javascript
+const testGroupJid = '120363406852054490@g.us'
+
+await sock.sendMessage(testGroupJid, {
+  text: 'Legacy group-status test',
+  groupStatus: true,
+  groupStatusVersion: 'legacy'
+})
+```
+
+The default V2 test is:
+
+```javascript
+await sock.sendMessage(testGroupJid, {
+  text: 'V2 group-status test',
+  groupStatus: true
+})
+```
+
+`groupStatusMessage` and `groupStatusMessageV2` are the two group-status protocol wrappers. They are not the same as `statusMentionMessage`, `groupStatusMentionMessage`, or the normal status/custom-audience path. `aiGroupAddBot()` is unrelated to all of these status APIs and is not required to send either group-status variant.
+
+### Status Mentions
 Passing an array as the destination posts a status and sends mention notifications to those contacts or groups. This is intentionally separate from `statusJidList`, which controls viewers without mentioning them.
 
 ```javascript

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