@yui-bails/yui-bails 0.0.0-stage → 1.1.0

package/lib/Utils/group-tools.d.ts

@@ -0,0 +1,38 @@
+import type { GroupMetadata, GroupParticipant, ParticipantAction, WAMessage } from '../Types/index.js';
+import type { GroupMetadataCache } from './group-cache.js';
+import type { SenderInfo } from './helpers.js';
+/** Who to check or act on: a number, a jid, a message, or the result of `getSender` */
+export type GroupMember = string | WAMessage | SenderInfo;
+export type GroupToolsSocket = {
+    user?: {
+        id: string;
+        lid?: string;
+    } | undefined;
+    groupMetadata: (jid: string) => Promise<GroupMetadata>;
+    groupParticipantsUpdate: (jid: string, participants: string[], action: ParticipantAction) => Promise<unknown>;
+};
+/**
+ * Group permissions and moderation shortcuts that understand both identities WhatsApp uses
+ * (phone number and LID), so admin checks do not break when a group shows LIDs.
+ */
+export declare const makeGroupTools: (sock: GroupToolsSocket, { cache, getSender }: {
+    cache?: GroupMetadataCache;
+    getSender: (msg: WAMessage) => Promise<SenderInfo>;
+}) => {
+    /** Admins and super admins of a group. */
+    getAdmins: (groupJid: string) => Promise<GroupParticipant[]>;
+    /** Is this person (number, jid, message or sender) an admin of the group? */
+    isAdmin: (groupJid: string, who: GroupMember) => Promise<boolean>;
+    /** Is the bot itself an admin of the group? */
+    isBotAdmin: (groupJid: string) => Promise<boolean>;
+    /** Removes members (numbers or jids). The bot must be admin. */
+    kick: (groupJid: string, who: string | string[]) => Promise<unknown>;
+    /** Adds members. */
+    addMembers: (groupJid: string, who: string | string[]) => Promise<unknown>;
+    /** Makes members admins. */
+    promote: (groupJid: string, who: string | string[]) => Promise<unknown>;
+    /** Removes admin rights. */
+    demote: (groupJid: string, who: string | string[]) => Promise<unknown>;
+};
+export type GroupTools = ReturnType<typeof makeGroupTools>;
+//# sourceMappingURL=group-tools.d.ts.map

package/lib/Utils/group-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-tools.d.ts","sourceRoot":"","sources":["../../src/Utils/group-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAE7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAC/C,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;IACtD,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7G,CAAA;AAiBD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAC1B,MAAM,gBAAgB,EACtB,sBAAsB;IAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE;IA+BvG,0CAA0C;0BACd,MAAM;IAElC,6EAA6E;wBACnD,MAAM,OAAO,WAAW;IAUlD,+CAA+C;2BAClB,MAAM;IAUnC,gEAAgE;qBAC/C,MAAM,OAAO,MAAM,GAAG,MAAM,EAAE;IAC/C,oBAAoB;2BACG,MAAM,OAAO,MAAM,GAAG,MAAM,EAAE;IACrD,4BAA4B;wBACR,MAAM,OAAO,MAAM,GAAG,MAAM,EAAE;IAClD,4BAA4B;uBACT,MAAM,OAAO,MAAM,GAAG,MAAM,EAAE;CAElD,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/lib/Utils/group-tools.js

