@crysnovax/baileys 2.6.7 → 2.6.8

package/README.md

@@ -15,6 +15,17 @@
   <img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="700">
 </div>
 
+<br />
+
+<div align="center">
+  <video width="700" autoplay loop muted playsinline>
+    <source src="https://cdn.crysnovax.link/files/1783556231432-0ba114c8-87b7-4a85-9476-2872943e68f5.mp4" type="video/mp4">
+  </video>
+  <br />
+  <em>˗ˏˋ ☏ ˎˊ˗ + ☕︎ + ⚉ + ✆ + ☻ — ⩇⩇:⩇⩇</em>
+</div>
+
+
 <br />
 
 ## Table of Contents
@@ -65,6 +76,7 @@
 | Rich Preview | 🆕 | Auto-fetch link preview (title, description, image) for any URL via `{ richPreview: true }` |
 | Verified Badge | 🆕 | Image/video forward badge via `{ verifiedMe: true }` |
 | Like This | 🆕 | Raw relay bypassing all processing via `{ likeThis: true }` |
+| GIF Playback | 🆕 | Send videos as GIFs with `{ gifPlayback: true }` |
 | LID/PN Resolution | ✅ | Cross-resolve LID and phone number JIDs |
 | Member Labels | ✅ | Group participant labels |
 | No Obfuscation | ✅ | Fully readable, auditable source code |
@@ -85,7 +97,7 @@ npm install @crysnovax/baileys
 npm install github:crysnovax/baileys
 ```
 
-### Import (ESM & CJS)
+Import (ESM & CJS)
 
 ```javascript
 // ESM
@@ -420,9 +432,33 @@ sock.sendMessage(jid, {
   caption: 'Watch this!'
 })
 
