@crysnovax/baileys 2.5.0 → 2.5.5

package/README.md

@@ -1,20 +1,3 @@
-<p align="center">
-  <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=700&size=40&duration=3000&pause=800&color=10B981&center=true&vCenter=true&width=600&lines=%F0%9F%91%8B+Hey%2C+I'm+CRYSNOVA;%F0%9F%92%BB+Full+Stack+Developer;%F0%9F%9A%80+Building+the+Future;%F0%9F%94%A5+Open+Source+Lover" alt="Typing Animation" />
-</p>
-
-<p align="center">
-  <img src="https://img.shields.io/github/followers/crysnovax?style=for-the-badge&logo=github&color=10b981&labelColor=0a0f0a" />
-  <img src="https://img.shields.io/github/stars/crysnovax?style=for-the-badge&logo=github&color=10b981&labelColor=0a0f0a" />
-  <img src="https://komarev.com/ghpvc/?username=crysnovax&style=for-the-badge&color=10b981&label=PROFILE+VIEWS" />
-</p>
-
-<br />
-
-<div align="center">
-  <img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="700">
-</div>
-
-<br />
 
 <h2 align="center">
   <img src="https://media2.giphy.com/media/QssGEmpkyEOhBCb7e1/giphy.gif?cid=ecf05e47a0n3gi1bfqntqmob8g9aid1oyj2wr3ds3mg700bl&rid=giphy.gif" width="28" />