@@ -0,0 +1,75 @@
+import { Boom } from '@hapi/boom';
+import { jidDecode } from '../WABinary/index.js';
+/** the user part of a jid, or the digits of a phone number */
+const identity = (value) => {
+    if (!value)
+        return undefined;
+    return value.includes('@') ? jidDecode(value)?.user : value.replace(/\D/g, '') || undefined;
+};
+const identitiesOf = (participant) => [participant.id, participant.lid, participant.phoneNumber].map(identity).filter((entry) => !!entry);
+const isAdminParticipant = (participant) => !!(participant.admin || participant.isAdmin || participant.isSuperAdmin);
+/** a number ("+51 910 227 479") or a jid becomes a jid */
+const toJid = (value) => (value.includes('@') ? value : `${value.replace(/\D/g, '')}@s.whatsapp.net`);
+/**
+ * Group permissions and moderation shortcuts that understand both identities WhatsApp uses
+ * (phone number and LID), so admin checks do not break when a group shows LIDs.
+ */
+export const makeGroupTools = (sock, { cache, getSender }) => {
+    const metadata = async (groupJid) => {
+        const cached = cache?.get(groupJid);
+        if (cached)
+            return cached;
+        const fresh = await sock.groupMetadata(groupJid);
+        cache?.set(groupJid, fresh);
+        return fresh;
+    };
+    /** every identity (number, LID id) a member is known by */
+    const identitiesOfMember = async (who) => {
+        if (typeof who === 'string')
+            return [identity(who)].filter((entry) => !!entry);
+        const sender = 'key' in who ? await getSender(who) : who;
+        return [sender.number, sender.id].filter((entry) => !!entry);
+    };
+    const targets = (who) => (Array.isArray(who) ? who : [who]).map(toJid);
+    const act = async (groupJid, who, action) => {
+        const jids = targets(who);
+        if (!jids.length)
+            throw new Boom('Say who to act on', { statusCode: 400 });
+        const result = await sock.groupParticipantsUpdate(groupJid, jids, action);
+        cache?.delete(groupJid); // the member list just changed
+        return result;
+    };
+    return {
+        /** Admins and super admins of a group. */
+        getAdmins: async (groupJid) => (await metadata(groupJid)).participants.filter(isAdminParticipant),
+        /** Is this person (number, jid, message or sender) an admin of the group? */
+        isAdmin: async (groupJid, who) => {
+            const wanted = await identitiesOfMember(who);
+            if (!wanted.length)
+                return false;
+            const { participants } = await metadata(groupJid);
+            return participants
+                .filter(isAdminParticipant)
+                .some(participant => identitiesOf(participant).some(entry => wanted.includes(entry)));
+        },
+        /** Is the bot itself an admin of the group? */
+        isBotAdmin: async (groupJid) => {
+            const me = [sock.user?.id, sock.user?.lid].map(identity).filter((entry) => !!entry);
+            if (!me.length)
+                return false;
+            const { participants } = await metadata(groupJid);
+            return participants
+                .filter(isAdminParticipant)
+                .some(participant => identitiesOf(participant).some(entry => me.includes(entry)));
+        },
+        /** Removes members (numbers or jids). The bot must be admin. */
+        kick: (groupJid, who) => act(groupJid, who, 'remove'),
+        /** Adds members. */
+        addMembers: (groupJid, who) => act(groupJid, who, 'add'),
+        /** Makes members admins. */
+        promote: (groupJid, who) => act(groupJid, who, 'promote'),
+        /** Removes admin rights. */
+        demote: (groupJid, who) => act(groupJid, who, 'demote')
+    };
+};
+//# sourceMappingURL=group-tools.js.map

package/lib/Utils/group-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-tools.js","sourceRoot":"","sources":["../../src/Utils/group-tools.ts"],"names":[],"mappings":"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"}

package/lib/Utils/helpers.d.ts