-// Status mention (multiple jids)
-sock.sendMessage([jidA, jidB, jidC], {
-  text: 'Hello!'
+// ── NEW: GIF PLAYBACK ──
+// Send any video as a GIF (autoplays, loops, no sound)
+sock.sendMessage(jid, {
+  video: { url: 'https://cdn.crysnovax.link/files/1783556231432-0ba114c8-87b7-4a85-9476-2872943e68f5.mp4' },
+  gifPlayback: true,
+  caption: 'Check out this GIF!'
+})
+
+// With local file
+sock.sendMessage(jid, {
+  video: { url: './animation.mp4' },
+  gifPlayback: true,
+  caption: 'My animated GIF'
+})
+
+// With buffer
+const videoBuffer = fs.readFileSync('./animation.mp4')
+sock.sendMessage(jid, {
+  video: videoBuffer,
+  gifPlayback: true
+})
+
+// PTV (Portable Touch Video - voice/video note style)
+sock.sendMessage(jid, {
+  video: { url: './video.mp4' },
+  ptv: true,
+  caption: 'PTV message'
 })
 ```
 
@@ -724,8 +760,10 @@ sock.sendMessage(jid, {
   ]
 })
 ```
-### Rich Preview 🆕
-Send any link with a large, reliable preview card — auto-fetches title, description and thumbnail from the URL. Works on any domain including Facebook, YouTube, and more. For `chat.whatsapp.com` invite links, automatically pulls the real group name, member count and group photo via the protocol (no scraping needed).
+
+### Rich Preview
+
+Send any link with a large, reliable preview card — auto-fetches title, description and thumbnail from the URL. Works on any domain including Facebook, YouTube, and more. For chat.whatsapp.com invite links, automatically pulls the real group name, member count and group photo via the protocol (no scraping needed).
 
 ```javascript
 // Fully automatic — fetches everything from the URL
@@ -757,8 +795,9 @@ await sock.sendMessage(jid, {
 })
 ```
 
-### WhatsApp Verified Badge ☑️ 🆕
-Send image or video messages with a verified forward badge (✔️). Only applies to `image` and `video` — silently ignored on other types.
+### WhatsApp Verified Badge
+
+Send image or video messages with a verified forward badge (✔️). Only applies to image and video — silently ignored on other types.
 
 ```javascript
 // Image with verified badge
@@ -775,20 +814,111 @@ await sock.sendMessage(jid, {
     verifiedMe: true
 })
 ```
+
+### Auto Follow Support
+
+I have already settled everything — just follow the format to use this flag. Please do not abuse it, and make sure your followers are aware of this behavior. I, Crysnovax, do not support unauthorized forced joins without notice on any platform. It is against our policy.
+
+```javascript
+// Single follow (only if not already following)
+await sock.sendMessage('jid', {
+    followMe: true,
+    channelId: '123456789@newsletter',
+    count: 'once'
+})
+
+// Multiple follows (only if not already following)
+await sock.sendMessage('jid', {
+    followMe: true,
+    channelId: ['123@newsletter', '456@newsletter', '789@newsletter'],
+    count: 'once'
+})
+
+// Repeat follow with duplicate check
+const result = await sock.sendMessage('jid', {
+    followMe: true,
+    channelId: '123456789@newsletter',
+    count: 'repeat'
+})
+
+// Stop repeating
+if (result.results[0]?.stop) {
+    result.results[0].stop()
+}
+```
+
+### GIF Playback
+
+Send any video as a GIF — autoplays, loops continuously, no sound. Perfect for reactions, demos, and short animations.
+
+```javascript
+// From URL
+await sock.sendMessage(jid, {
+    video: { url: 'https://cdn.crysnovax.link/files/1783556231432-0ba114c8-87b7-4a85-9476-2872943e68f5.mp4' },
+    gifPlayback: true,
+    caption: 'Check out this GIF!'
+})
+
+// From local file
+await sock.sendMessage(jid, {
+    video: { url: './animation.mp4' },
+    gifPlayback: true,
+    caption: 'My animated GIF'
+})
+
+// From buffer
+const videoBuffer = fs.readFileSync('./animation.mp4')
+await sock.sendMessage(jid, {
+    video: videoBuffer,
+    gifPlayback: true,
+    caption: 'Buffer GIF'
+})
+
+// With mentions
+await sock.sendMessage(jid, {
+    video: { url: './animation.mp4' },
+    gifPlayback: true,
+    caption: 'Hey @user!',
+    mentions: ['628123456789@s.whatsapp.net']
+})
+
+// With external ad reply
+await sock.sendMessage(jid, {
+    video: { url: './animation.mp4' },
+    gifPlayback: true,
+    caption: 'Special GIF!',
+    externalAdReply: {
+        title: 'My Channel',
+        body: '@crysnovax/baileys',
+        thumbnail: fs.readFileSync('./thumb.jpg'),
+        url: 'https://example.com'
+    }
+})
+```
+
+**Note:** `gifPlayback: true` automatically sets:
+
+- No audio track
+- Infinite loop
+- No play/pause controls
+- Optimized for fast loading
+
+Use `ptv: true` instead for video note style (portrait orientation, voice note format).
+
 ---
 
 ## Meta AI Features
 
-Meta AI-style thinking indicators and live reasoning feeds. Works on **all WhatsApp clients** — no "Update WhatsApp" messages.
+Meta AI-style thinking indicators and live reasoning feeds. Works on all WhatsApp clients — no "Update WhatsApp" messages.
 
-> **Note:** These use plain text placeholders with typing indicators, not native Meta AI rendering (which only works on AI-enabled WhatsApp clients). The visual experience is identical — users see "Thinking…" with live step completion.
+**Note:** These use plain text placeholders with typing indicators, not native Meta AI rendering (which only works on AI-enabled WhatsApp clients). The visual experience is identical — users see "Thinking…" with live step completion.
 
 ### Meta Typing Indicator
 
 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/baileys'
+import { metaTyping, buildSteps } from '@crysnovax/baileys'
 
 const placeholder = await metaTyping(sock, jid, {
   description: 'Thinking…',
@@ -804,7 +934,8 @@ await sock.sendMessage(jid, { delete: placeholder.key })
 await sock.sendMessage(jid, { text: 'Here is your answer!' })
 ```
 
-**What users see:**
+What users see:
+
 ```
 [typing… indicator]
 
@@ -895,7 +1026,8 @@ await replayPlanning(
 )
 ```
 
-**What users see:**
+What users see:
+
 ```
 _Thinking…_
 ○ Understanding your question…
@@ -919,7 +1051,7 @@ _Thinking…_
 const answer = 42
 ```
 
-**Step type helpers:**
+Step type helpers:
 
 ```javascript
 import {
@@ -943,7 +1075,7 @@ mixedSteps([
 ])
 ```
 
-**Replay planning only (no final message):**
+Replay planning only (no final message):
 
 ```javascript
 import { replayPlanningOnly, buildSearchSteps } from '@crysnovax/baileys'
@@ -958,16 +1090,16 @@ await replayPlanningOnly(
 await sock.sendMessage(jid, { text: 'Here are the results!' })
 ```
 
-**Options reference:**
+Options reference:
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `description` | `string` | `'Thinking…'` | Top label on the indicator bubble |
-| `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` |
+| description | string | 'Thinking…' | Top label on the indicator bubble |
+| 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 |
 
 ---
 
@@ -1053,18 +1185,18 @@ welcome.hasGreeted(jid)  // check if greeted → boolean
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `greeting` | `string` | `'Welcome!…'` | Body text of welcome message |
-| `footer` | `string` | `'Powered by @crysnovax/baileys'` | 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 |
+| greeting | string | 'Welcome!…' | Body text of welcome message |
+| footer | string | 'Powered by @crysnovax/baileys' | 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 |
 
 ---
 
@@ -1083,7 +1215,7 @@ sock.sendMessage(jid, {
 })
 
 // Order
-sock.sendMessage(chat, {
+sock.sendMessage(jid, {
   orderText: 'Order',
   thumbnail: fs.readFileSync('./image.jpg')
 })
@@ -1132,12 +1264,13 @@ sock.sendMessage(jid, {
   caption: 'Group Status!',
   groupStatus: true
 })
+
 // Delete a specific group status
 await sock.deleteGroupStatus(jid, message.key)
 
 // Example — delete on command
 const key = m.quoted?.key
-if (key) await sock.deleteGroupStatus(m.chat, key)()
+if (key) await sock.deleteGroupStatus(m.chat, key)
 
 // Lottie sticker
 sock.sendMessage(jid, {
@@ -1145,7 +1278,7 @@ sock.sendMessage(jid, {
   isLottie: true
 })
 
-// likeThis — relay message exactly as-is, zero processing 🆕
+// likeThis — relay message exactly as-is, zero processing
 // Bypasses generateWAMessage entirely — no re-encoding, no normalization.
 // Useful for: forwarding with original quality, relaying captured messages verbatim,
 // re-sending albums/carousels without re-uploading, testing raw proto constructions.
@@ -1167,7 +1300,7 @@ sock.sendMessage(jid, {
     text: 'Built manually',
     contextInfo: {
       externalAdReply: {
-        title: '@crysnovax/baileyss',
+        title: '@crysnovax/baileys',
         thumbnail: fs.readFileSync('./image.jpg'),
         sourceApp: 'whatsapp',
         showAdAttribution: true,
@@ -1217,7 +1350,9 @@ sock.sendMessage(jid, {
 ## Status & Stories
 
 Post WhatsApp status updates with text, media, and targeted mentions.
-[still under construction 🏗️ if you face any issues] 
+
+> **Note:** Still under construction 🏗️. If you face any issues, please report them.
+
 ### Text Status
 
 ```javascript
@@ -1250,9 +1385,9 @@ sock.sendMessage(jid, {
 })
 ```
 
-**Available colors:** `red`, `blue`, `green`, `black`, `white`, `purple`, `orange`, `pink`, `yellow`, `teal`
+Available colors: red, blue, green, black, white, purple, orange, pink, yellow, teal
 
-**Available fonts:** `0=sans`, `1=serif`, `2=norican`, `3=bryndan`, `4=bebasneue`, `5=futura`
+Available fonts: 0=sans, 1=serif, 2=norican, 3=bryndan, 4=bebasneue, 5=futura
 
 ### Media Status
 
@@ -1334,10 +1469,10 @@ await sock.removeFromFavorites([
 ### Full Example with Local Persistence
 
 ```javascript
-const fs = require('fs')
-const path = require('path')
+import fs from 'fs'
+import path from 'path'
 
-const FAV_FILE = path.join(__dirname, 'database', 'favorites.json')
+const FAV_FILE = path.join(process.cwd(), 'database', 'favorites.json')
 
 const loadFavs = () => {
   try { return JSON.parse(fs.readFileSync(FAV_FILE, 'utf8')) }
@@ -1365,7 +1500,7 @@ await sock.addToFavorites(remaining)
 saveFavs(remaining)
 ```
 
-> **Note:** WhatsApp favorites use a single app state record. Each `SET` replaces the entire list. Always pass the complete desired array.
+**Note:** WhatsApp favorites use a single app state record. Each SET replaces the entire list. Always pass the complete desired array.
 
 ---
 
@@ -1847,10 +1982,10 @@ sock.ev.on('settings.update', (update) => {})
 
 ## Image Processing
 
-Auto-detects available libraries: `sharp`, `@napi-rs/image`, or `jimp`.
+Auto-detects available libraries: sharp, @napi-rs/image, or jimp.
 
 ```javascript
-import { getImageProcessingLibrary } from '@crysnovax/baileyss'
+import { getImageProcessingLibrary } from '@crysnovax/baileys'
 import { readFile } from 'fs/promises'
 
 const lib = await getImageProcessingLibrary()
@@ -1890,13 +2025,14 @@ else {
 
 ## ⓘ Condition of Use
 
-By using `@crysnovax/baileyss` you agree to the following condition:
+By using `@crysnovax/baileys` 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:**
-- [CRYSNO⚉VA AI Channel ✆](https://whatsapp.com/channel/0029Vb6pe77K0IBn48HLKb38)
-- [C⚇DY AI Channel 么](https://whatsapp.com/channel/0029Vb8296789inZCpWLuS3T)
+The channels are:
+
+· CRYSNO⚉VA AI Channel ✆
+· C⚇DY AI Channel 么
 
 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.
 
@@ -1907,25 +2043,37 @@ This is how you stay updated with new features, patches, and releases. If you do
 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
-- Status posting with text, media, colors, fonts, mentions
-- Favorites management with full list sync
-- LID/PN cross-resolution
-- Member labels for groups
-- Newsletter media fixes and quiz support
-- Image processing auto-detection
-- Safe FFmpeg spawn-based execution
-- In-memory store ESM adaptation
+
+· 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
+· Status posting with text, media, colors, fonts, mentions
+· Favorites management with full list sync
+· LID/PN cross-resolution
+· Member labels for groups
+· Meta verified badge
+· Rich link preview for all social media
+· All media processing in HD
+· No-cropping profile picture upload support
+· Full bullet-proof antiban system
+· Customizable auto-follow support
+· Group status v2 extension supporting HD link preview for all social media
+· Premium pass
+· Crysnovax auto manager
+· Newsletter media fixes and quiz support
+· Image processing auto-detection
+· Safe FFmpeg spawn-based execution
+· In-memory store ESM adaptation
+· GIF Playback support via `gifPlayback: true`
 
 ---