queenruva-sockets 5.6.23

package/README.md

@@ -0,0 +1,1082 @@
+<h1 align="center">
+  <br/>
+  <strong>Queen Ruva Baileys</strong>
+  <br/>
+  <sub>by <a href="https://silentbyte-plantforms-inc.zone.id">Iconic Tech</a></sub>
+</h1>
+
+<p align="center">
+  A clean, powerful WebSocket library for WhatsApp Web automation.<br/>
+  Built on top of Baileys — refined, branded, and production-ready.
+</p>
+
+<p align="center">
+  <a href="https://github.com/iconictech-dev/queenruva-socket">GitHub</a> •
+  <a href="https://silentbyte-plantforms-inc.zone.id">Website</a> •
+  <a href="https://whatsapp.com/channel/0029Vak32nE4o7qP75htEB3I">WhatsApp Channel</a>
+</p>
+
+---
+
+## Overview
+
+**Queen Ruva Baileys** is a WebSocket-based JavaScript library for interacting with the WhatsApp Web API. No Selenium. No Chromium. Just a raw, efficient WebSocket connection that saves you memory and gets the job done.
+
+- Full multi-device support
+- Pairing code authentication — no QR scan required
+- Clean branded console output on every session
+- Pure JS — no TypeScript compilation step needed
+- **AI badge support** — mark messages with the WhatsApp `AI ✦` indicator
+- Actively maintained by **Iconic Tech**
+
+---
+
+## Installation
+
+```bash
+npm install queenruva-socket
+# or
+yarn add queenruva-socket
+```
+
+> Requires Node.js **>= 20.0.0**
+
+---
+
+## Index
+
+- [Connecting Account](#connecting-account)
+  - [Connect with Pairing Code](#connect-with-pairing-code)
+  - [Connect with QR Code](#connect-with-qr-code)
+  - [Receive Full History](#receive-full-history)
+- [Save & Restore Sessions](#save--restore-sessions)
+- [Handling Events](#handling-events)
+- [Sending Messages](#sending-messages)
+  - [Text Message](#text-message)
+  - [AI Badge Message ✦](#ai-badge-message-)
+  - [Quote / Reply Message](#quote--reply-message)
+  - [Mention User](#mention-user)
+  - [Forward Messages](#forward-messages)
+  - [Location Message](#location-message)
+  - [Contact Message](#contact-message)
+  - [Reaction Message](#reaction-message)
+  - [Pin Message](#pin-message)
+  - [Poll Message](#poll-message)
+  - [Link Preview](#link-preview)
+  - [Image Message](#image-message)
+  - [Video Message](#video-message)
+  - [Audio / PTT Message](#audio--ptt-message)
+  - [GIF Message](#gif-message)
+  - [View Once Message](#view-once-message)
+  - [Document Message](#document-message)
+  - [Sticker Message](#sticker-message)
+- [Modify Messages](#modify-messages)
+  - [Delete for Everyone](#delete-for-everyone)
+  - [Edit Message](#edit-message)
+- [Receiving Messages](#receiving-messages)
+- [Read & Presence](#read--presence)
+  - [Read Messages](#read-messages)
+  - [Send Typing / Recording / Online](#send-typing--recording--online)
+  - [Subscribe to Presence](#subscribe-to-presence)
+- [Modifying Chats](#modifying-chats)
+  - [Archive a Chat](#archive-a-chat)
+  - [Mute / Unmute a Chat](#mute--unmute-a-chat)
+  - [Mark Chat Read / Unread](#mark-chat-read--unread)
+  - [Delete a Chat](#delete-a-chat)
+  - [Star / Unstar a Message](#star--unstar-a-message)
+  - [Disappearing Messages](#disappearing-messages)
+- [User Queries](#user-queries)
+  - [Check if ID Exists](#check-if-id-exists)
+  - [Fetch Status](#fetch-status)
+  - [Fetch Profile Picture](#fetch-profile-picture)
+  - [Fetch Business Profile](#fetch-business-profile)
+  - [Fetch Blocklist](#fetch-blocklist)
+- [Change Profile](#change-profile)
+  - [Change Status](#change-status)
+  - [Change Name](#change-name)
+  - [Change Profile Picture](#change-profile-picture)
+  - [Remove Profile Picture](#remove-profile-picture)
+- [Privacy Settings](#privacy-settings)
+  - [Block / Unblock User](#block--unblock-user)
+  - [Update Last Seen Privacy](#update-last-seen-privacy)
+  - [Update Online Privacy](#update-online-privacy)
+  - [Update Profile Picture Privacy](#update-profile-picture-privacy)
+  - [Update Status Privacy](#update-status-privacy)
+  - [Update Read Receipts Privacy](#update-read-receipts-privacy)
+  - [Update Groups Add Privacy](#update-groups-add-privacy)
+  - [Update Default Disappearing Mode](#update-default-disappearing-mode)
+- [Groups](#groups)
+  - [Create a Group](#create-a-group)
+  - [Add / Remove / Promote / Demote](#add--remove--promote--demote)
+  - [Change Group Name](#change-group-name)
+  - [Change Group Description](#change-group-description)
+  - [Change Group Settings](#change-group-settings)
+  - [Leave a Group](#leave-a-group)
+  - [Get Invite Code](#get-invite-code)
+  - [Revoke Invite Code](#revoke-invite-code)
+  - [Join via Invite Code](#join-via-invite-code)
+  - [Get Group Info by Invite Code](#get-group-info-by-invite-code)
+  - [Get Group Metadata](#get-group-metadata)
+  - [Get All Participating Groups](#get-all-participating-groups)
+  - [Toggle Ephemeral](#toggle-ephemeral)
+  - [Approve / Reject Join Requests](#approve--reject-join-requests)
+- [Broadcast & Stories](#broadcast--stories)
+  - [Send Broadcast / Status](#send-broadcast--status)
+- [Media](#media)
+  - [Download Media Message](#download-media-message)
+  - [Re-upload Media to WhatsApp](#re-upload-media-to-whatsapp)
+- [Reject Call](#reject-call)
+- [Console Banner](#console-banner)
+- [Disclaimer](#disclaimer)
+
+---
+
+## Connecting Account
+
+### Connect with Pairing Code
+
+Queen Ruva Baileys randomly picks one of three pairing codes per session:
+
+| Code | Type |
+|------|------|
+| `QUEENRUV` | Queen Ruva signature |
+| `ICONICRUV` | Iconic Tech branded |
+| `RUVABETA` | Beta session |
+
+```js
+import makeWASocket, { useMultiFileAuthState, DisconnectReason } from 'queenruva-socket'
+import { Boom } from '@hapi/boom'
+
+const { state, saveCreds } = await useMultiFileAuthState('./session')
+
+const sock = makeWASocket({
+    auth: state,
+    printQRInTerminal: false
+})
+
+sock.ev.on('creds.update', saveCreds)
+
+// Request pairing code
+const code = await sock.requestPairingCode('+263786115435')
+console.log('Pairing code:', code)
+
+sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+    if (connection === 'close') {
+        const shouldReconnect =
+            (lastDisconnect?.error instanceof Boom)
+                ? lastDisconnect.error.output.statusCode !== DisconnectReason.loggedOut
+                : true
+        if (shouldReconnect) { /* reconnect */ }
+    } else if (connection === 'open') {
+        console.log('Connected to WhatsApp!')
+    }
+})
+```
+
+Or use a custom 8-character code:
+
+```js
+const code = await sock.requestPairingCode('+263786115435', 'MYCODE12')
+```
+
+### Connect with QR Code
+
+```js
+import makeWASocket, { useMultiFileAuthState } from 'queenruva-socket'
+import qrcode from 'qrcode-terminal'
+
+const { state, saveCreds } = await useMultiFileAuthState('./session')
+
+const sock = makeWASocket({ auth: state })
+
+sock.ev.on('connection.update', ({ qr }) => {
+    if (qr) qrcode.generate(qr, { small: true })
+})
+
+sock.ev.on('creds.update', saveCreds)
+```
+
+### Receive Full History
+
+```js
+const sock = makeWASocket({
+    auth: state,
+    syncFullHistory: true
+})
+```
+
+---
+
+## Save & Restore Sessions
+
+```js
+import { useMultiFileAuthState } from 'queenruva-socket'
+
+const { state, saveCreds } = await useMultiFileAuthState('./session')
+
+// Pass state to socket
+const sock = makeWASocket({ auth: state })
+
+// Always save on update
+sock.ev.on('creds.update', saveCreds)
+```
+
+> Keep the `./session` folder private — it holds your active WhatsApp session.
+
+---
+
+## Handling Events
+
+```js
+// Connection updates
+sock.ev.on('connection.update', (update) => {
+    console.log('Connection:', update)
+})
+
+// New / updated messages
+sock.ev.on('messages.upsert', ({ messages, type }) => {
+    console.log('Messages:', messages)
+})
+
+// Message updates (read, delivered, etc.)
+sock.ev.on('messages.update', (updates) => {
+    console.log('Updates:', updates)
+})
+
+// Chat updates
+sock.ev.on('chats.update', (chats) => {
+    console.log('Chats updated:', chats)
+})
+
+// Contact updates
+sock.ev.on('contacts.update', (contacts) => {
+    console.log('Contacts updated:', contacts)
+})
+
+// Presence updates (typing, online)
+sock.ev.on('presence.update', ({ id, presences }) => {
+    console.log(`${id} presence:`, presences)
+})
+
+// Group participant updates
+sock.ev.on('group-participants.update', ({ id, participants, action }) => {
+    console.log(`Group ${id}: ${action}`, participants)
+})
+
+// Call events
+sock.ev.on('call', (calls) => {
+    console.log('Incoming call:', calls)
+})
+```
+
+---
+
+## Sending Messages
+
+After every message is delivered the console prints:
+```
+  ✉  Message delivered  — Thanks for using Queen Ruva Baileys · By Iconic Tech
+```
+
+### Text Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    text: 'Hello from Queen Ruva Baileys!'
+})
+```
+
+---
+
+### AI Badge Message ✦
+
+> **Queen Ruva Baileys exclusive feature.**
+
+Add `ai: true` to any `sendMessage` call and WhatsApp will render the **`AI ✦`** badge next to the timestamp on the recipient's screen — visually marking the message as AI-generated.
+
+This works on **all message types** — text, image, video, audio, documents, and more.
+
+```js
+// Text with AI badge
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    text: 'Hello! I am an AI assistant.',
+    ai: true
+})
+```
+
+```js
+// Image with AI badge
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    image: { url: './image.jpg' },
+    caption: 'Generated by AI',
+    ai: true
+})
+```
+
+```js
+// Video with AI badge
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    video: { url: './video.mp4' },
+    caption: 'AI generated video',
+    ai: true
+})
+```
+
+```js
+// Voice note with AI badge
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    audio: { url: './voice.ogg' },
+    mimetype: 'audio/ogg; codecs=opus',
+    ptt: true,
+    ai: true
+})
+```
+
+> **How it works:** Queen Ruva Baileys injects `ai="1"` into the WhatsApp message stanza, which triggers WhatsApp to render the `AI ✦` indicator on the recipient's side. No extra setup or API keys needed — just pass `ai: true`.
+
+---
+
+### Quote / Reply Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    text: 'This is a reply!'
+}, {
+    quoted: messageToQuote
+})
+```
+
+### Mention User
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    text: '@2637XXXXXXXX hello!',
+    mentions: ['2637XXXXXXXX@s.whatsapp.net']
+})
+```
+
+### Forward Messages
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    forward: messageToForward
+})
+```
+
+### Location Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    location: {
+        degreesLatitude: -17.8252,
+        degreesLongitude: 31.0335
+    }
+})
+```
+
+### Contact Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    contacts: {
+        displayName: 'John',
+        contacts: [{ vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:John\nTEL;type=CELL:+2637XXXXXXXX\nEND:VCARD' }]
+    }
+})
+```
+
+### Reaction Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    react: {
+        text: '🔥',
+        key: messageToReactTo.key
+    }
+})
+```
+
+### Pin Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    pin: messageToPin.key,
+    type: 1  // 1 = pin, 0 = unpin
+})
+```
+
+### Poll Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    poll: {
+        name: 'Favourite colour?',
+        values: ['Red', 'Blue', 'Green'],
+        selectableCount: 1
+    }
+})
+```
+
+### Link Preview
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    text: 'Check this out: https://silentbyte-plantforms-inc.zone.id'
+}, {
+    detectLinks: true
+})
+```
+
+### Image Message
+
+```js
+// From file
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    image: { url: './image.jpg' },
+    caption: 'Sent via Queen Ruva Baileys'
+})
+
+// From buffer
+import { readFileSync } from 'fs'
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    image: readFileSync('./image.jpg'),
+    caption: 'Hello!'
+})
+```
+
+### Video Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    video: { url: './video.mp4' },
+    caption: 'Watch this!',
+    gifPlayback: false
+})
+```
+
+### Audio / PTT Message
+
+```js
+// Audio file
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    audio: { url: './audio.mp3' },
+    mimetype: 'audio/mp4'
+})
+
+// Voice note (PTT)
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    audio: { url: './voice.ogg' },
+    mimetype: 'audio/ogg; codecs=opus',
+    ptt: true
+})
+```
+
+### GIF Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    video: { url: './animation.mp4' },
+    gifPlayback: true,
+    caption: 'lol'
+})
+```
+
+### View Once Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    image: { url: './secret.jpg' },
+    viewOnce: true,
+    caption: 'View once!'
+})
+```
+
+### Document Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    document: { url: './file.pdf' },
+    mimetype: 'application/pdf',
+    fileName: 'report.pdf'
+})
+```
+
+### Sticker Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    sticker: { url: './sticker.webp' }
+})
+```
+
+---
+
+## Modify Messages
+
+### Delete for Everyone
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    delete: messageToDelete.key
+})
+```
+
+### Edit Message
+
+```js
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    edit: messageToEdit.key,
+    text: 'Updated text here'
+})
+```
+
+---
+
+## Receiving Messages
+
+```js
+sock.ev.on('messages.upsert', ({ messages }) => {
+    for (const msg of messages) {
+        if (msg.key.fromMe) continue
+
+        const text = msg.message?.conversation
+                  || msg.message?.extendedTextMessage?.text
+                  || ''
+
+        const sender = msg.key.remoteJid
+        console.log(`[${sender}]: ${text}`)
+    }
+})
+```
+
+---
+
+## Read & Presence
+
+### Read Messages
+
+```js
+await sock.readMessages([
+    {
+        remoteJid: '2637XXXXXXXX@s.whatsapp.net',
+        id: 'MESSAGE_ID',
+        fromMe: false
+    }
+])
+```
+
+### Send Typing / Recording / Online
+
+```js
+// Start typing
+await sock.sendPresenceUpdate('composing', '2637XXXXXXXX@s.whatsapp.net')
+
+// Recording audio
+await sock.sendPresenceUpdate('recording', '2637XXXXXXXX@s.whatsapp.net')
+
+// Stop typing / go back to available
+await sock.sendPresenceUpdate('paused', '2637XXXXXXXX@s.whatsapp.net')
+
+// Set online
+await sock.sendPresenceUpdate('available')
+
+// Set offline
+await sock.sendPresenceUpdate('unavailable')
+```
+
+### Subscribe to Presence
+
+```js
+// Subscribe to someone's presence (online, typing, etc.)
+await sock.presenceSubscribe('2637XXXXXXXX@s.whatsapp.net')
+
+sock.ev.on('presence.update', ({ id, presences }) => {
+    console.log(`${id}:`, presences)
+})
+```
+
+---
+
+## Modifying Chats
+
+### Archive a Chat
+
+```js
+// Archive
+await sock.chatModify({ archive: true }, '2637XXXXXXXX@s.whatsapp.net')
+
+// Unarchive
+await sock.chatModify({ archive: false }, '2637XXXXXXXX@s.whatsapp.net')
+```
+
+### Mute / Unmute a Chat
+
+```js
+// Mute for 8 hours
+await sock.chatModify({
+    mute: Date.now() + (8 * 60 * 60 * 1000)
+}, '2637XXXXXXXX@s.whatsapp.net')
+
+// Unmute
+await sock.chatModify({ mute: null }, '2637XXXXXXXX@s.whatsapp.net')
+```
+
+### Mark Chat Read / Unread
+
+```js
+// Mark as read
+await sock.chatModify({ markRead: true }, '2637XXXXXXXX@s.whatsapp.net')
+
+// Mark as unread
+await sock.chatModify({ markRead: false }, '2637XXXXXXXX@s.whatsapp.net')
+```
+
+### Delete a Chat
+
+```js
+await sock.chatModify({
+    delete: true,
+    lastMessages: [{ key: lastMessage.key, messageTimestamp: lastMessage.messageTimestamp }]
+}, '2637XXXXXXXX@s.whatsapp.net')
+```
+
+### Star / Unstar a Message
+
+```js
+// Star
+await sock.star('2637XXXXXXXX@s.whatsapp.net', [message], true)
+
+// Unstar
+await sock.star('2637XXXXXXXX@s.whatsapp.net', [message], false)
+```
+
+### Disappearing Messages
+
+```js
+// Enable disappearing messages (7 days)
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    disappearingMessagesInChat: 604800
+})
+
+// Disable
+await sock.sendMessage('2637XXXXXXXX@s.whatsapp.net', {
+    disappearingMessagesInChat: 0
+})
+```
+
+---
+
+## User Queries
+
+### Check if ID Exists
+
+```js
+const [result] = await sock.onWhatsApp('2637XXXXXXXX')
+console.log(result?.exists, result?.jid)
+```
+
+### Fetch Status
+
+```js
+const statuses = await sock.fetchStatus('2637XXXXXXXX@s.whatsapp.net')
+console.log(statuses)
+```
+
+### Fetch Profile Picture
+
+```js
+const url = await sock.profilePictureUrl('2637XXXXXXXX@s.whatsapp.net', 'image')
+console.log('Profile picture:', url)
+
+// Group profile picture
+const groupUrl = await sock.profilePictureUrl('GROUPID@g.us', 'image')
+```
+
+### Fetch Business Profile
+
+```js
+const profile = await sock.getBusinessProfile('2637XXXXXXXX@s.whatsapp.net')
+console.log(profile?.description, profile?.category)
+```
+
+### Fetch Blocklist
+
+```js
+const blocked = await sock.fetchBlocklist()
+console.log('Blocked:', blocked)
+```
+
+---
+
+## Change Profile
+
+### Change Status
+
+```js
+await sock.updateProfileStatus('Powered by Queen Ruva Baileys 🔥')
+```
+
+### Change Name
+
+```js
+await sock.updateProfileName('My Bot Name')
+```
+
+### Change Profile Picture
+
+```js
+await sock.updateProfilePicture('me', { url: './avatar.jpg' })
+
+// Change group picture
+await sock.updateProfilePicture('GROUPID@g.us', { url: './group.jpg' })
+```
+
+### Remove Profile Picture
+
+```js
+await sock.removeProfilePicture('me')
+```
+
+---
+
+## Privacy Settings
+
+### Block / Unblock User
+
+```js
+// Block
+await sock.updateBlockStatus('2637XXXXXXXX@s.whatsapp.net', 'block')
+
+// Unblock
+await sock.updateBlockStatus('2637XXXXXXXX@s.whatsapp.net', 'unblock')
+```
+
+### Update Last Seen Privacy
+
+```js
+// Options: 'all' | 'contacts' | 'contact_blacklist' | 'none'
+await sock.updateLastSeenPrivacy('contacts')
+```
+
+### Update Online Privacy
+
+```js
+await sock.updateOnlinePrivacy('match_last_seen')
+```
+
+### Update Profile Picture Privacy
+
+```js
+await sock.updateProfilePicturePrivacy('contacts')
+```
+
+### Update Status Privacy
+
+```js
+await sock.updateStatusPrivacy('contacts')
+```
+
+### Update Read Receipts Privacy
+
+```js
+// 'all' = show read receipts | 'none' = hide
+await sock.updateReadReceiptsPrivacy('all')
+```
+
+### Update Groups Add Privacy
+
+```js
+// Who can add you to groups: 'all' | 'contacts' | 'contact_blacklist'
+await sock.updateGroupsAddPrivacy('contacts')
+```
+
+### Update Default Disappearing Mode
+
+```js
+// Duration in seconds — 86400 = 1 day, 604800 = 7 days, 7776000 = 90 days
+await sock.updateDefaultDisappearingMode(604800)
+```
+
+---
+
+## Groups
+
+### Create a Group
+
+```js
+const group = await sock.groupCreate('My Bot Group', [
+    '2637XXXXXXXX@s.whatsapp.net',
+    '2637YYYYYYYY@s.whatsapp.net'
+])
+console.log('Created:', group.id)
+```
+
+### Add / Remove / Promote / Demote
+
+```js
+// Add participants
+await sock.groupParticipantsUpdate('GROUPID@g.us', ['2637XXXXXXXX@s.whatsapp.net'], 'add')
+
+// Remove participants
+await sock.groupParticipantsUpdate('GROUPID@g.us', ['2637XXXXXXXX@s.whatsapp.net'], 'remove')
+
+// Promote to admin
+await sock.groupParticipantsUpdate('GROUPID@g.us', ['2637XXXXXXXX@s.whatsapp.net'], 'promote')
+
+// Demote from admin
+await sock.groupParticipantsUpdate('GROUPID@g.us', ['2637XXXXXXXX@s.whatsapp.net'], 'demote')
+```
+
+### Change Group Name
+
+```js
+await sock.groupUpdateSubject('GROUPID@g.us', 'New Group Name')
+```
+
+### Change Group Description
+
+```js
+await sock.groupUpdateDescription('GROUPID@g.us', 'New description here')
+```
+
+### Change Group Settings
+
+```js
+// Only admins can send messages
+await sock.groupSettingUpdate('GROUPID@g.us', 'announcement')
+
+// Everyone can send messages
+await sock.groupSettingUpdate('GROUPID@g.us', 'not_announcement')
+
+// Only admins can edit group info
+await sock.groupSettingUpdate('GROUPID@g.us', 'locked')
+
+// Everyone can edit group info
+await sock.groupSettingUpdate('GROUPID@g.us', 'unlocked')
+```
+
+### Leave a Group
+
+```js
+await sock.groupLeave('GROUPID@g.us')
+```
+
+### Get Invite Code
+
+```js
+const code = await sock.groupInviteCode('GROUPID@g.us')
+console.log('Invite link: https://chat.whatsapp.com/' + code)
+```
+
+### Revoke Invite Code
+
+```js
+const newCode = await sock.groupRevokeInvite('GROUPID@g.us')
+```
+
+### Join via Invite Code
+
+```js
+await sock.groupAcceptInvite('INVITECODE')
+```
+
+### Get Group Info by Invite Code
+
+```js
+const info = await sock.groupGetInviteInfo('INVITECODE')
+console.log(info)
+```
+
+### Get Group Metadata
+
+```js
+const meta = await sock.groupMetadata('GROUPID@g.us')
+console.log(meta.subject, meta.participants)
+```
+
+### Get All Participating Groups
+
+```js
+const groups = await sock.groupFetchAllParticipating()
+console.log(Object.values(groups))
+```
+
+### Toggle Ephemeral
+
+```js
+// Enable ephemeral (disappearing) — 604800 = 7 days
+await sock.groupToggleEphemeral('GROUPID@g.us', 604800)
+
+// Disable
+await sock.groupToggleEphemeral('GROUPID@g.us', 0)
+```
+
+### Approve / Reject Join Requests
+
+```js
+// Get pending requests
+const requests = await sock.groupRequestParticipantsList('GROUPID@g.us')
+
+// Approve
+await sock.groupRequestParticipantsUpdate('GROUPID@g.us', ['2637XXXXXXXX@s.whatsapp.net'], 'approve')
+
+// Reject
+await sock.groupRequestParticipantsUpdate('GROUPID@g.us', ['2637XXXXXXXX@s.whatsapp.net'], 'reject')
+```
+
+---
+
+## Broadcast & Stories
+
+### Send Broadcast / Status
+
+```js
+// Text status
+await sock.sendMessage('status@broadcast', {
+    text: 'Queen Ruva Baileys is live! 🔥'
+})
+
+// Image status
+await sock.sendMessage('status@broadcast', {
+    image: { url: './banner.jpg' },
+    caption: 'Powered by Iconic Tech'
+})
+
+// Send to specific contacts
+await sock.sendMessage('status@broadcast', {
+    text: 'Hello everyone!'
+}, {
+    statusJidList: [
+        '2637XXXXXXXX@s.whatsapp.net',
+        '2637YYYYYYYY@s.whatsapp.net'
+    ]
+})
+```
+
+---
+
+## Media
+
+### Download Media Message
+
+```js
+import { downloadMediaMessage } from 'queenruva-socket'
+
+sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+        if (msg.message?.imageMessage) {
+            const buffer = await downloadMediaMessage(msg, 'buffer', {})
+            // buffer is ready to save or process
+        }
+    }
+})
+```
+
+### Re-upload Media to WhatsApp
+
+```js
+await sock.updateMediaMessage(message)
+```
+
+---
+
+## Reject Call
+
+```js
+sock.ev.on('call', async (calls) => {
+    for (const call of calls) {
+        if (call.status === 'offer') {
+            await sock.rejectCall(call.id, call.from)
+        }
+    }
+})
+```
+
+---
+
+## setup
+```js
+const { 
+  default: makeWASocket,
+  fetchLatestQueenruvaBaileysVersion,
+  downloadContentFromMessage,
+  useMultiFileAuthState,
+  BufferJSON,
+  WA_DEFAULT_EPHEMERAL,
+  generateWAMessageFromContent,
+  proto,
+  generateWAMessageContent,
+  generateWAMessage,
+  prepareWAMessageMedia,
+  areJidsSameUser,
+  getContentType 
+} = require('queenruva-socket');
+```
+---
+
+```js
+if (!IconicTechInc.public) {
+            if (!isCreator && !m.key.fromMe) return
+        }
+        
+        if (autoread) {
+            IconicTechInc.readMessages([m.key])
+        }
+        
+        if (global.autoTyping) {
+        IconicTechInc.sendPresenceUpdate('composing', from)
+        }
+
+        if (global.autoRecording) {
+        IconicTechInc.sendPresenceUpdate('recording', from)
+        };
+       ```
+        
+
+```
+
+## Console Banner
+
+Every time your bot starts, a clean branded banner is printed automatically:
+
+```
+══════════════════════════════════════════════════════════════
+   ██████  ██    ██ ███████ ███████ ███    ██
+  ██    ██ ██    ██ ██      ██      ████   ██
+  ██    ██ ██    ██ █████   █████   ██ ██  ██
+  ██ ▄▄ ██ ██    ██ ██      ██      ██  ██ ██
+   ██████   ██████  ███████ ███████ ██   ████
+      ▀▀
+
+        R U V A  —  B A I L E Y S
+
+  Version   v5.6.21
+  Author    Iconic Tech
+  Website   https://silentbyte-plantforms-inc.zone.id
+══════════════════════════════════════════════════════════════
+```
+
+---
+
+## Disclaimer
+
+This project is **not** affiliated with, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or Meta Platforms Inc.
+
+"WhatsApp" and related names, marks, and images are registered trademarks of their respective owners. Use responsibly. Do not violate WhatsApp's Terms of Service.
+
+---
+
+## Links
+
+| | |
+|---|---|
+| Website | [silentbyte-plantforms-inc.zone.id](https://silentbyte-plantforms-inc.zone.id) |
+| WhatsApp Channel | [Open Channel](https://whatsapp.com/channel/0029Vak32nE4o7qP75htEB3I) |
+| GitHub | [iconictech-dev/queenruva-socket](https://github.com/iconictech-dev/queenruva-socket) |
+
+---
+
+<p align="center">
+  <strong>Queen Ruva Baileys</strong> — crafted with care by <strong>Iconic Tech</strong><br/>
+  <sub>Silentbyte Platforms Inc &copy; 2026</sub>
+</p>