@@ -0,0 +1,180 @@
+import type { ButtonSpec, CarouselCard, MiscMessageGenerationOptions, PollMessageOptions, WAMessage, WAMessageKey } from '../Types/index.js';
+/** Who wrote a message, with both of WhatsApp's identities resolved when possible */
+export type SenderInfo = {
+    /** chat the message belongs to (group, private chat…) */
+    chat: string;
+    isGroup: boolean;
+    fromMe: boolean;
+    /** best jid to talk to the sender: the phone-number jid when known, otherwise the LID */
+    jid: string;
+    /** phone-number jid (`5191…@s.whatsapp.net`) when known */
+    pn: string | undefined;
+    /** LID jid (`2696…@lid`) when known */
+    lid: string | undefined;
+    /** phone number, digits only (`undefined` when only the LID is known) */
+    number: string | undefined;
+    /** WhatsApp's internal id: the user part of the LID (`undefined` when it is not known) */
+    id: string | undefined;
+    /** true when the number or the internal id is in `list` (numbers, ids or full jids) */
+    is: (list: string | string[]) => boolean;
+};
+type Me = {
+    id?: string;
+    lid?: string;
+} | undefined;
+/**
+ * Reads who sent a message using only the message itself (no network, no lookups).
+ * Use `sock.getSender(msg)` to also resolve the missing identity through WhatsApp's LID mapping.
+ */
+export declare const getSenderIds: (msg: Pick<WAMessage, "key" | "participant">, me?: Me) => SenderInfo;
+export type SendButtonsOptions = {
+    text?: string;
+    footer?: string;
+    title?: string;
+    buttons: ButtonSpec[];
+    /** classic buttons render in every client; `interactive` (default) uses native flow */
+    buttonsFormat?: 'interactive' | 'buttons';
+};
+export type SendCarouselOptions = {
+    cards: CarouselCard[];
+    text?: string;
+    title?: string;
+    footer?: string;
+};
+export type SendListOptions = {
+    text?: string;
+    title?: string;
+    footer?: string;
+    /** label of the button that opens the list */
+    buttonText?: string;
+    /** simple form: `{ title, rows: [{ id, title, description? }] }` */
+    sections: {
+        title?: string;
+        rows: {
+            id?: string;
+            rowId?: string;
+            title: string;
+            description?: string;
+        }[];
+    }[];
+};
+export type DownloadMediaOptions = {
+    /** download the media of the message this one replies to */
+    quoted?: boolean;
+};
+export type PollVotes = {
+    /** key of the poll message */
+    pollKey: WAMessageKey;
+    pollName: string;
+    /** every option with the people who chose it (the voters of an option can be empty) */
+    votes: {
+        name: string;
+        voters: string[];
+    }[];
+    /** the voter that triggered this update */
+    voter: string;
+};
+/**
+ * How a send ended:
+ * - `sent`: WhatsApp accepted it
+ * - `failed`: it definitely did not go out
+ * - `unknown`: it timed out or the connection dropped mid-send, so it may still be delivered
+ */
+export type SendResult = {
+    status: 'sent';
+    message: WAMessage | undefined;
+} | {
+    status: 'failed';
+    error: unknown;
+} | {
+    status: 'unknown';
+    error: unknown;
+    settled: Promise<SendResult>;
+};
+export type SendSafeOptions = {
+    /** how long to wait before giving up with `unknown`, in ms. Default 20000 */
+    timeoutMs?: number;
+};
+type Content = Record<string, unknown>;
+type SendFn = (jid: string, content: any, options?: MiscMessageGenerationOptions) => Promise<WAMessage | undefined>;
+/** What `makeHelpers` needs from the socket (a subset, so it is easy to test) */
+export type HelperSocket = {
+    user?: {
+        id: string;
+        lid?: string;
+    } | undefined;
+    ev: {
+        on: (event: any, listener: (...args: any[]) => void) => void;
+        emit: (event: any, data: any) => unknown;
+    };
+    sendMessage: SendFn;
+    updateMediaMessage: (message: WAMessage) => Promise<WAMessage>;
+    signalRepository?: {
+        lidMapping?: {
+            getPNForLID?: (lid: string) => Promise<string | null>;
+            getLIDForPN?: (pn: string) => Promise<string | null>;
+        };
+    };
+};
+export type HelperConfig = {
+    logger?: {
+        debug: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+    };
+    getMessage?: (key: WAMessageKey) => Promise<WAMessage['message'] | undefined>;
+};
+/**
+ * Shortcuts that every bot ends up writing by hand. `makeWASocket` already adds them
+ * to the socket, so normally you just call `sock.reply(msg, 'hi')`.
+ */
+export declare const makeHelpers: (sock: HelperSocket, config?: HelperConfig) => {
+    /**
+     * Who sent the message: phone number, LID and WhatsApp's internal id, resolving the missing
+     * one through the LID mapping. Never throws.
+     */
+    getSender: (msg: WAMessage) => Promise<SenderInfo>;
+    /** Replies quoting the message. `content` can be a plain string. */
+    reply: (msg: WAMessage, content: string | Content, options?: MiscMessageGenerationOptions) => Promise<WAMessage | undefined>;
+    /** Reacts to a message with an emoji (empty string removes the reaction). */
+    react: (msg: WAMessage, emoji: string) => Promise<WAMessage | undefined>;
+    /**
+     * Like `sendMessage`, but never throws: it tells `sent`, `failed` or `unknown` apart.
+     * `unknown` means the connection dropped or the wait timed out, so the message may still
+     * arrive; its `settled` promise gives the final outcome.
+     */
+    sendSafe: (jid: string, content: string | Content, options?: MiscMessageGenerationOptions, { timeoutMs }?: SendSafeOptions) => Promise<SendResult>;
+    /** Sends a message with buttons. */
+    sendButtons: (jid: string, { buttons, ...rest }: SendButtonsOptions, options?: MiscMessageGenerationOptions) => Promise<WAMessage | undefined>;
+    /**
+     * Sends a carousel: up to 10 cards that scroll sideways, each with its own image or video,
+     * texts and buttons.
+     */
+    sendCarousel: (jid: string, { cards, ...rest }: SendCarouselOptions, options?: MiscMessageGenerationOptions) => Promise<WAMessage | undefined>;
+    /**
+     * Tries to remove the buttons from a message you sent (by editing it into plain text), so
+     * nobody taps them again. WhatsApp may refuse to edit some interactive messages: it returns
+     * `false` then. For a guaranteed "use once", pass `{ once: true }` to `onButton`.
+     */
+    disableButtons: (msg: WAMessage, text?: string) => Promise<boolean>;
+    /** Sends a list (dropdown) message. */
+    sendList: (jid: string, { sections, ...rest }: SendListOptions, options?: MiscMessageGenerationOptions) => Promise<WAMessage | undefined>;
+    /** Sends a poll and starts tracking its votes (see the `poll.votes` event and `getPollVotes`). */
+    sendPoll: (jid: string, name: string, values: string[], poll?: Partial<Omit<PollMessageOptions, "name" | "values">>, options?: MiscMessageGenerationOptions) => Promise<WAMessage | undefined>;
+    /** Current results of a poll created by (or seen by) this socket. */
+    getPollVotes: (pollKey: WAMessageKey | string) => {
+        pollKey: WAMessageKey;
+        pollName: string;
+        votes: {
+            name: string;
+            voters: string[];
+        }[];
+    } | undefined;
+    /**
+     * Downloads the media of a message (image, video, audio, document, sticker) in one call,
+     * re-requesting the upload from the phone when the file expired.
+     */
+    downloadMedia: (msg: WAMessage, options?: DownloadMediaOptions) => Promise<Buffer>;
+};
+export type Helpers = ReturnType<typeof makeHelpers>;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/lib/Utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/Utils/helpers.ts"],"names":[],"mappings":"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"}

