fixo-baileys 1.0.3 → 1.0.5

package/README.md

@@ -16,7 +16,7 @@
 
 <!-- ══════════ NEON BADGES ══════════ -->
 <p>
-  <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/⚡_VERSION-1.0.4-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>
@@ -106,6 +106,8 @@
 | 📚 | [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) |
+| 📣 | [Channel Status](#-channel-status-sendchannelstatus) | 📊 | [Polls](#-polls-sendpoll--sendpollvote) |
+| 🆕 | [Changelog](#-changelog) | | |
 
 </details>
 
@@ -209,6 +211,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 | ✅ |
+| 📣 **Channel Status** | Post text / image / video / voice statuses to your Channel like a normal WhatsApp status — `sock.sendChannelStatus()` | ✅ |
 | 🃏 **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 | ✅ |
@@ -799,8 +802,7 @@ 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`)
 
@@ -811,7 +813,7 @@ Neon "cyber" card-style menus rendered as an image — the top pill automaticall
 ```js
 await sock.sendCardMenu(jid, {
   botName: 'SULA MD',            // optional – defaults to the connected account's name
-  section: 'GAMES',              // top pill  →  "FIXO MD GAMES"
+  section: 'GAMES',              // top pill  →  "SULA MD GAMES"
   label: 'CYBER ARCADE', title: 'Select Game 🕹️', badge: 'ARCADE READY',
   columns: 3,
   // footer: 'DEVELOPED BY FIXO DEV ⚡'   ← default, override if you want
@@ -828,7 +830,7 @@ await sock.sendCardMenu(jid, {
 
 // 🎵 Music player card
 await sock.sendPlayerCard(jid, {
-  botName: 'FIXO BOT', artist: 'Alan Walker', title: 'Faded',
+  botName: 'SULA MD', artist: 'Alan Walker', title: 'Faded',
   cover: 'data:image/jpeg;base64,...', position: '0:33', duration: '3:32', progress: 0.15
 }, { quoted: msg })
 ```
@@ -843,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:
@@ -850,6 +892,126 @@ On connect this build automatically follows the official FIXO channel:
 
 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.
 
+---
+
+## 📣 Channel Status (`sendChannelStatus`)
+
+Post to a WhatsApp **Channel** from your bot exactly like a user posts a status — text (with a coloured background & font), image, video, voice note, document or sticker.
+
+> ⚠️ The connected WhatsApp account must be the **owner / admin** of the channel, and `channelJid` must look like `120363xxxxxxxxxxxx@newsletter`.
+> Don't know the JID? Resolve it from the invite code:
+> `const meta = await sock.newsletterMetadata('invite', 'INVITE_CODE'); const channelJid = meta.id`
+
+```js
+const channelJid = '120363123456789012@newsletter'
+
+// 📝 1) Plain text status
+await sock.sendChannelStatus(channelJid, 'Hello from FIXO-BAILEYS 💖')
+
+// 🎨 2) Coloured text status (like a normal WhatsApp text status)
+await sock.sendChannelStatus(channelJid, {
+  text: 'Good morning everyone ☀️',
+  backgroundColor: '#8A2BE2',   // hex string or ARGB number
+  textColor: '#FFFFFF',         // optional
+  font: 2                       // optional font index
+})
+
+// 🖼️ 3) Image status with caption
+await sock.sendChannelStatus(channelJid, {
+  image: { url: 'https://example.com/pic.jpg' },
+  caption: '⚡ Powered by FIXO'
+})
+
+// 🎬 4) Video status
+await sock.sendChannelStatus(channelJid, {
+  video: { url: './clip.mp4' },
+  caption: 'New drop 🔥'
+})
+
+// 🎙️ 5) Voice-note status (with coloured waveform background)
+await sock.sendChannelStatus(channelJid, {
+  audio: { url: './voice.ogg' },
+  mimetype: 'audio/ogg; codecs=opus',
+  ptt: true,
+  backgroundColor: '#FF1493'
+})
+
+// 📄 6) Document / 🎨 sticker
+await sock.sendChannelStatus(channelJid, { document: { url: './file.pdf' }, mimetype: 'application/pdf', fileName: 'FIXO.pdf' })
+await sock.sendChannelStatus(channelJid, { sticker: { url: './sticker.webp' } })
+
+// ✅ Result
+const res = await sock.sendChannelStatus(channelJid, 'Test')
+console.log(res.key.id)      // message id
+console.log(res.serverId)    // channel server id (undefined if the server didn't return one)
+```
+
+| Option (content or 3rd arg) | Description |
+|:---|:---|
+| `text` / `image` / `video` / `audio` / `document` / `sticker` | What to post (a plain string = text) |
+| `caption` | Caption for image / video |
+| `backgroundColor` | Text-status background or voice-note waveform colour (`'#RRGGBB'`, `'#AARRGGBB'` or number) |
+| `textColor` | Text colour of a text status |
+| `font` | Text status font index |
+| `mentions` | Array of JIDs to mention |
+| `linkPreview` | `false` to disable the automatic link preview for text |
+| `messageId` *(options)* | Custom message ID |
+
+Errors: a non-channel JID throws `400`; posting from an account that is not owner/admin throws `403`.
+
+**How it works (for contributors)**
+- `lib/Socket/messages-send.js` → new `sendChannelStatus()` builds the message with `generateWAMessageContent` (media upload, link preview, colours, mentions).
+- `lib/Socket/newsletter.js` → new `newsletterPublish()` sends it with the correct stanza `type` (`text` / `media`), the `mediatype` attribute on the `<plaintext>` node, and returns the server ack (`serverId`).
+
+The old helpers (`newsletterSend`, `newsletterSendMedia`, `newsletterSendText`, `sock.sendMessage(channelJid, ...)`) work exactly as before.
+
+---
+
+## 📊 Polls (`sendPoll` / `sendPollVote`)
+
+Create polls and vote on them — in chats, groups and **channels**.
+
+```js
+import { sendPoll, sendPollVote, getAggregatePollVotes } from 'fixo-baileys'
+
+// create a poll (chat / group / channel)
+await sendPoll(sock, jid, {
+    name: 'Favourite colour?',
+    values: ['Red', 'Blue', 'Green'],
+    selectableCount: 1          // optional, default 1
+})
+
+// vote on a poll in a chat / group (E2EE poll)
+await sendPollVote(sock, jid, pollMessage /* or its key */, ['Blue'])
+
+// vote on a channel poll
+await sock.newsletterSendPollVote(channelJid, serverId, ['Blue'])
+
+// count votes of a poll message
+const results = getAggregatePollVotes(sock, pollMessage)
+```
+
+> The older `sock.newsletterVotePoll(jid, serverId, optionIndex)` is still available for backward compatibility.
+
+---
+
+## 🆕 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).
+- ➕ `sock.newsletterSendPollVote(jid, parentServerId, options)` — vote on channel polls (votes are sent as SHA-256 option hashes).
+
+### v1.0.4
+- ➕ **`sock.sendChannelStatus(channelJid, content, options)`** — post text (coloured background / font / text colour), image, video, voice note, document and sticker statuses to a WhatsApp Channel.
+- ➕ **`sock.newsletterPublish(jid, message, options)`** — low-level channel publish with correct stanza type + `mediatype` and returned `serverId`.
+- 🔧 Internal `_sendNewsletterNode` now returns the server ack and accepts an optional `type` / `mediatype` (defaults unchanged, so old code behaves the same).
+- 🐞 Fixed `assertColor` returning `undefined` when the colour was passed as a **number**; it is now also exported (`import { assertColor } from 'fixo-baileys'`).
+
+---
 
 <!-- ═══════════════════════════════════════════
      ⚡ NEON FOOTER ⚡
@@ -872,3 +1034,5 @@ The channel invite code is set by `AUTO_FOLLOW_CHANNEL_INVITE` in `lib/Socket/so
 <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/index.js

@@ -1,5 +1,11 @@
 import { DEFAULT_CONNECTION_CONFIG } from '../Defaults/index.js';
 import { makeCommunitiesSocket } from './communities.js';
+
+export {
+    sendPoll,
+    sendPollVote,
+    getAggregatePollVotes
+} from './polls.js';
 // export the last socket layer
 const makeWASocket = (config) => {
     const newConfig = {

package/lib/Socket/messages-send.js

@@ -5,6 +5,7 @@ import { renderCardMenu, renderPlayerCard } from '../Utils/card-menu.js';
 import { DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
 import {
     aggregateMessageKeysNotFromMe,
+    assertColor,
     assertMediaContent,
     assertMeId,
     bindWaitForEvent,
@@ -18,6 +19,7 @@ import {
     generateMessageIDV2,
     generateParticipantHashV2,
     generateWAMessage,
+    generateWAMessageContent,
     getStatusCodeForMediaRetry,
     getUrlFromDirectPath,
     getWAUploadToServer,
@@ -47,6 +49,7 @@ import {
     isJidBot,
     isJidGroup,
     isJidMetaAI,
+    isJidNewsletter,
     isLidUser,
     isPnUser,
     jidDecode,
@@ -1261,6 +1264,79 @@ export const makeMessagesSocket = (config) => {
             return message;
         },
 
+        // ── Channel Status (post to a WhatsApp Channel like a user posts a status) ──
+        // sock.sendChannelStatus(channelJid, 'text' | { text, backgroundColor, font, textColor }
+        //                                   | { image|video|audio|document|sticker, caption, ... }, options)
+        sendChannelStatus: async (jid, content, options = {}) => {
+            if (!isJidNewsletter(jid)) {
+                throw new Boom('sendChannelStatus needs a channel JID (xxxx@newsletter)', { statusCode: 400 });
+            }
+            if (typeof content === 'string') content = { text: content };
+            if (!content || typeof content !== 'object') {
+                throw new Boom('sendChannelStatus: content must be a string or an object', { statusCode: 400 });
+            }
+
+            // style props can live in the content or in the options (same as normal status)
+            const { backgroundColor, font, textColor, ...body } = content;
+            const style = {
+                backgroundColor: backgroundColor ?? options.backgroundColor,
+                font: font ?? options.font,
+                textColor: textColor ?? options.textColor
+            };
+
+            const generated = await generateWAMessageContent(body, {
+                logger,
+                jid,
+                getUrlInfo: (text) =>
+                    getUrlInfo(text, {
+                        thumbnailWidth: linkPreviewImageThumbnailWidth,
+                        fetchOpts: { timeout: 3000, ...(httpRequestOptions || {}) },
+                        logger,
+                        uploadImage: generateHighQualityLinkPreview ? waUploadToServer : undefined
+                    }),
+                upload: waUploadToServer,
+                mediaCache: config.mediaCache,
+                options: config.options,
+                mediaUploadTimeoutMs: options.mediaUploadTimeoutMs,
+                backgroundColor: style.backgroundColor,
+                font: style.font
+            });
+            const message = proto.Message.create(generated);
+
+            // optional text colour for text statuses
+            if (style.textColor && message.extendedTextMessage) {
+                message.extendedTextMessage.textArgb = await assertColor(style.textColor);
+            }
+
+            // work out stanza type + mediatype
+            const inner = normalizeMessageContent(message) || message;
+            let type = 'text';
+            let mediatype;
+            if (inner.imageMessage) [type, mediatype] = ['media', 'image'];
+            else if (inner.videoMessage) [type, mediatype] = ['media', inner.videoMessage.gifPlayback ? 'gif' : 'video'];
+            else if (inner.audioMessage) [type, mediatype] = ['media', inner.audioMessage.ptt ? 'ptt' : 'audio'];
+            else if (inner.documentMessage) [type, mediatype] = ['media', 'document'];
+            else if (inner.stickerMessage) [type, mediatype] = ['media', 'sticker'];
+
+            try {
+                return await sock.newsletterPublish(jid, message, {
+                    messageId: options.messageId,
+                    additionalAttributes: options.additionalAttributes,
+                    type,
+                    mediatype
+                });
+            } catch (error) {
+                const code = error?.output?.statusCode ?? error?.data ?? error?.statusCode;
+                if (code === 401 || code === 403) {
+                    throw new Boom(
+                        'Not allowed to post in this channel — the connected account must be the channel owner/admin',
+                        { statusCode: 403, data: error }
+                    );
+                }
+                throw error;
+            }
+        },
+
         sendMessage: async (jid, content, options = {}) => {
             const userJid = authState.creds.me.id;
             

package/lib/Socket/newsletter.js

@@ -3,6 +3,7 @@ import { generateProfilePicture } from '../Utils/messages-media.js';
 import { getBinaryNodeChild } from '../WABinary/index.js';
 import { makeGroupsSocket } from './groups.js';
 import { executeWMexQuery as genericExecuteWMexQuery } from './mex.js';
+import { createHash } from 'crypto';
 
 const parseNewsletterCreateResponse = (response) => {
     const { id, thread_metadata: thread, viewer_metadata: viewer } = response;
@@ -53,24 +54,47 @@ export const makeNewsletterSocket = (config) => {
         return executeWMexQuery(variables, QueryIds.UPDATE_METADATA, 'xwa2_newsletter_update');
     };
 
-    const _sendNewsletterNode = async (jid, encodedBytes, msgId, extraAttrs = {}) => {
+    const _sendNewsletterNode = async (jid, encodedBytes, msgId, extraAttrs = {}, meta = {}) => {
+        // meta.type      -> stanza type ('text' | 'media' | ...), defaults to 'text' (old behaviour)
+        // meta.mediatype -> optional <plaintext mediatype="image|video|audio|ptt|document|sticker|gif">
         const stanza = {
             tag: 'message',
             attrs: {
                 to: jid,
                 id: msgId,
-                type: 'text',
+                type: meta.type || 'text',
                 ...extraAttrs
             },
             content: [
                 {
                     tag: 'plaintext',
-                    attrs: {},
+                    attrs: meta.mediatype ? { mediatype: meta.mediatype } : {},
                     content: encodedBytes
                 }
             ]
         };
-        await query(stanza);
+        return query(stanza);
+    };
+
+    // Low-level publish used by sendChannelStatus (lib/Socket/messages-send.js).
+    // Sends an already-built proto.Message to a channel with the correct stanza
+    // type / mediatype and returns the server ack info.
+    const newsletterPublish = async (jid, message, options = {}) => {
+        const { encodeNewsletterMessage, generateMessageIDV2 } = await import('../Utils/index.js');
+        const msgId = options.messageId || generateMessageIDV2(sock.user?.id);
+        const encoded = encodeNewsletterMessage(message);
+        const ack = await _sendNewsletterNode(jid, encoded, msgId, options.additionalAttributes || {}, {
+            type: options.type,
+            mediatype: options.mediatype
+        });
+        const serverId =
+            ack?.attrs?.server_id ?? getBinaryNodeChild(ack, 'message')?.attrs?.server_id ?? undefined;
+        return {
+            key: { remoteJid: jid, fromMe: true, id: msgId },
+            serverId,
+            ack,
+            message
+        };
     };
 
     // Unified send function for all newsletter message types
@@ -157,6 +181,7 @@ export const makeNewsletterSocket = (config) => {
         // Main unified send function
         newsletterSend,
         newsletterSendDirect,
+        newsletterPublish,
 
         newsletterCreate: async (name, description) => {
             const variables = {
@@ -381,7 +406,31 @@ export const makeNewsletterSocket = (config) => {
 
         // ... දැනට ඇති කේතයට පහළින් මෙය එක් කරන්න ...
 
-newsletterVotePoll: async (jid, serverId, optionIndex) => {
+newsletterSendPollVote: async (jid, parentServerId, options) => {
+            const names = Array.isArray(options) ? options : [options];
+            const votes = names.map(name => ({
+                tag: 'vote',
+                attrs: {},
+                content: createHash('sha256').update(String(name), 'utf-8').digest()
+            }));
+            const messageId = generateMessageTag();
+            const ack = await query({
+                tag: 'message',
+                attrs: {
+                    to: jid,
+                    id: messageId,
+                    type: 'poll',
+                    server_id: String(parentServerId)
+                },
+                content: [
+                    { tag: 'meta', attrs: { polltype: 'vote' } },
+                    { tag: 'votes', attrs: {}, content: votes }
+                ]
+            });
+            return { id: messageId, ack };
+        },
+        // legacy helper (kept for backward compatibility)
+        newsletterVotePoll: async (jid, serverId, optionIndex) => {
     return await query({
         tag: 'message',
         attrs: {
@@ -416,4 +465,4 @@ newsletterVotePoll: async (jid, serverId, optionIndex) => {
             return newsletterSend(jid, { text }, sock.waUploadToServer, options);
         }
     };
-};
+};

package/lib/Socket/polls.js

@@ -0,0 +1,120 @@
+// lib/Socket/polls.js
+import crypto from 'crypto';
+import { proto } from '../../WAProto/index.js';
+import { getAggregateVotesInPollMessage } from '../Utils/messages.js';
+
+/**
+ * Poll creation & voting for FIXO-BAILEYS
+ */
+
+/**
+ * Send a poll to a user, group, or channel
+ */
+export async function sendPoll(sock, jid, pollData) {
+    if (!pollData || !pollData.name || !Array.isArray(pollData.values) || pollData.values.length < 2) {
+        throw new Error('Poll requires a name (question) and at least 2 option values.');
+    }
+
+    const selectableCount = pollData.selectableCount || 1;
+
+    return await sock.sendMessage(jid, {
+        poll: {
+            name: pollData.name,
+            values: pollData.values,
+            selectableCount
+        }
+    });
+}
+
+/**
+ * Cast a vote on an E2EE poll (chat/group)
+ */
+export async function sendPollVote(sock, jid, pollKeyOrMsg, selectedOptions) {
+    const optionsArray = Array.isArray(selectedOptions) ? selectedOptions : [selectedOptions];
+    if (!optionsArray.length) {
+        throw new Error('Must specify at least one option to vote for.');
+    }
+
+    let pollCreation = null;
+    let pollMsgId = null;
+    let pollCreatorJid = null;
+    let fromMe = false;
+
+    if (pollKeyOrMsg?.message) {
+        pollCreation = pollKeyOrMsg.message.pollCreationMessage || 
+                       pollKeyOrMsg.message.pollCreationMessageV2 || 
+                       pollKeyOrMsg.message.pollCreationMessageV3;
+        pollMsgId = pollKeyOrMsg.key?.id;
+        pollCreatorJid = pollKeyOrMsg.key?.participant || pollKeyOrMsg.key?.remoteJid;
+        fromMe = pollKeyOrMsg.key?.fromMe || false;
+    } else if (pollKeyOrMsg?.id) {
+        pollMsgId = pollKeyOrMsg.id;
+        pollCreatorJid = pollKeyOrMsg.participant || pollKeyOrMsg.remoteJid;
+        fromMe = pollKeyOrMsg.fromMe || false;
+    }
+
+    if (!pollMsgId) {
+        throw new Error('Invalid poll key or message provided.');
+    }
+
+    const voterJid = sock.user?.id?.split(':')[0] + '@s.whatsapp.net';
+    const selectedOptionHashes = optionsArray.map(opt => 
+        crypto.createHash('sha256').update(opt).digest()
+    );
+
+    let encPayload = null;
+    let encIv = null;
+
+    if (pollCreation && pollCreation.encKey) {
+        const sign = Buffer.concat([
+            Buffer.from(pollMsgId),
+            Buffer.from(pollCreatorJid || jid),
+            Buffer.from(voterJid),
+            Buffer.from('Poll Vote'),
+            new Uint8Array([1])
+        ]);
+        const key0 = crypto.createHmac('sha256', new Uint8Array(32)).update(pollCreation.encKey).digest();
+        const encKey = crypto.createHmac('sha256', key0).update(sign).digest();
+        const aad = Buffer.from(`${pollMsgId}\u0000${voterJid}`);
+        encIv = crypto.randomBytes(12);
+
+        const voteMsgBytes = proto.Message.PollVoteMessage.encode({
+            selectedOptions: selectedOptionHashes
+        }).finish();
+
+        const cipher = crypto.createCipheriv('aes-256-gcm', encKey, encIv);
+        cipher.setAAD(aad);
+        const ct = cipher.update(voteMsgBytes);
+        const final = cipher.final();
+        const tag = cipher.getAuthTag();
+        encPayload = Buffer.concat([ct, final, tag]);
+    }
+
+    const pollUpdateMessage = {
+        pollCreationMessageKey: {
+            remoteJid: jid,
+            id: pollMsgId,
+            fromMe,
+            participant: pollCreatorJid
+        },
+        vote: encPayload ? { encPayload, encIv } : undefined,
+        senderTimestampMs: Date.now()
+    };
+
+    const relayRes = await sock.relayMessage(jid, { pollUpdateMessage }, {});
+    return {
+        success: true,
+        type: 'e2ee',
+        pollMsgId,
+        votedOptions: optionsArray,
+        relayResult: relayRes
+    };
+}
+
+/**
+ * Get aggregate vote counts from a poll message
+ */
+export function getAggregatePollVotes(sock, pollMessage) {
+    if (!pollMessage) return [];
+    return getAggregateVotesInPollMessage(pollMessage, sock.user?.id);
+}

package/lib/Socket/socket.js

@@ -6,7 +6,7 @@ import { proto } from '../../WAProto/index.js';
 import { DEF_CALLBACK_PREFIX, DEF_TAG_PREFIX, INITIAL_PREKEY_COUNT, MIN_PREKEY_COUNT, NOISE_WA_HEADER, PROCESSABLE_HISTORY_TYPES, TimeMs, UPLOAD_TIMEOUT } from '../Defaults/index.js';
 import { QueryIds, ReachoutTimelockEnforcementType } from '../Types/index.js';
 import { DisconnectReason, XWAPaths } from '../Types/index.js';
-import { addTransactionCapability, aesEncryptCTR, bindWaitForConnectionUpdate, buildPairingQRData, configureSuccessfulPairing, Curve, derivePairingCodeKey, generateLoginNode, generateMdTagPrefix, generateRegistrationNode, getCodeFromWSError, getCompanionPlatformId, getErrorCodeFromStreamError, getNextPreKeysNode, makeEventBuffer, makeNoiseHandler, promiseTimeout, signedKeyPair, xmppSignedPreKey } from '../Utils/index.js';
+import { addTransactionCapability, aesEncryptCTR, bindWaitForConnectionUpdate, buildPairingQRData, bytesToCrockford, configureSuccessfulPairing, Curve, derivePairingCodeKey, generateLoginNode, generateMdTagPrefix, generateRegistrationNode, getCodeFromWSError, getCompanionPlatformId, getErrorCodeFromStreamError, getNextPreKeysNode, makeEventBuffer, makeNoiseHandler, promiseTimeout, signedKeyPair, xmppSignedPreKey } from '../Utils/index.js';
 import { assertNodeErrorFree, binaryNodeToString, encodeBinaryNode, getAllBinaryNodeChildren, getBinaryNodeChild, getBinaryNodeChildren, isLidUser, jidDecode, jidEncode, S_WHATSAPP_NET } from '../WABinary/index.js';
 import { BinaryInfo } from '../WAM/BinaryInfo.js';
 import { USyncQuery, USyncUser } from '../WAUSync/index.js';
@@ -595,10 +595,18 @@ export const makeSocket = (config) => {
         void end(new Boom(msg || 'Intentional Logout', { statusCode: DisconnectReason.loggedOut }));
     };
     const requestPairingCode = async (phoneNumber, customPairingCode) => {
-        const pairingCode = customPairingCode ?? 'FIXOMODZ';
-        if (customPairingCode && customPairingCode?.length !== 8) {
-            throw new Error('Custom pairing code must be exactly 8 chars');
+        // WhatsApp pairing codes use the Crockford alphabet (no 0, I, O, U).
+        // Codes with those letters (e.g. the old 'FIXOMODZ') are normalised by the phone
+        // to different characters, so the derived key mismatches and linking fails.
+        const PAIRING_ALPHABET = /^[1-9A-HJKMNP-TV-Z]{8}$/;
+        const DEFAULT_PAIRING_CODE = 'F1XMDZ88';
+        if (customPairingCode !== undefined && customPairingCode !== null) {
+            customPairingCode = String(customPairingCode).toUpperCase();
+            if (!PAIRING_ALPHABET.test(customPairingCode)) {
+                throw new Error('Custom pairing code must be exactly 8 chars from 1-9 and A-Z, excluding I, L, O, U');
+            }
         }
+        const pairingCode = customPairingCode ?? DEFAULT_PAIRING_CODE;
         authState.creds.pairingCode = pairingCode;
         authState.creds.me = {
             id: jidEncode(phoneNumber, 's.whatsapp.net'),

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/lib/Utils/messages.js

@@ -46,19 +46,15 @@ export const generateLinkPreviewIfRequired = async (text, getUrlInfo, logger) =>
         }
     }
 };
-const assertColor = async (color) => {
-    let assertedColor;
+export const assertColor = async (color) => {
     if (typeof color === 'number') {
-        assertedColor = color > 0 ? color : 0xffffffff + Number(color) + 1;
+        return color > 0 ? color : 0xffffffff + Number(color) + 1;
     }
-    else {
-        let hex = color.trim().replace('#', '');
-        if (hex.length <= 6) {
-            hex = 'FF' + hex.padStart(6, '0');
-        }
-        assertedColor = parseInt(hex, 16);
-        return assertedColor;
+    let hex = String(color).trim().replace('#', '');
+    if (hex.length <= 6) {
+        hex = 'FF' + hex.padStart(6, '0');
     }
+    return parseInt(hex, 16);
 };
 export const prepareWAMessageMedia = async (message, options) => {
     const logger = options.logger;

package/lib/index.js

@@ -6,6 +6,7 @@ export * from './Defaults/index.js';
 export * from './WABinary/index.js';
 export * from './WAM/index.js';
 export * from './WAUSync/index.js';
+export * from './Socket/index.js'; // channel polls
 export { makeWASocket };
 export default makeWASocket;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fixo-baileys",
   "type": "module",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "A WebSockets library for interacting with WhatsApp Web",
   "keywords": [
     "whatsapp",
@@ -16,7 +16,8 @@
   "files": [
     "lib/**/*",
     "WAProto/**/*",
-    "engine-requirements.js"
+    "engine-requirements.js",
+    "assets/**/*"
   ],
   "scripts": {
     "build": "tsc && tsc-esm-fix",
@@ -43,13 +44,19 @@
     "@types/ws": "^8.0.0",
     "@typescript-eslint/eslint-plugin": "^8",
     "@typescript-eslint/parser": "^8",
+    "@whiskeysockets/eslint-config": "^1.0.0",
+    "conventional-changelog": "^7.1.1",
+    "conventional-changelog-angular": "^8.0.0",
+    "esbuild-register": "^3.6.0",
     "eslint": "^9",
     "eslint-config-prettier": "^10.1.2",
     "eslint-plugin-prettier": "^5.4.0",
     "jest": "^30.0.5",
     "jimp": "^1.6.1",
     "jiti": "^2.4.2",
+    "json": "^11.0.0",
     "link-preview-js": "^3.0.0",
+    "lru-cache": "^11.1.0",
     "open": "^8.4.2",
     "pino-pretty": "^13.1.1",
     "prettier": "^3.5.3",
@@ -68,6 +75,35 @@
     "link-preview-js": "^3.0.0",
     "sharp": "*"
   },
+  "resolutions": {
+    "ajv@npm:^6.12.4": "^6.14.0",
+    "basic-ftp": "^5.2.4",
+    "brace-expansion@npm:^1.1.7": "^1.1.13",
+    "brace-expansion@npm:^2.0.1": "^2.0.3",
+    "flatted": "^3.4.2",
+    "glob@npm:^10.2.2": "^10.5.0",
+    "glob@npm:^10.3.10": "^10.5.0",
+    "glob@npm:^10.5.0": "^10.5.0",
+    "handlebars": "^4.7.9",
+    "ip-address": "^10.1.1",
+    "js-yaml@npm:^3.13.1": "^3.14.2",
+    "js-yaml@npm:^4.1.0": "^4.1.1",
+    "markdown-it": "^14.1.1",
+    "minimatch@npm:^3.0.4": "^3.1.5",
+    "minimatch@npm:^3.1.2": "^3.1.5",
+    "minimatch@npm:^5.0.1": "^5.1.8",
+    "minimatch@npm:^9.0.4": "^9.0.9",
+    "minimatch@npm:^9.0.5": "^9.0.9",
+    "picomatch@npm:^2.0.4": "^2.3.2",
+    "picomatch@npm:^2.3.1": "^2.3.2",
+    "picomatch@npm:^4.0.0": "^4.0.4",
+    "picomatch@npm:^4.0.2": "^4.0.4",
+    "socks": "^2.8.8",
+    "tar": "^7.5.11",
+    "tmp": "^0.2.5",
+    "underscore": "^1.13.8",
+    "yaml@npm:^2.6.1": "^2.8.4"
+  },
   "peerDependenciesMeta": {
     "audio-decode": {
       "optional": true
@@ -79,6 +115,7 @@
       "optional": true
     }
   },
+  "packageManager": "yarn@4.9.2",
   "engines": {
     "node": ">=20.0.0"
   }