fixo-baileys 1.0.4 → 1.0.5

package/README.md

@@ -845,6 +845,46 @@ await sock.sendPlayerCard(jid, {
 
 ---
 
+## 🎠 Carousel Menu (`sendCarouselMenu`)
+
+Swipeable **bot-style menu**: a header text on top and a row of cards you swipe sideways — every card has its own image and command list (e.g. *GROUP MENU*, *SETTINGS MENU*), exactly like the "RCD X MINI" style menus.
+
+```js
+await sock.sendCarouselMenu(jid, {
+  text: 'Good Morning!\n\n👉 Swipe the cards to open a category.',
+  footer: 'MY BOT • FREE CONNECTED',               // default: DEVELOPED BY FIXO DEV ⚡
+  cards: [
+    {
+      image: fs.readFileSync('./group.jpg'),        // Buffer | { url } | 'https://...'
+      title: '👥 GROUP MENU',
+      commands: ['.add', '.admins', '.kick', { cmd: '.kickall', locked: true }]   // locked → adds 🔒
+    },
+    {
+      image: { url: 'https://example.com/settings.jpg' },
+      title: '⚙️ SETTINGS MENU',
+      commands: ['.antidelete', '.autoreadstatus', '.mode'],
+      buttons: [{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Open', id: '.settings' }) }]  // optional
+    }
+  ]
+}, { quoted: msg })
+```
+
+| Option | Description |
+|:---|:---|
+| `text` | Header text shown above the cards |
+| `footer` | Footer text (default `DEVELOPED BY FIXO DEV ⚡`) |
+| `cards[].image` | Card banner image (Buffer, `{ url }` or URL string) |
+| `cards[].title` | Card heading (first line of the card) |
+| `cards[].commands` | Command list; each item is a string or `{ cmd, locked }` |
+| `cards[].text` | Use instead of `commands` to give the card free text |
+| `cards[].buttons` | Optional native-flow buttons for the card |
+
+Helpers `formatCardCommands` and `normaliseCarouselCard` are exported from the package root.
+
+> Works with WhatsApp mobile apps; carousels may not render on WhatsApp Web / Desktop.
+
+---
+
 ## 📢 Auto-Follow Channel
 
 On connect this build automatically follows the official FIXO channel:
@@ -957,6 +997,9 @@ const results = getAggregatePollVotes(sock, pollMessage)
 
 ## 🆕 Changelog
 
+### v1.0.6
+- ➕ **`sock.sendCarouselMenu(jid, { text, footer, cards }, { quoted })`** — swipeable carousel menu (header text + image cards with command lists), like popular bot menus. New file `lib/Utils/carousel-menu.js`.
+
 ### v1.0.5
 - 🐞 Fixed pairing-code linking: the default code `FIXOMODZ` contained letters outside the WhatsApp code alphabet (I, O). Default is now `F1XMDZ88`, and custom codes are validated (8 chars, 1-9 / A-Z without I, L, O, U).
 - ➕ Synced from ZANTA-BAILEYS: **polls** — `sendPoll`, `sendPollVote`, `getAggregatePollVotes` (new `lib/Socket/polls.js`, exported from the package root).

package/lib/Utils/carousel-menu.js

@@ -0,0 +1,28 @@
+/**
+ * Carousel (swipeable cards) menu helpers.
+ *
+ * Builds the WhatsApp `interactiveMessage.carouselMessage` structure used by
+ * `sock.sendCarouselMenu()` — a header text on top and a row of swipeable cards,
+ * every card having its own image + command list (like a "GROUP MENU" / "SETTINGS MENU" bot menu).
+ */
+export const DEFAULT_CAROUSEL_FOOTER = 'DEVELOPED BY FIXO DEV ⚡';
+
+/** "• .add\n• .kick 🔒" – turns ['.add', '.kick 🔒'] (or {cmd, locked}) into the list text shown on a card */
+export const formatCardCommands = (commands = [], bullet = '•') =>
+    commands
+        .map(c => (typeof c === 'string' ? c : `${c.cmd}${c.locked ? ' 🔒' : ''}`))
+        .map(line => `${bullet} ${line}`)
+        .join('\n');
+
+/** Normalises one user card into { title, body, footer, image, buttons } */
+export const normaliseCarouselCard = (card = {}) => {
+    const body = [card.title, card.text ?? (card.commands ? '\n' + formatCardCommands(card.commands) : '')]
+        .filter(v => v !== undefined && v !== '')
+        .join('\n');
+    return {
+        image: card.image,
+        body,
+        footer: card.footer,
+        buttons: card.buttons || []
+    };
+};

package/lib/Utils/index.js

@@ -20,4 +20,5 @@ export * from './companion-reg-client-utils.js';
 export * from './identity-change-handler.js';
 export * from './stanza-ack.js';
 export * from './card-menu.js';
+export * from './carousel-menu.js';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fixo-baileys",
   "type": "module",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "A WebSockets library for interacting with WhatsApp Web",
   "keywords": [
     "whatsapp",