package/lib/Utils/helpers.js

@@ -0,0 +1,279 @@
+import { Boom } from '@hapi/boom';
+import { isJidGroup, isLidUser, isPnUser, jidDecode, jidNormalizedUser } from '../WABinary/index.js';
+import { downloadMediaMessage, getAggregateVotesInPollMessage } from './messages.js';
+const userPart = (jid) => (jid ? jidDecode(jid)?.user : undefined);
+const clean = (value) => {
+    const digits = value.replace(/\D/g, '');
+    return digits || value.split('@')[0].split(':')[0];
+};
+/**
+ * Reads who sent a message using only the message itself (no network, no lookups).
+ * Use `sock.getSender(msg)` to also resolve the missing identity through WhatsApp's LID mapping.
+ */
+export const getSenderIds = (msg, me) => {
+    const key = msg.key;
+    const chat = key.remoteJid || '';
+    const isGroup = !!isJidGroup(chat) || chat === 'status@broadcast';
+    const fromMe = !!key.fromMe;
+    let pn;
+    let lid;
+    if (fromMe && me) {
+        pn = me.id ? jidNormalizedUser(me.id) : undefined;
+        lid = me.lid ? jidNormalizedUser(me.lid) : undefined;
+    }
+    else {
+        const main = isGroup ? key.participant || msg.participant : key.remoteJid;
+        const alt = isGroup ? key.participantAlt : key.remoteJidAlt;
+        for (const candidate of [main, alt]) {
+            if (!candidate)
+                continue;
+            const normalized = jidNormalizedUser(candidate);
+            if (!pn && isPnUser(normalized))
+                pn = normalized;
+            else if (!lid && isLidUser(normalized))
+                lid = normalized;
+        }
+    }
+    return buildSender({ chat, isGroup, fromMe, pn, lid });
+};
+const buildSender = ({ chat, isGroup, fromMe, pn, lid }) => {
+    const number = userPart(pn);
+    const id = userPart(lid);
+    const known = [number, id].filter((value) => !!value);
+    return {
+        chat,
+        isGroup,
+        fromMe,
+        jid: pn || lid || '',
+        pn,
+        lid,
+        number,
+        id,
+        is: list => (Array.isArray(list) ? list : [list]).map(clean).some(entry => known.includes(entry))
+    };
+};
+/** errors that do not prove the message was not sent: the connection died or the wait ran out */
+const UNCERTAIN_CODES = [408, 428, 440];
+const MAX_TRACKED_POLLS = 200;
+/**
+ * Shortcuts that every bot ends up writing by hand. `makeWASocket` already adds them
+ * to the socket, so normally you just call `sock.reply(msg, 'hi')`.
+ */
+export const makeHelpers = (sock, config = {}) => {
+    const polls = new Map();
+    const pollIdOf = (key) => (key?.id ? `${key.remoteJid || ''}|${key.id}` : undefined);
+    const remember = (msg) => {
+        const id = pollIdOf(msg?.key);
+        const content = msg?.message;
+        if (!id || !content)
+            return;
+        if (!(content.pollCreationMessage || content.pollCreationMessageV2 || content.pollCreationMessageV3))
+            return;
+        if (!polls.has(id)) {
+            polls.set(id, { message: content, key: msg.key, updates: new Map() });
+            // forget the oldest polls so a long-running bot does not grow forever
+            if (polls.size > MAX_TRACKED_POLLS)
+                polls.delete(polls.keys().next().value);
+        }
+    };
+    const aggregate = (tracked, meId) => getAggregateVotesInPollMessage({ message: tracked.message, pollUpdates: [...tracked.updates.values()] }, meId).map(option => ({ name: option.name, voters: option.voters }));
+    const pollName = (message) => message?.pollCreationMessage?.name ||
+        message?.pollCreationMessageV2?.name ||
+        message?.pollCreationMessageV3?.name ||
+        '';
+    sock.ev.on('messages.upsert', ({ messages }) => {
+        for (const msg of messages || [])
+            remember(msg);
+    });
+    sock.ev.on('messages.update', async (updates) => {
+        for (const { key, update } of updates || []) {
+            const incoming = update?.pollUpdates;
+            const id = pollIdOf(key);
+            if (!incoming?.length || !id)
+                continue;
+            try {
+                let tracked = polls.get(id);
+                if (!tracked && config.getMessage) {
+                    const stored = await config.getMessage(key);
+                    if (stored) {
+                        remember({ key, message: stored });
+                        tracked = polls.get(id);
+                    }
+                }
+                if (!tracked) {
+                    config.logger?.debug({ key }, 'poll vote ignored: the poll message is unknown (provide getMessage)');
+                    continue;
+                }
+                for (const vote of incoming) {
+                    const voter = vote.pollUpdateMessageKey?.participant || vote.pollUpdateMessageKey?.remoteJid || '';
+                    tracked.updates.set(voter, vote);
+                    sock.ev.emit('poll.votes', {
+                        pollKey: tracked.key,
+                        pollName: pollName(tracked.message),
+                        votes: aggregate(tracked, sock.user?.id),
+                        voter
+                    });
+                }
+            }
+            catch (error) {
+                config.logger?.warn({ error }, 'could not process a poll vote');
+            }
+        }
+    });
+    // ---- helpers ---------------------------------------------------------------
+    const toContent = (content) => (typeof content === 'string' ? { text: content } : content);
+    const chatOf = (msg) => {
+        const jid = msg.key.remoteJid;
+        if (!jid)
+            throw new Boom('The message has no chat (key.remoteJid)', { statusCode: 400 });
+        return jid;
+    };
+    return {
+        /**
+         * Who sent the message: phone number, LID and WhatsApp's internal id, resolving the missing
+         * one through the LID mapping. Never throws.
+         */
+        getSender: async (msg) => {
+            const base = getSenderIds(msg, sock.user);
+            let { pn, lid } = base;
+            try {
+                const mapping = sock.signalRepository?.lidMapping;
+                if (lid && !pn && mapping?.getPNForLID) {
+                    const found = await mapping.getPNForLID(lid);
+                    if (found)
+                        pn = jidNormalizedUser(found);
+                }
+                else if (pn && !lid && mapping?.getLIDForPN) {
+                    const found = await mapping.getLIDForPN(pn);
+                    if (found)
+                        lid = jidNormalizedUser(found);
+                }
+            }
+            catch (error) {
+                config.logger?.debug({ error }, 'could not resolve the sender through the LID mapping');
+            }
+            return buildSender({ chat: base.chat, isGroup: base.isGroup, fromMe: base.fromMe, pn, lid });
+        },
+        /** Replies quoting the message. `content` can be a plain string. */
+        reply: (msg, content, options = {}) => sock.sendMessage(chatOf(msg), toContent(content), { quoted: msg, ...options }),
+        /** Reacts to a message with an emoji (empty string removes the reaction). */
+        react: (msg, emoji) => sock.sendMessage(chatOf(msg), { react: { text: emoji, key: msg.key } }),
+        /**
+         * Like `sendMessage`, but never throws: it tells `sent`, `failed` or `unknown` apart.
+         * `unknown` means the connection dropped or the wait timed out, so the message may still
+         * arrive; its `settled` promise gives the final outcome.
+         */
+        sendSafe: async (jid, content, options, { timeoutMs = 20000 } = {}) => {
+            const run = Promise.resolve()
+                .then(() => sock.sendMessage(jid, toContent(content), options))
+                .then(message => ({ status: 'sent', message }))
+                .catch(error => {
+                const code = error?.output?.statusCode;
+                return UNCERTAIN_CODES.includes(code)
+                    ? { status: 'unknown', error, settled: Promise.resolve({ status: 'failed', error }) }
+                    : { status: 'failed', error };
+            });
+            let timer;
+            const timeout = new Promise(resolve => {
+                timer = setTimeout(() => {
+                    const error = new Boom('Timed out waiting for the send to finish', { statusCode: 408 });
+                    resolve({ status: 'unknown', error, settled: run });
+                }, timeoutMs);
+            });
+            try {
+                return await Promise.race([run, timeout]);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+        /** Sends a message with buttons. */
+        sendButtons: (jid, { buttons, ...rest }, options) => {
+            if (!Array.isArray(buttons) || !buttons.length) {
+                throw new Boom('sendButtons needs at least one button', { statusCode: 400 });
+            }
+            return sock.sendMessage(jid, { ...rest, buttons }, options);
+        },
+        /**
+         * Sends a carousel: up to 10 cards that scroll sideways, each with its own image or video,
+         * texts and buttons.
+         */
+        sendCarousel: (jid, { cards, ...rest }, options) => {
+            if (!Array.isArray(cards) || !cards.length) {
+                throw new Boom('sendCarousel needs at least one card', { statusCode: 400 });
+            }
+            return sock.sendMessage(jid, { ...rest, carousel: cards }, options);
+        },
+        /**
+         * Tries to remove the buttons from a message you sent (by editing it into plain text), so
+         * nobody taps them again. WhatsApp may refuse to edit some interactive messages: it returns
+         * `false` then. For a guaranteed "use once", pass `{ once: true }` to `onButton`.
+         */
+        disableButtons: async (msg, text) => {
+            const content = msg.message?.interactiveMessage || msg.message?.buttonsMessage;
+            const original = (content && 'body' in content ? content.body?.text : undefined) ||
+                (content && 'contentText' in content ? content.contentText : undefined) ||
+                '';
+            try {
+                await sock.sendMessage(chatOf(msg), { text: text ?? (original || '✅'), edit: msg.key });
+                return true;
+            }
+            catch (error) {
+                config.logger?.debug({ error }, 'could not edit the message to disable its buttons');
+                return false;
+            }
+        },
+        /** Sends a list (dropdown) message. */
+        sendList: (jid, { sections, ...rest }, options) => {
+            if (!Array.isArray(sections) || !sections.length) {
+                throw new Boom('sendList needs at least one section', { statusCode: 400 });
+            }
+            const normalized = sections.map(section => ({
+                ...section,
+                rows: section.rows.map(({ id, rowId, ...row }) => ({ ...row, rowId: rowId ?? id ?? row.title }))
+            }));
+            return sock.sendMessage(jid, { buttonText: 'Ver opciones', ...rest, sections: normalized }, options);
+        },
+        /** Sends a poll and starts tracking its votes (see the `poll.votes` event and `getPollVotes`). */
+        sendPoll: async (jid, name, values, poll = {}, options) => {
+            const sent = await sock.sendMessage(jid, { poll: { name, values, selectableCount: 1, ...poll } }, options);
+            remember(sent);
+            return sent;
+        },
+        /** Current results of a poll created by (or seen by) this socket. */
+        getPollVotes: (pollKey) => {
+            const id = typeof pollKey === 'string' ? [...polls.keys()].find(entry => entry.endsWith(`|${pollKey}`)) : pollIdOf(pollKey);
+            const tracked = id ? polls.get(id) : undefined;
+            if (!tracked)
+                return undefined;
+            return {
+                pollKey: tracked.key,
+                pollName: pollName(tracked.message),
+                votes: aggregate(tracked, sock.user?.id)
+            };
+        },
+        /**
+         * Downloads the media of a message (image, video, audio, document, sticker) in one call,
+         * re-requesting the upload from the phone when the file expired.
+         */
+        downloadMedia: async (msg, options = {}) => {
+            let target = msg;
+            if (options.quoted) {
+                const content = msg.message || {};
+                const type = Object.keys(content).find(entry => content[entry]?.contextInfo);
+                const context = type ? content[type].contextInfo : undefined;
+                if (!context?.quotedMessage)
+                    throw new Boom('The message does not reply to anything', { statusCode: 400 });
+                target = {
+                    key: { remoteJid: msg.key.remoteJid, id: context.stanzaId, participant: context.participant },
+                    message: context.quotedMessage
+                };
+            }
+            return downloadMediaMessage(target, 'buffer', {}, {
+                reuploadRequest: sock.updateMediaMessage,
+                logger: (config.logger || { debug() { }, warn() { } })
+            });
+        }
+    };
+};
+//# sourceMappingURL=helpers.js.map

package/lib/Utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/Utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAUjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC3F,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAA;AAwBjF,MAAM,QAAQ,GAAG,CAAC,GAAuB,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAEtF,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACvC,OAAO,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;AACrD,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAA2C,EAAE,EAAO,EAAc,EAAE;IAChG,MAAM,GAAG,GAAiB,GAAG,CAAC,GAAG,CAAA;IACjC,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAA;IAChC,MAAM,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,kBAAkB,CAAA;IACjE,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;IAE3B,IAAI,EAAsB,CAAA;IAC1B,IAAI,GAAuB,CAAA;IAE3B,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAClB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACjD,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACrD,CAAC;SAAM,CAAC;QACP,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAA;QACzE,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAA;QAC3D,KAAK,MAAM,SAAS,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS;gBAAE,SAAQ;YACxB,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAA;YAC/C,IAAI,CAAC,EAAE,IAAI,QAAQ,CAAC,UAAU,CAAC;gBAAE,EAAE,GAAG,UAAU,CAAA;iBAC3C,IAAI,CAAC,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC;gBAAE,GAAG,GAAG,UAAU,CAAA;QACzD,CAAC;IACF,CAAC;IAED,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;AACvD,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,MAAM,EACN,EAAE,EACF,GAAG,EAOH,EAAc,EAAE;IAChB,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;IACxB,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAEtE,OAAO;QACN,IAAI;QACJ,OAAO;QACP,MAAM;QACN,GAAG,EAAE,EAAE,IAAI,GAAG,IAAI,EAAE;QACpB,EAAE;QACF,GAAG;QACH,MAAM;QACN,EAAE;QACF,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;KACjG,CAAA;AACF,CAAC,CAAA;AA2DD,iGAAiG;AACjG,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAyBvC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAE7B;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAkB,EAAE,SAAuB,EAAE,EAAE,EAAE;IAG5E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAA;IAExC,MAAM,QAAQ,GAAG,CAAC,GAAoC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAErH,MAAM,QAAQ,GAAG,CAAC,GAAiC,EAAE,EAAE;QACtD,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAC7B,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,CAAA;QAC5B,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO;YAAE,OAAM;QAC3B,IAAI,CAAC,CAAC,OAAO,CAAC,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,IAAI,OAAO,CAAC,qBAAqB,CAAC;YAAE,OAAM;QAC5G,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;YACtE,sEAAsE;YACtE,IAAI,KAAK,CAAC,IAAI,GAAG,iBAAiB;gBAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC,CAAA;QACtF,CAAC;IACF,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAE,IAAa,EAAE,EAAE,CACrD,8BAA8B,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,CACjH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CACxD,CAAA;IAEF,MAAM,QAAQ,GAAG,CAAC,OAA6B,EAAE,EAAE,CAClD,OAAO,EAAE,mBAAmB,EAAE,IAAI;QAClC,OAAO,EAAE,qBAAqB,EAAE,IAAI;QACpC,OAAO,EAAE,qBAAqB,EAAE,IAAI;QACpC,EAAE,CAAA;IAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE,QAAQ,EAA6B,EAAE,EAAE;QACzE,KAAK,MAAM,GAAG,IAAI,QAAQ,IAAI,EAAE;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,iBAAiB,EAAE,KAAK,EAAE,OAA0B,EAAE,EAAE;QAClE,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,EAAE,WAAW,CAAA;YACpC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;YACxB,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAE;gBAAE,SAAQ;YAEtC,IAAI,CAAC;gBACJ,IAAI,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBAC3B,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;oBAC3C,IAAI,MAAM,EAAE,CAAC;wBACZ,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAe,CAAC,CAAA;wBAC/C,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;oBACxB,CAAC;gBACF,CAAC;gBAED,IAAI,CAAC,OAAO,EAAE,CAAC;oBACd,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,qEAAqE,CAAC,CAAA;oBACpG,SAAQ;gBACT,CAAC;gBAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;oBAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,EAAE,WAAW,IAAI,IAAI,CAAC,oBAAoB,EAAE,SAAS,IAAI,EAAE,CAAA;oBAClG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;oBAEhC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE;wBAC1B,OAAO,EAAE,OAAO,CAAC,GAAG;wBACpB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;wBACnC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;wBACxC,KAAK;qBACe,CAAC,CAAA;gBACvB,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,+BAA+B,CAAC,CAAA;YAChE,CAAC;QACF,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,+EAA+E;IAC/E,MAAM,SAAS,GAAG,CAAC,OAAyB,EAAW,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAErH,MAAM,MAAM,GAAG,CAAC,GAA2B,EAAE,EAAE;QAC9C,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAA;QAC7B,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,IAAI,CAAC,yCAAyC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAA;QACxF,OAAO,GAAG,CAAA;IACX,CAAC,CAAA;IAED,OAAO;QACN;;;WAGG;QACH,SAAS,EAAE,KAAK,EAAE,GAAc,EAAuB,EAAE;YACxD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;YACzC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;YAEtB,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAA;gBACjD,IAAI,GAAG,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;oBACxC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;oBAC5C,IAAI,KAAK;wBAAE,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;gBACzC,CAAC;qBAAM,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;oBAC/C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;oBAC3C,IAAI,KAAK;wBAAE,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;gBAC1C,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,sDAAsD,CAAC,CAAA;YACxF,CAAC;YAED,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QAC7F,CAAC;QAED,oEAAoE;QACpE,KAAK,EAAE,CAAC,GAAc,EAAE,OAAyB,EAAE,UAAwC,EAAE,EAAE,EAAE,CAChG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAE/E,6EAA6E;QAC7E,KAAK,EAAE,CAAC,GAAc,EAAE,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC;QAEjH;;;;WAIG;QACH,QAAQ,EAAE,KAAK,EACd,GAAW,EACX,OAAyB,EACzB,OAAsC,EACtC,EAAE,SAAS,GAAG,KAAM,KAAsB,EAAE,EACtB,EAAE;YACxB,MAAM,GAAG,GAAwB,OAAO,CAAC,OAAO,EAAE;iBAChD,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;iBAC9D,IAAI,CAAa,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;iBAC1D,KAAK,CAAa,KAAK,CAAC,EAAE;gBAC1B,MAAM,IAAI,GAAI,KAA0B,EAAE,MAAM,EAAE,UAAU,CAAA;gBAC5D,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAc,CAAC;oBAC9C,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE;oBACrF,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;YAC/B,CAAC,CAAC,CAAA;YAEH,IAAI,KAAgD,CAAA;YACpD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAa,OAAO,CAAC,EAAE;gBACjD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACvB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,0CAA0C,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAA;oBACvF,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;gBACpD,CAAC,EAAE,SAAS,CAAC,CAAA;YACd,CAAC,CAAC,CAAA;YAEF,IAAI,CAAC;gBACJ,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;YAC1C,CAAC;oBAAS,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC;QACF,CAAC;QAED,oCAAoC;QACpC,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAsB,EAAE,OAAsC,EAAE,EAAE;YAC9G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAChD,MAAM,IAAI,IAAI,CAAC,uCAAuC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAA;YAC7E,CAAC;YAED,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;QAC5D,CAAC;QAED;;;WAGG;QACH,YAAY,EAAE,CAAC,GAAW,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,EAAuB,EAAE,OAAsC,EAAE,EAAE;YAC9G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC5C,MAAM,IAAI,IAAI,CAAC,sCAAsC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAA;YAC5E,CAAC;YAED,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAA;QACpE,CAAC;QAED;;;;WAIG;QACH,cAAc,EAAE,KAAK,EAAE,GAAc,EAAE,IAAa,EAAoB,EAAE;YACzE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,kBAAkB,IAAI,GAAG,CAAC,OAAO,EAAE,cAAc,CAAA;YAC9E,MAAM,QAAQ,GACb,CAAC,OAAO,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC/D,CAAC,OAAO,IAAI,aAAa,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvE,EAAE,CAAA;YAEH,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;gBACvF,OAAO,IAAI,CAAA;YACZ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,mDAAmD,CAAC,CAAA;gBACpF,OAAO,KAAK,CAAA;YACb,CAAC;QACF,CAAC;QAED,uCAAuC;QACvC,QAAQ,EAAE,CAAC,GAAW,EAAE,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAmB,EAAE,OAAsC,EAAE,EAAE;YACzG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClD,MAAM,IAAI,IAAI,CAAC,qCAAqC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAA;YAC3E,CAAC;YAED,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC3C,GAAG,OAAO;gBACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;aAChG,CAAC,CAAC,CAAA;YACH,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAA;QACrG,CAAC;QAED,kGAAkG;QAClG,QAAQ,EAAE,KAAK,EACd,GAAW,EACX,IAAY,EACZ,MAAgB,EAChB,OAA6D,EAAE,EAC/D,OAAsC,EACrC,EAAE;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;YAC1G,QAAQ,CAAC,IAAI,CAAC,CAAA;YACd,OAAO,IAAI,CAAA;QACZ,CAAC;QAED,qEAAqE;QACrE,YAAY,EAAE,CAAC,OAA8B,EAAE,EAAE;YAChD,MAAM,EAAE,GACP,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;YACjH,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC9C,IAAI,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAA;YAC9B,OAAO;gBACN,OAAO,EAAE,OAAO,CAAC,GAAG;gBACpB,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;gBACnC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;aACxC,CAAA;QACF,CAAC;QAED;;;WAGG;QACH,aAAa,EAAE,KAAK,EAAE,GAAc,EAAE,UAAgC,EAAE,EAAmB,EAAE;YAC5F,IAAI,MAAM,GAAG,GAAG,CAAA;YAEhB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAA;gBACjC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAE,OAAe,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAA;gBACrF,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAE,OAAe,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAA;gBACrE,IAAI,CAAC,OAAO,EAAE,aAAa;oBAAE,MAAM,IAAI,IAAI,CAAC,wCAAwC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAA;gBAC1G,MAAM,GAAG;oBACR,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;oBAC7F,OAAO,EAAE,OAAO,CAAC,aAAa;iBACjB,CAAA;YACf,CAAC;YAED,OAAO,oBAAoB,CAC1B,MAAM,EACN,QAAQ,EACR,EAAE,EACF;gBACC,eAAe,EAAE,IAAI,CAAC,kBAAkB;gBACxC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,KAAK,KAAI,CAAC,EAAE,IAAI,KAAI,CAAC,EAAE,CAAU;aAC7D,CACD,CAAA;QACF,CAAC;KACD,CAAA;AACF,CAAC,CAAA"}

package/lib/Utils/history.d.ts

@@ -0,0 +1,24 @@
+import { proto } from '../../WAProto/index.js';
+import type { Chat, Contact, LIDMapping, WAMessage } from '../Types/index.js';
+import type { ILogger } from './logger.js';
+export declare const downloadHistory: (msg: proto.Message.IHistorySyncNotification, options: RequestInit) => Promise<proto.HistorySync>;
+export declare const processHistoryMessage: (item: proto.IHistorySync, logger?: ILogger) => {
+    chats: Chat[];
+    contacts: Contact[];
+    messages: WAMessage[];
+    lidPnMappings: LIDMapping[];
+    pastParticipants: proto.IPastParticipants[] | null | undefined;
+    syncType: proto.HistorySync.HistorySyncType | null | undefined;
+    progress: number | null | undefined;
+};
+export declare const downloadAndProcessHistorySyncNotification: (msg: proto.Message.IHistorySyncNotification, options: RequestInit, logger?: ILogger) => Promise<{
+    chats: Chat[];
+    contacts: Contact[];
+    messages: WAMessage[];
+    lidPnMappings: LIDMapping[];
+    pastParticipants: proto.IPastParticipants[] | null | undefined;
+    syncType: proto.HistorySync.HistorySyncType | null | undefined;
+    progress: number | null | undefined;
+}>;
+export declare const getHistoryMsg: (message: proto.IMessage) => proto.Message.IHistorySyncNotification;
+//# sourceMappingURL=history.d.ts.map

package/lib/Utils/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/Utils/history.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAwB1C,eAAO,MAAM,eAAe,GAAU,KAAK,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE,SAAS,WAAW,+BAYtG,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,MAAM,KAAK,CAAC,YAAY,EAAE,SAAS,OAAO;;;;;;;;CA6F/E,CAAA;AAED,eAAO,MAAM,yCAAyC,GACrD,KAAK,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAC3C,SAAS,WAAW,EACpB,SAAS,OAAO;;;;;;;;EAUhB,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,KAAK,CAAC,QAAQ,2CAKpD,CAAA"}