@@ -64,254 +47,841 @@ const crysnova = {
 
 | 🚀 Project | ⭐ Stars | 📝 Description |
 |-----------|---------|---------------|
-| **CRYSNOVA AI** | [![Stars](https://img.shields.io/github/stars/crysnovax/CRYSNOVA_AI?style=flat&color=10b981)](https://github.com/crysnovax/CRYSNOVA_AI) | 250+ Command WhatsApp Bot with AI Integration |
+| **CRYSNOVA AI** | [![Stars](https://img.shields.io/github/stars/crysnovax/CRYSNOVA_AI?style=flat&color=10b981)](https://github.com/crysnovax/CRYSNOVA_AI) | 550+ Command WhatsApp Bot with AI Integration |
 | **API Gateway** | [![Stars](https://img.shields.io/github/stars/crysnovax/API?style=flat&color=10b981)](https://github.com/crysnovax/API) | Nexray Endpoints Unified API Gateway |
 | **Economy Engine** | [![Stars](https://img.shields.io/github/stars/crysnovax?style=flat&color=10b981)](https://github.com/crysnovax) | Realistic Virtual Economy with Banking System |
 
 </div>
 
-<br />
 
-<h2 align="center">
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-  GitHub Stats
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-</h2>
 
-<div align="center">
-  <a href="https://github.com/crysnovax">
-    <img height="180em" src="https://github-readme-stats.vercel.app/api?username=crysnovax&show_icons=true&theme=dark&title_color=10b981&icon_color=10b981&text_color=e2f5e8&bg_color=0a0f0a&hide_border=true&count_private=true&include_all_commits=true" />
-  </a>
-  <a href="https://github.com/crysnovax">
-    <img height="180em" src="https://github-readme-stats.vercel.app/api/top-langs/?username=crysnovax&layout=compact&theme=dark&title_color=10b981&text_color=e2f5e8&bg_color=0a0f0a&hide_border=true&langs_count=8" />
-  </a>
-</div>
+<p align="center">
+  <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=700&size=32&duration=3000&pause=800&color=10B981&center=true&vCenter=true&width=650&lines=%F0%9F%9A%80+%40crysnovax%2Fbailey%3B+WhatsApp+API+for+Node.js%3B+Rich+Messages+%7C+Meta+AI+Style%3B+Production+Ready+%E2%9C%85" alt="Typing Animation" />
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/@crysnovax/bailey?style=for-the-badge&logo=npm&color=10b981&labelColor=0a0f0a" />
+  <img src="https://img.shields.io/github/stars/crysnovax/baileys?style=for-the-badge&logo=github&color=10b981&labelColor=0a0f0a" />
+  <img src="https://img.shields.io/badge/License-MIT-10b981?style=for-the-badge&labelColor=0a0f0a" />
+  <img src="https://img.shields.io/badge/Node.js-%3E%3D18-10b981?style=for-the-badge&logo=node.js&labelColor=0a0f0a" />
+</p>
 
 <br />
 
 <div align="center">
-  <a href="https://github.com/crysnovax">
-    <img src="https://github-readme-streak-stats.herokuapp.com/?user=crysnovax&theme=dark&ring=10b981&fire=10b981&currStreakLabel=10b981&sideNums=10b981&sideLabels=e2f5e8&dates=6aa886&background=0a0f0a&hide_border=true" />
-  </a>
+  <img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="700">
 </div>
 
 <br />
 
-<div align="center">
-  <img src="https://github-profile-trophy.vercel.app/?username=crysnovax&theme=darkhub&no-frame=true&no-bg=true&margin-w=15&column=7&title_color=10b981" />
-</div>
+## Table of Contents
+
+| # | Section | Description |
+|---|---------|-------------|
+| 1 | [Overview](#overview) | What this package is and what sets it apart |
+| 2 | [Installation](#installation) | NPM, GitHub, ESM & CJS imports |
+| 3 | [Quick Start](#quick-start) | Minimal working connection example |
+| 4 | [Authentication](#authentication) | Auth states, pairing codes, SQLite |
+| 5 | [Sending Messages](#sending-messages) | Text, mentions, reactions, contacts, locations, events, polls, forward, edit |
+| 6 | [Media Messages](#media-messages) | Images, videos, audio, documents, stickers, albums |
+| 7 | [Interactive Messages](#interactive-messages) | Buttons, lists, native flows, carousels, hydrated templates |
+| 8 | [Rich Content](#rich-content) | Code blocks, tables, inline entities, rich response arrays |
+| 9 | [Meta AI Features](#meta-ai-features) | Meta typing, meta compositing, replay planning |
+| 10 | [Welcome Flow](#welcome-flow) | Auto-greet new contacts with FAQ menus |
+| 11 | [Payment Messages](#payment-messages) | Invites, invoices, orders, payment requests |
+| 12 | [Message Options](#message-options) | AI icon, ephemeral, spoilers, view once, raw, and more |
+| 13 | [Newsletter Management](#newsletter-management) | Create, update, follow, react, delete newsletters |
+| 14 | [Group Management](#group-management) | Create, settings, participants, invites, metadata |
+| 15 | [Community Management](#community-management) | Communities, subgroups, linked groups |
+| 16 | [Profile & Business](#profile--business) | Profile pictures, business catalog, products, quick replies |
+| 17 | [Privacy & Security](#privacy--security) | Last seen, online, status, read receipts, calls |
+| 18 | [Events Reference](#events-reference) | Full list of socket event listeners |
+| 19 | [Image Processing](#image-processing) | Sharp, NAPI-RS, Jimp auto-detection |
+| 20 | [Condition of Use](#condition-of-use) | Channel follow agreement |
+| 21 | [Credits](#credits) | Attribution and enhancements |
+
+---
+
+## Overview
+
+`@crysnovax/bailey` is a powerful, production-ready WhatsApp API wrapper for Node.js, built on top of the Baileys protocol. It extends the core with rich messaging capabilities, Meta AI-style compositing, and a streamlined developer experience.
+
+### What Sets It Apart
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Rich Messages | ✅ | Code blocks, tables, inline entities, carousel cards |
+| Meta AI Style | ✅ | Live thinking indicators without "edited" badges |
+| Welcome Flow | ✅ | Auto-greet new contacts with interactive FAQ menus |
+| No Obfuscation | ✅ | Fully readable, auditable source code |
+| Newsletter Ready | ✅ | Full media support, quoting, quiz polls |
+| Image Processing | ✅ | Auto-detects `sharp`, `@napi-rs/image`, or `jimp` |
+| Safe FFmpeg | ✅ | Uses `spawn` instead of `exec` |
+| In-Memory Store | ✅ | Reintroduced with minimal ESM adaptation |
+
+---
+
+## Installation
+
+```bash
+# NPM
+npm install @crysnovax/bailey
+
+# GitHub
+npm install github:crysnovax/baileys
+```
 
-<br />
+### Import (ESM & CJS)
 
-<h2 align="center">
-  <img src="https://media.giphy.com/media/LnQjpWaON8nhr21vNW/giphy.gif" width="28" />
-  Let's Connect
-  <img src="https://media.giphy.com/media/LnQjpWaON8nhr21vNW/giphy.gif" width="28" />
-</h2>
+```javascript
+// ESM
+import { makeWASocket } from '@crysnovax/bailey'
 
-<p align="center">
-  <a href="https://whatsapp.com/channel/0029Vb6pe77K0IBn48HLKb38">
-    <img src="https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge&logo=whatsapp&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  </a>
-  <a href="https://youtube.com/@crysnovax">
-    <img src="https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  </a>
-  <a href="https://discord.com/users/crysnovadesigns">
-    <img src="https://img.shields.io/badge/Discord-crysnovadesigns-5865F2?style=for-the-badge&logo=discord&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  </a>
-  <a href="https://github.com/crysnovax">
-    <img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  </a>
-  <a href="mailto:crysnovax@gmail.com">
-    <img src="https://img.shields.io/badge/Email-D14836?style=for-the-badge&logo=gmail&logoColor=white&labelColor=0a0f0a&color=10b981" />
-  </a>
-</p>
+// CJS (Node.js 24+)
+const { makeWASocket } = require('@crysnovax/bailey')
+```
 
-<br />
+---
 
-<div align="center">
-  <img src="https://quotes-github-readme.vercel.app/api?type=horizontal&theme=dark&quote=Code+is+like+humor.+When+you+have+to+explain+it,+it's+bad.&author=Cory+House" />
-</div>
+## Quick Start
 
-<br />
+```javascript
+import { makeWASocket, delay, DisconnectReason, useMultiFileAuthState } from '@crysnovax/bailey'
+import { Boom } from '@hapi/boom'
+import pino from 'pino'
 
-<h2 align="center">⚠️ Condition of Use</h2>
+const myPhoneNumber = '6288888888888'
+const logger = pino({ level: 'silent' })
 
-<p align="center">
-  By using <b>@crysnovax/bailey</b> you agree to the following condition:<br/><br/>
-  This fork will automatically follow the two official Crysnovax WhatsApp channels<br/>
-  on first connection. This happens once and will not repeat on reconnects.<br/><br/>
-  <b>The channels are:</b><br/>
-  📢 <a href="https://whatsapp.com/channel/120363402922206865">Crysnovax Channel 1</a><br/>
-  📢 <a href="https://whatsapp.com/channel/120363423670814885">Crysnovax Channel 2</a><br/><br/>
-  This is how you stay updated with new features, patches, and releases.<br/>
-  If you do not agree to this condition, do not use this fork.
-</p>
+const connectToWhatsApp = async () => {
+  const { state, saveCreds } = await useMultiFileAuthState('session')
 
-<br />
+  const sock = makeWASocket({
+    logger,
+    auth: state
+  })
 
-<h2 align="center">
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-  Welcome Flow — Startup Template
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-</h2>
+  sock.ev.on('creds.update', saveCreds)
 
-<p align="center">
-  Meta Business-style greeting template — fires automatically on first message<br/>
-  from any new contact with an interactive FAQ menu. Once per contact, never repeats.
-</p>
+  sock.ev.on('connection.update', async (update) => {
+    const { connection, lastDisconnect } = update
 
-<br />
+    if (connection === 'connecting' && !sock.authState.creds.registered) {
+      await delay(1500)
+      const code = await sock.requestPairingCode(myPhoneNumber)
+      console.log('Pairing code:', code)
+    }
+    else if (connection === 'close') {
+      const shouldReconnect = new Boom(lastDisconnect?.error)?.output?.statusCode !== DisconnectReason.loggedOut
+      console.log('Connection closed, reconnecting:', shouldReconnect)
+      if (shouldReconnect) connectToWhatsApp()
+    }
+    else if (connection === 'open') {
+      console.log('Connected to WhatsApp')
+    }
+  })
 
-**Basic setup — drop it in and it works:**
+  sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+      if (!msg.message) continue
+      await sock.sendMessage(msg.key.remoteJid, { text: 'Hello world!' })
+    }
+  })
+}
 
-```js
-import { createWelcomeFlow } from '@crysnovax/bailey'
+connectToWhatsApp()
+```
 
-const welcome = createWelcomeFlow(sock, {
-    greeting:     '👋 Welcome! How can I help you today?',
-    footer:       'Powered by MyBot',
-    buttonText:   '📋 Choose an option',
-    sectionTitle: 'How can we help?',
-    faqs: [
-        { id: 'order',   title: '📦 Track my order',     description: 'Check order status'        },
-        { id: 'billing', title: '💳 Billing & payments', description: 'Payment issues & invoices' },
-        { id: 'support', title: '🛠️ Technical support',  description: 'Get help with a problem'   },
-        { id: 'human',   title: '📞 Talk to a human',    description: 'Connect with support staff' },
-    ]
+---
+
+## Authentication
+
+### Multi-File Auth State (Recommended)
+
+```javascript
+import { useMultiFileAuthState } from '@crysnovax/bailey'
+
+const { state, saveCreds } = await useMultiFileAuthState('session')
+```
+
+### Single-File Auth State (Experimental)
+
+```javascript
+import { useSingleFileAuthState } from '@crysnovax/bailey'
+
+const { state, saveCreds } = await useSingleFileAuthState('session.json')
+// Already includes internal caching — no need for makeCacheableSignalKeyStore
+```
+
+### SQLite Auth State (Experimental)
+
+```javascript
+import { useSqliteAuthState } from '@crysnovax/bailey'
+
+const { state, saveCreds } = await useSqliteAuthState('session.db')
+```
+
+### Custom Pairing Code
+
+```javascript
+const phoneNumber = '6281111111111'
+const customCode = 'STARFALL'
+
+await sock.requestPairingCode(phoneNumber, customCode)
+console.log('Pairing code:', customCode)
+```
+
+---
+
+## Sending Messages
+
+### Text & Mentions
+
+```javascript
+// Plain text
+sock.sendMessage(jid, { text: 'Hello!' }, { quoted: message })
+
+// With link preview
+const url = 'https://www.npmjs.com/package/@crysnovax/bailey'
+sock.sendMessage(jid, {
+  text: url + ' Check it out!',
+  linkPreview: {
+    'matched-text': url,
+    title: '@crysnovax/bailey',
+    description: 'WhatsApp API for Node.js',
+    previewType: 0,
+    jpegThumbnail: fs.readFileSync('./thumb.jpg')
+  }
 })
 
-welcome.listen() // start
+// Large link preview with favicon
+import { prepareWAMessageMedia } from '@crysnovax/bailey'
+
+const { imageMessage: image } = await prepareWAMessageMedia(
+  { image: { url: './thumb.jpg' } },
+  { upload: sock.waUploadToServer, mediaTypeOverride: 'thumbnail-link' }
+)
+
+image.height = 720
+image.width = 480
+
+sock.sendMessage(jid, {
+  text: url + ' Check it out!',
+  linkPreview: {
+    'matched-text': url,
+    title: '@crysnovax/bailey',
+    description: 'WhatsApp API for Node.js',
+    previewType: 0,
+    jpegThumbnail: fs.readFileSync('./thumb.jpg'),
+    highQualityThumbnail: image,
+    linkPreviewMetadata: {
+      linkMediaDuration: 0,
+      socialMediaPostType: 1 // 0=NONE, 1=REEL, 2=LIVE, 3=LONG, 4=IMAGE, 5=CAROUSEL
+    }
+  },
+  favicon: { url: './favicon.ico' }
+})
+
+// Mention specific users
+sock.sendMessage(jid, {
+  text: 'Hello @628123456789',
+  mentions: ['628123456789@s.whatsapp.net']
+})
+
+// Mention all group participants
+sock.sendMessage(jid, {
+  text: 'Hello @all',
+  mentionAll: true
+})
 ```
 
-<br />
+### Reactions & Pins
+
+```javascript
+// Reaction
+sock.sendMessage(jid, {
+  react: { key: message.key, text: '✨' }
+})
 
-**Handle FAQ replies + greet callback:**
+// Pin message (86400=1d, 604800=7d, 2592000=30d)
+sock.sendMessage(jid, {
+  pin: message.key,
+  time: 86400,
+  type: 1 // 1=pin, 2=unpin
+})
 
-```js
-const welcome = createWelcomeFlow(sock, {
-    greeting: '👋 Hi there! What brings you here today?',
-    faqs: [
-        { id: 'pricing', title: '💰 Pricing',    description: 'Plans and costs'   },
-        { id: 'demo',    title: '🎥 Request demo', description: 'See it in action' },
-        { id: 'support', title: '🛠️ Support',    description: 'Get help'          },
+// Keep chat (disappearing messages only)
+sock.sendMessage(jid, {
+  keep: message.key,
+  type: 1 // 1=keep, 2=remove
+})
+```
+
+### Contacts & Locations
+
+```javascript
+// Contact card
+const vcard = 'BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nORG:Company;\nTEL;type=CELL;type=VOICE;waid=628123456789:+62 8123 4567 89\nEND:VCARD'
+
+sock.sendMessage(jid, {
+  contacts: {
+    displayName: 'John Doe',
+    contacts: [{ vcard }]
+  }
+})
+
+// Location
+sock.sendMessage(jid, {
+  location: {
+    degreesLatitude: 24.121231,
+    degreesLongitude: 55.1121221,
+    name: 'I am here'
+  }
+})
+
+// Group invite
+const inviteCode = groupUrl.split('chat.whatsapp.com/')[1]?.split('?')[0]
+
+sock.sendMessage(jid, {
+  groupInvite: {
+    inviteCode,
+    inviteExpiration: Date.now() + 86400000,
+    text: 'Join our group!',
+    jid: groupJid,
+    subject: groupName
+  }
+})
+```
+
+### Events & Polls
+
+```javascript
+// Calendar event
+sock.sendMessage(jid, {
+  event: {
+    name: 'Meet & Mingle Party',
+    description: 'A fun gathering to connect and chat.',
+    call: 'audio', // or 'video'
+    startDate: new Date(Date.now() + 3600000),
+    endDate: new Date(Date.now() + 28800000),
+    isCancelled: false,
+    isScheduleCall: false,
+    extraGuestsAllowed: false,
+    location: {
+      name: 'Jakarta',
+      degreesLatitude: -6.2,
+      degreesLongitude: 106.8
+    }
+  }
+})
+
+// Poll
+sock.sendMessage(jid, {
+  poll: {
+    name: 'Voting time',
+    values: ['Yes', 'No'],
+    selectableCount: 1,
+    toAnnouncementGroup: false,
+    endDate: new Date(Date.now() + 28800000),
+    hideVoter: false,
+    canAddOption: false
+  }
+})
+
+// Quiz (newsletter only)
+sock.sendMessage('1211111111111@newsletter', {
+  poll: {
+    name: 'Quiz',
+    values: ['Yes', 'No'],
+    correctAnswer: 'Yes',
+    pollType: 1
+  }
+})
+
+// Poll result
+sock.sendMessage(jid, {
+  pollResult: {
+    name: 'Poll Result',
+    votes: [
+      { name: 'Nice', voteCount: 10 },
+      { name: 'Nah', voteCount: 2 }
     ],
+    pollType: 0
+  }
+})
+
+// Poll update
+sock.sendMessage(jid, {
+  pollUpdate: {
+    metadata: {},
+    key: message.key,
+    vote: { enclv: buffer, encPayload: buffer }
+  }
+})
+```
+
+### Forward & Edit
+
+```javascript
+// Forward
+sock.sendMessage(jid, {
+  forward: message,
+  force: true
+})
+
+// Delete
+sock.sendMessage(jid, { delete: message.key })
+
+// Edit text
+sock.sendMessage(jid, {
+  text: 'Updated text!',
+  edit: message.key
+})
+
+// Edit media caption
+sock.sendMessage(jid, {
+  caption: 'Updated caption!',
+  edit: message.key
+})
+```
+
+---
+
+## Media Messages
+
+### Images & Videos
+
+```javascript
+// Image
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'Check this out!'
+})
+
+// Video
+sock.sendMessage(jid, {
+  video: { url: './video.mp4' },
+  gifPlayback: false, // true = send as GIF
+  ptv: false,         // true = send as PTV
+  caption: 'Watch this!'
+})
+
+// Status mention (multiple jids)
+sock.sendMessage([jidA, jidB, jidC], {
+  text: 'Hello!'
+})
+```
+
+### Audio & Documents
+
+```javascript
+// Audio
+sock.sendMessage(jid, {
+  audio: { url: './audio.mp3' },
+  ptt: false // true = voice note
+})
+
+// Document
+sock.sendMessage(jid, {
+  document: { url: './file.pdf' },
+  mimetype: 'application/pdf',
+  caption: 'My document'
+})
+```
+
+### Stickers & Albums
+
+```javascript
+// Sticker
+sock.sendMessage(jid, {
+  sticker: { url: './sticker.webp' }
+})
+
+// Album (images + videos)
+sock.sendMessage(jid, {
+  album: [
+    { image: { url: './img1.jpg' }, caption: 'First image' },
+    { video: { url: './vid1.mp4' }, caption: 'First video' },
+    { image: { url: './img2.jpg' }, caption: 'Second image' }
+  ]
+})
+
+// Sticker pack
+sock.sendMessage(jid, {
+  cover: { url: './cover.webp' },
+  stickers: [
+    { data: { url: './sticker1.webp' } },
+    { data: { url: './sticker2.webp' } }
+  ],
+  name: 'My Sticker Pack',
+  publisher: 'CRYSNOVA',
+  description: '@crysnovax/bailey'
+})
+```
+
+---
+
+## Interactive Messages
+
+### Buttons & Lists
+
+```javascript
+// Buttons
+sock.sendMessage(jid, {
+  text: 'Choose an option!',
+  footer: '@crysnovax/bailey',
+  buttons: [
+    { text: 'Sign Up', id: '#SignUp' }
+  ]
+})
 
-    // Fires after greeting is sent
-    onGreet: async (jid, message) => {
-        console.log(`Greeted new contact: ${jid}`)
+// Buttons with media and native flow
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'Interactive buttons!',
+  footer: '@crysnovax/bailey',
+  buttons: [
+    { text: 'Rating', id: '#Rating' },
+    {
+      text: 'Select',
+      sections: [
+        {
+          title: 'Section 1',
+          rows: [
+            { header: '', title: 'Secret Ingredient', description: '', id: '#SecretIngredient' }
+          ]
+        },
+        {
+          title: 'Section 2',
+          highlight_label: 'Popular',
+          rows: [
+            { header: '', title: 'Coupon', description: '', id: '#CouponCode' }
+          ]
+        }
+      ]
+    }
+  ]
+})
+
+// List (private chat only)
+sock.sendMessage(jid, {
+  text: 'List menu!',
+  footer: '@crysnovax/bailey',
+  buttonText: 'Select',
+  title: 'Hello',
+  sections: [
+    {
+      title: 'Menu 1',
+      rows: [
+        { title: 'AI', description: '', rowId: '#AI' }
+      ]
     },
+    {
+      title: 'Menu 2',
+      rows: [
+        { title: 'Search', description: '', rowId: '#Search' }
+      ]
+    }
+  ]
+})
+```
 
-    // Fires when user picks a FAQ option
-    onFaqReply: async (jid, faqId, message) => {
-        switch (faqId) {
-            case 'pricing':
-                await sock.sendMessage(jid, { text: '💰 Our plans start at $9/month...' })
-                break
-            case 'demo':
-                await sock.sendMessage(jid, { text: '🎥 Book a demo here: https://...' })
-                break
-            case 'support':
-                await sock.sendMessage(jid, { text: '🛠️ Describe your issue and we\'ll help!' })
-                break
+### Native Flows & Carousels
+
+```javascript
+// Native flow with options
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'Interactive!',
+  footer: '@crysnovax/bailey',
+  optionText: 'Select Options',
+  optionTitle: 'Select Options',
+  offerText: 'New Coupon!',
+  offerCode: 'SAVE20',
+  offerUrl: 'https://example.com',
+  offerExpiration: Date.now() + 3600000,
+  nativeFlow: [
+    { text: 'Greeting', id: '#Greeting', icon: 'review' },
+    { text: 'Call', call: '628123456789' },
+    { text: 'Copy', copy: '@crysnovax/bailey' },
+    { text: 'Source', url: 'https://example.com', useWebview: true },
+    {
+      text: 'Select',
+      sections: [
+        {
+          title: 'Section 1',
+          rows: [
+            { header: '', title: 'Coupon', description: '', id: '#CouponCode' }
+          ]
         }
+      ],
+      icon: 'default'
     }
+  ],
+  interactiveAsTemplate: false
 })
 
-welcome.listen()
+// Carousel with cards
+sock.sendMessage(jid, {
+  text: 'Carousel!',
+  footer: '@crysnovax/bailey',
+  cards: [
+    {
+      image: { url: './img1.jpg' },
+      caption: 'Image 1',
+      footer: 'Pinterest',
+      nativeFlow: [
+        { text: 'Source', url: 'https://example.com', useWebview: true }
+      ]
+    },
+    {
+      image: { url: './img2.jpg' },
+      caption: 'Image 2',
+      footer: 'Pinterest',
+      offerText: 'New Coupon!',
+      offerCode: 'SAVE20',
+      offerUrl: 'https://example.com',
+      offerExpiration: Date.now() + 3600000,
+      nativeFlow: [
+        { text: 'Source', url: 'https://example.com' }
+      ]
+    }
+  ]
+})
+
+// Native flow with audio footer
+sock.sendMessage(jid, {
+  text: 'Music in footer!',
+  audioFooter: { url: './audio.mp3' },
+  nativeFlow: [
+    { text: 'Good, next', id: '#Next', icon: 'review' },
+    { text: 'Skip', id: '#Skip', icon: 'default' }
+  ]
+})
 ```
 
-<br />
+### Hydrated Templates
 
-**Persist seen contacts across restarts:**
+```javascript
+sock.sendMessage(jid, {
+  title: 'Hello',
+  image: { url: './image.jpg' },
+  caption: 'Template!',
+  footer: '@crysnovax/bailey',
+  templateButtons: [
+    { text: 'Tap Here', id: '#Order' },
+    { text: 'Source', url: 'https://example.com' },
+    { text: 'Call', call: '628123456789' }
+  ]
+})
+```
 
-```js
-const welcome = createWelcomeFlow(sock, {
-    greeting: '👋 Welcome!',
-    faqs: [...],
-    persistPath: './data/greeted-contacts.json' // saves + loads automatically
+---
+
+## Rich Content
+
+### Code Blocks
+
+```javascript
+// Built-in tokenizer
+sock.sendMessage(jid, {
+  disclaimerText: 'Code Block',
+  headerText: '## Example Usage',
+  contentText: '---',
+  code: 'console.log("Hello, World!")',
+  language: 'javascript',
+  footerText: 'Pretty simple, right?'
+})
+
+// Supported languages: css, html, javascript, typescript, python, golang, rust, c, c#, c++, bash, bat, powershell
+
+// Manual tokenization
+import { tokenizeCode } from '@crysnovax/bailey'
+
+const language = 'javascript'
+const code = 'console.log("Hello, World!")'
+
+sock.sendMessage(jid, {
+  disclaimerText: 'Tokenized Code',
+  richResponse: [
+    { text: 'Example Usage' },
+    { language, code: tokenizeCode(code, language) },
+    { text: 'Pretty simple, right?' }
+  ]
 })
 ```
 
-<br />
+### Tables & Inline Entities
 
-**Control methods:**
+```javascript
+// Table message
+sock.sendMessage(jid, {
+  disclaimerText: 'Table',
+  headerText: '## Comparison',
+  contentText: '---',
+  title: 'Runtime Comparison',
+  table: [
+    ['', 'Node.js', 'Bun', 'Deno'],
+    ['Engine', 'V8', 'JavaScriptCore', 'V8'],
+    ['Performance', '4/5', '5/5', '4/5']
+  ],
+  noHeading: false,
+  footerText: 'Does this help?'
+})
 
-```js
-welcome.listen()              // start listening
-welcome.stop()                // stop listening
-welcome.reset(jid)            // force re-greet one contact next message
-welcome.resetAll()            // clear all seen contacts
-welcome.hasGreeted(jid)       // check if contact was already greeted → boolean
+// Inline entities (links)
+sock.sendMessage(jid, {
+  disclaimerText: 'Inline Entities',
+  headerText: '## Check Out!',
+  contentText: '---',
+  links: [
+    { text: '1. Google', title: 'Search Engine', url: 'https://google.com' },
+    { text: '2. YouTube', title: 'Streaming', url: 'https://youtube.com' }
+  ],
+  footerText: '---'
+})
 ```
 
-<br />
+### Rich Response Arrays
 
-**Full config reference:**
+```javascript
+// Full rich response with mixed content
+sock.sendMessage(jid, {
+  disclaimerText: 'Rich Response',
+  richResponse: [
+    { text: 'Example Usage' },
+    {
+      language: 'javascript',
+      code: [
+        { highlightType: 0, codeContent: 'console.log("Hello, World!")' }
+      ]
+    },
+    { text: 'Pretty simple, right?\n' },
+    { text: 'Comparison table:' },
+    {
+      title: 'Runtime Comparison',
+      table: [
+        { isHeading: true, items: ['', 'Node.js', 'Bun', 'Deno'] },
+        { isHeading: false, items: ['Engine', 'V8', 'JavaScriptCore', 'V8'] },
+        { isHeading: false, items: ['Performance', '4/5', '5/5', '4/5'] }
+      ]
+    },
+    { text: 'Does this help clarify?' }
+  ]
+})
+```
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `greeting` | `string` | `'👋 Welcome!...'` | Body text of the welcome message |
-| `footer` | `string` | `'Powered by @crysnovax/bailey'` | Footer text |
-| `buttonText` | `string` | `'📋 Choose an option'` | List button label |
-| `sectionTitle` | `string` | `'How can we help?'` | Section header in the list |
-| `faqs` | `Array` | 4 default items | `{ id, title, description }` objects |
-| `typingDelayMs` | `number` | `1200` | Typing indicator duration before greeting |
-| `persistPath` | `string\|null` | `null` | JSON file path to persist seen JIDs |
-| `ignoreGroups` | `boolean` | `true` | Skip group chats |
-| `ignoreNewsletter` | `boolean` | `true` | Skip newsletter messages |
-| `ignoreBroadcast` | `boolean` | `true` | Skip broadcast messages |
-| `onGreet` | `async fn` | `null` | Called after greeting is sent |
-| `onFaqReply` | `async fn` | `null` | Called when user selects a FAQ option |
+---
 
-<br />
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-</h2>
+## Meta AI Features
 
-<p align="center">
-  Live Meta AI-style reasoning feed — each step visibly completes in real time,<br/>
-  then the final rich message lands clean. <b>No "edited" badge. Ever.</b>
-</p>
+### Meta Typing Indicator
 
-<br />
+Show a live thinking indicator that you control. Delete it manually when ready — no "edited" badge ever appears.
+
+```javascript
+import { metaTyping, buildSteps, PlanningStepStatus } from '@crysnovax/bailey'
+
+const placeholder = await metaTyping(sock, jid, {
+  description: 'Thinking…',
+  steps: buildSteps(['Reading your message…', 'Writing response…'])
+})
+
+// Do your work here…
+
+// Delete the indicator cleanly
+await sock.sendMessage(jid, { delete: placeholder.key })
+
+// Send the real message
+await sock.sendMessage(jid, { text: 'Here is your answer!' })
+```
+
+### Meta Compositing
+
+Full flow: indicator shows → auto-deletes → clean final message lands. Works with every rich content type.
+
+```javascript
+import { sendMetaComposited, PlanningStepStatus } from '@crysnovax/bailey'
+
+// With code block
+await sendMetaComposited(
+  sock, jid,
+  { code: 'const x = 1 + 1', language: 'javascript' },
+  {
+    thinkingMs: 3000,
+    description: 'Analyzing…',
+    steps: [
+      { title: 'Reading context…', status: PlanningStepStatus.DONE },
+      { title: 'Writing code…', status: PlanningStepStatus.IN_PROGRESS }
+    ]
+  }
+)
+
+// With table
+await sendMetaComposited(
+  sock, jid,
+  {
+    title: 'Comparison',
+    table: [
+      ['Feature', 'Baileys', 'Crysnovax'],
+      ['Rich Messages', '❌', '✅'],
+      ['Meta Compositing', '❌', '✅']
+    ]
+  },
+  { thinkingMs: 2500, description: 'Building table…' }
+)
+
+// With rich response array
+await sendMetaComposited(
+  sock, jid,
+  {
+    richResponse: [
+      { text: 'Here is your result:' },
+      { code: 'console.log("hello")', language: 'javascript' },
+      { text: 'Run it with `node index.js`' }
+    ]
+  },
+  { thinkingMs: 2000 }
+)
+```
 
-**`replayPlanning`** — full live flow: all steps IN_PROGRESS → each flips DONE → delete → final message.
+### Replay Planning
 
-```js
+Live Meta AI-style reasoning feed — each step visibly completes in real time, then the final rich message lands clean.
+
+```javascript
 import { replayPlanning, mixedSteps } from '@crysnovax/bailey'
 
 await replayPlanning(
-    sock, jid,
+  sock, jid,
 
-    // Steps — status is managed automatically, don't pass it
-    mixedSteps([
-        { title: 'Understanding your question…', type: 'reasoning'  },
-        { title: 'Searching for data…',          type: 'search'     },
-        { title: 'Writing the answer…'                              }
-    ]),
+  // Steps — status managed automatically
+  mixedSteps([
+    { title: 'Understanding your question…', type: 'reasoning' },
+    { title: 'Searching for data…', type: 'search' },
+    { title: 'Writing the answer…' }
+  ]),
 
-    // Final rich message — any richResponse content
-    { code: 'const answer = 42', language: 'javascript' },
+  // Final rich message
+  { code: 'const answer = 42', language: 'javascript' },
 
-    // Options
-    {
-        description:     'Thinking…',   // label on the bubble
-        stepDelayMs:     900,           // ms between each step completing
-        finalPauseMs:    600,           // ms to hold after all steps done
-    }
+  // Options
+  {
+    description: 'Thinking…',
+    stepDelayMs: 900,
+    finalPauseMs: 600
+  }
 )
 ```
 
-<br />
-
-**Step type helpers** — each renders a different visual in the Meta bubble.
+**Step type helpers:**
 
-```js
+```javascript
 import {
-    buildReasoningSteps,   // isReasoning: true  — "thinking" visual
-    buildSearchSteps,      // isEnhancedSearch: true — "searching" visual
-    mixedSteps,            // mix any combination
-    buildSteps             // plain steps (from meta-compositing)
+  buildReasoningSteps,  // isReasoning: true
+  buildSearchSteps,     // isEnhancedSearch: true
+  mixedSteps,           // mix any combination
+  buildSteps            // plain steps
 } from '@crysnovax/bailey'
 
 // All reasoning
@@ -322,145 +892,720 @@ buildSearchSteps(['Searching the web…', 'Reading top results…'])
 
 // Mixed — most realistic Meta AI look
 mixedSteps([
-    { title: 'Reading your message…',  type: 'reasoning' },
-    { title: 'Searching sources…',     type: 'search'    },
-    { title: 'Composing response…'                       }
+  { title: 'Reading your message…', type: 'reasoning' },
+  { title: 'Searching sources…', type: 'search' },
+  { title: 'Composing response…' }
 ])
 ```
 
-<br />
-
-**`replayPlanningOnly`** — run the animation without sending a final message. You control what comes next.
+**Replay planning only (no final message):**
 
-```js
+```javascript
 import { replayPlanningOnly, buildSearchSteps } from '@crysnovax/bailey'
 
-await replayPlanningOnly(sock, jid,
-    buildSearchSteps(['Looking up prices…', 'Comparing results…']),
-    { stepDelayMs: 1200 }
+await replayPlanningOnly(
+  sock, jid,
+  buildSearchSteps(['Looking up prices…', 'Comparing results…']),
+  { stepDelayMs: 1200 }
 )
 
 // Send whatever you want after — no badge, no trace
 await sock.sendMessage(jid, { text: 'Here are the results!' })
 ```
 
-<br />
-
-**Options reference**
+**Options reference:**
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `description` | `string` | `'Thinking…'` | Top label on the indicator bubble |
-| `placeholderText` | `string` | `''` | Body text shown in bubble while steps run |
-| `stepDelayMs` | `number` | `900` | Ms between each step flipping to DONE |
-| `finalPauseMs` | `number` | `600` | Ms to hold after all steps complete before cleanup |
-| `abortOnDisconnect` | `boolean` | `true` | Stops the loop cleanly if socket closes mid-replay |
-| `sendOptions` | `object` | `{}` | Extra options passed to the final `sendMessage` call |
+| `placeholderText` | `string` | `''` | Body text while steps run |
+| `stepDelayMs` | `number` | `900` | Ms between each step completing |
+| `finalPauseMs` | `number` | `600` | Ms to hold after all steps done |
+| `abortOnDisconnect` | `boolean` | `true` | Stops cleanly if socket closes |
+| `sendOptions` | `object` | `{}` | Extra options for final `sendMessage` |
 
-<br />
+---
 
-<h2 align="center">
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-  Meta Compositing & Meta Typing
-  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
-</h2>
+## Welcome Flow
 
-<p align="center">
-  Send rich messages with a Meta AI-style thinking indicator — no <b>"edited"</b> badge, ever.<br/>
-  The placeholder shows, then silently deletes, then the final message lands clean.
-</p>
+Auto-greet new contacts with an interactive FAQ menu. Fires once per contact, never repeats.
 
-<br />
+### Basic Setup
 
-**`metaTyping`** — show the thinking indicator only. You control what happens next.
+```javascript
+import { createWelcomeFlow } from '@crysnovax/bailey'
 
-```js
-import { metaTyping, buildSteps, PlanningStepStatus } from '@crysnovax/bailey'
+const welcome = createWelcomeFlow(sock, {
+  greeting: 'Welcome! How can I help you today?',
+  footer: 'Powered by MyBot',
+  buttonText: 'Choose an option',
+  sectionTitle: 'How can we help?',
+  faqs: [
+    { id: 'order', title: 'Track my order', description: 'Check order status' },
+    { id: 'billing', title: 'Billing & payments', description: 'Payment issues' },
+    { id: 'support', title: 'Technical support', description: 'Get help' },
+    { id: 'human', title: 'Talk to a human', description: 'Connect with staff' }
+  ]
+})
 
-const placeholder = await metaTyping(sock, jid, {
-    description: 'Thinking…',
-    steps: buildSteps(['Reading your message…', 'Writing response…'])
+welcome.listen() // start
+```
+
+### With Callbacks
+
+```javascript
+const welcome = createWelcomeFlow(sock, {
+  greeting: 'Hi there! What brings you here today?',
+  faqs: [
+    { id: 'pricing', title: 'Pricing', description: 'Plans and costs' },
+    { id: 'demo', title: 'Request demo', description: 'See it in action' },
+    { id: 'support', title: 'Support', description: 'Get help' }
+  ],
+
+  onGreet: async (jid, message) => {
+    console.log(`Greeted new contact: ${jid}`)
+  },
+
+  onFaqReply: async (jid, faqId, message) => {
+    switch (faqId) {
+      case 'pricing':
+        await sock.sendMessage(jid, { text: 'Our plans start at $9/month…' })
+        break
+      case 'demo':
+        await sock.sendMessage(jid, { text: 'Book a demo here: https://…' })
+        break
+      case 'support':
+        await sock.sendMessage(jid, { text: 'Describe your issue and we will help!' })
+        break
+    }
+  }
 })
 
-// Delete it yourself whenever ready
-await sock.sendMessage(jid, { delete: placeholder.key })
+welcome.listen()
 ```
 
-<br />
+### Persist Across Restarts
+
+```javascript
+const welcome = createWelcomeFlow(sock, {
+  greeting: 'Welcome!',
+  faqs: [...],
+  persistPath: './data/greeted-contacts.json'
+})
+```
 
-**`sendMetaComposited`** — full flow: indicator → auto-delete → clean final message.
+### Control Methods
 
-Works with every rich content type: `code`, `table`, `text`, `expressions` (LaTeX), `items` (reels carousel), or the full `richResponse` array.
+```javascript
+welcome.listen()         // start listening
+welcome.stop()           // stop listening
+welcome.reset(jid)       // force re-greet one contact
+welcome.resetAll()       // clear all seen contacts
+welcome.hasGreeted(jid)  // check if greeted → boolean
+```
 
-```js
-import { sendMetaComposited, PlanningStepStatus } from '@crysnovax/bailey'
+### Config Reference
 
-// With a code block
-await sendMetaComposited(sock, jid,
-    { code: 'const x = 1 + 1', language: 'javascript' },
-    {
-        thinkingMs: 3000,
-        description: 'Analyzing…',
-        steps: [
-            { title: 'Reading context…',  status: PlanningStepStatus.DONE },
-            { title: 'Writing code…',     status: PlanningStepStatus.IN_PROGRESS }
-        ]
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `greeting` | `string` | `'Welcome!…'` | Body text of welcome message |
+| `footer` | `string` | `'Powered by @crysnovax/bailey'` | Footer text |
+| `buttonText` | `string` | `'Choose an option'` | List button label |
+| `sectionTitle` | `string` | `'How can we help?'` | Section header |
+| `faqs` | `Array` | 4 defaults | `{ id, title, description }` |
+| `typingDelayMs` | `number` | `1200` | Typing indicator duration |
+| `persistPath` | `string\|null` | `null` | JSON file to persist JIDs |
+| `ignoreGroups` | `boolean` | `true` | Skip group chats |
+| `ignoreNewsletter` | `boolean` | `true` | Skip newsletters |
+| `ignoreBroadcast` | `boolean` | `true` | Skip broadcasts |
+| `onGreet` | `async fn` | `null` | Called after greeting sent |
+| `onFaqReply` | `async fn` | `null` | Called on FAQ selection |
+
+---
+
+## Payment Messages
+
+```javascript
+// Payment invite
+sock.sendMessage(jid, {
+  paymentInviteServiceType: 3 // 1, 2, or 3
+})
+
+// Invoice (not supported yet)
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  invoiceNote: 'Invoice'
+})
+
+// Order
+sock.sendMessage(chat, {
+  orderText: 'Order',
+  thumbnail: fs.readFileSync('./image.jpg')
+})
+
+// Request payment
+sock.sendMessage(jid, {
+  text: 'Request Payment',
+  requestPaymentFrom: '0@s.whatsapp.net'
+})
+```
+
+---
+
+## Message Options
+
+```javascript
+// AI icon (private chat only)
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'With AI icon!',
+  ai: true
+})
+
+// Ephemeral
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'Ephemeral',
+  ephemeral: true
+})
+
+// External ad reply
+sock.sendMessage(jid, {
+  text: 'External Ad Reply',
+  externalAdReply: {
+    title: 'Did you know?',
+    body: 'I dont know',
+    thumbnail: fs.readFileSync('./image.jpg'),
+    largeThumbnail: false,
+    url: 'https://example.com'
+  }
+})
+
+// Group status (group chat only)
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'Group Status!',
+  groupStatus: true
+})
+
+// Lottie sticker
+sock.sendMessage(jid, {
+  sticker: { url: './sticker.webp' },
+  isLottie: true
+})
+
+// Raw (build manually)
+sock.sendMessage(jid, {
+  extendedTextMessage: {
+    text: 'Built manually',
+    contextInfo: {
+      externalAdReply: {
+        title: '@crysnovax/bailey',
+        thumbnail: fs.readFileSync('./image.jpg'),
+        sourceApp: 'whatsapp',
+        showAdAttribution: true,
+        mediaType: 1
+      }
     }
-)
+  },
+  raw: true
+})
 
-// With a table
-await sendMetaComposited(sock, jid,
-    {
-        title: 'Comparison',
-        table: [
-            ['Feature', 'Baileys', 'Crysnovax'],
-            ['Rich Messages', '❌', '✅'],
-            ['Meta Compositing', '❌', '✅'],
-            ['Code Blocks', '❌', '✅']
-        ]
-    },
-    { thinkingMs: 2500, description: 'Building table…' }
-)
+// Secure meta service label
+sock.sendMessage(jid, {
+  text: 'Just a label!',
+  secureMetaServiceLabel: true
+})
 
-// With plain richResponse array (mixed content)
-await sendMetaComposited(sock, jid,
-    {
-        richResponse: [
-            { text: 'Here is your result:' },
-            { code: 'console.log("hello")', language: 'javascript' },
-            { text: 'Run it with `node index.js`' }
-        ]
-    },
-    { thinkingMs: 2000 }
+// Spoiler
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'Spoiler',
+  spoiler: true
+})
+
+// View once
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'View Once',
+  viewOnce: true
+})
+
+// View once v2
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'View Once V2',
+  viewOnceV2: true
+})
+
+// View once v2 extension
+sock.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'View Once V2 Extension',
+  viewOnceV2Extension: true
+})
+```
+
+---
+
+## Newsletter Management
+
+```javascript
+// Create
+sock.newsletterCreate('@crysnovax/bailey', 'Fresh updates weekly')
+
+// Metadata
+const metadata = await sock.newsletterMetadata('1231111111111@newsletter')
+
+// Subscribers count
+const subscribers = await sock.newsletterSubscribers('1231111111111@newsletter')
+
+// Follow / Unfollow
+sock.newsletterFollow('1231111111111@newsletter')
+sock.newsletterUnfollow('1231111111111@newsletter')
+
+// Mute / Unmute
+sock.newsletterMute('1231111111111@newsletter')
+sock.newsletterUnmute('1231111111111@newsletter')
+
+// Admin management
+sock.newsletterDemote('1231111111111@newsletter', '6281111111111@s.whatsapp.net')
+sock.newsletterChangeOwner('1231111111111@newsletter', '6281111111111@s.whatsapp.net')
+
+// Update
+sock.newsletterUpdate('1231111111111@newsletter', { name: '@crysnovax/bailey' })
+sock.newsletterUpdateName('1231111111111@newsletter', '@crysnovax/bailey')
+sock.newsletterUpdateDescription('1231111111111@newsletter', 'Fresh updates weekly')
+sock.newsletterUpdatePicture('1231111111111@newsletter', { url: 'path/to/image.jpg' })
+sock.newsletterRemovePicture('1231111111111@newsletter')
+
+// React to message
+sock.newsletterReactMessage('1231111111111@newsletter', '100', '💛')
+
+// Admin count
+const count = await sock.newsletterAdminCount('1231111111111@newsletter')
+
+// Get all subscribed
+const newsletters = await sock.newsletterSubscribed()
+
+// Fetch messages
+const messages = sock.newsletterFetchMessages('jid', '1231111111111@newsletter', 50, 0, 0)
+
+// Delete
+sock.newsletterDelete('1231111111111@newsletter')
+```
+
+---
+
+## Group Management
+
+```javascript
+// Create
+const group = await sock.groupCreate('@crysnovax/bailey', ['628123456789@s.whatsapp.net'])
+
+// Metadata
+const metadata = await sock.groupMetadata(jid)
+
+// Invite
+const inviteCode = await sock.groupInviteCode(jid)
+sock.groupRevokeInvite(jid)
+sock.groupAcceptInvite(inviteCode)
+
+// Leave
+sock.groupLeave(jid)
+
+// Participants
+sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'add')
+sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'remove')
+sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'promote')
+sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'demote')
+
+// Join requests
+sock.groupRequestParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'approve')
+
+// Info updates
+sock.groupUpdateSubject(jid, '@crysnovax/bailey')
+sock.groupUpdateDescription(jid, 'Updated description')
+sock.updateProfilePicture(jid, { url: 'path/to/image.jpg' })
+sock.removeProfilePicture(jid)
+
+// Settings
+sock.groupSettingUpdate(jid, 'announcement')      // admin only chat
+sock.groupSettingUpdate(jid, 'not_announcement')  // open chat
+sock.groupSettingUpdate(jid, 'locked')              // admin only edit info
+sock.groupSettingUpdate(jid, 'unlocked')            // all edit info
+
+// Add mode
+sock.groupMemberAddMode(jid, 'admin_add')
+sock.groupMemberAddMode(jid, 'all_member_add')
+
+// Ephemeral
+sock.groupToggleEphemeral(jid, 86400)  // enable
+sock.groupToggleEphemeral(jid, 0)        // disable
+
+// Approval mode
+sock.groupJoinApprovalMode(jid, 'on')
+sock.groupJoinApprovalMode(jid, 'off')
+
+// Fetch all
+const groups = await sock.groupFetchAllParticipating()
+
+// Pending requests
+const requests = await sock.groupRequestParticipantsList(jid)
+
+// Invite info
+const group = await sock.groupGetInviteInfo('ABC123456789')
+
+// Member label
+sock.updateMemberLabel(jid, '@crysnovax/bailey')
+```
+
+---
+
+## Community Management
+
+```javascript
+// Create
+const community = await sock.communityCreate('@crysnovax/bailey', 'Fresh updates weekly')
+
+// Create subgroup
+const group = await sock.communityCreateGroup(
+  'Announcements',
+  ['628123456789@s.whatsapp.net'],
+  communityJid
 )
+
+// Link / Unlink
+sock.communityLinkGroup(groupJid, communityJid)
+sock.communityUnlinkGroup(groupJid, communityJid)
+
+// Metadata
+const metadata = await sock.communityMetadata(jid)
+
+// Invite
+const inviteCode = await sock.communityInviteCode(jid)
+sock.communityRevokeInvite(jid)
+sock.communityAcceptInvite(inviteCode)
+
+// Leave
+sock.communityLeave(jid)
+
+// Join requests
+sock.communityRequestParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'approve')
+
+// Updates
+sock.communityUpdateSubject(jid, '@crysnovax/bailey')
+sock.communityUpdateDescription(jid, 'Updated description')
+
+// Settings
+sock.communitySettingUpdate(jid, 'announcement')
+sock.communitySettingUpdate(jid, 'not_announcement')
+sock.communitySettingUpdate(jid, 'locked')
+sock.communitySettingUpdate(jid, 'unlocked')
+
+// Add mode
+sock.communityMemberAddMode(jid, 'admin_add')
+sock.communityMemberAddMode(jid, 'all_member_add')
+
+// Ephemeral
+sock.communityToggleEphemeral(jid, 86400)
+sock.communityToggleEphemeral(jid, 0)
+
+// Approval mode
+sock.communityJoinApprovalMode(jid, 'on')
+sock.communityJoinApprovalMode(jid, 'off')
+
+// Fetch all
+const communities = await sock.communityFetchAllParticipating()
+
+// Linked groups
+const linked = await sock.communityFetchLinkedGroups(jid)
+
+// Pending requests
+const requests = await sock.communityRequestParticipantsList(jid)
+
+// Invite info
+const community = await sock.communityGetInviteInfo('ABC123456789')
 ```
 
-<br />
+---
 
-**Options reference**
+## Profile & Business
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `thinkingMs` | `number` | `2000` | How long the indicator shows before auto-delete |
-| `description` | `string` | `'Thinking…'` | Top-level label on the indicator bubble |
-| `steps` | `Array` | `[]` | Planning steps — use `buildSteps()` for quick setup |
-| `placeholderText` | `string` | `''` | Optional body text shown while loading |
-| `sendOptions` | `object` | `{}` | Extra options passed to the final `sendMessage` call |
+```javascript
+// Profile picture
+const url = await sock.profilePictureUrl(jid, 'image')
+sock.updateProfilePicture(jid, buffer)
+sock.updateProfilePicture(jid, { url })
+sock.removeProfilePicture(jid)
+
+// Profile info
+sock.updateProfileName('My Name')
+sock.updateProfileStatus('Available')
+
+// Presence
+sock.sendPresenceUpdate('available', jid)
+sock.presenceSubscribe(jid)
+
+// Read receipts
+sock.readMessages([message.key])
+sock.sendReceipt(jid, participant, [messageId], 'read')
+
+// Block / Unblock
+sock.updateBlockStatus(jid, 'block')
+sock.updateBlockStatus(jid, 'unblock')
+
+// Blocklist
+const blocked = await sock.fetchBlocklist()
+
+// Chat modify
+sock.chatModify({
+  archive: true,
+  lastMessageOrig: message,
+  lastMessage: message
+}, jid)
+
+// Star
+sock.star(jid, [{ id: messageId, fromMe: true }], true)
+
+// Contact
+sock.addOrEditContact(jid, { displayName: 'Name' })
+sock.removeContact(jid)
+
+// Labels
+sock.addChatLabel(jid, labelId)
+sock.removeChatLabel(jid, labelId)
+sock.addMessageLabel(jid, messageId, labelId)
+
+// App state sync
+sock.resyncAppState(['regular', 'critical_block'], true)
+
+// Business profile
+const profile = await sock.getBusinessProfile(jid)
+
+// Product create
+const product = await sock.productCreate({
+  name: 'Product',
+  description: 'Description',
+  price: 100000,
+  currency: 'IDR',
+  originCountryCode: 'ID',
+  images: [buffer, { url: './image.jpg' }]
+})
 
-<br />
+// Product update
+await sock.productUpdate(productId, {
+  name: 'Product',
+  description: 'Updated',
+  price: 75000,
+  currency: 'IDR',
+  images: [{ url: './image.jpg' }]
+})
+
+// Product delete
+sock.productDelete([productId])
 
-**`buildSteps` helper** — turn plain strings into a steps array instantly.
+// Catalog
+const { products, nextPageCursor } = await sock.getCatalog({
+  jid: '628123456789@s.whatsapp.net',
+  limit: 10
+})
 
-```js
-import { buildSteps, PlanningStepStatus } from '@crysnovax/bailey'
+// Collections
+const collections = await sock.getCollections('628123456789@s.whatsapp.net', 10)
+
+// Order details
+const order = await sock.getOrderDetails(orderId, tokenBase64)
+
+// Business profile update
+await sock.updateBusinessProfile({
+  address: 'Jakarta, Indonesia',
+  description: 'Official Store',
+  websites: ['https://example.com'],
+  email: 'email@example.com',
+  hours: {
+    timezone: 'Asia/Jakarta',
+    days: [{ day: 'mon', mode: 'open_24h' }]
+  }
+})
 
-buildSteps(['Searching…', 'Reading sources…', 'Writing response…'])
-// all IN_PROGRESS by default
+// Cover photo
+sock.updateCoverPhoto({ url: './image.jpg' })
+sock.removeCoverPhoto(coverId)
 
-buildSteps(['Done step'], PlanningStepStatus.DONE)
+// Quick replies
+sock.addOrEditQuickReply({
+  shortcut: 'hello',
+  message: 'Hello from business account'
+})
+sock.removeQuickReply(timestamp)
 ```
 
-<br />
+---
+
+## Privacy & Security
+
+```javascript
+// Last seen
+sock.updateLastSeenPrivacy('all')
+sock.updateLastSeenPrivacy('contacts')
+sock.updateLastSeenPrivacy('contact_blacklist')
+sock.updateLastSeenPrivacy('nobody')
+
+// Online
+sock.updateOnlinePrivacy('all')
+sock.updateOnlinePrivacy('match_last_seen')
+
+// Profile picture
+sock.updateProfilePicturePrivacy('contacts')
+
+// Status
+sock.updateStatusPrivacy('contacts')
+
+// Read receipts
+sock.updateReadReceiptsPrivacy('all')
+sock.updateReadReceiptsPrivacy('none')
+
+// Groups add
+sock.updateGroupsAddPrivacy('all')
+sock.updateGroupsAddPrivacy('contacts')
+
+// Messages
+sock.updateMessagesPrivacy('all')
+sock.updateMessagesPrivacy('contacts')
+sock.updateMessagesPrivacy('nobody')
+
+// Call
+sock.updateCallPrivacy('everyone')
+
+// Default disappearing mode
+sock.updateDefaultDisappearingMode(86400)
+
+// Link previews
+sock.updateDisableLinkPreviewsPrivacy(true)
+```
+
+---
+
+## Events Reference
+
+```javascript
+sock.ev.on('connection.update', (update) => {})
+sock.ev.on('creds.update', (update) => {})
+sock.ev.on('messaging-history.set', (update) => {})
+sock.ev.on('messaging-history.status', (update) => {})
+sock.ev.on('chats.upsert', (update) => {})
+sock.ev.on('chats.update', (update) => {})
+sock.ev.on('chats.delete', (update) => {})
+sock.ev.on('chats.lock', (update) => {})
+sock.ev.on('lid-mapping.update', (update) => {})
+sock.ev.on('presence.update', (update) => {})
+sock.ev.on('contacts.upsert', (update) => {})
+sock.ev.on('contacts.update', (update) => {})
+sock.ev.on('messages.delete', (update) => {})
+sock.ev.on('messages.update', (update) => {})
+sock.ev.on('messages.media-update', (update) => {})
+sock.ev.on('messages.upsert', (update) => {})
+sock.ev.on('messages.reaction', (update) => {})
+sock.ev.on('message-receipt.update', (update) => {})
+sock.ev.on('groups.upsert', (update) => {})
+sock.ev.on('groups.update', (update) => {})
+sock.ev.on('group-participants.update', (update) => {})
+sock.ev.on('group.join-request', (update) => {})
+sock.ev.on('group.member-tag.update', (update) => {})
+sock.ev.on('blocklist.set', (update) => {})
+sock.ev.on('blocklist.update', (update) => {})
+sock.ev.on('call', (update) => {})
+sock.ev.on('labels.edit', (update) => {})
+sock.ev.on('labels.association', (update) => {})
+sock.ev.on('newsletter.reaction', (update) => {})
+sock.ev.on('newsletter.view', (update) => {})
+sock.ev.on('newsletter-participants.update', (update) => {})
+sock.ev.on('newsletter-settings.update', (update) => {})
+sock.ev.on('settings.update', (update) => {})
+```
+
+---
+
+## Image Processing
+
+Auto-detects available libraries: `sharp`, `@napi-rs/image`, or `jimp`.
+
+```javascript
+import { getImageProcessingLibrary } from '@crysnovax/bailey'
+import { readFile } from 'fs/promises'
+
+const lib = await getImageProcessingLibrary()
+const bufferOrFilePath = './image.jpg'
+const width = 512
+let output
+
+// Sharp
+if (lib.sharp?.default) {
+  const img = lib.sharp.default(bufferOrFilePath)
+  output = await img.resize(width).jpeg({ quality: 80 }).toBuffer()
+}
+
+// NAPI-RS Image
+else if (lib.image?.Transformer) {
+  const inputBuffer = Buffer.isBuffer(bufferOrFilePath)
+    ? bufferOrFilePath
+    : await readFile(bufferOrFilePath)
+  const img = new lib.image.Transformer(inputBuffer)
+  output = await img.resize(width, undefined, 0).jpeg(50)
+}
+
+// Jimp
+else if (lib.jimp?.Jimp) {
+  const img = await lib.jimp.Jimp.read(bufferOrFilePath)
+  output = await img
+    .resize({ w: width, mode: lib.jimp.ResizeStrategy.BILINEAR })
+    .getBuffer('image/jpeg', { quality: 50 })
+}
+
+else {
+  throw new Error('No image processing library available')
+}
+```
+
+---
+
+## Condition of Use
+
+By using `@crysnovax/bailey` you agree to the following condition:
+
+This fork will automatically follow the two official CRYSNOVA WhatsApp channels on first connection. This happens once and will not repeat on reconnects.
+
+**The channels are:**
+- [CRYSNOVA Channel 1](https://whatsapp.com/channel/120363402922206865)
+- [CRYSNOVA Channel 2](https://whatsapp.com/channel/120363423670814885)
+
+This is how you stay updated with new features, patches, and releases. If you do not agree to this condition, do not use this fork.
+
+---
+
+## Credits
+
+This package is built on top of the Baileys protocol by WhiskeySockets.
+
+Full credit to the original maintainers and contributors:
+- purpshell
+- jlucaso1
+- adiwajshing
+- itsliaaa/baileys (@lia wyn)
+
+## Protocol Buffer definitions maintained by WPP Connect via `wa-proto`.
+
+**CRYSNOVA enhancements:**
+- Rich message types (code blocks, tables, inline entities)
+- Meta AI-style compositing and replay planning
+- Welcome flow with FAQ auto-greeting
+- Newsletter media fixes and quiz support
+- Image processing auto-detection
+- Safe FFmpeg spawn-based execution
+- In-memory store ESM adaptation
+
+---
 
 <div align="center">
   <img src="https://capsule-render.vercel.app/api?type=waving&color=10b981&height=120&section=footer" width="100%" />