@gqb333/based 2.7.71

package/lib/Utils/process-message.js

@@ -0,0 +1,498 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChatId = exports.shouldIncrementChatUnread = exports.isRealMessage = exports.cleanMessage = void 0;
+exports.decryptPollVote = decryptPollVote;
+const WAProto_1 = require("../../WAProto");
+const Types_1 = require("../Types");
+const messages_1 = require("../Utils/messages");
+const WABinary_1 = require("../WABinary");
+const crypto_1 = require("./crypto");
+const generics_1 = require("./generics");
+const history_1 = require("./history");
+const REAL_MSG_STUB_TYPES = new Set([
+    Types_1.WAMessageStubType.CALL_MISSED_GROUP_VIDEO,
+    Types_1.WAMessageStubType.CALL_MISSED_GROUP_VOICE,
+    Types_1.WAMessageStubType.CALL_MISSED_VIDEO,
+    Types_1.WAMessageStubType.CALL_MISSED_VOICE
+]);
+const REAL_MSG_REQ_ME_STUB_TYPES = new Set([
+    Types_1.WAMessageStubType.GROUP_PARTICIPANT_ADD
+]);
+
+/** Helper function to normalize JID */
+const normalizeToJid = (jid) => {
+    if (!jid || typeof jid !== 'string') {
+        return jid;
+    }
+    if ((0, WABinary_1.isLid)(jid)) {
+        const decoded = (0, WABinary_1.lidToJid)(jid);
+        return decoded || jid;
+    }
+    return jid;
+};
+
+/** Cleans a received message to further processing */
+const cleanMessage = (message, meId) => {
+    // ensure remoteJid and participant doesn't have device or agent in it
+    // normalize JIDs but catch errors to avoid throwing on invalid LIDs/JIDs
+    try {
+        const r0 = message.key.remoteJid;
+        if (r0) {
+            const rd = (0, WABinary_1.jidDecode)(r0);
+            if (rd === null || rd === void 0 ? void 0 : rd.user) {
+                message.key.remoteLid = message.key.remoteLid || ((0, WABinary_1.isLid)(r0) ? r0 : (0, WABinary_1.jidEncode)(rd.user, 'lid'));
+            }
+        }
+        message.key.remoteJid = normalizeToJid(message.key.remoteJid);
+    }
+    catch (_e) {
+        // if normalization fails, retain original remoteJid
+    }
+    if (message.key.participant) {
+        try {
+            const p0 = message.key.participant;
+            if (p0) {
+                const pd = (0, WABinary_1.jidDecode)(p0);
+                if (pd === null || pd === void 0 ? void 0 : pd.user) {
+                    message.key.participantLid = message.key.participantLid || ((0, WABinary_1.isLid)(p0) ? p0 : (0, WABinary_1.jidEncode)(pd.user, 'lid'));
+                }
+            }
+            message.key.participant = normalizeToJid(message.key.participant);
+        }
+        catch (_e) {
+            // ignore if can't normalize participant
+        }
+    }
+    message.key.remoteJidNormalized = message.key.remoteJid;
+    const content = (0, messages_1.normalizeMessageContent)(message.message);
+    // if the message has a reaction, ensure fromMe & remoteJid are from our perspective
+    if (content === null || content === void 0 ? void 0 : content.reactionMessage) {
+        normaliseKey(content.reactionMessage.key);
+    }
+    if (content === null || content === void 0 ? void 0 : content.pollUpdateMessage) {
+        normaliseKey(content.pollUpdateMessage.pollCreationMessageKey);
+    }
+    function normaliseKey(msgKey) {
+        // if the reaction is from another user
+        // we've to correctly map the key to this user's perspective
+        if (!message.key.fromMe) {
+            // if the sender believed the message being reacted to is not from them
+            // we've to correct the key to be from them, or some other participant
+            msgKey.fromMe = !msgKey.fromMe
+                ? (0, WABinary_1.areJidsSameUser)(msgKey.participant || msgKey.remoteJid, meId)
+                // if the message being reacted to, was from them
+                // fromMe automatically becomes false
+                : false;
+            // set the remoteJid to being the same as the chat the message came from
+            msgKey.remoteJid = message.key.remoteJid;
+            // set participant of the message
+            msgKey.participant = msgKey.participant || message.key.participant;
+        }
+    }
+};
+exports.cleanMessage = cleanMessage;
+const isRealMessage = (message, meId) => {
+    var _a;
+    const normalizedContent = (0, messages_1.normalizeMessageContent)(message.message);
+    const hasSomeContent = !!(0, messages_1.getContentType)(normalizedContent);
+    return (!!normalizedContent
+        || REAL_MSG_STUB_TYPES.has(message.messageStubType)
+        || (REAL_MSG_REQ_ME_STUB_TYPES.has(message.messageStubType)
+            && ((_a = message.messageStubParameters) === null || _a === void 0 ? void 0 : _a.some(p => (0, WABinary_1.areJidsSameUser)(meId, p)))))
+        && hasSomeContent
+        && !(normalizedContent === null || normalizedContent === void 0 ? void 0 : normalizedContent.protocolMessage)
+        && !(normalizedContent === null || normalizedContent === void 0 ? void 0 : normalizedContent.reactionMessage)
+        && !(normalizedContent === null || normalizedContent === void 0 ? void 0 : normalizedContent.pollUpdateMessage);
+};
+exports.isRealMessage = isRealMessage;
+const shouldIncrementChatUnread = (message) => (!message.key.fromMe && !message.messageStubType);
+exports.shouldIncrementChatUnread = shouldIncrementChatUnread;
+/**
+ * Get the ID of the chat from the given key.
+ * Typically -- that'll be the remoteJid, but for broadcasts, it'll be the participant
+ */
+const getChatId = ({ remoteJid, participant, fromMe }) => {
+    if ((0, WABinary_1.isJidBroadcast)(remoteJid)
+        && !(0, WABinary_1.isJidStatusBroadcast)(remoteJid)
+        && !fromMe) {
+        return participant;
+    }
+    return remoteJid;
+};
+exports.getChatId = getChatId;
+/**
+ * Decrypt a poll vote
+ * @param vote encrypted vote
+ * @param ctx additional info about the poll required for decryption
+ * @returns list of SHA256 options
+ */
+function decryptPollVote({ encPayload, encIv }, { pollCreatorJid, pollMsgId, pollEncKey, voterJid, }) {
+    const sign = Buffer.concat([
+        toBinary(pollMsgId),
+        toBinary(pollCreatorJid),
+        toBinary(voterJid),
+        toBinary('Poll Vote'),
+        new Uint8Array([1])
+    ]);
+    const key0 = (0, crypto_1.hmacSign)(pollEncKey, new Uint8Array(32), 'sha256');
+    const decKey = (0, crypto_1.hmacSign)(sign, key0, 'sha256');
+    const aad = toBinary(`${pollMsgId}\u0000${voterJid}`);
+    const decrypted = (0, crypto_1.aesDecryptGCM)(encPayload, decKey, encIv, aad);
+    return WAProto_1.proto.Message.PollVoteMessage.decode(decrypted);
+    function toBinary(txt) {
+        return Buffer.from(txt);
+    }
+}
+const processMessage = async (message, { shouldProcessHistoryMsg, placeholderResendCache, ev, creds, keyStore, logger, options, getMessage }) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
+    const meId = creds.me.id;
+    const { accountSettings } = creds;
+    const chat = { id: (0, WABinary_1.jidNormalizedUser)((0, exports.getChatId)(message.key)) };
+    const isRealMsg = (0, exports.isRealMessage)(message, meId);
+    if (isRealMsg) {
+        chat.messages = [{ message }];
+        chat.conversationTimestamp = (0, generics_1.toNumber)(message.messageTimestamp);
+        // only increment unread count if not CIPHERTEXT and from another person
+        if ((0, exports.shouldIncrementChatUnread)(message)) {
+            chat.unreadCount = (chat.unreadCount || 0) + 1;
+        }
+    }
+    const content = (0, messages_1.normalizeMessageContent)(message.message);
+
+    // unarchive chat if it's a real message, or someone reacted to our message
+    // and we've the unarchive chats setting on
+    if ((isRealMsg || ((_b = (_a = content === null || content === void 0 ? void 0 : content.reactionMessage) === null || _a === void 0 ? void 0 : _a.key) === null || _b === void 0 ? void 0 : _b.fromMe))
+        && (accountSettings === null || accountSettings === void 0 ? void 0 : accountSettings.unarchiveChats)) {
+        chat.archived = false;
+        chat.readOnly = false;
+    }
+    const protocolMsg = content === null || content === void 0 ? void 0 : content.protocolMessage;
+    if (protocolMsg) {
+        switch (protocolMsg.type) {
+            case WAProto_1.proto.Message.ProtocolMessage.Type.HISTORY_SYNC_NOTIFICATION:
+                const histNotification = protocolMsg.historySyncNotification;
+                const process = shouldProcessHistoryMsg;
+                const isLatest = !((_c = creds.processedHistoryMessages) === null || _c === void 0 ? void 0 : _c.length);
+                logger === null || logger === void 0 ? void 0 : logger.info({
+                    histNotification,
+                    process,
+                    id: message.key.id,
+                    isLatest,
+                }, 'got history notification');
+                if (process) {
+                    if (histNotification.syncType !== WAProto_1.proto.HistorySync.HistorySyncType.ON_DEMAND) {
+                        ev.emit('creds.update', {
+                            processedHistoryMessages: [
+                                ...(creds.processedHistoryMessages || []),
+                                { key: message.key, messageTimestamp: message.messageTimestamp }
+                            ]
+                        });
+                    }
+                    const data = await (0, history_1.downloadAndProcessHistorySyncNotification)(histNotification, options);
+                    ev.emit('messaging-history.set', {
+                        ...data,
+                        isLatest: histNotification.syncType !== WAProto_1.proto.HistorySync.HistorySyncType.ON_DEMAND
+                            ? isLatest
+                            : undefined,
+                        peerDataRequestSessionId: histNotification.peerDataRequestSessionId
+                    });
+                }
+                break;
+            case WAProto_1.proto.Message.ProtocolMessage.Type.APP_STATE_SYNC_KEY_SHARE:
+                const keys = protocolMsg.appStateSyncKeyShare.keys;
+                if (keys === null || keys === void 0 ? void 0 : keys.length) {
+                    let newAppStateSyncKeyId = '';
+                    await keyStore.transaction(async () => {
+                        const newKeys = [];
+                        for (const { keyData, keyId } of keys) {
+                            const strKeyId = Buffer.from(keyId.keyId).toString('base64');
+                            newKeys.push(strKeyId);
+                            await keyStore.set({ 'app-state-sync-key': { [strKeyId]: keyData } });
+                            newAppStateSyncKeyId = strKeyId;
+                        }
+                        logger === null || logger === void 0 ? void 0 : logger.info({ newAppStateSyncKeyId, newKeys }, 'injecting new app state sync keys');
+                    });
+                    ev.emit('creds.update', { myAppStateKeyId: newAppStateSyncKeyId });
+                }
+                else {
+                    logger === null || logger === void 0 ? void 0 : logger.info({ protocolMsg }, 'recv app state sync with 0 keys');
+                }
+                break;
+            case WAProto_1.proto.Message.ProtocolMessage.Type.REVOKE:
+                ev.emit('messages.update', [
+                    {
+                        key: {
+                            ...message.key,
+                            id: protocolMsg.key.id
+                        },
+                        update: { message: null, messageStubType: Types_1.WAMessageStubType.REVOKE, key: message.key }
+                    }
+                ]);
+                break;
+            case WAProto_1.proto.Message.ProtocolMessage.Type.EPHEMERAL_SETTING:
+                Object.assign(chat, {
+                    ephemeralSettingTimestamp: (0, generics_1.toNumber)(message.messageTimestamp),
+                    ephemeralExpiration: protocolMsg.ephemeralExpiration || null
+                });
+                break;
+            case WAProto_1.proto.Message.ProtocolMessage.Type.PEER_DATA_OPERATION_REQUEST_RESPONSE_MESSAGE:
+                const response = protocolMsg.peerDataOperationRequestResponseMessage;
+                if (response) {
+                    placeholderResendCache === null || placeholderResendCache === void 0 ? void 0 : placeholderResendCache.del(response.stanzaId);
+                    // Handle peer data operation results including sticker uploads, media uploads, link previews, and history sync
+                    const { peerDataOperationResult } = response;
+                    for (const result of peerDataOperationResult) {
+                        // Handle placeholder message resend responses
+                        const { placeholderMessageResendResponse: retryResponse } = result;
+                        if (retryResponse) {
+                            const webMessageInfo = WAProto_1.proto.WebMessageInfo.decode(retryResponse.webMessageInfoBytes);
+                            // wait till another upsert event is available, don't want it to be part of the PDO response message
+                            setTimeout(() => {
+                                ev.emit('messages.upsert', {
+                                    messages: [webMessageInfo],
+                                    type: 'notify',
+                                    requestId: response.stanzaId
+                                });
+                            }, 500);
+                        }
+                        
+                        // Handle sticker message results
+                        if (result.stickerMessage) {
+                            ev.emit('sticker.upload-result', {
+                                stickerMessage: result.stickerMessage,
+                                requestId: response.stanzaId
+                            });
+                        }
+                        
+                        // Handle media upload results
+                        if (result.mediaUploadResult !== undefined) {
+                            ev.emit('media.upload-result', {
+                                result: result.mediaUploadResult,
+                                requestId: response.stanzaId
+                            });
+                        }
+                        
+                        // Handle link preview responses
+                        if (result.linkPreviewResponse) {
+                            ev.emit('link-preview.response', {
+                                response: result.linkPreviewResponse,
+                                requestId: response.stanzaId
+                            });
+                        }
+                        
+                        // Handle history sync chunk retry responses
+                        if (result.historySyncChunkRetryResponse) {
+                            const historySyncResponse = result.historySyncChunkRetryResponse;
+                            ev.emit('history-sync.chunk-retry', {
+                                syncType: historySyncResponse.syncType,
+                                chunkOrder: historySyncResponse.chunkOrder,
+                                requestId: historySyncResponse.requestId,
+                                responseCode: historySyncResponse.responseCode,
+                                canRecover: historySyncResponse.canRecover,
+                                stanzaId: response.stanzaId
+                            });
+                        }
+                        
+                        // Handle full history sync on-demand responses
+                        if (result.fullHistorySyncOnDemandRequestResponse) {
+                            ev.emit('history-sync.on-demand-response', {
+                                response: result.fullHistorySyncOnDemandRequestResponse,
+                                requestId: response.stanzaId
+                            });
+                        }
+                    }
+                }
+            case WAProto_1.proto.Message.ProtocolMessage.Type.MESSAGE_EDIT:
+                ev.emit('messages.update', [
+                    {
+                        // flip the sender / fromMe properties because they're in the perspective of the sender
+                        key: { ...message.key, id: (_d = protocolMsg.key) === null || _d === void 0 ? void 0 : _d.id },
+                        update: {
+                            message: {
+                                editedMessage: {
+                                    message: protocolMsg.editedMessage
+                                }
+                            },
+                            messageTimestamp: protocolMsg.timestampMs
+                                ? Math.floor((0, generics_1.toNumber)(protocolMsg.timestampMs) / 1000)
+                                : message.messageTimestamp
+                        }
+                    }
+                ]);
+                break;
+        }
+    }
+    else if (content === null || content === void 0 ? void 0 : content.reactionMessage) {
+        const reaction = {
+            ...content.reactionMessage,
+            key: message.key,
+        };
+        ev.emit('messages.reaction', [{
+                reaction,
+                key: (_e = content.reactionMessage) === null || _e === void 0 ? void 0 : _e.key,
+            }]);
+    }
+    else if (message.messageStubType) {
+        const jid = (_f = message.key) === null || _f === void 0 ? void 0 : _f.remoteJid;
+        //let actor = whatsappID (message.participant)
+        let participants;
+        const author = normalizeToJid(message.participant);
+        const emitParticipantsUpdate = (action) => (ev.emit('group-participants.update', { id: jid, author, participants, action }));
+        const emitGroupUpdate = (update) => {
+            var _a;
+            ev.emit('groups.update', [{ id: jid, ...update, author: (_a = author) !== null && _a !== void 0 ? _a : undefined }]);
+        };
+        const emitGroupRequestJoin = (participant, action, method) => {
+            ev.emit('group.join-request', { id: jid, author, participant: normalizeToJid(participant), action, method: method });
+        };
+        const participantsIncludesMe = () => participants.find(jid => (0, WABinary_1.areJidsSameUser)(meId, jid));
+        switch (message.messageStubType) {
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_CHANGE_NUMBER:
+                participants = (message.messageStubParameters || []).map(normalizeToJid);
+                participants = participants.map(p => {
+                    if (typeof p === 'string') {
+                        const cleanedJid = (0, WABinary_1.validateAndCleanJid)(p);
+                        return cleanedJid;
+                    }
+                    return p;
+                });
+                emitParticipantsUpdate('modify');
+                break;
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_LEAVE:
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_REMOVE:
+                participants = (message.messageStubParameters || []).map(normalizeToJid);
+                participants = participants.map(p => {
+                    if (typeof p === 'string') {
+                        const cleanedJid = (0, WABinary_1.validateAndCleanJid)(p);
+                        return cleanedJid;
+                    }
+                    return p;
+                });
+                emitParticipantsUpdate('remove');
+                if (participantsIncludesMe()) {
+                    chat.readOnly = true;
+                }
+                break;
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_ADD:
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_INVITE:
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_ADD_REQUEST_JOIN:
+                participants = (message.messageStubParameters || []).map(normalizeToJid);
+                // Additional safety check: ensure all participants are proper JIDs
+                participants = participants.map(p => {
+                    if (typeof p === 'string') {
+                        const cleanedJid = (0, WABinary_1.validateAndCleanJid)(p);
+                        return cleanedJid;
+                    }
+                    return p;
+                });
+                if (participantsIncludesMe()) {
+                    chat.readOnly = false;
+                }
+                emitParticipantsUpdate('add');
+                break;
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_DEMOTE:
+                participants = (message.messageStubParameters || []).map(normalizeToJid);
+                // Additional safety check: ensure all participants are proper JIDs
+                participants = participants.map(p => {
+                    if (typeof p === 'string') {
+                        const cleanedJid = (0, WABinary_1.validateAndCleanJid)(p);
+                        return cleanedJid;
+                    }
+                    return p;
+                });
+                emitParticipantsUpdate('demote');
+                break;
+            case Types_1.WAMessageStubType.GROUP_PARTICIPANT_PROMOTE:
+                participants = (message.messageStubParameters || []).map(normalizeToJid);
+                // Additional safety check: ensure all participants are proper JIDs
+                participants = participants.map(p => {
+                    if (typeof p === 'string') {
+                        const cleanedJid = (0, WABinary_1.validateAndCleanJid)(p);
+                        return cleanedJid;
+                    }
+                    return p;
+                });
+                emitParticipantsUpdate('promote');
+                break;
+            case Types_1.WAMessageStubType.GROUP_CHANGE_ANNOUNCE:
+                const announceValue = (_g = message.messageStubParameters) === null || _g === void 0 ? void 0 : _g[0];
+                emitGroupUpdate({ announce: announceValue === 'true' || announceValue === 'on' });
+                break;
+            case Types_1.WAMessageStubType.GROUP_CHANGE_RESTRICT:
+                const restrictValue = (_h = message.messageStubParameters) === null || _h === void 0 ? void 0 : _h[0];
+                emitGroupUpdate({ restrict: restrictValue === 'true' || restrictValue === 'on' });
+                break;
+            case Types_1.WAMessageStubType.GROUP_CHANGE_SUBJECT:
+                const name = (_j = message.messageStubParameters) === null || _j === void 0 ? void 0 : _j[0];
+                chat.name = name;
+                emitGroupUpdate({ subject: name });
+                break;
+            case Types_1.WAMessageStubType.GROUP_CHANGE_DESCRIPTION:
+                const description = (_k = message.messageStubParameters) === null || _k === void 0 ? void 0 : _k[0];
+                chat.description = description;
+                emitGroupUpdate({ desc: description });
+                break;
+            case Types_1.WAMessageStubType.GROUP_CHANGE_INVITE_LINK:
+                const code = (_l = message.messageStubParameters) === null || _l === void 0 ? void 0 : _l[0];
+                emitGroupUpdate({ inviteCode: code });
+                break;
+            case Types_1.WAMessageStubType.GROUP_MEMBER_ADD_MODE:
+                const memberAddValue = (_m = message.messageStubParameters) === null || _m === void 0 ? void 0 : _m[0];
+                emitGroupUpdate({ memberAddMode: memberAddValue === 'all_member_add' });
+                break;
+            case Types_1.WAMessageStubType.GROUP_MEMBERSHIP_JOIN_APPROVAL_MODE:
+                const approvalMode = (_o = message.messageStubParameters) === null || _o === void 0 ? void 0 : _o[0];
+                emitGroupUpdate({ joinApprovalMode: approvalMode === 'on' });
+                break;
+            case Types_1.WAMessageStubType.GROUP_MEMBERSHIP_JOIN_APPROVAL_REQUEST_NON_ADMIN_ADD:
+                const participant = (_p = message.messageStubParameters) === null || _p === void 0 ? void 0 : _p[0];
+                const action = (_q = message.messageStubParameters) === null || _q === void 0 ? void 0 : _q[1];
+                const method = (_r = message.messageStubParameters) === null || _r === void 0 ? void 0 : _r[2];
+                emitGroupRequestJoin(participant, action, method);
+                break;
+        }
+    }
+    else if (content === null || content === void 0 ? void 0 : content.pollUpdateMessage) {
+        const creationMsgKey = content.pollUpdateMessage.pollCreationMessageKey;
+        // we need to fetch the poll creation message to get the poll enc key
+        const pollMsg = await getMessage(creationMsgKey);
+        if (pollMsg) {
+            const meIdNormalised = (0, WABinary_1.jidNormalizedUser)(meId);
+            const pollCreatorJid = (0, generics_1.getKeyAuthor)(creationMsgKey, meIdNormalised);
+            const voterJid = (0, generics_1.getKeyAuthor)(message.key, meIdNormalised);
+            const pollEncKey = (_s = pollMsg.messageContextInfo) === null || _s === void 0 ? void 0 : _s.messageSecret;
+            try {
+                const voteMsg = decryptPollVote(content.pollUpdateMessage.vote, {
+                    pollEncKey,
+                    pollCreatorJid,
+                    pollMsgId: creationMsgKey.id,
+                    voterJid,
+                });
+                ev.emit('messages.update', [
+                    {
+                        key: creationMsgKey,
+                        update: {
+                            pollUpdates: [
+                                {
+                                    pollUpdateMessageKey: message.key,
+                                    vote: voteMsg,
+                                    senderTimestampMs: content.pollUpdateMessage.senderTimestampMs.toNumber(),
+                                }
+                            ]
+                        }
+                    }
+                ]);
+            }
+            catch (err) {
+                logger === null || logger === void 0 ? void 0 : logger.warn({ err, creationMsgKey }, 'failed to decrypt poll vote');
+            }
+        }
+        else {
+            logger === null || logger === void 0 ? void 0 : logger.warn({ creationMsgKey }, 'poll creation message not found, cannot decrypt update');
+        }
+    }
+    if (Object.keys(chat).length > 1) {
+        ev.emit('chats.update', [chat]);
+    }
+};
+exports.default = processMessage;

