@crysnovax/baileys 1.0.3

package/README.md

@@ -0,0 +1,467 @@
+<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" />
+  About Me
+  <img src="https://media2.giphy.com/media/QssGEmpkyEOhBCb7e1/giphy.gif?cid=ecf05e47a0n3gi1bfqntqmob8g9aid1oyj2wr3ds3mg700bl&rid=giphy.gif" width="28" />
+</h2>
+
+```javascript
+const crysnova = {
+    name: "CRYSNOVA AI",
+    location: "🌍 Global",
+    role: "Full Stack Developer & Bot Creator",
+    stack: ["JavaScript", "Node.js", "Cloudflare Workers", "WhatsApp Bot Development"],
+    interests: ["AI", "Automation", "Open Source", "Building Cool Stuff"],
+    currentFocus: "Building the most powerful WhatsApp bot ecosystem 🚀",
+    funFact: "My code runs 24/7 on Cloudflare's edge network ⚡"
+};
+```
+
+<br />
+
+<h2 align="center">
+  <img src="https://media.giphy.com/media/iY8CRBdQXODJSCERIr/giphy.gif" width="28" />
+  Tech Stack
+  <img src="https://media.giphy.com/media/iY8CRBdQXODJSCERIr/giphy.gif" width="28" />
+</h2>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black&labelColor=0a0f0a&color=10b981" />
+  <img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white&labelColor=0a0f0a&color=10b981" />
+  <img src="https://img.shields.io/badge/Cloudflare-F38020?style=for-the-badge&logo=cloudflare&logoColor=white&labelColor=0a0f0a&color=10b981" />
+  <img src="https://img.shields.io/badge/Workers-F38020?style=for-the-badge&logo=cloudflareworkers&logoColor=white&labelColor=0a0f0a&color=10b981" />
+  <img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white&labelColor=0a0f0a&color=10b981" />
+  <img src="https://img.shields.io/badge/Baileys-25D366?style=for-the-badge&logo=whatsapp&logoColor=white&labelColor=0a0f0a&color=10b981" />
+  <img src="https://img.shields.io/badge/API-FF6F00?style=for-the-badge&logo=fastapi&logoColor=white&labelColor=0a0f0a&color=10b981" />
+  <img src="https://img.shields.io/badge/KV-FF4F00?style=for-the-badge&logo=cloudflare&logoColor=white&labelColor=0a0f0a&color=10b981" />
+</p>
+<br />
+
+<h2 align="center">
+  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
+  Featured Projects
+  <img src="https://media.giphy.com/media/W5eoZHPpUx9sapR0eu/giphy.gif" width="28" />
+</h2>
+
+<div align="center">
+
+| 🚀 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 |
+| **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>
+
+<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>
+</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>
+
+<br />
+
+<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>
+
+<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>
+
+<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>
+
+<br />
+
+<h2 align="center">⚠️ Condition of Use</h2>
+
+<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>
+
+<br />
+
+<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>
+
+<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>
+
+<br />
+
+**Basic setup — drop it in and it works:**
+
+```js
+import { createWelcomeFlow } 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 & invoices' },
+        { id: 'support', title: '🛠️ Technical support',  description: 'Get help with a problem'   },
+        { id: 'human',   title: '📞 Talk to a human',    description: 'Connect with support staff' },
+    ]
+})
+
+welcome.listen() // start
+```
+
+<br />
+
+**Handle FAQ replies + greet callback:**
+
+```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'          },
+    ],
+
+    // Fires after greeting is sent
+    onGreet: async (jid, message) => {
+        console.log(`Greeted new contact: ${jid}`)
+    },
+
+    // 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
+        }
+    }
+})
+
+welcome.listen()
+```
+
+<br />
+
+**Persist seen contacts across restarts:**
+
+```js
+const welcome = createWelcomeFlow(sock, {
+    greeting: '👋 Welcome!',
+    faqs: [...],
+    persistPath: './data/greeted-contacts.json' // saves + loads automatically
+})
+```
+
+<br />
+
+**Control methods:**
+
+```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
+```
+
+<br />
+
+**Full config reference:**
+
+| 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>
+
+<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>
+
+<br />
+
+**`replayPlanning`** — full live flow: all steps IN_PROGRESS → each flips DONE → delete → final message.
+
+```js
+import { replayPlanning, mixedSteps } from '@crysnovax/bailey'
+
+await replayPlanning(
+    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…'                              }
+    ]),
+
+    // Final rich message — any richResponse content
+    { 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
+    }
+)
+```
+
+<br />
+
+**Step type helpers** — each renders a different visual in the Meta bubble.
+
+```js
+import {
+    buildReasoningSteps,   // isReasoning: true  — "thinking" visual
+    buildSearchSteps,      // isEnhancedSearch: true — "searching" visual
+    mixedSteps,            // mix any combination
+    buildSteps             // plain steps (from meta-compositing)
+} from '@crysnovax/bailey'
+
+// All reasoning
+buildReasoningSteps(['Analyzing the problem…', 'Checking edge cases…'])
+
+// All search
+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…'                       }
+])
+```
+
+<br />
+
+**`replayPlanningOnly`** — run the animation without sending a final message. You control what comes next.
+
+```js
+import { replayPlanningOnly, buildSearchSteps } from '@crysnovax/bailey'
+
+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**
+
+| 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 |
+
+<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>
+
+<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>
+
+<br />
+
+**`metaTyping`** — show the thinking indicator only. You control what happens next.
+
+```js
+import { metaTyping, buildSteps, PlanningStepStatus } from '@crysnovax/bailey'
+
+const placeholder = await metaTyping(sock, jid, {
+    description: 'Thinking…',
+    steps: buildSteps(['Reading your message…', 'Writing response…'])
+})
+
+// Delete it yourself whenever ready
+await sock.sendMessage(jid, { delete: placeholder.key })
+```
+
+<br />
+
+**`sendMetaComposited`** — full flow: indicator → auto-delete → clean final message.
+
+Works with every rich content type: `code`, `table`, `text`, `expressions` (LaTeX), `items` (reels carousel), or the full `richResponse` array.
+
+```js
+import { sendMetaComposited, PlanningStepStatus } from '@crysnovax/bailey'
+
+// 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 }
+        ]
+    }
+)
+
+// With a table
+await sendMetaComposited(sock, jid,
+    {
+        title: 'Comparison',
+        table: [
+            ['Feature', 'Baileys', 'Crysnovax'],
+            ['Rich Messages', '❌', '✅'],
+            ['Meta Compositing', '❌', '✅'],
+            ['Code Blocks', '❌', '✅']
+        ]
+    },
+    { thinkingMs: 2500, description: 'Building table…' }
+)
+
+// 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 }
+)
+```
+
+<br />
+
+**Options reference**
+
+| 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 |
+
+<br />
+
+**`buildSteps` helper** — turn plain strings into a steps array instantly.
+
+```js
+import { buildSteps, PlanningStepStatus } from '@crysnovax/bailey'
+
+buildSteps(['Searching…', 'Reading sources…', 'Writing response…'])
+// all IN_PROGRESS by default
+
+buildSteps(['Done step'], PlanningStepStatus.DONE)
+```
+
+<br />
+
+<div align="center">
+  <img src="https://capsule-render.vercel.app/api?type=waving&color=10b981&height=120&section=footer" width="100%" />
+</div>

package/WAProto/V

@@ -0,0 +1 @@
+