@softtynet/zca-js 2.2.1 → 2.2.3

package/dist/cjs/apis/cancelVoiceCall.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+var sendVoiceCall = require('./sendVoiceCall.cjs');
+
+const cancelVoiceCallFactory = utils.apiFactory()((api, ctx, utils) => {
+    var _a;
+    const voiceCallService = (_a = api.zpwServiceMap.voice_call) === null || _a === void 0 ? void 0 : _a[0];
+    /**
+     * Huỷ cuộc gọi đang đổ chuông trước khi người nhận bắt máy (`/api/voicecall/cancel`, command `11305`).
+     *
+     * @param calleeId User ID của người nhận cuộc gọi
+     * @param callId ID của cuộc gọi (nhận từ `sendVoiceCall`)
+     * @param options Tuỳ chọn loại cuộc gọi (`callType`) và `status`
+     * @throws {ZaloApiError}
+     */
+    return async function cancelVoiceCall(calleeId, callId, options = {}) {
+        var _a, _b;
+        if (!calleeId)
+            throw new ZaloApiError.ZaloApiError("Missing calleeId");
+        if (!callId)
+            throw new ZaloApiError.ZaloApiError("Missing callId");
+        if (!voiceCallService)
+            throw new ZaloApiError.ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const numericCalleeId = Number.isNaN(Number(calleeId)) ? calleeId : Number(calleeId);
+        const params = {
+            callerId: numericCalleeId,
+            callId,
+            callType: (_a = options.callType) !== null && _a !== void 0 ? _a : sendVoiceCall.CallType.Audio,
+            status: (_b = options.status) !== null && _b !== void 0 ? _b : 0,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt cancelVoiceCall params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/cancel`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.cancelVoiceCallFactory = cancelVoiceCallFactory;

package/dist/cjs/apis/createReminder.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 var Reminder = require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const createReminderFactory = utils.apiFactory()((api, ctx, utils) => {

package/dist/cjs/apis/decryptGids.cjs

@@ -7,6 +7,7 @@ const decryptGidsFactory = utils.apiFactory()((api, ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/gid/decrypt`);
     /**
      * Giải mã danh sách Global ID (g_...) ẩn danh thành User ID thật
+     * (tương ứng hàm `getUidFromGlobalNoiseId` / command `12054` trên Zalo PC)
      *
      * @param gids Danh sách Global ID (hoặc 1 GID đơn lẻ)
      * @throws {ZaloApiError}
@@ -17,6 +18,7 @@ const decryptGidsFactory = utils.apiFactory()((api, ctx, utils) => {
         if (!Array.isArray(gids))
             gids = [gids];
         const params = {
+            globalUids: JSON.stringify(gids),
             gids,
             imei: ctx.imei,
         };

package/dist/cjs/apis/deleteChat.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const deleteChatFactory = utils.apiFactory()((api, ctx, utils) => {

package/dist/cjs/apis/deleteMessage.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const deleteMessageFactory = utils.apiFactory()((api, ctx, utils) => {

package/dist/cjs/apis/editReminder.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const editReminderFactory = utils.apiFactory()((api, ctx, utils) => {

package/dist/cjs/apis/endVoiceCall.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const endVoiceCallFactory = utils.apiFactory()((api, ctx, utils) => {
+    var _a;
+    const voiceCallService = (_a = api.zpwServiceMap.voice_call) === null || _a === void 0 ? void 0 : _a[0];
+    /**
+     * Kết thúc cuộc gọi thoại / video (`/api/voicecall/endcall`, command `11306`).
+     *
+     * @param calleeId User ID của đối phương
+     * @param callId ID của cuộc gọi
+     * @param options Tuỳ chọn mã trạng thái kết thúc (`status`, mặc định `3`)
+     * @throws {ZaloApiError}
+     */
+    return async function endVoiceCall(calleeId, callId, options = {}) {
+        var _a;
+        if (!calleeId)
+            throw new ZaloApiError.ZaloApiError("Missing calleeId");
+        if (!callId)
+            throw new ZaloApiError.ZaloApiError("Missing callId");
+        if (!voiceCallService)
+            throw new ZaloApiError.ZaloApiError("Missing voice_call service URL in zpwServiceMap");
+        const numericCalleeId = Number.isNaN(Number(calleeId)) ? calleeId : Number(calleeId);
+        const params = {
+            uidTo: numericCalleeId,
+            callId,
+            status: (_a = options.status) !== null && _a !== void 0 ? _a : 3,
+            imei: ctx.imei,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt endVoiceCall params");
+        const url = utils.makeURL(`${voiceCallService}/api/voicecall/endcall`, {
+            zpw_type: 24,
+            params: encryptedParams,
+        });
+        const response = await utils.request(url, {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.endVoiceCallFactory = endVoiceCallFactory;

package/dist/cjs/apis/findUser.cjs

@@ -12,6 +12,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 
 const findUserFactory = utils.apiFactory()((api, ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.friend[0]}/api/friend/profile/get`);

package/dist/cjs/apis/findUserByUsername.cjs

@@ -12,6 +12,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 
 const findUserByUsernameFactory = utils.apiFactory()((api, _ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.friend[0]}/api/friend/search/by-user-name`);

package/dist/cjs/apis/forwardMessage.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const forwardMessageFactory = utils.apiFactory()((api, ctx, utils) => {

package/dist/cjs/apis/getAllFriends.cjs

@@ -12,6 +12,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 
 const getAllFriendsFactory = utils.apiFactory()((api, ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/getfriends`);

package/dist/cjs/apis/getAvatarUrlProfile.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const getAvatarUrlProfileFactory = utils.apiFactory()((api, _ctx, utils) => {

package/dist/cjs/apis/getGroupChatHistory.cjs

@@ -13,6 +13,8 @@ var Message = require('../models/Message.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 
 const getGroupChatHistoryFactory = utils.apiFactory()((api, ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.group_cloud_message[0]}/api/cm/getrecentv2`);

package/dist/cjs/apis/getListBoard.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const getListBoardFactory = utils.apiFactory()((api, ctx, utils) => {

package/dist/cjs/apis/getListReminder.cjs

@@ -11,6 +11,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 
 const getListReminderFactory = utils.apiFactory()((api, ctx, utils) => {

package/dist/cjs/apis/getMultiUsersByPhones.cjs

@@ -12,6 +12,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 
 const getMultiUsersByPhonesFactory = utils.apiFactory()((api, ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.friend[0]}/api/friend/profile/multiget`);

package/dist/cjs/apis/getNoisedIds.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const ZWID_ZNOISE_URL = "https://zwid.api.zalo.me/api/znoise";
+function toNumericIds(ids) {
+    return ids.map((id) => Number.parseInt(String(id), 10));
+}
+function normalizeNoised(list, expected, stripGroupPrefix) {
+    const out = [];
+    const arr = Array.isArray(list) ? list : [];
+    for (let i = 0; i < expected; i++) {
+        let v = arr[i] == null ? "" : String(arr[i]);
+        if (stripGroupPrefix && v.startsWith("g"))
+            v = v.slice(1);
+        out.push(v === "0" ? "" : v);
+    }
+    return out;
+}
+const getNoisedIdsFactory = utils.apiFactory()((api, ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/znoise`);
+    /**
+     * Chuyển đổi danh sách UID cá nhân (`fids`) và GID nhóm (`gids`) dạng số thuần (từ SQLite ZDB4.0 mobile)
+     * sang định dạng Noised ID 19 chữ số dùng trên Zalo Web/PC (`getNoisedUids`, command `12390`).
+     * Tự động fallback sang `https://zwid.api.zalo.me/api/znoise` nếu profile domain trả về lỗi.
+     *
+     * @param params Danh sách `fids` và `gids`
+     * @throws {ZaloApiError}
+     */
+    return async function getNoisedIds({ fids = [], gids = [] }) {
+        const payload = {
+            fids: toNumericIds(fids),
+            gids: toNumericIds(gids),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(payload));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        try {
+            const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+                method: "GET",
+            });
+            const data = await utils.resolve(response);
+            const raw = (data !== null && data !== void 0 ? data : {});
+            return {
+                fids: normalizeNoised(raw.fids, fids.length, false),
+                gids: normalizeNoised(raw.gids, gids.length, true),
+            };
+        }
+        catch (primaryErr) {
+            try {
+                const body = new URLSearchParams({ params: encryptedParams }).toString();
+                const fallbackUrl = utils.makeURL(ZWID_ZNOISE_URL);
+                const response = await utils.request(fallbackUrl, {
+                    method: "POST",
+                    body,
+                });
+                const data = await utils.resolve(response);
+                const raw = (data !== null && data !== void 0 ? data : {});
+                return {
+                    fids: normalizeNoised(raw.fids, fids.length, false),
+                    gids: normalizeNoised(raw.gids, gids.length, true),
+                };
+            }
+            catch (_a) {
+                throw primaryErr;
+            }
+        }
+    };
+});
+
+exports.getNoisedIdsFactory = getNoisedIdsFactory;

package/dist/cjs/apis/getSyncData.cjs

@@ -0,0 +1,108 @@
+'use strict';
+
+var fs = require('node:fs');
+var path = require('node:path');
+var toughCookie = require('tough-cookie');
+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
+var utils = require('../utils.cjs');
+
+const getSyncDataFactory = utils.apiFactory()((api, ctx, utils) => {
+    async function downloadFileStream(url) {
+        if (!ctx.cookie)
+            ctx.cookie = new toughCookie.CookieJar();
+        const cookie = ctx.cookie;
+        const manualHeaders = {
+            "Cache-Control": "no-store, must-revalidate",
+            Pragma: "no-cache",
+            "Accept-Encoding": "gzip, deflate, br",
+            "Accept-Language": "en-US",
+            "User-Agent": ctx.userAgent || "",
+            cookie: await cookie.getCookieString("https://chat.zalo.me/"),
+            Expires: "0",
+            "Sec-Fetch-Dest": "empty",
+            "Sec-Fetch-Mode": "no-cors",
+            "Sec-Fetch-Site": "none",
+            Connection: "keep-alive",
+        };
+        const response = await utils.request(url, {
+            method: "GET",
+            headers: manualHeaders,
+        }, true);
+        if (!response.ok) {
+            throw new ZaloApiError.ZaloApiError(`Failed to download sync file: HTTP ${response.status}`);
+        }
+        return response;
+    }
+    async function downloadFile(url) {
+        const response = await downloadFileStream(url);
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+    /**
+     * Tải xuống file sao lưu tin nhắn từ sự kiện `syncmsg_info` (`.db.crypt`, định dạng `ZDB4.0`)
+     * và lưu ra ổ đĩa hoặc trả về `ReadableStream`.
+     *
+     * @param params Thông tin file sao lưu nhận được từ `SyncEventType.SYNCMSG_INFO`
+     * @returns `Promise<SyncDataResponse>`
+     */
+    return async function getSyncData({ url, encrypted_key, file_name, file_size, checksum_code, from_seq_id, is_full_transfer, returnStream = false, savePath = "./", }) {
+        try {
+            if (returnStream) {
+                const response = await downloadFileStream(url);
+                const syncDataStream = {
+                    stream: response.body,
+                    metadata: {
+                        file_name,
+                        file_size,
+                        checksum_code,
+                        from_seq_id,
+                        is_full_transfer,
+                        encrypted_key,
+                    },
+                    response: {
+                        status: response.status,
+                        statusText: response.statusText,
+                        url: response.url,
+                        contentType: response.headers.get("content-type"),
+                        contentLength: response.headers.get("content-length"),
+                    },
+                };
+                return {
+                    success: true,
+                    stream: syncDataStream,
+                };
+            }
+            const encryptedFileData = await downloadFile(url);
+            const fileName = file_name.endsWith(".db.crypt") ? file_name : `${file_name}.db.crypt`;
+            const fullPath = path.join(savePath, fileName);
+            const dir = path.dirname(fullPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(fullPath, encryptedFileData);
+            const syncData = {
+                file_path: fullPath,
+                encrypted_key,
+                metadata: {
+                    file_name: fileName,
+                    file_size,
+                    checksum_code,
+                    from_seq_id,
+                    is_full_transfer,
+                },
+            };
+            return {
+                success: true,
+                data: syncData,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error occurred",
+            };
+        }
+    };
+});
+
+exports.getSyncDataFactory = getSyncDataFactory;

package/dist/cjs/apis/getUserInfo.cjs

@@ -12,6 +12,8 @@ require('../models/GroupEvent.cjs');
 require('../models/Reaction.cjs');
 require('../models/Reminder.cjs');
 require('../models/ZBusiness.cjs');
+require('../models/SyncEvent.cjs');
+require('../models/CallEvent.cjs');
 
 const getUserInfoFactory = utils.apiFactory()((api, ctx, utils) => {
     const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/getprofiles/v2`);

package/dist/cjs/apis/listen.cjs

@@ -17,6 +17,9 @@ var SeenMessage = require('../models/SeenMessage.cjs');
 var Typing = require('../models/Typing.cjs');
 var Undo = require('../models/Undo.cjs');
 require('../models/ZBusiness.cjs');
+var ClearUnread = require('../models/ClearUnread.cjs');
+var SyncEvent = require('../models/SyncEvent.cjs');
+var CallEvent = require('../models/CallEvent.cjs');
 var utils = require('../utils.cjs');
 var ZaloApiError = require('../Errors/ZaloApiError.cjs');
 
@@ -233,7 +236,7 @@ class Listener extends EventEmitter {
             this.emit("error", event);
         };
         ws.onmessage = async (event) => {
-            var _a, _b, _c;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             this.resetWatchdog();
             this.emit("pong"); // Pulse event to notify watchdog that socket is alive
             const { data } = event;
@@ -355,6 +358,21 @@ class Listener extends EventEmitter {
                                 continue;
                             this.emit("friend_event", friendEvent);
                         }
+                        else if (control.content.act_type == "syncmsgmb" ||
+                            control.content.act_type == "transfer_msg") {
+                            const syncEventData = typeof control.content.data == "string"
+                                ? JSON.parse(control.content.data)
+                                : control.content.data;
+                            const syncEvent = SyncEvent.initializeSyncEvent(syncEventData, control.content.act, control.content.act_type);
+                            this.emit("sync_event", syncEvent);
+                        }
+                        else if (control.content.act_type == "voip") {
+                            const callEventData = typeof control.content.data == "string"
+                                ? JSON.parse(control.content.data)
+                                : control.content.data;
+                            const callEvent = CallEvent.initializeCallEvent(callEventData, control.content.act, control.content.act_type);
+                            this.emit("call_event", callEvent);
+                        }
                     }
                 }
                 if (cmd == 612) {
@@ -382,17 +400,54 @@ class Listener extends EventEmitter {
                     const reactionObjects = reacts.map((react) => new Reaction.Reaction(this.ctx.uid, react, isGroup));
                     this.emit("old_reactions", reactionObjects, isGroup);
                 }
-                if (cmd == 510 && subCmd == 1) {
-                    const parsedData = (await utils.decodeEventData(parsed, this.cipherKey)).data;
-                    const msgs = parsedData.msgs;
-                    const responseMsgs = msgs.map((msg) => new Message.UserMessage(this.ctx.uid, msg));
-                    this.emit("old_messages", responseMsgs, Enum.ThreadType.User);
+                if (cmd == 510 && (subCmd == 0 || subCmd == 1)) {
+                    const decoded = await utils.decodeEventData(parsed, this.cipherKey);
+                    const parsedData = (_d = decoded === null || decoded === void 0 ? void 0 : decoded.data) !== null && _d !== void 0 ? _d : decoded;
+                    const msgs = ((_e = parsedData === null || parsedData === void 0 ? void 0 : parsedData.msgs) !== null && _e !== void 0 ? _e : []);
+                    const responseMsgs = [];
+                    for (const msg of msgs) {
+                        if (typeof msg.content == "object" && utils.hasOwn(msg.content, "deleteMsg")) {
+                            const undoObject = new Undo.Undo(this.ctx.uid, msg, false);
+                            if (undoObject.isSelf && !this.selfListen)
+                                continue;
+                            this.emit("undo", undoObject);
+                        }
+                        else {
+                            responseMsgs.push(new Message.UserMessage(this.ctx.uid, msg));
+                        }
+                    }
+                    if (responseMsgs.length > 0 || msgs.length === 0) {
+                        this.emit("old_messages", responseMsgs, Enum.ThreadType.User, (parsedData === null || parsedData === void 0 ? void 0 : parsedData.more) === 1);
+                    }
                 }
-                if (cmd == 511 && subCmd == 1) {
-                    const parsedData = (await utils.decodeEventData(parsed, this.cipherKey)).data;
-                    const groupMsgs = parsedData.groupMsgs;
-                    const responseMsgs = groupMsgs.map((msg) => new Message.GroupMessage(this.ctx.uid, msg));
-                    this.emit("old_messages", responseMsgs, Enum.ThreadType.Group);
+                if (cmd == 511 && (subCmd == 0 || subCmd == 1)) {
+                    const decoded = await utils.decodeEventData(parsed, this.cipherKey);
+                    const parsedData = (_f = decoded === null || decoded === void 0 ? void 0 : decoded.data) !== null && _f !== void 0 ? _f : decoded;
+                    const groupMsgs = ((_g = parsedData === null || parsedData === void 0 ? void 0 : parsedData.groupMsgs) !== null && _g !== void 0 ? _g : []);
+                    const responseMsgs = [];
+                    for (const msg of groupMsgs) {
+                        if (typeof msg.content == "object" && utils.hasOwn(msg.content, "deleteMsg")) {
+                            const undoObject = new Undo.Undo(this.ctx.uid, msg, true);
+                            if (undoObject.isSelf && !this.selfListen)
+                                continue;
+                            this.emit("undo", undoObject);
+                        }
+                        else {
+                            responseMsgs.push(new Message.GroupMessage(this.ctx.uid, msg));
+                        }
+                    }
+                    if (responseMsgs.length > 0 || groupMsgs.length === 0) {
+                        this.emit("old_messages", responseMsgs, Enum.ThreadType.Group, (parsedData === null || parsedData === void 0 ? void 0 : parsedData.more) === 1);
+                    }
+                }
+                if ((cmd == 504 || cmd == 524) && subCmd == 0) {
+                    const decoded = await utils.decodeEventData(parsed, this.cipherKey);
+                    const parsedData = (_h = decoded === null || decoded === void 0 ? void 0 : decoded.data) !== null && _h !== void 0 ? _h : decoded;
+                    const clearUnreads = ((_j = parsedData === null || parsedData === void 0 ? void 0 : parsedData.clearUnreads) !== null && _j !== void 0 ? _j : []);
+                    if (Array.isArray(clearUnreads) && clearUnreads.length > 0) {
+                        const items = clearUnreads.map((item) => new ClearUnread.ClearUnread(item));
+                        this.emit("unread_cleared", items);
+                    }
                 }
                 if (cmd == 602 && subCmd == 0) {
                     const parsedData = (await utils.decodeEventData(parsed, this.cipherKey)).data;
@@ -488,16 +543,18 @@ class Listener extends EventEmitter {
         }
     }
     /**
-     * Request old messages
+     * Request old messages from Zalo WebSocket queue (`cmd 510` for User, `cmd 511` for Group).
+     * When `lastMsgId` is `null` or omitted, defaults to `"10000000000000000"` to fetch the latest offline messages.
      *
-     * @param lastMsgId
+     * @param threadType ThreadType.User or ThreadType.Group
+     * @param lastMsgId Optional cursor message ID (`actionId`) for pagination
      */
     requestOldMessages(threadType, lastMsgId = null) {
         const payload = {
             version: 1,
             cmd: threadType === Enum.ThreadType.User ? 510 : 511,
             subCmd: 1,
-            data: { first: true, lastId: lastMsgId, preIds: [] },
+            data: { first: true, lastId: lastMsgId !== null && lastMsgId !== void 0 ? lastMsgId : "10000000000000000", preIds: [] },
         };
         this.sendWs(payload);
     }