package/lib/Utils/rate-limiter.js

@@ -0,0 +1,90 @@
+"use strict";
+
+class RateLimiter {
+    /**
+     * @param {object} [options] - Configuration options
+     * @param {number} [options.limitPerSecond=1] - Number of tasks to process per second
+     * @param {number} [options.maxRandomDelayMs=500] - Maximum random delay to add after each task in milliseconds
+     */
+    constructor(options = {}) {
+        const { limitPerSecond = 1, maxRandomDelayMs = 500 } = options;
+
+        this.limitPerSecond = limitPerSecond;
+        this.interval = 1000 / this.limitPerSecond;
+        this.maxRandomDelayMs = maxRandomDelayMs;
+
+        this.queue = [];
+        this.processing = false;
+        this.lastSendTime = 0;
+    }
+
+    /**
+     * Add a task to the rate limiting queue
+     * @param {Function} task - Async function to execute
+     * @returns {Promise} - Promise that resolves when task is complete
+     */
+    async add(task) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ task, resolve, reject });
+            if (!this.processing) {
+                this.process();
+            }
+        });
+    }
+    async process() {
+        if (this.processing || this.queue.length === 0) {
+            return;
+        }
+
+        this.processing = true;
+
+        while (this.queue.length > 0) {
+            const { task, resolve, reject } = this.queue.shift();
+            const now = Date.now();
+            const timeSinceLastSend = now - this.lastSendTime;
+            if (timeSinceLastSend < this.interval) {
+                const waitTime = this.interval - timeSinceLastSend;
+                await new Promise(r => setTimeout(r, waitTime));
+            }
+
+            try {
+                const result = await task();
+                this.lastSendTime = Date.now();
+                resolve(result);
+            } catch (error) {
+                reject(error);
+            }
+            if (this.maxRandomDelayMs > 0) {
+                const randomDelay = Math.random() * this.maxRandomDelayMs;
+                await new Promise(r => setTimeout(r, randomDelay));
+            }
+        }
+
+        this.processing = false;
+    }
+
+    /**
+     * Update the rate limit
+     * @param {number} newLimit - New messages per second limit
+     */
+    setLimit(newLimit) {
+        this.limitPerSecond = newLimit;
+        this.interval = 1000 / newLimit;
+    }
+
+    /**
+     * Get current queue length
+     * @returns {number} - Number of pending tasks
+     */
+    getQueueLength() {
+        return this.queue.length;
+    }
+    clear() {
+        this.queue.forEach(({ reject }) => {
+            reject(new Error('Rate limiter cleared'));
+        });
+        this.queue = [];
+    }
+}
+
+module.exports = RateLimiter;

