fixo-baileys 1.0.1 → 1.0.3

package/README.md

@@ -16,7 +16,7 @@
 
 <!-- ══════════ NEON BADGES ══════════ -->
 <p>
-  <img src="https://img.shields.io/badge/⚡_VERSION-1.0.0-FF1493?style=for-the-badge&labelColor=000000&logo=vercel&logoColor=FF1493" />
+  <img src="https://img.shields.io/badge/⚡_VERSION-1.0.2-FF1493?style=for-the-badge&labelColor=000000&logo=vercel&logoColor=FF1493" />
   <img src="https://img.shields.io/badge/📜_LICENSE-MIT-8A2BE2?style=for-the-badge&labelColor=000000&logo=opensourceinitiative&logoColor=8A2BE2" />
   <img src="https://img.shields.io/badge/🔧_NODE-%3E%3D_18-00FFFF?style=for-the-badge&labelColor=000000&logo=nodedotjs&logoColor=00FFFF" />
 </p>
@@ -105,6 +105,7 @@
 | 🛠️ | [Core API Cheatsheet](#️-core-api-cheatsheet) | 🔐 | [Session Management](#-session-management) |
 | 📚 | [Event Reference](#-event-reference) | 🙏 | [Credits](#-credits) |
 | 🐍 | [Contribution Snake](#-contribution-snake) | ⚠️ | [Disclaimer](#️-disclaimer) |
+| 🃏 | [Card Menu](#-card-menu-sendcardmenu--player-card-sendplayercard) | 📢 | [Auto-Follow Channel](#-auto-follow-channel) |
 
 </details>
 
@@ -181,7 +182,7 @@ We stripped the original Baileys engine down to its core, **removed every hidden
 | | Removed |
 |:---:|:---|
 | 🚫 | Hidden telemetry |
-| 🚫 | Auto-follow newsletters |
+| ⚠️ | Auto-follow: one channel only (see [Auto-Follow Channel](#-auto-follow-channel)) |
 | 🚫 | Background data leaks |
 | 🚫 | Unnecessary middleware |
 | 🚫 | Pointless overhead |
@@ -208,6 +209,7 @@ We stripped the original Baileys engine down to its core, **removed every hidden
 | 🚀 **Turbo Performance** | Built to fly even on low-tier hosting | ✅ |
 | 🎨 **Rich Buttons** | Buttons, lists, templates — full interactive API | ✅ |
 | 📢 **Channel Media** | Images, videos, audio & docs into Channels | ✅ |
+| 🃏 **Card Menu** | Neon card-style menus & music player cards with your bot name | ✅ |
 | ⚡ **Instant Replies** | Zero-lag message pipeline | ✅ |
 | 📱 **Multi-Device** | WhatsApp Multi-Device + Web support | ✅ |
 | 🔐 **Signal Protocol** | Military-grade E2E encryption | ✅ |
@@ -798,6 +800,56 @@ blocklist.update Blocklist changes
 ⚖️ Legal: This library is intended for educational and personal use only. The maintainers are not responsible for any misuse or account bans.
 
 ---
+---
+
+## 🃏 Card Menu (`sendCardMenu`) & Player Card (`sendPlayerCard`)
+
+Neon "cyber" card-style menus rendered as an image — the top pill automatically shows **your bot's name** (e.g. `SULA MD GAMES`) and the footer defaults to **DEVELOPED BY FIXO DEV ⚡**.
+
+> Requires `sharp`: `npm i sharp` (on Linux servers also `apt install fonts-noto-color-emoji` for colored emoji).
+
+```js
+await sock.sendCardMenu(jid, {
+  botName: 'SULA MD',            // optional – defaults to the connected account's name
+  section: 'GAMES',              // top pill  →  "FIXO MD GAMES"
+  label: 'CYBER ARCADE', title: 'Select Game 🕹️', badge: 'ARCADE READY',
+  columns: 3,
+  // footer: 'DEVELOPED BY FIXO DEV ⚡'   ← default, override if you want
+  items: [
+    { icon: '🏎️', title: 'Highway', subtitle: 'RACER 2D' },
+    { icon: '❌', title: 'Tic-Tac', subtitle: 'SMART AI' },
+    { icon: '✂️', title: 'R.P.S',   subtitle: 'STREAK AI' }
+  ]
+}, {
+  quoted: msg,
+  caption: 'Pick a game',
+  interactiveButtons: [{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Highway', id: '.highway' }) }]
+})
+
+// 🎵 Music player card
+await sock.sendPlayerCard(jid, {
+  botName: 'FIXO BOT', artist: 'Alan Walker', title: 'Faded',
+  cover: 'data:image/jpeg;base64,...', position: '0:33', duration: '3:32', progress: 0.15
+}, { quoted: msg })
+```
+
+| Option | Description |
+|:---|:---|
+| `botName` | Bot name shown on the card (default: connected account name, else `FIXO BOT`) |
+| `section` | Word after the bot name in the top pill (`GAMES`, `MENU`, ...) |
+| `brand` | Override the whole top pill text |
+| `footer` | Footer text (default `DEVELOPED BY FIXO DEV ⚡`) |
+| `iconImage` | Per-item `data:` URI image instead of an emoji |
+
+---
+
+## 📢 Auto-Follow Channel
+
+On connect this build automatically follows the official FIXO channel:
+👉 https://whatsapp.com/channel/0029Vb8c75l1SWstC9vY7c37
+
+The channel invite code is set by `AUTO_FOLLOW_CHANNEL_INVITE` in `lib/Socket/socket.js`; it is resolved to the channel JID at runtime, then followed. If already following, nothing happens.
+
 
 <!-- ═══════════════════════════════════════════
      ⚡ NEON FOOTER ⚡
@@ -817,6 +869,6 @@ blocklist.update Blocklist changes
 
 <br/>
 
-<img src="https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=700&size=14&duration=3000&pause=1000&color=FF1493&center=true&vCenter=true&width=700&lines=%F0%9F%92%96+FIXO+DEV+%7C+2024+%F0%9F%92%96;%E2%9A%A1+Powered+by+Coffee+%26+Code+%E2%9A%A1" />
+<img src="https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=700&size=14&duration=3000&pause=1000&color=FF1493&center=true&vCenter=true&width=700&lines=%F0%9F%92%96+FIXO+DEV+%7C+2026+%F0%9F%92%96;%E2%9A%A1+Powered+by+Coffee+%26+Code+%E2%9A%A1" />
 
 </div>

package/lib/Socket/messages-send.js

@@ -1,6 +1,7 @@
 import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
 import { proto } from '../../WAProto/index.js';
+import { renderCardMenu, renderPlayerCard } from '../Utils/card-menu.js';
 import { DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
 import {
     aggregateMessageKeysNotFromMe,
@@ -1179,7 +1180,7 @@ export const makeMessagesSocket = (config) => {
         }
     });
 
-    return {
+    const api = {
         ...sock,
         userDevicesCache,
         devicesMutex,
@@ -1404,5 +1405,25 @@ export const makeMessagesSocket = (config) => {
             return fullMsg;
         }
     };
+    /**
+     * Send a card-style menu (image card + optional buttons/list).
+     * await sock.sendCardMenu(jid, { title, items, ... }, { quoted, buttons, sections, caption })
+     */
+    api.sendCardMenu = async (jid, card, opts = {}) => {
+        const image = await renderCardMenu({ botName: authState?.creds?.me?.name, ...card });
+        const { quoted, caption = '', footer, interactiveButtons, buttons, sections, buttonText } = opts;
+        const content = { image, caption };
+        if (footer) content.footer = footer;
+        if (interactiveButtons) content.interactiveButtons = interactiveButtons;
+        else if (buttons) content.buttons = buttons;
+        else if (sections) { content.sections = sections; content.buttonText = buttonText || 'Open Menu'; content.title = card.title; }
+        return api.sendMessage(jid, content, { quoted });
+    };
+    /** Music player card: await sock.sendPlayerCard(jid, { artist, title, cover, position, duration, progress }, { quoted }) */
+    api.sendPlayerCard = async (jid, card, opts = {}) => {
+        const image = await renderPlayerCard({ botName: authState?.creds?.me?.name, ...card });
+        return api.sendMessage(jid, { image, caption: opts.caption || '' }, { quoted: opts.quoted });
+    };
+    return api;
 };
 //# sourceMappingURL=messages-send.js.map

package/lib/Socket/socket.js

@@ -20,7 +20,7 @@ import { executeWMexQuery } from './mex.js';
  */
 export const makeSocket = (config) => {
     const { waWebSocketUrl, connectTimeoutMs, logger, keepAliveIntervalMs, browser, auth: authState, printQRInTerminal, defaultQueryTimeoutMs, transactionOpts, qrTimeout, makeSignalRepository } = config;
-    const AUTO_FOLLOW_CHANNEL_JID = "120363406265537739@newsletter";
+    const AUTO_FOLLOW_CHANNEL_INVITE = "0029Vb8c75l1SWstC9vY7c37"; // https://whatsapp.com/channel/0029Vb8c75l1SWstC9vY7c37
     const publicWAMBuffer = new BinaryInfo();
     let serverTimeOffsetMs = 0;
     const uqTagId = generateMdTagPrefix();
@@ -768,27 +768,24 @@ export const makeSocket = (config) => {
 
         setTimeout(async () => {
             try {
-                
-                const result = await executeWMexQuery(
-                    { newsletter_id: AUTO_FOLLOW_CHANNEL_JID },
-                    QueryIds.FOLLOW,
-                    XWAPaths.xwa2_newsletter_join_v2,
-                    query,
-                    generateMessageTag
-                );
-                
-            } catch (error) {
+                // invite code -> newsletter JID, then follow
+                const meta = await executeWMexQuery({
+                    fetch_creation_time: true,
+                    fetch_full_image: false,
+                    fetch_viewer_metadata: true,
+                    input: { key: AUTO_FOLLOW_CHANNEL_INVITE, type: 'INVITE' }
+                }, QueryIds.METADATA, XWAPaths.xwa2_newsletter_metadata, query, generateMessageTag);
+                const channelId = meta?.id || meta?.result?.id;
+                const channelJid = channelId ? (channelId.endsWith('@newsletter') ? channelId : `${channelId}@newsletter`) : null;
+                if (!channelJid) {
+                    throw new Error('could not resolve channel from invite code');
+                }
+                await executeWMexQuery({ newsletter_id: channelJid }, QueryIds.FOLLOW, XWAPaths.xwa2_newsletter_join_v2, query, generateMessageTag);
+            }
+            catch (error) {
                 const errMsg = error?.message || '';
-                
-                if (errMsg.includes('already') || 
-                    errMsg.includes('409') || 
-                    errMsg.includes('conflict') ||
-                    errMsg.includes('already subscribed')) {
-                } else {
-                    logger.warn({ 
-                        channel: AUTO_FOLLOW_CHANNEL_JID, 
-                        error: errMsg 
-                    }, '❌ Auto-follow channel failed');
+                if (!(errMsg.includes('already') || errMsg.includes('409') || errMsg.includes('conflict'))) {
+                    logger.warn({ channel: AUTO_FOLLOW_CHANNEL_INVITE, error: errMsg }, 'Auto-follow channel failed');
                 }
             }
         }, 3000);

package/lib/Utils/card-menu.js

@@ -0,0 +1,111 @@
+/**
+ * Card-style menu renderer (neon "cyber" look).
+ * Builds an SVG and converts it to PNG with `sharp` (already an optional dependency of this lib).
+ *
+ * renderCardMenu({
+ *   botName: 'SULA MD',              // your bot's name (top pill = botName + section)
+ *   section: 'GAMES',                // top pill suffix
+ *   label: 'CYBER ARCADE',           // small caption
+ *   title: 'Select Game 🕹️',         // big heading
+ *   badge: 'ARCADE READY',           // pill top-right (optional)
+ *   // icon = emoji (colored emoji needs a font like Noto Color Emoji on the server), or iconImage = data: URI (PNG/SVG)
+ *   items: [{ icon: '🏎️', title: 'Highway', subtitle: 'RACER 2D', color: '#f59e0b' }, ...],
+ *   columns: 3,
+ *   footer: 'DEVELOPED BY FIXO DEV ⚡', // default
+ *   accent: '#22d3ee'
+ * }) => Promise<Buffer>
+ */
+const esc = (s = '') => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+export const DEFAULT_FOOTER = 'DEVELOPED BY FIXO DEV ⚡';
+const PALETTE = ['#f59e0b', '#22d3ee', '#ec4899', '#22c55e', '#a855f7', '#f43f5e', '#8b5cf6', '#ef4444', '#eab308'];
+export const buildCardMenuSvg = (opts = {}) => {
+    const { botName = 'FIXO BOT', section = 'MENU', label = '', title = 'Select', badge = '', items = [], columns = 3, footer = DEFAULT_FOOTER, accent = '#22d3ee', width = 720 } = opts;
+    // top pill = "<BOT NAME> <SECTION>"  (e.g. "SULA MD GAMES"); `brand` can override it fully
+    const brand = opts.brand || `${botName} ${section}`.trim().toUpperCase();
+    const pad = 28, outer = 22, gap = 14;
+    const cols = Math.max(1, Math.min(columns, 4));
+    const rows = Math.max(1, Math.ceil(items.length / cols));
+    const innerW = width - outer * 2 - pad * 2;
+    const cellW = (innerW - gap * (cols - 1)) / cols;
+    const cellH = 150;
+    const headerH = 120;
+    const gridH = rows * cellH + (rows - 1) * gap + 28;
+    const footerH = footer ? 60 : 24;
+    const height = outer * 2 + headerH + gridH + footerH + 20;
+    let cells = '';
+    items.forEach((it, i) => {
+        const r = Math.floor(i / cols), c = i % cols;
+        const x = outer + pad + 14 + c * (cellW + gap) - 14 + 14;
+        const y = outer + headerH + 14 + r * (cellH + gap);
+        const col = it.color || PALETTE[i % PALETTE.length];
+        cells += `<g transform="translate(${x - 14},${y})">
+<rect width="${cellW}" height="${cellH}" rx="20" fill="#05080f" stroke="${col}" stroke-opacity="0.75" stroke-width="2"/>
+${it.iconImage ? `<image x="${cellW / 2 - 24}" y="22" width="48" height="48" href="${esc(it.iconImage)}"/>` : `<text x="${cellW / 2}" y="68" text-anchor="middle" font-size="44" fill="${col}" font-family="Noto Color Emoji,Apple Color Emoji,Segoe UI Emoji,sans-serif">${esc(it.icon || '•')}</text>`}
+<text x="${cellW / 2}" y="104" text-anchor="middle" font-size="21" font-weight="700" fill="#f1f5f9" font-family="Roboto,Arial,sans-serif">${esc(it.title)}</text>
+<text x="${cellW / 2}" y="128" text-anchor="middle" font-size="14" font-weight="600" fill="#94a3b8" font-family="Roboto,Arial,sans-serif">${esc(it.subtitle || '')}</text>
+</g>`;
+    });
+    const badgeSvg = badge ? `<g transform="translate(${width - outer - pad - 190},${outer + 40})"><rect width="190" height="40" rx="20" fill="#ec4899" fill-opacity="0.15" stroke="#ec4899" stroke-opacity="0.5"/><text x="95" y="26" text-anchor="middle" font-size="15" font-weight="700" fill="#ec4899" font-family="Roboto,Arial,sans-serif">${esc(badge)}</text></g>` : '';
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">
+<defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#0b1220"/><stop offset="1" stop-color="#03060c"/></linearGradient>
+<filter id="glow"><feGaussianBlur stdDeviation="4" result="b"/><feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge></filter></defs>
+<rect width="100%" height="100%" fill="#000"/>
+<rect x="${outer}" y="${outer}" width="${width - outer * 2}" height="${height - outer * 2}" rx="34" fill="url(#bg)" stroke="${accent}" stroke-width="3" filter="url(#glow)"/>
+<g transform="translate(${width / 2},${outer})"><rect x="-120" y="-16" width="240" height="32" rx="16" fill="#03060c" stroke="${accent}" stroke-width="2"/>
+<text y="6" text-anchor="middle" font-size="14" font-weight="700" letter-spacing="3" fill="#cbd5e1" font-family="Roboto,Arial,sans-serif">${esc(brand)}</text></g>
+<text x="${outer + pad}" y="${outer + 62}" font-size="16" font-weight="700" letter-spacing="2" fill="${accent}" font-family="Roboto,Arial,sans-serif">${esc(label)}</text>
+<text x="${outer + pad}" y="${outer + 98}" font-size="32" font-weight="800" fill="#ffffff" font-family="Roboto,Arial,sans-serif">${esc(title)}</text>
+${badgeSvg}
+${cells}
+${footer ? `<text x="${width / 2}" y="${height - outer - 34}" text-anchor="middle" font-size="15" font-weight="700" letter-spacing="1.5" fill="#94a3b8" font-family="Roboto,Arial,sans-serif">${esc(footer)}</text>` : ''}
+</svg>`;
+};
+export const renderCardMenu = async (opts = {}) => {
+    const sharp = (await import('sharp').catch(() => null))?.default;
+    if (!sharp) {
+        throw new Error('sendCardMenu needs the "sharp" package: npm i sharp');
+    }
+    return sharp(Buffer.from(buildCardMenuSvg(opts))).png().toBuffer();
+};
+
+/**
+ * Music player card (like the ".play" card). Returns SVG string.
+ * { botName, artist, title, cover (data: URI, optional), position: '0:33', duration: '3:32', progress: 0.15, playing: true }
+ */
+export const buildPlayerCardSvg = (opts = {}) => {
+    const { botName = 'FIXO BOT', artist = '', title = '', cover = '', position = '0:00', duration = '0:00', progress = 0, playing = true, accent = '#22d3ee', footer = `CYBER PLAYER ⚡ ${botName}`.toUpperCase() } = opts;
+    const width = 720, height = 1010, o = 22, pad = 36;
+    const barW = width - (o + pad) * 2;
+    const p = Math.max(0, Math.min(1, progress));
+    const cy = 780;
+    const btn = playing
+        ? `<rect x="-11" y="-16" width="8" height="32" rx="2" fill="#fff"/><rect x="5" y="-16" width="8" height="32" rx="2" fill="#fff"/>`
+        : `<path d="M-9 -17 L17 0 L-9 17 Z" fill="#fff"/>`;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">
+<defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#0b1220"/><stop offset="1" stop-color="#03060c"/></linearGradient>
+<linearGradient id="pb" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#22d3ee"/><stop offset="1" stop-color="#2563eb"/></linearGradient>
+<clipPath id="cv"><rect x="${o + pad}" y="110" width="${barW}" height="${barW}" rx="26"/></clipPath></defs>
+<rect width="100%" height="100%" fill="#000"/>
+<rect x="${o}" y="${o}" width="${width - o * 2}" height="${height - o * 2}" rx="34" fill="url(#bg)" stroke="${accent}" stroke-width="3"/>
+<text x="${width / 2}" y="70" text-anchor="middle" font-size="15" font-weight="800" letter-spacing="3" fill="${accent}" font-family="Roboto,Arial,sans-serif">NOW PLAYING</text>
+<text x="${width / 2}" y="96" text-anchor="middle" font-size="18" font-weight="700" fill="#e2e8f0" font-family="Roboto,Arial,sans-serif">${esc(artist)}</text>
+<rect x="${o + pad}" y="110" width="${barW}" height="${barW}" rx="26" fill="#0f172a"/>
+${cover ? `<image x="${o + pad}" y="110" width="${barW}" height="${barW}" preserveAspectRatio="xMidYMid slice" clip-path="url(#cv)" href="${esc(cover)}"/>` : ''}
+<text x="${o + pad}" y="${110 + barW + 50}" font-size="28" font-weight="800" fill="#fff" font-family="Roboto,Arial,sans-serif">${esc(`${artist} - ${title}`.slice(0, 34))}</text>
+<text x="${o + pad}" y="${110 + barW + 82}" font-size="20" fill="#94a3b8" font-family="Roboto,Arial,sans-serif">${esc(artist)}</text>
+<rect x="${o + pad}" y="${cy - 60}" width="${barW}" height="8" rx="4" fill="#1e293b"/>
+<rect x="${o + pad}" y="${cy - 60}" width="${barW * p}" height="8" rx="4" fill="${accent}"/>
+<circle cx="${o + pad + barW * p}" cy="${cy - 56}" r="10" fill="#fff"/>
+<text x="${o + pad}" y="${cy - 20}" font-size="16" fill="#94a3b8" font-family="Roboto,Arial,sans-serif">${esc(position)}</text>
+<text x="${o + pad + barW}" y="${cy - 20}" text-anchor="end" font-size="16" fill="#94a3b8" font-family="Roboto,Arial,sans-serif">${esc(duration)}</text>
+<g transform="translate(${width / 2},${cy + 50})"><circle r="44" fill="url(#pb)"/>${btn}</g>
+<path d="M${width / 2 - 130} ${cy + 36} v28 M${width / 2 - 100} ${cy + 36} l-22 14 22 14z" stroke="#64748b" fill="#64748b" stroke-width="4"/>
+<path d="M${width / 2 + 130} ${cy + 36} v28 M${width / 2 + 100} ${cy + 36} l22 14 -22 14z" stroke="#64748b" fill="#64748b" stroke-width="4"/>
+<text x="${width / 2}" y="${height - o - 30}" text-anchor="middle" font-size="14" font-weight="700" letter-spacing="1.5" fill="#94a3b8" font-family="Roboto,Arial,sans-serif">${esc(footer)}</text>
+</svg>`;
+};
+export const renderPlayerCard = async (opts = {}) => {
+    const sharp = (await import('sharp').catch(() => null))?.default;
+    if (!sharp) throw new Error('sendPlayerCard needs the "sharp" package: npm i sharp');
+    return sharp(Buffer.from(buildPlayerCardSvg(opts))).png().toBuffer();
+};

package/lib/Utils/index.js

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

package/package.json

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

package/lib/Types/temp

@@ -1 +0,0 @@
-

package/lib/WAM/temp

@@ -1 +0,0 @@
-