@realvare/based 2.7.62 → 2.7.71

package/README.MD

@@ -53,12 +53,59 @@
     - [Text with Formatting](#text-with-formatting)
     - [Basic Media](#basic-media)
     - [Advanced Media](#advanced-media)
+    - [Stickers](#stickers)
+      - [Sticker Packs](#sticker-packs)
+      - [Stickers on Status (2025 Feature)](#stickers-on-status-2025-feature)
     - [Interactive Messages](#interactive-messages)
       - [Messages with Simple Buttons](#messages-with-simple-buttons)
       - [Messages with Buttons and Image](#messages-with-buttons-and-image)
       - [List Messages](#list-messages)
+      - [Collection Messages (Catalog)](#collection-messages-catalog)
+      - [Invoice Messages](#invoice-messages)
+      - [Carousel Messages with Card Types](#carousel-messages-with-card-types)
+      - [Interactive Messages with Audio Footer](#interactive-messages-with-audio-footer)
+      - [Interactive Messages with Product Header](#interactive-messages-with-product-header)
+      - [Interactive Response Messages](#interactive-response-messages)
+      - [Poll Messages](#poll-messages)
+      - [Poll Result Snapshot](#poll-result-snapshot)
+      - [Poll Update](#poll-update)
+      - [Comment Messages](#comment-messages)
+      - [Question Messages](#question-messages)
+      - [Question Response Messages](#question-response-messages)
+      - [Status Question Answer Messages](#status-question-answer-messages)
+      - [Status Quoted Messages](#status-quoted-messages)
+      - [Status Sticker Interaction Messages](#status-sticker-interaction-messages)
+      - [AI Rich Response Messages](#ai-rich-response-messages)
+    - [New Interactive Features (2025)](#new-interactive-features-2025)
     - [Other Messages](#other-messages)
-  - [Response Management](#response-management)
+      - [Business Call Messages (BCall)](#business-call-messages-bcall)
+      - [Call Log Messages](#call-log-messages)
+      - [Event Response Messages](#event-response-messages)
+      - [Status Mention Messages](#status-mention-messages)
+      - [Group Status Messages](#group-status-messages)
+      - [Bot Task Messages](#bot-task-messages)
+      - [Limit Sharing Messages](#limit-sharing-messages)
+      - [Status Add Yours Messages](#status-add-yours-messages)
+      - [Bot Forwarded Messages](#bot-forwarded-messages)
+      - [Event Cover Image Messages](#event-cover-image-messages)
+      - [Poll Creation Message V4](#poll-creation-message-v4)
+      - [Poll Creation Message V5](#poll-creation-message-v5)
+      - [Poll Result Snapshot Message V3](#poll-result-snapshot-message-v3)
+      - [Encrypted Comment Messages](#encrypted-comment-messages)
+      - [Encrypted Event Response Messages](#encrypted-event-response-messages)
+      - [Message History Bundle](#message-history-bundle)
+      - [Message History Notice](#message-history-notice)
+      - [Newsletter Follower Invite](#newsletter-follower-invite)
+      - [Placeholder Messages](#placeholder-messages)
+      - [Secret Encrypted Messages](#secret-encrypted-messages)
+      - [Status Notification Messages](#status-notification-messages)
+      - [Sticker Sync RMR Messages](#sticker-sync-rmr-messages)
+      - [Send Payment](#send-payment)
+      - [Decline Payment Request](#decline-payment-request)
+      - [Cancel Payment Request](#cancel-payment-request)
+      - [Scheduled Call Creation](#scheduled-call-creation)
+      - [Scheduled Call Edit](#scheduled-call-edit)
+      - [Pin/Unpin Messages](#pinunpin-messages)
   - [🎭 Group Features](#-group-features)
     - [Basic Group Management](#basic-group-management)
     - [Participant Management](#participant-management)
@@ -73,6 +120,8 @@
   - [📊 Conditional Logging](#-conditional-logging)
   - [🔧 Performance Configuration](#-performance-configuration)
 - [🧩 Events: LID and JID always available (new)](#-events-lid-and-jid-always-available-new)
+  - [Gestione dei Messaggi (`messages.upsert`)](#gestione-dei-messaggi-messagesupsert)
+  - [Gestione dei Partecipanti di Gruppo (`group-participants.update`)](#gestione-dei-partecipanti-di-gruppo-group-participantsupdate)
 - [⚙️ Advanced Configuration](#️-advanced-configuration)
   - [🔧 Complete Options for makeWASocket](#-complete-options-for-makewasocket)
   - [🛡️ Security and Encryption](#️-security-and-encryption)
@@ -145,7 +194,7 @@ console.log(result.isValid, result.error);
 
 // Extract sender information from messages
 const sender = getSenderLid(message);
-console.log(sender.jid, sender.lid, sender.isValid);
+console.log(sender.jid, sender.lid, sender.user, sender.isValid, sender.timestamp, sender.error);
 
 // Convert LID to JID format
 const jid = toJid('1234567890@lid'); // Returns '1234567890@s.whatsapp.net'
@@ -157,6 +206,8 @@ const normalized = normalizeJid('1234567890@lid'); // Returns '1234567890@s.what
 const isValid = isValidJid('1234567890@s.whatsapp.net');
 ```
 
+**Events behavior**: all emitted events (e.g. `messages.upsert`, `messages.update`, `group-participants.update`) will expose standard JIDs (`@s.whatsapp.net`, `@g.us`, etc.) in `msg.key.remoteJid` and `msg.key.participant` whenever possible. When WhatsApp provides LIDs, the original values are preserved in `msg.key.remoteLid` and `msg.key.participantLid`.
+
 ### 📈 Key Benefits
 
 **Performance Improvements:**
@@ -214,7 +265,7 @@ const sock = makeWASocket({
 
 <p align="center">
   <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=18&duration=2500&pause=2500&color=8A2BE2&center=true&vCenter=true&width=600&lines=🚀+Powerful+and+Intuitive;🔧+Based+on+Baileys+with+Improvements" alt="Features">
-</div>
+</p>
 
 <br>
 
@@ -414,7 +465,7 @@ startBot().catch(console.error);
 The library now includes an advanced cache system with automatic memory management and configurable TTL:
 
 ```typescript
-import { CacheManager } from 'based/lib/Utils/cache-manager';
+import { CacheManager } from '@realvare/based';
 
 // Example of using the cache
 const cache = CacheManager;
@@ -621,49 +672,41 @@ await conn.sendMessage(jid, { sticker: buffer });
 
 ##### Sticker Packs
 
-While WhatsApp supports installable sticker packs, Baileys (and this fork) does not have a native feature to create or send a pack as a single multi-sticker message (`StickerPackMessage`). This is a requested feature in Baileys (see issues [#1548](https://github.com/WhiskeySockets/Baileys/issues/1548)), but not yet implemented.
-
-However, the library provides a way to send a sticker pack by sending a metadata message followed by the individual stickers. This simulates a sticker pack in the chat.
-
-Here is how you can send a sticker pack:
+Send a complete sticker pack message with multiple stickers. This allows you to send a collection of stickers as a single pack message.
 
 ```typescript
-import { Sticker } from 'wa-sticker-formatter';
-
-const sticker1 = new Sticker('path/to/image1.png', { pack: 'My Sticker Pack', author: 'Me' });
-const sticker2 = new Sticker('path/to/image2.png', { pack: 'My Sticker Pack', author: 'Me' });
-
-const stickerPack = {
+await conn.sendMessage(jid, {
+  stickerPack: {
     name: 'My Sticker Pack',
     publisher: 'My Bot',
     description: 'A cool sticker pack',
-    cover: 'path/to/cover.png', // or a buffer
+    cover: { url: './cover.png' }, // Cover image for the pack
+    stickerPackId: 'pack123', // Optional: auto-generated if not provided
+    origin: 2, // 0 = FIRST_PARTY, 1 = THIRD_PARTY, 2 = USER_CREATED
+    caption: 'Check out my stickers!',
     stickers: [
-        {
-            sticker: await sticker1.toBuffer(),
-            emojis: ['🎉', '🎊'],
-        },
-        {
-            sticker: await sticker2.toBuffer(),
-            emojis: ['😄', '😊'],
-        }
+      {
+        sticker: { url: './sticker1.webp' },
+        emojis: ['🎉', '🎊'],
+        isAnimated: false,
+        isLottie: false,
+        fileName: 'sticker1.webp',
+        accessibilityLabel: 'Celebration sticker',
+        mimetype: 'image/webp'
+      },
+      {
+        sticker: { url: './sticker2.webp' },
+        emojis: ['😄', '😊'],
+        isAnimated: true,
+        isLottie: false,
+        fileName: 'sticker2.webp'
+      }
     ]
-};
-
-await conn.sendMessage(jid, { stickerPack: stickerPack });
+  }
+});
 ```
 
-Alternatively, you can simulate a pack by sending multiple stickers in sequence with a small delay between them:
-
-```typescript
-// Simulate a pack by sending multiple stickers
-const stickers = ['sticker1.webp', 'sticker2.webp'];
-for (const url of stickers) {
-  await conn.sendMessage(jid, { sticker: { url } });
-  await new Promise(resolve => setTimeout(resolve, 500)); // Small delay
-}
-```
-To create actual sticker packs that users can install, you should use external tools like the official WhatsApp Sticker Maker app. You can then integrate the individual stickers into your bot.
+**Note**: For creating installable sticker packs that users can add to their WhatsApp, use the official WhatsApp Sticker Maker app. This method sends a pack as a message in the chat.
 
 ##### Stickers on Status (2025 Feature)
 
@@ -678,7 +721,7 @@ await conn.sendMessage('status@broadcast', {
 
 #### Interactive Messages
 
-These messages include interactive elements like buttons, lists, and polls.
+These messages include interactive elements like buttons, lists, polls, carousels, collections, and invoices.
 
 ##### Messages with Simple Buttons
 
@@ -692,7 +735,6 @@ await conn.sendMessage(jid, {
     { buttonId: 'cmd1', buttonText: { displayText: 'Option 1' }, type: 1 },
     { buttonId: 'cmd2', buttonText: { displayText: 'Option 2' }, type: 1 },
   ],
-  headerType: 1,
 });
 ```
 
@@ -733,6 +775,131 @@ await conn.sendMessage(jid, {
 });
 ```
 
+##### Collection Messages (Catalog)
+
+Send a collection/catalog message to browse products.
+
+```typescript
+await conn.sendMessage(jid, {
+  text: 'Browse our catalog!',
+  footer: 'Shop now',
+  title: 'Our Products',
+  collection: {
+    bizJid: 'business@s.whatsapp.net',
+    id: 'catalog123',
+    messageVersion: 1
+  }
+});
+```
+
+##### Invoice Messages
+
+Send an invoice with attachment (image or PDF).
+
+```typescript
+await conn.sendMessage(jid, {
+  invoice: {
+    note: 'Invoice for your order',
+    token: 'invoice_token_123',
+    attachmentType: 1, // 0 = IMAGE, 1 = PDF
+    attachment: { url: './invoice.pdf' } // or image
+  }
+});
+```
+
+##### Carousel Messages with Card Types
+
+Send a carousel of cards with different card types.
+
+```typescript
+await conn.sendMessage(jid, {
+  text: 'Check out these options!',
+  footer: 'Swipe to see more',
+  cards: [
+    {
+      title: 'Card 1',
+      body: 'Description 1',
+      footer: 'Footer 1',
+      image: { url: './image1.jpg' },
+      buttons: [
+        { name: 'quick_reply', buttonParamsJson: '{"display_text":"Button 1"}' }
+      ]
+    },
+    {
+      title: 'Card 2',
+      body: 'Description 2',
+      video: { url: './video.mp4' }
+    }
+  ],
+  carouselCardType: 1 // 1 = HSCROLL_CARDS (horizontal scroll), 2 = ALBUM_IMAGE
+});
+```
+
+**Compatibility note**: `interactiveButtons` and `cards` are sent as `interactiveMessage` and are automatically wrapped by the library in `viewOnceMessageV2` to improve rendering on WhatsApp clients.
+
+##### Interactive Messages with Audio Footer
+
+Send interactive messages with audio in the footer.
+
+```typescript
+await conn.sendMessage(jid, {
+  text: 'Listen to this message!',
+  title: 'Audio Message',
+  interactiveButtons: [
+    { name: 'action1', buttonParamsJson: '{"display_text":"Action"}' }
+  ],
+  footer: {
+    text: 'Footer text',
+    audio: { url: './audio.mp3' } // Audio attachment in footer
+  }
+});
+```
+
+##### Interactive Messages with Product Header
+
+Send interactive messages with a product in the header.
+
+```typescript
+await conn.sendMessage(jid, {
+  text: 'Check out this product!',
+  title: 'Featured Product',
+  interactiveButtons: [
+    { name: 'buy', buttonParamsJson: '{"display_text":"Buy Now"}' }
+  ],
+  headerProduct: {
+    productImage: { url: './product.jpg' },
+    productId: 'prod123',
+    title: 'Product Name',
+    description: 'Product Description',
+    currency: 'EUR',
+    priceAmount1000: 10000
+  }
+});
+```
+
+##### Interactive Response Messages
+
+Send responses to interactive messages (e.g., Native Flow responses).
+
+```typescript
+await conn.sendMessage(jid, {
+  interactiveResponse: {
+    body: {
+      text: 'Response text',
+      format: 0 // 0 = DEFAULT, 1 = EXTENSIONS_1
+    },
+    nativeFlowResponse: {
+      name: 'flow_name',
+      paramsJson: '{"key":"value"}',
+      version: 1
+    },
+    contextInfo: {
+      mentionedJid: [jid]
+    }
+  }
+});
+```
+
 ##### Poll Messages
 
 Create a poll for users to vote on.
@@ -747,79 +914,587 @@ await conn.sendMessage(jid, {
 });
 ```
 
-#### New Interactive Features (2025)
+##### Poll Result Snapshot
+
+Send a snapshot of poll results.
+
+```typescript
+await conn.sendMessage(jid, {
+  pollResultSnapshot: {
+    name: 'Favorite Anime?',
+    pollVotes: [
+      { optionName: 'Aot', optionVoteCount: 10 },
+      { optionName: 'Bleach', optionVoteCount: 5 },
+      { optionName: 'Death note', optionVoteCount: 3 }
+    ],
+    pollType: 0, // 0 = POLL, 1 = QUIZ
+    contextInfo: {
+      mentionedJid: [jid]
+    }
+  }
+});
+```
+
+##### Poll Update
+
+Send a poll vote update.
+
+```typescript
+await conn.sendMessage(jid, {
+  pollUpdate: {
+    pollCreationMessageKey: {
+      remoteJid: jid,
+      fromMe: false,
+      id: 'pollMessageId123'
+    },
+    vote: {
+      encPayload: Buffer.from('encrypted_vote_payload'),
+      encIv: Buffer.from('encryption_iv')
+    },
+    senderTimestampMs: Date.now()
+  }
+});
+```
+
+##### Comment Messages
+
+Comment on a specific message in a chat.
+
+```typescript
+await conn.sendMessage(jid, {
+  comment: {
+    message: { text: 'This is a comment!' },
+    targetMessageKey: {
+      remoteJid: jid,
+      fromMe: false,
+      id: 'messageId123'
+    }
+  }
+});
+```
+
+##### Question Messages
+
+Create a question message that users can respond to.
+
+```typescript
+await conn.sendMessage(jid, {
+  question: {
+    text: 'What is your favorite programming language?',
+    contextInfo: {
+      mentionedJid: [jid]
+    }
+  }
+});
+```
+
+##### Question Response Messages
+
+Respond to a question message.
+
+```typescript
+await conn.sendMessage(jid, {
+  questionResponse: {
+    key: {
+      remoteJid: jid,
+      fromMe: false,
+      id: 'questionMessageId123'
+    },
+    text: 'My answer is TypeScript!'
+  }
+});
+```
+
+##### Status Question Answer Messages
+
+Answer a question posted on status.
+
+```typescript
+await conn.sendMessage('status@broadcast', {
+  statusQuestionAnswer: {
+    key: {
+      remoteJid: 'status@broadcast',
+      fromMe: false,
+      id: 'statusQuestionId123'
+    },
+    text: 'My answer to the status question'
+  }
+}, {
+  statusJidList: [jid]
+});
+```
+
+##### Status Quoted Messages
+
+Quote a status message (e.g., question-answer reshare).
 
-WhatsApp introduced several new features in 2025. Here's how to handle them with Baileys:
+```typescript
+await conn.sendMessage('status@broadcast', {
+  statusQuoted: {
+    type: 1, // QUESTION_ANSWER
+    text: 'This is my response',
+    thumbnail: buffer, // optional thumbnail
+    originalStatusId: {
+      remoteJid: 'status@broadcast',
+      fromMe: false,
+      id: 'originalStatusId123'
+    }
+  }
+}, {
+  statusJidList: [jid]
+});
+```
+
+##### Status Sticker Interaction Messages
+
+Interact with stickers on status (e.g., reactions).
+
+```typescript
+await conn.sendMessage('status@broadcast', {
+  statusStickerInteraction: {
+    key: {
+      remoteJid: 'status@broadcast',
+      fromMe: false,
+      id: 'statusMessageId123'
+    },
+    stickerKey: 'stickerKey123',
+    type: 1 // REACTION
+  }
+}, {
+  statusJidList: [jid]
+});
+```
 
--   **Missed Call Messages**: Baileys is primarily for messaging and does not handle calls. To approximate this feature, you could potentially listen for call events (if supported) and then send a voice or video note as a follow-up message.
--   **Interactive Stickers on Status**: As shown in the sticker section, you can send stickers to `status@broadcast` with an interactive caption.
--   **AI-Generated Images**: This is not a native Baileys feature. You need to integrate an external AI image generation API (like Meta AI), generate the image, and then send it as a regular image message.
--   **Advanced Interactive Messages**: Features like "native flow" are partially supported in some forks (see issue [#398](https://github.com/WhiskeySockets/Baileys/issues/398)).
+##### AI Rich Response Messages
+
+Send AI-generated rich responses with multiple content types (tables, code, images, maps, etc.).
+
+```typescript
+await conn.sendMessage(jid, {
+  ai: true,
+  richResponse: {
+    messageType: 1, // AI_RICH_RESPONSE_TYPE_STANDARD
+    submessages: [
+      {
+        messageType: 2, // AI_RICH_RESPONSE_TEXT
+        messageText: 'Here is the answer to your question'
+      },
+      {
+        messageType: 4, // AI_RICH_RESPONSE_TABLE
+        tableMetadata: {
+          title: 'Data Table',
+          rows: [
+            { items: ['Header 1', 'Header 2'], isHeading: true },
+            { items: ['Value 1', 'Value 2'], isHeading: false }
+          ]
+        }
+      },
+      {
+        messageType: 5, // AI_RICH_RESPONSE_CODE
+        codeMetadata: {
+          codeLanguage: 'javascript',
+          codeBlocks: [
+            {
+              highlightType: 0, // DEFAULT
+              codeContent: 'console.log("Hello World");'
+            }
+          ]
+        }
+      }
+    ],
+    contextInfo: {
+      mentionedJid: [jid]
+    }
+  }
+});
+```
+
+Note: AI rich responses may show as "not supported" on some WhatsApp clients/accounts depending on app version and feature availability.
 
 #### Other Messages
+
+##### Business Call Messages (BCall)
+
+Send business call messages with media.
+
 ```typescript
-// Message with quote
-await conn.sendMessage(jid, { 
-    text: 'bang bang',
-    quoted: quotedMessage // The message to quote/reply/cite
+await conn.sendMessage(jid, {
+  bCall: {
+    sessionId: 'call_session_123',
+    mediaType: 2, // 0 = UNKNOWN, 1 = AUDIO, 2 = VIDEO
+    masterKey: Buffer.from('master_key_bytes'),
+    caption: 'Business call'
+  }
 });
+```
 
-// Location message
-await conn.sendMessage(jid, { 
-    location: { 
-        degreesLatitude: 45.4642, 
-        degreesLongitude: 9.1900,
-        name: "Milano",
-        address: "Piazza del Duomo, Milano"
-    } 
+##### Call Log Messages
+
+Send call log information.
+
+```typescript
+await conn.sendMessage(jid, {
+  callLog: {
+    isVideo: true,
+    callOutcome: 0, // 0 = CONNECTED, 1 = MISSED, 2 = FAILED, 3 = REJECTED, etc.
+    durationSecs: 120,
+    callType: 0, // 0 = REGULAR, 1 = SCHEDULED_CALL, 2 = VOICE_CHAT
+    participants: [
+      { jid: 'user@s.whatsapp.net', callOutcome: 0 }
+    ]
+  }
 });
+```
 
-// Contact Messages
-await conn.sendMessage(jid, { 
-  contacts: { 
-    displayName: 'Sam aka vare', 
-    contacts: [{ vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Sam aka vare\nTEL;waid=393476686131:+39 347 6686131\nEND:VCARD' }] 
-  } 
+##### Event Response Messages
+
+Respond to an event message (e.g., RSVP for an event).
+
+```typescript
+await conn.sendMessage(jid, {
+  eventResponse: {
+    response: 1, // GOING = 1, NOT_GOING = 2, MAYBE = 3
+    timestampMs: Date.now(),
+    extraGuestCount: 0
+  }
 });
+```
 
-// Ephemeral Messages (Self-Destructing)
-await conn.sendMessage(jid, { 
-  text: "This message will self-destruct {hopefully like israel}"
+##### Status Mention Messages
+
+Mention a status in another status.
+
+```typescript
+await conn.sendMessage('status@broadcast', {
+  statusMention: {
+    quotedStatus: {
+      key: {
+        remoteJid: 'status@broadcast',
+        fromMe: false,
+        id: 'statusId123'
+      },
+      message: {
+        conversation: 'Original status message'
+      }
+    }
+  }
 }, {
-  ephemeralExpiration: 7 * 24 * 60 * 60
+  statusJidList: [jid]
 });
+```
 
-// Messages with View Once Response
-await conn.sendMessage(
-    jid,
-    {
-        video: { url: './media/hado90.mp4' },
-        viewOnce: true,
-        caption: 'tuff'
+##### Group Status Messages
+
+Send a status message specific to a group.
+
+```typescript
+await conn.sendMessage(jid, {
+  groupStatus: {
+    message: {
+      conversation: 'Group status update!'
     }
-)
+  }
+});
+```
+
+##### Bot Task Messages
 
-// Status Messages
+Send a message related to a bot task.
+
+```typescript
+await conn.sendMessage(jid, {
+  botTask: {
+    message: {
+      conversation: 'Bot task completed.'
+    }
+  }
+});
+```
+
+##### Limit Sharing Messages
+
+Send a message to limit sharing.
+
+```typescript
+await conn.sendMessage(jid, {
+  limitSharing: {
+    message: {
+      conversation: 'Sharing limited for this message.'
+    }
+  }
+});
+```
+
+##### Status Add Yours Messages
+
+Send a "Add Yours" status message.
+
+```typescript
 await conn.sendMessage('status@broadcast', {
-    text: 'god forgive em'
+  statusAddYours: {
+    message: {
+      conversation: 'Add yours to this trend!'
+    }
+  }
 }, {
-    statusJidList: contacts
+  statusJidList: [jid]
+});
+```
+
+##### Bot Forwarded Messages
+
+Send a message that was forwarded by a bot.
+
+```typescript
+await conn.sendMessage(jid, {
+  botForwarded: {
+    message: {
+      conversation: 'This message was forwarded by a bot.'
+    }
+  }
+});
+```
+
+##### Event Cover Image Messages
+
+Send a cover image for an event.
+
+```typescript
+await conn.sendMessage(jid, {
+  eventCoverImage: {
+    message: {
+      imageMessage: {
+        url: 'https://example.com/event_cover.jpg',
+        mimetype: 'image/jpeg'
+      }
+    }
+  }
+});
+```
+
+##### Poll Creation Message V4
+
+Create a poll with additional options (version 4).
+
+```typescript
+await conn.sendMessage(jid, {
+  pollV4: {
+    name: 'Favorite color (V4)?',
+    selectableCount: 1,
+    values: ['Red', 'Green', 'Blue'],
+    pollType: 0 // Default poll type
+  }
+});
+```
+
+##### Poll Creation Message V5
+
+Create a poll with additional options (version 5).
+
+```typescript
+await conn.sendMessage(jid, {
+  pollV5: {
+    name: 'Favorite food (V5)?',
+    selectableCount: 2,
+    values: ['Pizza', 'Pasta', 'Sushi'],
+    pollType: 1 // Quiz poll type
+  }
+});
+```
+
+##### Poll Result Snapshot Message V3
+
+Send a snapshot of poll results (version 3).
+
+```typescript
+await conn.sendMessage(jid, {
+  pollResultSnapshotV3: {
+    pollCreationMessageKey: {
+      remoteJid: jid,
+      fromMe: true,
+      id: 'pollMessageId123'
+    },
+    pollResult: {
+      vote: {
+        selectedOptions: [Buffer.from('Red')]
+      },
+      senderTimestampMs: Date.now()
+    },
+    contextInfo: {
+      mentionedJid: [jid]
+    },
+    pollType: 0 // Default poll type
+  }
+});
+```
+
+##### Encrypted Comment Messages
+
+Send encrypted comments on messages.
+
+```typescript
+await conn.sendMessage(jid, {
+  encComment: {
+    targetMessageKey: {
+      remoteJid: jid,
+      fromMe: false,
+      id: 'messageId123'
+    },
+    encPayload: Buffer.from('encrypted_payload'),
+    encIv: Buffer.from('encryption_iv')
+  }
+});
+```
+
+##### Encrypted Event Response Messages
+
+Send encrypted event responses.
+
+```typescript
+await conn.sendMessage(jid, {
+  encEventResponse: {
+    eventCreationMessageKey: {
+      remoteJid: jid,
+      fromMe: false,
+      id: 'eventMessageId123'
+    },
+    encPayload: Buffer.from('encrypted_payload'),
+    encIv: Buffer.from('encryption_iv')
+  }
+});
+```
+
+##### Message History Bundle
+
+Send a bundle of message history.
+
+```typescript
+await conn.sendMessage(jid, {
+  messageHistoryBundle: {
+    mimetype: 'application/octet-stream',
+    media: { url: './history.bundle' },
+    messageHistoryMetadata: {
+      historyReceivers: ['user1@s.whatsapp.net', 'user2@s.whatsapp.net'],
+      oldestMessageTimestamp: Date.now() - 86400000,
+      messageCount: 100
+    },
+    contextInfo: {
+      mentionedJid: [jid]
+    }
+  }
+});
+```
+
+##### Message History Notice
+
+Send a notice about message history.
+
+```typescript
+await conn.sendMessage(jid, {
+  messageHistoryNotice: {
+    messageHistoryMetadata: {
+      historyReceivers: ['user1@s.whatsapp.net'],
+      oldestMessageTimestamp: Date.now() - 86400000,
+      messageCount: 50
+    },
+    contextInfo: {
+      mentionedJid: [jid]
+    }
+  }
 });
+```
+
+##### Newsletter Follower Invite
+
+Invite followers to a newsletter.
 
-// Send a status with media (visible only to selected contacts)
+```typescript
+await conn.sendMessage(jid, {
+  inviteFollower: {
+    newsletterJid: '120363418582531215@newsletter',
+    newsletterName: 'My Newsletter',
+    thumbnail: buffer, // Optional thumbnail
+    caption: 'Join our newsletter!',
+    contextInfo: {
+      mentionedJid: [jid]
+    }
+  }
+});
+```
+
+##### Placeholder Messages
+
+Send placeholder messages (e.g., to mask linked devices).
+
+```typescript
+await conn.sendMessage(jid, {
+  placeholder: {
+    type: 0 // MASK_LINKED_DEVICES = 0
+  }
+});
+```
+
+##### Secret Encrypted Messages
+
+Send secret encrypted messages (for event or message edits).
+
+```typescript
+await conn.sendMessage(jid, {
+  secretEncrypted: {
+    targetMessageKey: {
+      remoteJid: jid,
+      fromMe: false,
+      id: 'targetMessageId123'
+    },
+    encPayload: Buffer.from('encrypted_payload'),
+    encIv: Buffer.from('encryption_iv'),
+    secretEncType: 2 // 0 = UNKNOWN, 1 = EVENT_EDIT, 2 = MESSAGE_EDIT
+  }
+});
+```
+
+##### Status Notification Messages
+
+Send status notification messages (for status interactions).
+
+```typescript
 await conn.sendMessage('status@broadcast', {
-    image: { url: './media/menu/menu.jpg' },
-    caption: 'all i need in this life of sin is-',
-    }, {
-    statusJidList: contacts
+  statusNotification: {
+    responseMessageKey: {
+      remoteJid: 'status@broadcast',
+      fromMe: false,
+      id: 'responseId123'
+    },
+    originalMessageKey: {
+      remoteJid: 'status@broadcast',
+      fromMe: false,
+      id: 'originalId123'
+    },
+    type: 1 // 0 = UNKNOWN, 1 = STATUS_ADD_YOURS, 2 = STATUS_RESHARE, 3 = STATUS_QUESTION_ANSWER_RESHARE
+  }
+}, {
+  statusJidList: [jid]
 });
+```
 
-// Newsletter Messages
-await conn.sendMessage('120363418582531215@newsletter', {
-    text: 'ay yo',
-    });
+##### Sticker Sync RMR Messages
+
+Sync stickers via RMR (Recent Media Request).
+
+```typescript
+await conn.sendMessage(jid, {
+  stickerSyncRMR: {
+    filehash: ['hash1', 'hash2', 'hash3'],
+    rmrSource: 'source_identifier',
+    requestTimestamp: Date.now()
+  }
+});
+```
 
 // Payment Messages
+
+##### Request Payment
+```typescript
 await conn.sendMessage(jid, {
     requestPayment: {
         currency: 'EUR',
@@ -828,8 +1503,55 @@ await conn.sendMessage(jid, {
         note: 'js gimme my money' // https://paypal.me/samakavare
     }
 });
+```
+
+##### Send Payment
+```typescript
+await conn.sendMessage(jid, {
+    sendPayment: {
+        requestMessageKey: {
+            remoteJid: jid,
+            fromMe: false,
+            id: 'paymentRequestId123'
+        },
+        noteMessage: { text: 'Payment sent' },
+        background: {
+            id: 'payment_bg_id',
+            type: 1 // DEFAULT = 1
+        },
+        transactionData: 'transaction_data_string'
+    }
+});
+```
+
+##### Decline Payment Request
+```typescript
+await conn.sendMessage(jid, {
+    declinePayment: {
+        key: {
+            remoteJid: jid,
+            fromMe: false,
+            id: 'paymentRequestId123'
+        }
+    }
+});
+```
 
-// Call Messages
+##### Cancel Payment Request
+```typescript
+await conn.sendMessage(jid, {
+    cancelPayment: {
+        key: {
+            remoteJid: jid,
+            fromMe: true,
+            id: 'paymentRequestId123'
+        }
+    }
+});
+```
+
+##### Scheduled Call Creation
+```typescript
 await conn.sendMessage(jid, {
     call: {
         callKey: {
@@ -837,69 +1559,67 @@ await conn.sendMessage(jid, {
             id: Date.now().toString(),
             remoteJid: jid
         },
-        type: 'ACCEPT'  // 'MISSED', 'OFFER', 'ACCEPT', 'REJECT'..
+        type: 'ACCEPT',  // 'MISSED', 'OFFER', 'ACCEPT', 'REJECT'..
+        time: Date.now() + 3600000, // Scheduled time (optional)
+        title: 'Team Meeting' // Optional title
     }
 });
+```
 
-// Live Location Messages
+##### Scheduled Call Edit
+```typescript
 await conn.sendMessage(jid, {
-    liveLocation: {
-        degreesLatitude: 45.4642,
-        degreesLongitude: 9.1900,
-        accuracyInMeters: 50,
-        speedInMps: 5,
-        degreesClockwiseFromMagneticNorth: 359,
-        caption: "kmt im mean kiss my teeth",
-        sequenceNumber: 21,
-        timeOffset: 2000,
+    scheduledCallEdit: {
+        key: {
+            remoteJid: jid,
+            fromMe: true,
+            id: 'scheduledCallId123'
+        },
+        editType: 1 // 0 = UNKNOWN, 1 = CANCEL
     }
 });
+```
 
-// Order/Product Messages
+##### Pin/Unpin Messages
+
+Pin or unpin a message in a chat.
+
+```typescript
+// Pin a message (type 1 = PIN_FOR_ALL)
 await conn.sendMessage(jid, {
-    order: {
-        id: 'bysamakavare',
-        thumbnail: buffer, // image buffer
-        itemCount: 67,
-        surface: 'CATALOG',
-        title: 'heh',
-        text: 'gotta make it happen',
-        seller: '393514357738@s.whatsapp.net',
-        amount: 67000,
-        currency: 'EUR'
+    pin: {
+        key: {
+            remoteJid: jid,
+            fromMe: false,
+            id: 'messageId123'
+        },
+        type: 1, // 1 = PIN_FOR_ALL, 2 = UNPIN_FOR_ALL
+        time: 86400 // Duration in seconds (24 hours = 86400, 7 days = 604800, 30 days = 2592000)
     }
 });
 
-// Product
+// Or use simplified syntax
 await conn.sendMessage(jid, {
-    product: {
-        productImage: { url: './media/menu/menu.jpg' },
-        productId: 'prod123',
-        title: 'title',
-        description: 'Desc',
-        currency: 'EUR',
-        priceAmount1000: 67000,
-        retailerId: 'bysamakavare',
-        url: 'https://varebot.netlify.app',
+    pin: {
+        remoteJid: jid,
+        fromMe: false,
+        id: 'messageId123'
     },
-    businessOwnerJid: m.sender
+    type: 1, // 1 = PIN_FOR_ALL, 2 = UNPIN_FOR_ALL
+    time: 86400 // Optional: duration in seconds
 });
 
- // Messages with Custom Header
+// Unpin a message (type 2 = UNPIN_FOR_ALL)
 await conn.sendMessage(jid, {
-    text: 'dilemma',
-            contextInfo: {
-                externalAdReply: {
-                    title: `title`,
-                    body: `desc`,
-                    thumbnailUrl: 'https://i.ibb.co/hJW7WwxV/sam.jpg', // image
-                    sourceUrl: '', // not recommended to set
-                    mediaType: 1,
-                    renderLargerThumbnail: false
-                }
-            }
+    pin: {
+        key: {
+            remoteJid: jid,
+            fromMe: false,
+            id: 'messageId123'
+        },
+        type: 2 // UNPIN_FOR_ALL
+    }
 });
->  note: do not use showAdAttribution or keep it false, because with it active the message is not displayed
 ```
 
 ### Response Management
@@ -927,6 +1647,188 @@ conn.ev.on('messages.upsert', async ({ messages }) => {
         const selectedOptions = msg.message.pollResponseMessage.selectedOptions;
         console.log('Selected options:', selectedOptions);
     }
+    
+    // Comment response
+    if (msg.message?.commentMessage) {
+        const comment = msg.message.commentMessage;
+        console.log('Comment on message:', comment.targetMessageKey?.id);
+        console.log('Comment content:', comment.message);
+    }
+    
+    // Question response
+    if (msg.message?.questionResponseMessage) {
+        const response = msg.message.questionResponseMessage;
+        console.log('Response to question:', response.key?.id);
+        console.log('Answer:', response.text);
+    }
+    
+    // Status question answer
+    if (msg.message?.statusQuestionAnswerMessage) {
+        const answer = msg.message.statusQuestionAnswerMessage;
+        console.log('Status question answer:', answer.text);
+    }
+    
+    // AI Rich Response
+    if (msg.message?.richResponseMessage) {
+        const richResponse = msg.message.richResponseMessage;
+        console.log('AI Rich Response type:', richResponse.messageType);
+        console.log('Submessages:', richResponse.submessages);
+    }
+    
+    // Interactive Response (Native Flow Response)
+    if (msg.message?.interactiveResponseMessage) {
+        const response = msg.message.interactiveResponseMessage;
+        console.log('Interactive response body:', response.body?.text);
+        if (response.nativeFlowResponseMessage) {
+            console.log('Native flow response:', response.nativeFlowResponseMessage.name);
+            console.log('Params:', response.nativeFlowResponseMessage.paramsJson);
+        }
+    }
+    
+    // Sticker Pack
+    if (msg.message?.stickerPackMessage) {
+        const pack = msg.message.stickerPackMessage;
+        console.log('Sticker pack:', pack.name);
+        console.log('Publisher:', pack.publisher);
+        console.log('Stickers count:', pack.stickers?.length);
+        console.log('Pack ID:', pack.stickerPackId);
+        console.log('Origin:', pack.stickerPackOrigin);
+    }
+    
+    // Collection/Catalog response
+    if (msg.message?.interactiveMessage?.collectionMessage) {
+        const collection = msg.message.interactiveMessage.collectionMessage;
+        console.log('Collection opened:', collection.id);
+        console.log('Business JID:', collection.bizJid);
+    }
+    
+    // Invoice response
+    if (msg.message?.invoiceMessage) {
+        const invoice = msg.message.invoiceMessage;
+        console.log('Invoice token:', invoice.token);
+        console.log('Invoice note:', invoice.note);
+        console.log('Attachment type:', invoice.attachmentType === 0 ? 'IMAGE' : 'PDF');
+    }
+    
+    // Business Call
+    if (msg.message?.bcallMessage) {
+        const bcall = msg.message.bcallMessage;
+        console.log('Business call session:', bcall.sessionId);
+        console.log('Media type:', bcall.mediaType === 1 ? 'AUDIO' : 'VIDEO');
+    }
+    
+    // Call Log
+    if (msg.message?.callLogMesssage) {
+        const callLog = msg.message.callLogMesssage;
+        console.log('Call outcome:', callLog.callOutcome);
+        console.log('Duration:', callLog.durationSecs, 'seconds');
+        console.log('Participants:', callLog.participants);
+    }
+    
+    // Encrypted Comment
+    if (msg.message?.encCommentMessage) {
+        const encComment = msg.message.encCommentMessage;
+        console.log('Encrypted comment on message:', encComment.targetMessageKey?.id);
+    }
+    
+    // Encrypted Event Response
+    if (msg.message?.encEventResponseMessage) {
+        const encEvent = msg.message.encEventResponseMessage;
+        console.log('Encrypted event response for:', encEvent.eventCreationMessageKey?.id);
+    }
+    
+    // Message History Bundle
+    if (msg.message?.messageHistoryBundle) {
+        const bundle = msg.message.messageHistoryBundle;
+        console.log('History bundle receivers:', bundle.messageHistoryMetadata?.historyReceivers);
+        console.log('Message count:', bundle.messageHistoryMetadata?.messageCount);
+    }
+    
+    // Message History Notice
+    if (msg.message?.messageHistoryNotice) {
+        const notice = msg.message.messageHistoryNotice;
+        console.log('History notice receivers:', notice.messageHistoryMetadata?.historyReceivers);
+    }
+    
+    // Newsletter Follower Invite
+    if (msg.message?.newsletterFollowerInviteMessageV2) {
+        const invite = msg.message.newsletterFollowerInviteMessageV2;
+        console.log('Newsletter invite:', invite.newsletterName);
+        console.log('Newsletter JID:', invite.newsletterJid);
+    }
+    
+    // Placeholder
+    if (msg.message?.placeholderMessage) {
+        const placeholder = msg.message.placeholderMessage;
+        console.log('Placeholder type:', placeholder.type);
+    }
+    
+    // Secret Encrypted
+    if (msg.message?.secretEncryptedMessage) {
+        const secret = msg.message.secretEncryptedMessage;
+        console.log('Secret encrypted type:', secret.secretEncType);
+        console.log('Target message:', secret.targetMessageKey?.id);
+    }
+    
+    // Status Notification
+    if (msg.message?.statusNotificationMessage) {
+        const notification = msg.message.statusNotificationMessage;
+        console.log('Status notification type:', notification.type);
+        console.log('Original message:', notification.originalMessageKey?.id);
+    }
+    
+    // Sticker Sync RMR
+    if (msg.message?.stickerSyncRmrMessage) {
+        const sync = msg.message.stickerSyncRmrMessage;
+        console.log('Sticker sync filehashes:', sync.filehash);
+        console.log('RMR source:', sync.rmrSource);
+    }
+    
+    // Send Payment
+    if (msg.message?.sendPaymentMessage) {
+        const payment = msg.message.sendPaymentMessage;
+        console.log('Payment sent for request:', payment.requestMessageKey?.id);
+        console.log('Transaction data:', payment.transactionData);
+    }
+    
+    // Decline Payment
+    if (msg.message?.declinePaymentRequestMessage) {
+        const decline = msg.message.declinePaymentRequestMessage;
+        console.log('Payment declined for:', decline.key?.id);
+    }
+    
+    // Cancel Payment
+    if (msg.message?.cancelPaymentRequestMessage) {
+        const cancel = msg.message.cancelPaymentRequestMessage;
+        console.log('Payment cancelled for:', cancel.key?.id);
+    }
+    
+    // Scheduled Call Edit
+    if (msg.message?.scheduledCallEditMessage) {
+        const edit = msg.message.scheduledCallEditMessage;
+        console.log('Scheduled call edited:', edit.key?.id);
+        console.log('Edit type:', edit.editType === 1 ? 'CANCEL' : 'UNKNOWN');
+    }
+    
+    // Poll Result Snapshot
+    if (msg.message?.pollResultSnapshotMessage) {
+        const snapshot = msg.message.pollResultSnapshotMessage;
+        console.log('Poll snapshot:', snapshot.name);
+        console.log('Votes:', snapshot.pollVotes);
+    }
+    
+    // Poll Update
+    if (msg.message?.pollUpdateMessage) {
+        const update = msg.message.pollUpdateMessage;
+        console.log('Poll update for:', update.pollCreationMessageKey?.id);
+    }
+    
+    // Pin/Unpin
+    if (msg.message?.pinInChatMessage) {
+        const pin = msg.message.pinInChatMessage;
+        console.log('Pin action:', pin.type === 1 ? 'PIN_FOR_ALL' : 'UNPIN_FOR_ALL');
+        console.log('Pinned message:', pin.key?.id);
+    }
 });
 ```
 
@@ -1079,144 +1981,35 @@ await conn.sendMessage(jid, {
 
 ### Best Practices for LID/JID
 
-- **decodeJid(jid)**: Main function to normalize JID/LID. Handles:
-  - Formats with `:\d+@` (uses `jidNormalizedUser`).
-  - Decodes user/server into `${user}@${server}`.
-  - Converts `@lid` to `@s.whatsapp.net`.
-  
-  **Implementation Example (from main.js):**
-  ```typescript
-  decodeJid: (jid) => {
-      if (!jid) return jid;
-      let decoded = jid;
-      if (/:\d+@/gi.test(jid)) {
-          decoded = jidNormalizedUser(jid);
-      }
-      if (typeof decoded === 'object' && decoded.user && decoded.server) {
-          decoded = `${decoded.user}@${decoded.server}`;
-      }
-      if (decoded.endsWith('@lid')) {
-          decoded = decoded.replace('@lid', '@s.whatsapp.net');
-      }
-      return decoded;
-  },
-  ```
-  Use `conn.decodeJid(jid)` everywhere to normalize IDs (e.g., sender, participant, quoted).
+- **JID Normalization**: The library automatically handles JID/LID normalization in most cases.
+- **Use Built-in Functions**: Prefer `toJid()`, `normalizeJid()`, and `validateJid()` from the library.
+- **Cache Management**: The library includes automatic caching for LID/JID conversions.
 
-- **Monkey-Patch for groupParticipantsUpdate**: Fixes group participant updates by finding the real JID from metadata.
-  
-  **Example (from handler.js):**
-  ```typescript
-  if (!this.originalGroupParticipantsUpdate) {
-      this.originalGroupParticipantsUpdate = this.groupParticipantsUpdate;
-      this.groupParticipantsUpdate = async function(chatId, users, action) {
-          try {
-              let metadata = global.groupCache.get(chatId);
-              if (!metadata) {
-                  metadata = await fetchGroupMetadataWithRetry(this, chatId);
-                  if (metadata) global.groupCache.set(chatId, metadata);
-              }
-              if (!metadata) {
-                  console.error('[ERROR] No group metadata available for safe update');
-                  return this.originalGroupParticipantsUpdate.call(this, chatId, users, action);
-              }
-
-              const correctedUsers = users.map(userJid => {
-                  const decoded = this.decodeJid(userJid);
-                  const phone = decoded.split('@')[0].split(':')[0];
-                  const participant = metadata.participants.find(p => {
-                      const pId = this.decodeJid(p.id || p.jid || '');
-                      const pPhone = pId.split('@')[0].split(':')[0];
-                      return pPhone === phone;
-                  });
-                  return participant ? participant.id : userJid; // Fallback to original if not found
-              });
-
-              return this.originalGroupParticipantsUpdate.call(this, chatId, correctedUsers, action);
-          } catch (e) {
-              console.error('[ERROR] Error in safeGroupParticipantsUpdate:', e);
-              throw e;
-          }
-      };
-  }
-  ```
+**Common Use Cases:**
+- **Group Participants**: Use `toJid()` to normalize participant IDs before operations.
+- **Message Sender**: Extract sender info with `getSenderLid()` for reliable identification.
+- **Validation**: Always validate JIDs with `validateJid()` before critical operations.
 
-- **Cache for Group Metadata**: Use NodeCache to store metadata, normalizing with `decodeJid`.
-  
-  **Example (from handler.js):**
-  ```typescript
-  global.groupCache = new NodeCache({ stdTTL: 5 * 60, useClones: false });
-
-  // In participantsUpdate or groups.update:
-  metadata.participants.forEach(u => {
-      const normId = this.decodeJid(u.id);
-      const jid = u.jid || normId;
-  });
-  global.groupCache.set(update.id, metadata);
-  ```
-
-- **Normalization in Print/Log**: Remove `:xx` from phone numbers for clean display.
-  
-  **Example (from print.js):**
-  ```typescript
-  function formatPhoneNumber(jid, name) {
-      if (!jid) return 'Unknown';
-      let userPart = jid.split('@')[0];
-      let cleanNumber = userPart.split(':')[0]; // Remove the :xx part to get the real number
-      try {
-          const number = PhoneNumber('+' + cleanNumber).getNumber('international');
-          return number + (name ? ` ~${name}` : '');
-      } catch {
-          return (cleanNumber || '') + (name ? ` ~${name}` : '');
-      }
-  }
-  ```
-
-- **Common Problems and Fixes:**
-  - **Missing LID in Groups:** Use `decodeJid` and metadata cache to find real JIDs.
-  - **JID Conversion:** Always apply `decodeJid` before `sendMessage` or query.
-  - **Multi-Device:** Set `syncFullHistory: true` in config for LID sync.
-  - **Errors in Mention/Quoted:** Normalize with `decodeJid` in handler for quoted.sender and mentionedJid.
-
-### Integrated Example in Main
+### Integrated Example
 
 ```typescript
-// In your main file
-import makeWASocket, { getSenderLid, toJid } from '@realvare/based';
-// ... (authentication and sock creation)
+import makeWASocket, { getSenderLid, toJid, validateJid } from '@realvare/based';
 
 conn.ev.on('messages.upsert', async ({ messages }) => {
   const msg = messages[0];
   if (!msg.message) return;
 
   const info = getSenderLid(msg);
-  const senderJid = toJid(info.lid); // Fix LID -> JID
-
-  // Example: Reply only if valid JID
-  if (senderJid.endsWith('@s.whatsapp.net')) {
-    await conn.sendMessage(senderJid, { text: `Hello from ${senderJid}!` }, { quoted: msg });
+  const senderJid = toJid(info.lid);
+  
+  // Validate before using
+  const validation = validateJid(senderJid);
+  if (validation.isValid) {
+    await conn.sendMessage(senderJid, { text: 'Message received!' }, { quoted: msg });
   }
 });
 ```
 
-### Custom Handler Example
-
-```typescript
-// handler.js
-export async function handleMessage(sock, msg) {
-  const info = getSenderLid(msg);
-  const jid = toJid(info.lid);
-  
-  // Log and response
-  console.log(`Message from ${jid}`);
-  await conn.sendMessage(jid, { text: 'Handler activated!' });
-}
-
-// In main: conn.ev.on('messages.upsert', ({ messages }) => handleMessage(sock, messages[0]));
-```
-
-**Tip:** Test in groups to verify LID, as Baileys upstream has improved native support in 2025, but the custom fixes here ensure backward compatibility.
-
 ---
 
 ### 🚀 Smart LID/JID Cache
@@ -1309,29 +2102,16 @@ console.log('Cache enabled:', config.performance.enableCache);
 
 ---
 
-## 🧩 Events: LID and JID always available (new)
+## 🧩 Events: LID and JID Management
 
-The emitted events include auxiliary fields on messages to easily access both the sender/participant's JID and LID.
+The library enriches event payloads to provide both JID and LID, eliminating ambiguity in multi-device and group contexts.
 
-```typescript
-conn.ev.on('messages.upsert', ({ messages, type }) => {
-  for (const msg of messages) {
-    // Additional fields on msg.key
-    // - remoteJidNormalized: Normalized JID (e.g., @s.whatsapp.net)
-    // - remoteLid: LID equivalent of remoteJid
-    // - participantLid: LID equivalent of participant (if present)
-    const jid = msg.key.remoteJidNormalized || msg.key.remoteJid;
-    const remoteLid = msg.key.remoteLid;
-    const participantLid = msg.key.participantLid;
+**Key Features:**
+- Automatic JID/LID normalization in events
+- Pre-normalized fields in `msg.key` (`remoteJidNormalized`, `remoteLid`, `participantLid`)
+- Seamless conversion with `toJid()` and `normalizeJid()`
 
-    if (jid?.endsWith('@s.whatsapp.net')) {
-      conn.sendMessage(jid, { text: `Hello! LID: ${remoteLid || 'n/a'}` });
-    }
-  }
-});
-```
-
-These fields eliminate ambiguity in groups and multi-device contexts where some events report LID, others JID.
+Refer to the examples in the **Quick Guide** and **API Documentation** sections for practical usage.
 
 ---
 
@@ -1359,8 +2139,8 @@ const sock = makeWASocket({
   maxMsgRetryCount: 5,
   
   // 🎛️ Behavior
-  markOnlineOnConnect: true,
-  syncFullHistory: false, // Enable for full sync (consumes data)
+  markOnlineOnConnect: false, // Recommended: false to reduce ban risk
+  syncFullHistory: false, // Keep false to prevent slowdowns
   fireInitQueries: true,
   generateHighQualityLinkPreview: true,
 });
@@ -1465,4 +2245,4 @@ See [LICENSE](LICENSE) for details.
 <br>
 <img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=24&height=120&section=footer&text=&fontSize=30&fontColor=ffffff&animation=fadeIn&fontAlignY=35"/>
 
-</div>
+</div>