package/lib/Utils/retry.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryWithBackoff = void 0;
+
+async function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(resolve, ms);
+        if (signal) {
+            const onAbort = () => {
+                clearTimeout(t);
+                reject(Object.assign(new Error('aborted'), { code: 'ABORT_ERR' }));
+            };
+            if (signal.aborted) {
+                onAbort();
+                return;
+            }
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+    });
+}
+
+function computeDelay(attempt, baseMs, maxMs, jitter) {
+    const exp = Math.min(maxMs, baseMs * Math.pow(2, attempt));
+    if (!jitter) return exp;
+    // full jitter strategy: random between 0 and exp
+    const rand = Math.random() * exp;
+    return Math.min(maxMs, rand);
+}
+
+async function retryWithBackoff(fn, opts = {}) {
+	const {
+		retries = 3,
+		baseMs = 300,
+		maxMs = 5000,
+		jitter = true,
+        timeoutPerAttemptMs,
+        signal,
+		onRetry,
+		shouldRetry
+	} = opts;
+	let lastErr;
+	for (let attempt = 0; attempt <= retries; attempt++) {
+		try {
+            if (timeoutPerAttemptMs && timeoutPerAttemptMs > 0) {
+                const ctrl = new AbortController();
+                const timer = setTimeout(() => ctrl.abort(), timeoutPerAttemptMs);
+                try {
+                    return await fn({ signal: ctrl.signal });
+                } finally {
+                    clearTimeout(timer);
+                }
+            }
+            return await fn({ signal });
+		} catch (err) {
+			lastErr = err;
+			if (attempt === retries) break;
+			if (shouldRetry && !shouldRetry(err)) break;
+			if (onRetry) {
+				try { onRetry(err, attempt + 1); } catch {}
+			}
+            await sleep(computeDelay(attempt, baseMs, maxMs, jitter), signal);
+		}
+	}
+	throw lastErr;
+}
+exports.retryWithBackoff = retryWithBackoff;